AEM Assets と Brand Portal の連携の設定

Adobe Experience Manager(AEM)Assetsは、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ユーザーで、AEM AssetsオーサーインスタンスをBrand Portalと共に設定する場合は、で新しい設定を作成できま Adobe I/Oす。
  • 設定のアップグレード:旧来のOAuth Gateway上でBrand Portalを使用してAEM Assetsオーサーインスタンスを設定している既存のBrand Portalユーザーの場合は、既存の設定を削除し、で新しい設定を作成することをお勧めし 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 をダウンロードしたら、「デプロイメントと保守」の説明に従い、AEM オーサーインスタンスの設定を行ってください。

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

詳しい手順については、

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

設定の作成

AEM AssetsとBrand Portalを初めて設定する場合は、以下の手順を順に実行します。

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

AEM Assetsオーサーインスタンスは、1つのBrand Portalテナントでのみ設定できます。

IMS 設定の作成

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

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

公開証明書の取得

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

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

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

    Adobe IMS アカウント設定 UI

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

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

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

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

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

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

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

    証明書を作成

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

    証明書をダウンロード

  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 キーのコピー

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

    統合環境の API キー、クライアント秘密鍵、ペイロード情報の表示画面

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

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

IMS アカウント設定の作成

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

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

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

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

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

    Create Adobe I/O integrationの最後にコピーしたAPIキー、クライアント秘密鍵、JWTペイロードを貼り付けます。

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

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

    IMS アカウントの設定

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

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

注意

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

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

Cloud Service の設定

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

  1. AEM Assetsオーサーインスタンスにログインします。

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

  2. ツール ツールパネルから、Cloud Services/>AEM Brand Portal​に移動します。

    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オーサーインスタンスで正常に設定されました。 次の操作が可能になっています。

設定のアップグレード

既存の設定をアップグレードするには、以下の手順を上記の手順で実行します。

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

実行中のジョブの確認

変更を加える前に、AEM Assetsオーサーインスタンスで公開ジョブが実行されていないことを確認してください。 そのために、4つのレプリケーションエージェントをすべて検証し、キューが理想的/空であることを確認できます。

  1. AEM Assetsオーサーインスタンスにログインします。

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

  2. ツール ツールパネルから、デプロイメント/>レプリケーション​に移動します。

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

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

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

    すべてのレプリケーションエージェントに対して​QueueがIdle​であることを確認します。公開ジョブがアクティブでないことを確認します。

既存の構成を削除します

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

  • 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 に公開することができます。詳しくは、次を参照してください。

このページ