Webhook の送信を許可またはブロックする

この機能に対応しているエディション: Business Starter、Business Standard、Business Plus、Enterprise Standard、Enterprise Plus、Education Fundamentals、Education Standard、Teaching and Learning アドオン、Education Plus。この機能に対応しているアドオン: Google AI Pro for Education。

この機能は限定プレビュー版です。

Webhook を使用すると、フローで外部リンクまたは API を使用してデータを送受信できます。Webhook ステップを使用すると、Google Workspace Studio で直接サポートされていない内部リソースや外部リソースに接続できます。ただし、組織のデータを外部と共有する場合は注意が必要です。暗号化されていない HTTP（http://）でデータを送信するのは安全ではありません。HTTPS（https://）を使用します。

組織のデータを保護するため、Workspace Studio には複数のセキュリティ保護機能が組み込まれています。

  • デフォルトでオフ: 管理者が組織部門に対して明示的にオンにするまで、Webhook はオフになっています。
  • URL 許可リスト: サポートされているエディションでは、Webhook は組織の URL 許可リストで指定されたドメインとエンドポイントにのみデータを送信します。
  • ユーザーの承認: デフォルトでは、各 Webhook ステップを実行する前に、ユーザーが確認して承認する必要があります。
  • ログイベント データ: Webhook 実行リクエストは、Workspace Studio のログイベントとして記録されます。

ステップ 1: Webhook をオンまたはオフにする

始める前に: この設定に対する部門やチームを設定する必要がある場合は、組織部門を追加するをご覧ください。

  1. Google 管理コンソールで、メニュー アイコン 次に [ アプリ] 次に [Google Workspace] 次に [Workspace Studio] に移動します。

    アクセスするにはサービス設定の管理者権限が必要です。

  2. [Webhook の設定] をクリックします。
  3. （省略可）設定を部門やチームに適用するには、横で組織部門を選択します。
  4. 選択した組織部門のユーザーがフローで Webhook ステップを使用できるようにするには、[オン] を選択します。Webhook ステップをブロックするには、[オフ] を選択します。
  5. [保存] をクリックします。または、組織部門の [オーバーライド] をクリックします。

    後で継承値を復元するには、[継承] をクリックします。

ステップ 2:（省略可）Webhook を URL 許可リストに制限する

この機能に対応しているエディション: Business Plus、Enterprise Standard、Enterprise Plus、Education Standard、Education Plus。エディションの比較。

Webhook ステップを、特定の許可リストに登録されたドメインと URL からのデータの送受信のみに制限できます。これには、Google ドライブ、ドキュメント、スプレッドシート、Apps Script の共有 URL 許可リストが使用されます。

注: URL 許可リストをサポートしていないエディションでは、この機能を有効にすると、Webhook はすべての有効な URL に接続できます。

URL 許可リストを管理する

  1. Google 管理コンソールで、メニュー アイコン 次に [ アプリ] 次に [Google Workspace] 次に [ドライブとドキュメント] 次に [機能とアプリケーション] に移動します。

    アクセスするにはサービス設定の管理者権限が必要です。

  2. [URL からのインポートと取得] をクリックします。
  3. [次の URL からのみインポートと取得を許可します] を選択します。
  4. 承認済みの URL またはドメインを入力します（例: https://api.example.com）。
  5. [保存] をクリックします。

Webhook ステップのユーザー承認

Webhook ステップは外部エンドポイントと通信するため、機密性の高いアクションとして扱われます。フローで Webhook ステップが使用されている場合、Workspace Studio は、フローを実行または開始するユーザーに、実行前にアクションを確認して承認することを求めます。

管理コンソールでユーザーの承認設定を管理できます。詳しくは、外部ユーザーを含むフローの承認を必須にするをご覧ください。

ログイベントで Webhook のアクティビティをモニタリングする

管理コンソールの Workspace Studio ログイベントを使用して、Webhook の使用状況を確認できます。

開始する前に: Webhook ログイベント データには、URL などの機密性の高いコンテンツが含まれます。このコンテンツを表示するには、特権管理者であるか、管理者に[デリケートなコンテンツを表示] の設定をオンにしてもらう必要があります。

  1. Google 管理コンソールで、メニュー アイコン 次に [ レポート] 次に [監査と調査] 次に [Workspace Studio のログイベント] に移動します。

    アクセスするには、監査と調査のツールの管理者権限が必要です。

  2. [フィルタ] 次に [フィルタを追加] 次に [ステップ名] をクリックします。
  3. 次のいずれかの値を使用してフィルタを追加します。
    • [Contains] を選択し、「webhook」と入力します。
    • [次と等しい] を選択し、「Send a webhook」と入力します。
  4. イベント パラメータを確認します。
    • Webhook リクエスト URL: Webhook ステップによって呼び出されるターゲット URL。URL は機密データとして扱われます。