共用方式為


快速入門:列出敏感度標籤 (C#)

本快速入門說明如何使用 MIP 檔案 SDK 列出為組織設定的敏感度標籤。

先決條件

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

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

使用檔案引擎物件新增邏輯來列出組織的敏感度標籤。

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

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

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

備註

複製並儲存一或多個敏感度標籤的標識碼(例如,f42a3342-8706-4288-bd31-ebb85995028z),因為您會在下一個快速入門中使用它。

故障排除

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

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

失敗的 API 呼叫:profile_add_engine_async 失敗,發生:[類別 mip::PolicySyncException] 原則取得失敗,請求失敗,HTTP 狀態代碼為 401,x-ms-diagnostics:[2000001;reason="與請求一起提交的 OAuth 令牌無法解析。";error_category="invalid_token"],correlationId:[35bc0023-3727-4eff-8062-000006d5d672]

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

按任意鍵關閉此視窗 。 . .
如果您的專案建置成功,但看到輸出類似於左邊顯示的內容,則您在程式方法中可能有無效或已過期的令牌。 返回 建置並測試應用程式, 然後重新產生存取令牌、再次更新 AcquireOAuth2Token() 和重建/重新測試。 您也可以使用 jwt.ms 單頁 Web 應用程式,檢查並驗證令牌及其宣告。
未設定敏感度標籤 n/a 如果您的專案建置成功,但在控制台視窗中沒有輸出,請確定組織的敏感度標籤已正確設定。 如需詳細資訊,請參閱「定義標籤分類和保護設定」底下的 MIP SDK 設定和設定。

後續步驟

既然您已瞭解如何列出組織的敏感度標籤,請嘗試下一個快速入門: