Adobe Experience Cloud Triggers 用の Adobe I/O の設定

注意

OAuth 認証による旧バージョンのトリガー統合を使用している場合は、以下に説明するように Adobe I/O に移行する必要があります。
Adobe I/O へのこうした移行中に、一部の着信トリガーが失われる可能性があることに注意してください。

Campaign の従来の OAuth 認証モードは、2021年10月20日（PT）に廃止されました。ホスト環境では、2022年5月25日（PT）まで延長サポートを受けられます。オンプレミス環境またはハイブリッド環境のお客様は、アドビカスタマーケアに連絡してサポートを 2022年5月​まで延長してください。アドビに OAuth アプリケーションの AppID を伝える必要があります。

前提条件

この統合は、Campaign Classic 20.2.4 以降、19.1.8、Gold Standard 11 リリース​にのみ適用されます。

この実装を開始する前に、以下の点を確認してください。

  • 有効な​組織識別子：組織 ID は、Adobe Experience Cloud 内の一意の識別子で、VisitorID サービスや IMS シングルサインオン（SSO）などに使用されます。詳細情報
  • 組織への​開発者のアクセス。組織のシステム管理者は、単一の製品プロファイルへの開発者の追加​の手順（詳しくはこのページを参照）に従って、トリガーに関連する Adobe Analytics 製品の Analytics - {tenantID} 製品プロファイルに対するアクセス権を開発者に提供する必要があります。

手順 1：Adobe I/O プロジェクトの作成と更新

  1. Adobe I/O にアクセスし、組織の開発者アクセス権を使用してログインします。

    メモ

    正しい組織ポータルにログインしていることを確認します。

  2. 既存の統合クライアント識別子（クライアント ID） をインスタンス設定ファイル（ims/authIMSTAClientId）から抽出します。存在しない属性または空の属性は、クライアント識別子が設定されていないことを示します。

    メモ

    クライアント識別子が空の場合は、Adobe I/O で直接​新しいプロジェクトを作成​できます。

  3. 抽出したクライアント識別子を使用して、既存のプロジェクトを識別します。前の手順で抽出されたものと同じクライアント識別子を持つ既存のプロジェクトを探します。

  4. 「+ プロジェクトに追加」を選択して、「API」を選択します。

  5. API を追加​ウィンドウで、「Adobe Analytics」を選択します。

  6. 認証のタイプとして「Service Account (JWT)」を選択します。

  7. クライアント ID が空の場合は、「キーペアを生成」を選択して、公開鍵と秘密鍵のペアを作成します。

    キーは、デフォルトの有効期限 365 日で自動的にダウンロードされます。 有効期限が切れたら、新しいキーペアを作成し、設定ファイルで統合を更新する必要があります。 オプション 2 を使用すると、有効期限の長い​公開鍵​を手動で作成してアップロードすることを選択できます。

    注意

    再度ダウンロードすることができないので、ダウンロードプロンプトが表示されたら、config.zip ファイルを保存してください。

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

  9. 既存の​製品プロファイル​を選択するか、必要に応じて新しいプロファイルを作成します。 この​製品プロファイル​には権限は必要ありません。 Analytics 製品プロファイル​の詳細については、Adobe Analytics ドキュメントを参照してください。

    次に、「設定済み API を保存」をクリックします。

  10. プロジェクトから Adobe Analytics を選択し、「サービスアカウント (JWT)」下に次の情報をコピーします。

    • クライアント ID
    • クライアント秘密鍵
    • テクニカルアカウント ID
    • 組織 ID

注意

Adobe I/O 証明書は 12 か月後に期限が切れます。毎年新しいキーペアを生成する必要があります。

手順 2：Adobe Campaign へのプロジェクト資格情報の追加

メモ

手順1：Adobe I/O プロジェクトの作成／更新でクライアント識別子が空でなかった場合、この手順は不要です。

秘密鍵は、Base64 UTF-8 形式でエンコードする必要があります。それには、次の手順に従います。

  1. 手順 1：Adobe I/O プロジェクトの作成と更新で生成された秘密鍵を使用します。秘密鍵は、統合の作成に使用したものと同じである必要があります。

  2. base64 ./private.key > private.key.base64 というコマンドを使用して秘密鍵をエンコードします。これにより、base64 コンテンツが新しいファイル private.key.base64 に保存されます。

    メモ

    秘密鍵をコピーして貼り付けるときに、余分な行が自動的に追加される場合があります。 これは、秘密鍵をエンコードする前に忘れずに削除してください。

  3. ファイル private.key.base64 からコンテンツをコピーします。

  4. Adobe Campaign インスタンスがインストールされている各コンテナに SSH 経由でログインし、neolane ユーザーとして次のコマンドを実行して Adobe Campaign にプロジェクト資格情報を追加します。これにより、テクニカルアカウント​資格情報がインスタンス設定ファイルに挿入されます。

    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>

手順 3：パイプラインタグの更新

メモ

手順 1：Adobe I/O プロジェクトの作成／更新でクライアント識別子が空でなかった場合、この手順は不要です。

pipelined タグを更新するには、設定ファイル config-< instance-name >.xml で、以下のように認証タイプを Adobe I/O プロジェクトに更新する必要があります。

<pipelined ... authType="imsJwtToken"  ... />

次に、config -reload を実行し、pipelined を再起動して変更内容を反映させます。

このページ