Пакет 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
: общий указатель на реализацию профиля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);
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
Теперь, когда профиль был добавлен, следующим шагом является добавление обработчика в профиль.