Kit de développement logiciel (SDK) Microsoft Information Protection - Concepts du gestionnaire de stratégies

Dans le kit de développement logiciel (SDK) Policy, mip::PolicyHandler expose les opérations utilisées pour calculer les actions de stratégie et envoyer des événements d’audit.

Fonctions du gestionnaire de stratégies

mip::PolicyHandler expose les méthodes de lecture, écriture et suppression des étiquettes et des informations de protection. Pour obtenir la liste complète, consultez la référence de l’API.

Dans cet article, nous allons aborder les méthodes suivantes :

  • ComputeActions
  • NotifyCommittedActions

Spécifications

La création d’un PolicyHandler requiert :

  • Un mip::MipContext
  • Un mip::PolicyProfile
  • Un mip::PolicyEngine ajouté à l’élément mip::PolicyProfile
  • Une classe qui implémente mip::PolicyHandler::Observer

Créer un gestionnaire de stratégies

La première étape requise pour obtenir des actions de stratégie consiste à créer un objet PolicyHandler. Cette classe implémente des fonctionnalités requises pour obtenir la liste des actions qu’une étiquette spécifique doit effectuer. Elle implémente également la fonction pour déclencher un événement d’audit.

La création du PolicyHandler est aussi simple que l’appel de la fonction PolicyEngine de CreatePolicyHandlerAsync à l’aide du modèle promesse/avenir.

CreatePolicyHandlerAsync accepte un paramètre unique : isAuditDiscoveryEnabled. Définissez cette valeur sur true si l’application doit faire apparaître les événements de pulsation et de détection dans la journalisation d’audit.

Remarque

La classe mip::PolicyHandler::Observer doit être implémentée dans une classe dérivée, car CreatePolicyHandler requiert l’objet 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();

Une fois l’objet PolicyHandler créé, les actions peuvent être calculées et les événements d’audit envoyés.

Étapes suivantes

Maintenant que vous avez découvert la création d’un gestionnaire de stratégie :