Vorwort
Wenig lesen, viel tippen. In den Docker-Büchern ist die Anwendung
notes entstanden, in „Kong zum Anfassen” hat sie ein
Gateway bekommen. Was ihr fehlt, ist ein Login: Wer bist du, was darfst
du, und wie meldest du dich an, ohne dass jede Anwendung ihre eigene
Benutzerverwaltung mitbringt?
Die Antwort heißt Keycloak. Du lernst es von unten nach oben: erst
Keycloak mit Postgres, Realms, Benutzer und Rollen, dann OpenID Connect
und was in einem Token steht. notes bekommt einen echten Login im
Browser, und die API prüft Tokens selbst. Danach kommen die Benutzer aus
einem Verzeichnis, aus OpenLDAP und zum Vergleich aus einem Active
Directory mit Samba. Es folgen MFA, eigene Anmeldeabläufe, ein eigenes
Aussehen, der Betrieb hinter TLS mit zwei Instanzen, Automatisierung mit
REST, kcadm.sh und Terraform und am Ende der
Keycloak-Operator in Kubernetes.
Das Buch richtet sich an Entwickler, Platform- und Ops-Leute, die Docker beherrschen und Anmeldung zentral lösen wollen: Single Sign-on für eigene Anwendungen, Benutzer aus dem Firmenverzeichnis, MFA und ein Betrieb, der auch nachts hält.
Die Trainingsregeln
- Tippen, nicht kopieren. Jeder Befehl einmal selbst.
- Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
- Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
- Challenge allein lösen. Erst den Hinweis, dann die Lösung.
- Lab-Werte bleiben im Lab.
lab-admin-pw-123,lab-user-pw-123,lab-ldap-pw-123und alle anderenlab-…-Werte sind Übungsdaten. Echte Tokens gibst du nie aus, auch im Labor nicht.
Achtung: Alle Ausgaben und Bilder stammen aus echten Testläufen. IDs, Zeiten, IP-Adressen und Schlüssel werden bei dir abweichen. Entscheidend ist, was passiert.
Aufbau jedes Trainingstags
| Abschnitt | Zweck |
|---|---|
| Briefing | Das Nötigste in wenigen Stichpunkten |
| Drills | Befehle mit erwarteter Ausgabe, Bilder der Oberfläche |
| Kontrollpunkt | Einzelne Prüfbefehle: hat alles geklappt? |
| Challenge | Eine Aufgabe ohne Anleitung |
| Enterprise-Notiz | Was in Produktion anders ist |
Der Trainingsplan
| Teil | Tag | Einheit |
|---|---|---|
| 1 – Grundlagen | 0 | Das Trainingsgelände |
| 1 | Erster Start mit Postgres | |
| 2 | Benutzer, Gruppen, Rollen | |
| 3 | OIDC und Tokens | |
| 4 | notes mit Login | |
| 5 | Mapper, Scopes, Audience | |
| 2 – Verzeichnis | 6 | OpenLDAP |
| 7 | User Federation mit LDAP | |
| 8 | Gruppen und Rollen aus LDAP | |
| 9 | Active Directory mit Samba | |
| 3 – Sicherheit und Anpassung | 10 | MFA, Passwort-Policies, Brute-Force-Schutz |
| 11 | Flows, Identity Brokering, SAML, Theme | |
| 4 – Betrieb | 12 | Proxy, TLS, zwei Instanzen, Export, Upgrade |
| 13 | Automatisierung | |
| 14 | Keycloak-Operator auf k3s | |
| Wettkampf | 15 | Desaster-Drills |
| Anhang | A | Spickzettel |
| B | Abschlussprüfung |
Das Labor
Gearbeitet wird auf einer Ubuntu-24.04-VM kc mit 2 CPUs
und 4 GB RAM, die du per Multipass startest, per SSH auf der VM. Den
Browser öffnest du auf dem Laptop. Für Tag 14 kommt eine VM
k3s dazu. Jede andere Ubuntu-VM mit SSH, sudo
und Internetzugang tut es auch.
Die getesteten Versionen: Keycloak 26.8.1 (für die Upgrade-Drills
auch 26.8.0), Postgres 18.6, oauth2-proxy 7.15.5, OpenLDAP 2.6.10 aus
Debian 13, Samba 4.25.1, Caddy 2.11.7, Terraform 1.17.1 mit dem Provider
keycloak/keycloak 5.10.0, k3s v1.36.5 und der
Keycloak-Operator 26.8.1.
Den Begleitcode findest du unter
https://github.com/thomaszachmann/keycloak-zum-anfassen;
Tag 0 holt ihn per git clone.
Wo dieses Buch einen Bereich nur anreißt, gehen die Schwesterbücher in die Tiefe: „Docker Compose zum Anfassen” für das Backend, „Kong zum Anfassen” für das Gateway vor der API, „Kubernetes zum Anfassen” für Tag 14.
Los geht’s.