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 で直接サポートされていない内部リソースや外部リソースに接続できます。ただし、組織のデータを外部に共有する際は注意が必要です。

組織のデータを保護するため、Workspace Studio には複数のセキュリティ対策が用意されています。

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

ステップ 1: ウェブフックをオンまたはオフにする

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

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

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

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

ステップ 2: （省略可）ウェブフックを 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 の使用状況を確認し、フローの失敗をトラブルシューティングできます。

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

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

  2. イベント名でフィルタ:

    • workflow_execution_success
    • workflow_execution_failure

  3. イベント パラメータを検査します。

    • Webhook リクエスト URL: Webhook ステップで呼び出されるターゲット URL。
    • Webhook レスポンス コード: ターゲット エンドポイントから返された HTTP ステータス コード。例: 200、404、500。