Adobe Experience League

AEM Assets と Brand Portal の連携の設定

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

メモ

Adobe I/O経由でBrand Portalを使用したAEM Assetsの設定は、AEM 6.4.8.0以降でサポートされています。

これまで、Brand Portal は、旧来の OAuth ゲートウェイを通じてクラシック UI で設定されていました。このゲートウェイは、JWT トークン交換を使用して認証用の IMS アクセストークンを取得します。

ヒント

既存のお客様のみ

既存のレガシー OAuth Gateway 設定を引き続き使用することをお勧めします。レガシーOAuth Gatewayの構成に問題が発生した場合は、既存の構成を削除し、Adobe I/Oを介して新しい構成を作成します。

このヘルプでは、次の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 Assetsを初めて設定する場合は、一覧に示す順序で次の手順を実行します。

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

メモ

AEM Assetsの作成者インスタンスは、1つのBrand Portalテナントでのみ構成できます。

IMS 設定の作成

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

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

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

公開証明書の取得

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

AEM Assets作成者インスタンスにログインします
デフォルトURL:http:// localhost:4502/aem/start.html
ツール パネルから、セキュリティ >> AdobeIMS設定に移動します。
Adobe IMS 設定ページが開きます。

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

AdobeIMSテクニカルアカウント設定ページが表示されます。
デフォルトでは、「証明書」タブが開きます。

クラウドソリューションで「Adobe Brand Portal」を選択します。
「新しい証明書を作成」チェックボックスをオンにして、証明書のエイリアスを指定します。ここで入力したエイリアスが、ダイアログ名として表示されます。
「証明書を作成」をクリックします。ダイアログが表示されます。「OK」をクリックして公開証明書を生成します。
「公開鍵をダウンロード」をクリックし、AEM-Adobe-IMS.crt 証明書ファイルをローカルマシンに保存します。証明書ファイルは、create Adobe I/O integrationに使用されます。
「次へ」をクリックします。

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

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

Adobe I/O統合を作成

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

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

デフォルト URL：https://console.adobe.io/
「統合を作成」をクリックします。
「API にアクセス」を選択し、「続行」をクリックします。
新しい統合を作成ページを開きます。

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

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

「Brand Portal」オプションが無効になっている場合は、「アドビのサービス」オプションの上にあるドロップダウンボックスで正しい組織が選択されているかどうかを確認してください。自分がどの組織に属しているかわからない場合は、管理者に問い合わせてください。
新しい統合環境の名前と説明を入力します。「お使いのコンピューターからファイルを選択」をクリックし、「公開証明書を取得する」セクションでダウンロードした AEM-Adobe-IMS.crt ファイルをアップロードします。
組織のプロファイルを選択します。

または、デフォルトのプロファイル Assets Brand Portal を選択し、「統合を作成」をクリックします。統合環境が作成されます。
「統合の詳細情報に進む」をクリックして、統合環境の詳細情報を表示します。

API キーのコピー

「クライアント秘密鍵を取得」をクリックし、クライアント秘密鍵をコピーします。
「JWT」タブに移動し、JWT ペイロードをコピーします。

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

IMS アカウント設定の作成

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

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

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

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

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

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

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

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

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

注意

IMS 設定は 1 つだけにする必要があります。複数の IMS 設定を作成しないでください。

IMS 設定がヘルスチェックに合格していることを確認します。設定がヘルスチェックに合格しない場合は無効です。削除して、新しい有効な設定を作成する必要があります。

Cloud Service の設定

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

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

デフォルト URL は http://localhost:4502/aem/start.html です。
ツール パネルから、Cloud Services/> AEMブランドポータルに移動します。

Brand Portal 設定ページが開きます。
「作成」をクリックします。
設定のタイトルを入力します。

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

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

設定のテスト

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

デフォルト URL は http://localhost:4502/aem/start.html です。
ツール パネルから、展開/レプリケーションに移動します。
レプリケーションページが開きます。

「作成者のエージェント」をクリックします。
各テナントに4つのレプリケーションエージェントが作成されます。

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

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

メモ

レプリケーションエージェントは並行して動作し、ジョブの分散を均等に共有するので、パブリッシング速度を元の速度の4倍に増やします。クラウドサービスの設定後、複数のアセットの並列発行を有効にするために、デフォルトでアクティブ化される複製エージェントを有効にするために、追加の設定は必要ありません。
AEM Assetsの作成者とBrand Portalの間の接続を確認するには、「接続をテスト」をクリックします。
テスト結果の一番下を見て、レプリケーションが成功したことを確認します。
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に寄稿して公開できるようにします。

設定のアップグレード

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

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

実行中のジョブの確認

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

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

デフォルト URL は http://localhost:4502/aem/start.html です。
ツール パネルから、展開/レプリケーションに移動します。
レプリケーションページが開きます。

「作成者のエージェント」をクリックします。
Brand Portalテナントのレプリケーションエージェントを見つけます。

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

既存の構成の削除

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

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

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

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

デフォルトURL:http:// localhost:4502/crx/de/index.jsp
/etc/replications/agents.authorに移動し、Brand Portalテナントの4つのレプリケーションエージェントをすべて削除します。
/etc/cloudservices/mediaportalに移動し、Cloud Service設定を削除します。
/home/users/macに移動し、Brand PortalテナントのMACユーザーを削除します。