大网数据广告活动
域与目录服务

AD FS MSAL Web 应用 (服务器应用) 调用 web Api

· 52CE 我爱测

了解如何生成通过 AD FS 2019 进行身份验证的 web 应用登录用户。

适用于: AD FS 2019 及更高版本

了解如何生成通过 AD FS 2019 进行身份验证的 web 应用登录,并使用 MSAL 库 来调用 web api。

阅读本文之前,应熟悉 AD FS 概念 和 授权代码授予流

概述

Web 应用调用 web api 概述

在此流中,你将向 Web 应用添加身份验证 (Server 应用) ,从而可以登录用户和调用 Web API。 从 Web 应用调用 Web API,并使用 MSAL 的 AcquireTokenByAuthorizationCode 令牌采集方法。 可使用授权代码流,在令牌缓存中存储获取的令牌。 然后,控制器在需要时将以无提示方式从缓存中获取令牌。 MSAL 根据需要刷新该令牌。

用于调用 Web Api 的 web 应用:

  • 是机密客户端应用程序。
  • 这就是他们使用 AD FS 注册了机密 (应用程序共享密钥、证书或 AD 帐户) 的原因。 在对 AD FS 的调用期间,会传入此机密,以获取令牌。

为了更好地了解如何在 ADFS 中注册 Web 应用并将其配置为获取令牌来调用 Web API,我们使用 此处 提供的示例并演练应用注册和代码配置步骤。

先决条件

  • GitHub 客户端工具
  • AD FS 2019 或更高版本配置并运行
  • Visual Studio 2013 或更高版本

AD FS 中的应用注册

本部分说明如何将 Web 应用注册为机密客户端和 Web API,作为 AD FS 中 (RP) 的信赖方。

  1. 在 AD FS 管理 "中,右键单击" 应用程序组 ",然后选择" 添加应用程序组"。

  2. 在应用程序组向导上,为 " 输入 WebAppToWebApi ",在 " 客户端-服务器应用程序 " 下选择用于 访问 Web API 模板的服务器应用程序 。 单击“下一步” 。

    "添加应用程序组向导" 的 "欢迎使用" 页的屏幕截图,其中突出显示了访问 web 的服务器应用程序。

  3. 复制 " 客户端标识符 " 值。 它稍后将用作应用程序 Web.config 文件中的 ida: ClientId 的值。 对于 "重定向 URI",请输入以下内容: - https://localhost:44326 。 单击“添加”。 单击“下一步” 。

    "添加应用程序组向导" 的 "服务器应用程序" 页的屏幕截图,显示正确的客户端标识符和重定向 U R I。

  4. 在 "配置应用程序凭据" 屏幕上,选中 " 生成共享机密 并复制机密"。 此值稍后将用作应用程序 Web.config 文件中的 ida: ClientSecret 的值。 单击“下一步” 。

    "添加应用程序组" 向导的 "配置应用程序凭据应用程序" 页的屏幕截图,其中显示了 "生成共享机密" 选项,并填充了生成的共享机密。

  5. 在 "配置 Web API" 屏幕上,输入 标识符: https://webapi 。 单击 “添加” 。 单击“下一步” 。 此值稍后将用于应用程序 Web.config 文件中的 ida: GraphResourceId 。

    "添加应用程序组" 向导的 "配置 Web API" 页的屏幕截图,其中显示了正确的标识符。

  6. 在 "应用访问控制策略" 屏幕上,选择 " 允许 每个人" 并单击 " 下一步"

    "添加应用程序组向导" 的 "选择访问控制策略" 页的屏幕截图,显示突出显示 "允许所有人" 选项。

  7. 在 "配置应用程序权限" 屏幕上,确保已选中 " openid and user_impersonation ",然后单击 " 下一步"。

    "添加应用程序组" 向导的 "配置应用程序权限" 页的屏幕截图,其中显示了 "打开 I D" 和 "用户模拟" 选项。

  8. 在 "摘要" 屏幕上,单击 " 下一步"。

  9. 在 "完成" 屏幕上,单击 " 关闭"。

代码配置

本部分介绍如何将 ASP.NET Web 应用配置为登录用户和检索令牌,以调用 Web API

  1. 从此处下载示例

  2. 使用 Visual Studio 打开示例

  3. 打开 web.config 文件。 修改以下内容:

    • ida: ClientId-在上 AD FS 部分的 "应用注册 #3 中输入 客户端标识符 值。

    • ida: ClientSecret-在上面 AD FS 部分的 "应用注册" 中输入 #4 的 机密 值。

    • ida: RedirectUri-在上述 AD FS 部分中,输入 "应用注册 #3 中的" 重定向 URI "值。

    • ida:颁发机构-输入 https://[你的 AD FS 主机名]/adfs。 例如 https://adfs.contoso.com/adfs

    • ida:资源-在上述 AD FS 部分的 "应用注册 #5 中输入 标识符 值。

      显示修改后的值的 web 配置文件的屏幕截图。

测试示例

本部分介绍如何测试上面配置的示例。

  1. 更改代码后,重新生成解决方案

  2. 在 Visual Studio 顶部,请确保已选择 "Internet Explorer",并单击绿色箭头。

    Visual Studio UI 的屏幕截图,其中包含 IIS Express (Internet Explorer) 选项。

  3. 在主页上,单击 "登录"。

    "主页" 页的屏幕截图,其中的 "登录" 选项称为 "out"。

  4. 你将被重定向到 AD FS 登录页。 继续登录。

    登录页的屏幕截图。

  5. 登录后,单击 "访问令牌"。

    带有调用的访问令牌选项的主页屏幕截图。

  6. 单击 "访问令牌" 将通过调用 Web API 获取访问令牌信息。

    显示访问令牌信息的访问令牌页的屏幕截图。

后续步骤

AD FS OpenID Connect/OAuth 流和应用程序方案

历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Windows Server 中文文档历史快照
适用范围
历史中文快照 2021-03-23;详见原文产品版本;文档日期 08/09/2019
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。