Microsoft Information Protection SDK — koncepcje profilów zestawu SDK plików

  • Artykuł
  • Czas czytania: 2 min

Profil jest klasą główną wszystkich operacji w zestawie MIP SDK. Przed użyciem dowolnej funkcji zestawu File SDK należy utworzyć zestaw SDK i wykonać wszystkie przyszłe operacje przez profil lub inne obiekty dodane FileProfile do profilu. FileProfile

Istnieje kilka wymagań wstępnych dla kodu, które należy spełnić przed podjęciem próby wystąpienia profilu:

  • MipContext został utworzony i zapisany w obiekcie z ułatwieniami dostępu mip::FileProfile do tego obiektu.
  • ConsentDelegateImplmip::ConsentDelegateimplementuje.
  • Aplikacja została zarejestrowana w aplikacji Azure Active Directory a identyfikator klienta jest mocno kodowany w plikach aplikacji lub konfiguracji.
  • Dziedziczenie mip::FileProfile::Observer zajęć zostało odpowiednio zaimplementowane.

Ładowanie profilu

Teraz można utworzyć wystąpienia za pomocą zdefiniowanych funkcji , i ProfileObserverConsentDelegateImplmip::FileProfile . Do utworzenia obiektu wymagany jest [ ] have i do przechowywania mip::FileProfilemip::MipContext wszystkich informacji o mip::FileProfile::Settings ustawieniach dotyczących FileProfile .

FileProfile::Ustawienia Parameters

Konstruktor FileProfile::Settings akceptuje pięć parametrów wymienionych poniżej:

  • std::shared_ptr<MipContext>: mip::MipContext Obiekt, który został zainicjowany w celu przechowywania informacji o aplikacji, ścieżka województwa itp.
  • mip::CacheStorageType: Definiuje sposób przechowywania stanu: W pamięci, na dysku lub na dysku i zaszyfrowany.
  • std::shared_ptr<mip::ConsentDelegate>: Udostępniony wskaźnik zajęć mip::ConsentDelegate .
  • std::shared_ptr<mip::FileProfile::Observer> observer: Udostępniony wskaźnik implementacji Observer profilu (w PolicyProfile , i ProtectionProfileFileProfile ).

W poniższych przykładach popisano, jak utworzyć obiekt przy użyciu magazynu lokalnego na przykład do przechowywania informacji o stanie oraz profileSettings tylko w pamięci.

Stan przechowywania 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);

FileProfile::Settings profileSettings(
    mMipContext,                                  // mipContext object
    mip::CacheStorageType::InMemory,              // use in memory storage
    std::make_shared<ConsentDelegateImpl>(),      // new consent delegate
    std::make_shared<FileProfileObserverImpl>()); // new protection profile observer

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

Poniższy wycinek kodu poinstruuje, aby przechować FileProfile wszystkie dane o stanie aplikacji w ./mip_app_data .

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

FileProfile::Settings profileSettings(
    mMipContext,                                   // mipContext object
    mip::CacheStorageType::OnDisk,                 // use on disk storage    
    std::make_shared<ConsentDelegateImpl>(),       // new consent delegate
    std::make_shared<FileProfileObserverImpl>());  // new protection profile observer

Ładowanie profilu

Użyj powyższych szczegółów dotyczących obu powyższych podejście, a teraz użyj wzorca obietnicy/przyszłej, aby załadować ten FileProfile .

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

Jeśli załadowano profil i ta operacja się powiedzie, to ProfileObserver::OnLoadSuccess nasza implementacja mip::FileProfile::Observer::OnLoadSuccess jest nazywana. Wynikowy obiekt lub wskaźnik wyjątku, a także kontekst, są przekazywane jako parametry do funkcji. Kontekst jest wskaźnikiem utworzonym do obsługi std::promise operacji synchronizacji. Funkcja po prostu ustawia wartość obietnicy dla obiektu FileProfile, który został przekazany dla pierwszego parametru. Gdy funkcja główna używa Future.get() , wynik może być przechowywany w nowym obiekcie.

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

Umieszczanie go na nim

Po pełnym wdrożeniu użytkowników i pełnomocnika uwierzytelniania można teraz całkowicie załadować profil. W poniższej wycinka kodu założono, ż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);

    FileProfile::Settings profileSettings(
        mMipContext,                                   // MipContext object
        mip::CacheStorageType::OnDisk,                 // use on disk storage        
        std::make_shared<ConsentDelegateImpl>(),       // new consent delegate
        std::make_shared<FileProfileObserverImpl>());  // new file profile observer

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

Wynikiem jest to, że pomyślnie załadowaliśmy profil i przechowywano go w obiekcie o nazwie profile .

Następne kroki

Po dodaniu profilu następnym krokiem jest dodanie aparatu do profilu.