New Version

This commit is contained in:
Madzone
2026-09-09 14:13:44 +02:00
parent 23312854fc
commit efba066b51
11 changed files with 170 additions and 31 deletions
+53 -1
View File
@@ -1,6 +1,6 @@
# PVE 9 + Keycloak OIDC für HEIMLAN
Version: **1.2.1** · [Änderungsprotokoll](CHANGELOG.md) · [Versionsdatei](VERSION)
Version: **1.3.0** · [Änderungsprotokoll](CHANGELOG.md) · [Versionsdatei](VERSION)
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`.
@@ -287,3 +287,55 @@ python3 /root/pve-idm-logout-patch.py \
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:
```yaml
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:
```bash
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.