跳至主要内容

設定 OpenLDAP

如果您的組織使用 LDAP 進行使用者身份驗證,您可以設定 Rancher 與 OpenLDAP 伺服器通訊以驗證使用者。這允許 Rancher 管理員根據在組織中央使用者儲存庫中外部管理的使用者和群組來控制對叢集和專案的存取,同時允許終端使用者在登入 Rancher UI 時使用其 LDAP 憑證進行身份驗證。

先決條件​

Rancher 必須設定 LDAP 綁定帳戶(又稱服務帳戶)以搜尋和擷取與應具有存取權限的使用者和群組相關的 LDAP 條目。建議不要為此目的使用管理員帳戶或個人帳戶,而是在 OpenLDAP 中建立一個專用帳戶,該帳戶對設定的搜尋基底下的使用者和群組具有唯讀存取權限(見下文)。

使用 TLS?

如果 OpenLDAP 伺服器使用的憑證是自簽名的或不是來自認可的憑證授權機構,請確保您擁有 PEM 格式的 CA 憑證(與任何中繼憑證串接)。您必須在設定期間貼上此憑證,以便 Rancher 能夠驗證憑證鏈。

在 Rancher 中設定 OpenLDAP​

設定 OpenLDAP 伺服器、群組和使用者的設定。如需填寫每個欄位的幫助,請參閱設定參考。

在您繼續進行設定之前,請先熟悉外部身份驗證設定和主要使用者的概念。

  1. 在左上角,點擊 ☰ > Users & Authentication。
  2. 在左側導覽選單中,點擊 Auth Provider。
  3. 點擊 OpenLDAP。填寫 Configure an OpenLDAP server 表單。
  4. 點擊 Enable。

測試身份驗證​

完成設定後,請繼續測試與 OpenLDAP 伺服器的連線。如果測試成功,OpenLDAP 身份驗證將隱式啟用。

備註

在此步驟中輸入的憑證所屬的 OpenLDAP 使用者將映射到本機主要帳戶,並在 Rancher 中被指派管理員權限。因此,您應該有意識地決定使用哪個 LDAP 帳戶來執行此步驟。

  1. 為應映射到本機主要帳戶的 OpenLDAP 帳戶輸入 username 和 password。
  2. 點擊 Authenticate With OpenLDAP 以測試 OpenLDAP 連線並完成設定。

結果:

  • OpenLDAP 身份驗證已設定。
  • 與輸入的憑證相關的 LDAP 使用者已映射到本機主要(管理)帳戶。
備註

如果 LDAP 服務中斷,您仍然可以使用本機設定的 admin 帳戶和密碼登入。

附錄:疑難排解​

如果您在測試與 OpenLDAP 伺服器的連線時遇到問題,請先仔細檢查為服務帳戶輸入的憑證以及搜尋基底設定。您還可以檢查 Rancher 日誌以幫助確定問題原因。除錯日誌可能包含有關錯誤的更詳細資訊。請參閱本文件中的如何啟用除錯日誌記錄。