Zestaw SDK usługi Microsoft Information Protection — pojęcia profilu SDK polityki

Wczytaj mip::Profile przed wykonaniem jakichkolwiek operacji Policy SDK.

Poniższe dwa przykłady pokazują, jak utworzyć obiekt profileSettings przy użyciu pamięci lokalnej do przechowywania stanu lub wyłącznie w pamięci.

Ładowanie profilu

Po zdefiniowaniu MipContext i ProfileObserver użyj ich do utworzenia wystąpienia mip::PolicyProfile. Utworzenie obiektu mip::PolicyProfile wymaga mip::PolicyProfile::Settings i mip::MipContext.

Profil::Ustawienia parametry

Konstruktor PolicyProfile::Settings akceptuje następujące cztery parametry:

  • const std::shared_ptr<MipContext> mip::MipContext: obiekt, który został zainicjowany do przechowywania informacji o aplikacji, ścieżki stanu itp.
  • mip::CacheStorageType: definiuje sposób przechowywania stanu: w pamięci, na dysku lub na dysku i zaszyfrowanym. Aby uzyskać więcej informacji, zobacz Pojęcia dotyczące magazynu pamięci podręcznej.
  • std::shared_ptr<mip::PolicyProfile::Observer> observer: współdzielony wskaźnik do implementacji profilu Observer (w PolicyProfile, ProtectionProfile i FileProfile).

Poniższe dwa przykłady pokazują, jak utworzyć obiekt profileSettings, używając pamięci lokalnej do przechowywania stanu lub wyłącznie w pamięci.

Przechowywanie stanu tylko w pamięci

mip::ApplicationInfo appInfo {clientId, "APP NAME", "1.2.3" };

std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
				                                                                                  "mip_data",
                                                                                        		  mip::LogLevel::Trace,
                                                                                                  false);

std::shared_ptr<mip::MipContext> mMipContext = mip::MipContext::Create(mipConfiguration);

PolicyProfile::Settings profileSettings(
    mMipContext,                                  // mipContext object
    mip::CacheStorageType::InMemory,              // use in memory storage
    std::make_shared<PolicyProfileObserverImpl>()); // new protection profile observer

Ustawienia profilu odczytu/zapisu ze ścieżki magazynu na dysku

mip::ApplicationInfo appInfo {clientId, "APP NAME", "1.2.3" };

std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
			                                                                                      "mip_data",
                                                                                       			  mip::LogLevel::Trace,
                                                                                                  false);

std::shared_ptr<mip::MipContext> mMipContext = mip::MipContext::Create(mipConfiguration);

PolicyProfile::Settings profileSettings(
    mipContext,                                    // mipContext object
    mip::CacheStorageType::OnDisk,                 // use on disk storage
    std::make_shared<PolicyProfileObserverImpl>());  // new protection profile observer

Następnie użyj wzorca promise/future, aby załadować element Profile.

auto profilePromise = std::make_shared<std::promise<std::shared_ptr<Profile>>>();
auto profileFuture = profilePromise->get_future();
Profile::LoadAsync(profileSettings, profilePromise);

Jeśli aplikacja pomyślnie ładuje profil, implementacja elementu mip::Profile::Observer::OnLoadSuccess, ProfileObserver::OnLoadSuccess, jest powiadamiana. SDK przekazuje obiekt wynikowy, w tym przypadku element mip::Profile, oraz kontekst jako parametry do funkcji obserwatora.

Kontekst jest wskaźnikiem do elementu std::promise, który został utworzony w celu obsługi operacji asynchronicznej. Funkcja ustawia wartość obietnicy dla obiektu Profile przekazanego dla pierwszego parametru. Gdy funkcja główna używa Future.get(), może zapisać wynik w nowym obiekcie w wątku wywołującym.

//get the future value and store in profile.
auto profile = profileFuture.get();

Składanie całości

Po zaimplementowaniu obserwatorów i delegata uwierzytelniania można w pełni załadować profil. Poniższy fragment kodu zakłada, że wszystkie niezbędne nagłówki są już uwzględnione.

int main()
{
    const string userName = "MyTestUser@contoso.com";
    const string password = "P@ssw0rd!";
    const string clientId = "MyClientId";

    mip::ApplicationInfo appInfo {clientId, "APP NAME", "1.2.3" };
 
    std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
				                                                                                       "mip_data",
                                                                                        			   mip::LogLevel::Trace,
                                                                                                       false);

    std::shared_ptr<mip::MipContext> mMipContext = mip::MipContext::Create(mipConfiguration);

    PolicyProfile::Settings profileSettings(
        mMipContext,                                    // mipContext object
        mip::CacheStorageType::OnDisk,                 // use on disk storage
        std::make_shared<PolicyProfileObserverImpl>());  // new protection profile observer

    auto profilePromise = std::make_shared<promise<shared_ptr<PolicyProfile>>>();
    auto profileFuture = profilePromise->get_future();
    Profile::LoadAsync(profileSettings, profilePromise);
    auto profile = profileFuture.get();
}

Kod ładuje profil i przechowuje go w obiekcie o nazwie profile.

Następne kroki

Teraz, gdy profil został dodany, następnym krokiem jest dodanie silnika do profilu.

Pojęcia dotyczące silnika zasad

  • Ostatnia aktualizacja o