373 lines
22 KiB
Markdown
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`
|