빠른 시작: 민감도 레이블 설정 및 가져오기(C++)

이 빠른 시작에서는 MIP 파일 SDK를 더 많이 사용하는 방법을 보여 줍니다. 이전 빠른 시작에서 나열한 민감도 레이블 중 하나를 사용하여 파일 처리기를 사용하여 파일에 레이블을 설정하고 가져옵니다. 파일 처리기 클래스는 지원되는 파일 형식에 대한 레이블 설정 및 가져오기 또는 보호를 위한 다양한 작업을 노출합니다.

사전 요구 사항

아직 완료하지 않은 경우 계속하기 전에 다음 필수 조건을 완료해야 합니다.

빠른 시작: 민감도 레이블 나열(C++). 먼저 이 빠른 시작을 완료합니다. 조직의 민감도 레이블을 나열하는 시작 Visual Studio 솔루션을 빌드합니다. 이 "민감도 레이블 설정 및 가져오기" 빠른 시작은 이전 항목에서 빌드됩니다.
선택 사항: MIP SDK 개념에서 파일 처리기를 검토합니다.

관찰자 클래스를 구현하여 파일 처리기 개체 모니터링

애플리케이션 초기화 빠른 시작에서 파일 프로필 및 엔진에 대해 구현한 관찰자와 마찬가지로 이제 파일 처리기 개체에 대한 관찰자 클래스를 구현합니다.

SDK의 클래스를 확장하여 파일 처리기 관찰자에 대한 기본 구현을 mip::FileHandler::Observer 만듭니다. 애플리케이션은 관찰자를 인스턴스화하고 나중에 파일 처리기 작업을 모니터링하는 데 사용합니다.

이전 "빠른 시작: 민감도 레이블 나열(C++)" 문서에서 작업한 Visual Studio 솔루션을 엽니다.
프로젝트에 새 클래스를 추가합니다. Visual Studio 헤더/.h 및 구현/.cpp 파일을 모두 생성합니다.
- 솔루션 탐색기에서 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭하고 추가를 선택한 다음 클래스를 선택합니다.
- 클래스 추가 대화 상자에서 다음을 수행합니다.
  - 클래스 이름 필드에 "filehandler_observer"를 입력합니다. 입력한 이름에 따라 .h 파일 과 .cpp 파일 필드가 모두 자동으로 채워집니다.
  - 작업을 마쳤으면 확인을 선택합니다.

Visual Studio 클래스에 대한 .h 및 .cpp 파일을 생성하면 두 파일이 모두 편집기 탭에서 열립니다. 새 관찰자 클래스를 구현하도록 각 파일을 업데이트합니다.

생성된 클래스를 선택/삭제하여 "filehandler_observer.h"를 filehandler_observer 업데이트합니다. 이전 단계(#pragma, #include)에서 생성된 전처리기 지시문을 제거하지 마세요. 그런 다음, 기존 전처리기 지시문 다음에 다음 소스를 복사하여 파일에 붙여넣습니다.

#include <memory>
#include "mip/file/file_engine.h"
#include "mip/file/file_handler.h"

class FileHandlerObserver final : public mip::FileHandler::Observer {
public:
   FileHandlerObserver() { }
   // Observer implementation
   void OnCreateFileHandlerSuccess(const std::shared_ptr<mip::FileHandler>& fileHandler, const std::shared_ptr<void>& context) override;
   void OnCreateFileHandlerFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;
   void OnCommitSuccess(bool committed, const std::shared_ptr<void>& context) override;
   void OnCommitFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;		
};

생성된 클래스 구현을 선택/삭제하여 "filehandler_observer.cpp"를 filehandler_observer 업데이트합니다. 이전 단계(#pragma, #include)에서 생성된 전처리기 지시문을 제거하지 마세요. 그런 다음, 기존 전처리기 지시문 다음에 다음 소스를 복사하여 파일에 붙여넣습니다.

void FileHandlerObserver::OnCreateFileHandlerSuccess(const std::shared_ptr<mip::FileHandler>& fileHandler, const std::shared_ptr<void>& context) {
   auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::FileHandler>>>(context);
   promise->set_value(fileHandler);
}

void FileHandlerObserver::OnCreateFileHandlerFailure(const std::exception_ptr & error, const std::shared_ptr<void>& context) {
   auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::FileHandler>>>(context);
   promise->set_exception(error);
}

void FileHandlerObserver::OnCommitSuccess(bool committed, const std::shared_ptr<void>& context) {
   auto promise = std::static_pointer_cast<std::promise<bool>>(context);
   promise->set_value(committed);
}

void FileHandlerObserver::OnCommitFailure(const std::exception_ptr & error, const std::shared_ptr<void>& context) {
   auto promise = std::static_pointer_cast<std::promise<bool>>(context);
   promise->set_exception(error);
}

필요에 따라 F6(빌드 솔루션)을 사용하여 솔루션의 테스트 컴파일/링크를 실행하고 계속하기 전에 성공적으로 빌드되었는지 확인합니다.

민감도 레이블을 설정하고 가져오는 논리 추가

파일 엔진 개체를 사용하여 파일에 민감도 레이블을 설정하고 가져오는 논리를 추가합니다.

솔루션 탐색기 메서드 구현이 포함된 main() 프로젝트에서 .cpp 파일을 엽니다. 기본 이름은 프로젝트 생성 시 지정한 이름을 포함한 프로젝트와 동일합니다.
파일 맨 위에 있는 해당 기존 지시문 다음에 다음 #include 및 using 지시문을 추가합니다.
```
#include "filehandler_observer.h" 
#include "mip/file/file_handler.h" 

using mip::FileHandler;
```

본문의 끝부분에서, 이전 빠른 시작에서 중단한 지점인 system("pause"); 뒤와 return 0; 앞 사이의 main() 위치에 다음 코드를 삽입하세요.

// Set up async FileHandler for input file operations
string inputFilePath = "<input-file-path>";
string actualFilePath = "<content-identifier>";
std::shared_ptr<FileHandler> handler;
try
{
     auto handlerPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
     auto handlerFuture = handlerPromise->get_future();
     engine->CreateFileHandlerAsync(
          inputFilePath,
          actualFilePath,                       
          true, 
          std::make_shared<FileHandlerObserver>(), 
          handlerPromise);
     handler = handlerFuture.get();
}
catch (const std::exception& e)
{
     cout << "An exception occurred... did you specify a valid input file path?\n\n" << e.what() << "'\n";
     system("pause");
     return 1;
}

// Set a label on input file
try
{
     string labelId = "<label-id>";
     cout << "\nApplying Label ID " << labelId << " to " << inputFilePath << endl;
     mip::LabelingOptions labelingOptions(mip::AssignmentMethod::PRIVILEGED);
     handler->SetLabel(engine->GetLabelById(labelId), labelingOptions, mip::ProtectionSettings());
}
catch (const std::exception& e)
{
     cout << "An exception occurred... did you specify a valid label ID?\n\n" << e.what() << "'\n";
     system("pause");
     return 1; 
}

// Commit changes, save as a different/output file
string filePathOut = "<output-file-path>";
try
{
 	cout << "Committing changes" << endl;
     auto commitPromise = std::make_shared<std::promise<bool>>();
     auto commitFuture = commitPromise->get_future();
     handler->CommitAsync(filePathOut, commitPromise);
 	if (commitFuture.get()) {
 		cout << "\nLabel committed to file: " << filePathOut << endl;
 	}
 	else {
 		cout << "Failed to label: " + filePathOut << endl;
 		return 1;
 	}
}
catch (const std::exception& e)
{
     cout << "An exception occurred... did you specify a valid commit file path?\n\n" << e.what() << "'\n";
     system("pause");
     return 1;
}
system("pause");

// Set up async FileHandler for output file operations
actualFilePath = "<content-identifier>";
try
{
     auto handlerPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
     auto handlerFuture = handlerPromise->get_future();
     engine->CreateFileHandlerAsync(
          filePathOut,
          actualFilePath,
          true,
          std::make_shared<FileHandlerObserver>(),
          handlerPromise);

     handler = handlerFuture.get();
}
catch (const std::exception& e)
{
     cout << "An exception occurred... did you specify a valid output file path?\n\n" << e.what() << "'\n";
     system("pause");
     return 1;
}

// Get the label from output file
try
{
     cout << "\nGetting the label committed to file: " << filePathOut << endl;
     auto label = handler->GetLabel();
     cout << "Name: " + label->GetLabel()->GetName() << endl;
     cout << "Id: " + label->GetLabel()->GetId() << endl;
}
catch (const std::exception& e)
{
     cout << "An exception occurred... did you specify a valid label ID?\n\n" << e.what() << "'\n";
     system("pause");
     return 1;
}
system("pause");

main()의 끝부분에서 첫 번째 빠른 시작에서 생성한 애플리케이션 종료 블록을 찾아 핸들러 줄의 주석을 해제합니다.

// Application shutdown. Null out profile and engine, call ReleaseAllResources();
// Application may crash at shutdown if resources aren't properly released.
profile = nullptr;
engine = nullptr;
handler = nullptr;
mipContext = nullptr;

문자열 상수로 소스 코드의 자리 표시자 값을 다음과 같이 바꿉니다.

Placeholder	가치
<input-file-path (입력 파일 경로)>	테스트 입력 파일의 전체 경로(예: `"c:\\Test\\Test.docx"`.
<콘텐츠 식별자>	콘텐츠에 대한 사람이 읽을 수 있는 식별자입니다. 예를 들어: 파일의 경우 path\filename을 사용합니다. `"c:\Test\Test.docx"` 전자 메일의 경우 subject:sender를 사용합니다. `"RE: Audit design:user1@contoso.com"`
<label-id>	이전 빠른 시작의 콘솔 출력에서 복사한 민감도 레이블 ID입니다. 예를 들면 다음과 `"f42a3342-8706-4288-bd31-ebb85995028z"`같습니다.
<출력 파일 경로>	입력 파일의 레이블이 지정된 복사본인 출력 파일의 전체 경로입니다. 예를 들면 다음과 `"c:\\Test\\Test_labeled.docx"`같습니다.

응용 프로그램 구축 및 테스트

클라이언트 애플리케이션을 빌드하고 테스트합니다.

F6(솔루션 빌드)을 사용하여 클라이언트 애플리케이션을 빌드합니다. 빌드에 오류가 없는 경우 F5(디버깅 시작)를 사용하여 애플리케이션을 실행합니다.

프로젝트가 성공적으로 빌드되고 실행되면 애플리케이션은 SDK가 메서드를 호출할 때마다 액세스 토큰을 묻는 메시지를 표시합니다 AcquireOAuth2Token() . 이전에 "민감도 레이블 나열" 빠른 시작에서 했던 것처럼, $authority 및 $resourceUrl에 제공된 값을 사용하여 매번 토큰을 획득하도록 PowerShell 스크립트를 실행하세요.

Run the PowerShell script to generate an access token using the following values, then copy/paste it below:

Sensitivity labels for your organization:
Non-Business : 87ba5c36-17cf-14793-bbc2-bd5b3a9f95cz
Public : 83867195-f2b8-2ac2-b0b6-6bb73cb33afz
General : f42a3342-8706-4288-bd31-ebb85995028z
Confidential : 074e457c-5848-4542-9a6f-34a182080e7z
Highly Confidential : f55c2dea-db0f-47cd-8520-a52e1590fb6z
Press any key to continue . . .

Applying Label ID 074e457c-5848-4542-9a6f-34a182080e7z to c:\Test\Test.docx
Committing changes

Label committed to file: c:\Test\Test_labeled.docx
Press any key to continue . . .

Getting the label committed to file: c:\Test\Test_labeled.docx
Name: Confidential
Id: 074e457c-5848-4542-9a6f-34a182080e7z
Press any key to continue . . .

출력 파일을 열고 문서의 정보 보호 설정을 시각적으로 검사하여 레이블 애플리케이션을 확인합니다.

메모

Office 문서에 레이블을 지정하지만 액세스 토큰을 발급한 Microsoft Entra 테넌트의 계정을 사용하여 로그인하지 않은 경우(및 민감도 레이블이 구성됨) 레이블이 지정된 문서를 열기 전에 로그인하라는 메시지가 표시될 수 있습니다.

다음 단계

MIP 파일 SDK C++ 샘플

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-09-21