AEM Assets と Brand Portal の連携の設定

Adobe Experience Manager(AEM)アセットは、Adobe I/Oを通じてBrand Portalで設定され、Brand Portalテナントの認証用にIMSトークンを調達します。

このヘルプでは、次の2つの使用例について説明します。

• 新しい設定:新しいBrand Portalユーザーで、Brand PortalでAEM Assets作成者インスタンスを設定する場合は、で新しい設定を作成でき Adobe I/Oます。
• アップグレード設定:既存のBrand Portalユーザーで、従来のOAuth GatewayのBrand Portalで設定したAEM Assets作成者インスタンスを使用している場合は、既存の設定を削除し、新しい設定をに作成することをお勧めし Adobe I/Oます。

具体的には、以下の操作に関する十分な知識があるユーザーを対象としています。

• Adobe Experience ManagerおよびAEMパッケージのインストール、設定、管理

• LinuxおよびMicrosoft Windowsオペレーティングシステムの使用

前提条件

AEM Assets と Brand Portal の連携を設定するには以下が必要です。

• 最新のサービスパックを適用した実行中の AEM Assets オーサーインスタンス
• Brand Portal テナント URL
• Brand Portal テナントの IMS 組織に対するシステム管理者権限を持つユーザー

AEM 6.4のダウンロードとインストール

最新の AEM サービスパックをダウンロードしてインストールする

AEM 6.4をダウンロードしてインストール

AEMオーサーインスタンスを設定するには、AEM 6.4を使用することをお勧めします。 AEM が稼働していない場合は、以下の場所から AEM をダウンロードしてください。

• 既存のAEMをお使いの場合は、AdobeライセンスWebサイトからAEM 6.4をダウンロードします。

• Adobeパートナーの場合は、Adobeパートナートレーニングプログラムを使用してAEM 6.4をリクエストします。

AEM をダウンロードしたら、「デプロイメントと保守」の説明に従い、AEM オーサーインスタンスの設定を行ってください。

最新の AEM サービスパックをダウンロードしてインストールする

詳細な手順については、

• AEM 6.4 Service Pack リリースノート

最新のAEMパッケージまたはService Packが見つからない場合は、 カスタマーケアにお問い合わせください。

設定の作成

ブランドポータルを使用してAEM Assetsを初めて設定する場合は、一覧に示す順序で次の手順を実行します。

1. 公開証明書の取得
2. Adobe I/O Createintegration
3. IMS アカウント設定の作成
4. Cloud Service の設定
5. 設定のテスト

IMS 設定の作成

IMS 設定は、AEM Assets オーサーインスタンスを使用して Brand Portal テナントを認証します。

IMS 設定には、次の 2 つの手順が含まれます。

• 公開証明書の取得
• IMS アカウント設定の作成

公開証明書の取得

公開証明書を使用すると、Adobe I/Oでプロファイルを認証できます。

1. AEM Assets作成者インスタンスにログインします
   デフォルトURL:http:// localhost:4502/aem/start.html

2. ツール パネルから、セキュリティ >> AdobeIMS設定​に移動します。

   

3. Adobe IMS 設定ページが開きます。

   「作成」をクリックします。

   AdobeIMSテクニカルアカウント設定​ページが表示されます。

4. デフォルトでは、「証明書」タブが開きます。

   クラウドソリューション​で「Adobe Brand Portal」を選択します。

5. 「新しい証明書を作成​」チェックボックスをオンにして、証明書の​エイリアス​を指定します。​ここで入力したエイリアスが、ダイアログ名として表示されます。

6. 「証明書を作成」をクリックします。ダイアログが表示されます。「OK」をクリックして公開証明書を生成します。

   

7. 「公開鍵をダウンロード」をクリックし、AEM-Adobe-IMS.crt 証明書ファイルをローカルマシンに保存します。証明書ファイルは、create Adobe I/O integrationに使用されます。

   

8. 「次へ」をクリックします。

   「アカウント」タブで、Adobe IMS アカウントを作成するには、統合環境の詳細が必要です。このページは開いたままにしておきます。

   新しいタブを開き、統合 Adobe I/O 統合を作成して、IMSアカウント設定の統合の詳細を取得します。

Adobe I/O統合を作成

Adobe I/O 統合環境により、API キー、クライアント秘密鍵、および IMS アカウント設定の設定で必要なペイロード（JWT）が生成されます。

1. Brand PortalテナントのIMS組織のシステム管理者権限でAdobe I/Oコンソールにログインします。

   デフォルト URL：https://console.adobe.io/

2. 「統合を作成」をクリックします。

3. 「API にアクセス」を選択し、「続行」をクリックします。

   

4. 新しい統合を作成ページを開きます。

   ドロップダウンリストからご自身の組織を選択します。

   Experience Cloud で「AEM Brand Portal」を選択し、「続行」をクリックします。

   「Brand Portal」オプションが無効になっている場合は、「アドビのサービス」オプションの上にあるドロップダウンボックスで正しい組織が選択されているかどうかを確認してください。自分がどの組織に属しているかわからない場合は、管理者に問い合わせてください。

   

5. 新しい統合環境の名前と説明を入力します。「お使いのコンピューターからファイルを選択」をクリックし、「公開証明書を取得する」セクションでダウンロードした AEM-Adobe-IMS.crt ファイルをアップロードします。

6. 組織のプロファイルを選択します。

   または、デフォルトのプロファイル Assets Brand Portal を選択し、「統合を作成」をクリックします。統合環境が作成されます。

7. 「統合の詳細情報に進む」をクリックして、統合環境の詳細情報を表示します。

   API キーのコピー

   「クライアント秘密鍵を取得」をクリックし、クライアント秘密鍵をコピーします。

   

8. 「JWT」タブに移動し、JWT ペイロード​をコピーします。

   API キー、クライアント秘密鍵、JWT ペイロード情報は、IMS アカウント設定の作成に使用されます。

IMS アカウント設定の作成

次の手順を実行したことを確認します。

• 公開証明書の取得
• Adobe I/O Createintegration

IMS アカウント設定の作成手順：

1. IMS 設定ページの「アカウント」タブを開きます。（このページは、「公開証明書を取得する」セクションの最後で開いたままにしておいたページです）。

2. IMS アカウントの​タイトル​を指定します。

   「認証サーバー」に次の URL を入力します。https://ims-na1.adobelogin.com/

   Create Adobe I/O integrationの最後にコピーしたAPIキー、Client Secret、JWTペイロードを貼り付けます。

   「作成」をクリックします。

   統合環境が作成されます。

   

3. 作成した IMS 設定を選択して「ヘルスチェック」をクリックします。ダイアログボックスが表示されます。

   「チェック」をクリック。接続が成功すると、トークンが正常に取得された​ことを示すメッセージが表示されます。

   

Cloud Service の設定

Brand Portal クラウドサービス設定を作成するには、以下の手順を実行します。

1. AEM Assets作成者インスタンスにログインします

   デフォルト URL は http://localhost:4502/aem/start.html です。

2. ツール パネルから、Cloud Services/> AEMブランドポータル​に移動します。

   Brand Portal 設定ページが開きます。

3. 「作成」をクリックします。

4. 設定の​タイトル​を入力します。

   IMS アカウント設定の作成手順で作成した IMS 設定を選択します。

   「サービス URL」に、Brand Portal テナント URL を入力します。

   

5. 「保存して閉じる」をクリックします。クラウド設定が作成されます。これで、AEM Assets作成者インスタンスがBrand Portalテナントと統合されました。

設定のテスト

1. AEM Assets作成者インスタンスにログインします

   デフォルト URL は http://localhost:4502/aem/start.html です。

2. ツール パネルから、展開/​レプリケーションに移動します。

   

3. レプリケーションページが開きます。

   「作成者​のエージェント」をクリックします。

   

4. 各テナントに4つのレプリケーションエージェントが作成されます。

   Brand Portalテナントのレプリケーションエージェントを見つけます。

   複製エージェントのURLをクリックします。

   

   メモ

   レプリケーションエージェントは並行して動作し、ジョブの分散を均等に共有するので、パブリッシング速度を元の速度の4倍に増やします。 クラウドサービスの設定後、複数のアセットの並列発行を有効にするために、デフォルトでアクティブ化される複製エージェントを有効にするために、追加の設定は必要ありません。

5. AEM Assetsの作成者とBrand Portalの間の接続を確認するには、「接続をテスト」をクリックします。

   

6. テスト結果の一番下を見て、レプリケーションが成功したことを確認します。

   

7. 4つのレプリケーションエージェントすべてに対するテスト結果を1つずつ確認します。

   メモ

   どのレプリケーションエージェントも無効にしないでください。一部のアセットのレプリケーションが失敗する可能性があります。

   タイムアウトエラーを回避するために、4つのレプリケーションエージェントがすべて構成されていることを確認します。 Brand Portalへの並行投稿での問題のトラブルシューティングを参照してください。

Brand Portalは、AEM Assets作成者インスタンスで正常に設定されます。 次の操作が可能になっています。

• AEM Assets から Brand Portal へのアセットの公開
• AEM Assets から Brand Portal へのフォルダーの公開
• AEM Assets から Brand Portal へのコレクションの公開
• アセット ソースを設定し、Brand PortalユーザがアセットをAEM Assetsに寄稿して公開できるようにします。

設定のアップグレード

既存の設定をアップグレードするには、次の手順を一覧に示す順序で実行します。

1. 実行中のジョブの確認
2. 既存の設定の削除
3. 設定の作成

実行中のジョブの確認

変更を行う前に、AEM Assetsの作成者インスタンスで発行ジョブが実行されていないことを確認してください。 その場合は、4つのレプリケーションエージェントをすべて検証し、キューが理想的/空であることを確認できます。

1. AEM Assets作成者インスタンスにログインします

   デフォルト URL は http://localhost:4502/aem/start.html です。

2. ツール パネルから、展開/​レプリケーションに移動します。

3. レプリケーションページが開きます。

   「作成者​のエージェント」をクリックします。

   

4. Brand Portalテナントのレプリケーションエージェントを見つけます。

   すべてのレプリケーションエージェントで​キューがアイドル​であることを確認します。公開ジョブがアクティブでないことを確認してください。

   

既存の構成の削除

既存の設定の削除中に、次のチェックリストを実行する必要があります。

• 4つのレプリケーションエージェントをすべて削除する
• クラウドサービスの削除
• MACユーザーの削除

既存の設定を削除するには、次の手順を実行します。

1. AEM Assets作成者インスタンスにログインし、管理者としてCRX Liteを開きます。

   デフォルトURL:http:// localhost:4502/crx/de/index.jsp

2. /etc/replications/agents.authorに移動し、Brand Portalテナントの4つのレプリケーションエージェントをすべて削除します。

   

3. /etc/cloudservices/mediaportalに移動し、Cloud Service設定​を削除します。

   

4. /home/users/macに移動し、Brand Portalテナントの​MACユーザー​を削除します。

   

これで、Adobe I/O上のAEM 6.4オーサーインスタンスに設定を作成できます。

レプリケーションが正常に終了したら、アセット、フォルダー、コレクションを Brand Portal に公開することができます。詳しくは、次を参照してください。

• Brand Portal へのアセットの公開
• アセットおよびフォルダーの Brand Portal への公開
• Brand Portal へのコレクションの公開