适用于: AD FS 2019 及更高版本
了解如何生成通过 AD FS 2019 进行身份验证的 web 应用登录,并使用 MSAL 库 来调用 web api。
概述
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) 的信赖方。
-
在 AD FS 管理 "中,右键单击" 应用程序组 ",然后选择" 添加应用程序组"。
-
在应用程序组向导上,为 " 输入 WebAppToWebApi ",在 " 客户端-服务器应用程序 " 下选择用于 访问 Web API 模板的服务器应用程序 。 单击“下一步” 。
"添加应用程序组向导" 的 "欢迎使用" 页的屏幕截图,其中突出显示了访问 web 的服务器应用程序。
-
复制 " 客户端标识符 " 值。 它稍后将用作应用程序 Web.config 文件中的 ida: ClientId 的值。 对于 "重定向 URI",请输入以下内容: - https://localhost:44326 。 单击“添加”。 单击“下一步” 。
"添加应用程序组向导" 的 "服务器应用程序" 页的屏幕截图,显示正确的客户端标识符和重定向 U R I。
-
在 "配置应用程序凭据" 屏幕上,选中 " 生成共享机密 并复制机密"。 此值稍后将用作应用程序 Web.config 文件中的 ida: ClientSecret 的值。 单击“下一步” 。
"添加应用程序组" 向导的 "配置应用程序凭据应用程序" 页的屏幕截图,其中显示了 "生成共享机密" 选项,并填充了生成的共享机密。
-
在 "配置 Web API" 屏幕上,输入 标识符: https://webapi 。 单击 “添加” 。 单击“下一步” 。 此值稍后将用于应用程序 Web.config 文件中的 ida: GraphResourceId 。
"添加应用程序组" 向导的 "配置 Web API" 页的屏幕截图,其中显示了正确的标识符。
-
在 "应用访问控制策略" 屏幕上,选择 " 允许 每个人" 并单击 " 下一步"
"添加应用程序组向导" 的 "选择访问控制策略" 页的屏幕截图,显示突出显示 "允许所有人" 选项。
-
在 "配置应用程序权限" 屏幕上,确保已选中 " openid and user_impersonation ",然后单击 " 下一步"。
"添加应用程序组" 向导的 "配置应用程序权限" 页的屏幕截图,其中显示了 "打开 I D" 和 "用户模拟" 选项。
-
在 "摘要" 屏幕上,单击 " 下一步"。
-
在 "完成" 屏幕上,单击 " 关闭"。
代码配置
本部分介绍如何将 ASP.NET Web 应用配置为登录用户和检索令牌,以调用 Web API
-
从此处下载示例
-
使用 Visual Studio 打开示例
-
打开 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 配置文件的屏幕截图。
-
测试示例
本部分介绍如何测试上面配置的示例。
-
更改代码后,重新生成解决方案
-
在 Visual Studio 顶部,请确保已选择 "Internet Explorer",并单击绿色箭头。
Visual Studio UI 的屏幕截图,其中包含 IIS Express (Internet Explorer) 选项。
-
在主页上,单击 "登录"。
"主页" 页的屏幕截图,其中的 "登录" 选项称为 "out"。
-
你将被重定向到 AD FS 登录页。 继续登录。
登录页的屏幕截图。
-
登录后,单击 "访问令牌"。
带有调用的访问令牌选项的主页屏幕截图。
-
单击 "访问令牌" 将通过调用 Web API 获取访问令牌信息。
显示访问令牌信息的访问令牌页的屏幕截图。
后续步骤
AD FS OpenID Connect/OAuth 流和应用程序方案
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
