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

# Seguridad a nivel de fila (RLS)

> Aislamiento de inquilinos en profundidad en la capa de la base de datos.

Truthlocks utiliza la Seguridad a Nivel de Fila (RLS) de Postgres como medida de defensa en profundidad para hacer cumplir el aislamiento de inquilinos en la capa de la base de datos. Incluso si el código de la aplicación tiene errores, la base de datos misma evita el acceso a datos entre inquilinos.

> [!NOTE]
>
> RLS se aplica además del filtrado de inquilinos a nivel de aplicación. Ambas capas
> trabajan juntos para garantizar el aislamiento de los datos.

## Cómo funciona

### Variable de sesión

Cada solicitud de base de datos establece una variable de sesión con el ID de inquilino verificado:

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

### Definición de políticas

Las políticas de RLS verifican que las filas coincidan con el inquilino de la sesión:

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

### Fuente de identidad del inquilino

El ID de inquilino se deriva **solo** del contexto de autenticación verificado:

* Reclamaciones JWT (después de la verificación de la firma)
* Búsqueda de clave API (después de la validación del hash)
* **Nunca** desde encabezados proporcionados por el cliente como `X-Tenant-ID`

## Tablas cubiertas

RLS está habilitado en todas las tablas con alcance de inquilino:

| Tabla | Columna de inquilino | Política |
| :- | :- | :- |
| `issuers` | `tenant_id` | ✓ Habilitado |
| `issuer_keys` | `tenant_id` | ✓ Habilitado |
| `policies` | `tenant_id` | ✓ Habilitado |
| `tenant_api_keys` | `tenant_id` | ✓ Habilitado |
| `attestations` | `tenant_id` | ✓ Habilitado |
| `risk_signals` | `tenant_id` | ✓ Habilitado |
| `risk_event_sources` | `tenant_id` | ✓ Habilitado |
| `risk_decisions` | `tenant_id` | ✓ Habilitado |
| `fraud_cases` | `tenant_id` | ✓ Habilitado |
| `fraud_events` | `tenant_id` | ✓ Habilitado |

## Comportamiento de fallo cerrado

Si `app.tenant_id` no está configurado en la sesión:

* **SELECT**: Devuelve cero filas (no es un error)
* **INSERTAR**: Falla con violación de política RLS
* **ACTUALIZAR/ELIMINAR**: Afecta a cero filas

## Verificación

Ejecutar el conjunto de pruebas de aislamiento de RLS:

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

## Notas de implementación

### Agrupación de conexiones

Al usar grupos de conexiones, asegúrese de que `SET LOCAL` se use dentro de una transacción.

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