Auditoría en el SDK de MIP

El Microsoft Purview portal proporciona acceso a los informes de auditoría a través del Explorador de actividades. Estos informes proporcionan visibilidad sobre las etiquetas que los usuarios aplican, manual o automáticamente, en todas las aplicaciones que integran el SDK de MIP. Los asociados de desarrollo que usan el SDK pueden habilitar esta funcionalidad, lo que permite que la información de sus aplicaciones se muestre en los informes de clientes.

Tipos de evento

El SDK puede enviar tres tipos de eventos de auditoría: eventos de latido, eventos de detección y eventos de cambio.

Eventos de latido

El SDK genera automáticamente eventos de latido para cualquier aplicación que integre el SDK de directivas. Los eventos de latido incluyen:

  • Id del inquilino
  • Hora de generación
  • Nombre principal de usuario
  • Nombre de la máquina que generó la auditoría
  • Nombre del proceso
  • Plataforma
  • Id. de aplicación: corresponde al identificador de aplicación de Microsoft Entra

Estos eventos son útiles para detectar aplicaciones en toda la empresa que usan el SDK de Microsoft Information Protection.

Eventos de detección

Los eventos de detección proporcionan información sobre el contenido etiquetado que el SDK de directivas lee o consume. Estos eventos son útiles a medida que exponen los dispositivos, la ubicación y los usuarios que acceden a la información en toda una organización.

Para generar eventos de detección en el Policy SDK, establezca un indicador al crear el objeto mip::PolicyHandler. En el ejemplo siguiente, el valor de isAuditDiscoveryEnabled se establece en true. Al pasar mip::ExecutionState a ComputeActions() o GetSensitivityLabel() (con información de metadatos y identificador de contenido existentes), el SDK envía información de detección a Microsoft Purview Explorador de actividades.

El SDK genera la auditoría de detección después de que la aplicación llame a ComputeActions() o GetSensitivityLabel() y proporcione mip::ExecutionState. El SDK genera este evento solo una vez por controlador.

Revise la mip::ExecutionState documentación de conceptos para obtener más detalles sobre el estado de ejecución.

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

En la práctica, establezca isAuditDiscoveryEnabled en true durante la construcción de mip::PolicyHandler para permitir que la información de acceso a archivos se envíe al Explorador de actividades.

Cambiar evento

Los eventos de cambio proporcionan información sobre el archivo, la etiqueta que se aplicó o cambió y las justificaciones proporcionadas por el usuario. Para generar eventos de cambio, llame a NotifyCommittedActions() en mip::PolicyHandler. Realice la llamada después de que la aplicación haya confirmado correctamente un cambio en un archivo, pasando el mip::ExecutionState que calculó las acciones.

Note

Si la aplicación no puede llamar a esta función, no se envían eventos de auditoría.

handler->NotifyCommittedActions(*state);

Panel de auditoría

Los eventos de auditoría enviados por el SDK están disponibles en Microsoft Purview Explorador de actividades.

Pasos siguientes

  • Se actualizó por última vez el