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

# Segurança

> As garantias de segurança que o Matcher dá aos seus dados: identidade de quem chama pelo seu bearer token quando a autenticação está habilitada, isolamento de tenants, registros de auditoria, nome e email dos mapeamentos de ator criptografados e integrações verificadas.

Esta página lista as garantias de segurança que o Matcher dá aos seus dados. Ela não é uma certificação de conformidade.

## Identidade e permissões

***

```bash theme={null}
curl -X GET "https://api.matcher.example.com/v1/contexts" \
  -H "Authorization: Bearer $TOKEN"
```

Para a permissão que cada operação exige, veja a [referência da API do Matcher](https://docs.lerian.studio/pt/reference/products/matcher/matcher-developer-quick-start.md).

## Isolamento de tenants

***

Com autenticação habilitada, o Matcher lê `tenant_id` ou `tenantId` do token. Se as claims de tenant forem opcionais e estiverem ausentes, usa o tenant padrão configurado. Com `AUTH_ENABLED=false`, usa esse tenant padrão sem ler um token.

## Registros de auditoria

***

O Matcher registra as mudanças de configuração e as resoluções de exceções como registros de auditoria do seu tenant. Os registros são append-only e ficam ligados em uma cadeia de hash SHA-256.

Você pode reverificar a cadeia. Uma verificação inspeciona até 10.000 registros, por padrão a partir da menor sequência armazenada, e nunca altera um registro. Para iniciar a verificação em uma sequência posterior, use o parâmetro `fromSeq`. Quando o primeiro registro que a verificação lê não é a sequência 1, a verificação confia no vínculo armazenado desse registro. Ela não verifica os registros anteriores a ele. Para os endpoints de auditoria e de arquivos, veja [Governança](https://docs.lerian.studio/pt/products/matcher/reference/matcher-governance.md).

## Dados pessoais

***

O Matcher criptografa o nome de exibição e o email de um mapeamento de ator antes de armazená-los. Os registros de auditoria mantêm o identificador bruto do ator da requisição original, que pode ser um endereço de email. Para detalhes, veja [Mapeamentos de ator](https://docs.lerian.studio/pt/products/matcher/reference/matcher-governance.md#actor-mappings).

## Credenciais e chamadas de entrada

***

* O Matcher armazena apenas o hash SHA-256 de um token de callback de exceção ou de um token de webhook de agregador. Ele mostra o token bruto uma única vez, quando o cria.
* Um callback de exceção precisa trazer um token de callback válido para o seu tenant.
* O Matcher só aceita um webhook de agregador em uma URL que traga um token válido para o seu tenant, e só depois de verificar a origem por assinatura HMAC ou por endereço IP. Um webhook que não passa na verificação de origem recebe `401`.

## Próximos passos

***

> [card] [Governança](https://docs.lerian.studio/pt/products/matcher/reference/matcher-governance.md)
>
> Gerencie mapeamentos de atores, logs de auditoria e arquivos.


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