Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,372 @@
|
||||
# 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`
|
||||
Reference in new issue
Block a user