Open Source 2025

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

Login hell
4
Sprachen: DE, EN, FR, ES
2
Designs: hell und dunkel
0
unsafe-inline in der CSP
100 KB
CSS-Grenze, in CI geprüft

Technologien

Keycloak FreeMarker Bootstrap WebAuthn / Passkeys Content Security Policy Docker GitLab CI PurgeCSS csso terser

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.