Microsoft Information Protection SDK - 보호 SDK 프로필 개념

아티클
11/02/2024

아래의 두 예제에서는 상태 스토리지와 메모리 내 전용 로컬 스토리지를 사용하여 profileSettings 개체를 만드는 방법을 보여 줍니다.

프로필 로드

이제 ProtectionProfileObserverImpl이 정의되었으므로 이를 사용하여 mip::ProtectionProfile을 인스턴스화합니다. 개체를 mip::ProtectionProfile 만들려면 .mip::ProtectionProfile::Settings

ProtectionProfile::Settings 매개 변수

std::shared_ptr<MipContext>: 애플리케이션 정보, 상태 경로 등을 저장하도록 초기화된 mip::MipContext 개체입니다.
mip::CacheStorageType: 메모리 내, 디스크 내 또는 디스크 내 및 암호화된 상태를 저장하는 방법을 정의합니다.
std::shared_ptr<mip::ConsentDelegate>: 클래스 mip::ConsentDelegate의 공유 포인터입니다.
std::shared_ptr<mip::ProtectionProfile::Observer> observer: 프로필 Observer 구현(in , 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);

ProtectionProfile::Settings profileSettings(
    mMipContext,                                        // mipContext object
    mip::CacheStorageType::InMemory,                   // use in memory storage    
    std::make_shared<ConsentDelegateImpl>(),           // new consent delegate
    std::make_shared<ProtectionProfileObserverImpl>()); // 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);

ProtectionProfile::Settings profileSettings(
    mMipContext,                                         // mipContext object
    mip::CacheStorageType::OnDisk,                      // use on disk storage    
    std::make_shared<ConsentDelegateImpl>(),            // new consent delegate
    std::make_shared<ProtectionProfileObserverImpl>()); // new protection profile

다음으로 promise/future 패턴을 사용하여 .ProtectionProfile

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

프로필을 로드했고 해당 작업이 성공한 ProtectionProfileObserverImpl::OnLoadSuccess경우 구현 mip::ProtectionProfile::Observer::OnLoadSuccess 이 호출됩니다. 결과 개체 또는 예외 포인터와 컨텍스트는 함수에 매개 변수로 전달됩니다. 컨텍스트는 비동기 작업을 처리하기 위해 std::promise 만든 포인터입니다. 이 함수는 프라미스 값을 ProtectionProfile 개체(컨텍스트)로 설정하기만 하면 됩니다. main 함수가 사용하는 Future.get()경우 결과를 새 개체에 저장할 수 있습니다.

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

함께 배치

관찰자 및 인증 대리자를 완전히 구현했으므로 이제 프로필을 완전히 로드할 수 있습니다. 아래 코드 조각에서는 필요한 모든 헤더가 이미 포함되어 있다고 가정합니다.

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

    ProtectionProfile::Settings profileSettings(
        mMipContext,                                    // mipContext object
        mip::CacheStorageType::OnDisk,                 // use on disk storage        
        std::make_shared<ConsentDelegateImpl>(),       // new consent delegate
        std::make_shared<ProfileObserver>());          // new protection profile observer

    auto profilePromise = std::make_shared<promise<shared_ptr<ProtectionProfile>>>();
    auto profileFuture = profilePromise->get_future();
    ProtectionProfile::LoadAsync(profileSettings, profilePromise);
    auto profile = profileFuture.get();
}

최종 결과는 프로필을 성공적으로 로드하고 호출 profile된 개체에 저장한 것입니다.

다음 단계

이제 프로필이 추가되었으므로 다음 단계는 프로필에 엔진을 추가하는 것입니다.

보호 엔진 개념

다음을 통해 공유