BasicAuthとOAuth2
この記事では、BasicAuth、OAuth2(2-legged)、OAuth2(3-legged)認証、またはJWTを使用してWebhookコネクタを構成する方法について説明します。
BasicAuthの構成
このWebhookは、HTTPヘッダーフィールドAuthorizationを使用して基本的なHTTP認証をサポートしています。認証情報は{username}:{password}
のBase64エンコードされた文字列として渡されます。
BasicAuth Webhook構成のための以下の構成を使用してください:
構成 | 説明 |
---|---|
名前 | 必須。Webhookの説明的なタイトルを入力してください。 |
BasicAuth ユーザー名 | Webhookの認証用ユーザー名を入力してください。 |
BasicAuth パスワード | Webhookの認証用パスワードを入力してください。 |
次へをクリックするか、アクションタブに進んでください。アクションタブを使用してHTTPリクエストのトリガーを構成します。
OAuth2(3-legged)の構成
WebhookのOAuth実装はサーバーサイドアプリケーションのみをサポートしています。
OAuth 2.0サービスにWebアプリケーションを登録することが必要です。アプリケーションはリダイレクトURLを許可するように構成されている必要があります:https://my.tealiumiq.com/oauth/webhook/callback.html
OAuth2(3-legged)Webhook構成のための以下の構成を使用してください:
構成 | 説明 |
---|---|
名前 | 必須。Webhookの説明的なタイトルを入力してください。 |
クライアントID | 必須。OAuthサービスから割り当てられたアプリケーションのクライアント識別子を入力してください。 |
クライアントシークレット | 必須。OAuthサービスから割り当てられたアプリケーションのクライアントシークレットを入力してください。 |
スコープ | アプリケーションへのアクセス許可のタイプを選択してください。 |
認証URL | 必須。ユーザーを認証後にリダイレクトするURLを入力してください。 |
認証URLクエリパラメータ | 認証URLのための1つ以上の名前-値ペアを選択してください。複数のペアをアンパサンド(& )で区切ってください。アンパサンド(& )を先頭に使用しないでください。正しい例: access_type=offline&prompt=consent 誤った例: &access_type=offline&prompt=consent |
アクセストークンURL | 必須。リフレッシュトークンを取得するためのトークンURLを入力してください。 |
認証トークンの位置 | 認証トークンを配置する場所を指定してください。 |
認証ヘッダープレフィックス | デフォルト値はBearer です。新しい値を指定して上書きする(一部のOAuth2サービスで必要)。 |
OAuth2(2-legged)の構成
TealiumのWebhook OAuth2コネクタは、OAuth2 Two-Legged認証を必要とするAPIに完全にカスタマイズされたデータをHTTPリクエストとして送信することを可能にします。これはクライアント資格情報とリソースオーナーパスワード資格情報の付与をサポートしています。
コネクタを追加した後、OAuth2 2-Legged Webhook構成のための以下の構成を使用してください:
構成 | 説明 |
---|---|
名前 | 必須。Webhookの説明的なタイトルを入力してください。 |
アクセストークンURL | 必須。アクセストークンを要求するAPIエンドポイントURLを入力してください。 |
クライアントID | 必須。WebアプリケーションのクライアントIDを入力してください。 |
クライアントシークレット | 必須。Webアプリケーションのクライアントシークレットを入力してください。 |
ユーザー名 | ユーザー名を入力してください。パスワードグラントタイプを使用する場合は必須です。 |
パスワード | パスワードを入力してください。パスワードグラントタイプを使用する場合は必須です。 |
クライアント認証ID | 認証ヘッダーとして送信するクライアントID。 |
クライアント認証シークレット | 認証ヘッダーとして送信するクライアントシークレット。 |
スコープ | 要求する権限の範囲を選択してください(一部のOAuth2サービスで必要)。 |
追加の認証パラメータ | 追加の認証パラメータを追加してください(一部のOAuth2サービスで必要)。複数のパラメータを& で区切ってください。 |
認証URL | 必須。認証コードを要求するAPIエンドポイントURLを入力してください。 |
認証トークンの位置 | 認証トークンを配置する場所を指定してください。 |
認証ヘッダープレフィックス | デフォルト値はBearer です。新しい値を指定して上書きする(一部のOAuth2サービスで必要)。 |
JWTの構成
このWebhookはJSON Web Token(JWT)を使用した認証をサポートしています。
Webhook(JWT)構成のための以下の構成を使用してください:
構成 | 説明 |
---|---|
名前 | 必須。Webhookの説明的なタイトルを入力してください。 |
JWTトークン | JSON Web Tokenを入力してください。 |
OAuth2のアクセストークン
Webhook OAuth2を使用するリクエストは、リクエストにアクセストークンを含める必要があります。OAuth2接続によって生成されたトークンは、{{webhook_access_token}}
というテンプレート変数によって提供され、各API間で異なる方法で渡されます。次の例では、Authorization: Bearer TOKEN_HERE
“Authorization"ヘッダーで期待されます。
このヘッダーを生成してマッピングするための以下の手順を使用してください:
- 次の例を使用して
auth_template
というテンプレートを作成します:
Bearer {{webhook_access_token}}
- ヘッダーセクションで、このテンプレートをAuthorizationにマッピングします。
- 保存をクリックします。
- 変更を保存して公開します。
すべてのWebhookアクションのアクションパラメータ
すべてのWebhookアクションに利用可能な以下のパラメータがあります。
パラメータ | 説明 |
---|---|
方法 | 必須* 次の方法をサポートします: * GET * POST * PUT * DELETE * PATCH |
URL* | 必須。リクエストを送信するURLを提供してください。 |
URLパラメータ* | Mapドロップダウンリストから、送信したい属性の値を選択します。Toフィールドに構成するURLパラメータの名前を入力します。 |
ヘッダー* | オプションでWebhook (BasicAuth) Webhook OAuth2に必要です。Mapドロップダウンリストから、送信したい属性の値を選択します。Toフィールドに値を受け取るヘッダー名を入力します。 |
クッキー* | Mapドロップダウンリストから、送信したい属性の値を選択します。Toフィールドに値を受け取るクッキー名を入力します。 |
ボディコンテンツタイプ | Content-Type ヘッダーを指定します。すべてのタイプはUTF-8文字セットを使用します。GET方法の場合はこの構成を無視します。 |
ボディデータ* | HTTPリクエストを介してカスタマイズされたデータを送信アクションのみサポートします。GET方法の場合はこの構成を無視します。ボディコンテンツタイプがapplication/x-www-form-urlencoded の場合は名前/値ペアを提供します。より複雑なペイロードの場合はテンプレート名を提供します。 |
バッチングオプション* | 記録数の最大値は10から10,000の間です。有効期間は5分から60分の間です。 |
テンプレート変数 | 詳細については、Template Variables Guideを参照してください。 |
テンプレート | 詳細については、Trimou Templates Guideを参照してください。各テンプレートには一意の名前が必要です。サポートされている任意のフィールドにテンプレートを注入するには、その名前を二重中括弧で囲んで参照します。テンプレートはURL、URLパラメータ、ヘッダー、クッキー、またはボディデータフィールドに注入できます。 |
バッチングオプション | 記録数の最大値は10から10,000の間です。有効期間は5分から60分の間です。 |
* ダブルカーリーブレースで囲まれたカスタムテンプレートの名前を入力することでフィールド値を入力できます。たとえば、テンプレートがsome-template
という名前の場合、レンダリングされたコンテンツはその名前を参照することでフィールドに注入できます。
最終更新日 :: 2025年May月22日