MIP SDK 中的稽核

Purview 入口網站可讓您透過活動總管存取稽核報告。 這些報告提供由使用者在整合了 MIP SDK 的任何應用程式中手動或自動套用的標籤的可見性。 利用SDK的開發合作夥伴可以輕鬆地啟用這項功能，讓應用程式的資訊可在客戶報表中呈現。

事件類型

有三種類型的稽核事件可以透過 SDK 傳送。 心跳事件、發現事件和變更事件

心跳事件

已整合策略 SDK 的任何應用程式都會自動產生心跳事件。 心跳事件包括：

  • 租戶識別碼 (TenantId)
  • 產生的時間
  • 使用者主體名稱
  • 產生稽核的計算機名稱
  • 程序名稱
  • 平台
  • 應用程式識別碼 - 對應至 Microsoft Entra 應用程式識別碼。

這些事件適用於偵測使用 Microsoft 資訊保護 SDK 的企業應用程式。

發現活動

探索事件提供關於原則 SDK 所讀取或取用之標示資訊的資料。 這些事件在呈現跨組織存取資訊的裝置、位置和使用者時很有用。

探索事件會在原則 SDK 中產生，方法是在建立 mip::PolicyHandler 物件時設定旗標。 在下列範例中， isAuditDiscoveryEnabled 的值會設定為 true。 當 mip::ExecutionState 傳遞至 ComputeActions() 或 GetSensitivityLabel() 時（使用現有的元數據資訊和內容標識符），探索資訊將會提交至 Microsoft Purview 活動探索器。

一旦應用程式呼叫 ComputeActions() 或 GetSensitivityLabel() 並提供 mip::ExecutionState，就會產生探索稽核。 每個處理程式只會產生此事件一次。

如需 mip::ExecutionState 執行狀態的詳細資訊，請檢閱概念檔。

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

實際上，isAuditDiscoveryEnabled 應在建立過程中啟用，以允許檔案存取資訊流入活動檢視器。

變更事件

變更事件會提供檔案的相關信息、已套用或變更的標籤，以及使用者提供的任何理由。 在NotifyCommittedActions() 上呼叫 mip::PolicyHandler 會產生變更事件。 呼叫在變更成功提交到檔案之後進行，並傳入用來計算動作的 mip::ExecutionState。

如果應用程式無法呼叫此函式，則不會傳送稽核事件。

handler->NotifyCommittedActions(*state);

稽核儀錶板

SDK 所傳送的稽核事件將在 Purview 活動瀏覽器中可用。

後續步驟

  • Last updated on