> ## 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.

# Sécurité au niveau des lignes (RLS)

> Isolation du locataire en profondeur au niveau de la base de données.

Truthlocks utilise la sécurité au niveau des lignes (RLS) de Postgres comme mesure de défense en profondeur pour faire respecter l'isolation des locataires au niveau de la base de données. Même si le code de l'application contient des bogues, l'accès aux données entre locataires est empêché par la base de données elle-même.

> [!NOTE]
>
> Le RLS est appliqué en plus du filtrage des locataires au niveau de l'application. Les deux couches
> travaillent ensemble pour assurer l'isolation des données.

## Comment ça marche

### Variable de session

Chaque requête de base de données définit une variable de session avec l'ID de locataire vérifié :

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

### Définition de la politique

Les politiques RLS vérifient que les lignes correspondent au locataire de la session :

```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);
```

### Source d'identité du locataire

L'ID du locataire est dérivé **uniquement** du contexte d'authentification vérifié :

* Revendications JWT (après vérification de la signature)
* Recherche de clé API (après validation du hachage)
* **Jamais** à partir d'en-têtes fournis par le client comme `X-Tenant-ID`

## Tables couvertes

RLS est activé sur toutes les tables à portée locataire :

| Tableau | Colonne du locataire | Politique |
| :- | :- | :- |
| `issuers` | `tenant_id` | ✓ Activé |
| `issuer_keys` | `tenant_id` | ✓ Activé |
| `policies` | `tenant_id` | ✓ Activé |
| `tenant_api_keys` | `tenant_id` | ✓ Activé |
| `attestations` | `tenant_id` | ✓ Activé |
| `risk_signals` | `tenant_id` | ✓ Activé |
| `risk_event_sources` | `tenant_id` | ✓ Activé |
| `risk_decisions` | `tenant_id` | ✓ Activé |
| `fraud_cases` | `tenant_id` | ✓ Activé |
| `fraud_events` | `tenant_id` | ✓ Activé |

## Comportement de fermeture en cas d'échec

Si `app.tenant_id` n'est pas défini dans la session :

* **SÉLECTIONNER**: Renvoie zéro ligne (pas une erreur)
* **INSERTION** : Échec avec violation de la politique RLS
* **MISE À JOUR/SUPPRESSION** : Affecte zéro ligne

## Vérification

Exécuter la suite de tests d'isolation RLS :

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

## Notes d'implémentation

### Mise en commun des connexions

Lors de l'utilisation de pools de connexions, assurez-vous que `SET LOCAL` est utilisé dans une transaction.

```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.