SDK da Proteção de Informações da Microsoft - Conceitos do perfil do SDK de política

Carregue mip::Profile antes de executar qualquer operação do SDK de Política.

Os dois exemplos a seguir mostram como criar o objeto profileSettings usando o armazenamento local somente para armazenamento de estado ou na memória.

Carregar um perfil

Depois de definir MipContext e ProfileObserverusá-los para instanciar mip::PolicyProfile. A criação do objeto mip::PolicyProfile exige mip::PolicyProfile::Settings e mip::MipContext.

Parâmetros de Profile::Settings

O PolicyProfile::Settings construtor aceita os quatro parâmetros a seguir:

• const std::shared_ptr<MipContext>: o objeto mip::MipContext que foi inicializado para armazenar informações do aplicativo, caminho de estado etc.
• mip::CacheStorageType: define como armazenar o estado: na memória, no disco ou no disco e criptografado. Para obter mais detalhes, consulte os conceitos de armazenamento em cache.
• std::shared_ptr<mip::PolicyProfile::Observer> observer: um ponteiro compartilhado para a implementação do perfil Observer (em PolicyProfile, ProtectionProfile e FileProfile).

Os dois exemplos a seguir mostram como criar o objeto profileSettings usando o armazenamento local somente para armazenamento de estado ou na memória.

Armazenar estado somente na memória

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

Configurações de perfil de leitura/gravação do caminho de armazenamento em disco

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

Em seguida, use o padrão promessa/futuro para carregar o Profile.

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

Se o aplicativo carregar um perfil com êxito, ProfileObserver::OnLoadSuccess, a implementação de mip::Profile::Observer::OnLoadSuccess, será notificada. O SDK passa o objeto resultante, nesse caso um mip::Profilee o contexto como parâmetros para a função de observador.

O contexto é um ponteiro para o std::promise criado para lidar com a operação assíncrona. A função define como valor da promessa o objeto Profile passado como primeiro parâmetro. Quando a função principal usa Future.get(), ela pode armazenar o resultado em um novo objeto no thread de chamada.

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

Juntando tudo

Depois de implementar os observadores e o delegado de autenticação, você pode carregar totalmente um perfil. O snippet de código a seguir pressupõe que todos os cabeçalhos necessários já estão incluídos.

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

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

O código carrega o perfil e o armazena no objeto chamado profile.

Próximas Etapas 

Agora que o perfil é adicionado, a próxima etapa é adicionar um mecanismo ao perfil.

Conceitos do mecanismo de política

• Exemplo de C++ do SDK de Política de MIP