Microsoft Information Protection SDK – Koncepty modulu sady SDK ochrany

Implementace: Přidat ochranný modul

V rámci sady File SDK je třída mip::ProtectionProfile kořenovou třídou pro všechny operace SDK. Po vytvoření profilu nyní můžeme do profilu přidat engine.

Následující příklad ukazuje použití jednoho modulu pro jednoho ověřeného uživatele.

Implementace: Vytvoření nastavení modulu ochrany

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

Zde vytvoříme ProtectionEngine::Settings objekt s názvem engineSettings.

ProtectionEngine::Settings engineSettings("UniqueID", "");

Poznámka:

Pokud používáte tuto metodu k vytvoření objektu nastavení ochrany, musíte také ručně nastavit identitu na ProtectionEngineSettings prostřednictvím setIdentity() cílového cloudového prostředí prostřednictvím setCloud().

Osvědčeným postupem je, že první parametr, ID, by měl být něco, co modulu umožňuje snadné připojení k přidruženému uživateli nebo objektu mip::Identity . Inicializace nastavení pomocí mip::Identity:

ProtectionEngine::Settings engineSettings(mip::Identity("Bob@Contoso.com", "");

Při vytváření engineSettings tímto způsobem je důležité explicitně nastavit jedinečné engineId prostřednictvím:

engineSettings.SetEngineId(engineId);

Použití uživatelského jména nebo e-mailu pomáhá zajistit, aby se pokaždé, když uživatel používá službu nebo aplikaci, načetl stejný modul.

Implementace: Přidat ochranný modul

Chcete-li přidat engine, vrátíme se ke vzoru Future/Promise použitému k načtení profilu. Místo vytváření příslibu pro mip::ProtectionProfile, použijeme mip::ProtectionEngine.

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

  //Create the ProtectionEngine::Settings object
  ProtectionEngine::Settings engineSettings("UniqueID", "");

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

  //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::ProtectionEngine>
  auto engine = engineFuture.get();

Konečným výsledkem výše uvedeného kódu je, že jsme úspěšně přidali modul pro ověřeného uživatele do profilu.

Implementace: Výpis šablon

Pomocí přidaného modulu je nyní možné vypsat všechny šablony citlivosti dostupné ověřenému uživateli voláním engine->GetTemplatesAsync().

GetTemplatesAsync() načte seznam identifikátorů šablon. Výsledek je uložen ve vektoru std::shared_ptr<std::string>.

Implementace: ListSensitivityTemplates()

auto loadPromise = std::make_shared<std::promise<shared_ptr<vector<string>>>>();
std::future<std::shared_ptr<std::vector<std::string>>> loadFuture = loadPromise->get_future();
mEngine->GetTemplatesAsync(engineObserver, loadPromise);
auto templates = loadFuture.get();

Implementace: Výpis ID šablon

//Iterate through all template IDs in the vector
for (const auto& temp : *templates) {
  cout << "Template:" << "\n\tId: " << temp << endl;
}

Tisk názvů je snadný způsob, jak ukázat, že jsme ze služby úspěšně načetli zásady a mohli šablony získat. K použití šablony se vyžaduje identifikátor šablony.

Mapování šablon na štítky lze provést pouze pomocí sady Policy SDK na základě výsledku ComputeActions().

Další kroky

Teď, když je profil načtený, modul přidaný a máme šablony, můžeme přidat obslužnou rutinu, která začne číst, zapisovat nebo odebírat šablony ze souborů. Viz principy obslužné rutiny ochrany.