Keycloak Bootstrap Theme
Ein Login- und E-Mail-Theme für Keycloak auf Basis von Bootstrap: hell und dunkel ohne Flackern, Passkeys mit AutoFill, vier Sprachen und eine strikte Content Security Policy ohne unsafe-inline.
Seit
2025
Lizenz
MIT / Apache-2.0
Technologien
Die Herausforderung
Das Standard-Theme von Keycloak wirkt technisch und passt selten zum eigenen Auftritt. Eigene Themes kopieren oft Inline-Skripte mit, sodass eine strikte Content Security Policy nicht möglich ist, und neue Funktionen wie Passkeys fehlen.
Die Lösung
Ein vollständiges Login- und E-Mail-Theme auf Basis des Sign-in-Beispiels von Bootstrap, in reinem FreeMarker und CSS. Es unterstützt Passkeys mit Anmelde-Knopf, AutoFill und Registrierung, dazu OTP, Registrierung und Passwort-Reset, und kommt ohne Inline-Skripte aus.
Was das Theme bietet
Passkeys
Anmelde-Knopf, bedingte Anzeige im AutoFill des Browsers und Registrierung neuer Passkeys; die WebAuthn-Module werden beim Bau aus Keycloak selbst übernommen.
Hell und dunkel
Beide Designs ohne kurzes Aufblitzen der falschen Farben, laut README mit Kontrasten nach WCAG AA.
Einstellbar
Logo, Favicon, Copyright-Jahr, Signatur pro Realm und ein Cache-Buster über theme.properties; Sprachen Deutsch, Englisch, Französisch und Spanisch.
Strikte Content Security Policy
Das Theme kommt ohne Inline-Skripte und Inline-Styles aus und läuft unter script-src 'self' und style-src 'self'. Ein kleines Python-Werkzeug liest die Hashes, die Keycloak selbst noch einbettet, aus einer laufenden Instanz und gibt eine passende CSP aus. Meldungen werden über kcSanitize ausgegeben.
Build
Ein mehrstufiges Dockerfile übernimmt die WebAuthn-Module aus dem Keycloak-Image, verkleinert CSS und JavaScript mit PurgeCSS, csso und terser und liefert wahlweise ein komplettes Keycloak-Image oder nur den Theme-Ordner. GitLab CI prüft den Build, die Artefakte und dass das CSS unter 100 KB bleibt.
Einsatz und Lizenz
Kein React, kein Node zur Laufzeit und kein CDN: Das Theme besteht aus FreeMarker-Vorlagen, CSS und wenig JavaScript. Der eigene Code steht unter der MIT-Lizenz, von Keycloak abgeleitete Vorlagen zusätzlich unter Apache-2.0.
Datenschutz
Alle Schriften, Stile und Skripte kommen vom eigenen Keycloak-Server, Anfragen an Dritte stellt das Theme nicht.
Ergebnisse
Ein modernes Keycloak-Theme, das Passkeys unterstützt, zum eigenen Auftritt passt und sich mit einer strikten Content Security Policy betreiben lässt.
Galerie
Bilder aus dem GitHub-Repository des Projekts.