适用于: AD FS 2019 及更高版本
了解如何生成通过 AD FS 2019 进行身份验证的本机应用登录,并使用 MSAL 库 来调用 web api。
概述
概述
在此流中,会将身份验证添加到本机应用 (公共客户端) ,从而使用户登录并调用 Web API。 若要从登录用户的本机应用程序调用 Web API,可以使用 MSAL 的 AcquireTokenInteractive 标记获取方法。 为了实现这种交互,MSAL 利用了 Web 浏览器。
为了更好地了解如何在 ADFS 中配置本机应用以交互方式获取访问令牌,让我们使用 此处 提供的示例并演练应用注册和代码配置步骤。
先决条件
- GitHub 客户端工具
- AD FS 2019 或更高版本配置并运行
- Visual Studio 2013 或更高版本
AD FS 中的应用注册
本部分演示如何将本机应用作为公共客户端和 Web API 注册为依赖方 (RP) 在 AD FS
-
在 AD FS 管理"中,右键单击" 应用程序组 ",然后选择" 添加应用程序组"。
-
在应用程序组向导上,为 " 输入 NativeAppToWebApi ",在 " 客户端-服务器应用程序 " 下,选择 本机应用程序访问 Web API 模板。 单击“下一步” 。
"添加应用程序组向导" 的 "欢迎使用" 页的屏幕截图,其中突出显示了访问 Web API 模板的本机应用程序。
-
复制 " 客户端标识符 " 值。 稍后会将其用作应用程序 App.config 文件中的 ClientId 值。 对于 " 重定向 URI ",请输入以下内容: https://ToDoListClient 。 单击 “添加” 。 单击“下一步” 。
"添加应用程序组向导" 的 "本机应用程序" 页的屏幕截图,显示 "重定向 U R I"。
-
在 "配置 Web API" 屏幕上,输入 标识符: https://localhost:44321/ 。 单击 “添加” 。 单击“下一步” 。 稍后将在应用程序的 App.config 和 Web.config 文件中使用此值。
"添加应用程序组" 向导的 "配置 Web API" 页的屏幕截图,其中显示了正确的标识符。
-
在 "应用访问控制策略" 屏幕上,选择 " 允许每个人 " 并单击 " 下一步"
"添加应用程序组向导" 的 "选择访问控制策略" 页的屏幕截图,显示突出显示 "允许所有人" 选项。
-
在 "配置应用程序权限" 屏幕上,确保已选中 " openid " 并单击 " 下一步"。
"添加应用程序组" 向导的 "配置应用程序权限" 页的屏幕截图,其中显示了 "已选择"
-
在 "摘要" 屏幕上,单击 " 下一步"。
-
在 "完成" 屏幕上,单击 " 关闭"。
-
在 AD FS 管理 "中,单击" 应用程序组 ",并选择" NativeAppToWebApi 应用程序组 "。 右键单击并选择 “属性”。
显示突出显示 "NativeAppToWebApi" 组的 "D F S 管理" 对话框的屏幕截图,并显示下拉列表中的 "属性" 选项。
-
在 NativeAppToWebApi 的 "属性" 屏幕上,选择 " NativeAppToWebApi – WEB api " ,然后单击"编辑 ... "
显示 "NativeAppToWebApi 属性" 对话框的屏幕截图,其中突出显示了 P I 应用程序 NativeAppToWebApi。
-
在 NativeAppToWebApi – Web API 属性屏幕上,选择 "颁发转换规则" 选项卡,然后单击 "添加规则 ... "
显示 "颁发转换规则" 选项卡的 "NativeAppToWebApi-Web A P I 属性" 对话框的屏幕截图。
-
在 "添加转换声明规则向导" 上,从 "声明规则模板" 下拉列表选择 "转换传入声明",然后单击 "下一步"。
"添加转换声明规则向导" 的 "选择规则模板" 页的屏幕截图,其中显示了 "转换传入声明" 选项。
-
在 "声明规则名称: " 字段中输入 NameID 。 为 传入声明类型 选择 名称:、传出声明类型 的 名称 ID 和 传出名称 ID 格式 的 公用名:。 单击 " 完成"。
"添加转换声明规则" 向导的 "配置规则" 页的屏幕截图,其中显示了上面所述的配置。
-
单击 "NativeAppToWebApi – Web API 属性" 屏幕上的 "确定",然后单击 "NativeAppToWebApi 属性" 屏幕。
代码配置
本部分演示如何将本机应用配置为登录用户和检索令牌,以调用 Web API
-
从此处下载示例
-
使用 Visual Studio 打开示例
-
打开 App.config 文件。 修改以下内容:
-
ida:颁发机构-输入 h
ttps://[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 中输入 标识符 值。
显示修改后的值的应用程序配置文件的屏幕截图。
-
-
打开 Web.config 文件。 修改以下内容:
-
ida:受众-在上述 AD FS 部分的 "应用注册 #4 中输入 标识符 值
-
ida: AdfsMetadataEndpoint-enter
https://[your AD FS hostname]/federationmetadata/2007-06/federationmetadata.xml显示修改后的值的 web 配置文件的屏幕截图。
-
测试示例
本部分介绍如何测试上面配置的示例。
-
更改代码后,重新生成解决方案
-
在 Visual Studio 上,右键单击 "解决方案",然后选择 "设置启动项目 ... "
突出显示 "设置启动项目" 选项时显示的列表屏幕截图。
-
在 "属性页" 上,确保为每个项目将 " 操作 " 设置为 " 启动 "
"解决方案属性页" 对话框的屏幕截图,其中显示了 "多启动项目" 选项和所有项目的 "操作" 设置为 "启动"。
-
在 Visual Studio 顶部,单击绿色箭头。
Visual Studio UI 的屏幕截图,其中的 Start 选项称为 "out"。
-
在本机应用程序的主屏幕上,单击 " 登录"。
"待办事项列表客户端" 对话框的屏幕截图。
如果看不到 "本机应用" 屏幕,请在 *msalcache.bin 系统上搜索并删除项目存储库保存到的文件夹中的文件。
-
你将被重定向到 AD FS 登录页。 继续登录。
登录页的屏幕截图。
-
登录后,在 "创建待办事项"项 中输入文本 "生成本机应用到 Web Api "。 单击 " 添加项"。 这将调用 待办事项列表服务 (WEB API) 并在缓存中添加项。
"待办事项列表客户端" 对话框的屏幕截图,其中包含 "待办事项" 项。
后续步骤
AD FS OpenID Connect/OAuth 流和应用程序方案
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
