Microsoft Information Protection SDK – koncepty jádra sady Policy SDK

mip::PolicyEngine implementuje všechny operace, které může sada SDK zásad provádět, s výjimkou načtení profilu.

Implementace: Přidání modulu zásad

Implementace: Vytvořte nastavení modulu zásad

Podobně jako profil vyžaduje modul také objekt nastavení . mip::PolicyEngine::Settings Tento objekt ukládá jedinečný identifikátor modulu, objekt vaší mip::AuthDelegate implementace, přizpůsobitelná klientská data pro ladění nebo telemetrii a volitelně národní prostředí.

Následující příklad vytvoří PolicyEngine::Settings objekt s názvem engineSettings pomocí identity uživatele aplikace:

PolicyEngine::Settings engineSettings(
  mip::Identity(mUsername), // mip::Identity.  
  authDelegateImpl,         // Auth delegate object
  "",                       // Client data. Customizable by developer, stored with engine.
  "en-US",                  // Locale.
  false);                   // Load sensitive information types for driving classification.

Při vytváření engineSettings tímto způsobem také explicitně nastavte jedinečné engineId:

engineSettings.SetEngineId(engineId);

Použití uživatelského jména nebo e-mailu pomáhá zajistit, aby se při každém použití služby nebo aplikace načítá stejný modul.

Lze také zadat vlastní ID enginu:

PolicyEngine::Settings engineSettings(
  "myEngineId",     // String
  authDelegateImpl, // Auth delegate object
  "",               // Client data in string format. Customizable by developer, stored with engine.
  "en-US",          // Locale. Default is en-US
  false);           // Load sensitive information types for driving classification. Default is false.

Osvědčeným postupem je použít první parametr, ID, který připojí modul k přidruženému uživateli, nejlépe hlavní název uživatele.

Implementace: Přidání modulu zásad

Chcete-li přidat engine, vraťte se ke vzoru future/promise, který se používá k načtení profilu. Místo vytvoření slibu pro mip::Profile, použít mip::PolicyEngine.


  // Auto profile will be std::shared_ptr<mip::Profile>.
  auto profile = profileFuture.get();

  // Create the delegate
  auto authDelegateImpl = std::make_shared<sample::auth::AuthDelegateImpl>(appInfo, userName, password);


  // Create the PolicyEngine::Settings object.
  PolicyEngine::Settings engineSettings("UniqueID", authDelegateImpl, "");

  // Create a promise for std::shared_ptr<mip::PolicyEngine>.
  auto enginePromise = std::make_shared<std::promise<std::shared_ptr<mip::PolicyEngine>>>();

  // Instantiate the future from the promise.
  auto engineFuture = enginePromise->get_future();

  // Add the engine using AddEngineAsync, passing in the engine settings and the promise.
  profile->AddEngineAsync(engineSettings, enginePromise);

  // Get the future value and store in std::shared_ptr<mip::PolicyEngine>.
  auto engine = engineFuture.get();

Kód přidá do profilu modul pro ověřeného uživatele.

Implementace: Vypsat popisky citlivosti

Pomocí přidaného modulu můžete zobrazit všechny popisky citlivosti dostupné ověřenému uživateli voláním engine->ListSensitivityLabels().

ListSensitivityLabels() Načte seznam popisků a atributů těchto popisků pro konkrétního uživatele ze služby. Výsledek je uložen ve vektoru std::shared_ptr<mip::Label>.

Implementace: ListSensitivityLabels()

std::vector<shared_ptr<mip::Label>> labels = engine->ListSensitivityLabels();

Implementace: Tisk štítků

//Iterate through all labels in the vector
for (const auto& label : labels) {
  //print the label name
  cout << label->GetName() << endl;
  //Iterate through all child labels
  for (const auto& child : label->GetChildren()) {
    //Print the label with some formatting
    cout << "->  " << child->GetName() << endl;
  }
}

Tisk názvů ukazuje, že aplikace úspěšně nabrala zásadu ze služby a získala štítky. Chcete-li použít štítek, potřebujete identifikátor štítku. Upravte předchozí fragment kódu tak, aby vrátil ID popisku:

for (const auto& label : labels) {
  //Print label name and GUID
  cout << label->GetName() << " : " << label->GetId() << endl;

  //Print child label name and GUID
  for (const auto& child : label->GetChildren()) {
    cout << "->  " << child->GetName() <<  " : " << child->GetId() << endl;
  }
}

Kolekci mip::Label, kterou vrací ListSensitivityLabels(), můžete použít k zobrazení všech popisků, které jsou uživateli k dispozici, a po jejich výběru použít ID k přiřazení popisků k souboru.

Další kroky

  • Poslední aktualizace v