Zum Inhalt springen
Trainingslager IT-Trainingslager

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

  1. Tippen, nicht kopieren. Jeder Befehl einmal selbst.
  2. Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
  3. Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
  4. Challenge allein lösen. Erst den Hinweis, dann die Lösung.
  5. Lab-Werte bleiben im Lab. lab-admin-pw-123, lab-user-pw-123, lab-ldap-pw-123 und alle anderen lab-…-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.