快速入門：列出敏感度標籤 - Policy SDK（C++）

這個快速入門說明如何使用 MIP 政策 SDK 列出為組織設定的敏感度標籤。

先決條件

如果你還沒完成，請務必在繼續前完成以下先決條件：

加入邏輯來列出敏感度標籤

加入邏輯，使用政策引擎物件列出你組織的敏感性標籤。

  1. 打開你在上一組快速啟動中建立的 Visual Studio 解決方案。

  2. 在 main() 函式中，引擎成功載入後，加入以下程式碼：

    // List sensitivity labels
cout << "\nSensitivity labels for your organization:\n";
auto labels = engine->ListSensitivityLabels();
for (const auto& label : labels)
{
    cout << label->GetName() << " : " << label->GetId() << endl;

    for (const auto& child : label->GetChildren())
    {
        cout << "->  " << child->GetName() << " : " << child->GetId() << endl;
    }
}

  3. 可選擇依內容格式過濾標籤（例如， "email" 或 "file"）：

    // List labels for email content only
std::vector<std::string> contentFormats = { "email" };
auto emailLabels = engine->ListSensitivityLabels(contentFormats);

組建和測試應用程式

建立並測試你的客戶應用程式。

  1. 使用 Ctrl+Shift+B （建置解決方案）來建立應用程式。 如果沒有建置錯誤，就用 F5 （開始除錯）來執行。

  2. 第一次執行時，應用程式會提示驗證。 在你的租戶中提供使用者帳號的憑證。

  3. 輸出應該會顯示你組織所設定的敏感性標籤，類似：

    Sensitivity labels for your organization:
Public : <label-id>
General : <label-id>
->  Anyone (unrestricted) : <label-id>
Confidential : <label-id>
->  All Employees : <label-id>
->  Recipients Only : <label-id>
Highly Confidential : <label-id>
->  All Employees : <label-id>
->  Recipients Only : <label-id>

檢查標籤行為

你也可以查詢標籤保護類型的資訊，以判斷每個標籤的行為。 從 MIP SDK 1.18 開始，該 Label 類別提供檢查保護類型的方法：

for (const auto& label : labels)
{
    cout << label->GetName();
    
    if (label->HasDoNotForwardProtection())
        cout << " [Do Not Forward]";
    else if (label->HasEncryptOnlyProtection())
        cout << " [Encrypt Only]";
    else if (label->HasAdhocProtection())
        cout << " [Custom Protection]";
    
    cout << endl;
}

下一步

  • Last updated on