# eccenca Keycloak Theme

A Keycloak theme based on @eccenca/gui-elements.

Its used as a submodule for the eccenca keycloak docker repository as well as a sidecar image when using keycloak inside of k8s helm chart.

## Overview

TODO

## Installation

1. Download or clone this repository
2. Copy this directory in this repository to `<your-keycloak-installation>/themes/eccenca-keycloak-theme`
3. Rename repository to `eccenca`
3. Start or restart your Keycloak server.
4. Log into your Keycloak server's Administration Console.  Select the `eccenca` theme by navigating to Realm Settings → General → Themes → Login Theme.

## Configuration

### Favicon

* adjust `common/resources/img/favicon.ico` to alter the favicon

### Logo

Add the HTML markup for the logo into `.kc-logo-text` of the HTML Display name configuration in Keycloak. Currently you have two options:

* use `<span class="ecc-logo"></span>` to include standard logo from `login/resources/img/logo.png`, adjust the file directly to alter the logo
* use `<img class="ecc-logo" src="{URL}" alt =""/>` to include logo image from a URL, Keycloak currently not supports Data URI schemes as image sources

## Copyright

eccenca GmbH
