使用 Kerberos 設定管理員 來診斷 SQL Server 中的 Kerberos 問題

適用於:SQL Server

原始 KB 編號: 2985455

Summary

使用 Kerberos 設定管理員 for SQL Server 來診斷並修正導致 SQL Server 連線失敗的 Kerberos 設定問題。 該工具會掃描 SQL Server、SQL Server Reporting Services(SSRS)及 SQL Server Analysis Services(SSAS)實例,並回報缺少或重複的服務主體名稱(SPN)及委派問題。 它也能自動產生腳本或幫你套用修正。 本文說明如何下載該工具、需要哪些權限,以及如何解讀其輸出。

注意

Kerberos 設定管理員 係依現況提供,且不提供技術支援或更新。 它未更新以使用 SQL Server 2022 及更新版本的 Windows 管理儀器(WMI)提供者。 要排查並診斷這些版本的 Kerberos 設定問題,請使用 SQLCheck。

Kerberos 設定管理員 的功能

Kerberos 設定管理員 可以執行下列工作:

  • 收集安裝在伺服器上的作業系統、SQL Server 實例及 Always On 可用性群組監聽器的資訊。
  • 回報伺服器上所有 SPN 和委派設定。
  • 識別SPN和委派中的潛在問題。
  • 修正潛在的SPN問題。

Kerberos 設定管理員 協助疑難排解的錯誤

使用此工具來排除以下錯誤:

在開始排查之前,請先檢視 解決連線錯誤的前提條件和檢查清單。

如果你有管理員權限存取 SQL Server 電腦,也可以在該電腦上執行 SQLCheck(SQL 連線設定檢查工具)。 檢視其輸出結果,檢查你 SQL Server 實例的 SPN 設定。

下載 Kerberos 設定管理員

從 Microsoft 下載中心 下載此工具:

Microsoft Kerberos 設定管理員 for SQL Server.

你可以在你網域內任何能連接 SQL Server 電腦的電腦上下載並安裝這個工具。 請務必在下載中心頁面查看支援版本和系統需求。

執行 Kerberos 設定管理員 需要的權限

為了排除影響 SQL Server、SSRS 和 SSAS 的連線問題,請使用在該電腦上具有系統管理權限的網域使用者帳號連線到目標電腦(即裝載該服務的電腦)。

可選:如果你想使用該工具修復它識別出的 SPN 問題,網域帳號必須擁有 已驗證寫入 service principal name 權限。

啟動 Kerberos 設定管理員 並連接到伺服器

安裝完成後,從安裝資料夾啟動 KerberosConfigMgr.exe 二進位檔。 根據預設,位置為 C:\Program Files\Microsoft\Kerberos 設定管理員 for SQL Server。

如需了解如何以系統管理員或不同使用者身分啟動應用程式的資訊,請參閱 使用執行以系統管理員或不同使用者身分啟動應用程式。

請使用以下選項之一來連接:

  • 連接遠端 SQL Server 電腦:輸入伺服器名稱、網域使用者名稱和密碼的適當值。

    注意

    該工具使用 Windows API 查詢並顯示 SQL Server 電腦的 Kerberos 設定資訊。 即使你正在排查針對具名實例的 Kerberos 相關問題,也一定要輸入承載 SQL Server 實例的電腦名稱。

  • 連接本地伺服器:選擇 連接 以分析您的 Kerberos 設定。 你不需要指定伺服器名稱、網域使用者名稱或密碼。

    注意

    啟動工具的帳號必須是本地管理員帳號。 如需如何以系統管理員或不同使用者身分啟動應用程式的資訊,請參閱 使用 [執行身分] 以系統管理員或不同使用者身分啟動應用程式。

Kerberos 設定管理員 中的分頁與指令

連線成功後,工具會顯示所有相關的 SPN,如下圖所示。

Kerberos 設定管理員 中所有三個索引卷標檢視的螢幕快照。

此工具包含以下索引標籤:

  • 系統:顯示使用者資訊和計算機資訊。
  • SPN:顯示工具在目標伺服器上找到的每個 SQL Server 實例的 SPN 資訊。 同時也提供所需SPN及其狀態等細節。 每一列都有 生成 和 修正 按鈕。
  • 委派:識別影響服務帳號委派設定的問題。

生成一個 SPN 生成指令碼

在 SPN 標籤中使用 Generate 來尋找缺少的 SPN,並建立一個可以在命令提示字元執行的腳本:

  1. 在 SPN 索引標籤的 SPN 指令碼 欄位中,針對您想要產生指令碼的 SPN,選取 Generate。

  2. 在開啟的對話框中,輸入名稱(此例為 generateSPNss),將「另存為類型」設為 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」選項螢幕快照。

注意

此工具僅針對具有靜態埠的默認實例和具名實例,提供 Fix 和 Generate 命令。 對於使用動態埠的命名實例,我們建議你從動態埠切換到靜態埠,或提供服務帳號權限,每次 SQL Server 服務啟動時都能註冊或取消註冊 SPN。 否則,服務開始時你必須手動取消註冊並重新註冊對應的 SPN。 如需詳細資訊,請參閱 註冊 Kerberos 連線的服務主體名稱。

檢查委派設定

使用 委派 來識別影響服務帳號委派設定的問題。 此選項對於排查連結伺服器問題特別有用。 例如,如果 SPN 檢查通過但連結伺服器查詢仍失敗,服務帳號可能未設定為委派憑證。 欲了解更多資訊,請參閱連結的伺服器(資料庫引擎)及 SQL Server 認證中連結的伺服器連線問題。

[委派] 索引標籤的螢幕快照。

解讀並依據 Kerberos 設定管理員 的診斷採取行動

請透過檢查 狀態 欄來查看工具中的診斷結果。 根據狀態,依照適當的步驟解決問題。 以下章節將描述每種狀態。

狀態:良好

詳細資訊:已正確設定核取的專案。 移至輸出中的下一個專案。

操作:不需要採取任何操作。

狀態:缺少所需 SPN

更多資訊:如果 Active Directory 中 SQL Server 啟動帳號缺少「必要 SPN」欄位中列出的 SPN,就會出現這個狀態。

操作:依照以下步驟新增缺少的 SPN,並確認問題已解決:

  1. 選取 [修正] 以檢閱 警告 對話框中的資訊。
  2. 選取 [ 是 ] 以將遺漏的 SPN 新增至 Active Directory。
    • 如果你的網域帳號有更新 Active Directory 的必要權限,工具會將所需的 SPN 加入 Active Directory。
    • 如果您的網域帳號沒有更新 Active Directory 的必要權限,請使用 Generate 或 Generate All 來產生腳本,以協助 Active Directory 管理員新增缺少的 SPN。
  3. 新增SPN之後,請再次執行 Kerberos 設定管理員 以確認SPN問題已解決。

狀態:必須啟用 TCP 才能使用 Kerberos 設定

更多資訊:如果用戶端電腦未啟用 TCP,此狀態會出現。

動作:請遵循下列步驟來啟用 SQL Server 實例的 TCP/IP 通訊協定:

  1. 在 SQL Server 組態管理員 - 主控台中,展開 SQL Server 網路組態。
  2. 在主控台中,選取通訊協定以進行<instance name>。
  3. 在 詳細資料中,選擇 TCP/IP,然後選擇 啟用。
  4. 在 [控制台] 中,選取 [ SQL Server 服務]。
  5. 在 <instance name> 中,為 選取 SQL Server。
  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 位址。 針對設定為 Enabled 的位址,請移除 TCP 動態埠 中的目前值,然後在 TCP 連接埠 中設定值。
  7. 選取 [ 確定],然後重新啟動 SQL Server 實例,讓設定生效。 欲了解更多資訊,請參閱 「設定伺服器監聽特定 TCP 埠」。

狀態:重複 SPN

更多資訊:若同一 SPN 在 Active Directory 中以不同帳號註冊,此狀態會出現。

操作:請依照以下步驟移除 Active Directory 中的重複 SPN:

  1. 選取 修正。
  2. 檢查 警告 對話方塊中的資訊。
  3. 選擇「是」以移除 Active Directory 中錯誤的 SPN。
    • 如果你的網域帳號有更新 Active Directory 的必要權限,工具就會刪除錯誤的 SPN。
    • 如果你的網域帳號沒有更新 Active Directory 的必要權限,請使用 Generate 或 Generate All,產生一個腳本,然後交給你的 Active Directory 管理員,用來移除重複的 SPN。
  4. SPN 移除後,再次執行 Kerberos 設定管理員 以確認 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 設定管理員 中的額外選項

從命令列產生 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 設定管理員 產生的 XML 檔案。

查看工具的日誌檔案

預設情況下,每次執行應用程式時,工具都會產生新的日誌檔。 你可以在你的應用程式資料資料夾中找到日誌檔案: %APPDATA%\Microsoft\KerberosConfigMgr。

尋求幫助

可採用以下任一方法:

  • 將滑鼠指標移到指令上,即可顯示提示。
  • 在命令提示字元中執行 KerberosConfigMgr.exe -h 。
  • 選取工具列上的 [說明] 按鈕。