AEM Assets と Brand Portal の連携の設定

Adobe Experience Manager Assets とBrand Portalの連携は、 Adobe I/O:Brand Portalテナントの認証用の IMS トークンを取得します。

メモ

を介したBrand PortalとのAEM Assetsの設定 Adobe I/O は、AEM 6.4.8.0 以降でサポートされています。

これまで、Brand Portal は、旧来の OAuth ゲートウェイを通じてクラシック UI で設定されていました。このゲートウェイは、JWT トークン交換を使用して認証用の IMS アクセストークンを取得します。

ヒント

既存のお客様のみ

既存のレガシー OAuth Gateway 設定を引き続き使用することをお勧めします。レガシー OAuth Gateway 設定に問題が発生した場合は、既存の設定を削除し、 Adobe I/O.

このヘルプでは、次の 2 つの使用例について説明します。

  • 新しい設定:新しいBrand Portalユーザーで、Brand Portalを使用してAEM Assetsオーサーインスタンスを設定する場合は、で新しい設定を作成できます。 Adobe I/O.
  • 設定をアップグレード:旧来の OAuth Gateway でBrand Portalを使用してAEM Assetsオーサーインスタンスを設定している既存のBrand Portalユーザーの場合は、既存の設定を削除し、で新しい設定を作成することをお勧めします。 Adobe I/O.

具体的には、以下の操作に関する十分な知識があるユーザーを対象としています。

  • Adobe Experience ManagerおよびAEMパッケージのインストール、設定、管理

  • Linux およびMicrosoft Windows オペレーティングシステムの使用

前提条件

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

  • 最新のサービスパックを適用した実行中の AEM Assets オーサーインスタンス
  • Brand Portal テナント URL
  • Brand Portal テナントの IMS 組織に対するシステム管理者権限を持つユーザー

AEM 6.4 をダウンロードしてインストールする

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

AEM 6.4 をダウンロードしてインストールする

AEMオーサーインスタンスを設定するには、AEM 6.4 を使用することをお勧めします。 AEM が稼働していない場合は、以下の場所から AEM をダウンロードしてください。

AEM をダウンロードしたら、「デプロイメントと保守」の説明に従い、AEM オーサーインスタンスの設定を行ってください。

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

詳しい手順については、を参照してください。

カスタマーサポートに連絡 最新のAEMパッケージまたは Service Pack が見つからない場合。

設定の作成

AEM AssetsとBrand Portalを初めて設定する場合は、以下の手順を上記の順序で実行します。

  1. 公開証明書の取得
  2. 作成 Adobe I/O 統合
  3. IMS アカウント設定の作成
  4. Cloud Service の設定
  5. 設定のテスト
メモ

AEM Assetsのオーサーインスタンスは、1 つのBrand Portalテナントでのみ設定できます。

IMS 設定の作成

IMS 設定は、AEM Assets オーサーインスタンスを使用して Brand Portal テナントを認証します。

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

公開証明書の取得

公開証明書により、でプロファイルを認証できます。 Adobe I/O.

  1. AEM Assetsオーサーインスタンス(デフォルト URL)にログインします。http:// localhost:4502/aem/start.html

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

    Adobe IMS アカウント設定 UI

  3. Adobe IMS 設定ページが開きます。

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

    これにより、 Adobe IMSテクニカルアカウント設定 ページ。

  4. デフォルトでは、「証明書」タブが開きます。

    クラウドソリューション​で「Adobe Brand Portal」を選択します。

  5. チェックボックスをオンにします。 新しい証明書を作成 をクリックし、 エイリアス 証明書用。 ここで入力したエイリアスが、ダイアログ名として表示されます。

  6. 証明書を作成」をクリックします。ダイアログが表示されます。「OK」をクリックして公開証明書を生成します。

    証明書を作成

  7. 公開鍵をダウンロード」をクリックし、AEM-Adobe-IMS.crt 証明書ファイルをローカルマシンに保存します。証明書ファイルは、 作成 Adobe I/O 統合.

    証明書をダウンロード

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

    アカウント」タブで、Adobe IMS アカウントを作成するには、統合環境の詳細が必要です。このページは開いたままにしておきます。

    新しいタブを開き、 作成 Adobe I/O 統合 をクリックして、IMS アカウント設定の統合の詳細を取得します。

作成 Adobe I/O 統合

Adobe I/O 統合環境により、API キー、クライアント秘密鍵、および IMS アカウント設定の設定で必要なペイロード(JWT)が生成されます。

  1. ログイン先 Adobe I/O Brand Portalテナントの IMS 組織に対するシステム管理者権限を持つコンソール。

    デフォルト URL:https://console.adobe.io/

  2. 統合を作成」をクリックします。

  3. API にアクセス」を選択し、「続行」をクリックします。

    新しい統合の作成

  4. 新しい統合を作成ページを開きます。

    ドロップダウンリストからご自身の組織を選択します。

    Experience Cloud で「AEM Brand Portal」を選択し、「続行」をクリックします。

    「Brand Portal」オプションが無効になっている場合は、「アドビのサービス」オプションの上にあるドロップダウンボックスで正しい組織が選択されているかどうかを確認してください。自分がどの組織に属しているかわからない場合は、管理者に問い合わせてください。

    統合の作成

  5. 新しい統合環境の名前と説明を入力します。「お使いのコンピューターからファイルを選択」をクリックし、「公開証明書を取得する」セクションでダウンロードした AEM-Adobe-IMS.crt ファイルをアップロードします。

  6. 組織のプロファイルを選択します。

    または、デフォルトのプロファイル Assets Brand Portal を選択し、「統合を作成」をクリックします。統合環境が作成されます。

  7. 統合の詳細情報に進む」をクリックして、統合環境の詳細情報を表示します。

    API キーのコピー

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

    統合環境の API キー、クライアント秘密鍵、ペイロード情報の表示画面

  8. JWT」タブに移動し、JWT ペイロード​をコピーします。

    API キー、クライアント秘密鍵、JWT ペイロード情報は、IMS アカウント設定の作成に使用されます。

IMS アカウント設定の作成

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

IMS アカウント設定の作成手順:

  1. IMS 設定ページの「アカウント」タブを開きます。(このページは、「公開証明書を取得する」セクションの最後で開いたままにしておいたページです)。

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

    認証サーバー」に次の URL を入力します。https://ims-na1.adobelogin.com/

    コピーした API キー、クライアント秘密鍵、JWT ペイロードをの最後に貼り付けます。 作成 Adobe I/O 統合.

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

    統合環境が作成されます。

    IMS アカウントの設定

  3. 作成した IMS 設定を選択して「ヘルスチェック」をクリックします。ダイアログボックスが表示されます。

    チェック」をクリック。接続が成功すると、トークンが正常に取得された​ことを示すメッセージが表示されます。

注意

IMS 設定は 1 つだけにする必要があります。複数の IMS 設定を作成しないでください。

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

Cloud Service の設定

Brand Portal クラウドサービス設定を作成するには、以下の手順を実行します。

  1. AEM Assetsオーサーインスタンスにログインします。

    デフォルト URL は http://localhost:4502/aem/start.html です。

  2. 送信者 ツール ツール パネル、に移動します。 Cloud Services/AEM Brand Portal.

    Brand Portal 設定ページが開きます。

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

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

    IMS アカウント設定の作成手順で作成した IMS 設定を選択します。

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

  5. 保存して閉じる」をクリックします。クラウド設定が作成されます。これで、AEM AssetsオーサーインスタンスがBrand Portalテナントと統合されました。

設定のテスト

  1. AEM Assetsオーサーインスタンスにログインします。

    デフォルト URL は http://localhost:4502/aem/start.html です。

  2. 送信者 ツール ツール パネル、に移動します。 導入 >> レプリケーション.

  3. レプリケーションページが開きます。

    クリック 作成者のエージェント.

  4. 各テナントに対して 4 つのレプリケーションエージェントが作成されます。

    Brand Portalテナントのレプリケーションエージェントを見つけます。

    レプリケーションエージェントの URL をクリックします。

    メモ

    レプリケーションエージェントは並行して動作し、ジョブの配布を均等に共有するので、公開速度が元の速度の 4 倍に増えます。 クラウドサービスを設定した後は、複数のアセットを並行して公開できるように、デフォルトで有効化されるレプリケーションエージェントを有効にするために追加の設定は必要ありません。

  5. AEM AssetsオーサーとBrand Portalの間の接続を確認するには、 接続をテスト.

  6. テスト結果の一番下を見て、レプリケーションが成功したことを確認します。

  7. 4 つのレプリケーションエージェントすべてで 1 つずつテスト結果を確認します。

    メモ

    どのレプリケーションエージェントも無効にしないでください。一部のアセットのレプリケーションが失敗する可能性があります。

    タイムアウトエラーを避けるために、4 つのレプリケーションエージェントすべてが設定されていることを確認します。 詳しくは、 Brand Portalへの並列公開に関する問題のトラブルシューティング.

Brand PortalがAEM Assetsオーサーインスタンスで正常に設定されました。 次の操作が可能になっています。

設定のアップグレード

既存の設定をアップグレードするには、以下の手順を上記の順序で実行します。

  1. 実行中のジョブの検証
  2. 既存の設定を削除
  3. 設定の作成

実行中のジョブの検証

変更を加える前に、AEM Assetsオーサーインスタンスで公開ジョブが実行されていないことを確認してください。 そのためには、4 つのレプリケーションエージェントをすべて検証し、キューが理想的/空であることを確認できます。

  1. AEM Assetsオーサーインスタンスにログインします。

    デフォルト URL は http://localhost:4502/aem/start.html です。

  2. 送信者 ツール ツール パネル、に移動します。 導入 >> レプリケーション.

  3. レプリケーションページが開きます。

    クリック 作成者のエージェント.

  4. Brand Portalテナントのレプリケーションエージェントを見つけます。

    次を確認します。 キューは待機中です すべてのレプリケーションエージェントに対して、アクティブな公開ジョブはありません。

既存の設定を削除

既存の設定を削除する際は、次のチェックリストを実行する必要があります。

  • 4 つのレプリケーションエージェントをすべて削除
  • クラウドサービスを削除
  • MACユーザーを削除

既存の設定を削除するには、次の手順を実行します。

  1. AEM Assetsオーサーインスタンスにログインし、管理者として CRX Lite を開きます。

    デフォルトの URL:http:// localhost:4502/crx/de/index.jsp

  2. に移動します。 /etc/replications/agents.author Brand Portalテナントの 4 つのレプリケーションエージェントをすべて削除します。

  3. に移動します。 /etc/cloudservices/mediaportal をクリックし、 Cloud Service設定.

  4. に移動します。 /home/users/mac をクリックし、 Macユーザー Brand Portalテナントの

次の操作を実行できます。 設定を作成 (AEM 6.4 オーサーインスタンスの Adobe I/O.

レプリケーションが正常に終了したら、アセット、フォルダー、コレクションを Brand Portal に公開することができます。詳しくは、次を参照してください。

このページ