プレメッセージとポストメッセージのウェブフックにおける認証方法の定義

このドキュメントでは、AIアシスタントにおけるメッセージ送信前およびメッセージ送信後のWebhookの認証設定手順について説明します。利用可能な認証方法とその設定方法について説明する。

概要

Webhookを使用すると、外部システムが AIアシスタントと通信できるようになります。認証は、許可されたソースのみがウェブフックをトリガーできることを保証する。このドキュメントでは、Webhook 認証の設定と管理の手順について説明します。

ウェブフック認証を設定する前に

認証なし

これはデフォルト・オプションです。

ベーシック認証

ベアラ認証

APIキー認証

署名入りJWT

OAuth 2.0

Scope文字列を使用する場合は、ターゲット・サーバで定義されている1つ以上の認証スコープを、スペースで区切って指定する必要がある。例えば、write、read+write、email-readなど。

ウェブフックのユーザー名を入力してください。
Webhookサービスのパスワードを入力します。
Webhook認証サービスのクライアントIDを入力します。
Webhookを認証するためのクライアントシークレットを入力します。
トークン URL を入力します。
Refresh トークン URL を入力してください。
オプション： サービスにスコープ文字列が必要な場合は、ターゲットサーバーで定義されているスコープ文字列を入力します。
クライアント認証では、以下のいずれかのオプションを選択する必要があります：
- Basic Authヘッダーとして送信する： 認証情報は HTTP ヘッダーで送られる。
- 本文として送信： 認証クレデンシャルはリクエストボディに送信されます。
ヘッダーのプレフィックスを入力します：ベアラ

Webhook認証サービスのクライアントIDを入力します。
Webhookを認証するためのクライアントシークレットを入力します。
トークン URL を入力します。
Refresh トークン URL を入力してください。
オプション： サービスにスコープ文字列が必要な場合は、ターゲットサーバーで定義されているスコープ文字列を入力します。
クライアント認証では、以下のいずれかのオプションを選択する必要があります：
- Basic Authヘッダーとして送信する： 認証情報は HTTP ヘッダーで送られる。
- 本文として送信： 認証クレデンシャルはリクエストボディに送信されます。
ヘッダーのプレフィックスを入力します：ベアラ

Webhook認証サービスのクライアントIDを入力します。
認証サーバー URL を入力する。
トークン URL を入力します。
Refresh トークン URL を入力してください。
オプション： サービスにスコープ文字列が必要な場合は、ターゲットサーバーで定義されているスコープ文字列を入力します。
クライアント認証では、以下のいずれかのオプションを選択する必要があります：
- Basic Authヘッダーとして送信する： 認証情報は HTTP ヘッダーで送られる。
- 本文として送信： 認証クレデンシャルはリクエストボディに送信されます。
ヘッダーのプレフィックスを入力します：ベアラ
オプション： ターゲットサーバーに応じて、リダイレクトURLを OAuth アプリの「コールバック URL 」フィールドにコピーしてください。
アクセスを許可 」をクリックします。
付与サーバーが提示するページのステップを完了します。
アシスタントにリダイレクトされ、編集モーダルが再度開きます。
クライアントIDの下にクライアントシークレットを入力します。

Webhookのカスタムグラントタイプ名を入力します。
トークン URL を入力します。
Refresh トークン URL を入力してください。
オプション： サービスにスコープ文字列が必要な場合は、ターゲットサーバーで定義されているスコープ文字列を入力します。
クライアント認証では、以下のいずれかのオプションを選択する必要があります：
- Basic Authヘッダーとして送信する： 認証情報は HTTP ヘッダーで送られる。
- 本文として送信： 認証クレデンシャルはリクエストボディに送信されます。
ヘッダーのプレフィックスを入力します：ベアラ

アプリケーションにカスタムシークレットを追加する必要がある場合は、以下の手順に従ってください：