Microsoft Information Protection SDK – Koncepty profilu sady SDK zásad

Článek
11/02/2024

Před provedením jakýchkoli operací sady Sdk zásad je nutné je mip::Profile načíst.

Následující dva příklady ukazují, jak vytvořit objekt profileSettings pomocí místního úložiště pro úložiště stavu a pouze v paměti.

Načtení profilu

Teď, když jsou definovány MipContext a ProfileObserver jsou definovány, použijeme je k vytvoření instance mip::PolicyProfile. Vytvoření objektu mip::PolicyProfile vyžaduje mip::PolicyProfile::Settings a mip::MipContext.

Profile::Settings Parameters

Konstruktor PolicyProfile::Settings přijímá čtyři parametry uvedené níže:

const std::shared_ptr<MipContext>: Objekt mip::MipContext inicializovaný k uložení informací o aplikaci, cesty stavu atd.
mip::CacheStorageType: Definuje, jak uložit stav: V paměti, na disku nebo na disku a zašifrováno. Další podrobnosti najdete v konceptech úložiště mezipaměti.
std::shared_ptr<mip::PolicyProfile::Observer> observer: Sdílený ukazatel na implementaci profilu Observer (v PolicyProfileProtectionProfile, a FileProfile).

Následující dva příklady ukazují, jak vytvořit objekt profileSettings pomocí místního úložiště pro úložiště stavu a pouze v paměti.

Uložení stavu pouze v paměti

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

Nastavení profilu čtení a zápisu z cesty k úložišti na disku

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

V dalším kroku použijte k načtení vzorce příslibu Profilea budoucnosti .

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

Pokud se profil úspěšně načte, ProfileObserver::OnLoadSuccessbude naše implementace mip::Profile::Observer::OnLoadSuccess oznámena. Výsledný objekt, v tomto případě mip::Profile, stejně jako kontext, jsou předány jako parametry pozorovatel funkce.

Kontext je ukazatel na vytvořenou std::promise pro zpracování asynchronní operace. Funkce jednoduše nastaví hodnotu příslibu na objekt Profile, který byl předán pro první parametr. Pokud hlavní funkce použije Future.get(), výsledek může být uložen v novém objektu ve volajícím vlákně.

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

Seskupování

Když jste plně implementovali pozorovatele a delegáta ověřování, je teď možné plně načíst profil. Následující výnič kódu předpokládá, že jsou už zahrnuté všechny nezbytné hlavičky.

int main()
{
    const string userName = "MyTestUser@consoto.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();
}

Konečný výsledek je, že jsme úspěšně načetli profil a uložili do objektu s názvem profile.

Další kroky

Po přidání profilu je dalším krokem přidání modulu do profilu.

Koncepty modulu zásad

Sdílet prostřednictvím