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

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

Профиль — это корневой класс для всех операций в пакете SDK MIP. Перед использованием любой функциональности пакета SDK для файлов необходимо создать FileProfile и все будущие операции будут выполняться профилем или другими объектами, добавленными в профиль.

Перед попыткой создать экземпляр профиля необходимо выполнить несколько предварительных требований для кода:

  • MipContext был создан и сохранен в объекте, доступном для mip::FileProfile объекта.
  • ConsentDelegateImpl реализует mip::ConsentDelegate.
  • Приложение зарегистрировано в идентификаторе Microsoft Entra, и идентификатор клиента жестко закодирован в файлах приложения или конфигурации.
  • Класс, наследующий mip::FileProfile::Observer , был реализован соответствующим образом.

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

Когда ProfileObserver и ConsentDelegateImpl определены, можно создать экземпляр mip::FileProfile. Для создания объекта mip::FileProfile требуется [mip::MipContext] и mip::FileProfile::Settings, чтобы хранить всю информацию о параметрах FileProfile.

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

Конструктор FileProfile::Settings принимает пять параметров, перечисленных ниже:

  • std::shared_ptr<MipContext>: объект mip::MipContext, инициализированный для хранения сведений о приложении, пути к состоянию и т. д.
  • mip::CacheStorageType: определяет, как хранить состояние: в памяти, на диске или на диске и зашифрованном.
  • std::shared_ptr<mip::ConsentDelegate>: общий указатель класса mip::ConsentDelegate.
  • std::shared_ptr<mip::FileProfile::Observer> observer: общий указатель на реализацию профиля Observer (в PolicyProfile, 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);

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

Чтение и запись настроек профиля из пути к хранилищу на диске

В следующем фрагменте кода будет указано FileProfile, как хранить все данные о состоянии приложения в ./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

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

Используя любой из указанных выше подходов, теперь используйте шаблон Promise/Future для загрузки FileProfile.

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

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

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

Объединение

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

int main()
{
    const string userName = "[email protected]";
    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();
}

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

Следующие шаги

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