Поделиться через


Пакет SDK Microsoft Information Protection — основные понятия профиля пакета SDK политики

Перед mip::Profile выполнением любых операций пакета SDK политики необходимо загрузить.

В двух примерах ниже показано, как создать объект profileSettings с помощью локального хранилища для хранилища состояний, а также только в памяти.

Загрузка профиля

Теперь, когда MipContext и ProfileObserver определены, мы будем использовать их для создания экземпляров mip::PolicyProfile. mip::PolicyProfile Создание объекта требуется mip::PolicyProfile::Settings и mip::MipContext.

Параметры Profile::Settings

Конструктор PolicyProfile::Settings принимает четыре параметра, перечисленные ниже:

  • const std::shared_ptr<MipContext> mip::MipContext: объект, инициализированный для хранения сведений о приложении, пути к состоянию и т. д.
  • mip::CacheStorageType: определяет, как хранить состояние: в памяти, на диске или на диске и зашифрованном. Дополнительные сведения см. в концепциях хранилища кэша.
  • std::shared_ptr<mip::PolicyProfile::Observer> observer: общий указатель на реализацию профиля ObserverPolicyProfile, ProtectionProfileи FileProfile).

В двух примерах ниже показано, как создать объект profileSettings с помощью локального хранилища для хранилища состояний, а также только в памяти.

Хранение состояния только в памяти

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

Параметры профиля чтения и записи из пути к хранилищу на диске

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

Затем используйте шаблон обещания и будущего для загрузки Profile.

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

Если профиль успешно загружен, ProfileObserver::OnLoadSuccessнаша реализация mip::Profile::Observer::OnLoadSuccess уведомляется. Результирующий объект, в данном случае , mip::Profileа также контекст, передается в качестве параметров в функцию наблюдателя.

Контекст — это указатель на std::promise созданный для обработки асинхронной операции. Функция просто задает значение обещания объекту Profile, который был передан для первого параметра. При использовании Future.get()основной функции результат может храниться в новом объекте в вызывающем потоке.

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

Объединение его вместе

После полной реализации делегата наблюдателей и проверки подлинности теперь можно полностью загрузить профиль. Приведенный ниже фрагмент кода предполагает, что все необходимые заголовки уже включены.

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

Конечным результатом является то, что мы успешно загрузили профиль и сохранили его в вызываемом profileобъекте.

Next Steps

Теперь, когда профиль был добавлен, следующим шагом является добавление обработчика в профиль.

Основные понятия обработчика политик