ドキュメントAEM 6.4Assets ガイド

AEM Assets と Brand Portal の連携の設定 configure-integration-64

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Admin
CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

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

NOTE
を介したBrand PortalとのAEM Assetsの設定 Adobe I/O は、AEM 6.4.8.0 以降でサポートされています。
これまで、Brand Portal は、旧来の OAuth ゲートウェイを通じてクラシック UI で設定されていました。このゲートウェイは、JWT トークン交換を使用して認証用の IMS アクセストークンを取得します。
TIP
既存のお客様のみ
既存のレガシー 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 オペレーティングシステムの使用

前提条件 prerequisites

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

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

AEM 6.4 のダウンロードとインストール

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

AEM 6.4 のダウンロードとインストール aemquickstart

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

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

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

説明については、次を参照してください。

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

設定の作成 configure-new-integration-64

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

  1. 公開証明書の取得
  2. 作成 Adobe I/O 統合
  3. IMS アカウント設定の作成
  4. Cloud Service の設定
  5. 設定のテスト
NOTE
AEM Assets オーサーインスタンスは、1 つの Brand Portal テナントとの連携のみ設定する必要があります。

IMS 設定の作成 create-ims-configuration

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

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

公開証明書の取得 public-certificate

公開証明書により、でプロファイルを認証できます。 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 統合 createnewintegration

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 アカウント設定の作成 create-ims-account-configuration

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

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

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

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

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

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

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

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

    IMS アカウントの設定

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

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

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

Cloud Service の設定 configure-the-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テナントと統合されました。

設定のテスト test-integration

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

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

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

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

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

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

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

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

    note note
    NOTE
    レプリケーションエージェントは並行して動作し、ジョブを均等に分配するので、公開の速度が元の速度の 4 倍に向上します。Cloud Service を設定した後、レプリケーションエージェントを有効にするために追加の設定は必要ありません。レプリケーションエージェントはデフォルトでアクティベートされ、複数のアセットを並行して公開できるようになります。

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

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

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

    note note
    NOTE
    いずれのレプリケーションエージェントも無効にしないでください。無効にすると、一部のアセットのレプリケーションが失敗する可能性があります。
    タイムアウトエラーを避けるために、4 つのレプリケーションエージェントすべてが設定されていることを確認します。Brand Portal への並列公開における問題のトラブルシューティングを参照してください。

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

設定のアップグレード upgrade-integration-64

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

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

実行中のジョブの検証 verify-jobs

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

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

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

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

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

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

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

    すべてのレプリケーションエージェントに対して キューが待機中 ​で、アクティブな公開ジョブがないことを確認します。

既存の設定を削除 delete-existing-configuration

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

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

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

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

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

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

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

  4. /home/users/mac に移動して、Brand Portalテナントの Macユーザー ​を削除します。

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

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

recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad