Audyt w zestawie MIP SDK

portal Microsoft Purview zapewnia dostęp do raportów inspekcji za pośrednictwem Eksploratora działań. Te raporty zapewniają wgląd w etykiety, które użytkownicy stosują, ręcznie lub automatycznie, we wszystkich aplikacjach, które integrują zestaw MIP SDK. Partnerzy deweloperzy korzystający z zestawu SDK mogą włączyć tę funkcję, która umożliwia dostęp do informacji z aplikacji w raportach klientów.

Typy zdarzeń

Zestaw SDK może wysyłać trzy typy zdarzeń inspekcji: zdarzenia pulsu, zdarzenia odnajdywania i zdarzenia zmiany.

Zdarzenia bicia serca

SDK automatycznie generuje zdarzenia heartbeat dla każdej aplikacji, która integruje Policy SDK. Zdarzenia pulsu obejmują:

  • Identyfikator najemcy
  • Czas wygenerowania
  • Główna nazwa użytkownika
  • Nazwa maszyny, która wygenerowała inspekcję
  • Nazwa procesu
  • Platforma
  • Identyfikator aplikacji — odpowiada identyfikatorowi aplikacji Microsoft Entra

Te zdarzenia są przydatne w wykrywaniu aplikacji w przedsiębiorstwie korzystających z zestawu SDK Microsoft Information Protection.

Zdarzenia wykrywania

Zdarzenia odnajdywania dostarczają informacji o zawartości opatrzonej etykietą, którą zestaw SDK zasad odczytuje lub wykorzystuje. Te zdarzenia są przydatne, ponieważ udostępniają urządzenia, lokalizację i użytkowników, którzy uzyskują dostęp do informacji w organizacji.

Aby generować zdarzenia wykrywania w Policy SDK, ustaw flagę podczas tworzenia obiektu mip::PolicyHandler. W poniższym przykładzie wartość elementu isAuditDiscoveryEnabled jest ustawiona na true. Gdy przekażesz mip::ExecutionState do ComputeActions() lub GetSensitivityLabel() (z istniejącymi metadanymi i identyfikatorem treści), SDK przesyła informacje o odnajdywaniu do Eksploratora działań Microsoft Purview.

Pakiet SDK generuje audyt wykrywania po wywołaniu przez aplikację ComputeActions() lub GetSensitivityLabel() oraz przekazaniu mip::ExecutionState. SDK generuje to zdarzenie tylko raz dla każdego programu obsługi.

Zapoznaj się z dokumentacją pojęcia mip::ExecutionState, aby uzyskać więcej informacji na temat stanu wykonywania.

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

W praktyce ustaw isAuditDiscoveryEnabled na true podczas tworzenia mip::PolicyHandler, aby umożliwić przepływ informacji o dostępie do plików do Eksploratora aktywności.

Zmień zdarzenie

Zdarzenia zmiany zawierają informacje o pliku, etykiecie zastosowanej lub zmienionej oraz wszelkich uzasadnieniach dostarczonych przez użytkownika. Aby wygenerować zdarzenia zmiany, wywołaj NotifyCommittedActions() dla obiektu mip::PolicyHandler. Wykonaj wywołanie po pomyślnym zatwierdzeniu przez aplikację zmiany w pliku, przekazując element mip::ExecutionState, który obliczył akcje.

Note

Jeśli aplikacja nie wywoła tej funkcji, żadne zdarzenia inspekcji nie są wysyłane.

handler->NotifyCommittedActions(*state);

Panel audytu

Zdarzenia inspekcji wysyłane przez zestaw SDK są dostępne w eksploratorze działań Microsoft Purview.

Następne kroki

  • Ostatnia aktualizacja o