Show Menu
トピック×

Configure AEM Assets as a Cloud Service with Brand Portal

Adobe Experience Managerアセットブランドポータルを設定すると、承認済みのブランドアセットをAdobe Experience ManagerアセットからCloud Serviceインスタンスとしてブランドポータルに発行し、ブランドポータルユーザーに配信できます。
設定のワークフロー
Cloud ServiceとしてのAEM Assetsは、Adobe開発者コンソールを介してBrand Portalで設定されます。このコンソールは、AdobeIdentity Managementサービス(IMS)アカウントトークンを調達し、Brand Portalテナントの認証を受けます。 この機能を使用するには、AEM AssetsおよびAdobe開発者コンソールの両方の設定が必要です。
  1. AEM Assetsで、IMSアカウントを作成し、公開鍵(証明書)を生成します。
  2. Adobe 開発者コンソールで、Brand Portal テナント(組織)用のプロジェクトを作成します。
  3. プロジェクトで、公開鍵を使用してAPIを設定し、サービスアカウント接続を作成します。
  4. サービスアカウントの資格情報とJSON Web Token(JWT)ペイロード情報を取得します。
  5. AEM Assetsで、サービスアカウント資格情報とJWTペイロードを使用してIMSアカウントを設定します。
  6. AEM Assetsで、IMSアカウントとBrand Portalエンドポイント(組織URL)を使用してBrand Portalクラウドサービスを設定します。
  7. AEM AssetsからBrand Portalにアセットを公開して、設定をテストします。
Cloud ServiceインスタンスとしてのAEM Assetsは、1人のBrand Portalテナントでのみ構成する必要があります。

前提条件

AEM Assets と Brand Portal の連携を設定するには以下が必要です。
  • Cloud ServiceインスタンスとしてのAEM Assetsの起動および実行
  • Brand PortalテナントURL
  • Brand PortalテナントのIMS組織に対するシステム管理者権限を持つユーザー

設定の作成

指定したシーケンスで次の手順を実行して、ブランドポータルでAEM Assetsを設定します。

IMS 設定の作成

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

公開証明書の取得

公開鍵(証明書)は、Adobeデベロッパーコンソールでプロファイルを認証します。
  1. AEM Assets にログインします。
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Adobe IMS 設定ページで、「 作成 」をクリックします。It will redirect to the Adobe IMS Technical Account Configuration page. デフォルトでは、「 証明書 」タブが開きます。
  4. Cloud Solution 」ドロップダウンリストで「 Adobeブランドポータル 」を選択します。
  5. 新しい証明書を 作成 」チェックボックスをオンにして、公開鍵の エイリアスを指定します。 エイリアスは、公開鍵の名前として機能します。
  6. 証明書を作成 」をクリックします。Then, click OK to generate the public key.
  7. Click the Download Public Key icon and save the public key (.crt) file on your machine.
    公開鍵は、後でBrand PortalテナントのAPIを設定し、Adobeデベロッパーコンソールでサービスアカウントの資格情報を生成するために使用されます。
  8. 次へ 」をクリックします。
    アカウント 」タブで、AdobeIMSアカウントが作成されます。このアカウントには、Adobe開発者コンソールで生成されるサービスアカウント資格情報が必要です。 このページは開いたままにしておきます。
    新しいタブを開き、 Adobe 開発者コンソールでサービスアカウント(JWT)接続を作成 して、IMS アカウントを設定するための資格情報と JWT ペイロードを取得します。

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

Adobeデベロッパーコンソールでは、プロジェクトとAPIはBrand Portalテナント(組織)レベルで設定されます。 APIを設定すると、サービスアカウント(JWT)接続が作成されます。 API を設定するには、キーペア(秘密鍵と公開鍵)を生成する方法と、公開鍵をアップロードする方法の 2 とおりがあります。Brand PortalでAEM Assetsを設定するには、AEM Assetsで公開鍵(証明書)を生成し、Adobeデベロッパーコンソールで公開鍵をアップロードして秘密鍵証明書を作成する必要があります。 これらの資格情報は、AEM AssetsでIMSアカウントを設定するために必要です。 IMSアカウントを設定すると、AEM AssetsでBrand Portalクラウドサービスを設定できます。
サービスアカウント資格情報と JWT ペイロードを生成するには、次の手順を実行します。
  1. IMS 組織(Brand Portal テナント)のシステム管理者権限で Adobe 開発者コンソールにログインします。デフォルトの URL は次のとおりです。 https://www.adobe.com/go/devs_console_ui .
    右上隅にあるドロップダウン(組織)リストから正しいIMS組織(Brand Portalテナント)が選択されていることを確認します。
  2. 新規プロジェクトを作成 」をクリックします。システムで生成された名前を持つ空のプロジェクトが組織に対して作成されます。
    プロジェクトを編集 」をクリックして、「 プロジェクトタイトル 」と「 説明 」を更新し、「 保存 」をクリックします。
  3. In the Project overview tab, click Add API .
  4. In the Add an API window , select AEM Brand Portal and click Next .
    AEM Brand Portal サービスにアクセスできることを確認します。
  5. In the Configure API window, click Upload your public key . Then, click Select a File and upload the public key (.crt file) that you have downloaded in the obtain public certificate section.
    次へ 」をクリックします。
  6. Verify the public key and click Next .
  7. デフォルトの製品プロファイルとして 「Assets Brand Portal 」を選択し、「設定済みAPIを 保存 」をクリックします。
  8. APIが設定されると、APIの概要ページにリダイレクトされます。 From the left navigation under Credentials , click on the Service Account (JWT) option.
    秘密鍵証明書を表示し、JWTトークンの生成、秘密鍵証明書の詳細のコピー、クライアントシークレットの取得などの操作を実行できます。
  9. クライアント資格情報 」タブから、 クライアント ID をコピーします。
    クライアント秘密鍵を取得 」をクリックし、 クライアントの秘密鍵 ​をコピーします。
  10. Navigate to the Generate JWT tab and copy the JWT Payload information.
You can now use the client ID (API key), client secret, and JWT payload to configure the IMS account in AEM Assets.

IMS アカウントの設定

次の手順を実行したことを確認します。
次の手順を実行してIMSアカウントを設定します。
  1. Open the IMS Configuration and navigate to the Account tab. You kept the page open while obtaining the public certificate .
  2. IMS アカウントの​ タイトル ​を指定します。
    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/
    Specify client ID in the API key field, Client Secret , and Payload (JWT payload) that you have copied while creating the service account (JWT) connection .
    作成 」をクリックします。
    IMS アカウントが設定されます。
  3. その IMS アカウント設定を選択し、「 ヘルスチェック 」をクリックします。
    ダイアログボックスの「 チェック 」をクリックします。正常に設定されると、 トークンが正常に取得されました ​というメッセージが表示されます。
IMS 設定は 1 つだけにする必要があります。
IMS 設定がヘルスチェックに合格していることを確認します。設定がヘルスチェックに合格しない場合は無効です。削除して、新しい有効な設定を作成する必要があります。

Cloud Service の設定

Brand Portal Cloud Service を設定するには、次の手順を実行します。
  1. AEM Assets にログインします。
  2. ツール パネルで、 Cloud Services / AEM Brand Portalに移動します
  3. Brand Portal の設定ページで、「 作成 」をクリックします。
  4. 設定の​ タイトル ​を入力します。
    Select the IMS configuration that you created while configuring the IMS account .
    In the Service URL field, specify your Brand Portal tenant (organization) URL.
  5. 保存して閉じる 」をクリックします。クラウド設定が作成されます。
    Cloud ServiceインスタンスとしてのAEM AssetsがBrand Portalテナントと共に構成されました。

設定のテスト

設定を検証するには、次の手順を実行します。
  1. AEM Assets にログインします。
  2. ツール パネルで、 デプロイメント / 配布に移動します
    A Brand Portal distribution agent ( bpdistributionagent0 ) is created under Publish to Brand Portal .
  3. 「ブランドポータルに 公開 」をクリックして、配布エージェントを開きます。
    ステータス 」タブに配布キューが表示されます。
    配布エージェントには、次の 2 つのキューが含まれます。
    • processing-queue :Brand Portal へのアセット配布用。
    • error-queue :配布が失敗したアセット用。
    エラーを確認し、 error-queue を定期的に消去することをお勧めします。
  4. Cloud ServiceとしてのAEM AssetsとBrand Portalの間の接続を確認するには、「接続を テスト 」アイコンをクリックします。
    ストパッケージが正常に配信されたことを示すメッセージが表示されます
    配布エージェントを無効にしないでください。無効にすると、(実行中のキュー内の)アセットの配布が失敗する可能性があります。
次の操作が可能になりました。
See Brand Portal documentation for more information.

配布ログ

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