Auditoria no SDK do MIP

O portal do Microsoft Purview fornece acesso a relatórios de auditoria através do Activity Explorer. Estes relatórios fornecem visibilidade sobre as etiquetas que os utilizadores aplicam, manual ou automaticamente, em qualquer aplicação que integre o SDK MIP. Os parceiros de desenvolvimento que utilizam o SDK podem ativar esta funcionalidade, permitindo que a informação das suas aplicações apareça nos relatórios dos clientes.

Tipos de eventos

O SDK pode enviar três tipos de eventos de auditoria: eventos de pulsação, eventos de descoberta e eventos de alteração.

Eventos de pulsação

O SDK gera automaticamente eventos de batimento cardíaco para qualquer aplicação que integre o SDK de Políticas. Os eventos relacionados ao ritmo cardíaco incluem:

  • Id de Inquilino
  • Hora gerada
  • Nome principal do usuário
  • Nome da máquina que gerou a auditoria
  • Nome do processo
  • Plataforma
  • ID da aplicação - corresponde ao ID da aplicação Microsoft Entra

Estes eventos são úteis para detetar aplicações em toda a sua empresa que utilizam o Microsoft Information Protection SDK.

Eventos de descoberta

Os eventos de descoberta fornecem informação sobre conteúdos rotulados que o SDK da Política lê ou consome. Estes eventos são úteis porque revelam os dispositivos, a localização e os utilizadores que acedem à informação em toda a organização.

Para gerar eventos de descoberta no Policy SDK, defina uma flag ao criar o mip::PolicyHandler objeto. No exemplo seguinte, o valor para isAuditDiscoveryEnabled é definido como true. Quando passa mip::ExecutionState para ComputeActions() ou GetSensitivityLabel() (com informação de metadados existente e identificador de conteúdo), o SDK submete a informação de descoberta para o Microsoft Purview Activity Explorer.

O SDK gera a auditoria de descoberta após a aplicação chamar ComputeActions() ou GetSensitivityLabel() e fornecer mip::ExecutionState. O SDK gera este evento apenas uma vez por handler.

Analise a documentação de conceitos para obter mais detalhes sobre o mip::ExecutionState estado de execução.

// Create PolicyHandler, passing in true for isAuditDiscoveryEnabled
auto handler = mEngine->CreatePolicyHandler(true);

// Returns vector of mip::Action and generates discovery event.
auto actions = handler->ComputeActions(*state);

//Or, get the label for a given state
auto label = handler->GetSensitivityLabel(*state);

Na prática, defina isAuditDiscoveryEnabled como true durante a construção de mip::PolicyHandler para permitir que as informações de acesso ao ficheiro sejam encaminhadas para o Explorador de Atividades.

Alterar evento

Os eventos de alteração fornecem informações sobre o arquivo, o rótulo que foi aplicado ou alterado e quaisquer justificativas fornecidas pelo usuário. Para gerar eventos de alteração, chame NotifyCommittedActions() em mip::PolicyHandler. Faça a chamada depois de a aplicação confirmar com sucesso uma alteração num ficheiro, passando o mip::ExecutionState que calculou as ações.

Note

Se o aplicativo não conseguir chamar essa função, nenhum evento de auditoria será enviado.

handler->NotifyCommittedActions(*state);

Painel de auditoria

Os eventos de auditoria enviados pelo SDK estão disponíveis no Microsoft Purview Activity Explorer.

Passos seguintes

  • Última atualização a