Zum Inhalt springen
senn-techsenn-tech
Zurück zum Blog
Infrastruktur
Server, Proxmox und Netzwerk2026-11-20· Von Franz Senn

Keycloak 27 soll FGAP V1 und Legacy Token Exchange streichen

Am 19. November 2026 hat das Keycloak-Projekt im offiziellen Blog angekündigt, mit Version 27 zwei Funktionen entfernen zu wollen: die erste Version der feingranularen Administratorberechtigungen (Fine-Grained Admin Permissions, FGAP V1) und den Legacy Token Exchange, der von dieser Version abhängt. Wir haben am 20. November 2026 auf unseren beiden Keycloak-Instanzen nachgesehen, ob wir betroffen sind. Ergebnis: nein. Der Prüfweg, mit dem wir das festgestellt haben, steht weiter unten und lässt sich auf jede Instanz übertragen.

Logo von Keycloak
Keycloak ist das Identity- und Access-Management, das bei uns hinter internen Anmeldungen steht. Die Ankündigung stammt aus dem offiziellen Projekt-Blog vom 19. November 2026, die Bestandszahlen aus einer eigenen read-only-Messung am 20. November 2026. (Quelle: Simple Icons 16.36.0, Datei keycloak.svg (Lizenzfeld in den Metadaten: custom, Linux Foundation Trademark Usage), Marke: Keycloak Authors / The Linux Foundation)

Fine-Grained Admin Permissions (FGAP) erlauben, die Admin-Konsole von Keycloak stückweise zu delegieren: Eine Person darf beispielsweise nur Benutzer eines Bereichs anlegen oder nur bestimmte Clients bearbeiten, ohne die Realm-Administration zu sehen. Version 2 des Modells ist seit Keycloak 26.2 vom 11. April 2025 die Standardversion. Version 1 blieb eine Vorschau, die man beim Start einzeln einschalten muss. Legacy Token Exchange ist die alte Vorschau-Implementierung des Tokenaustauschs und braucht FGAP V1 für ihre Berechtigungen.

Was der Hersteller geschrieben hat

Der Beitrag vom 19. November 2026 nennt zwei zusammenhängende Strecken. FGAP V1 soll in Keycloak 27 wegfallen, und weil Token Exchange V1 davon abhängt, ist dessen Entfernung gleich mit angekündigt. Vorher will das Team bekannte Lücken zwischen V1 und V2 schließen: delegierte Administratoren sollen Benutzer sehen dürfen, die auch zu Gruppen anderer Delegierter gehören, die Sichtbarkeit von Gruppenmitgliedern über LDAP-Gruppen-Mapper soll stimmen, Gruppenberechtigungen bekommen eine Stufe für Untergruppen, und der Gruppen-Ressourcentyp erhält den Scope map-roles-members. Wer mit V1 arbeitet und etwas am Wechsel hindert, soll das im Tracking-Issue melden.

Der Ton ist eine Bitte um Rückmeldung, keine Ansage mit Termin. Das zeigt auch das Ticket: Issue 44122 trägt den Titel „Remove Fine-Grained Admin Permissions v1“, steht seit dem 11. November 2025 offen, hat den Meilenstein 27.0 Release und vier Kommentare, zwei davon vom 20. November 2026.

Warum Legacy Token Exchange mitfällt

Die Keycloak-Dokumentation unterscheidet seit 26.2 zwei Implementierungen: Standard Token Exchange als Feature token-exchange-standard:v2, standardmäßig aktiv und offiziell unterstützt, und Legacy Token Exchange als Feature token-exchange:v1, weiter in der Vorschau. Für Legacy gilt: Wer es braucht, braucht auch FGAP V1, weil FGAP V2 keine Token-Exchange-Berechtigungen enthält. Die Doku begründet das damit, dass Token Exchange begrifflich keine Administratorberechtigung ist. Der Tausch eines externen Tokens gegen ein internes ist laut Doku nur in Legacy umgesetzt.

Für den Betrieb heißt das: Eine Instanz, die delegierte Administration über V1 gebaut und Legacy Token Exchange für einen Gateway-Fall eingeschaltet hat, verliert in Keycloak 27 beides gleichzeitig.

Der Zeitplan, gemessen an den Tickets

Keycloak 27 gibt es noch nicht. Die Release-Liste des Projekts nennt als neueste Version 26.8.2 vom 5. November 2026, und es existiert kein Tag 27.0.0 (beides am 20. November 2026 über die GitHub-API abgerufen). Die Meilensteine im Tracker tragen ein Datum: Der Entwicklungs-Meilenstein 27.0 steht auf dem 29. Januar 2027 mit 90 offenen Punkten, der Meilenstein 27.0 Release auf dem 31. März 2027 mit 138 offenen Punkten. Ein Meilensteindatum ist eine Planung und kein Versprechen, aber es ist die einzige Zahl, die für den Zeitraum vorliegt. Im Issue selbst heißt es auf eine Nachfrage vom 20. November 2026, die Liste der Änderungen für Version 27 sei noch nicht final.

Was Migrieren konkret heißt

Die Upgrade-Dokumentation für 26.2.0 hält fest, dass es wegen der Grundänderung im Berechtigungsmodell keine automatische Migration von V1 nach V2 gibt. Beim Aktivieren legt Keycloak einen neuen Client admin-permissions an, in dem das V2-Modell liegt. Das V1-Modell bleibt im bestehenden Client realm-management. Administratoren müssen Berechtigungen und Richtlinien im neuen Modell nachbauen, im Bereich „Permissions“ der Admin-Konsole oder über die Admin REST API. Dabei entfallen laut Doku unter anderem die Berechtigung „user-impersonated“ und die Client-Berechtigung „configure“, und jede Berechtigung muss ihre Operationen einzeln bekommen.

Der Aufwand hängt an der Zahl der Richtlinien, nicht an der Version. Sinnvoll ist die übliche Reihenfolge eines Identitätsumbaus: Realm-Export und Datensicherung vorweg, die bestehende Delegation als Liste festhalten, in einer Kopie nachbauen, dann mit einem echten delegierten Konto prüfen, ob es noch dasselbe darf und das übrige nicht.

Umbau von FGAP V1 auf V2 nach der Upgrade-Dokumentation: keine AutomatikBestand sichernRealm-Export undDatenbank-Dump vor jederÄnderungV2 einschaltenSchalter Admin Permissionsin den Realm-EinstellungenClientadmin-permissionsKeycloak legt ihn beimAktivieren anRichtlinien nachbauenkeine automatischeMigration, jede DelegationeinzelnNachprüfenmit einem echten delegiertenKonto: dasselbe darf, dasübrige nicht
Das V1-Modell bleibt im Client realm-management stehen, das V2-Modell kommt in den neuen Client admin-permissions. Markiert sind die Schritte, die niemand abnimmt. (Quelle: Keycloak, Upgrade-Änderungen zu 26.2.0)

Was wir auf unseren beiden Instanzen gemessen haben

Wir betreiben zwei Keycloak-Instanzen: eine für das Heimnetz, eine für die Firma. Auf beiden haben wir am 20. November 2026 gegen 05:20 UTC nur lesend nachgesehen, mit docker inspect, dem Jar-Dateinamen und SQL-Abfragen gegen die zugehörige PostgreSQL.

PrüfpunktEinheitHeim-InstanzFirmen-Instanz
Eingebaute Server-Version, am Jar-Dateinamen gemessenVersion26.8.226.8.2
Image-Tag des ContainersVersion26.8.226.8.2
Resource-Server für BerechtigungsmodelleStück00
Richtlinien in resource_server_policyStück00
Client admin-permissions (V2-Modell)vorhanden?neinnein
Realm-Flag adminPermissionsEnabledWertnicht gesetztfalse
Feature-Schalter beim Start (--features, Environment, keycloak.conf)Anzahl00

Gezählt am 20. November 2026, der Messweg steht im Quellenabschnitt. Beide Instanzen laufen auf 26.8.2, der neuesten Veröffentlichung. Ausschlaggebend für die Entwarnung sind die Nullzeilen: Es gibt auf beiden Instanzen weder Resource-Server noch Richtlinien, also weder ein V1- noch ein V2-Berechtigungsmodell, und der V2-Client wurde nie angelegt. Beim Start ist kein Feature-Schalter gesetzt, also war weder V1 noch Legacy Token Exchange eingeschaltet. Für uns ist die Entfernung in Keycloak 27 eine Zeile im Changelog.

Betroffen wäre man auf einem anderen Weg: Hängt die Anmeldung der Rechner eines Standorts an diesem Dienst, ist ein missglücktes Upgrade ein Ausfall des ganzen Standorts. Zum Betrieb von Keycloak siehe Keycloak als zentrale Anmeldung, die letzten Sicherheitsfixes in Keycloak 26.7.5 und 26.8.0.

So prüfen Sie Ihre Instanz

  1. Version aus dem Betrieb lesen statt dem Tag glauben: docker exec <container> /opt/keycloak/bin/kc.sh --version, Gegenprobe über den Jar-Dateinamen unter /opt/keycloak/lib/lib/main/. Der Image-Tag beschreibt das gezogene Bild, der Jar-Name den Stand im Betrieb.
  2. Feature-Schalter ansehen: docker inspect <container> auf Config.Env und Config.Args nach features durchsuchen, dazu /opt/keycloak/conf/keycloak.conf. Kein Treffer heißt: admin-fine-grained-authz:v1 und token-exchange:v1 sind nicht per Schalter aktiviert.
  3. Realm-Zustand lesen: In den Realm-Einstellungen den Schalter „Admin Permissions“ ansehen oder GET /admin/realms/<realm> aufrufen und auf adminPermissionsEnabled achten. Existiert zusätzlich ein Client admin-permissions, wird mit V2 gearbeitet.
  4. Ohne Admin-Rechte zählt die Datenbank: select count(*) from resource_server; und select count(*) from resource_server_policy;. Zwei Nullen schließen beide Berechtigungsmodelle aus.
  5. Token Exchange einordnen: Standard Token Exchange braucht einen Schalter am jeweiligen Client und kein token-exchange:v1. Ist das Feature token-exchange nicht gesetzt, kann kein Client Legacy Token Exchange nutzen.

Vor jedem Upgrade auf eine Hauptversion gehören ein Datenbank-Dump und ein Realm-Export vor die Änderung, dazu die Probe an einer Kopie. Wer solche Umbauten nicht allein planen will, findet auf der Seite zur IT-Betreuung unser Angebot, unter Server und Netzwerk liegen die Beiträge aus demselben Bereich.

Was wir nicht behaupten

Wir haben kein Upgrade auf Keycloak 27 getestet, weil es diese Version nicht gibt. Gemessen ist der Stand 26.8.2 und die Meilensteinliste. Die V1-Oberfläche haben wir nicht geprüft, weil auf beiden Instanzen nichts Migrierbares konfiguriert ist. Die genannten Lückenschlüsse sind Ankündigungen und die Meilensteindaten Planung: 138 offene Punkte im Release-Meilenstein können sich verschieben.

Weiterführende Quellen

Eigene Messung: lesender SSH-Zugriff auf beide Keycloak-Hosts am 20. November 2026 gegen 05:20 UTC. docker ps und docker inspect für Image und Startparameter, ls /opt/keycloak/lib/lib/main/ für den Jar-Namen, grep -i feature /opt/keycloak/conf/keycloak.conf, danach SQL-Abfragen gegen die Datenbankcontainer (Tabellen realm, client, realm_attribute, resource_server, resource_server_policy). Keine Änderung an Konfiguration, Datenbank oder Betrieb. Die öffentlichen Angaben habe ich am 20. November 2026 abgerufen.

Fragen?
Muss ich vor einem Upgrade auf Keycloak 27 etwas vorbereiten?+

Nur wenn die Instanz Fine-Grained Admin Permissions V1 nutzt. Seit Keycloak 26.2 muss V1 mit `--features=admin-fine-grained-authz:v1` eigens eingeschaltet werden. Wer unsicher ist, zählt in der Datenbank, wie viele Resource-Server und Richtlinien existieren. Liegt beides bei null, gibt es nichts zu migrieren und es bleibt der normale Upgrade-Weg samt Datenbanksicherung.

Ist auch der normale Token Exchange betroffen?+

Nein. Geplant ist die Entfernung der alten Vorschau-Version `token-exchange:v1` (Legacy). Standard Token Exchange (`token-exchange-standard:v2`) ist seit 26.2 die Standardversion und bleibt. Die Kopplung besteht darin, dass Legacy Token Exchange ohne FGAP V1 nicht funktioniert, weil FGAP V2 bewusst keine Token-Exchange-Berechtigungen enthält.

Kam die Ankündigung überraschend?+

Das Tracking-Issue zur Entfernung ist seit dem 11. November 2025 offen und läuft unter dem Meilenstein 27.0 Release. Neu ist der öffentliche Aufruf vom 19. November 2026, blockierende Fälle zu melden, bevor entfernt wird. Bis zum 20. November 2026 trug das Issue vier Kommentare.