Files
nexarch/docs/BETRIEB-PORTAL.md
patrickandClaude Sonnet 5.5 638150450d
RBAC-Rollenhierarchie-Pflichtgate / rbac-policy-invariant (pull_request) Canceled after 0s
Core-Pflichttest-Gate / pflichttest-gate (pull_request) Canceled after 0s
Supply-Chain-Scan (npm) / npm-audit (pull_request) Canceled after 0s
Supply-Chain-Scan (Go) / govulncheck (pull_request) Canceled after 0s
Core-Schnittstellen-Vertragstests / contract-tests (pull_request) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (pull_request) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (pull_request) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (pull_request) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (pull_request) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (pull_request) Canceled after 0s
CI / Web (dms-browser) (pull_request) Canceled after 0s
CI / Web (pdf-viewer) (pull_request) Canceled after 0s
CI / Web (shl) (pull_request) Canceled after 0s
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (pull_request) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (push) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (push) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (push) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (push) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (push) Canceled after 0s
CI / Web (dms-browser) (push) Canceled after 0s
CI / Web (pdf-viewer) (push) Canceled after 0s
CI / Web (shl) (push) Canceled after 0s
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (push) Canceled after 0s
deploy: Skript zum Einrichten des Portals auf 131
Env-Datei, Unit, nginx-Block 8450, nft-Regel, Audience portal, CORS am Core
und Neubau von Portal und Login in einem idempotenten Lauf mit Sicherungen.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-29 00:00:29 +01:00

4.9 KiB
Raw Permalink Blame History

Betrieb Portal (Stand 2026-10-28)

131 (Vorstufe Produktion)

  • Code: /opt/nexarch-web/portal/web/{portal,shl}, Eigentümer nexarch. Der Benutzer hat kein Home; für npm ci HOME und NPM_CONFIG_CACHE auf /opt/nexarch-web/portal/ setzen.
  • Build mit NEXT_PUBLIC_CORE_API_BASE=https://192.168.1.131:8443, NEXT_PUBLIC_LOGIN_URL=https://192.168.1.131:8443/, NEXT_PUBLIC_TOKEN_MODULE=portal.
  • Unit-Vorlage: deploy/systemd/nexarch-web-portal.service.tmpl (Port 3057). Env-Datei /etc/nexarch/web-portal.env mit PORTAL_POLICY_API_URL, PORTAL_CORE_API_URL, PORTAL_STATUS_API_URL und dem Secret PORTAL_POLICY_SERVICE_TOKEN (legt der Betreiber an).
  • Einrichten in einem Schritt: deploy/131-portal-einrichten.sh (als root auf 131: Env-Datei aus dem Policy-Token, Unit, nginx-Block 8450, nft-Regel, Audience portal, CORS am Core, Neubau von Portal und Login). Das Skript sichert jede geänderte Datei nach /root/portal-einrichten-<Zeit> und nimmt nginx- und nft-Änderungen bei Prüffehlern zurück.
  • CORS: Der Core (8443) liefert auf 131 selbst keine CORS-Header; Frontends auf anderen Ports (8444–8450) brauchen sie für /auth/module-token. Das Skript trägt sie in nginx ein (/etc/nginx/conf.d/nexarch-cors-map.conf, Ursprünge https://192.168.1.131:8444–8450).
  • Voraussetzung für Anmeldung: nexarch-account-api läuft (Passwort der DB-Rolle muss zur DSN in account-api.env passen; bei Authentifizierungsfehler beendet sich der Dienst mit Exit 2 und startet nicht neu).

204 (Dev/Test, Demo nexarch-portal-live)

  • Portal auf Port 3900 (nginx TLS 8443). Build dort mit next build --webpack: Turbopack löst @nexarch/shl über den Symlink nicht auf.
  • NEXT_PUBLIC_* wird beim Build ins Bundle eingebaut. Werte mit 127.0.0.1 funktionieren im Browser nie. connect-api und rbac-admin-api sind deshalb über deploy/nginx/204-portal-live-api-proxy.conf (Ports 8447, 8448) erreichbar; connect, connect-datev und rbac-admin wurden damit neu gebaut.
  • Selbst signiertes Zertifikat: die Ports 8447 und 8448 einmal im Browser bestätigen.
  • Offen: Port 3113 (kennzahlen_dashboard) hat keinen Dienst.
  • archivdms-Daten (Dienste archivdms*, /var/archivdms, /opt/archivdms) nicht anfassen.

Rechtepruefung in ai-app, workflow-app, connect-app (Issue #369)

  • Migration migrations/0029_task_setup_policy_rules.up.sql (Core-DB, vor dem Binary-Rollout) legt workflow.task.read/write und connect.setup.read/write fuer user und tenant_admin an; ai.search.read stammt aus 0018.
  • Je Dienst zwei Variablen in der Env-Datei: NEXARCH_AI_APP_POLICY_URL/NEXARCH_AI_APP_POLICY_SERVICE_TOKEN, NEXARCH_WORKFLOW_APP_POLICY_URL/NEXARCH_WORKFLOW_APP_POLICY_SERVICE_TOKEN, NEXARCH_CONNECT_APP_POLICY_URL/NEXARCH_CONNECT_APP_POLICY_SERVICE_TOKEN (URL der policy-api, z. B. http://127.0.0.1:8093; Token wie NEXARCH_POLICY_SERVICE_TOKEN der policy-api, analog NEXARCH_DMS_APP_POLICY_*).
  • Ohne *_POLICY_URL startet der Dienst nicht (fail-closed). Uebergang: NEXARCH_{AI,WORKFLOW,CONNECT}_APP_POLICY_DISABLED=1 (Warnung im Log, keine Pruefung). Mit URL: Core nicht erreichbar → 503, kein Recht → 403. Rolle: workflow-app und connect-app reichen die Rolle aus dem Token als X-User-Role durch (nur aus dem Token, Client-Header werden entfernt); ohne Rolle gilt user. connect.setup.write hat nur tenant_admin. ai-app wird von Modulen mit Service-Token gerufen und fragt mit Rolle user.
  • taskapi (GET /tasks, PATCH /tasks/{id}/status) ist seit #369 in workflow-app verdrahtet und liegt damit hinter bearerauth.

204: Workflow-Demo und Bearer (Stand 2026-10-28)

  • Backend: workflow-app (Unit nexarch-portal-live-workflow-app, 127.0.0.1:9600) mit eigenem Postgres-Cluster /opt/nexarch-portal-live/pg-workflow (Port 55433, DB workflow_demo, Login-Rolle wf_demo in Gruppe nexarch_app, Verlaufstabelle ohne UPDATE/DELETE). Migrationen: alle workflow/migrations/tenant/*.up.sql in Reihenfolge. Konfiguration in env/workflow.env (Rechte 600, Geheimnisse zufällig): Mandant demo, NEXARCH_WORKFLOW_APP_JWKS_URL=http://127.0.0.1:8199/auth/module-jwks, Zielmodul workflow, kein ALLOW_HEADER_AUTH.
  • Core: NEXARCH_ACCOUNT_MODULE_AUDIENCES=dms,workflow,portal. Bei mehr als einer Audience lehnt der Core Token-Anfragen ohne ?module= ab; alle Frontends mit Sitzung setzen deshalb NEXT_PUBLIC_TOKEN_MODULE (Standard dms).
  • Frontends: Drop-ins bearer.conf für workflow, workflow-cases, routing-rules (NEXT_PUBLIC_CORE_API_BASE, NEXT_PUBLIC_LOGIN_URL, API-URL auf 9600) und portal (NEXT_PUBLIC_TOKEN_MODULE=portal, PORTAL_CORE_API_URL, PORTAL_TOKEN_AUDIENCE=portal, PORTAL_WORKFLOW_API_URL). NEXT_PUBLIC_* gilt beim Build: nach Änderung next build --webpack und Neustart.
  • Reihenfolge für 131: Audiences im Core setzen, workflow-app mit JWKS-URL starten, dann Frontends mit NEXT_PUBLIC_CORE_API_BASE bauen; erst danach NEXARCH_WORKFLOW_APP_ALLOW_HEADER_AUTH entfernen.