Zum Inhalt springen
Trainingslager IT-Trainingslager

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 mit kcadm, curl oder 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/notes

Erwartet:

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 -n

Erwartet:

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.refresh

Lösung

kcadm create users/$(uid ben)/logout -r lab

In 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,waitIncrementSeconds

Erwartet:

{
  "bruteForceProtected" : true,
  "waitIncrementSeconds" : 120,
  "failureFactor" : 5
}

Lösung

kcadm update realms/lab -s failureFactor=5 -s waitIncrementSeconds=120

Fortschritt 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 | sort

Erwartet: 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/anhb

Erwartet:

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/anhb

Erwartet:

["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/anhb

Erwartet:

Apply complete! Resources: 2 added, 0 changed, 0 destroyed.

Fortschritt speichern? Kostenlos registrieren

Wissenstest

  1. Warum gehört der Password Grant nicht in eine echte Anwendung?
  2. Was ist der Unterschied zwischen einer Realm-Rolle und einer Client-Rolle im Token?
  3. Warum liefert die Introspection active:false, obwohl das Token gültig ist?
  4. Ein Benutzer wurde im LDAP aus einer Gruppe entfernt, darf in Keycloak aber weiter schreiben. Woran liegt das, und was hilft?
  5. Warum verlangt ein AD für den Bind eine verschlüsselte Verbindung, und was braucht Keycloak dafür?
  6. Warum funktionieren Passkeys erst ab Tag 12?
  7. Was passiert mit allen Tokens, wenn sich KC_HOSTNAME ändert?
  8. Woher weiß der Operator, ob er ein Upgrade rolling durchführen darf?
  9. Warum liefert Keycloak bei einem gesperrten Konto dieselbe Meldung wie bei einem falschen Passwort?
  10. Was gehört nicht ins Git, wenn du Keycloak mit Terraform verwaltest?

Antworten

  1. 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).
  2. Realm-Rollen stehen unter realm_access.roles, Client-Rollen unter resource_access.<client>.roles – und setzen den Client zusätzlich in aud (Tag 5, Tag 15).
  3. Seit Keycloak 26 darf nur ein Client introspizieren, der im aud des Tokens steht; der Grund steht im Log, nicht in der Antwort (Tag 3, Tag 5).
  4. Der User-Cache: Keycloak liest Gruppen erst wieder, wenn der Benutzer nicht mehr im Cache liegt. clear-user-cache oder eine kürzere Cache-Policy hilft (Tag 8).
  5. 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).
  6. WebAuthn gibt es nur im sicheren Kontext, also mit HTTPS und einem Zertifikat, dem der Browser vertraut (Tag 10, Tag 12).
  7. iss ändert sich. Anwendungen, Broker und SAML-Partner müssen die neue Adresse kennen; alte Tokens passen nicht mehr zum Issuer (Tag 12).
  8. Er lässt einen Update-Job laufen, der wie kc.sh update-compatibility check alte und neue Version vergleicht (Tag 12, Tag 14).
  9. 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).
  10. 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.