Microsoft 資訊保護 SDK - 原則處理程式概念

在 Policy SDK 中，mip::PolicyHandler 提供用於計算原則動作及提交稽核事件的作業。

原則處理程式函式

mip::PolicyHandler 會公開讀取、寫入及移除標籤和保護資訊的方法。 如需完整清單，請參閱 API 參考。

在本文中，將涵蓋下列方法：

  • ComputeActions
  • NotifyCommittedActions

需求

建立 PolicyHandler 需要：

  • A mip::MipContext
  • A mip::PolicyProfile
  • mip::PolicyEngine 已新增至 mip::PolicyProfile
  • 實作 mip::PolicyHandler::Observer 的類別

建立原則處理程式

取得原則動作所需的第一個步驟是建立 PolicyHandler 物件。 這個類別會實作取得特定標籤必須採取的動作清單所需的功能。 它也實作了觸發稽核事件的功能。

建立 PolicyHandler 就像透過 promise/future 模式呼叫 PolicyEngine 的 CreatePolicyHandlerAsync 函式一樣簡單。

CreatePolicyHandlerAsync 接受單一參數： isAuditDiscoveryEnabled。 如果應用程式應在稽核記錄中顯示心跳和探索事件，請將此值設為 true。

注意事項

類別 mip::PolicyHandler::Observer 必須在衍生類別中實作，因為 CreatePolicyHandler 需要 Observer 物件。

auto createPolicyHandlerPromise = std::make_shared<std::promise<std::shared_ptr<mip::PolicyHandler>>>();
auto createPolicyHandlerFuture = createPolicyHandlerPromise->get_future();
PolicyEngine->CreatePolicyHandlerAsync(true);
auto handler = createPolicyHandlerFuture.get();

成功建立 PolicyHandler 物件之後，即可計算動作並提交稽核事件。

後續步驟

現在您已瞭解如何建立原則處理程式：

  • Last updated on