93 lines
2.4 KiB
Markdown
93 lines
2.4 KiB
Markdown
# 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.
|