Microsoft Information Protection SDK – Koncepty profilů souborových sad SDK

Profil je kořenová třída pro všechny operace v sadě Software Development Kit (SDK) MIP. Před použitím jakékoli funkce FileProfile sady File SDK je nutné vytvořit profil a všechny budoucí operace budou prováděny profilem nebo jinými objekty přidanými do profilu.

Před pokusem o vytvoření instance profilu je potřeba splnit několik požadavků na kód:

• MipContext byl vytvořen a uložen v objektu přístupném pro mip::FileProfile objekt.
• ConsentDelegateImpl implementuje mip::ConsentDelegate.
• Aplikace byla zaregistrována v Microsoft Entra ID a ID klienta je pevně zakódováno do aplikace nebo konfiguračních souborů.
• Třída dědící mip::FileProfile::Observer byla správně implementována.

Načtení profilu

S definovanými ProfileObserver a ConsentDelegateImpl lze nyní vytvořit instanci mip::FileProfile. Vytvoření objektu mip::FileProfile vyžaduje, aby mip::MipContext měl a mip::FileProfile::Settings ukládal všechny informace o nastavení FileProfile.

FileProfile::Nastavení Parametry

Konstruktor FileProfile::Settings přijímá pět parametrů uvedených níže:

• std::shared_ptr<MipContext>: Objekt mip::MipContext inicializovaný pro 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.
• std::shared_ptr<mip::ConsentDelegate>: Sdílený ukazatel třídy mip::ConsentDelegate.
• std::shared_ptr<mip::FileProfile::Observer> observer: Sdílený ukazatel na implementaci profilu Observer (v PolicyProfile, ProtectionProfile, a FileProfile).

Následující příklady ukazují, jak vytvořit profileSettings objekt 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);

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

Načíst/uložit nastavení profilu z úložné cesty na disku

Následující výnip kódu dá pokyn FileProfile k uložení všech dat o stavu aplikace do ./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

Načíst profil

Teď použijte vzorec slibu/budoucnosti k načtení FileProfile pomocí výše uvedených podrobností o obou přístupech.

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

Pokud jsme načetli profil a tato operace byla úspěšná, ProfileObserver::OnLoadSuccess, volá se naše implementace mip::FileProfile::Observer::OnLoadSuccess. Výsledný objekt nebo ukazatel výjimky a kontext se předá funkci jako parametry. Kontext je ukazatel na std::promise, který jsme vytvořili pro řízení asynchronní operace. Funkce jednoduše nastaví hodnotu promise na objekt FileProfile, který byl předán jako první parametr. Pokud hlavní funkce použije Future.get(), výsledek může být uložen v novém objektu.

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

Dát to dohromady

Poté, co jste plně implementovali pozorovatele a delegáta pro 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@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();
}

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

Další kroky

Nyní, když byl profil přidán, dalším krokem je přidání stroje do profilu.

• Koncepty souborového enginu