Быстрый старт: Инициализация клиентского приложения — Policy SDK (C++)

В этом кратком руководстве показано, как реализовать шаблон инициализации клиента, используемый пакетом SDK политики для MIP C++ во время выполнения.

Необходимые условия

Если вы еще не сделали этого, обязательно выполните следующие действия.

• Выполните действия, описанные в настройке и конфигурации пакета SDK Microsoft Information Protection (MIP).
• Необязательно:
  • Просмотрите объекты профиля и движка.
  • Ознакомьтесь с основными понятиями проверки подлинности.
  • Ознакомьтесь с концепциями наблюдателя.

Создание решения и проекта Visual Studio

1. Откройте Visual Studio 2022 или более поздней версии, выберите меню "Файл ", "Создать", " Проект".

   • Выберите консольное приложение в шаблонах C++ .
   • Укажите имя и расположение проекта.

2. Добавьте пакет NuGet для пакета SDK политики MIP в проект:

   • В обозревателе решений щелкните правой кнопкой мыши узел проекта и выберите пункт "Управление пакетами NuGet...".
   • Выберите Обзор и введите "Microsoft.InformationProtection" в поле поиска.
   • Выберите пакет Microsoft.InformationProtection.Policy и нажмите кнопку "Установить".

Реализуйте класс наблюдателя

Создайте базовую реализацию класса наблюдателя профиля политики, расширив класс mip::PolicyProfile::Observer в SDK.

1. Добавьте новый класс в проект с именем profile_observer.

2. Замените содержимое profile_observer.h:

   #include <memory>
   #include "mip/upe/policy_profile.h"
   
   class PolicyProfileObserver final : public mip::PolicyProfile::Observer {
   public:
        PolicyProfileObserver() { }
        void OnLoadSuccess(const std::shared_ptr<mip::PolicyProfile>& profile, const std::shared_ptr<void>& context) override;
        void OnLoadFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;
        void OnAddEngineSuccess(const std::shared_ptr<mip::PolicyEngine>& engine, const std::shared_ptr<void>& context) override;
        void OnAddEngineFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;
   };
   

3. Замените содержимое profile_observer.cpp:

   #include "profile_observer.h"
   #include <future>
   
   using std::promise;
   using std::shared_ptr;
   using std::exception_ptr;
   
   void PolicyProfileObserver::OnLoadSuccess(const shared_ptr<mip::PolicyProfile>& profile, const shared_ptr<void>& context) {
        auto loadPromise = static_cast<promise<shared_ptr<mip::PolicyProfile>>*>(context.get());
        loadPromise->set_value(profile);
   }
   
   void PolicyProfileObserver::OnLoadFailure(const exception_ptr& error, const shared_ptr<void>& context) {
        auto loadPromise = static_cast<promise<shared_ptr<mip::PolicyProfile>>*>(context.get());
        loadPromise->set_exception(error);
   }
   
   void PolicyProfileObserver::OnAddEngineSuccess(const shared_ptr<mip::PolicyEngine>& engine, const shared_ptr<void>& context) {
        auto addEnginePromise = static_cast<promise<shared_ptr<mip::PolicyEngine>>*>(context.get());
        addEnginePromise->set_value(engine);
   }
   
   void PolicyProfileObserver::OnAddEngineFailure(const exception_ptr& error, const shared_ptr<void>& context) {
        auto addEnginePromise = static_cast<promise<shared_ptr<mip::PolicyEngine>>*>(context.get());
        addEnginePromise->set_exception(error);
   }
   

Реализовать делегата проверки подлинности и основную функцию

1. Добавьте новый класс в проект с именем auth_delegate. Дополнительные сведения о реализации интерфейса см. в mip::AuthDelegate.

2. Обновление main() для создания MipContext, загрузки PolicyProfileи добавления PolicyEngine:

   #include "mip/mip_context.h"
   #include "mip/upe/policy_profile.h"
   #include "auth_delegate.h"
   #include "profile_observer.h"
   
   #include <iostream>
   #include <future>
   
   using std::cout;
   using std::endl;
   using std::make_shared;
   using std::shared_ptr;
   
   int main()
   {
       // Construct/initialize objects required by the application's profile object
       auto mipConfiguration = make_shared<mip::MipConfiguration>(
           "your_app_id",                          // Application ID from Microsoft Entra app registration
           "MIP SDK Policy Quickstart",            // Friendly name
           "1.0",                                  // Version
           true                                    // GUID for each machine
       );
   
       auto mipContext = mip::MipContext::Create(mipConfiguration);
   
       auto profileObserver = make_shared<PolicyProfileObserver>();
   
       auto authDelegateImpl = make_shared<sample::auth::AuthDelegateImpl>("your_app_id");
   
       mip::PolicyProfile::Settings profileSettings(mipContext,
           mip::CacheStorageType::OnDiskEncrypted,
           authDelegateImpl
       );
   
       // Load Policy Profile
       auto profilePromise = make_shared<std::promise<shared_ptr<mip::PolicyProfile>>>();
       auto profileFuture = profilePromise->get_future();
       mip::PolicyProfile::LoadAsync(profileSettings, profileObserver, profilePromise);
       auto profile = profileFuture.get();
   
       // Add a Policy Engine
       mip::PolicyEngine::Settings engineSettings(
           mip::Identity("user@contoso.com"),
           authDelegateImpl,
           "",
           "en-US",
           false
       );
   
       auto enginePromise = make_shared<std::promise<shared_ptr<mip::PolicyEngine>>>();
       auto engineFuture = enginePromise->get_future();
       profile->AddEngineAsync(engineSettings, profileObserver, enginePromise);
       auto engine = engineFuture.get();
   
       // Application using Policy engine is ready. 
       // Engine can be used to list labels, compute actions, etc.
   
       cout << "Policy engine loaded successfully." << endl;
   
       return 0;
   }
   

3. Сборка и тестирование. Приложение должно успешно инициализироваться и подключиться к службе Policy.

Дальнейшие действия

• Список меток конфиденциальности (Policy SDK - C++)
• Основные понятия профиля и механизма Policy SDK