將 ownCloud Infinite Scale 連接到 LDAP 以實現使用者登入

若要將現有的 LDAP 目錄與 ownCloud Infinite Scale (oCIS) 搭配使用,請設定其內建的 OpenID Connect 身分提供者 (IDP) 以透過 LDAP 對使用者進行驗證,然後將使用者、群組和驗證服務指向相同目錄。 LDAP 的配置並非透過經典伺服器風格的管理精靈完成。具體設定取決於您的 oCIS 版本和目錄架構;本參考文件基於 ownCloud 8.2 服務文件和 Docker Compose 風格的環境變數。

了解 oCIS 中「LDAP 身份驗證」的含義

oCIS 將瀏覽器登入與尋找使用者和群組的服務分開。內建的身分提供者 (IDP) 可以使用 LDAP 進行使用者驗證並頒發 OIDC 令牌;諸如 Graph 和 Users 之類的服務也需要相符的 LDAP 連線和屬性設定才能解析身分。 Auth Basic 服務為需要的用戶端處理 HTTP 基本驗證;這是一個獨立的路徑。操作:在變更配置之前,請確定您需要瀏覽器登入、特定用戶端的基本驗證,還是兩者都需要。

ownCloud 8.2 文件介紹了一種適用於小型環境的嵌入式身分提供者 (IDP) 和身分管理 (IDM) 方案,但建議企業級部署使用企業級外部身分提供者。如果您已經在使用 Keycloak 或 Active Directory Federation Services 等線上身分提供者 (OIDC),那麼整合該提供者可能比直接使用 LDAP 作為登入授權更合適。操作:在部署之前,請參考相關的 ownCloud 部署指南,確認您的架構和支援的版本。

首先收集目錄詳細資料。

向 LDAP 管理員索取伺服器主機名稱和連接埠、TLS 憑證鏈、綁定帳戶 DN 和密碼、使用者搜尋基準、登入屬性、唯一使用者 ID 屬性、電子郵件和顯示名稱屬性、使用者物件類別以及任何所需的使用者篩選條件。如果群組應出現在 oCIS 中,則還需收集群組基準 DN、物件類別、名稱屬性、成員屬性和穩定群組 ID 屬性。

  • 使用專用的最小權限綁定帳戶進行尋找。
  • ldaps://根據您的目錄策略,優先選擇LDAP 或使用 StartTLS,並將頒發 CA 憑證安裝在 oCIS 容器可以讀取的位置。
  • 選擇一個穩定且唯一的使用者識別碼。不要在使用者開始使用實例後隨意更改 ID 屬性。
  • 檢查 oCIS 主機或容器是否可以解析並連接到 LDAP 伺服器,以及防火牆規則是否允許所選的 LDAP TLS 連接埠。

OpenLDAP、Active Directory 和自訂目錄的模式名稱各不相同。 ownCloud 的範例預設值(例如 `<path>` inetOrgPerson、uid`<path>` 和 ` <custom-directory>`)ownCloudUUID並非通用。建議:在生產環境部署前,使用具有代表性的測試帳戶,並根據實際目錄條目驗證每個屬性。

配置內建身分提供者

對於 Docker Compose,環境變數應配置在ocis服務上。以下是一個模板,並非直接適用的配置:請將每個範例值替換為您目錄中的實際設置,並將 CA 檔案掛載到容器中指定的路徑。

services:
  ocis:
    environment:
      IDP_LDAP_URI: ldaps://ldap.example.org:636
      IDP_LDAP_TLS_CACERT: /etc/ocis/ldap-ca.pem
      IDP_LDAP_BIND_DN: cn=ocis-reader,ou=service-accounts,dc=example,dc=org
      IDP_LDAP_BIND_PASSWORD: ${OCIS_LDAP_BIND_PASSWORD}
      IDP_LDAP_BASE_DN: ou=people,dc=example,dc=org
      IDP_LDAP_LOGIN_ATTRIBUTE: uid
      IDP_LDAP_OBJECTCLASS: inetOrgPerson
      IDP_LDAP_UUID_ATTRIBUTE: entryUUID
      IDP_LDAP_EMAIL_ATTRIBUTE: mail
      IDP_LDAP_NAME_ATTRIBUTE: displayName
      IDP_USER_ENABLED_ATTRIBUTE: ownCloudUserEnabled

以上設定涵蓋了身分提供者 (IDP) 端的 LDAP 查找和登入。密碼以環境變數替換的形式顯示,因此無需將其硬編碼到 Compose 檔案中,但請保護環境變數檔案或使用部署平台的金鑰管理功能。 CA 路徑必須存在於容器內部,而不僅僅是在主機上。操作:以唯讀方式掛載 CA,並在重啟 oCIS 之前確認容器使用者可以讀取它。

請使用您實際啟用/停用的屬性及其值。文件中IDP_USER_ENABLED_ATTRIBUTE已將此屬性命名為「enabled」;「enabled」的含義取決於架構和實作。如果您的目錄中未使用此設置,請勿自行建立值:請查閱您所使用版本的服務文件。操作:測試已啟用和已停用的帳戶,以驗證存取原則。

保持身份查找和身份驗證的一致性

單獨變更身分提供者 (IDP) 設定可能會導致憑證驗證失敗,而 oCIS 的其他部分卻無法解析相同使用者或群組。使用者服務擁有自己的 LDAP 變量,包括USERS_LDAP_URI`users`、USERS_LDAP_CACERT` USERS_LDAP_BIND_DNgroups`、USERS_LDAP_BIND_PASSWORD`groups` 和 ` groups`。 GraphUSERS_LDAP_USER_BASE_DN使用對應的GRAPH_LDAP_*選項來控制使用者和群組查詢。如果這些服務包含在您的部署中,請將它們設定為相同的目錄和相容的架構。

例如,將 IDP 和 Graph 中的使用者基本 DN 和穩定 ID 屬性進行匹配,然後將 Graph 的群組基本 DN 和成員屬性設定為與您的 LDAP 記錄匹配。 Graph 服務文件指出其 LDAP 後端是預設後端,並單獨列出了伺服器寫入設定。操作:如果目錄在其他位置具有權威性,則首先使用唯讀查找;當 oCIS 不得建立或修改目錄使用者和群組時,請設定GRAPH_LDAP_SERVER_WRITE_ENABLED為「不允許」。false

僅AUTH_BASIC_AUTH_PROVIDER=ldap當您的用戶端確實需要 HTTP 基本驗證時才進行設定。 ownCloud 文件指出,必須在代理伺服器上啟用基本驗證PROXY_ENABLE_BASIC_AUTH=true;它不能取代正常的 OIDC 瀏覽器登入。操作:除非特定用戶端需要,否則請保持基本驗證停用狀態,並在啟用前評估其安全隱患。

重新啟動、測試和故障排除

  1. 驗證 Compose 文件,並確認變數已附加到正確的服務。
  2. 使用正常的部署流程重新啟動或重新部署 oCIS,以便服務載入新值。
  3. 檢查啟動日誌和服務日誌,尋找 LDAP 連線、綁定、憑證和搜尋錯誤。
  4. 透過網頁介面測試已知使用者登錄,然後驗證使用者設定檔和預期群組是否解析。
  5. 測試無效密碼和已停用使用者。確認兩者都無法存取。

如果連線失敗,請從容器內部驗證 DNS 和網路可及性,確保 LDAPS 主機名稱與憑證匹配,CA 鏈受信任,並且綁定 DN 和密碼正確。 LDAP 綁定成功並不能證明使用者搜尋基準或登入屬性正確。如果登入成功但使用者或群組資料缺失,請比較 IDP、使用者和 Graph 設置,並檢查它們各自的日誌。操作:每次只測試一個服務和一個測試帳戶,而不是放寬 TLS 驗證,從而隔離故障。

請勿在生產環境中設定 LDAP TLS 驗證繞過選項。 ownCloud 會明確警告使用者不要使用不安全的 LDAP 憑證設定。請保留一個恢復管理員帳戶以及先前正常工作的配置副本,直到驗證登入和群組解析無誤為止。操作:首先在暫存環境中套用更改,然後在管理員可以隨時恢復先前環境的視窗期內進行全面部署。

官方參考資料

留下評論

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。

將 ownCloud Infinite Scale 連接到 LDAP 以實現使用者登入

在部署之前,配置 oCIS LDAP 登錄,調整使用者和群組查找,並驗證 TLS 和架構設定。

將 S3 儲存桶連接到 ownCloud 10 作為外部存儲

將 S3 儲存桶連接到 ownCloud 10 作為外部存儲

將 Amazon S3 儲存桶新增至 ownCloud 10,準備相容的憑證和端點,並檢查存取權限,避免將掛載點與主儲存點混淆。

使用安全的夜間定時任務自動執行 ownCloud 資料庫轉儲

使用安全的夜間定時任務自動執行 ownCloud 資料庫轉儲

為 ownCloud Server 安排受保護的 MariaDB 轉儲,安全地處理維護模式,並在依賴每個備份之前進行驗證。

使用受支援的遷移將 ownCloud Classic 遷移到 oCIS

使用支援的應用程式、有序的命令、身份驗證以及需要單獨處理的資料的明確列表,規劃 ownCloud 10 到 oCIS 的遷移。

帶有主題應用程式和 CSS 的品牌 ownCloud Classic 10

使用主題應用程式取代 ownCloud Classic 10 標誌並調整 Web UI 顏色,同時避免升級和完整性檢查陷阱。

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

按角色為新的 ownCloud Infinite Scale 使用者指派基於位元組的儲存限制,並提供 proxy.yaml 範例和安全性驗證清單。

修正 TLS 來源端的 ownCloud 同步憑證錯誤

修正 TLS 來源端的 ownCloud 同步憑證錯誤

透過檢查伺服器主機名稱、憑證鏈、私有 CA 信任和強制入口網站問題,恢復 ownCloud 桌面同步,而無需停用 TLS 驗證。

升級後清除 ownCloud 完整性警告

使用無效文件報告來識別不匹配的核心文件或應用程式簽名,恢復正確的發布文件,並安全地驗證完整性檢查。

使用 Docker Compose 安裝 ownCloud Infinite Scale

從官方 Compose 範例部署 ownCloud Infinite Scale,配置網域和持久存儲,然後驗證 TLS、容器和首次登入。