logut

CopyToKeycloak/WAS_DU_TUN_MUSST.md

@@ -0,0 +1,92 @@
+# Was Du Tun Musst
+
+## 1. Theme nach Keycloak kopieren
+
+Den Ordner
+
+- `CopyToKeycloak/theme/kusche-desktop`
+
+in das Keycloak-Themes-Verzeichnis kopieren.
+
+Typische Ziele:
+
+- Container: `/opt/keycloak/themes/`
+- VM/Bare Metal: `<KEYCLOAK_HOME>/themes/`
+
+Danach muss dort existieren:
+
+- `/opt/keycloak/themes/kusche-desktop/login/theme.properties`
+
+## 2. Keycloak neu laden
+
+Wenn du in Entwicklung arbeitest:
+
+- Keycloak neu starten
+
+Wenn du in Produktion Theme-Caches aktiv hast:
+
+1. Keycloak stoppen oder neu starten
+2. falls noetig Theme-Cache loeschen:
+   - `data/tmp/kc-gzip-cache`
+
+## 3. Theme nur fuer 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
+
+Wichtig:
+
+- Das Theme soll **nicht** pauschal als Realm-Login-Theme fuer alle Clients gesetzt werden, wenn andere Clients das Standard-Keycloak-Login behalten sollen.
+
+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
+- falls nicht vorhanden, bleibt als saubere Alternative nur:
+  - eigener Realm fuer Desktop
+  - oder spaeter ein Theme Selector SPI
+
+## 4. Testen
+
+Danach testen:
+
+1. `https://staging.desktop.kusche.berlin`
+2. `https://desktop.kusche.berlin`
+
+Erwartung:
+
+- fuer den Client `desktop-kusche-berlin` erscheint das neue Desktop-Login-Theme
+- nach erfolgreichem Login geht es zur Desktop-Shell zurueck
+
+## 5. Falls das Theme nicht erscheint
+
+Dann diese Punkte pruefen:
+
+- Theme-Ordner liegt wirklich im Keycloak-`themes/`-Verzeichnis
+- Verzeichnisname ist exakt `kusche-desktop`
+- `theme.properties` liegt unter `kusche-desktop/login/`
+- Keycloak wurde nach dem Kopieren neu gestartet
+- Cache wurde geleert
+- wirklich der Client `desktop-kusche-berlin` wird verwendet
+
+## 6. Welche Datei du spaeter bei Aenderungen ersetzt
+
+Wenn du nur Styling aendern willst, reicht meist:
+
+- `theme/kusche-desktop/login/resources/css/desktop-kusche.css`
+
+Wenn du die Struktur aendern willst:
+
+- `theme/kusche-desktop/login/login.ftl`
+
+## 7. Was ich bewusst nicht fuer dich serverseitig tue
+
+Diese Schritte musst du selbst auf dem Keycloak-System machen:
+
+- Dateien nach Keycloak kopieren
+- Keycloak neu starten
+- Client-Theme-Override setzen
+
+Das Projekt hier erzeugt nur den fertigen Theme-Ordner.