用戶同步

簡介

當部署為publish farm時，成員必須能夠登入並查看其任何發佈節點上的資料。

作者環境不需要在發佈環境中建立的使用者和使用者群組（使用者資料）。

在作者環境中建立的大部分使用者資料都會保留在作者環境中，而不會複製至發佈例項。

在一個發佈實例上進行的註冊和修改必須與其他發佈實例同步，以便它們能夠訪問相同的用戶資料。

自AEM 6.1起，當啟用使用者同步時，使用者資料會自動在群組中的發佈執行個體間同步，而不會在作者上建立。

Sling Distribution

用戶資料及其ACL儲存在Oak Core（Oak JCR下的層）中，並使用Oak API訪問。 對於不頻繁的更新，使用Sling Content Distribution(Sling distribution)將使用者資料與其他發佈例項同步是合理的。

使用Sling散發的使用者同步的優點，與傳統複製相比有：

  • 使用者、使 用者 分析和 在發佈 時建立的使用者群組不會在作者上建立

  • Sling distribution會在jcr事件中設定屬性，讓您在發佈端事件接聽程式中運作成為可能，而不需擔心無限的複製回圈

  • Sling散發只會傳送使用者資料至非原始發佈例項，以消除不必要的流量

  • 用戶 節點中的ACLsset包含在同步中

注意

如果需要會話，建議使用SSO解決方案或使用嚴格會話，如果客戶切換到其他發佈者，請讓他們登錄。

注意

即使啟用了用戶同步，*administrators *group也不支援同步。 相反，錯誤日誌中將記錄「導入差異」失敗。

因此，當部署為發佈群時，如果將用戶添加到​*administrators group或從<a0/>管理員中刪除，則必須在每個發佈實例上手動進行修改。

啟用用戶同步

注意

依預設，使用者同步為disabled。

啟用用戶同步涉及修改​existing OSGi配置。

啟用使用者同步後，不應新增任何新的設定。

使用者同步需仰賴作者環境來管理使用者資料分發，即使使用者資料並非由作者建立。 許多（但並非全部）配置都發生在作者環境中，每個步驟都清楚地識別要在作者或發佈上執行。

以下是啟用用戶同步的必要步驟，後面是Troubleshooting部分：

必備條件

  1. 如果使用者和使用者群組已在一個發佈者上建立，建議在設定並啟用使用者同步之前，手動將使用者資料同步至所有發佈者。

    啟用使用者同步後，僅會同步新建立的使用者和群組。

  2. 請確定已安裝最新的代碼：

1.Apache Sling Distribution Agent - Sync Agents Factory

啟用使用者同步

  • 在作者上

chlimage_1-387

2.建立授權用戶

設定
權限此授權使用者將用於步驟3，以設定Sling散發給作者。

注意

必須建立新用戶。

  • 指派的預設使用者為​**admin**。
  • 請勿使用*communities-user-admin *user*.*

如何添加ACL

  • 存取CRXDE Lite

  • 選擇/home節點

  • 在右窗格中，選擇Access Control頁籤

  • 選擇+按鈕以添加ACL條目

    • 負責人: 搜索為用戶同步建立的用戶
    • 類型: Allow
    • 權限: jcr:all
    • 限 制代表：glob: */activities/*
    • 選擇​確定

  • 選擇​保存全部

chlimage_1-388

另請參閱

3.Adobe Granite Distribution —— 加密密碼傳輸機密提供者

設定權限

一旦在所有發佈實例上建立了​administrators​用戶組的授權用戶，該授權用戶必須在作者上被標識為具有從作者同步用戶資料到發佈的權限。

  • 在作者上

    • 以管理員權限登入

    • 訪問Web控制台

    • 找到Adobe Granite Distribution - Encrypted Password Transport Secret Provider

    • 選取要開啟以進行編輯的現有設定（鉛筆圖示）

      驗證 property name : socialpubsync-publishUser

    • 在步驟2中，將用戶名和密碼設定為在發佈時建立的授權用戶

      • 例如，usersync-admin

chlimage_1-389

4.Apache Sling Distribution Agent - Queue Agents Factory

啟用使用者同步

  • 發佈時 :

    • 以管理員權限登入

    • 訪問Web控制台

    • 找到Apache Sling Distribution Agent - Queue Agents Factory

      • 選取要開啟以進行編輯的現有設定（鉛筆圖示）

        驗證 Name : socialpubsync-reverse

      • 選中Enabled複選框

      • 選擇Save

    • 重 復每個發佈實例

chlimage_1-390

5.Adobe Granite Distribution - Diff Observer Factory

啟用群組同步

  • 在每個發佈例項上 :

    • 以管理員權限登入

    • 訪問Web控制台

    • 找到Adobe Granite Distribution - Diff Observer Factory

      • 選取要開啟以進行編輯的現有設定（鉛筆圖示）

        驗證 agent name : socialpubsync-reverse

      • 選中Enabled複選框

      • 選擇Save

chlimage_1-391

6.Apache Sling Distribution Trigger - Scheduled Triggers Factory

（可選）修改輪詢間隔

依預設，作者每30秒就會對變更進行民調問答。 要更改此間隔：

  • 在作者上

    • 以管理員權限登入

    • 訪問Web控制台

    • 找到Apache Sling Distribution Trigger - Scheduled Triggers Factory

      • 選取要開啟以進行編輯的現有設定（鉛筆圖示）

        • 驗證 Name : socialpubsync-scheduled-trigger

      • 將Interval in Seconds設為所需的間隔

      • 選擇Save

chlimage_1-392

設定多個發佈例項

預設組態是針對單一發佈例項。 由於啟用用戶同步的原因是同步多個發佈實例（例如對於發佈群），因此需要將其他發佈實例添加到同步代理工廠。

7.Apache Sling Distribution Agent - Sync Agents Factory

新增發佈例項：

chlimage_1-393

  • 匯出
    器端點每個發佈器應有一個匯出器端點。例如，如果有2個發佈者，localhost:4503和4504，則應有2個項目：

    • http://localhost:4503/libs/sling/distribution/services/exporters/socialpubsync-reverse
    • http://localhost:4504/libs/sling/distribution/services/exporters/socialpubsync-reverse

  • 匯入工
    具端點每個發佈工具都應有匯入工具端點。例如，如果有2個發佈者，localhost:4503和4504，則應有2個項目：

    • http://localhost:4503/libs/sling/distribution/services/importers/socialpubsync
    • http://localhost:4504/libs/sling/distribution/services/importers/socialpubsync

  • 選擇Save

8.AEM Communities User Sync Listener

（可選）同步其他JCR節點

如果有自訂資料需要在多個發佈例項間同步，則：

chlimage_1-394

  • 節點類型

    這是要同步的節點類型清單。 除了sling:Folder以外的任何節點類型都必須列在此處（sling:folder需另外處理）。

    要同步的節點類型的預設清單：

    • rep：用戶
    • nt:unstructured
    • nt：資源

  • 可忽略的屬性

    這是在偵測到任何變更時將忽略的屬性清單。 對這些屬性的更改可能會作為其他更改的副作用而得到同步（因為同步始終在節點級別），但對這些屬性的更改本身不會觸發同步。

    要忽略的預設屬性：

    • cq:lastModified

  • 可忽略節點

    在同步期間將完全忽略的子路徑。 這些子路徑下的任何內容將隨時同步。

    要忽略的預設節點：

    • .token
    • 系統

  • 分佈式資料夾

    Most sling:Folders are ingored are ingroted are not expensed synchronization. 此處列出了少數例外。

    要同步的預設資料夾

    • 區段／計分
    • 社交／關係
    • 活動

9.唯一Sling ID

注意

如果Sling ID在兩個或多個發佈例項之間相符，則使用者群組同步將失敗。

如果Sling ID對於發佈群中的多個發佈例項是相同的，則使用者群組將不會同步。

若要驗證所有Sling ID值都不同，請在每個發佈例項上：

  1. 瀏覽http://<host>:<port>/system/console/status-slingsettings
  2. 檢查​Sling ID​的值

chlimage_1-395

如果發佈例項的Sling ID符合任何其他發佈例項的Sling ID，則：

  1. 停止其中一個具有相符Sling ID的發佈例項

  2. 在crx-quickstart/launchpad/felix目錄中

    • 搜索並刪除名為​sling.id.file​的檔案

      • 例如，在Linux系統上：

        rm -i $(find . -type f -name sling.id.file)

      • 例如，在Windows系統上：

        use windows explorer and search for *sling.id.file*

  3. 啟動發佈例項

    • 啟動時，會指派新的Sling ID

  4. 驗證​Sling ID​現在是唯一的

重複這些步驟，直到所有發佈例項都有唯一的Sling ID。

Vault Package Builder Factory

為了使更新正確同步，必須為用戶同步修改Vault包生成器：

  • 在每個AEM發佈例項上

  • 訪問Web控制台

  • 找到Apache Sling Distribution Packaging - Vault Package Builder Factor

    • Builder name: socialpubsync-vlt

  • 選擇編輯表徵圖

  • 新增兩個Package Filters :

    • /home/users|-.*/.tokens
    • /home/users|-.*/rep:cache

  • 策略處理：

    • 要用新節點覆蓋現有rep:policy節點，請添加第三個包過濾器：

      • /home/users|+.*/rep:policy

    • 要防止策略被分發，請設定

      • Acl Handling : IGNORE

chlimage_1-396

當……

發佈時的使用者自行註冊或編輯描述檔

根據設計，在發佈環境中建立的使用者和設定檔（自行註冊）不會出現在作者環境中。

當拓撲是publish farm且使用者同步已正確設定時，*user *和​user profile​會使用Sling散發在發佈群中同步。

使用Security Console建立使用者或使用者群組

根據設計，在發佈環境中建立的使用者資料不會出現在作者環境中，反之亦然。

當使用使用者管理與安全性主控台來在發佈環境中新增使用者時，使用者同步會視需要將新使用者及其群組成員資格同步到其他發佈執行個體。 使用者同步也會同步透過安全性主控台建立的使用者群組。

疑難排解

如何讓使用者同步離線

若要讓使用者同步離線，若要移除發佈者或手動同步資料，散發佇列必須空白且安靜。

要檢查分發隊列的狀態，請執行以下操作：

  • 作者：

    • 使用CRXDE Lite

      • 在/var/sling/distribution/packages中查找條目

        • 使用模式distrpackage_*命名的資料夾節點

    • 使用軟體包管理器

      • 查找待定軟體包（尚未安裝）

        • 以模式socialpubsync-vlt*命名
        • 由communities-user-admin建立

當分發佇列為空時，請停用使用者同步：

任務完成後，要重新啟用用戶同步：

使用者同步診斷

用戶同步診斷是一種檢查配置並嘗試識別任何問題的工具。

在作者上，只需從主控制台瀏覽​工具、操作、診斷、用戶同步診斷。

只要進入「User Sync Diagnostics（用戶同步診斷）」控制台，就會顯示結果。

以下是未啟用用戶同步時顯示的內容：

chlimage_1-397

如何運行發佈者的診斷程式

當從作者環境運行診斷時，通過／失敗結果將包含[INFO]部分，該部分顯示已配置的發佈實例清單以供確認。

清單中包含每個發佈例項的URL，該例項將執行該例項的診斷。 url param syncUser會附加至診斷URL，其值會設定至在步驟2中建立的​授權同步使用者。

注意 :在啟動URL之前，授 權的 同步使用者必須已登入該發佈例項。

chlimage_1-398

配置未正確添加

當使用者同步無法運作時，最常見的問題是其他組態是​added。 相反，*existing *default configuration has be edited **.

以下是編輯後預設組態在Web主控台中的顯示方式檢視。 如果出現多個實例，應刪除添加的配置。

(author)One Apache Sling Distribution Agent - Sync Agents Factory

chlimage_1-399

（作者）一個Adobe Granite散發——加密密碼傳輸機密提供者

chlimage_1-400

(publish)One Apache Sling Distribution Agent - Queue Agents Factory

chlimage_1-481

(publish)一個Adobe Granite Distribution —— 比較觀察工廠

chlimage_1-402

(author)One Apache Sling Distribution Trigger - Scheduled Triggers Factory

chlimage_1-403

在響應處理過程中修改工序例外

如果日誌中顯示以下內容：

org.apache.sling.servlets.post.impl.operations.ModifyOperation Exception during response processing.

java.lang.IllegalStateException: This tree does not exist

然後確認2節。 已正確遵循「建立授權使用者」。

本節說明如何建立已授權的使用者（存在於所有發佈例項上），並在作者的「機密提供者」OSGi設定中識別這些使用者。 依預設，使用者為admin。

授權的使用者應成為​administrators​使用者群組的成員，該群組的權限不應變更。

授權使用者應明確擁有下列所有發佈例項的權限和限制：

路徑 jcr:all rep:glob
/home X &ast;/activity/&ast;
/home/users X &ast;/activity/&ast;
/home/groups X &ast;/activity/&ast;

身為administrators群組的成員，授權使用者應擁有下列所有發佈例項的權限：

路徑 jcr:all jcr:read rep:write
/etc/packages/sling/distribution X
/libs/sling/distribution X
/var X
/var/eventing X X
/var/sling/distribution X X

用戶組同步失敗

如果Sling ID在兩個或多個發佈例項之間相符，則使用者群組同步將失敗。

請參閱9節。 唯一Sling ID

手動同步使用者和使用者群組

要配置或啟用用戶同步，請轉至步驟1:Apache Sling Distribution Agent - Sync Agents Factory

當發行者變為不可用

當發佈例項無法使用時，如果它日後會重新連線，就不應移除它。 變更會排入發佈者佇列，一旦變更重新上線，就會處理變更。

如果發佈例項永遠不會回線，如果它已永久離線，則必須移除它，因為佇列累積會導致作者環境中的磁碟空間使用量明顯增加。

當發行者關閉時，作者記錄檔會有類似下列的例外：

28.01.2016 15:57:48.475 ERROR
 [pool-12-thread-34-org_apache_sling_distribution_queue_socialpubsync_endpoint1
 (org/apache/sling/distribution/queue/socialpubsync/endpoint1)]
 org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync] could not deliver package distrpackage_1454014575838_a2b45ec8-0400-42f3-bed8-ae09b66381cb
 org.apache.sling.distribution.packaging.DistributionPackageImportException: failed in importing package ...

如何刪除發佈者

若要從Apache Sling Distribution Agent - Sync Agents Factory移除發佈者，散發佇列必須空白且安靜。

本頁內容