先决条件
下面列出了在完成本文档之前需要满足的先决条件。 本文档假定已安装 AD FS 并且已创建 AD FS 场。
-
GitHub 客户端工具
-
Windows Server 2016 TP4 或更高版本中的 AD FS
-
Visual Studio 2013 或更高版本。
在 AD FS 2016 及更高版本中创建应用程序组
以下部分介绍如何配置 AD FS 2016 及更高版本中的应用程序组。
创建应用程序组
-
在 AD FS 管理 "中,右键单击" 应用程序组 ",然后选择" 添加应用程序组"。
-
在应用程序组向导上,为 "输入 ADFSSSO ",在 " 客户端-服务器应用程序 " 下,选择 " web 浏览器访问 web 应用程序 " 模板。 单击“下一步” 。
突出显示 Web 浏览器访问 web 应用程序模板的屏幕截图。
-
复制 " 客户端标识符 " 值。 它稍后将用作应用程序 web.config 文件中的 ida: ClientId 的值。
-
对于 "重定向 URI",请输入以下内容: - https://localhost:44320/ 。 单击“添加”。 单击“下一步” 。
显示在何处进入重定向 U R I 值的屏幕截图。
-
在 " 摘要 " 屏幕上,单击 " 下一步"。
显示摘要屏幕的屏幕截图。
-
在 " 完成 " 屏幕上,单击 " 关闭"。
下载并修改示例应用程序,通过 OpenID Connect 和 AD FS 进行身份验证
本部分介绍如何在 Visual Studio 中下载示例 Web 应用并对其进行修改。 我们将使用 此处的 Azure AD 示例。
若要下载示例项目,请使用 Git Bash,并键入以下内容:
git clone https://github.com/Azure-Samples/active-directory-dotnet-webapp-openidconnect
显示如何下载示例项目的终端窗口的屏幕截图。
修改应用程序
-
使用 Visual Studio 打开示例。
-
重新生成应用,以便还原所有缺少的 Nuget。
-
打开 web.config 文件。 修改以下值,使其类似于以下内容:
<add key="ida:ClientId" value="[Replace this Client Id from #3 in above section]" /> <add key="ida:ADFSDiscoveryDoc" value="https://[Your ADFS hostname]/adfs/.well-known/openid-configuration" /> <!--<add key="ida:Tenant" value="[Enter tenant name, e.g. contoso.onmicrosoft.com]" /> <add key="ida:AADInstance" value="https://login.microsoftonline.com/{0}" />--> <add key="ida:PostLogoutRedirectUri" value="[Replace this with Redirect URI from #4 in the above section]" />突出显示对 web 点配置文件所做的更改的屏幕截图。
-
打开 Startup.Auth.cs 文件并进行以下更改:
-
注释掉以下内容:
//string Authority = String.Format(CultureInfo.InvariantCulture, aadInstance, tenant); -
调整 OpenId Connect 中间件初始化逻辑,并进行以下更改:
private static string clientId = ConfigurationManager.AppSettings["ida:ClientId"]; //private static string aadInstance = ConfigurationManager.AppSettings["ida:AADInstance"]; //private static string tenant = ConfigurationManager.AppSettings["ida:Tenant"]; private static string metadataAddress = ConfigurationManager.AppSettings["ida:ADFSDiscoveryDoc"]; private static string postLogoutRedirectUri = ConfigurationManager.AppSettings["ida:PostLogoutRedirectUri"];显示如何更改打开的 I D Connect 中间件初始化逻辑的屏幕截图。
-
再往下修改 OpenId Connect 中间件选项,如下所示:
app.UseOpenIdConnectAuthentication( new OpenIdConnectAuthenticationOptions { ClientId = clientId, //Authority = authority, MetadataAddress = metadataAddress, PostLogoutRedirectUri = postLogoutRedirectUri, RedirectUri = postLogoutRedirectUri显示如何修改 "打开 I D 连接中间件" 选项的屏幕截图。
通过更改以上步骤,我们将执行以下操作:
-
我们不是使用授权来传达有关受信任颁发者的数据,而是通过 MetadataAddress 直接指定发现文档位置
-
Azure AD 不会强制在请求中存在 redirect_uri,但 ADFS 确实如此。 那么,我们需要在此添加
-
-
验证应用是否正在运行
进行上述更改后,按 F5。 这将显示示例页。 单击 "登录"。
屏幕截图,显示了一个 S P 点 N E T 示例页。
你将被重定向到 AD FS 登录页。 继续登录。
AD FS OpenID
成功后,你应该会看到你现在已登录。
突出显示登录所用用户名的屏幕截图。
后续步骤
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
