Microsoft Information Protection SDK - Koruma SDK'sı altyapısı kavramları

Makale
01/30/2024

Uygulama: Koruma Altyapısı Ekleme

Dosya SDK'sında, mip::ProtectionProfile sınıfı tüm SDK işlemlerinin kök sınıfıdır. Profili oluşturduktan sonra artık profile bir altyapı ekleyebiliriz.

Aşağıdaki örnekte, kimliği doğrulanmış tek bir kullanıcı için tek bir altyapının kullanılması gösterilmektedir.

Uygulama: Koruma Altyapısı oluşturma Ayarlar

Bir profile benzer şekilde, altyapı da bir ayarlar nesnesi gerektirir. mip::ProtectionEngine::Settings Bu nesne benzersiz altyapı tanımlayıcısını, hata ayıklama veya telemetri için kullanılabilecek özelleştirilebilir istemci verilerini ve isteğe bağlı olarak yerel ayarı depolar.

Burada engine Ayarlar adlı bir ProtectionEngine::Settings nesne oluşturuyoruz.

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

Dekont

Koruma ayarları nesnesini oluşturmak için bu yöntemi kullanıyorsanız, protectionEngine Ayarlar setIdentity() aracılığıyla veya aracılığıyla hedef bulut ortamında setCloud()da kimliği el ile ayarlamanız gerekir.

En iyi yöntem olarak, ilk parametre olan id, altyapının ilişkili kullanıcıya veya bir nesneye kolayca bağlanmasına olanak tanıyan bir mip::Identity şey olmalıdır. ayarları ile mip::Identitybaşlatmak için:

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

Altyapı oluştururken Ayarlar bu şekilde benzersiz bir engineId ayarlamak da önemlidir:

engineSettings.SetEngineId(engineId);

Kullanıcı adı veya e-postanın kullanılması, kullanıcı hizmeti veya uygulamayı her kullandığında aynı altyapının yüklendiğinden emin olmak için yardımcı olur.

Uygulama: Koruma Altyapısını Ekleme

Altyapıyı eklemek için profili yüklemek için kullanılan gelecek/promise desenine geri döneceğiz. için mip::ProtectionProfilesöz oluşturmak yerine kullanacağız 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();

Yukarıdaki kodun sonucu, kimliği doğrulanmış kullanıcı için profile başarıyla bir altyapı eklemiş olmamızdır.

Uygulama: Liste Şablonları

Eklenen altyapıyı kullanarak, kimliği doğrulanmış kullanıcının kullanabileceği tüm duyarlılık şablonlarını çağırarak engine->GetTemplatesAsync()listelemek artık mümkündür.

GetTemplatesAsync() şablon tanımlayıcılarının listesini getirir. Sonuç, vektörde std::shared_ptr<std::string>depolanır.

Uygulama: 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();

Uygulama: Şablon Kimliklerini Yazdırma

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

Adları yazdırmak, hizmetten başarıyla ilke çektiğimizi ve şablonları alabildiğimizi göstermenin kolay bir yoludur. Şablonu uygulamak için şablon tanımlayıcısı gereklidir.

Şablonları etiketlere eşleme yalnızca sonucunu inceleyerek İlke SDK'sı ComputeActions()aracılığıyla yapılabilir.

Sonraki Adımlar

Artık profil yüklendiğine, altyapı eklendiğine ve şablonlarımız olduğuna göre, dosyaları okumaya, yazmaya veya dosyalardan kaldırmaya başlamak için bir işleyici ekleyebiliriz. Bkz. Koruma işleyicisi kavramları.

Aracılığıyla paylaş