Show Menu
トピック×

AEM Assets と Brand Portal の連携の設定

Adobe Experience Managerアセットブランドポータルを使用すると、承認されたブランドアセットをAdobe Experience ManagerアセットからBrand Portalに公開し、Brand Portalユーザに配信できます。
AEM Assetsは、Adobe開発者コンソールを介してBrand Portalで設定されます。このコンソールは、Brand Portalテナントの認証用にAdobeIdentity Managementサービス(IMS)アカウントトークンを調達します。
Adobe開発者コンソールを使用したBrand PortalでのAEM Assetsの設定は、AEM 6.5.4.0以降でサポートされています。
以前は、Brand Portalは従来のOAuth Gatewayを介して設定されていました。従来のOAuth Gatewayは、JSON Web Token(JWT)交換を使用して、認証用のIMSアクセストークンを取得します。
従来のOAuth Gatewayを使用した設定は、2020年4月6日からサポートされなくなり、Adobe開発者コンソールに変更されました。
既存のお客様のみ
既存のレガシーOAuth Gateway構成を引き続き使用することをお勧めします。 レガシーOAuth Gateway設定で問題が発生した場合は、既存の設定を削除し、Adobe開発者コンソールを使用して新しい設定を作成します。
このヘルプでは、次の2つの使用例について説明します。
  • 新しい設定 :新しいBrand Portalユーザーで、Brand PortalでAEM Assetsの作成者インスタンスを設定する場合は、Adobe開発者コンソールで設定を作成できます。
  • アップグレード設定 :既存のBrand Portalユーザーが従来のOAuth Gatewayに対して設定を行っている場合は、既存の設定を削除し、Adobe開発者コンソールを使用して新しい設定を作成します。
具体的には、以下の操作に関する十分な知識があるユーザーを対象としています。
  • Adobe Experience ManagerおよびAEMパッケージのインストール、設定、管理。
  • LinuxおよびMicrosoft Windowsオペレーティングシステムの使用

前提条件

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

Download and install AEM 6.5

AEMオーサーインスタンスを設定するには、AEM 6.5を使用することをお勧めします。 AEM が稼働していない場合は、以下の場所から AEM をダウンロードしてください。
AEM をダウンロードしたら、「 デプロイメントと保守 」の説明に従い、AEM オーサーインスタンスの設定を行ってください。

最新の AEM サービスパックをダウンロードしてインストールする

詳細な手順については、
最新のAEMパッケージまたはService Packが見つからない場合は、サポート にお問い合わせください。

設定の作成

Brand PortalでAEM Assetsを設定するには、AEM Assets作成者インスタンスとAdobe開発者コンソールの両方の設定が必要です。
  1. AEM Assetsで、IMSアカウントを作成し、公開証明書(公開鍵)を生成します。
  2. Adobe 開発者コンソールで、Brand Portal テナント(組織)用のプロジェクトを作成します。
  3. そのプロジェクトで、公開鍵で API を設定して、サービスアカウント(JWT)接続を作成します。
  4. サービスアカウント資格情報と JWT ペイロード情報を取得します。
  5. AEM Assetsで、サービスアカウント資格情報とJWTペイロードを使用してIMSアカウントを設定します。
  6. AEM Assetsで、IMSアカウントとBrand Portalエンドポイント(組織URL)を使用してBrand Portalクラウドサービスを設定します。
  7. AEM AssetsからBrand Portalにアセットを公開して、設定をテストします。
AEM Assetsの作成者インスタンスは、1つのBrand Portalテナントでのみ構成できます。
ブランドポータルを使用してAEM Assetsを初めて設定する場合は、一覧に示した順序で次の手順を実行します。

IMS 設定の作成

IMS設定は、Brand PortalテナントでAEM Assets作成者インスタンスを認証します。
IMS 設定には、次の 2 つの手順が含まれます。

公開証明書の取得

公開鍵(証明書)は、Adobeデベロッパーコンソールでプロファイルを認証します。
  1. AEM Assets オーサーインスタンスにログインします。デフォルトの URL は http://localhost:4502/aem/start.html です。
  2. ツール パネルで、 セキュリティ Adobe IMS 設定 ​に移動します。
  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. 設定の​ タイトル ​を入力します。
    IMS アカウントの設定 時に作成した IMS 設定を選択します。
    In the Service URL field, specify your Brand Portal tenant (organization) URL.
  5. 保存して閉じる 」をクリックします。クラウド設定が作成されます。
    これで、AEM Assets作成者インスタンスがBrand Portalテナントと共に設定されました。

設定のテスト

設定を検証するには、次の手順を実行します。
  1. AEM Assets クラウドインスタンスにログインします。
  2. From the Tools panel, navigate to Deployment > Replication .
  3. レプリケーションページで、「 作成者のエージェント 」をクリックします。
    Brand Portalテナント用に作成された4つのレプリケーションエージェントが表示されます。
    Brand Portalテナントのレプリケーションエージェントを探し、レプリケーションエージェントURLをクリックします。
    レプリケーションエージェントは並行して動作し、ジョブの分散を均等に共有するので、パブリッシング速度を元の速度の4倍に増やします。 クラウドサービスの設定後、複数のアセットの並列発行を有効にするために、デフォルトでアクティブ化される複製エージェントを有効にするために、追加の設定は必要ありません。
  4. To verify the connection between AEM Assets and Brand Portal, click on the Test Connection icon.
    ストパッケージが正常に配信されたことを示すメッセージが表示されます
  5. 4つのレプリケーションエージェントすべてでテスト結果を確認します。
    アセットの複製(実行中のキュー)が失敗する原因となる可能性があるので、複製エージェントを無効にしないでください。
    タイムアウトエラーを回避するために、4つのレプリケーションエージェントがすべて構成されていることを確認します。 See troubleshoot issues in parallel publishing to Brand Portal .
次の操作が可能になりました。
See Brand Portal documentation for more information.

設定のアップグレード

既存の設定をAdobe開発者コンソールにアップグレードするには、一覧に示した手順に従って次の手順を実行します。

実行中のジョブの確認

変更を行う前に、AEM Assetsの作成者インスタンスで発行ジョブが実行されていないことを確認してください。 その場合は、4つのレプリケーションエージェントすべてでアクティブなジョブの状態を確認し、キューがアイドル状態であることを確認できます。
  1. AEM Assets オーサーインスタンスにログインします。
  2. From the Tools panel, navigate to Deployment > Deployment Replication .
  3. レプリケーションページで、「 作成者のエージェント 」をクリックします。
  4. Brand Portalテナントのレプリケーションエージェントを見つけます。
    すべてのレプリケーションエージェントで キューがアイドル状態であることを確認します 。公開ジョブがアクティブでないことを確認します。

既存の設定の削除

既存の設定の削除時に、次のチェックリストを実行する必要があります。
  • 4つのレプリケーションエージェントをすべて削除する
  • Brand Portalクラウドサービスの削除
  • MACユーザーの削除
  1. AEM Assets作成者インスタンスにログインし、管理者としてCRX Liteを開きます。 デフォルトの URL は http://localhost:4502/crx/de/index.jsp です。
  2. Brand Portalテナントの4つのレプリケーションエージェントすべてに移動 /etc/replications/agents.author して削除します。
  3. Brand Portalクラウドサービスの設定に移動 /etc/cloudservices/mediaportal して削除します。
  4. Brand Portalテナントの /home/users/mac MACユーザ ​に移動して削除します。
AEM 6.5作成者インスタンスのAdobe開発者コンソールを使用して 、設定を 作成できるようになりました。