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.
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.
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üfpunkt | Einheit | Heim-Instanz | Firmen-Instanz |
|---|---|---|---|
| Eingebaute Server-Version, am Jar-Dateinamen gemessen | Version | 26.8.2 | 26.8.2 |
| Image-Tag des Containers | Version | 26.8.2 | 26.8.2 |
| Resource-Server für Berechtigungsmodelle | Stück | 0 | 0 |
Richtlinien in resource_server_policy | Stück | 0 | 0 |
Client admin-permissions (V2-Modell) | vorhanden? | nein | nein |
Realm-Flag adminPermissionsEnabled | Wert | nicht gesetzt | false |
Feature-Schalter beim Start (--features, Environment, keycloak.conf) | Anzahl | 0 | 0 |
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
- 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. - Feature-Schalter ansehen:
docker inspect <container>aufConfig.EnvundConfig.Argsnachfeaturesdurchsuchen, dazu/opt/keycloak/conf/keycloak.conf. Kein Treffer heißt:admin-fine-grained-authz:v1undtoken-exchange:v1sind nicht per Schalter aktiviert. - Realm-Zustand lesen: In den Realm-Einstellungen den Schalter „Admin Permissions“ ansehen oder
GET /admin/realms/<realm>aufrufen und aufadminPermissionsEnabledachten. Existiert zusätzlich ein Clientadmin-permissions, wird mit V2 gearbeitet. - Ohne Admin-Rechte zählt die Datenbank:
select count(*) from resource_server;undselect count(*) from resource_server_policy;. Zwei Nullen schließen beide Berechtigungsmodelle aus. - Token Exchange einordnen: Standard Token Exchange braucht einen Schalter am jeweiligen Client und kein
token-exchange:v1. Ist das Featuretoken-exchangenicht 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.
- Keycloak-Blog: Planned Removal of Fine-Grained Admin Permissions V1 in Keycloak 27 vom 19. November 2026, Primärquelle
- Upgrade-Änderungen 26.2.0 in der Projekt-Dokumentation, Abschnitte zu Fine-Grained Admin Permissions und Standard Token Exchange, Primärquelle
- Issue 44122, Remove Fine-Grained Admin Permissions v1, offen, Meilenstein 27.0 Release, Stand 20. November 2026
- Keycloak-Meilensteine auf GitHub, Stand 20. November 2026: 27.0 Development 29. Januar 2027 (90 offen), 27.0 Release 31. März 2027 (138 offen)
- Keycloak-Releases auf GitHub, Stand 20. November 2026: 26.8.2 vom 5. November 2026, kein Tag 27.0.0
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.
senn-tech