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
- Keycloak 26.8.0 auf einen Blick
- Sicherheitskorrekturen in 26.8.0
- Patch-Releases 26.8.1 und 26.8.2: CVE-Fixes und Breaking Changes
- Breaking Changes vor dem Upgrade prüfen
- Geändertes Verhalten nach dem Upgrade
- Organizations: Identity Provider für mehrere Organisationen
- Abkündigungen und Ende des Realm Operators
- Neue Funktionen mit Status supported und preview
- Upgrade-Ablauf Schritt für Schritt
- Unser Vorgehen bei WZ-IT
- 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
- 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.
- IdP-Mapper auf Zuweisungen administrativer Rollen oder Gruppen mit Admin-Rollen prüfen.
- Protokoll-Mapper "Group Membership" und Gruppenrichtlinien auf Namen ohne Pfad prüfen.
- Automatisierungen und delegierte Admins identifizieren, die Client-Secrets mit view-clients lesen.
- Logout-Flows mit initiating_idp sowie X509-Authenticatoren für Benutzer prüfen.
- Eigene Login-Themes auf Überschreibungen von social-providers.ftl und CSS für IdP-Icons prüfen.
- 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. - Startparameter prüfen: --features=preview aktiviert stateless nicht mehr, stateless braucht --cache-embedded-cluster-name.
- Für Operator-Installationen: Labels an Secrets für KeycloakOIDCClient setzen, Abhängigkeit vom Realm Operator ablösen.
- 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).
- 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
- Upgrade auf einer Kopie mit Produktionsdaten testen, inklusive Logins über jeden Identity Provider.
- 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.
- 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.
- 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.
- Ersten Knoten starten und die Schemamigration im Log verfolgen, danach die übrigen Knoten.
Nach dem Upgrade
- Organisationen: Domains und Identity-Provider-Verknüpfungen kontrollieren.
- Logins, Logout über Broker, Token-Inhalte (aud, groups, resource_access) und Gruppenrichtlinien testen.
- Log auf Abkündigungswarnungen prüfen, insbesondere "Full scope allowed", und eine Liste der betroffenen Clients anlegen.
- Datenbanklast beobachten, da Login-Fehlversuche seit 26.8 standardmäßig in der Datenbank liegen; Hintergrund-Indexerstellung abwarten.
- 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
- Bestandsaufnahme. Version, Betriebsart (VM, Container, Kubernetes mit Operator), Datenbank, Realms, Identity Provider, Themes und eigene Provider.
- 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.
- Testlauf. Upgrade auf einer Kopie mit Produktionsdaten, Tests der Logins, Token-Inhalte und angebundenen Anwendungen.
- Durchführung. Sicherung von Installation und Datenbank, Upgrade im abgestimmten Wartungsfenster, Kontrolle nach dem Start und definierter Rückfallweg.
- 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
- Authentik vs. Zitadel, zwei Open-Source-Identity-Provider im Vergleich zu Keycloak.
- NetBird mit Authentik oder Keycloak, SSO für ein selbst betriebenes VPN einrichten.
- PostgreSQL 14 Supportende, Upgrade-Pfade für die Datenbank unter Keycloak.
- Rechte und Freigaben für KI-Agenten, wie Agenten nur die nötigen Berechtigungen erhalten.
- Managed Open Source, Betrieb von Keycloak und weiteren Open-Source-Anwendungen durch WZ-IT.
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
- Keycloak, Keycloak 26.8.0 released
- Keycloak, Keycloak 26.8.1 released
- Keycloak, Keycloak 26.8.2 released
- Keycloak, Upgrading Guide (Migrating to 26.8.0)
- GitHub, Keycloak Release 26.8.0
- GitHub, Keycloak Release 26.8.1
- GitHub, Keycloak Release 26.8.2
- GitHub, Upgrade-Handbuch Quelltext 26.8.2 (changes-26_8_2.adoc)
- GitHub, Upgrade-Handbuch Quelltext 26.8.1 (changes-26_8_1.adoc)
- GitHub, Keycloak Release 26.7.5
- GitHub Issue #50444, CVE-2026-12388
- GitHub Issue #50618, CVE-2026-14781
- GitHub Issue #51865, CVE-2026-19608
- GitHub Issue #53074, CVE-2026-93999
- GitHub Issue #50992, Neue Identity-Provider-Buttons
- Keycloak, Migrating from multi-cluster v1 to v2
- Keycloak, Token Exchange
- Keycloak, Configuring the database
- Keycloak Operator, Realm Import
- Keycloak Operator, Managing Keycloak Clients
- GitHub, Keycloak Realm Operator













