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

获取并配置 AD FS 的令牌签名和令牌解密证书

· 52CE 我爱测

本文档介绍如何获取和配置 AD FS 的 TS 和 TD 证书

本主题介绍了可执行的任务和过程,以确保 AD FS 令牌签名和令牌解密证书是最新的。

令牌签名证书是标准 X509 证书,用于安全地对联合服务器颁发的所有令牌进行签名。 令牌解密证书是标准 X509 证书,用于对任何传入令牌进行解密。 它们还在联合元数据中发布。

有关其他信息,请参阅 证书要求

确定 AD FS 是否自动续订证书

默认情况下,AD FS 配置为在初始配置时以及在证书接近到期日期时自动生成令牌签名证书和令牌解密证书。

您可以运行以下 Windows PowerShell 命令: Get-AdfsProperties 。

PowerShell 窗口的屏幕截图,其中显示了具有自动证书滚动更新和被称为 out 的证书生成阈值属性的 Get-ADFSProperties 命令的结果。

AutoCertificateRollover 属性描述 AD FS 是否配置为自动续订令牌签名和令牌解密证书。

如果将 AutoCertificateRollover 设置为 TRUE,则将在 AD FS 自动续订和配置 AD FS 证书。 配置新证书后,若要避免服务中断,必须确保每个联合伙伴 AD FS (通过信赖方信任或声明提供方信任) 使用此新证书更新。

如果 AD FS 未配置为自动续订令牌签名和令牌解密证书 (如果将 AutoCertificateRollover 设置为 False) ,则 AD FS 将不会自动生成或开始使用新的令牌签名或令牌解密证书。 你必须手动执行这些任务。

如果将 AD FS 配置为自动续订令牌签名和令牌解密证书 (AutoCertificateRollover 设置为 TRUE) ,则可以确定何时续订这些证书:

CertificateGenerationThreshold 描述了在日期后,将生成新证书的日期前的天数。

CertificatePromotionThreshold 确定在生成新证书后,将其升级为主要证书的天数 (换言之,AD FS 将开始使用该证书对它颁发的令牌进行签名,并从标识提供者) 解密令牌。

PowerShell 窗口的屏幕截图,其中显示了具有 "证书生成阈值" 和 "证书提升阈值" 属性(称为 out)的 Get-ADFSProperties 命令的结果。

如果将 AD FS 配置为自动续订令牌签名和令牌解密证书 (AutoCertificateRollover 设置为 TRUE) ,则可以确定何时续订这些证书:

  • CertificateGenerationThreshold 描述了在日期后,将生成新证书的日期前的天数。
  • CertificatePromotionThreshold 确定在生成新证书后,将其升级为主要证书的天数 (换言之,AD FS 将开始使用该证书对它颁发的令牌进行签名,并从标识提供者) 解密令牌。

确定当前证书何时过期

你可以使用以下过程来确定主要令牌签名和令牌解密证书,并确定当前证书的过期时间。

您可以运行以下 Windows PowerShell 命令: Get-AdfsCertificate –CertificateType token-signing (或 Get-AdfsCertificate –CertificateType token-decrypting ) 。 或者,你可以在 MMC 中检查当前的证书:服务 >证书。

"PowerShell" 窗口的屏幕截图,其中显示了 "Get-AdfsCertificate – Certificatetype token-signing 令牌签名" 命令的结果,而不是 "后" 和 "主属性"。

IsPrimary 值设置为 True 的证书是 AD FS 当前正在使用的证书。

" 不晚 于" 的显示日期是必须配置新的主令牌签名或解密证书的日期。

为了确保服务连续性,所有联合伙伴 (在 AD FS 场中由信赖方信任或声明提供方信任表示,) 在此过期之前必须使用新的令牌签名和令牌解密证书。 建议提前计划至少60天进行此过程。

宽限期结束之前手动生成新的自签名证书

你可以使用以下步骤在宽限期结束之前手动生成新的自签名证书。

  1. 确保你已登录到主 AD FS 服务器。
  2. 打开 Windows PowerShell 并运行以下命令: Add-PSSnapin "microsoft.adfs.powershell"
  3. 还可以选择在 AD FS 中检查当前签名证书。 为此,请运行以下命令: Get-ADFSCertificate –CertificateType token-signing 。 查看命令输出,查看列出的任何证书的不在日期之后。
  4. 若要生成新证书,请执行以下命令以续订和更新 AD FS 服务器上的证书: Update-ADFSCertificate –CertificateType token-signing 。
  5. 再次运行以下命令,验证更新: Get-ADFSCertificate –CertificateType token-signing
  6. 现在应会列出两个证书,其中一个证书的日期 不能晚 于将来的一年,并且 IsPrimary 值为 False。

Important: 若要避免服务中断,请通过运行如何使用有效的令牌签名证书更新 Azure AD 中的步骤来更新 Azure AD 上的证书信息。

如果使用的不是自签名证书 .。。

如果未使用默认自动生成的自签名令牌签名和令牌解密证书,则必须手动续订和配置这些证书。

首先,你必须从证书颁发机构获取新证书,并将其导入到每个联合服务器上的本地计算机个人证书存储中。 有关说明,请参阅 导入证书一 文。

然后,必须将此证书配置为辅助 AD FS 令牌签名或解密证书。 (你将其配置为辅助证书,以便在将其升级到主要证书) 之前,允许联合伙伴足够的时间使用此新证书。

将新证书配置为辅助证书

  1. 打开 PowerShell 并运行以下内容: Set-ADFSProperties -AutoCertificateRollover $false
  2. 导入证书后, 打开 AD FS 管理 控制台。
  3. 展开 “服务”,然后选择 “证书”。
  4. 在 "操作" 窗格中,单击 " 添加 Token-Signing 证书"。 显示称为 "添加令牌签名证书" 选项的 "D F S" 对话框的屏幕截图。
  5. 从已显示证书的列表中选择新证书,然后单击“确定”。
  6. 打开 PowerShell 并运行以下内容: Set-ADFSProperties -AutoCertificateRollover $true

Warning: 确保新证书具有与之关联的私钥,并确保向 AD FS 的服务帐户授予对私钥的读取权限。 请在每个联合服务器上进行验证。 为此,请在“证书”管理单元中右键单击新证书,单击“所有任务”,然后单击“管理私钥”。

为联合身份验证伙伴提供足够的时间来使用新证书后 (他们请求你的联合元数据,或者将你的新证书的公钥发送) ,你必须将辅助证书提升为主证书。

将新证书从辅助证书升级为主证书

  1. 打开 AD FS 管理 控制台。
  2. 展开 “服务”,然后选择 “证书”。
  3. 单击辅助令牌签名证书。
  4. 在 “操作” 窗格中,单击 “设置为主证书”。 在出现确认提示时单击“是”。 显示 "操作" 窗格中的 "设置为主选项" 选项的屏幕截图。

更新联合伙伴

可以使用联合元数据的合作伙伴

如果你已经续订并配置了新的令牌签名或令牌解密证书,则必须确保所有联合伙伴 (资源组织或在你 AD FS 中由信赖方信任和声明提供方信任表示的组织合作伙伴,) 选取了新证书。

不能使用联合元数据的合作伙伴

如果联合身份验证伙伴不能使用联合元数据,则必须手动向其发送新的令牌签名/令牌解密证书的公钥。 如果希望将整个链) 包含到所有资源组织或帐户组织合作伙伴, (在 AD FS 中用信赖方信任和声明提供程序信任) 表示),请将新的证书公钥发送 ( .cer 文件或. p7b。 让合作伙伴在其端实施更改以信任新证书。

如果 AutoCertificateRollover 为 False,则提升为主 ()

如果 AutoCertificateRollover 设置为 False,则 AD FS 不会自动生成或开始使用新的令牌签名或令牌解密证书。 你必须手动执行这些任务。 允许所有联合身份验证伙伴使用新的辅助证书后,将此辅助证书升级到主 (在 MMC 管理单元中,单击 "辅助令牌签名证书",然后在 "操作" 窗格中,单击 " 设为主 证书"。 )

更新 Azure AD

AD FS 通过用户现有 AD DS 凭据对用户进行身份验证,从而提供对 Microsoft 云服务(如 Office 365)的单一登录访问。 有关使用证书的其他信息,请参阅 续订 Office 365 和 Azure AD 的联合身份验证证书。

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

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

资料来源与适用范围

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

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

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