快速入門：列出敏感度標籤 （C#）

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

先決條件

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

新增邏輯以列出敏感度標籤

透過檔案引擎物件加入列出你組織敏感性標籤的邏輯。

  1. 開啟您在上一篇「快速入門：用戶端應用程式初始化（C#）》一文中建立的 Visual Studio 解決方案。

  2. 在方案總管中，打開專案中包含該方法實作Main()的 .cs 檔案。 它預設為包含它的專案同名，這個名稱是在您創建專案時指定的。

  3. 在 Main() 主體的結尾附近，也就是在 Main() 函式的應用程式關閉區段之前（也就是你在前一個快速入門中停下來的地方），插入下列程式碼：

// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

建置及測試應用程式

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

  1. 使用 CTRL-SHIFT-B （建置解決方案） 來建置用戶端應用程式。 如果沒有建置錯誤，就用 F5（開始除錯）來執行你的應用程式。

  2. 如果你的專案成功建置並執行，應用程式可能會在每次 SDK 呼叫你的 AcquireToken() 方法時，使用 Microsoft 驗證資源庫（MSAL）提示進行驗證。 如果已存在快取的認證資訊，系統不會提示您登入，且您會看到標籤清單。

    Visual Studio 取得令牌登入提示。

    • 你可能還需要同意讓應用程式在登入帳號下存取 MIP API。 當 Microsoft Entra 應用程式註冊未取得事先同意時（如「MIP SDK 設定和組態」中所述），或您使用其他租戶的帳戶登入，而非應用程式註冊所在的租戶，可能出現此情形。 選擇 「接受 」以記錄你的同意。

      Visual Studio 同意提示。

  3. 驗證之後，主控台輸出應該會顯示敏感度標籤，類似下列範例：

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

備註

複製並儲存一個或多個敏感度標籤的 ID（例如 f42a3342-8706-4288-bd31-ebb85995028z），因為你在下一個快速入門時會用到它。

故障排除

C# 應用程式執行期間的問題

總結 錯誤訊息 解決方法
不正確的存取令牌 發生例外狀況...存取令牌不正確/過期嗎？

API 呼叫失敗：profile_add_engine_async 失敗，錯誤如下：[class mip::PolicySyncException] 取得原則失敗，要求失敗，HTTP 狀態碼：401，x-ms-diagnostics: [2000001;reason="隨要求提交的 OAuth 權杖無法解析。";error_category="invalid_token"]，correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe （process 29924） 以代碼 0 結束。

按任意鍵關閉此視窗 。 . }		 如果你的專案成功建置，但輸出與左邊相似，表示你 AcquireOAuth2Token() 方法中的標記很可能無效或過期。 返回 建置並測試應用程式， 然後重新產生存取令牌、再次更新 AcquireOAuth2Token() 和重建/重新測試。 您也可以透過 jwt.ms 單頁網頁應用程式檢查並驗證該代幣及其聲明。
未設定敏感度標籤 n/a 如果你的專案成功建置，但主控台視窗中沒有輸出，請確保你組織的敏感度標籤設定正確。 詳情請參閱 MIP SDK 設定與設定，在「定義標籤分類法與保護設定」中。

下一步

既然你已經知道如何列出你組織的敏感性標籤，請試試下一個快速入門：

設定並取得敏感度標籤

  • Last updated on