asdsad

CopyToKeycloak/WAS_DU_TUN_MUSST.md

@@ -26,27 +26,39 @@ Wenn du in Entwicklung arbeitest:
 Wenn du in Produktion Theme-Caches aktiv hast:
 
 1. Keycloak stoppen oder neu starten
-2. falls noetig Theme-Cache loeschen:
+2. falls nötig Theme-Cache löschen:
    - `data/tmp/kc-gzip-cache`
 
-## 3. Theme nur fuer den Desktop-Client setzen
+## 3. Theme nur für den Desktop-Client setzen
 
 In Keycloak:
 
-1. Realm `KuscheBerlin` oeffnen
-2. Client `desktop-kusche-berlin` oeffnen
-3. Die Login-Theme-Override fuer den Client auf `kusche-desktop` setzen
+1. Realm `KuscheBerlin` öffnen
+2. Client `desktop-kusche-berlin` öffnen
+3. Die Login-Theme-Override für den Client auf `kusche-desktop` setzen
 
 Wichtig:
 
-- Das Theme soll **nicht** pauschal als Realm-Login-Theme fuer alle Clients gesetzt werden, wenn andere Clients das Standard-Keycloak-Login behalten sollen.
+- Das Theme soll **nicht** pauschal als Realm-Login-Theme für alle Clients gesetzt werden, wenn andere Clients das Standard-Keycloak-Login behalten sollen.
+- Wenn die Texte automatisch nach Browser-Sprache wechseln sollen:
+  - im Realm unter `Realm settings` die Internationalisierung aktivieren
+  - `de` und `en` als erlaubte Sprachen hinterlegen
+  - optional `de` als Standard-Sprache setzen
+- Wenn `Passwort vergessen?` sichtbar sein soll:
+  - im Realm unter `Login` die Option `Forgot password` aktivieren
+- Wenn `Angemeldet bleiben` sichtbar sein soll:
+  - im Realm unter `Login` die Option `Remember Me` aktivieren
+- Wenn ein Passwort-Reset auch wirklich ins angebundene LDAP zurückschreiben soll:
+  - in der LDAP-User-Federation muss Passwort-Änderung erlaubt sein
+  - das hängt von der Keycloak-LDAP-Konfiguration ab, nicht vom Theme selbst
+  - falls LDAP nur read-only angebunden ist, kann Keycloak zwar den Reset-Flow anzeigen, aber das Passwort nicht ins LDAP zurückschreiben
 
 Falls deine Keycloak-Version im Client-UI keine direkte Login-Theme-Auswahl anzeigt:
 
-- pruefen, ob die Client-spezifische Login-Theme-Option in den Client-Einstellungen / Advanced Settings vorhanden ist
+- prüfen, ob die Client-spezifische Login-Theme-Option in den Client-Einstellungen / Advanced Settings vorhanden ist
 - falls nicht vorhanden, bleibt als saubere Alternative nur:
-  - eigener Realm fuer Desktop
-  - oder spaeter ein Theme Selector SPI
+  - eigener Realm für Desktop
+  - oder später ein Theme Selector SPI
 
 ## 4. Testen
 
@@ -57,12 +69,12 @@ Danach testen:
 
 Erwartung:
 
-- fuer den Client `desktop-kusche-berlin` erscheint das neue Desktop-Login-Theme
-- nach erfolgreichem Login geht es zur Desktop-Shell zurueck
+- für den Client `desktop-kusche-berlin` erscheint das neue Desktop-Login-Theme
+- nach erfolgreichem Login geht es zur Desktop-Shell zurück
 
 ## 5. Falls das Theme nicht erscheint
 
-Dann diese Punkte pruefen:
+Dann diese Punkte prüfen:
 
 - Theme-Ordner liegt wirklich im Keycloak-`themes/`-Verzeichnis
 - Verzeichnisname ist exakt `kusche-desktop`
@@ -71,17 +83,17 @@ Dann diese Punkte pruefen:
 - Cache wurde geleert
 - wirklich der Client `desktop-kusche-berlin` wird verwendet
 
-## 6. Welche Datei du spaeter bei Aenderungen ersetzt
+## 6. Welche Datei du später bei Änderungen ersetzt
 
-Wenn du nur Styling aendern willst, reicht meist:
+Wenn du nur Styling ändern willst, reicht meist:
 
 - `theme/kusche-desktop/login/resources/css/desktop-kusche.css`
 
-Wenn du die Struktur aendern willst:
+Wenn du die Struktur ändern willst:
 
 - `theme/kusche-desktop/login/login.ftl`
 
-## 7. Was ich bewusst nicht fuer dich serverseitig tue
+## 7. Was ich bewusst nicht für dich serverseitig tue
 
 Diese Schritte musst du selbst auf dem Keycloak-System machen: