Anhang B: Abschlussprüfung
Ziel: Ohne Anleitung zeigen, dass du Keycloak betreiben kannst: Clients und Benutzer anlegen, Sitzungen beenden, Angriffe bremsen, sichern und als Code pflegen. · Dauer: ca. 90 min · Voraussetzung: Tag 15
Spielregeln
- Jede Übung beschreibt nur das Ziel. Den Weg findest du selbst; die Tage in Klammern helfen beim Nachschlagen.
- Jede Übung endet mit einem Prüfblock: einzelne Befehle mit dem, was sie zeigen müssen. Erst wenn alle stimmen, gilt die Übung.
- Arbeite in
~/kc-lab/anhb. Übung 6 verlangt Terraform, alles andere geht mitkcadm,curloder der Konsole.
source ~/kc-lab/setup/env.sh
mkdir -p ~/kc-lab/anhb && cd ~/kc-lab/anhb
kclogin
api() { docker run --rm --network lab curlimages/curl:8.17.0 -s "$@"; }
uid() { kcadm get users -r lab -q username=$1 -q exact=true | jq -r '.[0].id'; }Übung 1: Eine App fürs Handy
Lege im Realm lab den Client notes-mobile an: öffentlich
(ohne Secret), nur Authorization Code, PKCE mit S256 ist
Pflicht, Rücksprung nach http://localhost:8765/cb. (Tag 3,
Tag 4)
Prüfblock:
kcadm get clients -r lab -q clientId=notes-mobile | jq -c '.[0] | {publicClient,
directAccessGrantsEnabled, pkce: .attributes["pkce.code.challenge.method"]}'
A="$KC_URL/realms/lab/protocol/openid-connect/auth?client_id=notes-mobile"
A="$A&response_type=code&scope=openid&redirect_uri=http://localhost:8765/cb"
curl -s -o /dev/null -w '%{redirect_url}\n' "$A" | grep -o 'error_description=[^&]*'Erwartet:
{"publicClient":true,"directAccessGrantsEnabled":false,"pkce":"S256"}
error_description=Missing+parameter%3A+code_challenge_method
Ohne code_challenge schickt Keycloak den Browser mit
einem Fehler zurück.
Lösung
kcadm create clients -r lab -s clientId=notes-mobile -s publicClient=true \
-s standardFlowEnabled=true -s directAccessGrantsEnabled=false \
-s 'redirectUris=["http://localhost:8765/cb"]' \
-s 'attributes."pkce.code.challenge.method"=S256'Erwartet:
Created new client with id '…'
Fortschritt speichern? Kostenlos registrieren
Übung 2: Eine neue Kollegin
lena ([email protected], Passwort
lab-user-pw-lena) soll in notes schreiben dürfen – über die
Gruppe, nicht über direkt vergebene Rollen. (Tag 2, Tag 4)
Prüfblock:
kcadm get users/$(uid lena)/groups -r lab | jq -r '.[].name'
api -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $(token lena lab-user-pw-lena)" \
-H 'Content-Type: application/json' -d '{"text":"von lena"}' notes-api:8080/notesErwartet:
team-notes
201
Lösung
kcadm create users -r lab -s username=lena -s enabled=true -s [email protected] \
-s emailVerified=true -s firstName=Lena -s lastName=Neu
kcadm set-password -r lab --username lena --new-password lab-user-pw-lena
GID=$(kcadm get groups -r lab -q search=team-notes \
| jq -r '.[] | select(.name=="team-notes") | .id')
kcadm update users/$(uid lena)/groups/$GID -r lab -nErwartet:
Created new user with id '…'
Fortschritt speichern? Kostenlos registrieren
Übung 3: Alle Sitzungen von ben
bens Laptop ist gestohlen. Beende alle seine Sitzungen, sodass auch seine Refresh Tokens nichts mehr wert sind. (Tag 3, Tag 12)
Prüfblock:
kcadm get users/$(uid ben)/sessions -r lab | jq length
curl -s -d grant_type=refresh_token -d client_id=notes-cli \
-d client_secret=lab-client-secret-123 -d refresh_token=$(cat ben.refresh) \
$KC_URL/realms/lab/protocol/openid-connect/token | jq -c '{error, error_description}'Erwartet:
0
{"error":"invalid_grant","error_description":"Session not active"}
Den Refresh Token in ben.refresh legst du vorher an – er
steht für „ben war angemeldet”:
curl -s -d grant_type=password -d client_id=notes-cli \
-d client_secret=lab-client-secret-123 -d username=ben -d password=lab-user-pw-456 \
$KC_URL/realms/lab/protocol/openid-connect/token | jq -r .refresh_token > ben.refreshLösung
kcadm create users/$(uid ben)/logout -r labIn der Konsole: Users → ben → Sessions → Sign out all sessions. Access Tokens bleiben bis zu ihrem Ablauf gültig – ein Grund für kurze Laufzeiten.
Fortschritt speichern? Kostenlos registrieren
Übung 4: Weniger empfindlich
Tag 10 sperrt nach drei Fehlversuchen. Stell den Realm auf fünf Versuche und zwei Minuten Wartezeit um. (Tag 10)
Prüfblock:
kcadm get realms/lab --fields bruteForceProtected,failureFactor,waitIncrementSecondsErwartet:
{
"bruteForceProtected" : true,
"waitIncrementSeconds" : 120,
"failureFactor" : 5
}
Lösung
kcadm update realms/lab -s failureFactor=5 -s waitIncrementSeconds=120Fortschritt speichern? Kostenlos registrieren
Übung 5: Partner sichern
Exportiere den Realm partner samt Benutzern als
~/kc-lab/anhb/partner-realm.json. (Tag 12)
Prüfblock:
jq -r '.realm' ~/kc-lab/anhb/partner-realm.json
jq -r '.users[].username' ~/kc-lab/anhb/partner-realm.json | sortErwartet: der Realm mit pia und der Kopie von anna aus dem SAML-Login.
partner
anna
pia
Lösung
cd ~/kc-lab/keycloak
docker compose run --rm --no-deps -v ~/kc-lab/anhb:/export keycloak \
export --dir /export --realm partner --users realm_file 2>&1 \
| grep -o 'KC-SERVICES0035.*'
cd ~/kc-lab/anhbErwartet:
KC-SERVICES0035: Export finished successfully
Fortschritt speichern? Kostenlos registrieren
Übung 6: uwe als Code
uwe ([email protected], Passwort
lab-user-pw-uwe) kommt in die Gruppe berichte
– angelegt mit Terraform im Projekt aus Tag 13, in einer eigenen Datei
uwe.tf. (Tag 13)
Prüfblock:
jwt "$(token uwe lab-user-pw-uwe)" \
| jq -c '[.realm_access.roles[] | select(startswith("notes"))]'
cd ~/kc-lab/terraform
terraform plan -no-color -detailed-exitcode >/dev/null; echo "exit=$?"
cd ~/kc-lab/anhbErwartet:
["notes-berichte"]
exit=0
Lösung
cd ~/kc-lab/terraform
export TF_VAR_kc_url=$KC_URL TF_VAR_client_secret=lab-client-secret-123
cat > uwe.tf <<'EOF'
resource "keycloak_user" "uwe" {
realm_id = data.keycloak_realm.lab.id
username = "uwe"
email = "[email protected]"
first_name = "Uwe"
last_name = "Bericht"
initial_password {
value = "lab-user-pw-uwe"
temporary = false
}
}
resource "keycloak_user_groups" "uwe" {
realm_id = data.keycloak_realm.lab.id
user_id = keycloak_user.uwe.id
group_ids = [keycloak_group.berichte.id]
}
EOF
terraform apply -auto-approve -no-color | grep -E 'Apply complete'
cd ~/kc-lab/anhbErwartet:
Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
Fortschritt speichern? Kostenlos registrieren
Wissenstest
- Warum gehört der Password Grant nicht in eine echte Anwendung?
- Was ist der Unterschied zwischen einer Realm-Rolle und einer Client-Rolle im Token?
- Warum liefert die Introspection
active:false, obwohl das Token gültig ist? - Ein Benutzer wurde im LDAP aus einer Gruppe entfernt, darf in Keycloak aber weiter schreiben. Woran liegt das, und was hilft?
- Warum verlangt ein AD für den Bind eine verschlüsselte Verbindung, und was braucht Keycloak dafür?
- Warum funktionieren Passkeys erst ab Tag 12?
- Was passiert mit allen Tokens, wenn sich
KC_HOSTNAMEändert? - Woher weiß der Operator, ob er ein Upgrade rolling durchführen darf?
- Warum liefert Keycloak bei einem gesperrten Konto dieselbe Meldung wie bei einem falschen Passwort?
- Was gehört nicht ins Git, wenn du Keycloak mit Terraform verwaltest?
Antworten
- Die Anwendung sieht das Passwort, MFA, Passkeys und Brokering gehen nicht, und Required Actions blockieren ihn. Browser-Anwendungen nehmen Authorization Code mit PKCE (Tag 3, Tag 10).
- Realm-Rollen stehen unter
realm_access.roles, Client-Rollen unterresource_access.<client>.roles– und setzen den Client zusätzlich inaud(Tag 5, Tag 15). - Seit Keycloak 26 darf nur ein Client introspizieren, der im
auddes Tokens steht; der Grund steht im Log, nicht in der Antwort (Tag 3, Tag 5). - Der User-Cache: Keycloak liest Gruppen erst wieder, wenn der
Benutzer nicht mehr im Cache liegt.
clear-user-cacheoder eine kürzere Cache-Policy hilft (Tag 8). - Ein einfacher Bind schickt das Passwort mit. AD verlangt darum LDAPS; Keycloak braucht die CA des Domain Controllers im Truststore und den richtigen Namen im Zertifikat (Tag 9).
- WebAuthn gibt es nur im sicheren Kontext, also mit HTTPS und einem Zertifikat, dem der Browser vertraut (Tag 10, Tag 12).
issändert sich. Anwendungen, Broker und SAML-Partner müssen die neue Adresse kennen; alte Tokens passen nicht mehr zum Issuer (Tag 12).- Er lässt einen Update-Job laufen, der wie
kc.sh update-compatibility checkalte und neue Version vergleicht (Tag 12, Tag 14). - Damit ein Angreifer nicht erfährt, dass er ein Konto gesperrt hat – oder dass es das Konto überhaupt gibt. Den Grund zeigt das Log (Tag 10, Tag 15).
- Der State (
terraform.tfstate) und Secrets. Der State enthält Passwörter und Client-Secrets im Klartext (Tag 13).
Wie geht es weiter?
- Kong zum Anfassen: Keycloak-Tokens am API-Gateway prüfen, mit Plugins und Rate Limiting.
- Kubernetes zum Anfassen: der Cluster unter dem Operator, mit Helm und RKE2.
- Weiter mit Keycloak: Organizations für mandantenfähige Logins, eigene Provider (SPI) in Java, Fine-grained Admin Permissions, Keycloakify für eigene Login-Seiten.