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

AD FS MSAL 本机应用调用 Web API

· 52CE 我爱测

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

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

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

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

概述

概述

在此流中,会将身份验证添加到本机应用 (公共客户端) ,从而使用户登录并调用 Web API。 若要从登录用户的本机应用程序调用 Web API,可以使用 MSAL 的 AcquireTokenInteractive 标记获取方法。 为了实现这种交互,MSAL 利用了 Web 浏览器。

为了更好地了解如何在 ADFS 中配置本机应用以交互方式获取访问令牌,让我们使用 此处 提供的示例并演练应用注册和代码配置步骤。

先决条件

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

AD FS 中的应用注册

本部分演示如何将本机应用作为公共客户端和 Web API 注册为依赖方 (RP) 在 AD FS

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

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

    "添加应用程序组向导" 的 "欢迎使用" 页的屏幕截图,其中突出显示了访问 Web API 模板的本机应用程序。

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

    "添加应用程序组向导" 的 "本机应用程序" 页的屏幕截图,显示 "重定向 U R I"。

  4. 在 "配置 Web API" 屏幕上,输入 标识符: https://localhost:44321/ 。 单击 “添加” 。 单击“下一步” 。 稍后将在应用程序的 App.config 和 Web.config 文件中使用此值。

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

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

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

  6. 在 "配置应用程序权限" 屏幕上,确保已选中 " openid " 并单击 " 下一步"。

    "添加应用程序组" 向导的 "配置应用程序权限" 页的屏幕截图,其中显示了 "已选择"

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

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

  9. 在 AD FS 管理 "中,单击" 应用程序组 ",并选择" NativeAppToWebApi 应用程序组 "。 右键单击并选择 “属性”。

    显示突出显示 "NativeAppToWebApi" 组的 "D F S 管理" 对话框的屏幕截图,并显示下拉列表中的 "属性" 选项。

  10. 在 NativeAppToWebApi 的 "属性" 屏幕上,选择 " NativeAppToWebApi – WEB api " ,然后单击"编辑 ... "

    显示 "NativeAppToWebApi 属性" 对话框的屏幕截图,其中突出显示了 P I 应用程序 NativeAppToWebApi。

  11. 在 NativeAppToWebApi – Web API 属性屏幕上,选择 "颁发转换规则" 选项卡,然后单击 "添加规则 ... "

    显示 "颁发转换规则" 选项卡的 "NativeAppToWebApi-Web A P I 属性" 对话框的屏幕截图。

  12. 在 "添加转换声明规则向导" 上,从 "声明规则模板" 下拉列表选择 "转换传入声明",然后单击 "下一步"。

    "添加转换声明规则向导" 的 "选择规则模板" 页的屏幕截图,其中显示了 "转换传入声明" 选项。

  13. 在 "声明规则名称: " 字段中输入 NameID 。 为 传入声明类型 选择 名称:、传出声明类型 的 名称 ID 和 传出名称 ID 格式 的 公用名:。 单击 " 完成"。

    "添加转换声明规则" 向导的 "配置规则" 页的屏幕截图,其中显示了上面所述的配置。

  14. 单击 "NativeAppToWebApi – Web API 属性" 屏幕上的 "确定",然后单击 "NativeAppToWebApi 属性" 屏幕。

代码配置

本部分演示如何将本机应用配置为登录用户和检索令牌,以调用 Web API

  1. 从此处下载示例

  2. 使用 Visual Studio 打开示例

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

    • ida:颁发机构-输入 https://[your AD FS hostname]/adfs

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

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

    • todo: TodoListResourceId –在上述 AD FS 部分的 "应用注册" 中 #4 输入 标识符 值

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

      显示修改后的值的应用程序配置文件的屏幕截图。

  4. 打开 Web.config 文件。 修改以下内容:

    • ida:受众-在上述 AD FS 部分的 "应用注册 #4 中输入 标识符 值

    • ida: AdfsMetadataEndpoint-enter https://[your AD FS hostname]/federationmetadata/2007-06/federationmetadata.xml

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

测试示例

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

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

  2. 在 Visual Studio 上,右键单击 "解决方案",然后选择 "设置启动项目 ... "

    突出显示 "设置启动项目" 选项时显示的列表屏幕截图。

  3. 在 "属性页" 上,确保为每个项目将 " 操作 " 设置为 " 启动 "

    "解决方案属性页" 对话框的屏幕截图,其中显示了 "多启动项目" 选项和所有项目的 "操作" 设置为 "启动"。

  4. 在 Visual Studio 顶部,单击绿色箭头。

    Visual Studio UI 的屏幕截图,其中的 Start 选项称为 "out"。

  5. 在本机应用程序的主屏幕上,单击 " 登录"。

    "待办事项列表客户端" 对话框的屏幕截图。

如果看不到 "本机应用" 屏幕,请在 *msalcache.bin 系统上搜索并删除项目存储库保存到的文件夹中的文件。

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

    登录页的屏幕截图。

  2. 登录后,在 "创建待办事项"项 中输入文本 "生成本机应用到 Web Api "。 单击 " 添加项"。 这将调用 待办事项列表服务 (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(示例代码)

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

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