Webhook認証

BasicAuth

BasicAuth Webhookは、HTTPヘッダーフィールド Authorization を使用した基本的なHTTP認証を使用する統合に使用します。認証情報は {username}:{password} のBase64エンコードされた文字列として渡されます。

BasicAuth認証のための以下の構成を使用してください：

OAuth2 (3-legged)

OAuth2 3-legged Webhookは、ユーザー同意の認証フローが必要な統合に使用します。この方法はユーザーをプロバイダーの同意ページにリダイレクトし、認証コードを取得し、それをアクセストークンと交換します。その後、Webhookはそのトークンを使用してユーザーの代わりにリクエストを認証します。

OAuth2メソッドはサーバーサイドアプリケーションのみをサポートします。

OAuth 2.0サービスにWebアプリケーションを登録し、リダイレクトURLを許可するように構成する必要があります： https://my.tealiumiq.com/oauth/webhook/callback.html

OAuth2 (3-legged)認証のための以下の構成を使用してください：

OAuth2 (2-legged)

OAuth2 2-legged Webhookは、ユーザーの関与なしにサーバー間認証に依存する統合に使用します。この方法では、クライアント資格情報（クライアントIDとシークレット）をプロバイダーから直接アクセストークンと交換します。その後、Webhookはそのトークンを使用してシステムへのリクエストを認証します。

OAuth2 (2-legged)認証のための以下の構成を使用してください：

OAuth2 (2-legged) with mTLS

OAuth2 (2-legged) with mTLS Webhookは、相互TLS認証を組み合わせたサーバー間アクセストークンが必要な統合に使用します。クライアントシークレットの代わりに、Tealiumはトークンリクエスト中のTLSハンドシェイク中にエンドポイントにDigiCert発行のクライアント証明書を提示します。

OAuth2 (2-legged) with mTLS認証のための以下の構成を使用してください：

WebhookコネクターのためのOAuth2 (2-legged) with mTLS認証を構成するには：

1. コネクタ構成で、認証タイプとして OAuth2 (2-legged) with mTLS を選択します。
2. 配信リクエストにmTLSを適用するには、2番目のレッグにmTLS暗号化を適用 チェックボックスを選択します。
3. キーアルゴリズム を選択し、生成 をクリックします。
4. 証明書をダウンロード をクリックし、証明書をAPIゲートウェイまたはサーバーの管理者に提供します。
5. プロファイルを保存して公開します。

証明書と秘密キーはプロファイルに保存され、バックアップコピーはありません。証明書を生成した後にプロファイルを保存して公開しない場合、証明書は保存されず、アクセスを回復するためにTealiumサポートに連絡する必要があります。

mTLS

Webhook mTLSコネクタは、特定の顧客のみが利用可能です。開始するには、Tealiumサポート担当者に連絡してください。

OAuth2トークンフローなしで相互TLS認証が必要な統合には、mTLS webhookを使用します。Tealiumは、配信リクエストごとにTLSハンドシェイク中にDigiCertが発行したクライアント証明書を提示します。クライアントID、クライアントシークレット、またはアクセストークンURLは使用されません。

mTLS認証のための以下の構成を使用してください：

• キーアルゴリズム：（必須）キーペアとDigiCertによって署名された公開証明書を生成するアルゴリズムを選択します。
  • 生成されたキーペアと証明書は、配信リクエストごとのTLSハンドシェイク中にクライアント証明書として提示されます。
  • 私有キーはPKCS#1形式（-----BEGIN RSA PRIVATE KEY-----）で保存されます。PKCS#8キー（-----BEGIN PRIVATE KEY-----）はサポートされていません。
• テストエンドポイントURL：（オプション）mTLSハンドシェイクを検証するためにのみ使用されるHTTPSエンドポイント。
  • このフィールドは配信URLではありません。配信URLはアクションごとに構成されます。
  • テスト接続は常に証明書と私有キーの形式と有効期限を検証します。このフィールドを空白のままにすると、テスト接続はmTLSハンドシェイクを実行しません。
  • このエンドポイントからの任意のHTTPレスポンスステータスは、ハンドシェイクが成功したことを確認します。

証明書と私有キーはバックアップコピーなしでプロファイルに保存されます。証明書を生成した後にプロファイルを保存および公開しない場合、証明書は保存されず、アクセスを回復するためにTealiumサポートに連絡する必要があります。

JWT

JWT webhookを使用して、署名されたJSON Webトークンを使用して認証する統合を行います。

JWT認証のための以下の構成を使用してください：

OAuth2のアクセストークン

OAuth2を使用するWebhookリクエストは、リクエストでアクセストークンを提供する必要があります。OAuth2接続によって生成されたトークンは、{{webhook_access_token}}というテンプレート変数によってコネクタから提供され、APIごとに異なる方法で渡されます。次の例では、ヘッダーとしてAuthorization: Bearer TOKEN_HEREで期待されます。

このヘッダーを生成およびマッピングするための以下の手順を使用してください：

1. 次の例を使用してauth_templateというテンプレートを作成します：
   Bearer {{webhook_access_token}}
2. ヘッダーセクションで、このテンプレートをAuthorizationにマッピングします。
   

   

3. 保存をクリックします。
4. 変更を保存して公開します。

HTTPレスポンスクッキー

状態のないAPIと通信するサーバー間環境では、クッキーベースのセッション管理は一般的に推奨されません。そのため、webhookコネクタはクッキーベースのセッションを追跡せず、HTTPレスポンスのSet-Cookieヘッダー値を効果的に無視します。