New Version
This commit is contained in:
+53
-1
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user