This commit is contained in:
Madzone
2026-09-10 09:14:19 +02:00
parent efba066b51
commit ce5e389abd
23 changed files with 639 additions and 0 deletions
+16
View File
@@ -0,0 +1,16 @@
# Lokale Geheimnisse und Laufzeitdaten
.env
.env.*
!.env.example
*.local.*
secrets/
*.key
*.pem
*.p12
*.pfx
*.jks
kcadm.config
.kcadm.config
*.log
__pycache__/
.DS_Store
+202
View File
@@ -0,0 +1,202 @@
# PegaProx mit Keycloak über OIDC
Git-taugliche Einrichtungsanleitung, rekonstruiert aus „OIDC Endpunkte korrigieren“ vom 09.09.2026. Alle internen Adressen, Namen und IPs sind **Beispielwerte aus der Unterhaltung** und müssen für andere Umgebungen ersetzt werden. Keine Zugangsdaten enthalten.
## Nachweis und Grenzen
Der Benutzer bestätigte abschließend, dass die Anmeldung und Rollenzuordnung funktionieren. Belegt sind erfolgreiche Discovery-Abfragen mit curl und Python, der Claim `groups: ["pegaprox-admins"]` und die abschließende Zuordnung in PegaProx. Nach dem Vorschlag eines PegaProx-Neustarts und alternativ eines kurzen Tests ohne TLS-Prüfung wurde Erfolg gemeldet; welche Maßnahme tatsächlich ausgeführt wurde, ist nicht eindeutig dokumentiert. Der finale Schalterstand von „Skip SSL verification“ ist nicht belegt. Diese Anleitung setzt ihn für den sicheren Zielzustand auf OFF und fordert einen erneuten Test.
Exakte PegaProx- und Keycloak-Versionen fehlen. UI-Bezeichnungen beziehen sich auf die Unterhaltung; ergänzende CA- und CLI-Schritte sind reproduzierbare Anleitungen, keine Behauptung über bereits ausgeführte Änderungen. Ein Quellcode-Patch ist nicht als ausgeführt belegt und wird nicht benötigt, wenn Discovery funktioniert.
## Repo-Struktur
```text
README.md
docs/troubleshooting.md
docs/verification.md
example-configs/keycloak-client.example.json
example-configs/pegaprox-groups-scope.example.json
example-configs/pegaprox-oidc.example.json
example-configs/discovery.example.json
example-configs/pegaprox-ca.conf.example
scripts/check-discovery.py
.gitignore
```
## 1. Voraussetzungen und Beispielumgebung
| Zweck | Beispielwert |
|---|---|
| Keycloak | `https://9.99.30.11:8443` |
| Realm | `service.heim.lan` |
| Client ID (Großschreibung beachten) | `PegaProx` |
| PegaProx | `https://9.99.30.13:5000` |
| Callback | `https://9.99.30.13:5000/oidc/callback` |
| Zertifikats-CN | `keycloak.service.heim.lan` |
| Aussteller des Serverzertifikats | `HEIMLAN_SubCA` |
| System-CA-Bundle | `/etc/ssl/certs/ca-certificates.crt` |
| PegaProx-Dienst / Benutzer | `pegaprox` |
| Python / Anwendung | `/usr/bin/python3`, `/usr/lib/pegaprox/pegaprox_multi_cluster.py` |
Keycloak und PegaProx sind bereits installiert. Benötigt werden Realm-Administrationsrechte, ein lokaler PegaProx-Administrator, Netzwerkzugriff vom Browser auf beide Dienste und vom PegaProx-Dienst auf Keycloak:8443 sowie korrekte Systemzeiten. Für Diagnosen: curl, Python 3 mit requests; optional die Keycloak Admin CLI.
Die Adressen `9.99.30.x` wurden intern verwendet, gehören aber nicht zu den privaten RFC1918-Netzen. Nicht als frei verfügbare Lab-Adressen übernehmen. Der alternative Name `auth.service.heim.lan` war im Chat nur ein Vorschlag, kein nachgewiesener finaler Issuer. Ein Wechsel von IP auf DNS erfordert konsistente Issuer-, Zertifikats- und Client-Einstellungen.
## 2. Keycloak-Client anlegen
Im Realm `service.heim.lan`: **Clients → Create client**. Client type **OpenID Connect**, Client ID **PegaProx**.
| Einstellung | Wert |
|---|---|
| Client authentication | ON (vertraulicher Client) |
| Authorization | OFF |
| Standard flow | ON |
| Direct access grants | OFF |
| Implicit flow | OFF |
| Service accounts roles | OFF |
| Root URL / Home URL | `https://9.99.30.13:5000` |
| Valid redirect URIs | `https://9.99.30.13:5000/oidc/callback` |
| Web origins | `https://9.99.30.13:5000` |
Speichern. Unter **Credentials** das erzeugte Client Secret ausschließlich in PegaProx eintragen. Es wird weder in dieser Repo-Struktur noch in einem Export gespeichert. Die JSON-Datei ist eine Vorlage für einen neuen Client; bei vorhandenem Client die UI-Werte abgleichen, nicht blind erneut importieren.
Die beobachtete Anmeldung verwendet Authorization Code Flow mit PKCE S256 (`response_type=code`, `code_challenge_method=S256`). Eine zwingende PKCE-Clientrichtlinie war nicht nachgewiesen. Post-Logout-Redirects sind für diesen Login nicht nötig; nur bei tatsächlich eingerichtetem Logout mit dessen exaktem Rücksprungziel ergänzen. Das früher vorgeschlagene `https://9.99.30.13:5000/*` ist kein nachgewiesener finaler Logout-Wert.
## 3. TLS-Vertrauen herstellen und Discovery prüfen
Im tatsächlichen PegaProx-Host bzw. Container prüfen, nicht nur auf einem anderen Rechner:
```bash
curl --fail --show-error --silent \
'https://9.99.30.11:8443/realms/service.heim.lan/.well-known/openid-configuration'
python3 scripts/check-discovery.py
```
Erwartet: HTTP 200, JSON und exakt der konfigurierte Issuer. Die Endpunkte werden aus Discovery bezogen:
| Feld | Beispiel-URL |
|---|---|
| issuer | `https://9.99.30.11:8443/realms/service.heim.lan` |
| Discovery | `https://9.99.30.11:8443/realms/service.heim.lan/.well-known/openid-configuration` |
| authorization_endpoint | `https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/auth` |
| token_endpoint | `https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/token` |
| jwks_uri | `https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/certs` |
| userinfo_endpoint | `https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/userinfo` |
Der UserInfo-Pfad ist der Keycloak-Standard; sein vollständiger Wert war im ursprünglichen curl-Auszug abgeschnitten. Die anderen Endpunkte waren sichtbar. Keycloak dokumentiert Discovery und diese Endpunkte in der [OIDC-Dokumentation](https://www.keycloak.org/securing-apps/oidc-layers).
Falls die interne CA noch fehlt, auf Debian/Ubuntu im PegaProx-System die vertrauenswürdig beschaffte öffentliche Root-CA installieren (Dateiname hier neu gewähltes Beispiel):
```bash
sudo install -m 0644 /pfad/zur/geprueften/heimlan-root-ca.crt \
/usr/local/share/ca-certificates/heimlan-root-ca.crt
sudo update-ca-certificates
sudo systemctl restart pegaprox
```
Die Datei muss ein PEM-Zertifikat enthalten; pro `.crt` eine CA. Die Serverkette sollte benötigte Intermediate-Zertifikate liefern. Fehlende Intermediate-Ketten am Keycloak-TLS-Endpunkt korrigieren. Keine privaten Schlüssel kopieren. Bei Containern die CA dauerhaft im Image oder vorgesehenen Truststore bereitstellen; Änderungen nur am Host reichen nicht.
Im Chat vertrauten curl und Python der CA bereits: curl meldete „SSL certificate verify ok“, IP-SAN passend zu `9.99.30.11`, HTTP 200. requests und certifi verwendeten beide das System-Bundle. Ein grundsätzlich defektes Zertifikat oder ein abweichendes certifi-Bundle war damit für diese Shell nicht belegt.
Nach einer CA-/Dienständerung PegaProx neu starten und den integrierten OIDC-Test wiederholen. Bei weiterem Fehler siehe [TLS-Diagnose](docs/troubleshooting.md). „Skip SSL verification“ bleibt im Zielzustand **OFF**; ein erfolgreicher Test nur mit abgeschalteter Prüfung ist kein abgeschlossener TLS-Fix.
## 4. PegaProx-OIDC-Einstellungen
**OIDC / Entra ID** öffnen und OIDC aktivieren, soweit separat vorhanden:
| Einstellung | Wert |
|---|---|
| Provider | Generic OIDC (`generic`) |
| Issuer / Authority | `https://9.99.30.11:8443/realms/service.heim.lan` |
| Client ID | `PegaProx` |
| Client Secret | lokal aus Keycloak Credentials einsetzen |
| Scopes | `openid profile email` |
| Redirect URI | `https://9.99.30.13:5000/oidc/callback` |
| JWT-Signaturprüfung | aktiviert |
| Skip SSL verification | OFF, abschließend überprüfen |
| Allow private IP | nur bei beabsichtigtem internem IdP und konkreter SSRF-Blockierung erforderlich; finaler Chat-Wert unbekannt |
| Auto-create users on first login | ON |
| Default Role (no group match) | Viewer |
In das Issuer-Feld gehört weder die Discovery-URL noch der `/auth`-Endpunkt. **Save OIDC Settings**, anschließend OIDC-Test. Discovery muss erfolgreich sein und der Authorization-Endpunkt auf `/protocol/openid-connect/auth` enden. Bei deaktivierter Discovery verwendete die untersuchte Version einen falschen `/authorize`-Fallback.
## 5. Gruppen, Client Scope und Mapper
Im Realm unter **Groups → Create group** anlegen:
```text
pegaprox-admins
pegaprox-users
pegaprox-viewers
```
Unter **Users → Benutzer → Groups → Join Group** zuweisen. Im Chat war `svc_cm_admin` das Beispiel für die Mitgliedschaft in `pegaprox-admins`; der Name allein verleiht keine Rechte und meint hier einen interaktiv anmeldenden Benutzer, keinen Client-Credentials-Service-Account.
**Client Scopes → Create client scope**: Name `pegaprox-groups`, Protocol `OpenID Connect`. Unter **Mappers → Configure a new mapper → Group Membership**:
| Einstellung | Wert |
|---|---|
| Name | groups |
| Token Claim Name | groups |
| Full group path | OFF |
| Add to ID token | ON |
| Add to access token | ON |
| Add to userinfo | ON |
Danach **Clients → PegaProx → Client scopes → Add client scope**: `pegaprox-groups` als **Default** zuweisen. Deshalb muss der Scope nicht zusätzlich im angeforderten `openid profile email` stehen. Die Scope-JSON-Datei bildet diese Mapper-Einstellungen ab; Import allein ersetzt weder Client-Zuweisung noch Gruppenmitgliedschaften. Grundlagen: [Keycloak Client Scopes und Mapper](https://www.keycloak.org/docs/latest/server_admin/).
Unter **Clients → PegaProx → Client scopes → Evaluate** einen Gruppenbenutzer wählen. Im Generated ID Token muss stehen:
```json
{"groups": ["pegaprox-admins"]}
```
Kein führender Slash und keine Gruppen-UUID. Ein Realm-Rollen-Claim unter `realm_access.roles` ersetzt diesen Gruppen-Claim nicht. Nach Änderungen neue Tokens durch erneute Anmeldung erzeugen.
## 6. PegaProx Group → Role Mapping
Auf derselben OIDC-Seite nach unten zu **Group → Role Mapping**. Im Feld **GroupName** den Namen eingeben, rechts die Rolle wählen; weitere Zeilen über **+ Add Mapping**:
| GroupName | Rolle |
|---|---|
| pegaprox-admins | Administrator |
| pegaprox-users | User |
| pegaprox-viewers | Viewer |
**Default Role (no group match): Viewer**, **Auto-create users on first login: ON**, anschließend **Save OIDC Settings**.
Die früher im Chat vermuteten Felder „Admin Group ID“ usw. sind nicht die bestätigte UI-Anleitung. Die bestätigte Oberfläche verwendet die obige Mapping-Tabelle. Der gepostete Code unterstützt zusätzlich eingebaute Gruppenfelder und gewichtet Administrator vor User vor Viewer; er normalisiert Groß-/Kleinschreibung, entfernt aber keinen führenden Slash aus Claim-Werten. Für einfache Nachvollziehbarkeit genau die obigen Gruppennamen nutzen.
## 7. Login und Abnahme
PegaProx vollständig abmelden, bei Bedarf ein separates Browserprofil verwenden, dann **Sign in with OIDC**. Keycloak-Anmeldung durchführen; Rückkehr zur Callback-URI und Anmeldung in PegaProx prüfen. Den Account `svc_cm_admin` (Beispiel) als Administrator erwarten. Die [Testmatrix](docs/verification.md) deckt weitere Rollen ab.
Bestehende Benutzer zuerst erneut anmelden und die effektive Rolle kontrollieren. Der Codeauszug enthält einen Aktualisierungspfad für Benutzer; welche Attribute aktualisiert werden, wurde nicht vollständig gezeigt. Deshalb ist Löschen kein allgemeiner Pflichtschritt. Der Chat schlug die Neuanlage eines falsch provisionierten Accounts vor, belegt deren Ausführung aber nicht. Nur falls erforderlich, nach Prüfung von Zuordnungen und Daten sowie mit verfügbarem lokalem Admin den betroffenen PegaProx-Account gezielt neu provisionieren; nicht den Keycloak-Benutzer löschen.
## 8. Finaler funktionierender Zusammenhang
```text
Keycloak Realm service.heim.lan / Client PegaProx
→ Discovery liefert Keycloak-Endpunkte
→ Authorization Code + PKCE S256
→ Callback https://9.99.30.13:5000/oidc/callback
→ groups enthält pegaprox-admins
→ PegaProx Group → Role Mapping
→ Administrator
```
Dieser Ablauf wurde vom Benutzer als funktionierend bestätigt. Viewer als Standard und TLS-Prüfung ON sind die dokumentierte Zielkonfiguration; ein vollständiger abschließender Konfigurationsexport oder Sicherheits-Test liegt nicht vor. Die Vorlagen sind ohne Geheimnisse und keine Sicherung der laufenden Installation. `pegaprox-oidc.example.json` ist ausdrücklich eine lesbare Sollwertliste, kein zugesichertes Import-/API-Format.
## 9. In Git übernehmen
ZIP entpacken, in den entpackten Ordner wechseln:
```bash
git init
git add README.md docs example-configs scripts .gitignore
git diff --cached --check
git diff --cached
git commit -m "docs: document PegaProx Keycloak OIDC setup"
```
Vor dem Commit lokale Anpassungen auf Secrets prüfen. Ein Remote-Repository wurde nicht erstellt oder veröffentlicht. `.gitignore` schützt nur passende unversionierte Dateien; niemals echte Secrets in die versionierten Vorlagen eintragen.
+92
View File
@@ -0,0 +1,92 @@
# Troubleshooting
Alle Adressen sind Beispielwerte aus der Unterhaltung. Befehle im tatsächlichen PegaProx-System ausführen. Dienstneustarts unterbrechen laufende Sitzungen möglicherweise kurz.
## Fehlerbilder
| Symptom | Einordnung | Maßnahme |
|---|---|---|
| CERTIFICATE_VERIFY_FAILED / self-signed certificate in certificate chain | CA-Vertrauen oder Kette im anfragenden Prozess fehlt | CA, Kette, SAN und Prozessumgebung prüfen |
| Discovery doc not reachable, danach `/authorize` 404 | PegaProx fällt auf generische Endpunkte zurück | Discovery/TLS beheben, nicht Issuer um `/protocol/openid-connect` erweitern |
| `/realms/service.heim.lan/.well-known/jwks.json` schlägt fehl | Ebenfalls generischer Fallback | Discovery muss `/protocol/openid-connect/certs` liefern |
| curl/Python 200, PegaProx weiterhin TLS-Fehler | Shell und Dienst können verschiedene Umgebungen haben | Interpreter, Dienstbenutzer, CA-Variablen prüfen; Dienst neu starten |
| invalid_redirect_uri | Callback stimmt nicht exakt überein | Schema, IP/Host, Port, Pfad und Slash mit Client vergleichen |
| invalid_client | Client ID, Secret oder Client-Authentifizierung falsch | PegaProx ID und aktuelles Secret mit Client Credentials abgleichen |
| groups fehlt | Mapper, Scope-Zuweisung oder Mitgliedschaft fehlt | Evaluate prüfen, Scope Default, frische Tokens |
| `/pegaprox-admins` statt `pegaprox-admins` | Full group path aktiv | Mapper auf OFF, neu anmelden |
| Gruppe korrekt, aber Benutzer statt Administrator | PegaProx-Mapping fehlt/falsch oder bestehende Provisionierung | GroupName und Rolle speichern; erneute Anmeldung |
| SSRF guard rejected / private IP | URL-Schutz blockiert Ziel | Issuer prüfen; gezielte Allow-private-IP-Option für beabsichtigten IdP |
| kcadm invalid_grant | Anmeldung der Admin CLI fehlgeschlagen | Anmelde-Realm, Passwort, Kontostatus, Required Actions prüfen |
## TLS systematisch eingrenzen
```bash
curl -v 'https://9.99.30.11:8443/realms/service.heim.lan/.well-known/openid-configuration'
/usr/bin/python3 -c 'import requests, certifi, ssl; print(requests.certs.where()); print(certifi.where()); print(ssl.get_default_verify_paths())'
systemctl show pegaprox --property=User --property=ExecStart --property=MainPID
```
Im Chat: CA-Bundle `/etc/ssl/certs/ca-certificates.crt`, Zertifikat-CN `keycloak.service.heim.lan`, Aussteller `HEIMLAN_SubCA`, IP-SAN passte. Der CN allein wäre für IP-Zugriff nicht ausreichend. Das gezeigte Zertifikat galt vom 18.07.2026 bis 17.07.2028; das ist historischer Befund, keine Aussage über das heute installierte Zertifikat.
Mit dem Diagnose-Skript aus dem Repo und einem für den Dienstbenutzer lesbaren absoluten Pfad:
```bash
sudo -u pegaprox /usr/bin/python3 /pfad/zum/repo/scripts/check-discovery.py
# Ohne sudo, als root:
runuser -u pegaprox -- /usr/bin/python3 /pfad/zum/repo/scripts/check-discovery.py
```
Das prüft Benutzer und Interpreter, übernimmt aber nicht automatisch die systemd-Umgebung. Dienstdatei und Drop-ins lokal auf CA-Pfade prüfen; keine vollständigen Umgebungs- oder Konfigurationsdumps veröffentlichen, da diese Secrets enthalten können.
Vergleich mit explizitem Bundle:
```bash
REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt \
/usr/bin/python3 scripts/check-discovery.py
```
Funktioniert nur das, kann die mitgelieferte `example-configs/pegaprox-ca.conf.example` als systemd-Drop-in dienen. Vorhandene Overrides prüfen und ergänzen, nicht überschreiben:
```bash
sudo systemctl edit pegaprox
# Inhalt der Beispiel-Datei im Editor ergänzen und speichern.
sudo systemctl daemon-reload
sudo systemctl restart pegaprox
sudo systemctl status pegaprox --no-pager
```
Requests unterstützt `REQUESTS_CA_BUNDLE`; `SSL_CERT_FILE` ist zusätzlich für Python/OpenSSL-Verbraucher vorgesehen, die es berücksichtigen. Ein Shell-export ändert keinen bereits laufenden systemd-Dienst. Siehe [Requests TLS-Dokumentation](https://requests.readthedocs.io/en/stable/user/advanced/#ssl-cert-verification).
Danach PegaProx-OIDC-Test mit **Skip SSL verification OFF**. Ein kurzer unautorisierter Discovery-Abruf mit `curl -k` kann TLS als Ursache eingrenzen, validiert aber keine Identität. Den Login nicht als TLS-erfolgreich bewerten, solange die Zertifikatsprüfung ausgeschaltet ist. JWT-Prüfung bleibt aktiviert.
## Fallback und Cache
Der gepostete Code in `/usr/lib/pegaprox/pegaprox/utils/oidc.py` ruft Discovery per requests auf. Bei TLS-/HTTP-/JSON-Fehlern konstruiert er `<authority>/authorize`, `/token`, `/.well-known/jwks.json` und `/userinfo`. Diese Vermutungen passen nicht zu den gezeigten Keycloak-Endpunkten. Erfolgreiche Discovery-Daten werden dort bis zu 3600 Sekunden gecacht. Ein Dienstneustart setzt den Prozesszustand zurück; anschließend erneut testen.
Frühere Chat-Vermutungen über einen nachgewiesenen Codefehler oder ein separates certifi-Bundle wurden nicht bestätigt. Keine pauschale Zeichenersetzung in `oidc.py` durchführen: Sie verdeckt die eigentliche Discovery-Ursache und ist nicht der dokumentierte finale Fix.
## Admin CLI: Anmelde-Realm und Ziel-Realm unterscheiden
Auf dem Keycloak-System, Passwort interaktiv eingeben:
```bash
/opt/keycloak/bin/kcadm.sh config credentials \
--server 'https://9.99.30.11:8443' \
--realm master --user '<MASTER_ADMIN>'
/opt/keycloak/bin/kcadm.sh get clients -r 'service.heim.lan' \
-q clientId=PegaProx --fields id,clientId
```
Falls der berechtigte Administrator stattdessen im Realm `service.heim.lan` liegt, diesen Realm bei `config credentials --realm` angeben. Der Ziel-Realm der späteren Operationen bleibt `-r service.heim.lan`. Ein gleichnamiger Benutzer in beiden Realms ist nicht dieselbe Identität. Das im Chat versuchte `madzone` im Realm `master` scheiterte mit `invalid_grant`; ein späterer CLI-Erfolg ist nicht belegt. Erfolgreiche Anmeldung allein beweist zudem noch keine administrativen Rechte.
Optionale Erstellung einer noch nicht vorhandenen Gruppe:
```bash
/opt/keycloak/bin/kcadm.sh get groups -r 'service.heim.lan' \
-q search=pegaprox-admins --fields id,name
# Nur anlegen, falls die exakte Gruppe noch nicht existiert:
/opt/keycloak/bin/kcadm.sh create groups -r 'service.heim.lan' \
-s name=pegaprox-admins
```
Analog für users/viewers. Kein pauschales `|| true`: Es würde Berechtigungs- und Netzwerkfehler verschlucken. Die CLI kann eine eigene Java-Truststore-Konfiguration benötigen; ein erfolgreiches Python-TLS-Ergebnis gilt nicht automatisch für Java. CLI-Konfigurationsdateien mit Tokens außerhalb dieses Repos halten. Vollständige Gruppen-/Mapper-Automatisierung war im Chat nur angeboten, nicht ausgeführt.
+36
View File
@@ -0,0 +1,36 @@
# Tests und Abnahmeprotokoll
## Historisch belegt
- curl: Zertifikatsprüfung erfolgreich, Discovery HTTP 200.
- requests: HTTP 200, passender Issuer sowie Authorization-/JWKS-Endpunkte.
- requests und certifi zeigten auf `/etc/ssl/certs/ca-certificates.crt`.
- Browser nutzte zunächst den falschen `/authorize`-Pfad und erhielt „Page not found“.
- Nach Neustart-/TLS-Test-Vorschlag: Benutzer meldete „ok ht geholfen“.
- Geteilte Claims enthielten `groups: ["pegaprox-admins"]`.
- Nach Anleitung zum Group→Role Mapping: Benutzer meldete „es geht jatzt“.
Nicht einzeln nachgewiesen: finaler TLS-Schalter, erfolgte CA-Installation, tatsächlich ausgeführter Neustart, Benutzerlöschung, alle drei Rollentests, Logout sowie Versionsnummern.
## Wiederholbare Abnahme
| Test | Erwartung | Ergebnis / Datum |
|---|---|---|
| Discovery per curl ohne -k | TLS gültig, HTTP 200 | offen |
| Python im Dienstkontext | HTTP 200, exakter Issuer | offen |
| PegaProx-OIDC-Test | Discovery erfolgreich, korrekte auth/JWKS URLs | offen |
| TLS-Schalter | Skip SSL verification OFF | offen |
| JWT-Prüfung | aktiviert | offen |
| Token Evaluate | groups als Array ohne führenden Slash | offen |
| Frischer Admin-Login | Administrator | offen |
| Frischer User-Login | User; keine Admin-Funktionen | offen |
| Frischer Viewer-Login | Viewer; keine Schreibrechte | offen |
| Ohne passende Gruppe | Viewer | offen |
| Admin- und User-Gruppe zusammen | Administrator gemäß untersuchtem Code | offen |
| Bestehender Benutzer nach Gruppenänderung | tatsächliche Rollenaktualisierung prüfen | offen |
Viewer als Default bedeutet, dass ein Benutzer ohne passende Gruppe grundsätzlich noch Leserechte erhalten kann. Falls gar kein Zugriff gewünscht ist, muss das gesondert konfiguriert und getestet werden.
Ein HTTP 400 am Authorization-Endpunkt ohne vollständige Login-Parameter kann dessen Erreichbarkeit zeigen, beweist aber keinen erfolgreichen Login. Erst der vollständige Browser-Flow prüft Client Secret, Callback, Tokenverarbeitung und effektive Rollen gemeinsam. Ein decodiertes JWT allein beweist keine gültige Signatur; Evaluate ist ein Claim-Konfigurationstest.
Keine echten Tokens, Secrets, Cookies oder vollständigen Benutzerprofile in dieses Protokoll aufnehmen. Prüfungen der gelieferten Dateien sind keine Live-Tests der internen Installation.
@@ -0,0 +1,7 @@
{
"issuer": "https://9.99.30.11:8443/realms/service.heim.lan",
"authorization_endpoint": "https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/auth",
"token_endpoint": "https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/token",
"jwks_uri": "https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/certs",
"userinfo_endpoint": "https://9.99.30.11:8443/realms/service.heim.lan/protocol/openid-connect/userinfo"
}
@@ -0,0 +1,21 @@
{
"clientId": "PegaProx",
"name": "PegaProx",
"protocol": "openid-connect",
"enabled": true,
"publicClient": false,
"clientAuthenticatorType": "client-secret",
"standardFlowEnabled": true,
"implicitFlowEnabled": false,
"directAccessGrantsEnabled": false,
"serviceAccountsEnabled": false,
"authorizationServicesEnabled": false,
"rootUrl": "https://9.99.30.13:5000",
"baseUrl": "https://9.99.30.13:5000",
"redirectUris": [
"https://9.99.30.13:5000/oidc/callback"
],
"webOrigins": [
"https://9.99.30.13:5000"
]
}
@@ -0,0 +1,5 @@
# Ergänzende Vorlage, nicht als tatsächlich ausgeführter Chat-Fix belegt.
# Mit systemctl edit pegaprox in vorhandene Konfiguration integrieren.
[Service]
Environment="REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt"
Environment="SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt"
@@ -0,0 +1,20 @@
{
"name": "pegaprox-groups",
"description": "Beispiel: nach Erstellung dem PegaProx-Client als Default zuweisen",
"protocol": "openid-connect",
"protocolMappers": [
{
"name": "groups",
"protocol": "openid-connect",
"protocolMapper": "oidc-group-membership-mapper",
"consentRequired": false,
"config": {
"full.path": "false",
"id.token.claim": "true",
"access.token.claim": "true",
"userinfo.token.claim": "true",
"claim.name": "groups"
}
}
]
}
@@ -0,0 +1,18 @@
{
"hinweis": "Dokumentarische Sollwertliste, kein PegaProx-Importformat. Alle Adressen sind Beispielwerte. Secret separat lokal eintragen. TLS-Schalter im finalen Chat nicht belegt.",
"provider": "Generic OIDC",
"issuer": "https://9.99.30.11:8443/realms/service.heim.lan",
"client_id": "PegaProx",
"scopes": "openid profile email",
"redirect_uri": "https://9.99.30.13:5000/oidc/callback",
"jwt_signature_verification": true,
"skip_ssl_verification": false,
"allow_private_ip": "Nur bei bewusstem internem Ziel und entsprechender Blockierung; Chat-Wert unbekannt",
"auto_create_users": true,
"default_role": "Viewer",
"group_role_mapping": {
"pegaprox-admins": "Administrator",
"pegaprox-users": "User",
"pegaprox-viewers": "Viewer"
}
}
+37
View File
@@ -0,0 +1,37 @@
#!/usr/bin/env python3
"""Nur öffentliche Discovery-Metadaten abrufen; TLS-Prüfung bleibt aktiv."""
import argparse
import sys
import requests
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--issuer", default="https://9.99.30.11:8443/realms/service.heim.lan",
help="Beispielwert aus dem Chat; für andere Umgebungen ersetzen")
args = parser.parse_args()
issuer = args.issuer.rstrip("/")
if not issuer.startswith("https://"):
parser.error("HTTPS-Issuer erforderlich")
print("CA-Bundle (Bibliotheksstandard):", requests.certs.where())
try:
response = requests.get(issuer + "/.well-known/openid-configuration", timeout=15)
response.raise_for_status()
data = response.json()
if data.get("issuer") != issuer:
raise ValueError("Issuer stimmt nicht exakt mit der Konfiguration überein")
for key in ("issuer", "authorization_endpoint", "token_endpoint", "jwks_uri", "userinfo_endpoint"):
value = data.get(key)
if not isinstance(value, str) or not value.startswith("https://"):
raise ValueError("Fehlendes/ungültiges HTTPS-Feld: " + key)
print(key + ":", value)
print("OK: Discovery erreichbar und erforderliche HTTPS-Felder vorhanden.")
print("Kein Login-, Rollen- oder JWT-Signaturtest.")
return 0
except (requests.RequestException, ValueError) as exc:
print("FEHLER:", exc, file=sys.stderr)
return 1
if __name__ == "__main__":
sys.exit(main())
@@ -0,0 +1,48 @@
#!/bin/bash
echo "Idempotentes Hinzufügen von VMs und CTs zur HA (ohne Templates)..."
# Funktion zum Prüfen, ob eine HA-Ressource bereits existiert
ha_exists() {
local res="$1"
ha-manager status | awk '{print $1}' | grep -qx "$res"
}
# --- VMs (Qemu) ---
for vmid in $(qm list | awk 'NR>1 {print $1}'); do
# Templates überspringen
if qm config "$vmid" | grep -q "^template:\s*1"; then
echo "VM $vmid ist ein Template → wird übersprungen."
continue
fi
resource="vm:$vmid"
if ha_exists "$resource"; then
echo "VM $vmid ist bereits in HA → OK."
else
echo "VM $vmid wird zur HA hinzugefügt..."
ha-manager add $resource --state started --max_restart 3 --max_relocate 3
fi
done
# --- CTs (LXC) ---
for ctid in $(pct list | awk 'NR>1 {print $1}'); do
# Templates überspringen
if pct config "$ctid" | grep -q "^template:\s*1"; then
echo "CT $ctid ist ein Template → wird übersprungen."
continue
fi
resource="ct:$ctid"
if ha_exists "$resource"; then
echo "CT $ctid ist bereits in HA → OK."
else
echo "CT $ctid wird zur HA hinzugefügt..."
ha-manager add $resource --state started --max_restart 3 --max_relocate 3
fi
done
echo "Fertig."
@@ -0,0 +1,48 @@
logging {
debug: off
to_syslog: yes
}
nodelist {
node {
name: pve-x-1
nodeid: 1
quorum_votes: 1
ring0_addr: 10.1.99.XXX
ring1_addr: 10.3.99.XXX
}
node {
name: pve-x-2
nodeid: 2
quorum_votes: 1
ring0_addr: 10.1.99.XXX
ring1_addr: 10.3.99.XXX
}
node {
name: pve-x-3
nodeid: 3
quorum_votes: 1
ring0_addr: 10.1.99.XXX
ring1_addr: 10.3.99.XXX
}
}
quorum {
provider: corosync_votequorum
}
totem {
cluster_name: cluster-x
config_version: 4
interface {
linknumber: 0
}
interface {
linknumber: 1
}
ip_version: ipv4-6
link_mode: passive
secauth: on
version: 2
}
@@ -0,0 +1,89 @@
# network interface settings; autogenerated
# Please do NOT modify this file directly, unless you know what
# you're doing.
#
# If you want to manage parts of the network configuration manually,
# please utilize the 'source' or 'source-directory' directives to do
# so.
# PVE will preserve these directives, but will NOT read its network
# configuration from sourced files, so do not attempt to move any of
# the PVE managed interfaces into external files!
auto lo
iface lo inet loopback
auto ens18
iface ens18 inet manual
# Karte 10GBPS
auto ens19
iface ens19 inet manual
auto ens20
iface ens20 inet static
address 10.2.99.XXX/24
#Corosync Link 0
auto ens21
iface ens21 inet static
address 10.3.99.XXX/24
#Corosync Link 1
auto ens22
iface ens22 inet manual
auto ens23
iface ens23 inet manual
auto bond0
iface bond0 inet manual
bond-slaves ens18 ens19
bond-miimon 100
bond-mode active-backup
bond-primary ens18
#Bond0 nach aussen
auto bond1
iface bond1 inet manual
bond-slaves ens22 ens23
bond-miimon 100
bond-mode active-backup
bond-primary ens22
#Bond1 zum Ceph Storage
auto vmbr0
iface vmbr0 inet static
address 10.1.99.XXX/24
gateway 10.1.99.254
bridge-ports bond0
bridge-stp off
bridge-fd 0
#Bridge nach aussen
source /etc/network/interfaces.d/*
auto vmbr1
iface vmbr1 inet static
address 192.168.127.254/24
bridge-ports none
bridge-stp off
bridge-fd 0
pre-up iptables -t nat -A POSTROUTING -s '192.168.127.0/24' -o vmbr0 -j MASQUERADE
pre-up echo 1 > /proc/sys/net/ipv4/ip_forward
post-down iptables -t nat -F
# END ANSIBLE MANAGED BLOCK
auto Ceph_public
iface Ceph_public inet static
address 10.4.99.XXX/24
vlan-id 50
vlan-raw-device bond1
#Ceph_public
auto Ceph_cluster
iface Ceph_cluster inet static
address 10.5.99.XXX/24
vlan-id 51
vlan-raw-device bond1
#Ceph_cluster