Visão geral da auditoria do Dataverse para desenvolvedores

O Microsoft Dataverse fornece recursos para atender às políticas externas e internas de auditoria, conformidade, segurança e governança que são comuns a muitas empresas. O Dataverse registra o acesso do usuário e as alterações feitas nos registros. Você pode usar as tabelas de auditoria e AS APIs para criar aplicativos cliente ou interagir programaticamente com dados de auditoria.

Note

Para obter uma descrição completa de conceitos e funcionalidades de auditoria, como a auditoria é exposta em aplicativos e tarefas para administradores, consulte o Guia do Administrador: Gerenciar a auditoria do Dataverse. As tabelas e APIs descritas neste artigo dão suporte a aplicativos cliente usados pelos administradores e podem ser usadas por desenvolvedores para projetos de integração. Este artigo não descreve todos os conceitos e recursos de auditoria.

Use tabelas e APIs do Dataverse para:

• Recupere e altere as configurações da organização para auditoria.
• Detecte quais tabelas e colunas estão habilitadas para auditoria.
• Habilite ou desabilite tabelas e colunas para auditoria.
• Recuperar um histórico de alterações de dados auditadas.
• Excluir dados de auditoria.

Configurações da organização para auditoria

As propriedades da tabela Organização controlam como a auditoria é habilitada para um ambiente. Recupere valores de coluna para determinar:

Coluna	Description
IsAuditEnabled	Se a auditoria está habilitada para o ambiente.
AuditRetentionPeriodV2	O número de dias para manter registros de log de auditoria.
IsUserAccessAuditEnabled	Se o registro de acesso do usuário está habilitado.
UserAccessAuditingInterval	Com que frequência o acesso do usuário é registrado.

Se você tiver a função Administrador do Sistema ou Personalizador de Sistema, poderá definir as configurações da organização para alterar o comportamento de auditoria.

Mais informações:Definir configurações da organização

Configurações de auditoria de tabela e coluna

Cada uma das tabelas e colunas tem uma IsAuditEnabled propriedade gerenciada Booleana que controla se a auditoria está habilitada para a respectiva tabela ou coluna. A auditoria também deve ser habilitada para que a organização registre alterações.

Use as APIs do Dataverse para consultar definições de tabela e coluna e verificar essa propriedade para determinar quais tabelas e colunas estão habilitadas para auditoria.

Se você tiver a função Administrador do Sistema ou Personalizador de Sistema, poderá configurar tabelas e colunas para alterar o comportamento de auditoria.

Mais informações: Configurar tabelas e colunas

Recuperar histórico de auditoria

O sistema armazena dados de histórico de auditoria na tabela Auditoria (Auditoria). Use as seguintes mensagens para recuperar dados de histórico de auditoria:

Mensagem	Description
RetrieveAuditDetails	Recupere os detalhes completos de um registro de auditoria.
RetrieveAttributeChangeHistory	Recupere o histórico de alterações de uma única coluna de um registro auditado.
RetrieveRecordChangeHistory	Recupere o histórico de alterações para todas as colunas de um registro auditado.

Mais informações: recuperar o histórico de alterações de dados auditadas:

Excluir dados de auditoria

Para atender à solicitação de um cliente para excluir seu histórico ou liberar espaço de capacidade de log, talvez seja necessário excluir dados de auditoria. Você não pode excluir registros diretamente na tabela Auditoria (Auditoria). Em vez disso, o Dataverse fornece as seguintes mensagens para excluir dados de histórico de auditoria:

Mensagem	Description
DeleteRecordChangeHistory	Exclui todo o histórico de alterações de um registro específico.
BulkDelete	Exclui de forma assíncrona os registros identificados por uma consulta. Use esta mensagem para excluir um grande número de registros de auditoria sem bloquear outras atividades.
DeleteAuditData	Para clientes que usam chaves de criptografia gerenciadas pelo cliente, essa mensagem exclui todos os registros de dados de auditoria até uma data de término especificada.

Mais informações: Excluir dados de auditoria

Consulte também

Gerir a auditoria do Dataverse
Configurar a auditoria
Recuperar o histórico de alterações de dados auditados
Excluir dados de auditoria