使用AEM 6配置LDAP configuring-ldap-with-aem

CAUTION
AEM 6.4已結束延伸支援,本檔案不再更新。 如需詳細資訊,請參閱 技術支援期. 尋找支援的版本 此處.

LDAP( L ​八八 D ​記錄 A ​存取 P rotocol)用於訪問集中目錄服務。 這有助於減少管理多個應用程式可存取的使用者帳戶所需的工作量。 Active Directory是此類LDAP伺服器。 LDAP通常用於實現單一登錄,該登錄允許用戶在登錄後訪問多個應用程式。

可在LDAP伺服器和儲存庫之間同步用戶帳戶,並將LDAP帳戶詳細資訊保存在儲存庫中。 這可讓帳戶指派給存放庫群組,以分配所需的權限。

儲存庫使用LDAP驗證來驗證此類用戶,並將憑據傳遞到LDAP伺服器進行驗證,這是允許訪問儲存庫之前所需的。 為了改善效能,存放庫可快取成功驗證的憑證,並設定到期逾時,以確保在適當的期間後會進行重新驗證。

從LDAP伺服器中刪除帳戶時,不再授予驗證權,因此對儲存庫的訪問被拒絕。 也可清除儲存庫中儲存的LDAP帳戶的詳細資訊。

這些帳戶的使用對您的用戶是透明的,他們發現從LDAP建立的用戶和組帳戶與僅在儲存庫中建立的用戶和組帳戶之間沒有區別。

在AEM 6中,LDAP支援隨附新實作,其需要的組態類型與舊版不同。

所有LDAP設定現在都可作為OSGi設定使用。 可透過Web管理控制台進行設定:
https://serveraddress:4502/system/console/configMgr

若要讓LDAP與AEM搭配使用,您需要建立三個OSGi設定:

  1. LDAP身分提供者(IDP)。
  2. 同步處理程式。
  3. 外部登入模組。
NOTE
Watch [Oak的外部登入模組 — 使用LDAP及更新進行驗證]https://experienceleague.adobe.com/docs/experience-manager-gems-events/gems/gems2015/aem-oak-external-login-module-authenticating-with-ldap-and-beyond.html?lang=zh-Hant)深入探討外部登入模組。
若要閱讀使用Apache DS配置Experience Manager的範例,請參閱 配置Adobe Experience Manager 6.4以使用Apache Directory Service。

配置LDAP標識提供程式 configuring-the-ldap-identity-provider

LDAP標識提供程式用於定義如何從LDAP伺服器檢索用戶。

您可在管理主控台的 Apache Jackrabbit Oak LDAP身分提供程式 名稱。

LDAP標識提供程式可使用以下配置選項:

LDAP提供程式名稱
此LDAP提供程式配置的名稱。
LDAP伺服器主機名
LDAP伺服器的主機名
LDAP伺服器埠
LDAP伺服器的埠
使用SSL
指示是否應使用SSL(LDAP)連接。
使用TLS
指出是否應在連線上啟動TLS。
禁用證書檢查
指示是否應禁用伺服器證書驗證。
綁定DN
用於驗證的用戶的DN。 如果保留為空,則將執行匿名綁定。
綁定密碼
用於驗證的用戶密碼
搜尋逾時
搜索超時的時間
管理池最大活動
管理連接池的最大活動大小。
用戶池最大活動
用戶連接池的最大活動大小。
用戶庫DN
用戶搜索的DN
用戶對象類
用戶條目必須包含的對象類清單。
使用者ID屬性
包含用戶ID的屬性名稱。
使用者額外篩選
搜尋使用者時要使用的額外LDAP篩選器。 最終篩選器的格式如下:'(&(<idattr>=<userid>)(objectclass=<objectclass>)<extrafilter>)'(user.extraFilter)
用戶DN路徑
控制是否應使用DN來計算中間路徑的一部分。
組基DN
組搜索的基本DN。
組對象類
組條目必須包含的對象類清單。
組名屬性
包含組名的屬性的名稱。
分組額外篩選
搜尋群組時要使用的額外LDAP篩選器。 最終篩選器的格式如下:'(&(<nameattr>=<groupname>)(objectclass=<objectclass>)<extrafilter>)'
組DN路徑
控制是否應使用DN來計算中間路徑的一部分。
組成員屬性
包含組成員的組屬性。

配置同步處理程式 configuring-the-synchronization-handler

同步處理程式將定義如何與儲存庫同步身份提供程式用戶和組。

位於 Apache Jackrabbit Oak Default同步處理常式 名稱。

以下配置選項適用於同步處理程式:

同步處理程式名稱
同步配置的名稱。
使用者過期時間
持續時間,直到同步的使用者過期。
用戶自動成員資格
已自動新增同步使用者的群組清單。
用戶屬性映射
外部屬性的本地屬性的清單映射定義。
用戶路徑前置詞
建立新使用者時使用的路徑首碼。
使用者成員資格有效期
會籍過期的時間。
用戶成員資格嵌套深度
傳回同步成員關係時的群組巢狀深度上限。 值0有效地禁用組成員資格查找。 值1隻會新增使用者的直接群組。 此值僅在同步使用者成員資格祖先時才會在同步個別群組時失效。
組到期時間
持續時間,直到同步的群組過期。
群組自動成員資格
同步組自動添加到的組清單。
組屬性映射
外部屬性的本地屬性的清單映射定義。
組路徑前置詞
建立新群組時使用的路徑首碼。

外部登入模組 the-external-login-module

外部登入模組位於 Apache Jackrabbit Oak External登入模組 下。

NOTE
Apache Jackrabbit Oak外部登入模組會實作Java驗證和授權服務(JAAS)規格。 請參閱 官方OracleJava安全參考指南 以取得更多資訊。

其工作是定義要使用的身份提供程式和同步處理程式,有效綁定這兩個模組。

可使用下列設定選項:

JAAS排名
指定此登錄模組條目的排名(即排序順序)。 項目會以遞減順序排序(亦即值排名設定會排在第一)。
JAAS控制標幟
指定LoginModule是否為必需、必要、充分或可選的屬性。有關這些標誌含義的詳細資訊,請參閱JAAS配置文檔。
JAAS王國
註冊LoginModule時所依據的領域名稱(或應用程式名稱)。 如果未提供領域名稱,則LoginModule將註冊為Felix JAAS配置中配置的預設領域。
身份提供程式名稱
身份提供程式的名稱。
同步處理程式名稱
同步處理程式的名稱。
NOTE
如果您打算使用AEM執行個體建立多個LDAP設定,則需要為每個設定建立個別的身分提供者和同步處理常式。

通過SSL配置LDAP configure-ldap-over-ssl

AEM 6可透過SSL設定以透過LDAP驗證,方法如下:

  1. 檢查 使用SSL使用TLS 配置時的複選框 LDAP標識提供程式.

  2. 根據您的設定配置同步處理程式和外部登錄模組。

  3. 視需要在您的Java VM中安裝SSL憑證。 這可透過使用鍵具來完成:

    keytool -import -alias localCA -file <certificate location> -keystore <keystore location>

  4. 測試與LDAP伺服器的連接。

建立SSL憑證 creating-ssl-certificates

在設定AEM以透過SSL透過LDAP驗證時,可使用自行簽署的憑證。 以下是產生要與AEM搭配使用之憑證的工作程式範例。

  1. 請確定您已安裝SSL程式庫且運作正常。 此程式將以OpenSSL為例。

  2. 建立自訂的OpenSSL設定(cnf)檔案。 複製預設的​ openssl.cnf ​ 設定檔案並自訂,即可完成此操作。 在UNIX系統上,它通常位於 /usr/lib/ssl/openssl.cnf

  3. 在終端中運行以下命令,繼續建立CA根密鑰:

    code language-none
    openssl genpkey -algorithm [public key algorithm] -out certificatefile.key -pkeyopt [public key algorithm option]
    
  4. 接下來,建立新的自簽名證書:

    openssl req -new -x509 -days [number of days for certification] -key certificatefile.key -out root-ca.crt -config CA/openssl.cnf

  5. Inspect新產生的憑證,以確保一切都順序:

    openssl x509 -noout -text -in root-ca.crt

  6. 請確定憑證設定(.cnf)檔案中指定的所有資料夾都存在。 否則,請建立。

  7. 例如,執行以建立隨機種子:

    openssl rand -out private/.rand 8192

  8. 將建立的.pem檔案移至.cnf檔案中設定的位置。

  9. 最後,將憑證新增至Java金鑰存放區。

啟用偵錯記錄 enabling-debug-logging

可以為LDAP身分提供程式和外部登錄模組啟用調試日誌記錄,以便對連接問題進行故障排除。

若要啟用偵錯記錄,您必須:

  1. 前往Web管理控制台。
  2. 尋找「Apache Sling Logging Logger Configuration」並使用下列選項建立兩個記錄器:
  • 記錄層級:除錯

  • 記錄檔logs/ldap.log

  • 消息模式:{0,date,dd.MM.yyyy HHss.SSS} *{4}*{2}

  • 記錄器:org.apache.jackrabbit.oak.security.authentication.ldap

  • 記錄層級:除錯

  • 日誌檔案:logs/external.log

  • 消息模式:{0,date,dd.MM.yyyy HHss.SSS} *{4}*{2}

  • 記錄器:org.apache.jackrabbit.oak.spi.security.authentication.external

關於團體隸屬關係的一個詞 a-word-on-group-affiliation

透過LDAP同步的使用者可以是AEM中不同群組的一部分。 這些組可以是將作為同步過程的一部分添加到AEM的外部LDAP組,但也可以是單獨添加的組,而不是原始LDAP組關聯方案的一部分。

在大多數情況下,這些群組可以是由本機AEM管理員或任何其他身分提供者新增的群組。

如果從LDAP伺服器上的組中刪除了用戶,則同步時,該更改也將反映在AEM端。 但是,未由LDAP添加的用戶的所有其他組從屬關係將保持不變。

AEM會利用 rep:externalId 屬性。 此屬性將自動添加到由同步處理程式同步的任何用戶或組中,並包含有關原始身份提供程式的資訊。

如需詳細資訊,請參閱Apache Oak檔案,位於 用戶和組同步.

已知問題 known-issues

如果您打算使用LDAP over SSL,請確保您使用的證書建立時沒有Netscape注釋選項。 如果啟用此選項,驗證將會因SSL握手錯誤而失敗。

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8