让用户通过本地代理登录(预览版)

本地代理在终结点设备上运行,无法安全地存储客户端机密或证书。 将其配置为 OAuth 公共客户端,并使用带有代码 Exchange 的证明密钥(PKCE)的授权代码流。

用户通过浏览器登录。 代理在其已注册的重定向 URI 处接收授权代码,并在没有客户端凭据的情况下兑换代码。

Important

本地代理身份验证以预览版提供。 此预览版在没有服务级别协议的情况下提供,不建议用于生产工作负荷。 某些功能可能不受支持或功能受限。 有关详细信息,请参阅 联机服务的通用许可条款。

Prerequisites

需要一个Microsoft Entra租户,可在其中注册代理 ID 或支持客户端 ID 元数据文档(CIMD)的租户。

选择客户端 ID

选项 客户端 ID 何时使用
在 Microsoft Entra 中注册代理 ID 由Microsoft Entra分配的客户端 ID 当知道代理连接到Microsoft Entra时,建议使用此项。
使用 CIMD 客户端元数据文档的公共 HTTPS URL 当同一分布式客户端连接到独立操作的授权服务器和预注册是不可行的时使用。

尽可能首选已注册的代理 ID。 有关 CIMD 的详细信息,请参阅 Microsoft Entra ID 中的客户端 ID 元数据文档。

注册代理 ID

  1. 创建单实例蓝图并预配其代理 ID。 创建蓝图时选择实例模式;之后无法更改它。
  2. 在蓝图的 publicClient 平台下添加身份验证库推荐的重定向 URI。
  3. 记录代理 ID 的客户端 ID 和租户 ID。

每个安装都使用相同的客户端 ID。 不要为每个设备创建单独的代理 ID,也不会为此流添加客户端机密、证书或联合标识凭据。

有关重定向 URI 选项,请参阅 调用 Web API 的桌面应用:代码配置。

使用 MSAL.NET 登录

安装 MSAL.NET:

dotnet add package Microsoft.Identity.Client

创建公共客户端应用程序:

using Microsoft.Identity.Client;

var app = PublicClientApplicationBuilder
    .Create("<agent-client-id>")
    .WithAuthority("https://login.microsoftonline.com/<tenant-id>")
    .WithDefaultRedirectUri()
    .Build();

在不请求 API 的委派权限的情况下登录用户:

var result = await app
    .AcquireTokenInteractive(Array.Empty<string>())
    .ExecuteAsync();

Console.WriteLine($"Signed in as {result.Account.Username}");

AcquireTokenInteractive 没有无参数重载。 如果代理只需让用户登录,则传递空范围集合。 MSAL 添加了登录所需的保留 OpenID Connect 范围,但它不会请求 API 的委托范围。

MSAL 打开系统浏览器,使用 PKCE,验证响应并缓存帐户。 对已注册的代理 ID 使用特定于租户的授权机构。 不要使用帐户名或 ID 令牌来授权访问 API。 在下一步中请求 API 的委托范围。

使用 CIMD 客户端进行委派的 API 访问(预览版)

使用 CIMD URL 作为支持 URL 值客户端 ID 的 OAuth 库中的客户端 ID。 库必须使用 PKCE 的授权代码流,并且不能在兑换代码时发送客户端凭据。

CIMD 不支持用户登录的 ID 令牌。 此分支使用浏览器身份验证来获取委派的 API 访问权限,而不是前面显示的仅登录 MSAL.NET 结果。 按照 CIMD 配置过程请求资源的委派作用域。

有关元数据和重定向 URI 要求,请参阅 使用客户端 ID 元数据文档配置客户端。

后续步骤

以已登录用户身份调用 API。