GNMON-001 M6 abgenommen: Dashboard oeffentlich via mon.ghostnet.selfhost.eu (Keycloak-OIDC)

Kette: Browser -> https://mon.ghostnet.selfhost.eu (NPM CT-103 ID 14, LE-TLS,
Force SSL, WS-Support, X-Forwarded-Proto/Host + 32k-Puffer) -> 10.0.0.90:8080
(nftables gnmon_firewall: nur von 10.0.0.10) -> Blazor v0.3.2 -> Keycloak
Realm Ghost.net, Client gnai-dashboard, Rollen gnai-dashboard-user/-admin.

Neu/geaendert:
- Rolle gnmon_firewall (nftables auf ghostnet-ki, Policy ACCEPT, 8080 nur
  von NPM, Monitoring-Ports non-loopback-drop), Tag firewall in monitor.yml
- Dashboard-Bind 10.0.0.90:8080 (Assertion: LAN-Bind nur mit Firewall-Tag);
  Image v0.3.2; Playbook-Verifikation akzeptiert 200/302 mit Forwarded-Headern
- App: ClientId gnai-dashboard, Auth:AllowedRoles konfigurierbar,
  KnownNetworks/KnownProxies per .Clear() (leere Initializer = Loopback-Default),
  GetClaimsFromUserInfoEndpoint=true (realm-roles-Mapper-Flags im Realm unset),
  SaveTokens=true (Logout: id_token_hint), Cookie AccessDeniedPath
  /access-denied + Page (sonst Redirect-Loop), csproj PrunePackageData=false +
  Containerfile ohne --no-restore (sonst fehlt blazor.web.js im Image ->
  Blazor-Circuit startet nicht)
- KeycloakRealmRolesClaimTransformation auf ClaimTypes.Role + [gnmon-auth]-Log
- CT-100: Adoption 09.11. (pct exec), Split-DNS mon -> 10.0.0.10 live;
  Befunde gefixt: dns_pihole_hosts_records in allen 3 Inventaren gespiegelt,
  FTLCONF_dns_hosts als eine ';'-gejointe Environment-Zeile (systemd: letzter
  Key gewinnt); gnmon_alloy doppelte Key korrigiert
- Doku: GNMON-000 M6 abgenommen (alle Befunde), GNMON-001 v2.2, GNAI-000
  Monitoring/DNS-Zeilen, GNAI-006 v3.1 (Proxy-Host 14), GNAI-012 Stand

E2E 09.11.2026: unauth -> 302 mit PAR request_uri; Direktzugriff 10.0.0.90:8080
gedroppt; blazor.web.js 200 text/javascript; Login ghost -> Dashboard 200 mit
Live-Daten, Unterseiten + WebSocket ok; testuser ohne Rollen -> saubere 403;
/logout ok; monitor.yml gesamt ok=84 changed=0. Server-Image-Store aufgeraeumt
(v0.3.2 + Rollback v0.2.0/v0.1.0).

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
2026-11-09 19:34:50 +01:00
parent 148104de4e
commit fd8e1a5559
25 changed files with 383 additions and 90 deletions
@@ -2,7 +2,7 @@
**Dokumenten-ID:** GNMON-000-DOC
**Stand:** 2026-11-09
**Status:** Revision v2.0 (03.11.2026) übernommen; M1–M5 produktiv auf Workstation + KI-Server; M6 (NPM + Keycloak-OIDC) App-/Server-seitig vorbereitet, externe Freigabe wartet auf Betreiber-Schritte
**Status:** Revision v2.0 (03.11.2026) übernommen; M1–M6 produktiv — Dashboard öffentlich über `https://mon.ghostnet.selfhost.eu` mit Keycloak-OIDC (abgenommen 09.11.2026)
## Dokumente
@@ -330,37 +330,71 @@ Realm `Ghost.net` (Vaultwarden-Realm, Issuer
ergänzt; der Production-Deploy scheitert zunächst, weil auf CT-100 noch
**kein `ansible-deploy`-Konto existiert** (Adoption steht aus, siehe
Betreiber-Schritte).
- **Betreiber-Schritte (offen):**
1. Keycloak: einmalig `kcadm config credentials` als Admin im
`ghostnet-keycloak`-Container (Passwort-Prompt), danach legt der
Agent Client `gn-dashboard` (confidential, Standard-Flow, Redirect
`https://mon.ghostnet.selfhost.eu/signin-oidc`), Realm-Rolle
`dashboard-admin` und Rollen-Zuweisung an; Secret wird nur in die
host-lokale dashboard-secrets.env geschrieben. MFA-Hinweis: eine
reichweitenweite Realm-Policy könnte den produktiven
Vaultwarden-OIDC beeinflussen — Ausgestaltung ist
Betreiberentscheidung (z. B. Conditional Flow nur für die Rolle).
2. CT-100: Adoption-Bootstrap (`bootstrap.yml` auf Bootstrap-Inventar,
`--ask-become-pass`) → Agent deploys den DNS-Record.
3. CT-103: Der Ansible-Nachbau ist abgeschlossen — Projekt unter
`proxmox/lxc/ct-103-reverse-proxy/ansible/`, am 07.11.2026 adoptiert
und am 09.11.2026 verifiziert (preflight ok=15, verify-production
ok=27 changed=0, `site.yml --check` changed=0; GNAI-006 v3.0).
Verbleibend: Proxy-Host `mon.ghostnet.selfhost.eu` → `10.0.0.90:8080`
in NPM anlegen (NPM-Proxyhosts sind Runtime-Daten und werden nicht
per Ansible verwaltet), WebSocket Support und Block Common Exploits
aktiv, SSL/Redirect wie die bestehenden Hosts (Vaultwarden-Muster).
Danach: Bind des Dashboards auf die LAN-IP + nftables „8080 nur von
10.0.0.10" + `Auth__Enabled=true` + E2E-Abnahme (echter Login,
Rollen-403-Negativtest, Blazor-Circuit über WebSocket hinter Proxy).
- **Abnahme M6 (09.11.2026, alle bestanden):** Alle drei Betreiber-Schritte
wurden durchgeführt und agent-seitig verifiziert:
1. **Keycloak (Realm `Ghost.net`, Betreiber-GUI):** Client **`gnai-dashboard`**
(confidential, Standard Flow, Redirects
`https://mon.ghostnet.selfhost.eu/signin-oidc` +
`/signout-callback-oidc`, Web Origin `https://mon.ghostnet.selfhost.eu`),
Realm-Rollen **`gnai-dashboard-user`** / **`gnai-dashboard-admin`**
(Scope `roles`, Mapper `realm roles` mit Add-to-ID-token/access-token/
userinfo ON — im restaurierten Realm waren die Flags unset, das ID-Token
enthielt dadurch kein `realm_access`), zugewiesen an User `ghost`.
Secret liegt ausschließlich in `/etc/gnmon/dashboard-secrets.env`
(gn-dashboard:gn-dashboard 0640; Keys `Auth__Enabled`,
`Auth__ClientSecret`, `Auth__AllowedRoles=gnai-dashboard-user,gnai-dashboard-admin`)
— nie im Repo/Chat. Keine Änderungen an Authentication-Flows (MFA am
Vaultwarden-Login unberührt).
2. **CT-100:** Adoption per `pct exec` (ansible-deploy 1002 +
`AllowUsers` + sudoers) am 09.11.2026; danach `verify-deploy-access`
ok=5, `site.yml` ok=61 changed=11 dann `changed=0`, `verify-production`
ok=32 changed=0. Split-DNS `mon.ghostnet.selfhost.eu → 10.0.0.10` live
(`dig @10.0.0.14` verifiziert; öffentlich bleibt Wildcard → WAN).
**Befund:** die Inventare hatten `dns_pihole_hosts_records` gespiegelt —
der neue Record musste in allen drei Inventaren ergänzt werden;
außerdem darf die Quadlet-Template nur EINE `FTLCONF_dns_hosts`-Zeile
emittieren (systemd: letzter Key gewinnt — sonst fällt auth-admin auf
Upstream zurück). Beides gefixt.
3. **CT-103:** Proxy-Host ID 14 `mon.ghostnet.selfhost.eu → 10.0.0.90:8080`
(WebSocket Support, Block Common Exploits, LE-Cert `npm-20`, Force SSL,
HTTP/2, HSTS) + Advanced-Block
`proxy_set_header X-Forwarded-Proto $scheme; X-Forwarded-Host $host;`
(NPM 2.15.1 setzt sonst nur das leere `$x_forwarded_proto`) sowie
`proxy_buffer_size 32k; proxy_buffers 8 32k; proxy_busy_buffers_size 64k;`
(großer Auth-Cookie nach Login → sonst 502 „upstream sent too big
header“).
4. **KI-Server:** Rolle `gnmon_firewall` (nftables, Policy ACCEPT, nur
8080 von 10.0.0.10 + Monitoring-Ports non-loopback-drop; `changed=0`
idempotent), Dashboard-Bind auf `10.0.0.90:8080` (Assertion erlaubt LAN-Bind
nur mit aktivem Firewall-Tag), Image **v0.3.2** deployt.
**App-Befunde (v0.2.x → v0.3.2):** ClientId an `gnai-dashboard` angepasst;
`Auth:AllowedRoles` konfigurierbar; `KnownNetworks/KnownProxies` per
`.Clear()` geleert (leere `{ }`-Initialisierung behält den Loopback-
Default — sonst ignoriert .NET die NPM-Forwarded-Header und die
redirect_uri wäre intern → PAR 400); `GetClaimsFromUserInfoEndpoint=true`
(realm-roles-Mapper-Flags); `SaveTokens=true` (Logout braucht
id_token_hint); Cookie-`AccessDeniedPath=/access-denied` + Seite
(sonst Redirect-Loop auf /Account/AccessDenied); csproj
`PrunePackageData=false` + Containerfile ohne `--no-restore` (sonst
fehlt `wwwroot/_framework/blazor.web.js` im Image → Blazor-Circuit
startet nicht, 404).
**E2E-Verifikation 09.11.2026:** unauth `GET /` via NPM → 302 zu
`auth.../realms/Ghost.net/.../auth?client_id=gnai-dashboard&request_uri=...`
(PAR 201); Direktzugriff `https://10.0.0.90:8080` von der Workstation →
gedroppt (nftables, curl 000); `blazor.web.js` via NPM → 200
`text/javascript`; Browser-Login als `ghost` → Dashboard 200 mit Live-Daten,
Unterseiten + WebSocket-Circuit hinter NPM ok; Login als `testuser` ohne
Rollen → saubere 403-Seite `/access-denied`; `/logout` → Keycloak-Logout
ohne id_token_hint-Fehler; Gesamtsuite `monitor.yml` ok=84 changed=0.
Journal-Evidenz: `[gnmon-auth] realm_roles=gnai-dashboard-user,...,gnai-dashboard-admin`.
## Noch offen (Rest)
1. GNMON-001 v2.0 Abschnitt 9, Restpunkte: Metrics-Account-Identität,
UID/GID `gn-monitor` und Chart-Bibliothek sind entschieden/umgesetzt;
NPM-Hostname ist entschieden (`mon.ghostnet.selfhost.eu`), der
Keycloak-Client folgt mit den M6-Betreiber-Schritten (oben). Offen
bleiben LLM-Metriken jenseits `gn_ai_active_env` (z. B. Tokens/
UID/GID `gn-monitor` (986), Chart-Bibliothek (Braille), NPM-Hostname
(`mon.ghostnet.selfhost.eu`) und Keycloak-Client (`gnai-dashboard` +
Rollen) sind entschieden/umgesetzt (M6, oben). Offen bleiben
LLM-Metriken jenseits `gn_ai_active_env` (z. B. Tokens/
Latenzen der Inference-Engine) und die Retention-Feinjustierung.
2. keep-id-Ursachenanalyse (crun/Overlay-Rechte der gn-dashboard-Storage)
bei Bedarf; Entscheidung zum Default-Mapping steht in Abschnitt M5.
@@ -3,7 +3,7 @@
**Dokumenten-ID:** GNMON-001-PLAN
**Titel:** Host-Monitoring auf dem KI-Server: Systemmetriken, Log-Pipeline und Blazor-Dashboard
**Stand:** 2026-11-09
**Status:** Revidierter Plan (v2.0) nach Betreiberentscheidungen vom 03.11.2026; M1–M5 produktiv umgesetzt (belegter Stand in GNMON-000), M6 externe Freigabe in Vorbereitung
**Status:** Revidierter Plan (v2.0) nach Betreiberentscheidungen vom 03.11.2026; M1–M6 produktiv umgesetzt inkl. OIDC-Freigabe (belegter Stand in GNMON-000)
**Referenzen:** [GNENC-001](https://git.ghostnet.selfhost.eu/ghostnet.ai/infrastructure/raw/branch/main/docs/platform/llm-server/encoding/GNENC-001-PLAN_Architecture.md), [GNENC-002](https://git.ghostnet.selfhost.eu/ghostnet.ai/infrastructure/raw/branch/main/docs/platform/llm-server/encoding/GNENC-002-PLAN_Pipeline.md), [GNAI-005](https://git.ghostnet.selfhost.eu/ghostnet.ai/infrastructure/raw/branch/main/docs/platform/GNAI-005-SEC_Access-Control.md), [GNAI-006](https://git.ghostnet.selfhost.eu/ghostnet.ai/infrastructure/raw/branch/main/docs/platform/proxmox-server/lxc/ct-103-reverse-proxy/GNAI-006-SEC_Reverse-Proxy.md)
## Änderungsverlauf
@@ -13,6 +13,7 @@
| 19.10.2026 | 1.0 | Betreiber | Planungsabschluss: Metrics-Collector (system.json) + Flask-Dashboard |
| 03.11.2026 | 2.0 | Betreiber / Mistral Vibe | Revision: Dashboard auf ASP.NET Core Blazor Server; Metriken über VictoriaMetrics + Exporter statt system.json-Schnappschuss; neue Log-Pipeline (Alloy + Loki) für journald-, Container- und Encoding-Logs |
| 09.11.2026 | 2.1 | Mistral Vibe | Umsetzungsabweichungen gegenüber v2.0 nachgeführt (belegter Stand in GNMON-000): `gn-monitor` hat UID/GID **986** (die geplante 983 war an `gn-download` vergeben), Charts als eigene Braille-Komponente statt ApexCharts, NPM-Hostname `mon.ghostnet.selfhost.eu` entschieden; M1–M5 sind produktiv auf dem KI-Server (System-Scope) und der Workstation (User-Scope) ausgerollt |
| 09.11.2026 | 2.2 | Mistral Vibe | M6 umgesetzt (Abschnitt 7 wird damit Realität): nftables-Rolle `gnmon_firewall` (8080 nur von NPM 10.0.0.10), Dashboard-Bind auf `10.0.0.90:8080`, OIDC gegen Keycloak-Client `gnai-dashboard` (Realm Ghost.net, Rollen `gnai-dashboard-user`/`gnai-dashboard-admin`); NPM-Proxyhost mit X-Forwarded-Proto/Host + vergrößerten Puffern. Details und Befunde in GNMON-000 M6 |
## Änderungen gegenüber v1.0