22 KiB
PVE 9 + Keycloak OIDC für HEIMLAN
Version: 1.3.0 · Änderungsprotokoll · Versionsdatei
Dieses Ansible-Setup konfiguriert den bestehenden PVE-Host ts01 und eine bestehende Keycloak-VM. Es installiert die private Root-CA auf beiden Betriebssystemen sowie im Java- und Keycloak-Truststore, richtet Realm, Client, Gruppen, Mapper und Sessions ein und ergänzt PVE-ACLs ausschließlich für bereits vorhandene Gruppen. Alle Module gehören zu ansible.builtin.
Voraussetzungen und Umfang
- Ansible-Core 2.18/2.19 auf einem Controller mit passender Python-Version (für 2.19 Python ≥3.11); Python 3 auf beiden Zielhosts, SSH und root/sudo-Zugriff.
- PVE 9 ist installiert. Die Keycloak-VM läuft auf Debian/Ubuntu, mit einer bestehenden modernen Keycloak-Distribution (26.x, Quarkus), JVM und einem systemd-Dienst
keycloak. Datenbank, VM-Erstellung, Keycloak-Binärinstallation und initialer Admin-Bootstrap sind Voraussetzung. - Keycloak bietet direkt HTTPS auf Port 8443, ohne Reverse Proxy. Serverzertifikat mit SAN
keycloak.service.heim.lan, privater Serverschlüssel und vollständige Intermediate-Kette müssen bereits konfiguriert sein. Der Import einer Root-CA stellt kein Serverzertifikat aus. - DNS, Zeitabgleich und Erreichbarkeit müssen auf PVE, Keycloak und im Browser stimmen. Auch der Browser muss HEIMLAN_RootCA vertrauen.
- Bestehender Keycloak-Admin im
master-Realm, der Realms anlegen und Zielrealm, Clients und Gruppen verwalten darf. Die Anmeldung erfolgt überadmin-climit Password Grant. Für einen Admin mit vorgeschriebenem interaktivem MFA ist dieses Verfahren ungeeignet; dafür einen passenden Automationszugang bereitstellen. - JVM-Pfad und Truststore müssen zur tatsächlich gestarteten JVM passen. Ein Container oder ein über
javax.net.ssl.trustStoreabweichend konfigurierter Dienst braucht entsprechend angepasste Pfade; das Beispiel steuert eine native systemd-Installation.
Dateien
ansible.cfg
inventory/hosts.yml
group_vars/all.yml.example
files/README.md
playbook/site.yml # vollständige Konfiguration
playbook/acl.yml # spätere ACL-Zuordnung nach Login
tasks/{preflight,ca,java,keycloak,keycloak_group,keycloak_mapper,pve,acl}.yml
Interaktive Einrichtung (empfohlen)
Nach Installation/Aktivierung der unten beschriebenen Ansible-Python-Umgebung:
python3 setup.py
Der Assistent fragt alle konfigurierbaren Verbindungs- und Setup-Werte ab:
- PVE- und Keycloak-Inventory-Namen, IP/DNS-Adressen, SSH-Ports, Benutzer, private SSH-Key-Pfade und sudo-Zielbenutzer.
- Ob SSH- und sudo-Passwörter beim Ansible-Lauf abgefragt werden sollen.
- HTTPS-Adressen, Issuer, Realms, Client-IDs und erlaubte PVE-Browser-URLs.
- Alle vier Session-Zeiten in Sekunden, CA-Datei/Fingerprint, System- und Java-Truststore-Pfade.
- Keycloak-Installationspfad, Dienst, Benutzer/Gruppe, Java-Keytool und CA-Alias.
- Zu verwaltende PVE-Rollen und sämtliche erforderlichen Secrets.
Enter übernimmt den angezeigten Standardwert. Secrets werden verdeckt mit Bestätigung abgefragt. Ein zusätzliches Vault-Passwort verschlüsselt die Zugangsdaten direkt über Ansible Vault; Klartext-Secrets und Vault-Passwort werden nicht in temporäre Dateien geschrieben. Der Assistent benötigt ein interaktives macOS-/Linux-Terminal.
Die Antworten landen mit Dateirechten 0600 in inventory/hosts.local.yml,
group_vars/all.yml und der verschlüsselten group_vars/vault.yml. Alle drei Dateien
sind von Git ausgeschlossen. Die .yml-Konfigurationsdateien verwenden JSON-Syntax,
die Ansible als gültiges YAML liest. Die CA-Datei bleibt am eingegebenen lokalen Pfad.
Bei einer erneuten Einrichtung fragt der Assistent vor dem Ersetzen vorhandener Konfiguration nach; bisherige Werte werden nicht eingelesen. Alle Parameter dann neu eingeben. Nach dem Speichern kann das Setup direkt gestartet werden. Standardmäßig werden zunächst nur die Dateien erstellt. Den angezeigten Startbefehl verwenden:
ansible-playbook -i inventory/hosts.local.yml playbook/site.yml --ask-vault-pass
# Nach dem ersten OIDC-Login:
ansible-playbook -i inventory/hosts.local.yml playbook/acl.yml
Bei Bedarf --ask-pass und/oder --ask-become-pass ergänzen; der Assistent fügt diese
Optionen beim direkten Start entsprechend den Antworten hinzu. Passwortbasierter
SSH-Zugriff kann auf dem Controller zusätzliche SSH-Unterstützung wie sshpass
erfordern; ein SSH-Key oder SSH-Agent ist ebenfalls möglich.
Die vorgegebenen OIDC-Flags, Claim-Namen, TLS-Verifikation und der ACL-Pfad / bleiben
entsprechend den Projektanforderungen fest. Es werden weiterhin bestehende Hosts und
eine installierte Keycloak-Instanz vorausgesetzt.
Einrichtung und Start (manuell)
Alle Befehle im entpackten Verzeichnis ausführen:
python3 -m venv .venv
. .venv/bin/activate
pip install 'ansible-core>=2.18,<2.20'
cp group_vars/all.yml.example group_vars/all.yml
ansible-vault create group_vars/vault.yml
Im Vault-Editor die folgenden Variablen mit echten Werten anlegen. Die leeren Werte hier sind ausschließlich eine Vorlage; das Playbook lehnt sie ab:
vault_keycloak_admin_username: ""
vault_keycloak_admin_password: ""
vault_keycloak_client_secret: ""
vault_java_cacerts_password: ""
Für das Client-Secret einen zufälligen Wert mit mindestens 16, maximal 256 Zeichen ohne führende/abschließende Leerzeichen oder Zeilenumbrüche verwenden. Das Java-Passwort muss das bestehende Truststore-Passwort sein; es wird nicht geändert. Keine Zugangsdaten im Inventory oder in der Kommandozeile eintragen.
inventory/hosts.ymlanpassen:ts01, Keycloak-Adresse, SSH-Benutzer.- Öffentliche PEM-Root-CA als
files/HEIMLAN_RootCA.crtablegen, genau ein Zertifikat und kein privater CA-Schlüssel. Optionalheimlan_ca_sha256auf einen unabhängig geprüften SHA-256-Fingerprint setzen, nur den Hexwert mit Doppelpunkten. group_vars/all.ymlprüfen: URL, Java-/Keycloak-Pfade, Servicebenutzer und tatsächliche Browser-URLs unterpve_redirect_uris. Beispiel:https://ts01.heim.lan:8006/. Fürhttps://ts01:8006/einen eigenen Eintrag ergänzen. Keine Wildcards.- Bei abweichendem Issuer
keycloak_base_url,keycloak_realmund ggf.pve_oidc_issuerkonsistent ändern. Die Discovery-Antwort muss den Issuer exakt bestätigen.pve_realmbestimmt PVE-Benutzersuffix und PVE-Gruppensuffix. - SSH-Hostschlüssel vorab prüfen und in
known_hostsaufnehmen.
ansible-playbook playbook/site.yml --syntax-check --ask-vault-pass
ansible-playbook playbook/site.yml --ask-vault-pass
Bei sudo-Passwort zusätzlich --ask-become-pass. Den vollständigen Lauf nicht mit --limit pve oder --limit keycloak zerlegen: CA-Fakten und Java-Prüfungen bauen aufeinander auf. --check wird für site.yml bewusst abgelehnt, da noch nicht angelegte API-Ressourcen und Truststores keinen verlässlichen Gesamtdryrun erlauben.
Konfigurierte Werte
| Objekt | Einstellung |
|---|---|
| Keycloak-Realm | main.heim.lan |
| Client | PVE-SERVER, confidential, Authorization Code Flow |
| Issuer | https://keycloak.service.heim.lan:8443/realms/main.heim.lan |
| PVE-Realm | main.heim.lan, Typ openid |
| PVE-Optionen | autocreate=1, groups-claim=groups, groups-autocreate=1, groups-overwrite=1, query-userinfo=1, username-claim=preferred_username |
| Gruppenmapper | Name/Claim groups, Group Membership, Full group path off, ID/access/userinfo on |
| Username-Mapper | pve-preferred-username: Benutzerattribut username → preferred_username, ID/access/userinfo on |
| SSO Idle / Max | 900 / 28800 Sekunden (15 Minuten / 8 Stunden) |
| Client Idle / Max | 900 / 28800 Sekunden, Realm-Defaults und explizite Client-Overrides |
Keycloak erhält diese Top-Level-Gruppen, keine Keycloak-Rollen:
Administrator, PVEAdmin, PVEAuditor, PVEDatastoreAdmin, PVEDatastoreUser, PVEMappingAdmin, PVEMappingUser, PVEPoolAdmin, PVEPoolUser, PVESDNAdmin, PVESDNUser, PVESysAdmin, PVETemplateUser, PVEUserAdmin, PVEVMAdmin, PVEVMUser.
NoAccess wird nicht angelegt oder gemappt. Bestehende sonstige Gruppen und ACLs bleiben erhalten. Der Mapper liefert sämtliche Mitgliedschaften; für Rollen diese flachen Top-Level-Gruppen verwenden, damit gleichnamige Untergruppen bei ausgeschaltetem vollständigem Pfad nicht verwechselt werden.
Erster Login und Rechte
- In Keycloak einen vorhandenen Benutzer der gewünschten Gruppe zuweisen, beispielsweise
PVEAuditoroderPVEAdmin. Benutzeranlage und Mitgliedschaften werden nicht automatisch verändert. - Im PVE-Login den Realm
main.heim.lanauswählen und über Keycloak anmelden. - PVE erzeugt beim Login den Benutzer
BENUTZERNAME@main.heim.lanund z. B.PVEAuditor-main.heim.lan. Bis zum ACL-Lauf kann der Benutzer noch ohne Rechte sein. - Anschließend ausführen:
ansible-playbook playbook/acl.yml
Dieser Lauf benötigt kein Vault und keinen Keycloak-API-Zugriff. Er vergibt für jede bereits existierende Gruppe <ROLE>-main.heim.lan die gleichnamige PVE-Rolle auf / mit propagate=1. Fehlende Gruppen werden gemeldet und übersprungen. Nach dem ersten Login weiterer Gruppen erneut ausführen. Eine bereits passende ACL erzeugt keine Änderung. Wie angefordert wirken die Rechte global auf / und werden vererbt.
Bestehende Realms und Username-Migration
PVE kennzeichnet username-claim als bei der Anlage festzulegen. Das Playbook setzt den Wert bei der Neuanlage und übergibt ihn nicht bei realm modify. Ein vorhandener Realm mit fehlendem oder abweichendem Wert führt vor der PVE-Änderung zu einer verständlichen Fehlermeldung. Ein blindes realm modify --username-claim ... ist kein zuverlässiger Migrationsweg.
Für einen bereits mit UUID/subject eingerichteten Realm zuerst Benutzer, ACLs und lokale Notfallanmeldung sichern. Dann eine geplante Realm-Neuanlage oder einen neuen PVE-Realmnamen verwenden. Ein neuer Realmname ändert Benutzer- und Gruppensuffixe; alte UUID-Benutzer werden nicht automatisch mit neuen Benutzern zusammengeführt. Dieses Paket löscht dafür keine bestehenden Realms oder Benutzer. Keycloak kann in einem solchen abgebrochenen Gesamtlauf bereits aktualisiert sein; nach der Migration lässt sich der Lauf wiederholen.
Idempotenz, TLS und Secrets
GET-Abfragen vergleichen die verwalteten Realm-/Client-/Mapper-Felder vor POST/PUT. Clientattribute außerhalb der verwalteten Sessionwerte werden erhalten. Die konfigurierte Redirect-Liste ist maßgeblich. Client-Secret wird über den dedizierten Keycloak-Endpunkt gelesen und mit dem Vault-Wert verglichen; PVE liest die lokale Realm-Konfiguration mit pvesh. Java-Alias wird anhand des Zertifikatfingerprints verglichen und bei CA-Wechsel ersetzt. OS-Trust-Aktualisierung läuft zur Reparierbarkeit jedes Mal, meldet bei unverändertem Store aber keine Änderung.
Jeder API-Aufruf verwendet CA- und Hostnamenprüfung. Die API-Tasks laufen auf der Keycloak-VM, die Discovery-Prüfung auf PVE; der Controller braucht deshalb für diese Aufrufe keinen eigenen CA-Import. Es gibt kein validate_certs: false, curl -k oder abgeschaltetes Hostname-Checking. Vertrauensänderungen starten den Keycloak-Dienst neu, bevor API-Aufrufe beginnen.
Alle Secrets kommen aus Variablen/Vault und sensitive Tasks nutzen no_log. PVE speichert seinen OIDC-Client-Key selbst in seiner Realm-Konfiguration; Vault verschlüsselt die Quelle, nicht den Laufzeitspeicher der Zielprodukte. Beim notwendigen pveum-Schreibaufruf ist der Key kurzzeitig ein Prozessargument auf PVE und damit für entsprechend privilegierte lokale Beobachter sichtbar. Keine Ansible-Debug-Ausgaben oder Prozessmitschnitte für diese Tasks aktivieren. Das Java-Passwort wird über eine Umgebungsvariable statt als Passwortargument übergeben.
Secret-Rotation: ansible-vault edit group_vars/vault.yml, denselben neuen Client-Key für den Gesamtlauf verwenden und site.yml erneut ausführen. Zwischen Keycloak- und PVE-Aktualisierung kann der Login kurzzeitig scheitern. Bestehende fremde ACLs werden nicht bereinigt; Entfernen einer Rolle aus pve_roles entzieht daher keine zuvor vergebenen Rechte.
Session-Verhalten
Die Realm-SSO-Werte betreffen alle Anwendungen dieses Keycloak-Realms. Client-Overrides können die globale SSO-Grenze nicht verlängern. Kürzere Client-Sessions erzwingen bei weiterhin aktiver SSO-Session nicht zwangsläufig eine neue Passworteingabe.
Keycloak-Sessionablauf ist außerdem keine PVE-Ticket-Laufzeit: PVE-Aktivität muss Keycloak nicht aktiv halten und ein abgelaufener Keycloak-Login beendet nicht automatisch ein bereits ausgestelltes PVE-Ticket. Ohne aktivierten optionalen Logout-Patch beendet lokales PVE-Logout die Keycloak-SSO-Session nicht automatisch.
Prüfung und Fehlerdiagnose
Nach Konfiguration einen tatsächlichen Browser-Login durchführen. Im Keycloak-Client unter Client scopes → Evaluate für einen Testbenutzer kontrollieren, dass groups ein Array wie ["PVEAuditor"] enthält, ohne führenden /, und preferred_username vorhanden ist. Vorhandene zusätzliche Mapper für dieselben Claims auf Widersprüche prüfen.
Auf PVE:
pveum group list --output-format json
pveum acl list --output-format json
pveum user list --output-format json
curl --fail --cacert /etc/ssl/certs/ca-certificates.crt \
https://keycloak.service.heim.lan:8443/realms/main.heim.lan/.well-known/openid-configuration
Bei TLS-Fehlern SAN, DNS, Systemzeit, CA-Datei und vom Server ausgelieferte Intermediate-Kette prüfen. Bei invalid_redirect_uri den tatsächlich im Browser verwendeten PVE-Origin einschließlich Port und abschließendem / eintragen. Bei versteckten API-Fehlern Keycloak-Serverlogs prüfen; no_log nicht pauschal abschalten. Bei fehlenden Rechten Gruppenmitgliedschaft, erneuten Login und ACL-Lauf prüfen. groups-overwrite=1 ersetzt bestehende PVE-Gruppenmitgliedschaften dieses Benutzers beim Login.
Das Paket wird lokal auf YAML-/Ansible-Syntax und ausgewählte Entscheidungslogik geprüft. Ein Integrationstest auf deinem PVE/Keycloak sowie ein echter zweiter Lauf mit changed=0 können ohne Zugriff auf deine Hosts nicht bestätigt werden.
Referenzen
- Proxmox OpenID-Dokumentation
- Proxmox OpenID-Plugin, insbesondere immutable username-claim
- Proxmox ACL-API
- Keycloak Admin REST API
- Keycloak Truststore
- Keycloak Session-Verwaltung
- Keycloak Client-Session-Attributnamen
Optional: PVE-Logout → Keycloak-Logout (ab 1.2.0)
Im Einrichtungsassistenten die Logout-Frage mit j beantworten. Für eine bereits
vorhandene Konfiguration diese zwei Werte in group_vars/all.yml ergänzen
(bei JSON-Syntax innerhalb des vorhandenen Objekts):
pve_logout_enabled: true
pve_logout_redirect_uri: https://ts01.heim.lan:8006/
Die Rücksprungadresse muss exakt in pve_redirect_uris enthalten sein. Dann entweder
den vollständigen Lauf verwenden oder bei bereits eingerichtetem CA-/OIDC-Setup:
ansible-playbook -i inventory/hosts.local.yml playbook/logout.yml --ask-vault-pass
logout.yml gleicht zunächst die vorhandene Keycloak-Konfiguration mit den
Projektvariablen ab, einschließlich Realm-Sessions, Client, Gruppen und Mappern.
Es setzt zusätzlich das Clientattribut post.logout.redirect.uris auf die gewählte
Rücksprungadresse (eine eventuell vorhandene Logout-Redirect-Liste wird ersetzt).
Danach prüft PVE den Discovery-Endpunkt mit TLS-CA-Verifikation und installiert den Patch.
Der Desktop-Logout merkt sich vor der lokalen Abmeldung den Benutzernamen. Nur beim
Suffix @<pve_realm> leitet er nach der normalen lokalen Abmeldung zum verifizierten
Keycloak-Logout-Endpunkt weiter, mit client_id und post_logout_redirect_uri.
PAM-/andere Realms bleiben im normalen Ablauf. Es werden keine Client-Secrets in
JavaScript oder URLs eingebaut. Ohne id_token_hint kann Keycloak eine Bestätigung
anzeigen; diese muss der Benutzer abschließen. Erst dann ist auch die Keycloak-SSO-
Session beendet. Andere Anwendungen können von der beendeten SSO-Session betroffen sein.
Der Patch gilt für den Desktop-Logout-Button. Er implementiert weder Backchannel- Logout noch eine serverseitige Sperrung bereits ausgestellter PVE-Tickets, mobile Oberflächen oder ein synchronisiertes Logout sämtlicher Browser-Tabs.
Sicherung, Updates und Rückbau
- Ziel:
/usr/share/pve-manager/js/pvemanagerlib.js, nur PVE 9 und genau ein bekannter Logout-Codeblock. Unbekannte/minifizierte Varianten oder vorkomprimierte Sidecars führen zum Abbruch; eine Major-Version allein gilt nicht als Kompatibilitätsnachweis. - Originaldatei und SHA-256-Prüfsummen werden unter
/var/lib/pve-idm/logoutgesichert. Identischer zweiter Lauf ändert nichts. Manuelle Änderungen an einem gepatchten Bundle führen zum Abbruch, statt fremde Änderungen zu überschreiben. - PVE-Paketupdates können den Patch ersetzen. Danach
logout.ymlerneut ausführen. Der neue Originalstand wird separat gesichert. Es gibt keinen unbeaufsichtigten Update-Hook. Bei geändertem Logout-Code ist eine erneute Anpassung erforderlich. - Nach Installation/Rückbau die PVE-Seite vollständig neu laden, ggf. Browsercache leeren. Bereits geöffnete Tabs enthalten noch die alte JavaScript-Version.
- Rückbau ohne Vault und ohne Keycloak-Zugriff:
ansible-playbook -i inventory/hosts.local.yml playbook/logout-remove.yml
Danach pve_logout_enabled: false speichern, damit spätere Gesamtläufe den Patch
nicht erneut aktivieren. Alternativ entfernt ein Gesamtlauf mit false den Patch.
Der Rückbau stellt nur die nachweislich zugehörige Originaldatei wieder her; nach
Paketupdates wird keine ältere Datei zurückkopiert. Sicherungen und die zugelassene
Keycloak-Rücksprungadresse bleiben erhalten.
Abnahme auf den Zielhosts
- Desktop-Seite neu laden, OIDC-Benutzer anmelden, Logout drücken.
- Prüfen: lokale PVE-Abmeldung, Keycloak-Bestätigung, danach Rückkehr zu PVE.
- Erneut anmelden: Keycloak sollte eine neue Authentifizierung verlangen, sofern kein vorgeschalteter Identity Provider erneut automatisch anmeldet.
- Mit
root@pamprüfen, dass keine Keycloak-Weiterleitung erfolgt. - Zweiten Ansible-Lauf und anschließend bei Bedarf Rückbau prüfen.
Lokal getestet werden Patch/Rückbau, Idempotenz, Paketupdate-Verhalten und Ablehnung veränderter Dateien. Ein Browser-/Integrationstest auf deinen Hosts steht aus.
Rückbau über den Einrichtungsassistenten (ab 1.2.1)
python3 setup.py --rollback-logout
Fragt Inventory, SSH-/sudo-Passwortbedarf und die Ausführung ab. Nach erfolgreichem
Rückbau speichert der Assistent pve_logout_enabled: false in der lokalen Konfiguration,
damit spätere Gesamtläufe den Patch nicht erneut installieren. Kein Vault-Passwort nötig.
Bei fehlgeschlagenem Rückbau bleibt die lokale Einstellung unverändert.
Bei einer rein manuellen Installation ohne lokale Ansible-Konfiguration direkt auf PVE:
python3 /root/pve-idm-logout-patch.py \
--target /usr/share/pve-manager/js/pvemanagerlib.js \
--state-dir /var/lib/pve-idm/logout \
--enabled false
Auch dieser Rückbau ist bereits im Patch-Skript eingebaut. Anschließend die PVE-Seite vollständig neu laden. Keycloak-Konfiguration und Sicherungsdateien bleiben erhalten.
Keycloak-Logout über IP und FQDN (ab 1.3.0)
Im Assistenten Keycloak über IP UND FQDN abmelden? mit j beantworten und
https://9.99.30.11:8443 sowie https://keycloak.service.heim.lan:8443 eingeben.
Alternativ in der lokalen Konfiguration:
pve_logout_enabled: true
pve_logout_redirect_uri: https://192.168.1.231:8006/
pve_logout_endpoints:
- https://9.99.30.11:8443/realms/main.heim.lan/protocol/openid-connect/logout
- https://keycloak.service.heim.lan:8443/realms/main.heim.lan/protocol/openid-connect/logout
Die Rücksprungadresse muss in pve_redirect_uris stehen. PVE-Zugriff per IP und DNS
ist über mehrere Einträge in dieser Liste möglich. Die Logout-Rückkehr erfolgt zur
gewählten festen Adresse. Andere PVE-Tabs/Host-Cookies werden dadurch nicht gelöscht.
Der Browser meldet die Keycloak-Sitzung zunächst über die erste, dann über die zweite Adresse ab. Die zweite Logout-URL einschließlich ihrer kodierten Rücksprungadresse wird als exakter erlaubter Post-Logout-Redirect am Client registriert, ebenso die finale PVE-Adresse. Es gibt keine Wildcard-Freigabe. Der Assistent/Ansible erzeugt die Kodierung; nicht manuell Markdown-Links in URLs einsetzen. Die vorhandene Post-Logout-Redirect-Liste wird durch die für diesen Ablauf benötigten Einträge ersetzt.
Bis zu zwei Bestätigungsseiten sind möglich. Erst nach Abschluss der gesamten Kette sind beide Browser-Sitzungen angesprochen worden. Abbruch, Nichterreichbarkeit eines Hosts oder ein vorgeschalteter Identity Provider können den Ablauf unterbrechen bzw. eine neue automatische Anmeldung verursachen. Der Ablauf ist kein serverseitiger Global-Logout aller Sitzungen des Benutzers auf anderen Geräten.
Beide Adressen brauchen gültiges HTTPS: im Zertifikat DNS-SAN für den FQDN und IP-SAN
für 9.99.30.11 (oder passende separate Zertifikate). Die CA-Prüfung wird nicht
abgeschaltet. Ein Fehler hierbei muss an Zertifikat/Truststore behoben werden.
Es bleibt ein kanonischer OIDC-Issuer. IP und FQDN sind Zugriffsaliase desselben Realms; die Discovery-Antwort beider Aliase muss denselben Issuer liefern. Die bestehende Issuer-Konfiguration nicht allein aufgrund der Browser-URL ändern. Wenn beide Aliase unterschiedliche Issuer ausliefern, Keycloaks Hostname-Konfiguration zuerst vereinheitlichen. Der Logout-Modus ändert weder den Login-Issuer noch Serverzertifikate automatisch.
Installation auf bereits eingerichteten Hosts:
ansible-playbook -i inventory/hosts.local.yml playbook/logout.yml --ask-vault-pass
Danach PVE mit deaktiviertem Browsercache neu laden. Je einen Testlogin über die verwendeten Keycloak-Adressen durchführen und nach vollständigem Logout die Sessions prüfen, bevor erneut angemeldet wird. Lokal sind Kodierung, Patch, Realm-Zuordnung, Rückbau und Wiederholung geprüft; der vollständige Ablauf auf deinem Keycloak steht aus.