AEM Assets as aCloud Serviceと Brand Portal の連携の設定

Adobe Experience Manager Assets Brand Portal を設定すると、承認済みのブランドアセットを Adobe Experience Manager Assets as a Cloud Service インスタンスから Brand Portal に公開し、Brand Portal ユーザーに配信できます。

Cloud Manager を使用して Brand Portal をライセンス認証する

Cloud Manager ユーザーは、AEM Assets as a Cloud Service インスタンスで、Brand Potal をライセンス認証します。アクティベーションワークフローは、バックエンドに必要な設定(認証トークン、IMS 設定および Brand Portal クラウドサービス)を作成し、Cloud Manager の Brand Portal テナントのステータスを反映します。Brand Portal をライセンス認証すると、AEM Assets のユーザは Brand Portal にアセットを公開して、Brand Portal ユーザーに配信できます。

前提条件

AEM Assets as a Cloud Service インスタンスで Brand Portal をライセンス認証するには、以下が必要です。

  • 実行中の AEM Assets as a Cloud Service インスタンス。
  • Cloud Manager 製品のプロファイルに割り当てられている、Cloud Manager にアクセスできるユーザー。詳しくは、Cloud Manager へのアクセスを参照してください。
メモ

AEM Assets as a Cloud Service インスタンスは、1 つの Brand Portal テナントとのみ接続できます。AEM Assets as a Cloud Service インスタンスに複数の環境(開発、実稼動、ステージ)を設定できます。この場合、Brand Portal は 1 つの環境でアクティブになります。

Brand Portal のライセンス認証手順

Brand Portal は、AEM Assets as a Cloud Service のインスタンス用に環境を作成するか、または個別に作成するときにライセンス認証できます。環境が既に作成され、Brand Portal をライセンス認証する必要があるとします。

  1. Adobe Cloud Manager にログインし、「環境」に移動します。

    環境​ページには、既存の環境のリストが表示されます。

  2. 環境の詳細を表示するリストから環境を(1 つずつ)選択します。

    Brand Portal には利用可能な環境のうちいずれかの権利が付与され、環境情報​に反映されます。

    Brand Portal に関連付けられている環境を見つけたら、「Brand Portal のライセンス認証」ボタンをクリックして、アクティベーションワークフローを開始します。

    Brand Portal のライセンス認証

  3. アクティベーションワークフローがバックエンドで必要な設定を作成するので、Brand Portal テナントのライセンス認証に数分かかります。Brand Portal テナントがライセンス認証されると、ステータスが「アクティベート済み」に変わります。

    表示ステータス

メモ

Brand Portal は、AEM Assets as a Cloud Service インスタンスと同じ IMS 組織でライセンス認証する必要があります。

IMS 組織(org1-existing)に既存の Brand Portal のクラウド設定(Adobe 開発者コンソールを使用して手動で設定)があり、AEM Assets as a Cloud Serviceインスタンスが別の IMS 組織(org2-new)に設定されている場合、Cloud Manager から Brand Portal のライセンス認証を行うと、Brand Portal IMS 組織が org2-new にリセットされます。org1-existing で手動で設定したクラウド設定は、AEM Assets のオーサーインスタンスには表示されますが、Cloud Manager で Brand Portal をアクティベートすると使用できなくなります。

既存の Brand Portal クラウド設定と AEM Assets as a Cloud Service インスタンスが同じ IMS 組織(org1)を使用している場合は、Cloud Manager から Brand Portal をライセンス認証するだけで済みます。

自動生成された設定は変更しないでください。

関連トピック:

Brand Portal テナントへのログイン

Cloud Manager で Brand Portal テナントをライセンス認証した後、Admin Console から、またはテナント URL を使用して直接 Brand Portal にログインできます。

Brand Portal テナントのデフォルト URL は https://<tenant-id>.brand-portal.adobe.com/ です。

ここで、テナント ID は IMS 組織です。

ブランドポータルの URL が不明な場合は、次の手順を実行します。

  1. Admin Consoleにログインし、「製品」に移動します。

  2. 左パネルの「Adobe Experience Manager Brand Portal - Brand Portal」を選択します。

  3. Brand Portal に移動」をクリックして、ブラウザーで直接 Brand Portal を開きます。

    または、Brand Portal へ移動​リンクから Brand Portal テナント URL をコピーし、ブラウザーに貼り付けて Brand Portal インターフェイスを開きます。

    Brand Portal にアクセス

接続をテストします。

次の手順を実行して、AEM Assets as a Cloud Service インスタンスと Brand Portal テナントの接続を検証します。

  1. AEM Assets にログインします。

  2. ツール​パネルで、導入配布版​に移動します。

    Brand Portal 配布エージェント(bpdistributionagent0)は、「Brand Portal に公開」の下に作成されます。

  3. Brand Portal に公開」をクリックして、配布エージェントを開きます。

    ステータス」タブに配布キューが表示されます。

    配布エージェントには、次の 2 つのキューが含まれます。

    • processing-queue:Brand Portal へのアセット配布用。

    • error-queue:配布が失敗したアセット用。

    メモ

    エラーを確認し、error-queue を定期的に消去することをお勧めします。

  4. AEM Assets as a Cloud Service と Brand Portal の間の接続を確認するには、「接続をテスト」アイコンをクリックします。

    テストパッケージが正常に配信された​ことを示すメッセージが表示されます。

    メモ

    配布エージェントを無効にしないでください。無効にすると、(実行中のキュー内の)アセットの配布が失敗する可能性があります。

AEM Assets as a Cloud Service インスタンスと Brand Portal テナントの間の接続を検証するには、AEM Assets から Brand Portal にアセットを公開します。接続に成功すると、公開されたアセットが Brand Portal インターフェイスに表示されます。

次の操作が可能になっています。

詳しくは、Brand Portal ドキュメントを参照してください。

配布ログ

配布エージェントのログで、アセット発行ワークフローを監視できます。

次に、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):システムは、Brand Portal 内のアセットを含む AEM Assets フォルダーを複製します。

上記の例では、追加の要求と応答がトリガーされます。アセットが初めて発行されたので、Brand Portal で親フォルダー(追加パス)が見つからなかったため、アセットが発行された Brand Portal で同じ名前の親フォルダーを作成する追加の要求をトリガーします。

メモ

親フォルダーが Brand Portal に存在しない場合や AEM Assets で変更された場合には、追加のリクエストが生成されます。

自動処理ワークフローを使用して AEM Assets as a Cloud Service で Brand Portal のライセンス認証を行う方法以外に、Adobe 開発者コンソールを使用して、AEM Assets as a Cloud Service と Brand Portal の連携を手動設定する方法もありますが、この方法は推奨されません。

メモ

Brand Portalテナントのアクティベート中に問題が発生した場合は、カスタマーサポートにお問い合わせください。

Adobe 開発者コンソールを使用した手動設定

次の節では、Adobe 開発者コンソールを使用して、AEM Assets as a Cloud Serviceと Brand Portal の連携を手動で設定する方法について説明します。

AEM Assets as a Cloud Service と Brand Portal の連携は、Adobe 開発者コンソールを通じて設定されます。このコンソールでは、Brand Portal テナントの認証に使用する Adobe Identity Management サービス(IMS)アカウントトークンを調達します。この機能を使用するには、AEM Assets および Adobe 開発者コンソールの両方の設定が必要です。

  1. AEM Assets で、IMS アカウントを作成して公開鍵(証明書)を生成します。
  2. Adobe 開発者コンソールで、Brand Portal テナント(組織)用のプロジェクトを作成します。
  3. そのプロジェクトで、公開鍵で API を設定して、サービスアカウント接続を作成します。
  4. サービスアカウント資格情報と JSON Web トーケン(JWT)ペイロード情報を取得します。
  5. AEM Assets で、サービスアカウント資格情報と JWT ペイロードを使用して IMS アカウントを設定します。
  6. AEM Assets で、IMS アカウントと Brand Portal エンドポイント(組織 URL)を使用して Brand Portal Cloud Service を設定します。
  7. AEM Assets から Brand Portal にアセットを公開して、設定をテストします。
メモ

AEM Assets as a Cloud Service インスタンスには、1 つの Brand Portal テナントとの連携のみ設定する必要があります。

前提条件

AEM Assets と Brand Portal の連携を設定するには以下が必要です。

  • 実行中の AEM Assets as a Cloud Service インスタンス
  • Brand Portal テナント URL
  • Brand Portal テナントの IMS 組織に対するシステム管理者権限を持つユーザー

設定の作成

指定した順序で次の手順を実行して、AEM Assets と Brand Portal の連携を設定します。

  1. 公開証明書の取得
  2. サービスアカウント(JWT)接続の作成
  3. IMS アカウントの設定
  4. Cloud Service の設定

IMS 設定の作成

IMS 設定では、AEM Assets as a Cloud Service インスタンスと Brand Portal テナントの連携を認証します。

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

公開証明書の取得

公開鍵(証明書)は、Adobe 開発者コンソールでプロファイルを認証します。

  1. AEM Assets にログインします。

  2. ツール​パネルで、セキュリティAdobe IMS 設定​に移動します。

  3. Adobe IMS 設定ページで、「作成」をクリックします。Adobe IMS 技術アカウント設定​ページにリダイレクトされます。デフォルトでは、「証明書」タブが開きます。

  4. クラウドソリューション」ドロップダウンリストで「Adobe Brand Portal」を選択します。

  5. 新しい証明書を作成」チェックボックスをオンにして、公開鍵の​エイリアス​を指定します。ここで入力したエイリアスが、公開鍵になります。

  6. 証明書を作成」をクリックします。「OK」をクリックして公開証明書を生成します。

    証明書を作成

  7. 公開鍵をダウンロード​アイコンをクリックして、公開鍵(CRT)ファイルをローカルマシンに保存します。

    この公開鍵を後で使用して、Brand Portal テナントの API を設定し、Adobe 開発者コンソールでサービスアカウント資格情報を生成が次の値である。

    証明書をダウンロード

  8. 次へ」をクリックします。

    アカウント」タブで、Adobe IMS アカウントが作成されます。このアカウントには、Adobe 開発者コンソールで生成されるサービスアカウント資格情報が必要です。このページは開いたままにしておきます。

    新しいタブを開き、Adobe 開発者コンソールでサービスアカウント(JWT)接続を作成して、IMS アカウントを設定するための資格情報と JWT ペイロードを取得します。

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

Adobe 開発者コンソールで、プロジェクトと API を Brand Portal テナント(組織)レベルで設定します。API を設定すると、サービスアカウント(JWT)接続が作成されます。API を設定するには、キーペア(秘密鍵と公開鍵)を生成する方法と、公開鍵をアップロードする方法の 2 とおりがあります。AEM Assets と Brand Portal の統合を設定するには、AEM Assets で公開鍵(証明書)を生成し、その公開鍵をアップロードして Adobe 開発者コンソールで資格情報を作成する必要があります。これらの資格情報は、AEM Assets で IMS アカウントを設定するために必要です。IMS アカウントを設定したら、AEM Assets に Brand Portal Cloud Service を設定できます。

サービスアカウント資格情報と JWT ペイロードを生成するには、次の手順を実行します。

  1. IMS 組織(Brand Portal テナント)のシステム管理者権限で Adobe 開発者コンソールにログインします。デフォルトの URL は https://www.adobe.com/go/devs_console_ui です。

    メモ

    右上隅にあるドロップダウン(組織)リストから正しい IMS 組織(Brand Portal テナント)が選択されていることを確認します。

  2. 新規プロジェクトを作成」をクリックします。システムで生成された名前を持つ空のプロジェクトが組織に対して作成されます。

    プロジェクトを編集」をクリックして、「プロジェクトタイトル」と「説明」をアップデートし、「保存」をクリックします。

  3. プロジェクトの概要」タブで、「API を追加」をクリックします。

  4. API を追加​ウィンドウで、「AEM Brand Portal」を選択し、「次へ」をクリックします。

    AEM Brand Portal サービスにアクセスできることを確認します。

  5. API を設定​ウィンドウで、「公開鍵をアップロード」をクリックします。次に、「ファイルを選択」をクリックし、公開証明書の取得のセクションでダウンロードした公開鍵(.crt ファイル)をアップロードします。

    次へ」をクリックします。

    「公開鍵をアップロード」

  6. 公開鍵を確認し、「次へ」をクリックします。

  7. デフォルトの製品プロファイルとして「Assets Brand Portal」を選択し、「設定済み API を保存」をクリックします。

    製品プロファイルを選択

  8. API が設定されると、API の概要ページにリダイレクトされます。左側のナビゲーションツリーで「資格情報」の下の「サービスアカウント(JWT)」オプションをクリックします。

    メモ

    資格情報を確認し、必要に応じて、JWT トークンの生成、資格情報の詳細のコピー、クライアントの秘密鍵の取得などのアクションを実行できます。

  9. クライアント資格情報」タブから、クライアント ID をコピーします。

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

    サービスアカウント資格情報

  10. JWT を生成」タブに移動し、JWT ペイロード​情報をコピーします。

これで、クライアント ID(API キー)、クライアントの秘密鍵、JWT ペイロードを使用して、AEM Assets に IMS アカウントを設定できるようになりました。

IMS アカウントの設定

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

IMS アカウントを設定するには、次の手順を実行します。

  1. IMS 設定を開き、「アカウント」タブに移動します。公開証明書の取得中も、ページは開いたままになっています。

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

    認証サーバー」フィールドで、URL「 https://ims-na1.adobelogin.com/」を指定します。

    API キー​にクライアント ID を指定し、サービスアカウント(JWT)接続の作成時にコピーした​クライアントの秘密鍵​と​ペイロード(JWT ペイロード)を貼り付けます。

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

    IMS アカウントが設定されます。

    IMS アカウントの設定

  3. その IMS アカウント設定を選択し、「正常性をチェック」をクリックします。

    ダイアログボックスの「チェック」をクリックします。正常に設定されると、トークンが正常に取得されました​というメッセージが表示されます。

注意

IMS 設定は 1 つだけにする必要があります。

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

Cloud Service の設定

Brand Portal Cloud Service を設定するには、次の手順を実行します。

  1. AEM Assets にログインします。

  2. ツール​パネルで、クラウドサービスAEM Brand Portal に移動します。

  3. Brand Portal の設定ページで、「作成」をクリックします。

  4. 設定の​タイトル​を入力します。

    IMS アカウントの設定時に作成した IMS 設定を選択します。

    サービス URL」に、Brand Portal テナント(組織)URL を入力します。

  5. 保存して閉じる」をクリックします。クラウド設定が作成されます。

    これで、AEM Assets as a Cloud Service インスタンスと Brand Portal テナントの連携が設定されました。

これで、配布エージェントを確認し、Brand Portal にアセットを公開することで、設定をテストできます。

このページ