[email protected]

Keycloak 26.8 Upgrade: Checkliste mit Breaking Changes und CVE-Fixes

Keycloak 26.8 Upgrade: Checkliste mit Breaking Changes und CVE-Fixes

Hinweis zum Inhalt: Die Informationen in diesem Artikel wurden nach bestem Wissen zum Zeitpunkt der Veröffentlichung zusammengestellt. Technische Details, Preise, Versionen, Lizenzmodelle und externe Inhalte können sich ändern. Bitte prüfen Sie die genannten Angaben eigenständig, insbesondere vor geschäftskritischen oder sicherheitsrelevanten Entscheidungen. Dieser Artikel ersetzt keine individuelle Fach-, Rechts- oder Steuerberatung.

Keycloak-Upgrade mit Rückfallplan? WZ-IT prüft Ihre Konfiguration gegen die Änderungen in 26.8, testet das Upgrade auf einer Kopie und betreibt Keycloak auf Wunsch dauerhaft, siehe Keycloak bei WZ-IT. Termin vereinbaren

Aktualisierung vom 10. November 2026: Seit dem 5. November 2026 ist Keycloak 26.8.2 aktuell. Die beiden Patch-Releases 26.8.1 und 26.8.2 enthalten weitere Sicherheitskorrekturen (33 Einträge in 26.8.2) und Breaking Changes, siehe den Abschnitt Patch-Releases 26.8.1 und 26.8.2.

Keycloak 26.8.0 ist am 1. Oktober 2026 erschienen. Das Release bringt drei Keycloak-eigene Sicherheitskorrekturen (CVEs) und aktualisierte Abhängigkeiten, hebt SCIM, Client Secret Rotation und Multi-Cluster v2 auf den Status supported und führt Token-Exchange-Delegation für KI-Agenten als Preview ein. Für den Betrieb wichtiger sind die Änderungen im Upgrade-Handbuch: Mehrere Breaking Changes betreffen Identity-Provider-Mapper, Gruppen-Claims in Autorisierungsrichtlinien, Logout über Broker und die Admin-API.

Dieser Beitrag fasst die Änderungen als Checkliste zusammen, ordnet sie nach Auswirkung auf bestehende Installationen und beschreibt den Ablauf eines Minor-Upgrades. Die technischen Angaben beruhen auf den Release Notes und dem Upgrade-Handbuch von Keycloak, Stand 10. November 2026 (26.8.0 bis 26.8.2). Handlungsempfehlungen, Reihenfolgen und der Abschnitt zu unserem Vorgehen sind eigene Einschätzungen.

Inhaltsverzeichnis

  1. Keycloak 26.8.0 auf einen Blick
  2. Sicherheitskorrekturen in 26.8.0
  3. Patch-Releases 26.8.1 und 26.8.2: CVE-Fixes und Breaking Changes
  4. Breaking Changes vor dem Upgrade prüfen
  5. Geändertes Verhalten nach dem Upgrade
  6. Organizations: Identity Provider für mehrere Organisationen
  7. Abkündigungen und Ende des Realm Operators
  8. Neue Funktionen mit Status supported und preview
  9. Upgrade-Ablauf Schritt für Schritt
  10. Unser Vorgehen bei WZ-IT
  11. Weiterführende Guides

Keycloak 26.8.0 auf einen Blick

Merkmal Wert
Version 26.8.0
Veröffentlichung 1. Oktober 2026 (Release-Ankündigung, GitHub)
Vorherige Version 26.7.5 vom 30. September 2026 (GitHub)
Aktuelle Patch-Version (Stand 10. November 2026) 26.8.2 vom 5. November 2026 (Ankündigung, GitHub)
Quarkus 3.40 (in 26.7.0: 3.33)
Sicherheitskorrekturen 3 Keycloak-CVEs plus Abhängigkeiten
Upgrade-Art von 26.7 Minor-Upgrade, kein Rolling Update
Neu supported SCIM-API, Client Secret Rotation, Multi-Cluster v2 (stateless)
Neu preview Token-Exchange-Delegation, OID4VCI, Parameterized Scopes, Client Admin API v2

Wichtig für die Planung: Keycloak unterstützt seit 26.6.0 Rolling Updates nur für Patch-Releases innerhalb derselben Minor-Version. Der Schritt von 26.7.x auf 26.8.0 erfordert laut Upgrade-Handbuch das Herunterfahren aller Knoten. Im Standardbetrieb gehen laufende Anmeldevorgänge dabei verloren, Benutzer müssen sie neu starten.

Sicherheitskorrekturen in 26.8.0

Die Release Notes führen folgende Sicherheitskorrekturen auf:

CVE Bereich Problem GitHub
CVE-2026-12388 Identity Brokering Administratoren mit manage-identity-providers konnten über IdP-Mapper administrative Rollen vergeben und so ihre Rechte ausweiten #50444
CVE-2026-14781 OIDC-Broker Bei trustEmail=true und aktivem Userinfo-Endpunkt wurde email_verified aus dem ID-Token auf eine abweichende E-Mail aus Userinfo angewendet #50618
CVE-2026-19608 Authorization Services Gruppen-Claims nur mit Namen ließen gleichnamige Gruppen an anderer Stelle der Hierarchie Gruppenrichtlinien erfüllen #51865
CVE-2026-54515, CVE-2026-59889 Abhängigkeit jackson-databind #52168
CVE-2026-59903 Abhängigkeit netty-codec-http #52169

Die drei Keycloak-eigenen CVEs tragen in GitHub die Priorität "important". In den Release Notes von 26.7.5 sind sie nicht aufgeführt. 26.7.5 behebt andere Lücken, darunter CVE-2026-93999 (deaktivierte Clients in der Token-Audience) und CVE-2026-89298 (Client-Secret für view-clients über Client Registration). Wer auf 26.7 bleibt, sollte 26.7.5 einspielen; weitere 26.7-Versionen mit den Fixes der 26.8-Reihe sind laut GitHub bis zum 10. November 2026 nicht erschienen. Zusätzlich listen die Release Notes 84 als "Weaknesses" markierte Einträge, darunter Härtungen in SCIM, OID4VCI und der Admin-API.

Patch-Releases 26.8.1 und 26.8.2: CVE-Fixes und Breaking Changes

Nach 26.8.0 sind zwei Patch-Releases erschienen. Beide enthalten Sicherheitskorrekturen und Breaking Changes. Das Upgrade-Handbuch schreibt dazu, dass Keycloak in Minor- und Patch-Releases Breaking Changes nur zur Behebung von Fehlern einführt. Die Zahlen stammen aus den Release Notes und dem Handbuch (Stand 10. November 2026):

Version Veröffentlicht Einträge unter "Security fixes" Breaking changes Notable changes
26.8.1 13. Oktober 2026 22, davon 19 mit CVE-Kennung im Titel 6 4
26.8.2 5. November 2026 33, jeder mit eigener CVE-Kennung 14 5

In 26.8.1 sind zwei der 22 Einträge Sammelmeldungen zu Abhängigkeiten (jackson-databind, simple-git) und einer beschreibt ein instabiles Testszenario unter dieser Überschrift. Die Ankündigungen geben keine Schweregrade an. Eine Auswahl der Einträge aus 26.8.2, Kennungen und Kurzbeschreibung nach den Titeln der Keycloak-Issues:

CVE Gegenstand Issue
CVE-2026-117691 SAML-Broker mit Redirect-Binding: Umgehung der Signaturprüfung über einen prozentkodierten Parameternamen, Anmeldung als beliebiger Benutzer #54714
CVE-2026-103112 Account-Übernahme über eine Race Condition bei der Authentifizierung #54706
CVE-2026-112208 Account-Übernahme über einen veralteten SSO_AUTH-Vermerk im Identity-First-Login von Organizations #54688
CVE-2026-97175 Automatisches Verknüpfen von Konten über eine nicht verifizierte IdP-E-Mail-Adresse #54707
CVE-2026-107889 Stored XSS auf der Login-Seite über eine Umgehung von kcSanitize #53813
CVE-2026-110931 Beenden der JVM ohne Anmeldung durch eine einzelne Anfrage über den SAML-1.1-Parser (laut Titel unvollständige Korrektur von CVE-2026-7307) #54693
CVE-2026-110932 Dauerhafte Erschöpfung des Festplattenplatzes ohne Anmeldung über den Theme-Gzip-Cache (laut Titel Keycloak bis einschließlich 26.8.0) #54689
CVE-2026-97847 Ein Client-Manager kann den Principal eines sessionlosen Tokens ersetzen und den Realm übernehmen #54697

Die vollständigen Listen stehen in den Release Notes von 26.8.1 und 26.8.2. Eine 26.7-Version nach 26.7.5 ist auf GitHub weder als Release noch als Tag vorhanden. Die Release Notes enthalten keine vollständige Liste betroffener Versionen, einzelne Einträge nennen Versionen in ihrem Titel (Issue 54688: reproduziert auf 26.8.1; Issue 54689: bis einschließlich 26.8.0). Ob eine ältere Version betroffen ist, ist je CVE im Issue zu prüfen.

Breaking Changes in 26.8.2. Die folgende Auswahl stammt aus dem Abschnitt Migrating to 26.8.2 des Upgrade-Handbuchs (Quelltext: changes-26_8_2.adoc):

Änderung Wer betroffen ist Was zu tun ist
Admin REST API prüft die Audience Eigene Clients und Service-Accounts, die Tokens für die Admin REST API holen Client-Scope kc-admin-api als Default- oder Optional-Scope zuweisen (ein Optional-Scope muss beim Token-Abruf angefordert werden), sonst 401 (das Token braucht Audience und Scope); admin-cli und security-admin-console erhalten ihn automatisch
Protokoll-Mapper nur noch für Realm-Administratoren Delegierte Client-Administratoren, die Mapper über die Admin REST API verwalten Berechtigung zum Verwalten des Realms vergeben oder erlaubte Mapper-Typen unter "Allowed protocol mapper types for client administrators" eintragen; leer ist der Standard und blockiert die Mapper-Verwaltung
Dynamic Client Registration: Mapper-Typen, Default Roles, Full Scope (Default Roles und Full Scope: CVE-2026-109081) Nutzer der Dynamic Client Registration Mapper-Typen in der Client-Registration-Policy und in der Realm-Option freigeben; die Policy Default Roles Disabled ist neu, Full Scope Disabled gilt nun auch für authentifizierte Registrierung (bei anonymer Registrierung war sie bereits vorhanden); verbotene Änderungen liefern 403; Rolling Upgrade nicht unterstützt
SAML-Broker: Bearer-Bestätigung Pflicht, ProxyRestriction abgelehnt Setups mit einem Upstream-SAML-Identity-Provider Upstream muss eine Bearer-SubjectConfirmation mit SubjectConfirmationData liefern; bei ProxyRestriction den Schalter "Reject proxy restriction" je Identity Provider prüfen
SAML-Adapter prüft den Issuer Adapter mit entityID "idp" oder einem Wert abweichend von der Realm-URL entityID auf die Realm-URL setzen, Konfiguration in der Admin Console neu herunterladen
SAML-Back-Channel-Logout über SessionIndex SAML-Clients ohne "Client signature required" Signaturpflicht aktivieren und LogoutRequests signieren oder Front-Channel-Logout nutzen
Auto-Linking braucht eine vertrauenswürdige E-Mail-Adresse (CVE-2026-97175) Identity Provider, deren E-Mail-Adresse nicht als verifiziert gilt (etwa SAML oder eigene Provider ohne email_verified-Claim) "Trust Email" nur aktivieren, wenn der Provider E-Mail-Adressen tatsächlich verifiziert
Organizations: E-Mail-Verifizierung vor Domain-Mitgliedschaft Organisationen mit Domains und verknüpften Identity Providern SMTP vor dem Upgrade testen, Trust-Email-Einstellung prüfen, bisherige Mitgliedschaften prüfen (sie werden nicht neu bewertet)
Token Exchange: exp von Access- und ID-Token durch den Subject Token begrenzt Clients mit Standard Token Exchange Verhalten einplanen (Refresh Tokens regelt ein eigener Schalter); den Schalter "Allow exchange token expiration after subject token expiration" nur bei Bedarf aktivieren, das Handbuch empfiehlt, ihn aus zu lassen
CIBA: reservierte Parameternamen CIBA-Clients mit Namen wie sub, iss, aud als Formparameter Parameter umbenennen, sonst invalid_request
SAML-SOAP-Endpunkte begrenzt Nutzer der SOAP-Bindings Anfragen sind standardmäßig auf 120000 Bytes begrenzt; Anpassung über die Option spi-login-protocol--saml--max-soap-message-request-size

Als Notable changes nennt das Handbuch für 26.8.2 unter anderem, dass das Parsen von SAML 1.1 standardmäßig deaktiviert ist und dass der Client admin-permissions bei Fine-Grained Admin Permissions V2 als interner Client behandelt wird (Änderungen daran liefern 403).

Breaking Changes in 26.8.1. Laut Migrating to 26.8.1: Bei aktiviertem "Enable StartTLS" scheitert der E-Mail-Versand, wenn der SMTP-Server kein STARTTLS anbietet, statt in Klartext zurückzufallen (CVE-2026-107121). Backchannel-Logout-Tokens von OIDC-Identity-Providern werden immer auf Signatur geprüft, auch wenn "Validate Signatures" aus ist, dafür sind JWKS-URL oder öffentlicher Schlüssel zu hinterlegen (CVE-2026-18569). Wer per API ein Feld ändert, das bestimmt, wohin das Client-Secret gesendet wird (etwa tokenUrl oder clientId), und dabei den maskierten Secret-Wert zurückschickt, erhält 400 Bad Request; das tatsächliche clientSecret ist mitzusenden, bei Secrets als Vault-Ausdruck gilt das nicht (CVE-2026-15943). Dazu kommen drei Änderungen an den X.509-Authenticatoren: Key-Usage-Prüfung, CRL-Dateien nur aus dem Verzeichnis conf und ein Limit von 10 MB für CRL- und OCSP-Antworten. Als Notable changes nennt das Handbuch unter anderem, dass das Semikolon kein Parametertrenner mehr ist und dass "Skip OTP for Header" im Conditional-OTP-Authenticator einen vertrauenswürdigen Proxy voraussetzt.

Kein Rolling Update auf 26.8.2. Für den Wechsel auf 26.8.2 gilt eine Ausnahme von der Regel, dass Patch-Releases per Rolling Update eingespielt werden können. Die Migration der Client-Registration-Policies installiert einen Policy-Provider, den frühere 26.8.x-Knoten nicht kennen. Das Handbuch schreibt dazu: "A rolling upgrade is therefore not supported for this change; shut down the cluster and upgrade all nodes together (or use a recreate update)". Außerdem stellen alte Knoten ohne den Audience-Mapper Admin-Tokens ohne die geforderte Audience aus, die aktualisierte Knoten mit 401 ablehnen.

Breaking Changes vor dem Upgrade prüfen

Breaking Changes in Minor-Releases führt Keycloak nach eigener Aussage nur zur Behebung von Fehlern ein. In 26.8.0 sind es sechs Punkte, die sich direkt auf bestehende Konfigurationen auswirken können (Upgrade-Handbuch, Breaking changes):

Änderung Wer betroffen ist Was zu tun ist
IdP-Mapper vergeben standardmäßig keine Admin-Rollen mehr (CVE-2026-12388) Realms, in denen Mapper Admin-Rollen oder Gruppen mit Admin-Rollen zuweisen Pro Identity Provider "Allow granting admin roles via mappers" aktivieren (nur mit manage-realm), bestehende Zuweisungen prüfen
Client-Secret nur noch mit manage-clients Delegierte Admins oder Automatisierungen, die Secrets mit view-clients lesen Rolle manage-clients oder entsprechende FGAP-Berechtigung vergeben
Parameter initiating_idp beim Logout wird ignoriert Setups, die Upstream-Logout am Broker unterdrücken Auf OIDC Back-Channel- oder Front-Channel-Logout umstellen; Übergangsoption allow-initiating-idp-logout-param ist bereits abgekündigt
X509-Benutzer-Authentifizierung braucht CA Subject DN Realms mit X509-Login für Benutzer Vertrauenswürdige CA pro Authenticator eintragen; Pflicht ab dem nächsten Major-Release
Deaktivierte Clients nicht mehr in aud und resource_access Ressourcenserver, die auf diese Einträge prüfen Clientstatus und Audience-Prüfungen abgleichen
Normalisierte Resource-URIs in Authorization Services Richtlinien, die nach Matrix-Parametern, Punktsegmenten, Slash am Ende oder Query unterscheiden Ressourcen- und Richtlinienkonfiguration prüfen

Zusätzlich gehört CVE-2026-19608 in diese Prüfung, obwohl das Handbuch sie unter "Notable changes" führt: Gruppennamen ohne Pfad in Token-Claims werden nur noch auf Top-Level-Gruppen aufgelöst. Wer den Mapper "Group Membership" mit deaktiviertem "Full group path" nutzt und Richtlinien auf verschachtelte Gruppen bezieht, muss "Full group path" aktivieren, sonst greifen diese Richtlinien nicht mehr (Upgrade-Handbuch).

Geändertes Verhalten nach dem Upgrade

Diese Änderungen verändern Verhalten, Last oder Logs; einzelne verlangen Vorbereitung, etwa das Label an Operator-Secrets oder einen eigenen Cluster-Namen für stateless:

Änderung Auswirkung
Login-Fehlversuche in der Datenbank (login-failures:v2) Sperren nach Brute-Force-Erkennung überstehen Neustarts; mehr Datenbankverbindungen und CPU-Last auf der Datenbank möglich; Deployments mit den Features multi-site oder clusterless speichern die Daten weiter im externen Infinispan, login-failures:v1 ist abgekündigt, aber noch wählbar
Ablauf von Refresh Tokens Begrenzt durch das Session-Idle-Timeout; Offline-Refresh-Tokens haben immer einen exp-Claim
E-Mail-Verifizierung E-Mails gelten nur nach abgeschlossener Verifizierung als bestätigt, nicht mehr über Account-Linking per E-Mail oder Admin-Mails ohne Verify Email; Trust Email bei IdP und LDAP bleibt unberührt
Client Secret Rotation und SCIM-API Standardmäßig aktiviert; explizite Feature-Flags sind nicht mehr nötig
Feature stateless Nicht mehr über --features=preview aktiviert, sondern ausdrücklich als Feature stateless (z. B. --features=stateless); verlangt einen eigenen Cluster-Namen ungleich ISPN
Index-Erstellung Bei mehr als 300.000 Einträgen in OFFLINE_USER_SESSION (Standardschwelle, konfigurierbar) wird ein Index während der Migration übersprungen und danach im Hintergrund erstellt (PostgreSQL, Oracle, MySQL/MariaDB, bestimmte SQL-Server-Editionen; nur bei Datenbanken mit nicht-blockierender Indexerstellung, bei der Migrationsstrategie manual oder validate wird die SQL-Anweisung nur protokolliert)
Introspection act.sub Enthält die Benutzer-ID statt des Benutzernamens; Benutzername in act.preferred_username
NO_PROXY Einträge mit führendem Punkt oder Leerzeichen nach Komma werden seit 26.8 korrekt ausgewertet
kcadm und kcreg Setzen Konfigurationsdateien beim Schreiben von Zugangsdaten auf 0600
Operator: OIDC-Client-CRs Referenzierte Secrets brauchen das Label operator.keycloak.org/kind=KeycloakOIDCClient

Für Installationen mit großen Session-Tabellen ist der Index-Punkt relevant: Auf PostgreSQL nutzt Keycloak CREATE INDEX CONCURRENTLY und erkennt ungültige Indizes aus früheren Abbrüchen (Upgrade-Handbuch). Bei MySQL und MariaDB im Stateless-Modus setzt Keycloak die Isolationsstufe READ COMMITTED; ist Binary Logging mit binlog_format = STATEMENT aktiviert, schlagen Schreibvorgänge dann fehl. Unterstützte Datenbankversionen stehen im Datenbank-Guide, für PostgreSQL sind das 14 bis 18. Wer noch PostgreSQL 14 betreibt, sollte das Supportende von PostgreSQL 14 in die Planung einbeziehen.

Organizations: Identity Provider für mehrere Organisationen

Ein Identity Provider kann in 26.8 mehreren Organisationen zugeordnet werden, die Beziehung ist von viele-zu-eins auf viele-zu-viele umgestellt (Release-Ankündigung). Die Migration läuft automatisch, ändert aber das Datenmodell:

  • Bestehende Verknüpfungen werden mit Auto-Membership und Typ Managed übernommen, neue Verknüpfungen erhalten standardmäßig Unmanaged.
  • Das Domain-Routing wandert vom Identity Provider zur Domain. Die bisherige Ausschlussliste entfällt, ausgeschlossene Domains werden ohne zugeordneten Identity Provider migriert.
  • Einstellungen wie "Hide on login page when organization is not resolved" liegen seit 26.8 in den Einstellungen des Identity Providers auf Realm-Ebene.
  • Die Admin-REST-API ersetzt das Feld organizationId in IdentityProviderRepresentation durch Organisations-Links. Skripte und Terraform-Module, die dieses Feld setzen, müssen angepasst werden.
  • Mapper auf Organisationsgruppen speichern die Organisations-ID explizit; bei mehreren Organisationen ist je Organisation ein eigener Mapper nötig.

Nach dem Upgrade sollten die Reiter "Domains" und "Identity providers" jeder Organisation kontrolliert werden. Wer Organisationen für mandantenfähige Anwendungen nutzt, prüft zusätzlich, ob Realm-Importe die Link-Richtlinien korrekt setzen; Issue #53166 behebt einen Fall, in dem ein Realm-Import sie auf offene Standardwerte zurücksetzte.

Abkündigungen und Ende des Realm Operators

Keine dieser Funktionen fällt in 26.8 weg, sie sollen aber in künftigen Releases entfernt werden (Upgrade-Handbuch, Deprecated features):

Abgekündigt Nachfolger oder Empfehlung
Multi-Cluster v1 (--features=multi-site) Multi-Cluster v2 mit --features=stateless, Migrationsanleitung
Feature clusterless (experimentell) stateless
In-Memory-Login-Failures (login-failures:v1) Standard login-failures:v2 in der Datenbank
Volatile Sessions (persistent-user-sessions deaktiviert) Persistente Sessions werden der einzige Modus
Schalter "Full scope allowed" an Clients Gezielte Role-Scope-Mappings; Keycloak loggt pro Client eine Warnung bei der Token-Ausstellung
Client-Registration-Provider default, install, saml2-entity-descriptor Admin-REST-API oder OIDC Dynamic Client Registration
Mehrere Schalter in "OpenID Connect Compatibility Modes" (Liste im Handbuch) Client-Anwendungen aktualisieren
Refresh Tokens bei Client Credentials Grant Neuen Client-Credentials-Request senden
Kerberos Credential Delegation Abgekündigt aus Sicherheitsgründen, wird in einem künftigen Release entfernt
Route im Cookie AUTH_SESSION_ID für Sticky Sessions Gleichmäßige Lastverteilung ohne Sticky Sessions

Endgültig beendet ist der Keycloak Realm Operator: Er hat sein Lebensende erreicht, das Repository wird archiviert. Seine Ressourcen KeycloakRealm und KeycloakClient werden durch KeycloakRealmImport sowie KeycloakOIDCClient und KeycloakSAMLClient ersetzt, die als Preview zur Verfügung stehen (Managing Keycloak Clients). KeycloakRealmImport legt laut Dokumentation nur neue Realms an und aktualisiert oder löscht vorhandene nicht.

Zur Warnung bei "Full scope allowed": Für die eingebauten Clients security-admin-console und admin-cli ist sie unterdrückt. Das Handbuch nennt ein manuelles Deaktivieren dort als nicht erforderlich und weist darauf hin, dass dies den Login in die Admin Console brechen kann.

Neue Funktionen mit Status supported und preview

Funktion Status in 26.8 Einordnung
SCIM-API supported, standardmäßig aktiv Benutzer und Gruppen über den SCIM-Standard verwalten, etwa für Provisionierung aus anderen Identitätssystemen
Client Secret Rotation supported, standardmäßig aktiv Bis zu zwei gleichzeitig gültige Secrets über Client Policies, koordinierter Wechsel (die Verbraucher müssen das neue Secret rechtzeitig übernehmen)
Multi-Cluster v2 (stateless) supported, standardmäßig aus Mehrere Cluster ohne externes Infinispan, Sitzungen in der Datenbank; neuer Guide für Bare Metal und VMs
Token-Exchange-Delegation preview Benutzer delegieren per Consent über den Scope delegation:client:<client-id>; Token mit act-Claim; Freigabe nur über FGAP V2
Verschlüsselte PEM-Schlüssel für TLS neu Option --https-certificate-key-file-password
Stabile Knotennamen neu --cache-embedded-node-name, im Operator automatisch der Pod-Name
Vert.x-HTTP-Client experimentell --features=http-client:v2

Die Token-Exchange-Delegation zielt laut Release-Ankündigung auf KI-Agenten und Automatisierungen, die im Namen eines Benutzers handeln, ohne Admin-Rechte zu erhalten. Ein per Client-Delegation ausgestelltes Token gewährt keinen Zugriff auf die Admin-API, auch wenn der Client Service-Account-Credentials hat. Wer die Funktion aus 26.7 bereits testet, muss für die Delegation an einen Benutzer den Scope von delegation auf delegation:user umstellen (Client-Delegation nutzt delegation:client) und die Berechtigung über FGAP V2 neu anlegen (Token-Exchange-Dokumentation). Wie Agenten-Rechte grundsätzlich begrenzt werden, beschreibt der Beitrag zu Rechten und Freigaben für KI-Agenten.

Upgrade-Ablauf Schritt für Schritt

Der folgende Ablauf folgt dem Upgrade-Handbuch und ergänzt die Prüfpunkte aus 26.8:

Vorbereitung

  1. Aktuelle Version feststellen und alle "Migrating to"-Abschnitte zwischen dieser Version und der Zielversion lesen, aktuell 26.8.2 (also einschließlich 26.8.0, 26.8.1 und 26.8.2). Bei Sprüngen über mehrere Minor-Versionen summieren sich die Änderungen.
  2. IdP-Mapper auf Zuweisungen administrativer Rollen oder Gruppen mit Admin-Rollen prüfen.
  3. Protokoll-Mapper "Group Membership" und Gruppenrichtlinien auf Namen ohne Pfad prüfen.
  4. Automatisierungen und delegierte Admins identifizieren, die Client-Secrets mit view-clients lesen.
  5. Logout-Flows mit initiating_idp sowie X509-Authenticatoren für Benutzer prüfen.
  6. Eigene Login-Themes auf Überschreibungen von social-providers.ftl und CSS für IdP-Icons prüfen.
  7. Eigene Provider und Erweiterungen gegen Quarkus 3.40 neu bauen und testen; bei mehreren Persistence Units in einer persistence.xml den Hinweis zur Umbenennung auf <default> beachten, bei einer Unit ohne eigene Entities, die META-INF/orm.xml laden soll, zusätzlich die ausdrückliche mapping-file-Deklaration.
  8. Startparameter prüfen: --features=preview aktiviert stateless nicht mehr, stateless braucht --cache-embedded-cluster-name.
  9. Für Operator-Installationen: Labels an Secrets für KeycloakOIDCClient setzen, Abhängigkeit vom Realm Operator ablösen.
  10. Eigene Clients und Service-Accounts für die Admin REST API identifizieren und ihnen den Client-Scope kc-admin-api zuweisen (ab 26.8.2).
  11. SAML-Broker, SAML-Adapter, SAML-Back-Channel-Logout, Dynamic Client Registration, Organizations mit Domains und SMTP mit StartTLS gegen die Breaking Changes aus 26.8.1 und 26.8.2 prüfen.

Durchführung

  1. Upgrade auf einer Kopie mit Produktionsdaten testen, inklusive Logins über jeden Identity Provider.
  2. Wartungsfenster einplanen, alle Knoten der alten Version stoppen. Auch von 26.8.0 oder 26.8.1 auf 26.8.2 ist laut Handbuch kein Rolling Update vorgesehen.
  3. Installation (Konfiguration, Themes, Provider) und Datenbank sichern. Ein Rückweg ist nur über die Wiederherstellung beider Sicherungen möglich, da Keycloak Schemaänderungen nicht zurückrollt.
  4. Neue Version bereitstellen, providers/ und themes/ übernehmen, conf/ ohne cache-ispn.xml kopieren; eigene Cache-Anpassungen auf Basis der neuen cache-ispn.xml neu anwenden.
  5. Ersten Knoten starten und die Schemamigration im Log verfolgen, danach die übrigen Knoten.

Nach dem Upgrade

  1. Organisationen: Domains und Identity-Provider-Verknüpfungen kontrollieren.
  2. Logins, Logout über Broker, Token-Inhalte (aud, groups, resource_access) und Gruppenrichtlinien testen.
  3. Log auf Abkündigungswarnungen prüfen, insbesondere "Full scope allowed", und eine Liste der betroffenen Clients anlegen.
  4. Datenbanklast beobachten, da Login-Fehlversuche seit 26.8 standardmäßig in der Datenbank liegen; Hintergrund-Indexerstellung abwarten.
  5. Client-Bibliotheken (Admin Client, Authorization Client) getrennt aktualisieren, sie werden unabhängig vom Server veröffentlicht.

Für Installationen mit Keycloak als Identity Provider für VPN oder Fernzugriff lohnt sich zusätzlich ein Test der angebundenen Dienste, etwa bei NetBird mit Authentik oder Keycloak.

Unser Vorgehen bei WZ-IT

  1. Bestandsaufnahme. Version, Betriebsart (VM, Container, Kubernetes mit Operator), Datenbank, Realms, Identity Provider, Themes und eigene Provider.
  2. Abgleich mit den Änderungen. Prüfung der Konfiguration gegen alle Breaking Changes und Abkündigungen zwischen Ihrer Version und 26.8, als dokumentierte Liste mit Maßnahmen.
  3. Testlauf. Upgrade auf einer Kopie mit Produktionsdaten, Tests der Logins, Token-Inhalte und angebundenen Anwendungen.
  4. Durchführung. Sicherung von Installation und Datenbank, Upgrade im abgestimmten Wartungsfenster, Kontrolle nach dem Start und definierter Rückfallweg.
  5. Betrieb. Überwachung, Backups, Updates und Auswertung von Sicherheitsmeldungen, auf Wunsch über CVE-Monitoring. Support, Beratung und Implementierung durch WZ-IT.

Details zu Hosting, Installation und Betrieb stehen auf der Seite Keycloak bei WZ-IT.

Weiterführende Guides

Keycloak 26.8 einspielen, ohne Logins zu riskieren? Wir prüfen Ihre Realms gegen die Breaking Changes, testen auf einer Kopie und führen das Upgrade mit Rückfallplan durch. Termin vereinbaren

Quellen

Timo Wevelsiep

Geschrieben von

Timo Wevelsiep

Co-Founder & CEO

Co-Founder von WZ-IT. Spezialisiert auf Cloud-Infrastruktur, Open-Source-Plattformen und Managed Services für KMUs und Enterprise-Kunden weltweit.

Häufig gestellte Fragen

Antworten auf wichtige Fragen zu diesem Thema

Kunden aus Mittelstand, Industrie und öffentlicher Hand, in Deutschland und international

  • Stadtwerke Brühl
  • DGHO e.V.
  • solarwerkstatt berlin
  • Krüger Dirndl
  • ABCO Water Systems
  • Golem.de
  • EVADXB
  • nextGYM
  • AInergy
  • ml&s
  • Odiseo Solutions
  • Annota
  • ARGE
  • SweetConnect GmbH
  • Aphy AG
  • CORGOS
  • Rekorder
  • SolidProof
  • Yonju
  • Keymate
  • Paritel
  • Mr. Clipart
  • Millenium
  • Negosh
  • Führerscheinmacher
  • BTI
  • Deutsche Gesellschaft für Datenschutz
Kundenstimmen ansehen

Anfrage

Keycloak-Upgrade auf 26.8 planen und durchführen

Wir prüfen Ihre Realms, Identity Provider, Themes und Erweiterungen gegen die Änderungen in 26.8, testen das Upgrade auf einer Kopie und führen es mit Rückfallplan durch.

  • Sie sprechen direkt mit Timo und Robin, den technisch Verantwortlichen
  • Fachliche Einschätzung Ihrer Situation
  • Konkrete nächste Schritte für Infrastruktur, Software oder KI

Das Gespräch ist kostenfrei und unverbindlich.

Die Beratung von WZ-IT zu unserer Azure-Migration war schon im Erstgespräch fachlich sehr fundiert und völlig unverbindlich - wir haben eine Menge mitgenommen.
Jakob ÖschlbergerInno7 GmbH
Timo und Robin, Gründer von WZ-IT

Worum geht es bei Ihnen?

Die Beratung von WZ-IT zu unserer Azure-Migration war schon im Erstgespräch fachlich sehr fundiert und völlig unverbindlich - wir haben eine Menge mitgenommen.
Jakob ÖschlbergerInno7 GmbH