快速入门:列出模板(C#)

本快速入门介绍如何使用 MIP 保护 SDK 列出可供用户使用的保护模板。

先决条件

在继续操作之前,请完成以下先决条件:

添加逻辑以列出保护模板

使用保护引擎对象添加逻辑以列出用户可用的保护模板。

  1. 打开在上一篇“快速入门 - 客户端应用程序初始化 - 保护 SDK (C#)”一文中创建的 Visual Studio 解决方案。

  2. 在解决方案资源管理器中,打开项目中包含方法实现Main()的.cs文件。 它默认与其所在项目同名,这是您在创建项目时指定的。

  3. 在 Main() 主体接近末尾处、Main() 函数的应用程序关闭部分上方(也就是你在上一个快速入门中结束的位置),插入以下代码:

// List protection templates using protectionEngine and display the list

var templates=protectionEngine.GetTemplates();

for(int i = 0; i < templates.Count; i++)
{
    Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}

Console.WriteLine("Press a key to continue...");

生成并测试应用

生成并测试客户端应用程序。

  1. 使用 Ctrl+Shift+B(生成解决方案)生成客户端应用程序。 如果生成没有错误,请使用 F5(开始调试)来运行应用程序。

  2. 如果你的项目成功生成并运行,则每次 SDK 调用你的 方法时,应用程序AcquireToken()会使用 MSAL 提示进行身份验证。 如果缓存的凭据已存在,则不会提示你登录并查看标签列表。

    Visual Studio获取令牌登录。

    • 你可能还需要同意允许应用程序在登录帐户下运行时访问 MIP API。 当Microsoft Entra 应用程序注册未经预许可(如“MIP SDK 设置和配置”中所述),或者使用不同租户的帐户登录(而不是注册应用程序的帐户)时,就会发生这种情况。 选择 “接受” 以记录同意。

      Visual Studio同意。

  3. 身份验证后,控制台输出应显示经过身份验证的用户的保护模板,类似于以下示例:

0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.

注释

复制并保存一个或多个保护模板的 ID(例如 bb7ed207-046a-4caf-9826-647cff56b990),以便在下一个快速入门中使用。

故障排除

执行 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 应用程序检查和验证令牌及其声明。

后续步骤

了解如何列出可供经过身份验证的用户使用的保护模板后,请尝试下一个快速入门: