使用 Kerberos Configuration Manager诊断 SQL Server 中的 Kerberos 问题

适用范围:SQL Server

原始 KB 数: 2985455

Summary

使用 Kerberos Configuration Manager进行SQL Server来诊断和修复导致SQL Server连接失败的 Kerberos 配置问题。 该工具扫描SQL Server、SQL Server Reporting Services(SSRS)和SQL Server Analysis Services(SSAS)实例,并报告缺少或重复的服务主体名称(SPN)和委派问题。 它还可以生成脚本或为你应用修补程序。 本文介绍如何下载该工具、需要哪些权限以及如何解释其输出。

注意

as-is提供 Kerberos Configuration Manager,不提供技术支持或更新。 未更新为使用 SQL Server 2022 和更高版本的 Windows Management Instrumentation (WMI) 提供程序。 若要排查和诊断这些版本的 Kerberos 配置问题,请使用 SQLCheck。

Kerberos Configuration Manager的作用

Kerberos Configuration Manager 可以执行以下任务:

  • 收集有关服务器上安装的操作系统、SQL Server实例和 Always On 可用性组侦听器的信息。
  • 报告服务器上的所有 SPN 和委派配置。
  • 确定 SPN 和委派中的潜在问题。
  • 修复潜在的 SPN 问题。

Kerberos Configuration Manager帮助排查的错误

使用此工具排查以下错误:

在开始故障排除之前,请查看 解决连接错误的先决条件和清单。

如果拥有SQL Server计算机的管理员访问权限,则还可以在该计算机上运行 SQLCheck (SQL 连接设置检查工具)。 查看其输出以检查SQL Server实例的 SPN 配置。

下载 Kerberos Configuration Manager

从Microsoft 下载中心下载该工具:

Microsoft用于SQL Server的 Kerberos Configuration Manager。

可以在域中连接到 SQL Server 计算机的任意计算机上下载并安装该工具。 请确保在“下载中心”页中查看受支持的版本和系统要求。

运行 Kerberos Configuration Manager所需的权限

若要排查影响SQL Server、SSRS 和 SSAS 的连接问题,请使用对该计算机具有管理权限的域用户帐户连接到目标计算机(承载服务的计算机)。

可选:如果要使用该工具修复它标识的 SPN 问题,则域帐户必须具有 对服务主体名称权限的已验证写入 。

启动 Kerberos Configuration Manager并连接到服务器

安装完成后,从安装文件夹中启动 KerberosConfigMgr.exe 二进制文件。 默认情况下,位置为 C:\Program Files\Microsoft\Kerberos Configuration Manager for SQL Server。

有关如何以管理员或其他用户身份启动应用的信息,请参阅 “使用运行”以管理员身份启动应用。

使用以下选项之一进行连接:

  • 连接到远程SQL Server计算机:输入服务器名称、域名和密码的适当值。

    注意

    该工具使用 Windows API 查询和显示SQL Server计算机的 Kerberos 配置信息。 始终输入托管SQL Server实例的计算机的名称,即使对命名实例的 Kerberos 相关问题进行故障排除也是如此。

  • 连接到本地服务器:选择 “连接” 以分析 Kerberos 配置。 无需指定服务器名称、域名或密码。

    注意

    启动该工具的帐户必须是本地管理员帐户。 有关如何以管理员或其他用户身份启动应用的信息,请参阅 “使用运行”以管理员身份启动应用。

Kerberos Configuration Manager中的选项卡和命令

连接成功后,该工具会显示所有相关的 SPN,如以下屏幕截图所示。

Kerberos Configuration Manager 中所有三个选项卡的视图的屏幕截图。

该工具具有以下选项卡:

  • 系统:显示用户信息和计算机信息。
  • SPN:显示该工具在目标服务器上找到的每个SQL Server实例的 SPN 信息。 它还提供所需的 SPN 及其状态等详细信息。 每行都有 “生成 ”和 “修复 ”按钮。
  • 委派:标识影响服务帐户配置委派的问题。

生成 SPN 生成脚本

使用 SPN 选项卡上的 “生成 ”查找缺少的 SPN 并创建可在命令提示符下运行的脚本:

  1. 在 SPN 选项卡上的 “SPN 脚本 ”列中,为要编写脚本的 SPN 选择“ 生成 ”。

  2. 在打开的对话框中,提供名称(在此示例中, generateSPNs),将 “另存为类型 ”设置为 Kerberos Config Mgr (.cmd),然后选择“ 保存”。

    用于提供 CMD 文件名称的对话框的屏幕截图。

该工具将创建 generateSPNss.cmd 文件。 文件的内容类似于以下示例:

:: This script is generated by the Microsoft® SQL Server® Kerberos Configuration Manager tool.

:: The script may update the system information, SPN settings and Delegation configurations of a given server.

:: SPN and Delegation configuration updates require Windows Domain Administrator permission to execute.

:: A Domain Admin should review the configurations recommended by this tool and take appropriate actions to enable Kerberos authentication.

:: Please contact Microsoft Support if Kerberos connection problem persists.

:: The file is intended to be run in domain `<DomainName>.com`"

:: Corrections for MSSQLSvc/`<HostName>.<DomainName>.com` **SetSPN -s MSSQLSvc/`<HostName>`. `<DomainName>`.com UserName**

使用 SetSPN 在 SQL Server 的服务帐户下创建 SPN。

修复 SPN 问题

在 SPN 选项卡上,使用 “修复” 修复问题并添加 SPN。 仅当具有所需权限时,才能添加 SPN。 选择 “修复”时,该工具会显示以下工具提示:

用于添加 SPN 的“修复”选项的屏幕截图。

注意

该工具仅针对具有静态端口的默认实例和命名实例提供 Fix 和 Generate 命令。 对于使用动态端口的命名实例,我们建议你从动态端口切换到静态端口,或者在每次启动SQL Server服务时向服务帐户提供注册和注销 SPN 的权限。 否则,必须在服务启动时手动注销并重新注册相应的 SPN。 有关详细信息,请参阅为 Kerberos 连接注册服务主体名称。

检查委派设置

使用 委派 识别影响服务帐户配置委派的问题。 此选项特别适用于排查链接服务器问题。 例如,如果 SPN 检查通过,但链接服务器查询仍然失败,则可能无法将服务帐户配置为委托凭据。 有关详细信息,请参阅SQL Server身份验证中链接服务器(数据库引擎)和链接服务器的连接问题。

“委派”选项卡的屏幕截图。

解释和处理 Kerberos Configuration Manager诊断

通过检查 “状态 ”列查看工具的诊断。 根据状态,按照相应的步骤解决问题。 以下各节介绍每个状态。

状态:良好

详细信息:检查的项目已正确配置。 转到输出中的下一项。

操作:无需执行任何操作。

状态:缺少必需的 SPN

详细信息:如果Active Directory中SQL Server启动帐户缺少“所需 SPN”列中列出的 SPN,则会出现此状态。

操作:按照以下步骤添加缺少的 SPN 并验证问题是否已解决:

  1. 选择“修复”以查看“警告”对话框中的信息。
  2. 选择“是”,将缺少的 SPN 添加到 Active Directory。
    • 如果域帐户具有更新Active Directory所需的权限,该工具会将所需的 SPN 添加到Active Directory。
    • 如果域帐户没有更新Active Directory所需的权限,请使用“生成”或“全部生成”来生成一个脚本,帮助Active Directory管理员添加缺少的 SPN。
  3. 添加 SPN 后,再次运行 Kerberos Configuration Manager 以验证是否已解决 SPN 问题。

状态:必须启用 TCP 才能使用 Kerberos 配置

详细信息:如果未在客户端计算机上启用 TCP,将显示此状态。

操作:按照以下步骤为 SQL Server 实例启用 TCP/IP 协议:

  1. 在 SQL Server 配置管理器 - 控制台中,展开 SQL Server 网络配置。
  2. 在控制台中,选择 “协议” 。<instance name>
  3. 在 “详细信息”中,选择 “TCP/IP”,然后选择“ 启用”。
  4. 在 控制台中,选择 “SQL Server 服务”。
  5. 在“详细信息”中,选择 SQL Server for <instance name>.
  6. 选择“重启”以停止并重启 SQL Server 服务。 有关详细信息,请参阅 启用或禁用服务器网络协议中的“启用或禁用服务器网络协议”部分。

状态:动态端口

详细信息:对于使用动态端口(默认配置)的命名实例,将显示此状态。 在需要 Kerberos 连接到SQL Server的环境中,将命名实例设置为使用静态端口,并在注册 SPN 时使用该端口。 否则,在Active Directory中注册的 SPN 在下一次开始侦听其他端口时变为无效。

注意

此建议仅适用于依赖于手动 SPN 注册的环境。

操作:按照以下步骤将 SQL Server 实例配置为使用静态端口:

  1. 在 SQL Server 配置管理器 - 控制台中,展开 SQL Server 网络配置,展开协议,<instance name>然后双击 TCP/IP。
  2. 在 TCP/IP 属性中,选择“协议”选项卡中的“全部侦听”。
  3. 如果 “全部 侦听”设置为 “是”,请切换到 IP 地址,并滚动到窗口底部以查找 IPAll 设置。
  4. 删除 TCP 动态端口中的当前值,并在 TCP 端口中输入端口号。
  5. 选择“确定”,然后重启 SQL Server 实例。 有关详细信息,请参阅 配置服务器以侦听特定的 TCP 端口。
  6. 如果 “全部 侦听”设置为 “否”,请切换到 IP 地址,并检查 IP1 和 IP2 节点中显示的每个 IP 地址。 对于设置为“已启用”的地址,请删除 TCP 动态端口中的当前值,然后在 TCP 端口中设置值。
  7. 选择“确定”,然后重启 SQL Server 实例,使设置生效。 有关详细信息,请参阅 配置服务器以侦听特定的 TCP 端口。

状态:重复 SPN

详细信息:如果在Active Directory的不同帐户下注册了同一 SPN,则会出现此状态。

操作:按照以下步骤从Active Directory中删除重复的 SPN:

  1. 选择“修复”。
  2. 选中“警告”对话框中的信息。
  3. 选择“是”可从Active Directory中删除不正确的 SPN。
    • 如果域帐户具有更新Active Directory所需的权限,该工具将删除不正确的 SPN。
    • 如果域帐户没有更新Active Directory所需的权限,请使用“生成”或“全部生成”来生成脚本,你可以向Active Directory管理员提供该脚本来删除重复的 SPN。
  4. 删除 SPN 后,再次运行 Kerberos Configuration Manager以验证 SPN 问题是否已解决。

注意

当 SQL Server 数据库引擎 的实例启动时,SQL Server 将尝试为 SQL Server 服务注册 SPN。 实例停止时,SQL Server尝试注销 SPN。 若要执行此过程,SQL Server服务帐户需要Active Directory中的相应权限。 如果服务帐户没有这些权限,则不会发生自动 SPN 注册。 在这种情况下,请与Active Directory管理员一起注册 SPN,以便SQL Server实例可以使用 Kerberos 身份验证。 有关详细信息,请参阅为 Kerberos 连接注册服务主体名称。

注意

在群集化SQL Server的环境中,不建议自动注册 SPN。 在Active Directory中注销和重新注册 SPN 所需的时间可能比SQL Server联机所需的时间更多。 如果 SPN 注册未及时发生,SQL Server可能无法联机,因为群集管理员无法连接到SQL Server实例。

Kerberos Configuration Manager 中的其他选项

从命令行生成 SPN 列表

  1. 打开命令提示符。 若要排查影响 SSRS 的连接问题,请打开管理命令提示符窗口。
  2. 切换到包含 KerberosConfigMgr.exe的文件夹。
  3. 输入 KerberosConfigMgr.exe -q -l。
  4. 有关更多命令行选项,请输入 KerberosConfigMgr.exe -h。

保存服务器的 Kerberos 配置

  1. 连接到目标 Windows 服务器。
  2. 选择“保存”。
  3. 指定保存文件的位置。 选择本地驱动器或网络共享。 该工具以 .xml 格式保存文件。

查看保存的 Kerberos 配置

  1. 选择“加载”。
  2. 打开 Kerberos Configuration Manager生成的 XML 文件。

查看工具的日志文件

默认情况下,每次运行应用程序时,该工具都会生成一个新的日志文件。 可以在应用程序数据文件夹中找到日志文件: %APPDATA%\Microsoft\KerberosConfigMgr。

获取帮助

使用以下任一方法:

  • 将鼠标指针悬停在命令上以显示工具提示。
  • 在命令提示符下运行 KerberosConfigMgr.exe -h 。
  • 选择 工具栏上的“帮助 ”按钮。