Differences

This shows you the differences between two versions of the page.

--- keycloak [2024/01/28 08:37] – matthiaslueth
+++ keycloak [2024/01/28 08:58] (current) – matthiaslueth
@@ Line 4: / Line 4: @@
 ===== Neue Doku (vor 2024) ======
+Generell ist die Keycloak Dokumentation zu empfehlen: [[https://www.keycloak.org/documentation]]
+Keycloak wird laufend weiterentwickelt und Foren-Einträge sind häufig veraltet, während die Hauptdokumentation bei Google schlecht indiziert ist.
 ==== Deployment ====
 Aktuelle Version ist immer in <code>~/keycloak</code> gelinkt (in der Regel auf die größte Versionsnummer).
@@ Line 9: / Line 12: @@
 <code>~/kc-build-script.sh</code>
 <code>
+Stand 2024-01-28
 #!/bin/bash
@@ Line 25: / Line 29: @@
 <code>~/.config/systemd/user/keycloak.service</code>
 <code>
+Stand 2024-01-28
 [Unit]
 Description=Keycloak Open Source Identity and Access Management
@@ Line 38: / Line 43: @@
 </code>
-==== Technische Konfiguration ====
+==== Server-Konfiguration ====
 === Konfigurationsdatei ===
 <code>~/keycloak/conf/keycloak.conf</code>
@@ Line 48: / Line 53: @@
 === Theme ===
+Wir überschreiben zur Zeit nur das Login-Theme (SSO). Das Theme ist ein Clon vom Keycloakv1-Theme (/lib/lib/main/org.keycloak.keycloak-themes-xx.xx.x.jar). Dieses erbt vom Basis-Theme. Die Jar-Datei kann mit einem Zip-Programm geöffnet werden.
+Letztlich haben wir primär das Hintergrundbild ausgetauscht und ein paar Kleinigkeiten verändert.
+Unser Theme liegt als „Rote Tools v4“ im Theme-Ordner.
+ToDo: Theme vernünftig vom KC-V1-Theme erben lassen.
+== Achtung, Stolperfallen ==
+  * Neues Theme lädt nicht?
+    * Es können für jeden Client eigene Themes geladen werden, die das globale Theme überschreiben.
+    * Keycloak mit folgendem Befehl neu starten: <code>start --spi-theme-static-max-age=-1 --spi-theme-cache-themes=false --spi-theme-cache-templates=false</code>
+==== Webkonfiguration ====
+Zugang unter [[https://login.rote.tools/]].
+=== Realms ===
+Keycloak erlaubt Realms für verschiedene Nutzer:innen-Gruppen. Unsere Produktiv-Umgebung liegt in "user".
+=== Username-Validation ===
+Um eine Username-Validation bei der Registrierung zu ermöglichen, haben wir das Preview-Feature „DECLARATIVE_USER_PROFILE“ aktiviert.
+Unter Realm-Settings > User Profile > username läuft die Validation via pattern:
+<code>{"pattern":"^[a-z0-9.\\-_]{3,63}$","error-message":"username-validation-error"}</code>
+Die Errormessage wird über die Sprachkonfiguration Realm-Settings > Localization ausgegeben.