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

# Segurança em Nível de Linha (RLS)

> Isolamento de inquilino em profundidade na camada do banco de dados.

Truthlocks usa a Segurança em Nível de Linha (RLS) do Postgres como uma medida de defesa em profundidade para impor o isolamento do inquilino na camada do banco de dados. Mesmo que o código do aplicativo tenha bugs, o acesso a dados entre inquilinos é impedido pelo próprio banco de dados.

> [!NOTE]
>
> O RLS é aplicado além da filtragem de locatários em nível de aplicativo. Ambas as camadas
> trabalham juntos para garantir o isolamento dos dados.

## Como funciona

### Variável de Sessão

Cada solicitação de banco de dados define uma variável de sessão com o ID do locatário verificado:

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

### Definição de Política

As políticas RLS verificam se as linhas correspondem ao locatário da sessão:

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

### Fonte de Identidade do Tenant

O ID do locatário é derivado **apenas** do contexto de autenticação verificado:

* Reivindicações JWT (após verificação de assinatura)
* Pesquisa de chave de API (após validação de hash)
* **Nunca** de cabeçalhos fornecidos pelo cliente como `X-Tenant-ID`

## Tabelas Cobertas

RLS está habilitado em todas as tabelas com escopo de locatário:

| Tabela | Coluna do Inquilino | Política |
| :- | :- | :- |
| `issuers` | `tenant_id` | ✓ Ativado |
| `issuer_keys` | `tenant_id` | ✓ Ativado |
| `policies` | `tenant_id` | ✓ Ativado |
| `tenant_api_keys` | `tenant_id` | ✓ Ativado |
| `attestations` | `tenant_id` | ✓ Habilitado |
| `risk_signals` | `tenant_id` | ✓ Habilitado |
| `risk_event_sources` | `tenant_id` | ✓ Ativado |
| `risk_decisions` | `tenant_id` | ✓ Habilitado |
| `fraud_cases` | `tenant_id` | ✓ Ativado |
| `fraud_events` | `tenant_id` | ✓ Habilitado |

## Comportamento Fail-Closed

Se `app.tenant_id` não estiver definido na sessão:

* **SELECT**: Retorna zero linhas (não é um erro)
* **INSERT**: Falha com violação da política RLS
* **UPDATE/DELETE**: Afeta zero linhas

## Verificação

Executar o conjunto de testes de isolamento RLS:

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

## Notas de implementação

### Pool de Conexões

Ao usar pools de conexão, certifique-se de que `SET LOCAL` seja usado dentro de uma transação.

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