快速入門：設定並取得敏感度標籤（C++）

本快速入門說明如何使用更多 MIP 檔案 SDK。 使用您在上一個快速入門中列出的其中一個敏感度標籤，您可以使用檔案處理程式來設定/取得檔案上的標籤。 File handler 類別會針對支援的檔類型，公開設定/取得標籤或保護的各種作業。

先決條件

如果您尚未完成，請務必先完成下列必要條件，再繼續進行：

• 完成 快速入門：先列出敏感度標籤（C++）， 以建置入門Visual Studio解決方案，以列出組織的敏感度標籤。 本「設定並取得敏感度標籤」快速入門是以「上述快速入門」為基礎。
• 選擇性：檢閱 MIP SDK 概念中的檔案處理程式 。

實作觀察者類別來監視 File 處理程式物件

類似於您在應用程式初始化快速入門中實作的觀察者（針對檔案配置檔和引擎），現在您會為 File 處理程式物件實作觀察者類別。

藉由擴充 SDK 的 mip::FileHandler::Observer 類別，為檔案處理器監視器建立基本實作。 觀察者會具現化及稍後使用，以監視檔案處理程序作業。

1. 開啟您在上一篇「快速入門：列出敏感度標籤（C++）》一文中處理過的 Visual Studio 解決方案。

2. 將新類別新增至您的專案，這會為您產生標頭/.h 和實作/.cpp檔案：

   • 在 方案總管中，再次以滑鼠右鍵按兩下項目節點，選取 [ 新增]，然後選取 [ 類別]。
   • 在 [ 新增類別 ] 對話框中：
     • 在 [ 類別名稱] 欄位中，輸入 「filehandler_observer」。 請注意，根據您輸入的名稱，會自動填入 .h 檔案 和 .cpp檔案 欄位。
     • 完成後，按兩下 [ 確定] 按鈕。

3. 產生 類別的 .h 和 .cpp 檔案之後，這兩個檔案都會在 [編輯器群組] 索引卷標中開啟。 現在更新每個檔案以實作新的觀察者類別：

   • 選取/刪除產生的 filehandler_observer 類別，以更新 “filehandler_observer.h”。 請勿 移除上一個步驟所產生的預處理器指示詞（#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 類別實作，以更新 “filehandler_observer.cpp”。 請勿 移除上一個步驟所產生的預處理器指示詞（#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);
     }
     

4. 您可以選擇性地使用 F6 （建置方案） 來執行解決方案的測試編譯/連結，以確保它成功建置，然後再繼續。

新增邏輯以設定並取得敏感度標籤

使用檔案引擎物件，新增邏輯以在檔案上設定並取得敏感度標籤。

1. 使用 方案總管，在您的項目中開啟包含 方法實作 main() 的 .cpp 檔案。 預設名稱為包含它的專案的同一名稱，而這是在您建立專案時指定的。

2. 在檔案頂端的對應現有指示詞下方，新增下列 #include 和 using 指示詞：

   #include "filehandler_observer.h" 
   #include "mip/file/file_handler.h" 
   
   using mip::FileHandler;
   

3. 在 main() 主體的末尾，位於 system("pause"); 下方和 return 0; 上方 （這是您在上一個快速入門中所停留的位置），插入下列代碼：

   // 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 " << filePathIn << endl;
        mip::LabelingOptions labelingOptions(mip::AssignmentMethod::PRIVILEGED);
        handler->SetLabel(engine->GetLabelById(labelId), labelingOptions, new 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");
   

4. 請在 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;
   

5. 使用字串常數來取代如下所示的原始碼中的佔位元值：

   佔位符	價值
   <輸入檔案路徑>	測試輸入檔的完整路徑，例如： "c:\\Test\\Test.docx"。
   <內容識別碼>	內容的人類可讀識別碼。 例如： 針對檔案，請使用 path\filename： "c:\Test\Test.docx" 針對電子郵件，請考慮subject：sender ： "RE: Audit design:user1@contoso.com"
   <標籤識別碼>	例如：從上一個快速入門的控制台輸出中複製的敏感度標籤識別碼："f42a3342-8706-4288-bd31-ebb85995028z"。
   <輸出檔案路徑>	輸出檔案的完整路徑，這會是輸入檔的標籤複本，例如： "c:\\Test\\Test_labeled.docx"。

建置及測試應用程式

建置及測試客戶端應用程式。

1. 使用 F6 （建置解決方案） 來建置用戶端應用程式。 如果您沒有建置錯誤，請使用 F5 （開始偵錯） 來執行應用程式。

2. 如果您的專案建置並成功執行，應用程式會在每次 SDK 呼叫您的 AcquireOAuth2Token() 方法時，提示輸入存取令牌。 如同您之前在「列出機密性標籤」快速入門指南中所做的，請執行 PowerShell 腳本，使用提供的 $authority 和 $resourceUrl 值來每次取得令牌。

   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 . . .
   

您可以開啟輸出檔案，並以可視化方式檢查檔案的信息保護設定，來驗證標籤的應用程式。