コミュニティのユーザーの同期

はじめに

AEM Communitiesのパブリッシュ環境から（設定されている権限に応じて）、 サイト訪問者 ～になるかもしれない メンバー、作成 ユーザーグループ​を編集します。 メンバープロファイル .

ユーザーデータ ～を指す用語 ユーザー, ユーザープロファイル および ユーザーグループ.

メンバー ～を指す用語 ユーザー オーサー環境に登録されたユーザーとは対照的に、パブリッシュ環境に登録されている。

ユーザーデータに関する詳細は、 ユーザーとユーザーグループの管理.

パブリッシュファーム間でのユーザーの同期

設計上、パブリッシュ環境で作成されたユーザーデータは、オーサー環境には表示されません。

オーサー環境で作成されたほとんどのユーザーデータは、オーサー環境に残ることを目的としており、パブリッシュインスタンスに同期もレプリケートもされません。

次の場合に トポロジ は パブリッシュファーム、1 つのパブリッシュインスタンスでおこなわれた登録と変更を、他のパブリッシュインスタンスと同期する必要があります。 メンバーは、任意のパブリッシュノードにログインしてデータを確認できる必要があります。

ユーザーの同期が有効になっている場合、ユーザーデータはファーム内のパブリッシュインスタンス間で自動的に同期されます。

ユーザー同期の設定手順

パブリッシュファーム間で同期を有効にする手順について詳しくは、次を参照してください。

バックグラウンドでのユーザー同期

sling-dist-workflow

  • vlt パッケージ

    これは、パブリッシャーでおこなわれたすべての変更の zip ファイルで、パブリッシャー間で配布する必要があります。 パブリッシャー上で変更を行うと、変更イベントリスナーによって選択されたイベントが生成されます。 これにより、すべての変更を含む vlt パッケージが作成されます。

  • 配布パッケージ

    Sling の配布情報が含まれます。 コンテンツの配信先と最後に配信された日時に関する情報です。

各種操作の結果

コミュニティサイトコンソールからサイトを発行

オーサー環境で、コミュニティサイトが コミュニティサイトコンソールに設定した場合、 複製 関連するページと Sling が、動的に作成されたコミュニティユーザーグループを、そのメンバーシップも含めて配布します。

ユーザーがパブリッシュ環境で作成または編集されたプロファイル

デザインにより、パブリッシュ環境で作成されたユーザーとプロファイル（自己登録、ソーシャルログイン、LDAP 認証など）は、オーサー環境には表示されません。

トポロジーがパブリッシュファームであり、ユーザー同期が正しく設定されると、Sling 配布を使用して​ユーザー​と​ユーザープロファイル​がパブリッシュファーム間で同期されます。

新しいコミュニティグループがパブリッシュで作成されました

パブリッシュインスタンスから開始したコミュニティグループの作成では、新しいサイトページと新しいユーザーグループが作成されますが、実際にはオーサーインスタンス上で作成されます。

プロセスの一環として、新しいサイトページがすべてのパブリッシュインスタンスにレプリケートされます。 動的に作成されるコミュニティユーザーグループとそのメンバーシップは、 Sling をすべてのパブリッシュインスタンスに配布します。

セキュリティコンソールを使用してユーザーやユーザーグループが作成される場合

設計上、パブリッシュ環境で作成されたユーザーデータは、オーサー環境にも反対にも表示されません。

ユーザー管理およびセキュリティコンソールを使用してパブリッシュ環境で新しいユーザーを追加すると、ユーザーの同期機能により、新しいユーザーとそのグループメンバーシップがその他のパブリッシュインスタンスに同期されます（必要な場合）。ユーザー同期により、セキュリティコンソールによって作成されたユーザーグループも同期されます。

ユーザーが投稿時にコンテンツを投稿

ユーザー生成コンテンツ (UGC) の場合、パブリッシュインスタンスに入力されたデータには、 設定済み SRP.

ベストプラクティス

デフォルトでは、ユーザー同期は 無効. ユーザー同期を有効にするには、OSGi の既存の設定を変更する必要があります​。​ユーザー同期を有効にした結果、新しい設定が追加されることはありません。

ユーザー同期では、オーサー環境で作成されていないユーザーデータでもその配布の管理はオーサー環境に依存します。

前提条件

  1. ）1 つのパブリッシャーでユーザーおよびユーザーグループが既に作成されている場合は、ユーザー同期を設定して有効にする前に、ユーザーデータをすべてのパブリッシャーと手動で同期することをお勧めします。

    ユーザー同期を有効にすると、新規に作成されたユーザーおよびグループのみが同期されるようになります。

  2. 最新のコードがインストールされていることを確認します。

AEM Communitiesでユーザーの同期を有効にするには、次の設定が必要です。 Sling コンテンツの配布が失敗するのを防ぐために、これらの設定が正しいことを確認します。

Apache Sling Distribution Agent - Sync Agents Factory

この設定は、パブリッシャー全体で同期されるコンテンツを取得します。 設定はオーサーインスタンス上にあります。 作成者は、そこに存在するすべての公開者と、すべての情報を同期する場所を追跡する必要があります。

この設定のデフォルト値は、1 つのパブリッシュインスタンス用です。 ユーザー同期は、パブリッシュファームなど、複数のパブリッシュインスタンスを同期する場合に便利なので、追加のパブリッシュインスタンスを設定に追加する必要があります。

コンテンツはどのように同期されますか？

オーサーインスタンスが、パブリッシャーのエクスポーターエンドポイントに ping を発行します。 特定の発行者 (n) でユーザーが作成または更新されるたびに、作成者は、書き出しエンドポイントおよび コンテンツをプッシュ を他のパブリッシャー（n-1、つまりコンテンツの取得元とは別のパブリッシャー）に送信する場合。

Apache Sling 同期エージェントを設定するには：

  1. AEMオーサーインスタンスでの管理者権限でログインします。

  2. 次にアクセス： Web コンソール. 例： https://localhost:4502/system/console/configMgr.

  3. 場所 Apache Sling Distribution Agent - Sync Agents Factory.

    • 編集用に開く既存の設定を選択します（鉛筆アイコン）。

      名前を確認： socialpubsync.

    • 「有効」チェックボックスを選択します。

    • 選択 複数のキューを使用します。

    • 指定 エクスポーターエンドポイント および インポーターエンドポイント （エクスポーターおよびインポーターエンドポイントをさらに追加できます）。

      これらのエンドポイントは、コンテンツの取得元と、コンテンツのプッシュ先を定義します。 作成者は、指定されたエクスポーターエンドポイントからコンテンツを取得し、そのコンテンツを（コンテンツの取得元の発行者以外の）発行者にプッシュします。

    sync-agent-fact

Adobe Granite Distribution - Encrypted Password Transport Secret Provider

作成者は、作成者から発行へのユーザーデータの同期権限を持つ、認証済みユーザーを識別できます。

The 認証済みユーザーが作成されました すべてのパブリッシュインスタンスでは、パブリッシャーはオーサーとの接続とオーサーでの Sling 配布の設定をおこなうことができます。 この承認済みユーザーは、すべての要件を満たしています ACL.

パブリッシャーにデータをインストールする場合、またはパブリッシャーからデータを取得する場合は常に、この設定で設定された資格情報（ユーザー名とパスワード）を使用してパブリッシャーに接続します。

認証済みユーザーを使用してオーサーとパブリッシャーを接続するには：

  1. AEMオーサーインスタンスでの管理者権限でログインします。

  2. 次にアクセス： Web コンソール.

    例： https://localhost:4502/system/console/configMgr.

  3. 場所 AdobeGranite 配布 — 暗号化されたパスワードトランスポート秘密鍵プロバイダー。

  4. 編集用に開く既存の設定を選択します（鉛筆アイコン）。

    プロパティを検証 socialpubsync - publishUser.

  5. ユーザー名とパスワードを 認証済みユーザー.

    例： usersync - admin

granite-paswrd-trans

Apache Sling Distribution Agent - Queue Agents Factory

この設定は、パブリッシャー間で同期するデータを設定するために使用します。 で指定したパスでデータが作成/更新されたとき 許可されたルート​を指定した場合、「var/community/distribution/diff」がアクティブ化され、作成されたレプリケーターがパブリッシャーからデータを取得して、他のパブリッシャーにインストールします。

同期するデータ（ノードパス）を設定するには、次の手順に従います。

  1. パブリッシュインスタンス上で管理者権限でログインします。

  2. 次にアクセス： Web コンソール.

    例： https://localhost:4503/system/console/configMgr.

  3. 場所 Apache Sling Distribution Agent - Queue Agents Factory.

  4. 編集用に開く既存の設定を選択します（鉛筆アイコン）。

    名前を検証： socialpubsync -reverse

  5. を選択します。 有効 チェックボックスをオンにして保存します。

  6. レプリケート先のノードパスを指定します。 許可されたルート.

  7. 各に対して繰り返し 公開 インスタンス。

    queue-agents-fact

AdobeGranite 配布 — 差分監視者ファクトリー

この設定は、パブリッシャー間でグループメンバーシップを同期します。
あるパブリッシャーでグループのメンバーシップを変更しても、他のパブリッシャーのメンバーシップが更新されない場合は、 ref : members が プロパティ名を参照.

メンバーの同期を確実に行うには、次の手順に従います。

  1. パブリッシュインスタンス上で管理者権限でログインします。

  2. 次にアクセス： Web コンソール.

    例： https://localhost:4503/system/console/configMgr.

  3. 場所 AdobeGranite 配布 — 差分監視者ファクトリー.

  4. 編集用に開く既存の設定を選択します（鉛筆アイコン）。

    検証 エージェント名：socialpubsync -reverse.

  5. 「有効」チェックボックスを選択します。

  6. 指定 rep:members 次のプロパティ名の説明： プロパティ名を参照、をクリックして保存します。

    diff-obs

Apache Sling Distribution Trigger - Scheduled Triggers Factory

この設定を使用すると、（作成者が変更を取り込んで発行者に送信する）ポーリング間隔を設定して、発行者間で変更を同期できます。

作成者は、30 秒ごと（デフォルト）に発行者をポーリングします。 フォルダーにパッケージが存在する場合 /var/sling/distribution/packages/ socialpubsync - vlt /sharedその後、これらのパッケージを取得し、他のパブリッシャーにインストールします。

ポーリング間隔を変更するには：

  1. AEMオーサーインスタンスでの管理者権限でログインします。

  2. 次にアクセス： Web コンソール例： https://localhost:4502/system/console/configMgr

  3. 場所 Apache Sling 配布トリガー — 予定トリガーファクトリ

    • 編集用に開く既存の設定を選択します（鉛筆アイコン）。

      検証 socialpubsync -scheduled-トリガー

    • 間隔（秒）を目的の間隔に設定し、保存します。

    scheduled-トリガー

AEM Communities User Sync Listener

Sling 配布で、サブスクリプションとフォローに不一致がある問題については、 AEM Communities User Sync Listener 設定は次のように設定されます。

  • NodeTypes
  • IgnorableProperties
  • IgnorableNodes
  • DistributedFolders

購読、フォロー、および通知を同期するには

各AEMパブリッシュインスタンスで、次の手順を実行します。

  1. 管理者権限でログインします。

  2. 次にアクセス： Web コンソール. 例： https://localhost:4503/system/console/configMgr.

  3. 場所 AEM Communities User Sync Listener.

  4. 編集用に開く既存の設定を選択します（鉛筆アイコン）

    名前を検証： socialpubsync -scheduled-トリガー

  5. 次の設定を行います。 NodeTypes:

    rep:User

    nt:unstructured

    nt:resource

    rep:ACL

    sling:Folder

    sling:OrderedFolder

    このプロパティで指定されたノードタイプが同期され、通知情報（ブログと設定が続く）が異なる発行者間で同期されます。

  6. 同期するすべてのフォルダーを追加 DistributedFolders. 例：

    segments/scoring

    social/relationships

    activities

  7. を設定します。 ignorablenodes 移動先：

    .tokens

    system

    rep:cache （スティッキーセッションを使用するので、このノードを別のパブリッシャーに同期する必要はありません）。

    user-sync-listner

一意の Sling ID の節を参照してください

AEMオーサーインスタンスは、Sling ID を使用して、データの送信先と、パッケージを送り返す（または送り返す）必要のあるパブリッシャーを特定します。

パブリッシュファーム内のすべてのパブリッシャーが一意の Sling ID を持っていることを確認します。 Sling ID がパブリッシュファーム内の複数のパブリッシュインスタンスに対して同じ場合、ユーザーの同期は失敗します。 作成者は、パッケージの取得元とインストール先を知りません。

パブリッシュファーム内のパブリッシャーの一意の Sling ID を、各パブリッシュインスタンスで確実に使用するには、次の手順を実行します。

  1. 参照先 https://host:port/system/console/status-slingsettings.

  2. の値を確認します。 Sling ID.

    slingid

    あるパブリッシュインスタンスの Sling ID が他のパブリッシュインスタンスの Sling ID と一致する場合は、次のようにします。

  3. 一致する Sling ID を持つパブリッシュインスタンスの 1 つを停止します。

  4. Adobe Analytics の crx-quickstart/launchpad/felix ディレクトリ、という名前のファイルを検索して削除します。 sling.id.file.

    例えば、Linux システムの場合は、次のようになります。

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

    例えば、Windows システムの場合、次のようになります。

    Windows エクスプローラーを使用して、以下を検索します。 sling.id.file

  5. パブリッシュインスタンスを起動します。 起動時に、新しい Sling ID が割り当てられます。

  6. を検証します。 Sling ID が一意になりました。

すべてのパブリッシュインスタンスの Sling ID が一意になるまでこの手順を繰り返します。

Vault Package Builder Factory

更新を正しく同期するには、ユーザ同期用に Vault パッケージビルダーを変更する必要があります。
In /home/users, a */rep:cache ノードが作成されます。 ノードのプリンシパル名に対してクエリを実行すると、このキャッシュが直接使用できることを確認するために使用されるキャッシュです。

次の場合にユーザーの同期が停止する可能性がある： rep :cache ノードはパブリッシャー間で同期されます。

パブリッシャー間で更新が適切に同期されるようにするには、各AEMパブリッシュインスタンスで次の手順を実行します。

  1. 次にアクセス： Web コンソール

    例： https://localhost:4503/system/console/configMgr.

  2. 次を見つけます。 Apache Sling 配布パッケージ — Vault Package Builder Factory

    ビルダー名：socialpubsync-vlt。

  3. 編集アイコンを選択します。

  4. 2 つのパッケージノードフィルターを追加します。

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

  5. ポリシーの処理

    • 既存の rep :policy ノードを新しいノードで上書きするには、3 つ目のパッケージフィルタを追加します。 /home/users|+.*/rep:policy
    • ポリシーの配布を防ぐには、次のように設定します。 Acl Handling: IGNORE

    Vault パッケージビルダーファクトリ

AEM Communitiesでの Sling 配布のトラブルシューティング

Sling 配布が失敗した場合は、次のデバッグ手順を試してください。

  1. 次を確認 不適切に追加された設定

    複数の設定を追加または編集しないようにします。代わりに、既存のデフォルト設定を編集する必要があります。

  2. 設定を確認

    すべての 設定 がAEMオーサーインスタンスで適切に設定されているかどうかを確認します。詳しくは、 ベストプラクティス.

  3. 認証済みユーザー権限の確認

    パッケージが正しくインストールされていない場合は、 認証済みユーザー 最初のパブリッシュインスタンスで作成されたが、正しい ACL を持っている。

    これを検証するには、 認証済みユーザーが作成されました 変更する AdobeGranite 配布 — 暗号化パスワードトランスポート秘密鍵プロバイダー オーサーインスタンスの設定で、管理者ユーザーの資格情報を使用します。 次に、パッケージを再度インストールしてみてください。 ユーザー同期が管理者の資格情報で正常に機能する場合は、作成された公開ユーザーに適切な ACL がなかったことを意味します。

  4. 差分監視者ファクトリ設定を確認

    特定のノードのみがパブリッシュファーム全体で同期されない（例えば、グループメンバーが同期されない）場合は、 AdobeGranite 配布 — 差分監視者ファクトリー 設定が有効になっており、 rep: members が プロパティ名を参照.

  5. AEM Communities User Sync Listener 設定を確認します。 作成したユーザーが同期されているものの、サブスクリプションとフォローが機能しない場合は、AEM Communities User Sync Listener の設定に次の事項が含まれていることを確認します。

    • ノードタイプ — に設定 rep:User, nt :unstructured, nt:resource, rep:ACL, sling:Folder、および sling:OrderedFolder.
    • 無視可能なノード — に設定 .tokens, システム、および rep :cache.
    • [ 配布フォルダ ]：配布するフォルダに設定します。

  6. パブリッシュインスタンスでのユーザー作成時に生成されたログを確認する

    上記の設定が適切に設定されているにもかかわらず、ユーザー同期が機能していない場合は、ユーザーの作成時に生成されるログを確認します。

    次のように、ログの順序が同じかどうかを確認します。

    15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7422] com.adobe.cq.social.sync.impl.PublisherSyncServiceImpl Handing these paths to the distribution subsystem: [/home/users/C, /home/users/C/Cw-5avWqilmqsNn5hCvK]
15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7422] org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync-reverse] REQUEST-START DSTRQ2: ADD paths=[/home/users/C, /home/users/C/Cw-5avWqilmqsNn5hCvK], user=communities-user-admin
15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7431] com.adobe.cq.social.sync.impl.PublisherSyncServiceImpl Handing these paths to the distribution subsystem: [/home/users/C/Cw-5avWqilmqsNn5hCvK, /home/users/C/Cw-5avWqilmqsNn5hCvK/profile, /home/users/C/Cw-5avWqilmqsNn5hCvK/rep:policy]
15.05.2016 18:33:01.523 *INFO* [sling-oak-observation-7431] org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync-reverse] REQUEST-START DSTRQ3: ADD paths=[/home/users/C/Cw-5avWqilmqsNn5hCvK, /home/users/C/Cw-5avWqilmqsNn5hCvK/profile, /home/users/C/Cw-5avWqilmqsNn5hCvK/rep:policy], user=communities-user-admin
15.05.2016 18:33:01.757 *INFO* [sling-oak-observation-7431] org.apache.jackrabbit.vault.packaging.impl.JcrPackageDefinitionImpl unwrapping package sling/distribution:socialpubsync-vlt_1463337181554_ebb27ad9-a861-4405-9342-d64c916654e2:0.0.1
15.05.2016 18:33:01.820 *INFO* [sling-oak-observation-7422] org.apache.jackrabbit.vault.packaging.impl.JcrPackageDefinitionImpl unwrapping package sling/distribution:socialpubsync-vlt_1463337181554_58811273-5861-48fe-95d2-4aff367b99c3:0.0.1
15.05.2016 18:33:02.023 *INFO* [sling-oak-observation-7430] com.adobe.cq.social.sync.impl.PublisherSyncServiceImpl Handing these paths to the distribution subsystem: [/home/users/C/Cw-5avWqilmqsNn5hCvK/profile]
15.05.2016 18:33:02.023 *INFO* [sling-oak-observation-7430] org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync-reverse] REQUEST-START DSTRQ4: ADD paths=[/home/users/C/Cw-5avWqilmqsNn5hCvK/profile], user=communities-user-admin
15.05.2016 18:33:02.273 *INFO* [sling-oak-observation-7430] org.apache.jackrabbit.vault.packaging.impl.JcrPackageDefinitionImpl unwrapping package sling/distribution:socialpubsync-vlt_1463337182039_f34f4fa6-10b9-42eb-8740-4da9d4d38f99:0.0.1

デバッグするには：

  1. ユーザーの同期を無効にします。

  2. AEMオーサーインスタンスで、管理者権限でログインします。

    1. 次にアクセス： Web コンソール. 例： https://localhost:4502/system/console/configMgr.

    2. 設定を見つけます。 Apache Sling Distribution Agent - Sync Agents Factory.

    3. 選択を解除すると、 有効 」チェックボックスをオンにします。

      オーサーインスタンスでのユーザー同期を無効にすると、（エクスポーターおよびインポーター）エンドポイントが無効になり、オーサーインスタンスが静的になります。 The vlt 作成者はパッケージに対して ping を送信したり取得したりしません。

      パブリッシュインスタンスでユーザーが作成された場合、 vlt パッケージは次の場所に作成されます。 /var/sling/distribution/packages/ socialpubsync - vlt /data ノード。 作成者がこれらのパッケージを別のサービスにプッシュした場合も同様です。 このデータをダウンロードして抽出し、他のサービスにプッシュされるすべてのプロパティを確認できます。

  3. 投稿者に移動し、投稿者でユーザーを作成します。 その結果、イベントが作成されます。

  4. 次を確認します。 ログの順序（ユーザーの作成時に作成）

  5. 次の条件を満たしているかどうかを確認します。 vlt パッケージの作成日： /var/sling/distribution/packages/socialpubsync-vlt/data.

  6. 次に、AEMオーサーインスタンスでユーザー同期を有効にします。

  7. パブリッシャーで、のエクスポーターまたはインポーターエンドポイントを変更します。 Apache Sling Distribution Agent - Sync Agents Factory.
    パッケージデータをダウンロードおよび抽出して、他のパブリッシャーにプッシュされるすべてのプロパティと、失われるデータを確認できます。

このページ