Adobe Target との統合時に使用する IMS 設定

Target Standard API を介して AEM と Adobe Target を統合するには、Adobe IMS(Identity Management System)の設定が必要です。この設定は、Adobe Developer コンソールで行います。

メモ

AEMaaCS には、Adobe Target Standard API のサポートが新しく追加されました。Target Standard API では IMS 認証を使用します。

API の選択は、AEM/Target 統合に使用される認証方法によって決定されます。

前提条件

この手順を開始する前に、以下を実行します。

  • アドビサポートは、次のアカウントをプロビジョニングする必要があります。

    • アドビコンソール
    • Adobe 開発者コンソール
    • Adobe Target と
    • Adobe IMS(Identity Management System)
  • 組織のシステム管理者は、Admin Console を使用して、組織内で必要な開発者を関連する製品プロファイルに追加する必要があります。

    • これにより、Adobe Developer Console 使用して統合を有効にする権限が特定の開発者に付与されます。
    • 詳しくは、開発者の管理を参照してください。

IMS 設定の指定 - 公開鍵の生成

設定の最初の段階は、AEMで IMS 設定を作成し、公開鍵を生成することです。

  1. AEM で、ツール​メニューを開きます。

  2. セキュリティ​セクションで、Adobe IMS 設定​を選択します。

  3. 作成​を選択して、Adobe IMS テクニカルアカウント設定​を開きます。

  4. クラウド設定​の下のドロップダウンを使用して、Adobe Target​を選択します。

  5. 新しい証明書の作成​をアクティブにして、新しいエイリアスを入力します。

  6. 証明書の作成」で確認します。

    証明書を作成

  7. ダウンロード」(または「公開鍵のダウンロード」)を選択してファイルをローカルドライブにダウンロードし、Adobe Target と AEM の統合に向けて IMS を設定する際に使用できるようにします。

    注意

    この設定は、AEM で IMS 設定を完了するときに再び必要になるため、開いたままにしてください。

    証明書をダウンロード

Adobe Target と AEM の統合に向けた IMS の設定

AEM で使用する Adobe Target を組み込んだ Adobe 開発者コンソールプロジェクト(統合)を作成し、必要な権限を割り当てます。

プロジェクトの作成

Adobe 開発者コンソールを開いて、AEM で使用する Adobe Target を組み込んだプロジェクトを作成します。

  1. Adobe Developer Console を開いて、プロジェクトを表示します。

    https://developer.adobe.com/console/projects

  2. 既に作成したプロジェクトが表示されます。新規プロジェクトの作成​を選択 - 場所と使用方法は、以下に依存します。

    • まだプロジェクトがない場合は、 新規プロジェクトを作成が中央の下に表示されます。
      新規プロジェクトの作成 - 最初のプロジェクト
    • 既存のプロジェクトがある場合は、それらがリストされ、 新規プロジェクトの作成が右上に表示されます。
      新規プロジェクトの作成 - 複数のプロジェクト
  3. プロジェクトに追加​を選択し、続いて API を選択します。

    プロジェクトへの追加

  4. Adobe Target を選択し、続いて​次へ​を選択します。

    メモ

    Adobe Target を購読しているが、リストに表示されない場合は、 前提条件を確認する必要があります。

  5. 公開鍵​をアップロードして、完了したら​次へ​をクリックして進みます。

    公開鍵をアップロード

  6. 資格情報を確認して、次へ​をクリックして進みます。

    資格情報を確認

  7. 必要な製品プロファイルを選択して、設定済み API を保存​に進みます。

    メモ

    で表示される製品プロファイルは、次のものがあるかどうかによって異なります。

    • Adobe Target Standard - デフォルトのワークスペース​のみ使用可能です
    • Adobe Target Premium - 以下に示すように、使用可能なすべてのワークスペースが一覧表示されます

    製品プロファイルを選択し設定済み API を保存

  8. 作成が確定します。

統合への権限の割り当て

次に、必要な権限を統合に割り当てる必要があります。

  1. Adobe Admin Console を開きます。

  2. 製品 (上部のツールバー)に移動し、Adobe Target - <your-tenant-id>(左のパネルから)を選択します。

  3. 製品プロファイル​を選択して、表示されるリストから必要なワークスペースを選択します(例:「デフォルトのワークスペース」)。

  4. API 資格情報​を選択して、必要な統合設定を選択します。

  5. 製品の役割​として、オブザーバー​の代わりに​編集者​を選択します。

Adobe Developer Console 統合プロジェクト用に保存された詳細

Adobe 開発者コンソールプロジェクトコンソールで、すべての統合プロジェクトのリストを表示できます。

表示(特定のプロジェクトエントリの右側)を選択して、設定に関する詳細を表示します。次のものが含まれます。

  • プロジェクトの概要
  • Insights
  • 資格情報
    • サービスアカウント(JWT)
      • 資格情報の詳細
      • JWT の生成
  • API
    • 例:Adobe Target

これらの一部は、IMS に基づいて AEM で Adobe Target の統合を完了するために必要になります。

AEM での IMS 設定の完了

AEM に戻り、Target の IMS 統合から必要な値を追加して、IMS 設定を完了できます。

  1. AEM で IMS 設定を開くに戻ります。

  2. 次へ」を選択します。

  3. ここで、Adobe 開発者コンソールのプロジェクト設定から得られる詳細を使用できます。

    • タイトル:テキスト。
    • 認証サーバー:以下の​ペイロード​セクションの aud 行からこれをコピーして貼り付けます。例:以下の例では https://ims-na1.adobelogin.com
    • API キー:これはプロジェクトの「概要」セクションからコピーします
    • クライアントの秘密鍵:これはプロジェクトの「概要」セクションで生成しコピーします
    • ペイロード:これは「JWT を生成」セクションからコピーします

    Adobe IMS テクニカルアカウント設定

  4. 作成」で確認します。

  5. Adobe Target の設定が AEM コンソールに表示されます。

    IMS 設定

IMS 設定の確認

設定が期待どおりに動作していることを確認するには:

  1. 次を開きます。

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    次に例を示します。

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. 設定を選択します。

  3. ツールバーから​ヘルスチェック​を選択し、次に​チェック​を選択します。

    正常性をチェック

  4. 成功した場合は、確認メッセージが表示されます。

Adobe Target との統合の完了

これで、この IMS 設定を使用して Adobe Target との統合を完了できます。

このページ