クラウドコネクタ拡張機能の概要
Cloud Connector イベント転送拡張機能を使用すると、宛先にデータを送信したり、宛先からデータを取得したりするためのカスタム HTTP リクエストを作成できます。Cloud Connector の拡張機能は、Postman を Adobe Experience Platform Edge ネットワークに配置する場合と似ており、専用の拡張機能を持たないエンドポイントへのデータ送信に使用できます。
このリファレンスは、この拡張機能を使用してルールを作成するときに使用できるオプションに関する情報です。
Cloud Connector 拡張機能のアクションタイプ
この節では、Adobe Experience Platform の Cloud Connector 拡張機能で使用できる「データを送信」アクションタイプについて説明します。
リクエストタイプ
エンドポイントに必要なリクエストのタイプを選択するには、 リクエストタイプドロップダウンで適切なタイプを選択します。
エンドポイント URL
「リクエストタイプ」ドロップダウンメニューの横にあるテキストフィールドに、データを送信するエンドポイントの URL を入力します。
クエリパラメーター、ヘッダー、および本文の設定
各タブ（「クエリのパラメーター」、「ヘッダー」および「本文のデータ要素」）を使用して、特定のエンドポイントに送信するデータを制御します。
クエリのパラメーター
クエリ文字列パラメーターとして送信するキーと値のペアごとにキーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「siteSection」という名前のデータ要素の値をキーまたは値として参照するには、「{{siteSection}}」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。
クエリのパラメーターを追加するには、「さらに追加」を選択してください。
ヘッダー
ヘッダーとして送信するキーと値のペアごとにキーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「pageName」という名前のデータ要素の値をキーまたは値として参照するには、「{{pageName}}」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。
ヘッダーを追加するには、「さらに追加」を選択します。
次の表に、定義済みのヘッダーのリストを示します。これらのヘッダーに制限されることなく、必要に応じて独自のカスタムヘッダーを追加し、必要に応じて使用可能にできます。
Accept-Datetime ヘッダーは、元のリソースの TimeGate に対して発行される HTTP リクエストで伝送され、その値はアクセスを希望する元のリソースの過去の状態の日時を示します。Set-Cookie ヘッダーで以前に送信された、保存済み HTTP Cookie が含まれます。Accept-Transfer-Encoding と呼ぶこともできます）Upgrade ヘッダーフィールドに関連する RFC ドキュメントは、RFC 7230、6.7 項です。この規格では、現在のクライアント、サーバー、転送プロトコル接続で、別のプロトコルにアップグレードまたは変更するためのルールが定められています。例えば、このヘッダーの規格では、クライアントは HTTP 1.1 から HTTP 2.0 に変更できます（サーバーで Upgrade ヘッダーフィールドを確認して実装する場合）。 どちらも、Upgrade ヘッダーフィールドについて指定されている条項に同意する必要はありません。クライアントヘッダーとサーバーヘッダーの両方で使用できます。Upgrade ヘッダーフィールドを指定した場合、送信者は upgrade オプションを指定して Connection ヘッダーフィールドも送信する必要があります。本文（JSON）
リクエストの本文で送信するキーと値のペアごとに、キーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「appSection」という名前のデータ要素の値をキーまたは値として参照するには、「{{appSection}}」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。
キーと値のペアを追加するには、「さらに追加」を選択します。
本文（生）
リクエストの本文で送信するキーと値のペアごとに、キーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「appSection」という名前のデータ要素の値をキーまたは値として参照するには、「{{appSection}}」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。1 つ以上のデータ要素を追加できます。
アドバンス
イベント転送のルール内のアクションは順番に実行されます。 クライアントからの着信イベントにないデータを外部ソースから取得し、この応答を受け取って、同じルール内の後続アクションでデータを変換する、または最終的な宛先に送信する必要がある場合があります。詳細セクションの「リクエスト応答を保存」で、この処理を有効にできます。
エンドポイントからの応答の本文を保存するには、「 リクエストの応答を保存」ボックスをチェックして、テキストフィールドで応答キーを定義します。
応答キーを productDetails として定義した場合は、このデータをデータ要素で参照し、同じルール内の後続のアクションでこのデータ要素を参照します。productDetail を参照するデータ要素を作成するには、タイプ path のデータ要素を作成し、次のパスを入力します。
arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]
arc.ruleStash.adobe-cloud-connector.reponses.productDetails
イベント転送ライブラリへの相互トランスポート層セキュリティ （mTLS） ルールの追加 mtls-rules
mTLS 証明書は、安全な通信におけるサーバーまたはクライアントの ID を証明するデジタル証明書です。 mTLS Service API を使用する場合、これらの証明書は、Adobe Experience Platform イベント転送とのインタラクションを検証し、暗号化するのに役立ちます。 このプロセスは、データを保護するだけでなく、すべての接続が信頼できるパートナーからのものであることを保証します。
Adobe Cloud Connector 拡張機能のインストール install
拡張機能をインストールするには、 イベント転送プロパティを作成するか、代わりに編集する既存のプロパティを選択します。
左側のパネルで 拡張機能 を選択します。 「カタログ」タブで、Adobe Cloud Connector カードを選択し、「インストール」を選択します。
イベント転送ルールの設定 rule
拡張機能をインストールしたら、mTLS を使用するイベント転送ルールを作成し、ライブラリに追加できます。
イベント転送プロパティに新しいイベント転送 ルールを作成します。 ルールの名前を指定し、「アクション」で新しいアクションを追加し、拡張機能を「Adobe Cloud Connector」に設定します。 次に、「アクションタイプ に対して「 取得呼び出しを行う 」を選択 ます。
選択を行うと、mTLS リクエストの方法と宛先を設定するための追加のコントロールが表示されます。 環境でアクティブな証明書の使用を有効にするには、「mTLS で有効にする」を選択し、「変更を保持」を選択してルールを保存します。
これで、新しいルールの準備が整いました。 「ライブラリに保存」を選択したあと、「ビルド」を選択してデプロイします。 mTLS リクエストがアクティブになり、ライブラリで使用できるようになりました。
次の手順
このガイドでは、イベント転送で mTLS ルールを設定する方法について説明しました。 環境用の mTLS の設定について詳しくは、Mutual Transport Layer Security （mTLS） ガイドを参照してください。
Experience Platformのイベント転送機能について詳しくは、 イベント転送の概要を参照してください。