快速入门：列出敏感度标签 (C#)

项目
01/30/2024

本快速入门介绍如何使用 MIP 文件 SDK 列出为组织配置的敏感度标签。

先决条件

如果尚未完成，请确保先完成以下先决条件，然后再继续：

首先完成快速入门：客户端应用程序初始化 (C#)，构建一个入门级 Visual Studio 解决方案。此“列出敏感度标签”快速入门依赖于上一个快速入门，用于正确创建入门解决方案。
可选：查看分类标签概念。

添加逻辑以列出敏感度标签

使用文件引擎对象添加逻辑以列出组织的敏感度标签。

打开你在前文“快速入门：客户端应用程序初始化 (C#)”中创建的 Visual Studio 解决方案。
使用“解决方案资源管理器”，打开项目中包含 Main() 方法实现的 .cs 文件。该文件默认与包含它的项目同名，该名称在项目创建期间指定。
在 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));
        }
    }
}

生成并测试应用

最后，生成和测试客户端应用程序。

使用 CTRL-SHIFT-B（生成解决方案）生成客户端应用程序。如果没有生成错误，请使用 F5（启动调试）运行应用程序。
如果项目成功生成并运行，则应用程序可能在 SDK 每次调用 AcquireToken() 方法时都会提示使用 Microsoft 身份验证库 (MSAL) 进行身份验证。如果缓存的凭据已存在，系统不会提示你登录并查看标签列表。
- 可能还需要同意，以允许应用程序在登录帐户下运行时访问 MIP API。如果未预先同意 Microsoft Entra 应用程序注册（如“MIP SDK 安装和配置”中所述），或者使用来自不同租户的帐户（注册应用程序的帐户除外），则会发生这种情况。只需单击“接受”即可记录同意。
身份验证后，控制台输出应显示敏感度标签，类似于以下示例：

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:[35bc0023-3727-4eff-8062-000006d5d672]' C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe（进程 29924）已退出，代码为 0。按任意键关闭此窗口。。 .	如果项目成功生成，但你看到与左侧类似的输出，则 `AcquireOAuth2Token()` 方法中可能有一个无效或过期的令牌。返回到生成和测试应用程序并重新生成访问令牌，再次更新 `AcquireOAuth2Token()`，然后重新生成/重新测试。还可以使用 jwt.ms 单页 Web 应用检查和验证令牌及其声明。
未配置敏感度标签	不适用	如果项目成功生成，但控制台窗口中没有输出，请确保组织的敏感度标签配置正确。有关详细信息，请参阅“定义标签分类和保护设置”下的 MIP SDK 安装和配置。

后续步骤

现在你已经了解了如何为组织列出敏感度标签，请尝试下一个快速入门：

设置和获取敏感度标签