Пакет SDK Microsoft Information Protection — основные понятия обработчика политик

В политиках SDK предоставляются вызовы, mip::PolicyHandler используемые для выполнения действий политики и отправки событий аудита.

Функции обработчика политик

mip::PolicyHandler предоставляет методы чтения, записи и удаления меток и сведений о защите. Полный список указан в справочнике API.

В этой статье рассматриваются следующие методы:

  • ComputeActions
  • NotifyCommittedActions

Требования

Создание PolicyHandler требует:

  • mip::MipContext
  • mip::PolicyProfile
  • Добавлено mip::PolicyEngine в mip::PolicyProfile
  • Класс, реализующий mip::PolicyHandler::Observer

Создание обработчика политики

Первым шагом, необходимым для получения действий политики, является создание объекта PolicyHandler. Этот класс реализует функциональные возможности, необходимые для получения списка действий, необходимых для выполнения определенной метки. Она также реализует функцию для активации события аудита.

Создание PolicyHandler так же просто, как вызов функции PolicyEngine из CreatePolicyHandlerAsync, используя паттерн "promise/future".

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, действия могут быть вычислены и события аудита отправлены.

Следующие шаги

Теперь, когда вы узнали о создании обработчика политики: