Brand Portal を使用した Experience Manager Assets 設定 configure-aem-assets-with-brand-portal
Adobe Experience Manager Assets Brand Portal を設定すると、承認済みのブランドアセットを Adobe Experience Manager Assets as a Cloud Service インスタンスから Brand Portal に公開し、Brand Portal ユーザーに配信できます。
Cloud Manager を使用して Brand Portal をアクティベート activate-brand-portal
Cloud Manager ユーザーは、Experience Manager Assets as a Cloud Service インスタンス用の Brand Portal をアクティブ化します。アクティブ化のワークフローでは、必要な設定(認証トークン、IMS 設定および Brand Portal クラウドサービス)がバックエンドで作成され、Cloud Manager の Brand Portal テナントのステータスが反映されます。Brand Portal をアクティブ化すると、Experience Manager Assets のユーザーが Brand Portal にアセットを公開して、Brand Portal ユーザーに配布できるようになります。
前提条件
Experience Manager Assets as a Cloud Service インスタンスで Brand Portal をアクティブ化するには、次のものが必要です。
- 稼働中の Experience Manager Assets as a Cloud Service インスタンス。
- Cloud Manager 製品のプロファイルに割り当てられている、Cloud Manager にアクセスできるユーザー。詳しくは、Cloud Manager へのアクセスを参照してください。
Brand Portal をアクティブ化する手順
Brand Portal のライセンス認証は、Experience Manager Assets as a Cloud Service インスタンス用の実稼動環境を作成する際に行うことも、別個に行うこともできます。環境が既に作成されており、Brand Portal をライセンス認証する必要があるとします。
-
Adobe Cloud Manager にログインし、環境 に移動します。
環境 ページには、既存の環境のリストが表示されます。
-
環境の詳細を表示するリストから環境を(1 つずつ)選択します。
Brand Portal には利用可能な環境のうちいずれかの権利が付与され、環境情報 に反映されます。
Brand Portal に関連付けられている環境を見つけたら、「Brand Portal のライセンス認証」ボタンをクリックして、アクティベーションワークフローを開始します。
-
アクティベーションワークフローがバックエンドで必要な設定を作成するので、Brand Portal テナントのライセンス認証に数分かかります。Brand Portal テナントがライセンス認証されると、ステータスが「アクティベート済み」に変わります。
org2-new
にリセットされます。org1-existing
で手動で設定したクラウド設定は、Experience Manager Assets のオーサーインスタンスに表示されますが、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 が不明な場合は、次の手順を実行します。
-
Admin Console にログインし、製品 に移動します。
-
左パネルの「Adobe Experience Manager Brand Portal - Brand Portal」を選択します。
-
「Brand Portal に移動」をクリックして、ブラウザーで直接 Brand Portal を開きます。
または、Brand Portal へ移動 リンクから Brand Portal テナント URL をコピーし、ブラウザーに貼り付けて Brand Portal インターフェイスを開きます。
接続をテストします。
Experience Manager Assets as a Cloud Service インスタンスと Brand Portal テナントとの接続を検証するには、次の手順を実行します。
-
Experience Manager Assets にログインします。
-
ツール パネルで、デプロイメント/配布 に移動します。
Brand Portal 配布エージェント(bpdistributionagent0)は、「Brand Portal に公開」の下に作成されます。
-
「Brand Portal に公開」をクリックして、配布エージェントを開きます。
「ステータス」タブに配布キューが表示されます。
配布エージェントには、次の 2 つのキューが含まれます。
-
processing-queue:Brand Portal へのアセット配布用。
-
error-queue:配布が失敗したアセット用。
note note NOTE エラーを確認し、error-queue を定期的に消去することをお勧めします。 -
-
Experience Manager Assets as a Cloud Service と Brand Portal との接続を確認するには、「接続をテスト」アイコンをクリックします。
テストパッケージが正常に配信された ことを示すメッセージが表示されます。
note note NOTE 配布エージェントを無効にしないでください。無効にすると、(実行中のキュー内の)アセットの配布が失敗する可能性があります。
Experience Manager Assets as a Cloud Service インスタンスと Brand Portal テナントとの接続を確認するには、Experience Manager Assets から Brand Portal にアセットを公開します。接続に成功すると、公開されたアセットが Brand Portal インターフェイスに表示されます。
次の操作が可能になっています。
詳しくは、 Brand Portal ドキュメント を参照してください。
配布ログ
配布エージェントのログで、アセット発行ワークフローを監視できます。
Experience Manager Assets から Brand Portal にアセットを公開して、ログを確認しましょう。
-
「設定のテスト」節で示した手順(1 ~ 4)に従い、配布エージェントページに移動します。
-
「ログ」をクリックして、処理ログとエラーログを表示します。
配布エージェントは次のログを生成します。
- 情報:これは、配布エージェントの構成が正常に完了したときにトリガーされるシステムが生成するログです。
- DSTRQ1(リクエスト 1):テスト接続時にトリガーされます。
アセットの公開時に、次の要求および応答ログが生成されます。
配布エージェントの要求:
- DSTRQ2(リクエスト 2):アセットの公開リクエストがトリガーされます。
- DSTRQ3(リクエスト 3):システムは、アセットが存在する Experience Manager Assets フォルダーを公開する別のリクエストをトリガーし、そのフォルダーを Brand Portal に複製します。
配布エージェントの応答:
- queue-bpdistributionagent0(DSTRQ2):アセットが Brand Portal に公開されます。
- queue-bpdistributionagent0(DSTRQ3):システムは、アセットを含んだ Experience Manager Assets フォルダーを Brand Portal に複製します。
上記の例では、追加の要求と応答がトリガーされます。アセットが初めて公開されたため、システムは Brand Portal で親フォルダー(パスの追加)を見つけることができず、アセットが公開されている Brand Portal で同じ名前の親フォルダーを作成する追加リクエストをトリガーしました。
Experience Manager Assets as a Cloud Service で Brand Portal をアクティブ化する自動処理ワークフロー以外に、Adobe Developer Console を使用して Experience Manager Assets as a Cloud Service と Brand Portal の連携を手動で設定する方法もありますが、こちらの方法はお勧めしません。
Adobe Developer Console を使用した手動設定 manual-configuration
次の節では、Adobe Developer Console を使用して Experience Manager Assets as a Cloud Service と Brand Portal の連携を手動で設定する方法について説明します。
以前は、Experience Manager Assets as a Cloud Service と Brand Portal の連携は Adobe Developer Console を介して手動で設定されており、Brand Portal テナントの認証のために Adobe Identity Management Services(IMS)アカウントトークンを入手していました。それには、Experience Manager Assets と Adobe Developer Console の両方で設定を行う必要があります。
- Experience Manager Assets で、IMS アカウントを作成し、公開鍵(証明書)を生成します。
- Adobe 開発者コンソールで、Brand Portal テナント(組織)用のプロジェクトを作成します。
- そのプロジェクトで、公開鍵で API を設定して、サービスアカウント接続を作成します。
- サービスアカウント資格情報と JSON Web トーケン(JWT)ペイロード情報を取得します。
- Experience Manager Assets で、サービスアカウント資格情報と JWT ペイロードを使用して IMS アカウントを設定します。
- Experience Manager Assets で、IMS アカウントと Brand Portal エンドポイント(組織 URL)を使用して Brand Portal クラウドサービスを設定します。
- Experience Manager Assets から Brand Portal にアセットを公開して、設定をテストします。
前提条件
Experience Manager Assets と Brand Portal の連携を設定するには、以下が必要です。
- 稼働中の Experience Manager Assets as a Cloud Service インスタンス
- Brand Portal テナント URL
- Brand Portal テナントの IMS 組織に対するシステム管理者権限を持つユーザー
設定の作成 create-new-configuration
指定した順序で次の手順を実行して、Brand Portal で Experience Manager Assets を設定します。
IMS 設定の作成 create-ims-configuration
IMS 設定では、Brand Portal テナントで Experience Manager as a Cloud Service インスタンスを認証します。
IMS 設定には、次の 2 つの手順が含まれます。
公開証明書の取得 public-certificate
公開鍵(証明書)は、Adobe 開発者コンソールでプロファイルを認証します。
-
Experience Manager Assets にログインします。
-
ツール パネルで、セキュリティ/Adobe IMS 設定 に移動します。
-
Adobe IMS 設定ページで、「作成」をクリックします。Adobe IMS 技術アカウント設定 ページにリダイレクトされます。デフォルトでは、「証明書」タブが開きます。
-
「クラウドソリューション」ドロップダウンリストで「Adobe Brand Portal」を選択します。
-
「新しい証明書を作成」チェックボックスをオンにして、公開鍵の エイリアス を指定します。ここで入力したエイリアスが、公開鍵になります。
-
「証明書を作成」をクリックします。「OK」をクリックして公開証明書を生成します。
-
公開鍵をダウンロード アイコンをクリックして、公開鍵(CRT)ファイルをローカルマシンに保存します。
この公開鍵は、Brand Portal テナントの API を設定し、Adobe 開発者コンソールでサービスアカウント資格情報を生成するために後で使用します。
-
「次へ」をクリックします。
「アカウント」タブで、Adobe IMS アカウントが作成されます。このアカウントには、Adobe 開発者コンソールで生成されるサービスアカウント資格情報が必要です。このページは開いたままにしておきます。
新しいタブを開き、 Adobe 開発者コンソールでサービスアカウント(JWT)接続を作成 して、IMS アカウントを設定するための資格情報と JWT ペイロードを取得します。
サービスアカウント(JWT)接続の作成 createnewintegration
Adobe 開発者コンソールで、プロジェクトと API を Brand Portal テナント(組織)レベルで設定します。API を設定すると、サービスアカウント(JWT)接続が作成されます。API を設定するには、キーペア(秘密鍵と公開鍵)を生成する方法と、公開鍵をアップロードする方法の 2 とおりがあります。Brand Portal で Experience Manager Assets を設定するには、Experience Manager Assets で公開鍵(証明書)を生成し、その公開鍵をアップロードして Adobe Developer コンソールで資格情報を作成する必要があります。これらの資格情報は、Experience Manager Assets で IMS アカウントを設定するために必要です。IMS アカウントを設定したら、Experience Manager Assets に Brand Portal クラウドサービスを設定できます。
サービスアカウント資格情報と JWT ペイロードを生成するには、次の手順を実行します。
-
IMS 組織(Brand Portal テナント)のシステム管理者権限で Adobe Developer Console にログインします。デフォルトの URL は https://www.adobe.com/go/devs_console_ui です。
note note NOTE 右上隅にあるドロップダウン(組織)リストから正しい IMS 組織(Brand Portal テナント)が選択されていることを確認します。 -
「新規プロジェクトを作成」をクリックします。システムで生成された名前を持つ空のプロジェクトが組織に対して作成されます。
「プロジェクトを編集」をクリックして、「プロジェクトタイトル」と「説明」をアップデートし、「保存」をクリックします。
-
「プロジェクトの概要」タブで、「API を追加」をクリックします。
-
API を追加 ウィンドウで、「AEM Brand Portal」を選択し、「次へ」をクリックします。
Experience Manager Brand Portal サービスにアクセスできることを確認します。
-
API を設定 ウィンドウで、「公開鍵をアップロード」をクリックします。次に、「ファイルを選択」をクリックし、公開証明書の取得のセクションでダウンロードした公開鍵(.crt ファイル)をアップロードします。
「次へ」をクリックします。
-
公開鍵を確認し、「次へ」をクリックします。
-
デフォルトの製品プロファイルとして「Assets Brand Portal」を選択し、「設定済み API を保存」をクリックします。
-
API が設定されると、API の概要ページにリダイレクトされます。「資格情報」の下の左側のナビゲーションで「サービスアカウント(JWT)」オプションをクリックします。
note note NOTE - 資格情報を確認し、必要に応じて、JWT トークンの生成、資格情報の詳細のコピー、クライアントの秘密鍵の取得などのアクションを実行できます。
- 現在、Adobeの開発者コンソールサービスアカウント (JWT) 秘密鍵証明書の種類のみがサポートされています。 次を使用しない
OAuth Server-to-Server
4 月中旬にサポートされるまでの資格情報タイプ。 詳しくは、 Adobe Developerコンソールでの JWT 資格情報の廃止.
-
「クライアント資格情報」タブから、クライアント ID をコピーします。
「クライアント秘密鍵を取得」をクリックし、クライアントの秘密鍵 をコピーします。
-
「JWT を生成」タブに移動し、JWT ペイロード 情報をコピーします。
これで、クライアント ID(API キー)、クライアントシークレット、JWT ペイロードを使用して、Experience Manager Assets に IMS アカウントを設定できるようになりました。
IMS アカウントの設定 create-ims-account-configuration
次の手順を実行したことを確認します。
IMS アカウントを設定するには、次の手順を実行します。
-
IMS 設定を開き、「アカウント」タブに移動します。公開証明書の取得中も、ページは開いたままになっています。
-
IMS アカウントの タイトル を指定します。
「認証サーバー」フィールドで、URL「 https://ims-na1.adobelogin.com/」を指定します。
API キー にクライアント ID を指定し、サービスアカウント(JWT)接続の作成時にコピーした クライアントの秘密鍵 と ペイロード(JWT ペイロード)を貼り付けます。
「作成」をクリックします。
IMS アカウントが設定されます。
-
その IMS アカウント設定を選択し、「正常性をチェック」をクリックします。
ダイアログボックスの「チェック」をクリックします。正常に設定されると、トークンが正常に取得されました というメッセージが表示されます。
Cloud Service の設定 configure-the-cloud-service
Brand Portal Cloud Service を設定するには、次の手順を実行します。
-
Experience Manager Assets にログインします。
-
ツール パネルで、クラウドサービス/AEM Brand Portal に移動します。
-
Brand Portal の設定ページで、「作成」をクリックします。
-
設定の タイトル を入力します。
IMS アカウントの設定 時に作成した IMS 設定を選択します。
「サービス URL」に、Brand Portal テナント(組織)URL を入力します。
-
「保存して閉じる」をクリックします。クラウド設定が作成されます。
これで、Experience Manager Assets as Cloud Service インスタンスが Brand Portal で設定されました。
これで、配信エージェントを確認し、Brand Portal にアセットを公開することで、設定をテストできます。
セキュアプレビューが有効な場合は、SPS でエグレス IP を許可リストに登録する
(会社に対してセキュアプレビューが有効な状態で)Dynamic Media - Scene7 を使用する場合は、Scene7 会社管理者が SPS(Scene7 Publishing System)Flash UI を使用して、それぞれの地域の公開エグレス IP を許可リストに登録することをお勧めします。
エグレス IP は次のとおりです。
関連情報