Show Menu
トピック×

AEM Assets と Brand Portal の連携の設定

Adobe Experience Manager(AEM)Assetsは、Adobe Developer Consoleを介してBrand Portalで設定され、Brand Portalテナントの認証用にIMSトークンを取得します。
設定の仕組み
AEM AssetsクラウドインスタンスをBrand Portalテナント(組織)と共に設定するには、AEM AssetsクラウドインスタンスとAdobe Developer Consoleの両方を設定する必要があります。
  1. AEM Assetsクラウドインスタンスで、IMSアカウントを作成し、公開証明書(公開鍵)を生成します。
  2. Adobe Developer Consoleで、Brand Portalテナント(組織)用のプロジェクトを作成します。
  3. プロジェクトで、公開鍵を使用してAPIを設定し、サービスアカウント(JWT)接続を作成します。
  4. サービスアカウントの資格情報とJWTペイロード情報を取得します。
  5. AEM Assetsクラウドインスタンスで、サービスアカウントの資格情報とJWTペイロードを使用してIMSアカウントを設定します。
  6. AEM Assetsクラウドインスタンスで、IMSアカウントとブランドポータルエンドポイント(組織URL)を使用してBrand Portalクラウドサービスを設定します。
  7. AEM AssetsクラウドインスタンスからBrand Portalにアセットを公開して、設定をテストします。
Brand Portalテナントは、1つのAEM Assetsクラウドインスタンスでのみ設定できます。
複数のAEM Assetsクラウドインスタンスを持つBrand Portalテナントは設定しないでください。

前提条件

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

設定の作成

指定した順序で次の手順を実行し、AEM Assetsクラウドインスタンスをブランドポータルに設定します。

IMS 設定の作成

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

公開証明書の取得

公開証明書を使用すると、Adobe Developer Consoleでプロファイルを認証できます。
  1. AEM Assetsクラウドインスタンスにログインします。
  2. ツール パネルで、 セキュリティ/ Adobe IMS設定のに移動します。
  3. Adobe IMS設定ページで、「 作成 」をクリックします。
  4. Adobe IMSテクニカルアカウント設定 」ページにリダイレクトされます。 By default, the Certificate tab opens.
    クラウドソリューションの Adobe Brand Portalを選択します
  5. 新しい証明書を作成 」チェックボックスをチェックし、証明書の​ エイリアス ​を指定します。ここで入力したエイリアスが、ダイアログ名として表示されます。
  6. 証明書を作成 」をクリックします。次に、ダイアログボックスで 「OK 」をクリックして、公開証明書を生成します。
  7. Click Download Public Key and save the certificate (.crt) file on your machine.
    この証明書ファイルは、Brand PortalテナントのAPIを設定し、Adobe Developer Consoleでサービスアカウントの資格情報を生成するための追加の手順で使用されます。
  8. 次へ 」をクリックします。
    アカウント 」タブでAdobe IMSアカウントを作成しますが、作成するにはAdobe Developer Consoleで生成されるサービスアカウント資格情報が必要です。 このページは開いたままにしておきます。
    新しいタブを開き、Adobe Developer Consoleでサービスアカウント(JWT)接続を サービスアカウント(JWT)接続の作成 作成して、IMSアカウントを設定するための秘密鍵証明書とJWTペイロードを取得します。

サービスアカウント(JWT)接続の作成

Adobe Developer Consoleでは、プロジェクトとAPIは組織(Brand Portalテナント)レベルで設定されます。 APIを設定すると、Adobe Developer Consoleでサービスアカウント(JWT)接続が作成されます。 キーペア(秘密鍵と公開鍵)を生成するか、公開鍵をアップロードして、APIを設定する方法は2つあります。 Brand PortalでAEM Assetsクラウドインスタンスを設定するには、AEM Assetsクラウドインスタンスで公開証明書(公開鍵)を生成し、公開鍵をアップロードしてAdobe Developer Consoleで秘密鍵証明書を作成する必要があります。 この公開鍵は、選択したブランドポータル組織のAPIを設定するために使用され、サービスアカウントの資格情報とJWTペイロードを生成します。 これらの資格情報は、AEM AssetsクラウドインスタンスでIMSアカウントを設定する際にさらに使用されます。 IMSアカウントを設定すると、AEM AssetsクラウドインスタンスでBrand Portalクラウドサービスを設定できます。
次の手順を実行して、サービスアカウント資格情報とJWTペイロードを生成します。
  1. IMS組織(Brand Portalテナント)のシステム管理者権限でAdobe Developer Consoleにログインします。 デフォルトのURLは
    右上隅にあるドロップダウン(組織リスト)から正しいIMS組織(Brand Portalテナント)が選択されていることを確認します。
  2. Click Create new project . 組織用に空のプロジェクトが作成されます。
    プロジェクトの編集 」をクリックして、 プロジェクトタイトル 説明を更新し、「保存と ​保存」をクリックします。
  3. 「プロジェクトの概要」タブで、「 追加API 」をクリックします。
  4. API追加ウィンドウで、「 AEM Brand Portal 」を選択し、「 次へ 」をクリックします。
    AEM Brand Portalサービスにアクセスできることを確認します。
  5. APIを設定ウィンドウで、「公開鍵を アップロード 」をクリックします。 次に、「ファイルを 選択 」をクリックし、「公開証明書を 取得 」セクションでダウンロードした公開証明書(.crtファイル)をアップロードします。
    次へ 」をクリックします。
  6. 公開証明書を確認し、「 次へ 」をクリックします。
  7. デフォルトの製品プロファイル「 アセット」「ブランドポータル 」を選択し、「設定 を保存 」をクリックします。
  8. APIが設定されている場合、APIの概要にリダイレクトされます。 左側のナビゲーションの「 資格情報 」で、「 サービスアカウント(JWT)」をクリックし ​ます。
    必要に応じて、秘密鍵証明書を表示し、その他の操作(JWTトークンの生成、秘密鍵証明書の詳細のコピー、クライアントシークレットの取得など)を実行できます。
  9. Client Credentials 」タブで、 クライアントIDをコピーします
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
クライアントID(APIキー)、クライアントシークレットおよびJWTペイロードを使用して、AEM AssetsクラウドインスタンスでIMSアカウント 設定できるようになりました。

IMSアカウントの設定

次の手順を実行したことを確認します。
次の手順を実行して、公開証明書を 取得して作成したIMSアカウントを設定します
  1. IMS設定を開き、「 アカウント 」タブに移動します。 公開証明書の 取得中も、ページを開いたままでした
  2. IMS アカウントの​ タイトル ​を指定します。
    認証サーバー 」に次の URL を入力します。 https://ims-na1.adobelogin.com/
    作成 」をクリックします。
    IMSアカウントが設定されている。
  3. Select the IMS account configuration and click Check Health .
    ダイアログボックスで 「チェック 」をクリックします。 設定が成功すると、 トークンが正常に取得されたことを示すメッセージが表示されます
IMS 設定は 1 つだけにする必要があります。複数の IMS 設定を作成しないでください。
IMS 設定がヘルスチェックに合格していることを確認します。設定がヘルスチェックに合格しない場合は無効です。削除して、新しい有効な設定を作成する必要があります。

Cloud Service の設定

次の手順を実行して、ブランドポータルクラウドサービスを設定します。
  1. AEM Assetsクラウドインスタンスにログインします。
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. Brand Portal Configurationsページで、「 作成 」をクリックします。
  4. 設定の​ タイトル ​を入力します。
    In the Service URL , enter your Brand Portal tenant (organization URL).
  5. 保存して閉じる 」をクリックします。クラウド設定が作成されます。AEM Assets クラウドインスタンスが Brand Portal テナントで設定されました。

設定のテスト

次の手順を実行して設定を検証します。
  1. AEM Assetsクラウドインスタンスにログインします。
  2. From the Tools panel, navigate to Deployment > Distribution .
  3. 配布ページでは、「ブランドポータルに 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. Follow the steps (from 1 to 4) as shown in the test connection section and navigate to the distribution agent page.
  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 で変更された場合に、追加のリクエストが生成されます。