Überwachung im MIP SDK

Die Microsoft Purview-Portal ermöglicht den Zugriff auf Überwachungsberichte über den Aktivitäts-Explorer. Diese Berichte bieten Einblicke in die Bezeichnungen, die Benutzer auf anwendungen anwenden, die das MIP SDK integrieren, manuell oder automatisch. Entwicklungspartner, die das SDK verwenden, können diese Funktionalität aktivieren, wodurch Informationen aus ihren Anwendungen in Kundenberichten angezeigt werden können.

Ereignistypen

Das SDK kann drei Arten von Überwachungsereignissen senden: Taktereignisse, Ermittlungsereignisse und Änderungsereignisse.

Heartbeat-Ereignisse

Das SDK generiert automatisch Taktereignisse für jede Anwendung, die das Richtlinien-SDK integriert. Heartbeat-Ereignisse umfassen:

  • Mieter-ID
  • Generierungszeit
  • Benutzerprinzipalname
  • Name des Rechners, der die Prüfung erstellt hat
  • Prozessname
  • Plattform
  • Anwendungs-ID – entspricht der Microsoft Entra Anwendungs-ID

Diese Ereignisse sind hilfreich beim Erkennen von Anwendungen in Ihrem Unternehmen, die das Microsoft Information Protection SDK verwenden.

Ermittlungsereignisse

Erkennungsereignisse liefern Informationen über gekennzeichnete Inhalte, die das Richtlinien-SDK liest oder verarbeitet. Diese Ereignisse sind nützlich, da sie die Geräte, Standorte und Benutzer sichtbar machen, die in einer gesamten Organisation auf Informationen zugreifen.

Um Ermittlungsereignisse im Richtlinien-SDK zu generieren, legen Sie beim Erstellen des mip::PolicyHandler Objekts ein Flag fest. Im folgenden Beispiel ist der Wert für isAuditDiscoveryEnabled auf true festgelegt. Wenn Sie ComputeActions() mit vorhandenen Metadaten und Inhaltsbezeichner an GetSensitivityLabel() oder mip::ExecutionState übergeben, sendet das SDK Ermittlungsinformationen an den Microsoft Purview-Aktivitäts-Explorer.

Das SDK generiert das Discovery-Audit, nachdem die Anwendung ComputeActions() oder GetSensitivityLabel() aufruft und mip::ExecutionState bereitstellt. Das SDK generiert dieses Ereignis nur einmal pro Handler.

Weitere Informationen zum Ausführungszustand erhalten Sie in der mip::ExecutionState Dokumentation zu den Konzepten.

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

Legen Sie in der Praxis isAuditDiscoveryEnabled bei der true-Erstellung auf mip::PolicyHandler fest, damit Dateizugriffsinformationen an den Activity-Explorer weitergeleitet werden können.

Ereignis ändern

Änderungsereignisse stellen Informationen über die Datei, die angewendete oder geänderte Bezeichnung und alle vom Benutzer bereitgestellten Begründungen bereit. Um Änderungsereignisse zu generieren, rufen Sie mip::PolicyHandler bei NotifyCommittedActions() auf. Führen Sie den Aufruf aus, nachdem die Anwendung eine Änderung an einer Datei erfolgreich übernommen hat, und übergeben Sie dabei mip::ExecutionState, der die Aktionen berechnet hat.

Note

Wenn die Anwendung diese Funktion nicht aufruft, werden keine Überwachungsereignisse gesendet.

handler->NotifyCommittedActions(*state);

Überwachungsdashboard

Überwachungsereignisse, die vom SDK gesendet werden, sind im Microsoft Purview Aktivitäts-Explorer verfügbar.

Nächste Schritte

  • Zuletzt aktualisiert um