> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zeilenbasierte Sicherheit (RLS)

> Defense-in-Depth-Mandantenisolation auf der Datenbankebene.

Truthlocks verwendet Postgres Row-Level Security (RLS) als Defense-in-Depth-Maßnahme, um die Mandantenisolation auf Datenbankebene durchzusetzen. Selbst wenn der Anwendungscode Fehler aufweist, wird der mandantenübergreifende Datenzugriff von der Datenbank selbst verhindert.

> [!NOTE]
>
> RLS wird zusätzlich zur mandantenbezogenen Filterung auf Anwendungsebene erzwungen. Beide Schichten
> zusammenarbeiten, um die Datenisolation zu gewährleisten.

## Funktionsweise

### Sitzungsvariable

Jede Datenbankanfrage setzt eine Sitzungsvariable mit der verifizierten Mandanten-ID:

```sql theme={null}
SET LOCAL app.tenant_id = 'verified-tenant-uuid';
```

### Richtliniendefinition

RLS-Richtlinien prüfen, ob Zeilen dem Sitzungsmandanten entsprechen:

```sql theme={null}
CREATE POLICY tenant_isolation ON issuers
  USING (tenant_id = current_setting('app.tenant_id')::uuid)
  WITH CHECK (tenant_id = current_setting('app.tenant_id')::uuid);
```

### Mandantenidentitätsquelle

Die Mandanten-ID wird **nur** aus dem verifizierten Authentifizierungskontext abgeleitet:

* JWT-Ansprüche (nach Signaturprüfung)
* API-Schlüssel-Lookup (nach Hash-Validierung)
* **Niemals** aus vom Client bereitgestellten Headern wie `X-Tenant-ID`

## Abgedeckte Tabellen

RLS ist für alle mandantenbezogenen Tabellen aktiviert:

| Tabelle | Mandantenspalte | Richtlinie |
| :- | :- | :- |
| `issuers` | `tenant_id` | ✓ Aktiviert |
| `issuer_keys` | `tenant_id` | ✓ Aktiviert |
| `policies` | `tenant_id` | ✓ Aktiviert |
| `tenant_api_keys` | `tenant_id` | ✓ Aktiviert |
| `attestations` | `tenant_id` | ✓ Aktiviert |
| `risk_signals` | `tenant_id` | ✓ Aktiviert |
| `risk_event_sources` | `tenant_id` | ✓ Aktiviert |
| `risk_decisions` | `tenant_id` | ✓ Aktiviert |
| `fraud_cases` | `tenant_id` | ✓ Aktiviert |
| `fraud_events` | `tenant_id` | ✓ Aktiviert |

## Fail-Closed-Verhalten

Wenn `app.tenant_id` in der Sitzung nicht gesetzt ist:

* **SELECT**: Gibt null Zeilen zurück (kein Fehler)
* **INSERT**: Schlägt fehl mit RLS-Richtlinienverletzung
* **UPDATE/DELETE**: Betrifft null Zeilen

## Verifizierung

Führen Sie die RLS-Isolationstestsuite aus:

```bash theme={null}
make rls-check
```

## Implementierungshinweise

### Verbindungspooling

Bei der Verwendung von Verbindungspools stellen Sie sicher, dass `SET LOCAL` innerhalb einer Transaktion verwendet wird.

```go theme={null}
// Go example with pgx
tx, _ := pool.Begin(ctx)
defer tx.Rollback(ctx)

tx.Exec(ctx, "SET LOCAL app.tenant_id = $1", tenantID)
// ... perform queries ...

tx.Commit(ctx)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.