SDK da Proteção de Informações da Microsoft - Conceitos de perfil do SDK de arquivo

Artigo
01/30/2024

O perfil é a classe raiz para todas as operações no MIP SDK. Antes de usar qualquer uma das funcionalidades do File SDK, um FileProfile deve ser criado e todas as operações futuras serão executadas pelo perfil ou por outros objetos adicionados ao perfil.

Há alguns pré-requisitos de código que devem ser atendidos antes de tentar instanciar um perfil:

MipContext foi criado e armazenado em um objeto acessível ao mip::FileProfile objeto.
ConsentDelegateImpl implementos mip::ConsentDelegate.
O aplicativo foi registrado no Microsoft Entra ID e o ID do cliente é codificado no aplicativo ou nos arquivos de configuração.
Uma herança de classe foi implementada mip::FileProfile::Observer adequadamente.

Carregar um perfil

Com o ProfileObserver, e ConsentDelegateImpl, definido, mip::FileProfile agora pode ser instanciado. A criação do mip::FileProfile objeto requer [mip::MipContext] para ter e mip::FileProfile::Settings armazenar todas as informações de configurações sobre o FileProfile.

FileProfile::Parâmetros de configurações

O FileProfile::Settings construtor aceita cinco parâmetros, listados abaixo:

std::shared_ptr<MipContext>: O mip::MipContext objeto 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.
std::shared_ptr<mip::ConsentDelegate>: Um ponteiro compartilhado da classe mip::ConsentDelegate.
std::shared_ptr<mip::FileProfile::Observer> observer: Um ponteiro compartilhado para a implementação do perfil Observer (em PolicyProfile, ProtectionProfilee FileProfile).

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

Armazenar estado apenas 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);

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

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

O trecho de código a seguir instruirá o a armazenar todos os dados de estado do FileProfile aplicativo no ./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

Carregar o perfil

Usando os detalhes da abordagem acima, agora use o padrão promise/future para carregar o FileProfile.

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

Se carregamos um perfil e essa operação foi bem-sucedida, ProfileObserver::OnLoadSuccessnossa implementação é mip::FileProfile::Observer::OnLoadSuccess chamada. O objeto resultante ou ponteiro de exceção, bem como o contexto, são passados como parâmetros para a função. O contexto é um ponteiro para o std::promise que criamos para lidar com a operação assíncrona. A função simplesmente define o valor da promessa para o objeto FileProfile que foi passado para o primeiro parâmetro. Quando a função principal usa Future.get(), o resultado pode ser armazenado em um novo objeto.

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

Juntando

Tendo implementado totalmente os observadores e o delegado de autenticação, agora é possível carregar totalmente um perfil. O trecho de código abaixo assume 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);

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

O resultado final é que carregamos com êxito o perfil e armazenamos no objeto chamado profile.

Passos Seguintes

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

Conceitos de mecanismo de arquivo

Partilhar via