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 リリースにのみ適用されます。
この実装を開始する前に、以下の点を確認してください。
Analytics - {tenantID}
製品プロファイルに対するアクセス権を開発者に提供する必要があります。Adobe I/O にアクセスし、組織の開発者アクセス権を使用してログインします。
正しい組織ポータルにログインしていることを確認します。
既存の統合クライアント識別子(クライアント ID) をインスタンス設定ファイル(ims/authIMSTAClientId)から抽出します。存在しない属性または空の属性は、クライアント識別子が設定されていないことを示します。
クライアント識別子が空の場合は、Adobe I/O で直接新しいプロジェクトを作成できます。
抽出したクライアント識別子を使用して、既存のプロジェクトを識別します。前の手順で抽出されたものと同じクライアント識別子を持つ既存のプロジェクトを探します。
「+ プロジェクトに追加」を選択して、「API」を選択します。
API を追加ウィンドウで、「Adobe Analytics」を選択します。
認証のタイプとして「Service Account (JWT)」を選択します。
クライアント ID が空の場合は、「キーペアを生成」を選択して、公開鍵と秘密鍵のペアを作成します。
キーは、デフォルトの有効期限 365 日で自動的にダウンロードされます。 有効期限が切れたら、新しいキーペアを作成し、設定ファイルで統合を更新する必要があります。 オプション 2 を使用すると、有効期限の長い公開鍵を手動で作成してアップロードすることを選択できます。
期限が切れる証明書キーペアを置き換える手順のガイドについては、このページを参照してください。
再度ダウンロードすることができないので、ダウンロードプロンプトが表示されたら、config.zip ファイルを保存してください。
「次へ」をクリックします。
既存の製品プロファイルを選択するか、必要に応じて新しいプロファイルを作成します。 この製品プロファイルには権限は必要ありません。 Analytics 製品プロファイルの詳細については、Adobe Analytics ドキュメントを参照してください。
次に、「設定済み API を保存」をクリックします。
プロジェクトから Adobe Analytics を選択し、「サービスアカウント (JWT)」下に次の情報をコピーします。
Adobe I/O 証明書は 12 か月後に期限が切れます。毎年新しいキーペアを生成する必要があります。
手順1:Adobe I/O プロジェクトの作成/更新でクライアント識別子が空でなかった場合、この手順は不要です。
秘密鍵は、Base64 UTF-8 形式でエンコードする必要があります。それには、次の手順に従います。
手順 1:Adobe I/O プロジェクトの作成と更新で生成された秘密鍵を使用します。秘密鍵は、統合の作成に使用したものと同じである必要があります。
base64 ./private.key > private.key.base64
というコマンドを使用して秘密鍵をエンコードします。これにより、base64 コンテンツが新しいファイル private.key.base64
に保存されます。
秘密鍵をコピーして貼り付けるときに、余分な行が自動的に追加される場合があります。 これは、秘密鍵をエンコードする前に忘れずに削除してください。
ファイル private.key.base64
からコンテンツをコピーします。
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>
手順 1:Adobe I/O プロジェクトの作成/更新でクライアント識別子が空でなかった場合、この手順は不要です。
pipelined タグを更新するには、設定ファイル config-< instance-name >.xml で、以下のように認証タイプを Adobe I/O プロジェクトに更新する必要があります。
<pipelined ... authType="imsJwtToken" ... />
次に、config -reload
を実行し、pipelined を再起動して変更内容を反映させます。