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

使用 OpenID Connect 和 AD FS 2016 及更高版本构建 web 应用程序

· 52CE 我爱测

了解详细信息:使用 OpenID Connect 构建 web 应用程序,AD FS 2016 及更高版本

先决条件

下面列出了在完成本文档之前需要满足的先决条件。 本文档假定已安装 AD FS 并且已创建 AD FS 场。

  • GitHub 客户端工具

  • Windows Server 2016 TP4 或更高版本中的 AD FS

  • Visual Studio 2013 或更高版本。

在 AD FS 2016 及更高版本中创建应用程序组

以下部分介绍如何配置 AD FS 2016 及更高版本中的应用程序组。

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

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

    突出显示 Web 浏览器访问 web 应用程序模板的屏幕截图。

  3. 复制 " 客户端标识符 " 值。 它稍后将用作应用程序 web.config 文件中的 ida: ClientId 的值。

  4. 对于 "重定向 URI",请输入以下内容: - https://localhost:44320/ 。 单击“添加”。 单击“下一步” 。

    显示在何处进入重定向 U R I 值的屏幕截图。

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

    显示摘要屏幕的屏幕截图。

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

下载并修改示例应用程序,通过 OpenID Connect 和 AD FS 进行身份验证

本部分介绍如何在 Visual Studio 中下载示例 Web 应用并对其进行修改。 我们将使用 此处的 Azure AD 示例。

若要下载示例项目,请使用 Git Bash,并键入以下内容:

git clone https://github.com/Azure-Samples/active-directory-dotnet-webapp-openidconnect

显示如何下载示例项目的终端窗口的屏幕截图。

修改应用程序
  1. 使用 Visual Studio 打开示例。

  2. 重新生成应用,以便还原所有缺少的 Nuget。

  3. 打开 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 点配置文件所做的更改的屏幕截图。

  4. 打开 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

成功后,你应该会看到你现在已登录。

突出显示登录所用用户名的屏幕截图。

后续步骤

AD FS 开发

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

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

资料来源与适用范围

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

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

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