Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/docs/security/RLS-HARDENING-2026-07-13.md
T

373 lines
22 KiB
Markdown

# RLS-Härtung — Implementierungs- und Operations-Handoff
**Branch-Start:** 13.07.2026
**Nachweisstand:** 14.07.2026
**Scope:** anwendungsweites PostgreSQL-RLS, Rollen, Runtime-Kontext, CI und Deploy-Vertrag
## Status in einem Satz
Der Branch enthält einen vollständigen, generierten RLS-Vertrag mit lokalen
statischen und ephemeren PostgreSQL-Nachweisen. **Staging ist seit dem 14.07.2026
ausgerollt (siehe „Staging-Rollout"); Produktion steht weiterhin aus, dort sind
Bestandsdaten, reale Rollen/Secrets, PgBouncer, Read-Replicas und
Coolify-Ressourcen noch nicht als produktiv grün belegt.**
## Staging-Rollout (14.07.2026, durchgeführt von Akeshan)
**Ergebnis:** 180/180 Migrationen, `20260713190000_appwide_rls_cutover` angewandt,
264 Tabellen mit aktivem RLS. Alle 9 Coolify-Ressourcen healthy auf `hivegrid_app`
bzw. `hivegrid_worker` mit `RLS_RUNTIME_MODE=required`. Bestandsdaten unverändert
(54 User, 3 Tenants). Tenant-A/B-Isolation verifiziert: ohne gebundenen Kontext
sieht `hivegrid_app` **null** Tenants, mit Kontext genau den eigenen und **null**
fremde. Vorher: `pg_dump -Fc` + Restore-Probe in eine Wegwerf-DB (identische
Tabellen-/Zeilenzahlen), Backup auf staging-1 unter `/root/hivegrid-cutover-*`.
**Drei Dinge, die der Rollout-Plan nicht vorhergesehen hat** — für den
Prod-Rollout vorab zu klären:
1. **Der Migrator braucht Netzwerkzugriff auf die Ziel-DB.** Der One-Shot-Container
läuft als `docker run` auf dem **CI-Runner-Host**, nicht auf dem DB-Host. Die
Staging-Postgres veröffentlichte keinen Port und war nur im Coolify-Docker-Netz
auflösbar → der erste Versuch scheiterte mit „PostgreSQL migrator role
verification failed". **Diese Meldung ist der Catch-all für Verbindungsfehler**,
nicht für einen Rollen-Verstoß — ein echter Vertragsbruch meldet konkret. Gelöst
über einen mesh-only Forwarder (`hivegrid-db-mesh`, `10.42.0.3:5432`, kein
`0.0.0.0`); `STAGING_MIGRATOR_DATABASE_URL` zeigt darauf. Für Prod: Erreichbarkeit
des Runners zur Prod-DB **vor** dem Fenster klären (dort existieren Private-IPs
`10.0.0.x`). Siehe `infra/LESSONS.md`.
2. **Die Coolify-Ressource `hivegrid-hocuspocus` fehlte.** Der Deploy verlangt sie
zwingend („must all exist") und bricht sonst fail-closed ab. Angelegt und in
`COOLIFY_STAGING_RESOURCE_UUIDS` ergänzt. **Prod-Allowlist vorab prüfen.**
3. **Der Demo-Login-Schalter hing an `SEED_*`-Variablen.** Da der Deploy-Vertrag
jeden `SEED_*`-Schlüssel auf Runtime-Ressourcen abweist, sperrte der Cutover
sämtliche Staging-Demo-Konten aus („Dieses Nutzerkonto kann in Produktion nicht
verwendet werden"). Der Gate ist ein **Runtime**-Schalter, kein Seed-Schalter,
und heißt jetzt `STAGING_DEMO_LOGIN_ENABLED` (wirkt nur mit
`SENTRY_ENVIRONMENT=staging`). Betrifft Prod nicht, ist aber die generelle Lehre:
**kein Laufzeit-Flag mit `SEED_`-Präfix.**
**Offen für Produktion:** Secret `MIGRATOR_DATABASE_URL` existiert nicht; Rollen sind
dort nicht provisioniert; Runtime-Env noch auf der alten Rolle. Ein `promote` schlägt
bis dahin fehl. Zusätzlich offen: der tenant-bewusste Operator-Seed-Workflow (Seeding
ist auf Runtime-Ressourcen abgeschaltet).
## Was der Branch absichert
### Vollständige und explizite Klassifikation
- `prisma/tenant-scope-manifest.mjs` klassifiziert alle 262 Prisma-Modelle und
zwei implizite Tabellen. Keine Tabelle fällt aufgrund einer Namensheuristik
still in einen Default.
- Der generierte Vertrag umfasst 264/264 RLS-Definitionen. Davon sind 221
Modelle laut Manifest RLS-pflichtig; die übrigen Klassifikationen beschreiben
globale Kataloge, geteilte globale Daten oder den Plattform-Admin-Datenraum.
- Nullable Tenant-Spalten, FK-abgeleitete Ownership, Worker-Poller,
Plattform-Operatoren und globale Lesepfade stehen explizit in
`prisma/tenant-policy-contract.mjs`.
- `scripts/generate-tenant-policy-contract.mjs` erzeugt sowohl
`prisma/rls/tenant-policy-contract-isolation.sql` als auch die
Forward-only-Cutover-Migration. `--check` verhindert Drift zwischen Quelle,
Artefakt und Migration.
### Datenbankrollen und begrenzte Ausnahmen
- `hivegrid_app`: `LOGIN`, `NOSUPERUSER`, `NOINHERIT`, `NOBYPASSRLS`, keine
Mitgliedschaft; verwendet von Web, API, MCP und Hocuspocus.
- `hivegrid_worker`: gleicher eingeschränkter Login-Vertrag, keine
Mitgliedschaft; verwendet von allen Worker-Gruppen.
- `hivegrid_authentik_jit`: eingeschränkter Login ohne Tabellen- oder
Sequenzrechte; nur der verifizierte Authentik-Callback nutzt sein einziges
`EXECUTE`-Recht auf die JIT-Capability.
- `hivegrid_migrator`: `LOGIN`, kein Superuser/BYPASSRLS; einzige
Mitgliedschaft ist die Definer-Rolle mit `SET TRUE`, ohne `ADMIN` oder
`INHERIT`; nur für die kurzlebige Prisma-Migration.
- `hivegrid_rls_definer`: `NOLOGIN`, `BYPASSRLS`, keine allgemeinen
Admin-Rechte; Eigentümer der geprüften Capability-Funktionen.
`scripts/provision-rls-roles.mjs` setzt diese Attribute und Mitgliedschaften
idempotent, erzwingt getrennte SCRAM-Secrets und überträgt Datenbank, Schema und
nicht zu Extensions gehörende Anwendungsobjekte an den Migrator. App, Worker
und Authentik-JIT können die Definer-Rolle weder erben noch per `SET ROLE`
annehmen. Die Migration selbst erstellt oder verändert keine Rolle und stoppt
bei einer fehlenden Vorprovisionierung mit einem klaren Prerequisite-Fehler.
Die Definer-Ausnahme ist keine generelle Runtime-Hintertür. Die Runtime-
Readiness erwartet genau 44 namentlich und per Signatur gelistete
`SECURITY DEFINER`-Funktionen mit fixiertem `search_path`, `row_security=off`
und exakt geprüftem App-/Worker-/Authentik-JIT-`EXECUTE`-Grant. Unerwartete
Funktionen oder direkte `EXECUTE`-Empfänger machen die Readiness rot.
Davon sind 24 reine Bootstrap-Resolver. Die neu geschlossenen öffentlichen
Provider-Pfade lösen ausschließlich IDs auf: Google Calendar bindet Channel-ID
und Channel-Token, Microsoft Subscription-ID und Client-State, Gmail liefert
eine auf 25 Einträge begrenzte Liste exakt normalisierter Mailbox-Identitäten,
Signatur-Links binden den Token-Hash und Legacy-Open-Tracking zusätzlich den
gespeicherten Tracking-Token. Nur `hivegrid_app` darf diese Resolver ausführen;
Vollzeilen werden anschließend im jeweiligen Tenant-/User-Kontext erneut
gelesen.
### Runtime-Kontext und Fail-closed-Start
- `runWithRlsContext()` bindet die authentifizierte Tenant-/User-Identität an
die aktuelle Async-Call-Chain und verbietet einen Identitätswechsel in einem
aktiven Kontext.
- Der Prisma-Proxy setzt `app.tenant_id`, `app.user_id`,
`app.public_knowledge_base_id` und `app.platform_analytics` ausschließlich mit
`set_config(..., true)` innerhalb einer Transaktion. Verschachtelte
Callback-Transaktionen verwenden dieselbe Transaktion; Array-Transaktionen
sind im RLS-Kontext verboten.
- Für öffentliche und pre-tenant Flows gibt es eng begrenzte Resolver- bzw.
Mutationsfunktionen statt einer ungebundenen Runtime-Rolle mit breiten
Tabellenrechten.
- Tenantlose Plattform-Analytics laufen ausschließlich unter dem isolierten
Literal-Kontext `platformAnalytics: true`. Er erbt weder User/Tenant noch
Public-KB oder eine bestehende Transaktion. Die Readiness meldet bereits ein
auf der Pool-Session verbliebenes `app.platform_analytics` als Kontext-Leak.
- Die Analytics-Policy erlaubt in diesem Kontext für vollständig anonyme
`AnalyticsUniqueVisitor` nur SELECT, INSERT und UPDATE, niemals DELETE.
`AnalyticsPageView` und `AnalyticsEvent` erlauben nur SELECT und INSERT,
sofern eigener Portalbezug und User-/Portalbezug des referenzierten Visitors
vollständig NULL sind. Tenant- und portalgebundene Policies bleiben als
getrennte Alternative bestehen.
- `Event` und `OutboxEvent` sind für die App nach dem Insert unveränderlich:
die App erhält nur SELECT/INSERT, der globale Worker behält SELECT/INSERT/
UPDATE/DELETE. Tenantlose Events brauchen einen exakten `app.user_id`;
tenantlose Outbox-Zeilen zusätzlich `workflow.trigger.event`, ein JSON-
Objekt und eine nichtleere, exakt passende `payload.userId`. Anonyme oder
fremde Tenant-/User-Zeilen bleiben gesperrt; Operatoren dürfen Events nur
global lesen, nicht schreiben.
- Die globalen Admin-Leser für API-Aufrufe, Audit-Trails und Audit-Events
erkennen einen Operator ausschließlich über `app.user_id` plus `AdminUser`.
`ApiKeyLog`, `Log` und `AuditEvent` erlauben diesem Operator SELECT über alle
Tenants und tenantlose Plattformzeilen. `ApiKeyLog` bleibt für die App beim
Schreiben strikt tenantgebunden; tenantlose Mutationen sind weiterhin nur
dem Worker erlaubt. API-Schlüssel selbst erhalten keine globale
Operator-Policy: Listen, Lookup und CRUD laufen je Mandant in einem explizit
gebundenen Tenant-Kontext, und ein Schlüssel kann nicht zwischen Tenants
verschoben werden.
- In Produktion ist `RLS_RUNTIME_MODE=required`. Die Start-Readiness prüft
Runtime-Rolle, `NOBYPASSRLS`, Mitgliedschaften, 264 aktivierte und erzwungene
Tabellen, die erwartete Definer-Allowlist sowie leere Session-GUCs. Web,
API, MCP, Hocuspocus und Worker starten bei Vertragsdrift nicht normal weiter.
Ein explizites `off` oder `audit` wird in `NODE_ENV=production` bereits beim
Auflösen des Modus abgelehnt.
- Worker übernehmen keine generische `payload.userId` als DB-Operatoridentität.
Dadurch kann eine Admin-ID in einer Queue-Payload den Worker nicht zum
Plattform-Operator hochstufen.
### Migration, CI und Deploy
- `prisma/migrations/20260713190000_appwide_rls_cutover/migration.sql` ist die
generierte Forward-only-Cutover-Migration. Sie enthält Backfill-Guards,
Grants, Policies, `ENABLE ROW LEVEL SECURITY` und `FORCE ROW LEVEL SECURITY`.
- GitHub- und Gitea-CI prüfen den generierten Policy-Vertrag und führen
`verify:rls-live` gegen eine frische PostgreSQL-16-Instanz aus.
- Das Live-Gate beweist zusätzlich einen erwarteten Migrationsfehler ohne
Definer-Mitgliedschaft, danach die vollständige Migration als
nicht-privilegierter `hivegrid_migrator` sowie echte App-/Worker-
Read-/Write-Isolation.
- Der Deploy-Workflow verwendet das bereits gebaute immutable Web-Image einmal
als `start.sh migrate`. Nur dieser kurzlebige Prozess erhält `DIRECT_URL`.
Lang laufende App-Runtimes erhalten ausschließlich `hivegrid_app`, Worker
ausschließlich `hivegrid_worker`. Nur Web darf zusätzlich die
`hivegrid_authentik_jit`-URL und das vollständige Authentik-Admin-Env-Set
erhalten; API, MCP, Hocuspocus und Worker lehnen diese Keys ab. Migrator- und
Seed-Variablen werden vor Rollout abgelehnt.
## Reproduzierbarer Nachweis
Auf dem oben genannten Branch-Stand wurden folgende Checks lokal ausgeführt:
- `pnpm run verify:tenant-policy-contract`: PASS, 264/264 Definitionen;
Artefakt und Migration aktuell.
- `pnpm run verify:rls-release-readiness`: PASS, 262/262 Modelle
klassifiziert; 221/221 RLS-Modelle mit Artefakt sowie `ENABLE`, `FORCE` und
Policy in Migrationen.
- `pnpm run verify:migrations-parity`: PASS. Die Rollen werden vor dem Replay
extern provisioniert, alle Migrationen laufen als eingeschränkter
`hivegrid_migrator`, und zwischen Migrationsergebnis und Prisma-Schema wurde
kein Unterschied erkannt.
- Fokussierte DB-/Generator-Suite für Resolver, Tracking und Readiness: PASS,
vier Dateien und 62 Tests. Die fokussierten Webhook-, OAuth-Zugriffs-,
Signatur- und Tracking-Routenprüfungen sind mit acht Dateien und 30 Tests
grün.
- Vollständiger Core-Testlauf: PASS, 760 Testdateien und 4.943 Tests; acht
Dateien mit 46 env-abhängigen Integrationsfällen wurden erwartungsgemäß
übersprungen. `pnpm test:foundation` ist mit 114 Dateien und 678 Tests grün;
`pnpm test:packages` ebenfalls vollständig grün.
- `pnpm run verify:test-coverage`: PASS. Die kritischen RLS-nahen Targets
liegen bei API-Auth auf 99,42 % Statements/97,67 % Branches, bei den Web-
Auth-Services auf 97,46 %/90,42 % und beim Tenant-DB-Service auf
99,53 %/98,61 %.
- Typechecks für Web, DB, CLI, API, Worker, MCP und Hocuspocus sowie der
vollständige ESLint-Lauf: PASS.
- `pnpm run verify:rls-live`: PASS, Migration ohne Definer-Mitgliedschaft
erwartungsgemäß blockiert, Migration als `hivegrid_migrator` grün und 38/38
Live-Isolationstests grün. Darin sind direkte Tabellen-SELECT/INSERT- sowie
fremde Definer-EXECUTE-Versuche als `hivegrid_authentik_jit` negativ geprüft.
Die Zahlen 264 und 221 messen unterschiedliche Dinge: 264 ist der vollständige
Definitionensatz inklusive globaler/Plattform-Klassen; 221 ist die Teilmenge,
für die der statische Release-Check Tenant-RLS in den Migrationen fordert.
## Kontrollierter Rollout
1. **Vorbedingungen:** main-synchronen SHA festhalten, aktuelles Backup oder
Restore-Point bestätigen, Restore-Pfad kennen und ein Schreib-/Cutover-
Fenster freigeben. Keine Produktionsdaten in Logs oder Tickets kopieren.
2. **Rollen provisionieren:** mit der dedizierten, nur für diesen Schritt
verfügbaren Superuser-URL `pnpm run db:roles:provision` ausführen. Den
verifizierten Rollen-/Ownership-Bericht sichern, nicht die Secrets. Dabei
auch `HIVEGRID_RLS_AUTHENTIK_JIT_PASSWORD` setzen und anschließend die
daraus gebildete `AUTHENTIK_ADMIN_JIT_DATABASE_URL` ausschließlich am
Web-Runtime-Resource hinterlegen.
3. **Staging migrieren:** das immutable Web-Image einmal mit dem direkten
Migrator-Secret und Argument `migrate` starten. Kein Seed im selben Prozess.
4. **Runtime umschalten:** App-Ressourcen auf `hivegrid_app`, Worker-Gruppen auf
`hivegrid_worker`; jeweils `RLS_RUNTIME_MODE=required` und die passende
`DATABASE_RUNTIME_ROLE` setzen. `DIRECT_URL`, `MIGRATOR_*`, `MIGRATE_ON_BOOT`,
`SEED_ON_BOOT` und `SEED_*` aus allen Runtime-/vererbten Env-Gruppen entfernen.
5. **Staging beweisen:** Start-Readiness für Primary und konfigurierte Replica,
Migration-Status, Tenant-A/B-Read/Write-Isolation, Worker-Verarbeitung sowie
die kritischen public/pre-tenant Flows prüfen.
6. **Produktion promoten:** erst nach grünem Staging-Proof und bestätigtem
Backup die bereits geprüften SHA-Images promoten. Migration vor den
langlebigen Runtimes ausführen; bei jedem Fehler vor Traffic-Freigabe stoppen.
7. **Nachlauf:** Role-/Grant-Drift, Readiness, PgBouncer-Pools und Fehlerquoten
beobachten. Nur redaktierte Status-, SHA- und Diagnosecodes dokumentieren.
Die operativen Details stehen ergänzend in [`../database.md`](../database.md),
[`../db-ci.md`](../db-ci.md), [`../deployment.md`](../deployment.md) und
[`../ops/pgbouncer.md`](../ops/pgbouncer.md).
## Rollback und Recovery
Die Migration ist forward-only. Die auskommentierte Inverse-SQL am Ende der
Migration ist ein Review-/Recovery-Artefakt, kein automatisch sicherer
Produktions-Rollback.
- Bei einem Fehler **vor** Runtime-Umschaltung: Rollout stoppen, keine
langlebige Runtime mit Migrator-Credentials starten und Ursache per
Forward-Fix oder freigegebenem Restore beheben.
- Bei einem Fehler **nach** Runtime-Umschaltung: Schreiber anhalten. Nicht als
Schnellfix `BYPASSRLS`, Superuser-Rechte, Definer-Mitgliedschaft oder breite
Tabellen-Grants an App/Worker vergeben.
- Ein Code-/Image-Rollback darf nur auf einen schema-kompatiblen, bekannten SHA
zeigen. Die bereits angewandte Migration wird nicht umbenannt oder verändert.
- Muss der Datenbank-Cutover zurückgenommen werden, erfolgt das im
Wartungsfenster aus dem bestätigten Backup/Restore-Punkt oder anhand einer
separat reviewten Inverse-/Forward-Migration. Vor Traffic-Freigabe müssen
Rollen, Ownership, Policies und Tenant-A/B-Isolation erneut grün sein.
- Ein reiner PgBouncer-Rollback darf direkt auf Postgres zeigen, muss aber die
getrennten `hivegrid_app`-/`hivegrid_worker`-Credentials, die web-exklusive
`hivegrid_authentik_jit`-Capability und den vollständigen RLS-Vertrag
beibehalten.
## Rest-Risiken und offene Operations-Proofs
1. **Produktion ist nicht verifiziert.** Repository- und Ephemeral-DB-Proof
sagen nichts über tatsächliche Produktionsrollen, Grants, Bestandsdaten,
Pooler-/Replica-Drift oder Coolify-Vererbung aus.
2. **Legacy-Daten können Guards auslösen.** Die Cutover-Migration bricht bei
nicht eindeutig zuordenbaren Ownership-Zeilen absichtlich ab. Diese Daten
müssen vor dem Produktionslauf redaktiert analysiert und fachlich bereinigt
werden; sie dürfen nicht pauschal einem Tenant zugeordnet werden.
3. **Capability-Funktionen sind hochsensibel.** Jede neue öffentliche,
pre-tenant, Worker- oder Operator-Ausnahme benötigt einen expliziten
Contract-Eintrag, minimale Grants, Generator-/Readiness-Nachzug und einen
negativen Isolationstest.
4. **Global- und Cross-tenant-Pfade bleiben Sonderfälle.** Worker-Poller,
Plattform-Inboxen, globale Knowledge-Base-/Workflow-Daten und nullable
Ownership sind explizit modelliert, müssen bei jeder Fachänderung aber
erneut auf Datenminimierung geprüft werden.
5. **Fresh-DB ist nicht Bestands-DB.** Das Live-Gate beweist Migration und
Isolation auf einer leeren PostgreSQL-16-Datenbank mit Fixtures. Ein
produktionsnaher Restore-/Cutover-Drill bleibt notwendig.
6. **Seed bleibt getrennt.** Die bestehende Seed-Infrastruktur ist keine
freigegebene RLS-Produktionsautorität und darf nicht in den Migrator oder die
Runtime zurückverdrahtet werden.
## Incident 2026-07-14: Passwort-Login auf Staging
### Befund und Ursache
Der auf `842b82690080555ec024d1a61c570730075a76d1` laufende Web-Prozess
enthielt zwei getrennt ausgewertete Kopien von `@hivegrid/db`: eine im äußeren
Node-Server-Bundle und eine im React-Router-Server-Bundle. Beide Kopien teilten
den über `global.__db` gecachten Prisma-Client, besaßen aber jeweils einen eigenen
`AsyncLocalStorage` für den RLS-Kontext.
Der äußere Server rief `assertRlsRuntimeReady()` vor dem Import des
React-Router-Builds auf und initialisierte dadurch den globalen Prisma-Proxy. Der
Pre-Auth-Pfad band die aufgelöste User-ID anschließend im RLS-Kontext der inneren
Bundle-Kopie. Der bereits erzeugte Proxy las jedoch den Kontext der äußeren Kopie,
sah deshalb keine Identität und führte den User-Lookup unscoped aus. `FORCE ROW
LEVEL SECURITY` blendete die User-Zeile korrekt aus. `getUserByEmail()` lieferte
somit `null`; der Auth-Service prüfte absichtlich nur den Dummy-Hash und antwortete
mit `api.errors.invalidPassword`.
Das erklärt auch den scheinbaren Widerspruch: Der `SECURITY DEFINER`-Resolver fand
die Identität, weil er keine Session-GUC benötigt, während der anschließende
Tabellenzugriff ohne den tatsächlich vom Proxy gelesenen RLS-Kontext keine Zeile
sah. Ein redaktierter Doppel-Bundle-Probe im laufenden Prozess belegte genau diese
Kette: globaler Client wiederverwendet, Resolver erfolgreich, App-Lookup ohne
erneutes Wrapping unsichtbar, derselbe Lookup nach Wrapping mit dem zweiten Kontext
sichtbar. Es wurden dabei weder E-Mail, Passwort noch Hash ausgegeben.
PR #113 war nur die zeitliche Deploy-Korrelation. Auch das unmittelbare
Vorgänger-Image `576f543318d00cb315529b550bcc47e808f8f944` und das erste
Post-RLS-Image `01a7b4f991c0d5860177182c4eb7c66ffc671d80` enthalten
die doppelte Kontextstruktur. Die letzten erfolgreichen Sessions lagen vor PR
#110; der Defekt kam mit Commit `66e76722fddce33e3e076813b99083b4e531cd74`
in den RLS-Runtime-Pfad. Die Pre-RLS-Images
`39fe47f3a342e5825a472a75dcbee887668f5123` und
`7ae0172e31799bba95fba4a0f39677f03ee8eff0` enthielten nur die App-seitige
Initialisierung und waren strukturell nicht betroffen. Argon2 0.44.0, seine
nativen Binaries, Node 24 ABI 137 und der Prozess-Start ohne Sonderflags waren in
den verglichenen Images gleich und sind als Ursache ausgeschlossen.
### Korrektur und Regression
- Der RLS-`AsyncLocalStorage` liegt pro Node-Prozess auf `globalThis`. Getrennt
ausgewertete Bundle-Kopien und der globale Prisma-Proxy greifen dadurch auf
denselben Request-Kontext zu; die Transaktions-GUCs bleiben fail-closed.
- Zwei Unit-Regressionen prüfen die getrennte Modulauswertung und insbesondere
den kritischen Fall „Proxy aus Bundle A, Identität aus Bundle B“.
- Der Docker-Web-Runtime-Smoke erzeugt einen isolierten Login-Fixture, startet
das exakte Produktions-Image als `hivegrid_app` mit
`RLS_RUNTIME_MODE=required`, führt GET/POST mit CSRF und vollständigem
Cookie-Transport aus und verlangt Redirect, Session-Cookie sowie exakt eine
aktive `UserSession`. Das Vorher-Image scheitert damit reproduzierbar mit HTTP
400; das korrigierte Image besteht den Lauf.
- Die generische Diagnose protokolliert nur Operationscode, Fehlerklasse und
optionale technische Fehlerkennung. Passwort, Hash und E-Mail werden weder bei
der Verifikation noch beim RLS-Anomaliehinweis geloggt.
### Zustand der Demo-Zugangsdaten
Die 50 User von `demo-pro-crm` bleiben bewusst auf das kanonische gemeinsame
Staging-Demo-Passwort aus dem Secret-Store rotiert, wie in
[`../deploy/DEMO-PRO-SEED.md`](../deploy/DEMO-PRO-SEED.md) vorgesehen. Die
redaktierte Bestandsprüfung ergab 50 User, 50 Argon2id-Hashes und 0 Null-Hashes.
Das Backup der 50 vorherigen Hashes liegt ausschließlich auf `staging-1` unter
`/root/demo-pro-pw-backup-20260714.tsv`, hat Modus `0600` und 50 Zeilen. Es wird
nicht in das Repository kopiert. `SEED_*` bleibt entsprechend dem Runtime-Vertrag
aus dem Web-Container entfernt; der Staging-Login-Schalter ist davon getrennt.
## Review-Einstiegspunkte
- Klassifikation: `prisma/tenant-scope-manifest.mjs`
- Fachlicher Vertrag: `prisma/tenant-policy-contract.mjs`
- Generator: `scripts/generate-tenant-policy-contract.mjs`
- Cutover: `prisma/migrations/20260713190000_appwide_rls_cutover/migration.sql`
- Rollen: `scripts/provision-rls-roles.mjs`
- Kontext/Proxy: `packages/db/src/rls-context.server.ts`,
`packages/db/src/rls-client.server.ts`
- Runtime-Readiness: `packages/db/src/rls-runtime-readiness.server.ts`
- Live-Gate: `scripts/verify-rls-live.sh`,
`packages/db/src/rls-live.integration.test.ts`
- Deploy-Grenze: `start.sh`, `.gitea/workflows/deploy.yml`,
`scripts/coolify-deploy.mjs`