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

# Auditabilidade

> Entenda os mecanismos de auditoria com escopo definido no Midaz: eventos de proteção do CRM e mensagens opcionais de auditoria de transação do Ledger.

O Midaz não fornece uma trilha de auditoria universal única para toda ação da plataforma. O comportamento de auditoria dele é específico do mecanismo que produz os dados.

## Eventos de auditoria de proteção do CRM

***

Quando o CRM roda com criptografia por envelope, o Midaz emite **Eventos de Auditoria de Proteção** para a atividade de proteção por criptografia. O Midaz armazena esses eventos por Organização. Você pode lê-los pelo endpoint [Listar eventos de auditoria de proteção](https://docs.lerian.studio/pt/reference/products/midaz/v2/get-audit-events.md).

Esse mecanismo não está disponível no modo de criptografia legado. O gravador de auditoria opera em regime de melhor esforço: uma emissão de auditoria com falha é registrada em log, mas não bloqueia a operação do CRM.

Use os eventos de auditoria de proteção para investigar a atividade de proteção por criptografia de uma Organização. Não os interprete como um registro completo de toda ação do Ledger ou da plataforma.

## Mensagens de auditoria de transação do Ledger

***

O Ledger publica mensagens de auditoria de transação apenas quando `AUDIT_LOG_ENABLED` é `true`. Defina a flag como `true` apenas depois de configurar o seu consumidor downstream, a retenção dele e os fluxos de investigação dele.

O Ledger envia essas mensagens para o exchange do RabbitMQ definido em `RABBITMQ_AUDIT_EXCHANGE`, com a chave de roteamento definida em `RABBITMQ_AUDIT_KEY`. A publicação opera em regime de melhor esforço: o Midaz registra em log uma publicação com falha e não bloqueia a transação. O Midaz não as expõe como uma API geral de registros de auditoria do Ledger consultável. O sistema receptor é responsável pela retenção, pela indexação e pelos fluxos de investigação.

## Projetando a sua trilha de auditoria

***

Escolha o mecanismo que corresponde aos dados que você precisa observar:

* Use **Eventos de Auditoria de Proteção** para a atividade de criptografia por envelope do CRM.
* Habilite as **mensagens de auditoria de transação do Ledger** apenas depois de configurar o seu consumidor downstream para retê-las e processá-las.
* Mantenha os controles, a retenção e os requisitos de evidência no sistema responsável pelos dados depois que o Midaz os emite.

> [!NOTE]
>
> Para ajuda no design de uma arquitetura de auditoria e retenção em torno do Midaz, [entre em contato conosco](https://lerian.studio/contact).


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