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

Uygulama: Bir koruma motoru ekleyin

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, profile bir motor ekleyebilirsiniz.

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

Uygulama: Koruma altyapısı ayarları oluşturma

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

Aşağıdaki kod engineSettings adlı bir ProtectionEngine::Settings nesne oluşturur.

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

Uyarı

Koruma ayarları nesnesini bu yöntemle oluşturursanız, SetIdentity() kullanarak ProtectionEngine::Settings nesnesi üzerindeki kimliği veya SetCloud() kullanarak hedef bulut ortamını da ayarlayın.

En iyi uygulama olarak, ilişkili kullanıcıyı tanımlamak için ilk parametreyi, kimliği kullanın veya bir mip::Identity nesne kullanın. Ayarları mip::Identity ile başlatmak için:

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

EngineSettings'i bu şekilde oluşturduğunuzda, şunu kullanarak da açıkça benzersiz bir engineId ayarlayın:

engineSettings.SetEngineId(engineId);

Kullanıcı hizmeti veya uygulamayı her kullandığında altyapının tutarlı bir şekilde yüklendiğinden emin olmak için kullanıcı adını veya e-postayı kullanın.

Uygulama: Koruma motorunu ekleyin

Motoru eklemek için, profili yüklemede kullanılan future/promise desenini kullanın. mip::ProtectionProfile için söz oluşturmak yerine mip::ProtectionEngine kullanın.


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

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

  //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();

Kod, kimliği doğrulanmış kullanıcı için profile bir altyapı ekler.

Uygulama: Liste şablonları

Altyapıyı ekledikten sonra, çağrısı engine->GetTemplatesAsync()yaparak kimliği doğrulanmış kullanıcının kullanabileceği tüm duyarlılık şablonlarını listeleyebilirsiniz.

GetTemplatesAsync() şablon tanımlayıcılarının listesini getirir. yöntemi sonucu bir vektör olarak std::shared_ptr<mip::TemplateDescriptor>depolar.

Uygulama: ListSensitivityTemplates()

auto loadPromise = std::make_shared<std::promise<std::vector<std::shared_ptr<mip::TemplateDescriptor>>>>();
auto loadFuture = loadPromise->get_future();
engine->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->GetId() << endl;
}

Adların yazdırılması, uygulamanın hizmetten politikayı başarıyla çektiğini ve şablonları aldığını gösterir. Şablonu uygulamak için şablon tanımlayıcısına ihtiyacınız vardır.

Şablonları etiketlerle yalnızca ComputeActions() sonucunu inceleyerek İlke SDK'sı aracılığıyla eşleyebilirsiniz.

Sonraki Adımlar

Profili yüklediğinize, altyapıyı eklediğinize ve şablonlarınız olduğuna göre, dosyaları okumaya, yazmaya veya dosyalardan kaldırmaya başlamak için bir işleyici ekleyebilirsiniz. Bkz . Koruma işleyicisi kavramları.

  • Last updated on