Files
desktop/docs/keycloak-theme-handoff.md
Lars Gebhardt-Kusche 1ae7b98378
All checks were successful
Deploy / deploy-staging (push) Successful in 46s
Deploy / deploy-production (push) Has been skipped
keycloak
2026-06-08 02:45:36 +02:00

1.8 KiB

Keycloak Theme Handoff

Diese Datei beschreibt die Uebergabepunkte zwischen der Desktop-Shell und dem spaeteren Keycloak-Login-Theme.

Zielbild

  • Keycloak bleibt das Auth-System.
  • desktop.kusche.berlin bekommt ein eigenes Keycloak-Theme.
  • Das Login soll sich wie ein Desktop-Login anfuehlen und visuell zur Shell passen.

Design-Bausteine

  • Wallpaper oder Verlauf passend zum aktiven Branding
  • zentrierte Login-Kachel
  • grosse Uhr oder Statusanzeige
  • Logo und Produktname Kusche.Berlin
  • ruhige Desktop-artige Animationen

Technische Schnittstellen

  • Desktop-Shell verweist auf die Login-App desktop-login.
  • Root / kann jetzt vor der Desktop-Shell auf einen eigenen Login-Screen umleiten.
  • Login-Handoff zu Keycloak laeuft ueber /auth/keycloak.
  • Callback-Endpunkt ist unter /auth/callback vorbereitet.
  • Keycloak-Theme liegt spaeter getrennt im Keycloak-Theme-System.
  • Gemeinsame Branding-Werte sollten aus einer zentralen Theme-Definition abgeleitet werden.

Aktueller Stand im Projekt

  • config/keycloak.php enthaelt die Grundkonfiguration.
  • config/<env>/keycloak.php kann die Werte je Umgebung ueberschreiben.
  • public/auth/login/ rendert den Desktop-Login-Screen.
  • public/auth/keycloak/ leitet auf die Keycloak-Authorize-URL weiter.
  • public/auth/callback/ prueft den Ruecksprungzustand, tauscht den Authorization Code gegen Token und legt die Session an.
  • public/auth/logout/ beendet die lokale Session und kann Keycloak-Logout anstossen.

Zu erledigen ausserhalb dieser V1

  • Keycloak-Theme erzeugen
  • Theme dem passenden Client oder Realm zuweisen
  • Login-Templates, CSS und Assets im Theme pflegen
  • Session-Validierung, Refresh und spaetere Token-Erneuerung sauber nachziehen
  • Ruecksprung aus Keycloak sauber in die Desktop-Shell fuehren