# 設定目錄身分來源並同步使用者

Canonical: https://www.nsecsoft.com/tw/docs/ping64-identity-access/iam/users/directory-identity-source/

Language: zh-TW

Updated: 2026-11-15T04:09:23.891997Z

身分來源用於將目錄中的使用者、使用者群組及相關關係同步至統一身分目錄。儲存設定、測試連線、預覽同步與執行同步是不同步驟；任何一步成功都不能單獨證明使用者已同步完成或已取得應用程式存取權限。

以下介紹 AD 網域目錄和 LDAP 目錄。身分來源與 AD 網域管理中的目錄設定屬於不同管理入口；即使使用同一目錄服務，也應分別確認用途、連線與同步範圍，不假設一處已完成另一處設定。

## 設定前準備

-   確認管理員具備檢視、設定、預覽與同步身分來源所需權限；同步與刪除可能需要額外權限。
-   與目錄管理員確認伺服器、連接埠、憑證、繫結帳戶、同步根目錄、使用者與群組範圍及篩選條件。繫結帳戶應具備必要的目錄讀取權限，並依組織規定保護密碼。
-   確保平台能連接目錄服務，所選安全連線方式的憑證鏈與主機名稱可通過驗證。準備小範圍試點、測試帳戶及變更復原方案。
-   若目錄連線被其他設定使用，修改前與維護人員協調。縮小範圍或修改篩選可能使原有同步使用者或群組不再符合條件，影響其狀態及業務存取；先評估影響，不直接對完整目錄試行。

## 設定並測試身分來源

1.  在統一身分管理的身份目錄中開啟身分來源，選擇「新增身分來源」，選擇 「AD 網域目錄」或 LDAP 目錄。已建立的來源不能在編輯時直接切換類型。
2.  在「設定連線」填寫名稱並選擇目錄來源設定方式。「建立或維護目錄來源連線」會在儲存身分來源時建立或更新連線；「使用既有目錄來源」則由所選來源提供連線設定。使用或修改共用連線前先確認其他使用方。
3.  若自行維護連線，選擇 LDAPS 或 StartTLS，填寫伺服器、連接埠、繫結帳戶與密碼，並核對憑證驗證。編輯現有連線時密碼留空會保留原密碼；更換時填寫新密碼。使用現有目錄來源時，核對所選連線及其維護安排。
4.  在「同步範圍」核對同步根目錄、使用者與群組範圍及篩選條件。依組織驗證方案決定是否啟用「業務使用者委派認證」；僅需同步時，不應假設必須啟用。
5.  選擇「測試設定」並檢查結果；失敗時修正後重新測試。在預覽確認步驟檢查摘要並儲存。測試通過不代表目錄物件已同步或業務登入可用。

## 預覽並執行同步

1.  返回來源清單，重新開啟已儲存來源，在預覽確認步驟選擇「預覽同步」。新來源須先儲存；編輯時預覽使用已儲存設定，不代表尚未儲存的修改。
2.  檢查連接器狀態、新增與衝突等結果。頁面請求預覽最多 200 個物件，不能視為已逐項核驗完整目錄；如有衝突，先由管理員確認對應關係及處理方案。
3.  核對試點範圍後，在來源清單的操作選單選擇「同步」。「同步已觸發」表示任務已提交，不代表已完成；如提示「已有同步任務在執行」，應等待並查看狀態。
4.  查看同步狀態及最後同步時間；完成後在使用者管理核對預期使用者與群組，並檢查失敗或衝突資訊。對缺失物件先檢查範圍、篩選、繫結帳戶讀取權限及任務結果，再決定是否調整並重新同步。
5.  需要存取應用程式的同步使用者仍須在目標應用程式設定存取範圍並驗證身分串接。可參考[使用者帳戶與應用程式存取](https://www.nsecsoft.com/tw/docs/ping64-identity-access/iam/users/user-accounts/)，核對指定使用者或實際所屬群組、應用程式狀態及受控登入結果；同步完成不會自動授予所有應用程式存取權限。

\*\*變更範圍的重要提示：\*\*預覽依據當時讀取的物件產生，不會完整列出因新範圍或篩選條件而未讀入的既有使用者與群組；預覽未顯示停用項目，不代表實際同步不會停用物件。同步可能停用先前同步的使用者或群組，並影響使用者現有工作階段與應用程式存取。變更範圍前，應與目錄管理員核對既有同步清單、預期範圍及重要帳號，準備經核准的復原方案；先小範圍驗證，再於同步後分別確認使用者、群組及業務存取。

\*\*衝突與空結果：\*\*預覽頁面顯示狀態、新增數量及衝突數量等摘要，不提供衝突物件明細或連結操作。使用者名稱或電子郵件與現有使用者重複，或使用者群組名稱與現有群組衝突時，實際同步會略過衝突物件，不會自動連結至現有物件。即使工作顯示完成，也應確認重要使用者、群組及成員關係；發生衝突時，應與目錄管理員及技術支援確認處理方式，不要僅憑名稱認定為同一物件。若同步完全未讀取到物件，本次不會更新物件或停用缺失物件，因此工作完成不代表原有使用者已清除。應檢查範圍、篩選與讀取權限，確認預期資料後再同步。

\*\*目錄群組與應用程式授權：\*\*對使用 OIDC 的應用程式，依群組授權會檢查使用者在統一身分管理中的管理分組，不會直接使用目錄同步的群組成員關係。新同步建立的使用者初始沒有管理分組；僅同步目錄群組並在應用程式中選取該群組，不保證成員取得存取權限。若需依群組授權，先在「用戶管理」確認，並依組織要求設定使用者的管理分組，再儲存應用程式的指定存取範圍；也可依需要在應用程式中直接指定獲准使用者。變更分組或授權前應評估影響，完成後分別使用獲准及未獲准帳號驗證。

## 修改與排查

-   \*\*修改連線或範圍：\*\*先確認連線是否共用，評估現有使用者、群組及業務存取；儲存後重新測試、預覽並檢查同步結果。
-   \*\*連線測試失敗：\*\*檢查地址、連接埠、網路、憑證鏈及主機名稱、繫結帳戶與密碼；不要為通過測試而忽略憑證問題。
-   \*\*預覽有衝突：\*\*不要僅憑預覽擴大同步範圍；核對目錄物件與現有使用者的對應關係並確認處理方案。
-   \*\*任務已觸發但物件未出現：\*\*檢查任務是否完成、範圍、篩選及讀取權限；成功提交不等於同步完成。
-   \*\*同步使用者無法存取應用程式：\*\*分別檢查使用者狀態、應用程式存取範圍、驗證串接及實際登入結果；同步或委派驗證不等同應用程式授權。
