AEM Assets と Brand Portal の連携の設定 configure-integration-65
Adobe Experience Manager Assets Brand Portal では、承認済みのブランドアセットを Adobe Experience Manager Assets から Brand Portal に公開し、Brand Portal ユーザーに配信できます。
AEM Assets と Brand Portal の連携は、Adobe 開発者コンソールを通じて設定されます。このコンソールでは、Brand Portal テナントの認証に使用する Adobe Identity Management サービス(IMS)アカウントトークンを調達します。
このヘルプでは、次の 2 つのユースケースについて説明します。
- 新しい設定:新しい Brand Portal ユーザーが、Brand Portal を使用して AEM Assets オーサーインスタンスを設定する場合は、Adobe Developer Console で設定を作成できます。
- 設定のアップグレード:レガシーの OAuth ゲートウェイを使用して設定を行っている既存の Brand Portal ユーザーの場合は、Adobe Developer Console で既存の設定を削除し、新しい設定を作成します。
具体的には、以下の操作に関する十分な知識があるユーザーを対象としています。
-
Adobe Experience Manager パッケージと AEM パッケージのインストール、設定、管理
-
Linux® オペレーティングシステムと Microsoft® Windows オペレーティングシステムの使用
前提条件 prerequisites
AEM Assets と Brand Portal の連携を設定するには以下が必要です。
- 最新のサービスパックを適用した実行中の AEM Assets オーサーインスタンス
- Brand Portal テナント URL
- Brand Portal テナントの IMS 組織に対するシステム管理者権限を持つユーザー
最新の AEM サービスパックをダウンロードしてインストールする
AEM 6.5 のダウンロードとインストール aemquickstart
AEM オーサーインスタンスを設定するには、AEM 6.5 の使用をお勧めします。AEM が稼働していない場合は、以下の場所から AEM をダウンロードしてください。
-
既に AEM を使用している場合は、Adobe ライセンス web サイトから AEM 6.5 をダウンロードしてください。
-
Adobe パートナーの場合は、Adove パートナートレーニングプログラムから AEM 6.5 をリクエストしてください。
AEM をダウンロードしたら、デプロイとメンテナンスの説明に従って、AEM オーサーインスタンスの設定を行ってください。
最新の AEM サービスパックをダウンロードしてインストールする servicepack
手順について詳しくは、現在の AEM 6.5 サービスパックに関するリリースノートを参照してください。
最新の AEM パッケージまたはサービスパックが見つからない場合、Adobe カスタマーサポートにお問い合わせください。
設定の作成 configure-new-integration-65
Brand Portal と連携する AEM Assets の設定には、AEM Assets オーサーインスタンスと Adobe 開発者コンソールの両方の設定が必要です。
- AEM Assets クラウドインスタンスで、IMS アカウントを作成し、公開証明書(公開鍵)を生成します。
- Adobe 開発者コンソールで、Brand Portal テナント(組織)用のプロジェクトを作成します。
- そのプロジェクトで、公開鍵で API を設定して、サービスアカウント(JWT)接続を作成します。
- サービスアカウント資格情報と JWT ペイロード情報を取得します。
- AEM Assets で、サービスアカウント資格情報と JWT ペイロードを使用して IMS アカウントを設定します。
- AEM Assets で、IMS アカウントと Brand Portal エンドポイント(組織 URL)を使用して Brand Portal Cloud Service を設定します。
- AEM Assets から Brand Portal にアセットを公開して、設定をテストします。
AEM Assets と Brand Portal を初めて設定する場合は、以下の手順を上記の順序で実行します。
IMS 設定の作成 create-ims-configuration
IMS 設定では、AEM Assets オーサーインスタンスと Brand Portal テナントの連携を認証します。
IMS 設定には、次の 2 つの手順が含まれます。
公開証明書の取得 public-certificate
公開鍵(証明書)は、Adobe 開発者コンソールでプロファイルを認証します。
-
AEM Assets オーサーインスタンスにログインします。デフォルトの URL は
http://localhost:4502/aem/start.html
です。 -
ツール パネルで、セキュリティ/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 とおりがあります。AEM Assets と Brand Portal の統合を設定するには、AEM Assets で公開鍵(証明書)を生成し、その公開鍵をアップロードして Adobe 開発者コンソールで資格情報を作成する必要があります。これらの資格情報は、AEM Assets で IMS アカウントを設定するために必要です。IMS アカウントを設定したら、AEM Assets に Brand Portal Cloud Service を設定できます。
サービスアカウント資格情報と JWT ペイロードを作成するには、以下の手順を実行します。
-
IMS 組織(Brand Portal テナント)のシステム管理者権限で Adobe 開発者コンソールにログインします。デフォルトの URL は https://www.adobe.com/go/devs_console_ui です。
note note NOTE 右上隅のドロップダウン(組織)リストから正しい IMS 組織(Brand Portal テナント)が選択されていることを確認します。 -
「新規プロジェクトを作成」をクリックします。システムで生成された名前を持つ空のプロジェクトが組織に対して作成されます。
「プロジェクトを編集」をクリックして、「プロジェクトタイトル」と「説明」を更新し、「保存」をクリックします。
-
「プロジェクトの概要」タブで、「API を追加」をクリックします。
-
API を追加 ウィンドウで、「AEM Brand Portal」を選択し、「次へ」をクリックします。
AEM Brand Portal サービスにアクセスできることを確認します。
-
API を設定 ウィンドウで、「公開鍵をアップロード」をクリックします。次に、「ファイルを選択」をクリックし、公開証明書の取得のセクションでダウンロードした公開鍵(.crt ファイル)をアップロードします。
「次へ」をクリックします。
-
公開鍵を確認し、「次へ」をクリックします。
-
デフォルトの製品プロファイルとして「Assets Brand Portal」を選択し、「設定済み API を保存」をクリックします。
-
API が設定されると、API の概要ページにリダイレクトされます。「資格情報」の下の左側のナビゲーションで「サービスアカウント(JWT)」オプションをクリックします。
note note NOTE 資格情報を表示し、JWT トークンの生成、資格情報の詳細のコピー、クライアントの秘密鍵の取得などのアクションを実行できます。 -
「クライアント資格情報」タブから、クライアント ID をコピーします。
「クライアント秘密鍵を取得」をクリックし、クライアントの秘密鍵 をコピーします。
-
「JWT を生成」タブに移動し、JWT ペイロード 情報をコピーします。
これで、クライアント ID(API キー)、クライアントの秘密鍵、JWT ペイロードを使用して、AEM Assets に IMS アカウントを設定できるようになりました。
IMS アカウントの設定 create-ims-account-configuration
次の手順を既に実行したことを確認します。
IMS アカウントを設定するには:
-
IMS 設定を開き、「アカウント」タブに移動します。公開証明書の取得中も、ページは開いたままになっています。
-
IMS アカウントの タイトル を指定します。
Adobe Analytics の 認証サーバー フィールドで、次の URL を指定します。 https://ims-na1.adobelogin.com/.
API キー にクライアント ID を指定し、サービスアカウント(JWT)接続の作成時にコピーした クライアントの秘密鍵 と ペイロード(JWT ペイロード)を貼り付けます。
「作成」をクリックします。
IMS アカウントが設定されます。
-
その IMS アカウント設定を選択し、「正常性をチェック」をクリックします。
ダイアログボックスの「チェック」をクリックします。正常に設定されると、トークンが正常に取得されました というメッセージが表示されます。
Brand Portal Cloud Service の設定 configure-the-cloud-service
-
AEM Assets オーサーインスタンスにログインします。
-
ツール の パネルで、Cloud Services/AEM Brand Portal に移動します。
-
Brand Portal の設定ページで、「作成」をクリックします。
-
設定の タイトル を入力します。
IMS アカウントの設定時に作成した IMS 設定を選択します。
「サービス URL」フィールドに、Brand Portal テナント(組織)URL を指定します。
-
「保存して閉じる」をクリックします。クラウド設定が作成されます。
これで、AEM Assets オーサーインスタンスと Brand Portal テナントの連携が設定されました。
設定のテストと検証 test-integration
-
AEM Assets クラウドインスタンスにログインします。
-
ツール の パネルで、デプロイメント/レプリケーション に移動します。
-
レプリケーションページで、「作成者のエージェント」をクリックします。
Brand Portal テナントのために作成された 4 つのレプリケーションエージェントを表示できます。
Brand Portal テナントのレプリケーションエージェントを探し、レプリケーションエージェントの URL をクリックします。
note note NOTE レプリケーションエージェントは並行して動作し、ジョブを均等に分配するので、公開の速度が元の速度の 4 倍に向上します。Cloud Service を設定した後、レプリケーションエージェントを有効にするために追加の設定は必要ありません。レプリケーションエージェントはデフォルトでアクティベートされ、複数のアセットを並行して公開できるようになります。 -
AEM Assets と Brand Portal の間の接続を確認するには、接続をテスト アイコンをクリックします。
テストパッケージが正常に配信された ことを示すメッセージが表示されます。
-
4 つのレプリケーションエージェントすべてでテスト結果を確認します。
note note NOTE どのレプリケーションエージェントも無効にしないでください。一部のアセットのレプリケーション(キューで実行中)が失敗する可能性があります。 タイムアウトエラーを避けるために、4 つのレプリケーションエージェントすべてが設定されていることを確認します。Brand Portal への並列公開における問題のトラブルシューティングを参照してください。 自動生成された設定は変更しないでください。
次の操作が可能になっています。
詳しくは、Brand Portal のドキュメントを参照してください。
設定のアップグレード upgrade-integration-65
既存の設定を Adobe Developer Console にアップグレードするには、次の手順を、指定された順序で実行します。
実行中のジョブの検証 verify-jobs
編集する前に、AEM Assets オーサーインスタンスで公開ジョブが実行されていないことを確認してください。そのため、4 つのレプリケーションエージェントすべてでアクティブジョブのステータスを確認し、キューがアイドル状態であることを確認できます。
-
AEM Assets オーサーインスタンスにログインします。
-
ツール の パネルで、デプロイメント/デプロイメントレプリケーション に移動します。
-
レプリケーションページで、「作成者のエージェント」をクリックします。
-
Brand Portal テナントのレプリケーションエージェントを見つけます。
すべてのレプリケーションエージェントに対して キューが待機中 で、アクティブな公開ジョブがないことを確認します。
既存の設定を削除 delete-existing-configuration
既存の設定を削除する際は、次のチェックリストを実行する必要があります。
- 4 つのレプリケーションエージェントをすべて削除
- Brand Portal Cloud Service の削除
- MAC ユーザーを削除
-
AEM Assets オーサーインスタンスにログインし、管理者として CRX Lite を開きます。デフォルトの URL は
http://localhost:4502/crx/de/index.jsp
です。 -
/etc/replications/agents.author
に移動して、Brand Portal テナントの 4 つのレプリケーションエージェントをすべて削除します。 -
/etc/cloudservices/mediaportal
に移動して、Brand Portal クラウドサービス設定を削除します。 -
/home/users/mac
に移動して、Brand Portal テナントの Mac ユーザー を削除します。
AEM 6.5 オーサーインスタンスの Adobe 開発者コンソールを使用して、設定を作成できます。