概述
今天 AD FS 通过设置 AD FS 场实现高度可用。 某些组织希望通过一种方法 AD FS 部署,从而无需使用多个 AD FS 服务器和网络负载平衡基础结构,同时仍有一些保证,如果出现问题,可以快速还原服务。 新的 AD FS 快速还原工具提供了一种方法来还原 AD FS 的数据,无需完全备份和还原操作系统或系统状态。 可以使用新工具将 AD FS 配置导出到 Azure 或本地位置。 然后,可以将导出的数据应用于全新 AD FS 安装,重新创建或复制 AD FS 环境。
方案
可以在以下方案中使用 AD FS 快速还原工具:
- 问题后快速还原 AD FS 功能
- 使用工具创建 AD FS 的冷备用安装,这些安装可以快速部署以代替联机 AD FS 服务器
- 部署相同的测试环境和生产环境
- 使用此工具可在测试环境中快速创建生产 AD FS 的精确副本,或快速将验证的测试配置部署到生产环境
- 从基于 SQL 的配置迁移到 WID,反之亦然
- 使用工具从基于 SQL 的场配置移动到 WID,反之亦然。
Note: 如果使用的是 SQL 合并复制或 Alwayson 可用性组,则不支持快速还原工具。 建议使用基于 SQL 的备份和 SSL 证书的备份作为替代方法。
备份的内容
该工具备份以下 AD FS 配置
- AD FS 配置数据库 (SQL 或 WID)
- 位于 AD FS 文件夹中的配置文件 ()
- 从 Active Directory DKM 容器自动生成的令牌签名和解密证书和私钥 ()
- SSL 证书和任何外部注册的证书 (令牌签名、令牌解密和服务通信) 以及相应的私钥 (注意:私钥必须是可导出的,并且运行该脚本的用户必须具有访问这些证书的权限)
- 安装的自定义身份验证提供程序、属性存储和本地声明提供程序信任的列表。
如何使用该工具
首先,将 MSI 下载 并安装到 AD FS 服务器。
在 PowerShell 提示符下运行以下命令:
import-module 'C:\Program Files (x86)\ADFS Rapid Recreation Tool\ADFSRapidRecreationTool.dll'
Note: 如果使用的是 Windows 集成数据库 (WID) ,则需要在主 AD FS 服务器上运行此工具。 你可以使用
Get-AdfsSyncPropertiesPowerShell cmdlet 来确定你所在的服务器是否是主服务器。
系统要求
- 此工具适用于 Windows Server 2012 R2 和更高版本中的 AD FS。
- 所需的 .NET framework 至少为4.0。
- 必须在与备份版本相同的 AD FS 服务器上执行还原,并使用与 AD FS 服务帐户相同的 Active Directory 帐户。
创建备份
若要创建备份,请使用 Backup-ADFS cmdlet。 此 cmdlet 备份 AD FS 配置、数据库、SSL 证书等。
用户至少必须是本地管理员才能运行此 cmdlet。 若要备份 Active Directory DKM 容器 (在默认 AD FS 配置) 中是必需的,则用户必须是域管理员,需传入 AD FS 服务帐户凭据,或者有权访问 DKM 容器。 如果你使用的是 gMSA 帐户,则该用户必须是域管理员或具有容器的权限;不能提供 gMSA 凭据。
备份将按照模式 "adfsBackup_ID_Date 时间" 命名。 它将包含完成备份的日期和时间。 Cmdlet 采用以下参数:
参数集
显示 cmdlet 接受的参数集的屏幕截图。
详细说明
-
BackupDKM -备份包含默认配置中 AD FS 密钥的 Active Directory DKM 容器 (自动生成的令牌签名和解密证书) 。 这将使用 AD 工具 "ldifde" 导出 AD 容器及其所有子树。
-
-StorageType < string > -用户要使用的存储类型。 "文件系统" 表示用户要将其存储在本地或网络 "Azure" 中,表示用户要在执行备份时将其存储在 Azure 存储容器中,请选择 "文件系统" 或云中的备份位置。 要使用 Azure,应将 Azure 存储凭据传递给 cmdlet。 存储凭据包含帐户名和密钥。 除此之外,还必须传入容器名称。 如果该容器不存在,则在备份过程中创建它。 对于要使用的文件系统,必须指定存储路径。 在该目录中,将为每个备份创建一个新目录。 创建的每个目录都将包含备份的文件。
-
EncryptionPassword < 字符串 > -用于在存储之前加密所有已备份文件的密码
-
AzureConnectionCredentials < Pscredential > -Azure 存储帐户的帐户名称和密钥
-
New-azurestoragecontainer < string > -将在 Azure 中存储备份的存储容器
-
存储路径 < string > -将存储备份的位置
-
ServiceAccountCredential < pscredential > -指定当前正在运行的 AD FS 服务所使用的服务帐户。 仅当用户想要备份 DKM 而不是域管理员或无权访问容器的内容时,才需要此参数。
-
BackupComment < string [] > -有关将在还原期间显示的备份的信息性字符串,类似于 hyper-v 检查点命名的概念。 默认值为空字符串
备份示例
下面是使用 AD FS 快速还原工具的备份示例。
使用 DKM 将 AD FS 配置备份到文件系统,并且可以 (域管理员或委派的) 访问 DKM 容器内容
Backup-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -EncryptionPassword "password" -BackupComment "Clean Install of ADFS (FS)" -BackupDKM
将具有 DKM 的 AD FS 配置备份到具有服务帐户凭据的文件系统,以本地管理员身份运行
Backup-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -EncryptionPassword "password" -BackupComment "Clean Install of ADFS (FS)" -BackupDKM -ServiceAccountCredential $cred
将不包含 DKM 的 AD FS 配置备份到 Azure 存储容器。
Backup-ADFS -StorageType "Azure" -AzureConnectionCredentials $cred -AzureStorageContainer "adfsbackups" -EncryptionPassword "password" -BackupComment "Clean Install of ADFS"
将不带 DKM 的 AD FS 配置备份到文件系统
Backup-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -EncryptionPassword "password" -BackupComment "Clean Install of ADFS (FS)"
从备份还原
若要将使用 Backup-ADFS 创建的配置应用到新的 AD FS 安装,请使用 Restore-ADFS cmdlet。
此 cmdlet 使用 cmdlet 创建新的 AD FS 场 Install-AdfsFarm ,并还原 AD FS 配置、数据库、证书等。 如果服务器上尚未安装 AD FS 角色,则该 cmdlet 将安装它。 该 cmdlet 检查现有备份的还原位置,并提示用户根据所采用的日期/时间以及用户可能已附加到备份的任何备份注释来选择适当的备份。 如果有多个 AD FS 配置具有不同的联合身份验证服务名称,则系统会提示用户首先选择适当的 AD FS 配置。
用户必须是本地管理员和域管理员才能运行此 cmdlet。
Note: 使用 AD FS 快速恢复工具之前,请先确保服务器已加入域,然后再还原备份。
Cmdlet 采用以下参数:
AD FS 快速还原工具
详细说明
-
StorageType < string > -用户要使用的存储类型。 "文件系统" 指示用户要将其存储在本地或网络 "Azure" 中,表示用户要将其存储在 Azure 存储容器中
-
DecryptionPassword < 字符串 > -用于加密所有已备份文件的密码
-
AzureConnectionCredentials < Pscredential > -Azure 存储帐户的帐户名称和密钥
-
New-azurestoragecontainer < string > -将在 Azure 中存储备份的存储容器
-
存储路径 < string > -将存储备份的位置
-
ADFSName < 字符串 > -已备份并将还原的联合的名称。 如果未提供此项并且只有一个联合身份验证服务名称,则将使用。 如果有多个备份到该位置的联合身份验证服务,则会提示用户选择一个已备份的联合身份验证服务。
-
ServiceAccountCredential < pscredential > -指定将用于要还原的新 AD FS 服务的服务帐户
-
GroupServiceAccountIdentifier < string > -用户要用于要还原的新 AD FS 服务的 GMSA。 默认情况下,如果未提供任何一个,则会在 GMSA 时使用备份的帐户名称,否则,系统会提示用户将其置于服务帐户中
-
DBConnectionString < 字符串 > -如果用户想要使用不同的数据库进行还原,则应在 Wid 中传递 SQL 连接字符串或为 wid 键入。
-
强制 < 执行 > 布尔-跳过工具在选择备份后可能会出现的提示
-
RestoreDKM < bool > -若要转到新的 AD 并且最初备份 dkm,应设置为 ad 的 dkm 容器。
还原示例
从 Azure 存储容器还原不含 DKM 的 AD FS 配置
Restore-ADFS -StorageType "Azure" -AzureConnectionCredential $cred -DecryptionPassword "password" -AzureStorageContainer "adfsbackups"
从文件系统中还原不含 DKM 的 AD FS 配置
Restore-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -DecryptionPassword "password"
将 AD FS 配置与 DKM 一起还原到文件系统
Restore-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -DecryptionPassword "password" -RestoreDKM
将 AD FS 配置还原到 WID
Restore-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -DecryptionPassword "password" -DBConnectionString "WID"
将 AD FS 配置还原到 SQL
Restore-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -DecryptionPassword "password" -DBConnectionString "Data Source=TESTMACHINE\SQLEXPRESS; Integrated Security=True"
用指定的 GMSA 还原 AD FS 配置
Restore-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -DecryptionPassword "password" -GroupServiceAccountIdentifier "mangupd1\adfsgmsa$"
用指定的服务帐户凭据还原 AD FS 配置
Restore-ADFS -StorageType "FileSystem" -StoragePath "C:\Users\administrator\testExport\" -DecryptionPassword "password" -ServiceAccountCredential $cred
加密信息
在将所有备份数据推送到云之前对其进行加密,或将其存储在文件系统中。
作为备份的一部分创建的每个文档都使用 AES-256 进行加密。 传递给工具的密码用作通行短语,以使用 Rfc2898DeriveBytes 类生成新密码。
RngCryptoServiceProvider 用于生成 AES 和 Rfc2898DeriveBytes 类使用的 salt。
日志文件
每次执行备份或还原时,都会创建一个日志文件。 可在以下位置找到这些内容:
- %LOCALAPPDATA%\ADFSRapidRecreationTool
Note: 执行还原时,可能会创建一个 PostRestore_Instructions 文件,其中包含附加身份验证提供程序的概述、属性存储和本地声明提供程序信任,以便在启动 AD FS 服务之前手动安装。
版本发行历史记录
版本1.0.82。3
版本:2020年4月
已解决的问题:
- 添加了对基于 CNG 的证书的支持
版本1.0.82。0
版本:2019年7月
已解决的问题:
- AD FS 包含 LDAP 转义字符的服务帐户名称的 Bug 修复
版本:1.0.81。0
版本:2019年4月
已解决的问题:
- 证书备份和还原的 Bug 修复
- 日志文件的附加跟踪信息
版本:1.0.75。0
版本:8月2018
已解决的问题:
- 当使用-BackupDKM 开关时,更新备份-ADFS。 该工具将确定当前上下文是否有权访问 DKM 容器。 如果是这样,则不需要域管理员权限或服务帐户凭据。 这允许自动备份,而无需显式提供凭据或作为域管理员帐户运行。
版本:1.0.73。0
版本:8月2018
已解决的问题:
-
更新加密算法,使应用程序符合 FIPS
NOTE 旧备份不适用于新版本,因为加密算法的更改是根据 FIPS 相容性的
-
添加对使用合并复制的 SQL 群集的支持
版本:1.0.72。0
版本:2018年7月
已解决的问题:
- Bug 修复:已修复。用于支持就地升级的 MSI 安装程序
1.0.18.0
版本:2018年7月
已解决的问题:
- Bug 修复:处理服务帐户密码,这些密码在其中包含特殊字符 (ie,"&" )
- Bug 修复:还原失败,因为另一个进程正在使用 Microsoft.IdentityServer.Servicehost.exe.config
1.0.0.0
发布日期:2016年10月
AD FS 快速还原工具的初始版本
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
