Show Menu
トピック×

AEM Assets と Brand Portal の連携の設定

Adobe Experience Manager(AEM)Assets と Brand Portal の連携が、Adobe I/O を通じて設定されます。Adobe I/O は Brand Portal テナントの認証用の IMS トークンを取得します。

前提条件

AEM Assets と Brand Portal の連携を設定するには以下が必要です。
  • AEM Assets クラウドインスタンスの起動および実行
  • Brand Portal テナント URL
  • Brand Portal テナントの IMS 組織に対するシステム管理者権限を持つユーザー
詳しくは、 サポートへお問い合わせください

設定の作成

Adobe I/O で設定を作成し、AEM Assets クラウドインスタンスを Brand Portal で設定できます。
リストに表示されたシーケンスで次の手順を実行します。

IMS 設定の作成

IMS 設定は、AEM Assets オーサーインスタンスを使用して Brand Portal テナントを認証します。
IMS 設定には、次の 2 つの手順が含まれます。

公開証明書の取得

公開証明書により、Adobe I/O でプロファイルを認証できます。
  1. AEM Assets クラウドインスタンスにログインします。
  2. ツール パネルより、 セキュリティ Adobe IMS 設定 ​に移動します。
  3. Adobe IMS 設定ページが開きます。
    作成 」をクリックします。
    Adobe IMS 技術アカウント設定 ​ページが表示されます。
  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 キーのコピー
    クライアント秘密鍵を取得 」をクリックし、クライアント秘密鍵をコピーします。
  8. JWT 」タブに移動し、 JWT ペイロード ​をコピーします。
    API キー、クライアント秘密鍵、JWT ペイロード情報は、IMS アカウント設定の作成に使用されます。

IMS アカウント設定の作成

次の手順を実行したことを確認します。
IMS アカウント設定の作成手順:
  1. IMS 設定ページの「 アカウント 」タブを開きます。(このページは、「 公開証明書を取得する 」セクションの最後で開いたままにしておいたページです)。
  2. IMS アカウントの​ タイトル ​を指定します。
    認証サーバー 」に次の URL を入力します。 https://ims-na1.adobelogin.com/
    Adobe I/O 統合環境の作成 の最後にコピーした API キー、クライアント秘密鍵、JWT ペイロードを貼り付けます。
    作成 」をクリックします。
    統合環境が作成されます。
  3. 作成した IMS 設定を選択して「 ヘルスチェック 」をクリックします。ダイアログボックスが表示されます。
    チェック 」をクリック。接続が成功すると、 トークンが正常に取得された ​ことを示すメッセージが表示されます。
IMS 設定は 1 つだけにする必要があります。複数の IMS 設定を作成しないでください。
IMS 設定がヘルスチェックに合格していることを確認します。設定がヘルスチェックに合格しない場合は無効です。削除して、新しい有効な設定を作成する必要があります。

Cloud Service の設定

Brand Portal クラウドサービス設定を作成するには、以下の手順を実行します。
  1. AEM Assets クラウドインスタンスにログインします。
  2. ツール パネルで、 Cloud Services AEM Brand Portal に移動します。
    Brand Portal 設定ページが開きます。
  3. 作成 」をクリックします。
  4. 設定の​ タイトル ​を入力します。
    IMS アカウント設定の作成 手順で作成した IMS 設定を選択します。
    サービス URL 」に、Brand Portal テナント URL を入力します。
  5. 保存して閉じる 」をクリックします。クラウド設定が作成されます。AEM Assets クラウドインスタンスが Brand Portal テナントで設定されました。

設定のテスト

  1. AEM Assets クラウドインスタンスにログインします。
  2. ツール パネルで、 デプロイメント 配布 ​に移動します。
  3. 配布ページが表示されます。
    Brand Portal 配布エージェント bpdistributionagent0 は、「 Brand Portal に公開 」の下に作成されます。
    Brand Portal に公開 」をクリックします。
    デフォルトでは、Brand Portal テナント用に 1 つの配布エージェントが作成されます。
  4. 配布エージェントページが開きます。デフォルトでは、「 ステータス 」タブが開き、配布キューが設定されます。
    配布エージェントには、次の 2 つのキューが含まれます。
    • processing-queue :Brand Portal へのアセット配布用。
    • error-queue :配布が失敗したアセット用。
    エラーを確認し、 error-queue を定期的に消去することをお勧めします。
  5. AEM Assets と Brand Portal の間の接続を検証するには、「 接続をテスト 」をクリックします。
    テストパッケージが正常に配信されたことを示すメッセージがページの下部に表示されます。
    配布エージェントを無効にしないでください。無効にすると、(実行中のキュー内の)アセットの配布が失敗する可能性があります。
AEM Assets クラウドインスタンスが Brand Portal で正常に設定され、次の操作が可能になりました。
上記に加えて、AEM Assets のメタデータスキーマ、画像プリセット、検索ファセット、タグを Brand Portal に公開することもできます。
詳しくは、 Brand Portal ドキュメント を参照してください。

配布ログ

配布エージェントで実行されたアクションの詳細については、ログを確認できます。
例えば、AEM Assets から Brand Portal にアセットを発行し、設定を確認したとします。
  1. 接続をテスト 」に示す手順(手順 1 ~ 4)に従い、配布エージェントページに移動します。
  2. ログ 」をクリックして、配布ログを表示します。処理ログとエラーログは、ここで確認できます。
配布エージェントは次のログを生成します。
  • 情報:これは、構成が正常に完了したときにトリガーされるシステムが生成するログで、配布エージェントを有効にします。
  • DSTRQ1(リクエスト 1):テスト接続時にトリガーされます。
アセットの公開時に、次の要求および応答ログが生成されます。
配布エージェントの要求
  • DSTRQ2(リクエスト 2):アセットの発行要求がトリガーされます。
  • DSTRQ3(リクエスト 3):アセットが存在するフォルダーの公開と、Brand Portal でのフォルダーの複製をおこなう別の要求がトリガーされます。
配布エージェントの応答
  • queue-bpdistributionagent0(DSTRQ2):アセットが Brand Portal に公開されます。
  • queue-bpdistributionagent0(DSTRQ3):システムは、Brand Portal 内のアセットを含むフォルダーを複製します。
上記の例では、追加の要求と応答がトリガーされます。アセットが初めて発行されたので、Brand Portal で親フォルダ(追加パス)が見つからなかったため、アセットが発行された Brand Portal で同じ名前の親フォルダを作成する追加の要求をトリガーします。
親フォルダーが Brand Portal に存在しない場合(上記の例)、または親フォルダーが AEM Assets で変更された場合に、追加のリクエストが生成されます。