„Webhook senden“ zulassen oder blockieren

Unterstützte Versionen für diese Funktion: Business Starter, Business Standard und Business Plus; Enterprise Standard und Enterprise Plus; Education Fundamentals, Education Standard, Teaching and Learning-Add-on und Education Plus. Unterstützte Add-ons für diese Funktion: Google AI Pro for Education.

Diese Funktion befindet sich in der eingeschränkten Vorschau.

Mit Webhooks können Abläufe Daten über einen externen Link oder eine externe API senden oder empfangen. Mit dem Webhook-Schritt können Nutzer eine Verbindung zu internen und externen Ressourcen herstellen, die nicht direkt von Google Workspace Studio unterstützt werden. Nutzer müssen jedoch vorsichtig sein, wenn sie Daten Ihrer Organisation extern freigeben. Wenn Sie Daten über unverschlüsseltes HTTP (http://) versenden, sind sie nicht geschützt. Verwenden Sie HTTPS (https://).

Zum Schutz der Daten Ihrer Organisation bietet Workspace Studio mehrere Sicherheitsmaßnahmen:

  • Standardmäßig deaktiviert:Webhooks sind deaktiviert, bis ein Administrator sie explizit für eine Organisationseinheit aktiviert.
  • URL-Zulassungsliste:Bei unterstützten Versionen senden Webhooks Daten nur an Domains und Endpunkte, die in der URL-Zulassungsliste Ihrer Organisation angegeben sind.
  • Nutzergenehmigung: Standardmäßig muss eine Person jeden Webhook-Schritt prüfen und bestätigen, bevor er ausgeführt wird.
  • Ereignisdaten protokollieren:Webhook-Ausführungsanfragen werden als Workspace Studio-Protokollereignisse aufgezeichnet.

Schritt 1: Webhooks aktivieren oder deaktivieren

Hinweis:Wenn Sie für diese Einstellung eine Abteilung oder ein Team einrichten möchten, lesen Sie den Hilfeartikel Organisationseinheit hinzufügen.

  1. Öffnen Sie in der Admin-Konsole im Menü  und dann Apps und dann Google Workspace und dann Workspace Studio.

    Hierfür ist die Adminberechtigung „Diensteinstellungen“ erforderlich.

  2. Klicken Sie auf Webhook-Einstellungen.
  3. Optional: Wenn Sie die Einstellung auf eine Abteilung oder ein Team anwenden möchten, wählen Sie an der Seite eine Organisationseinheit aus.
  4. Wählen Sie EIN aus, damit Nutzer in der ausgewählten Organisationseinheit Webhook-Schritte in Abläufen verwenden können, oder wählen Sie AUS aus, um Webhook-Schritte zu blockieren.
  5. Klicken Sie auf Speichern. Alternativ können Sie für eine Organisationseinheit auf Überschreiben klicken.

    Wenn Sie den übernommenen Wert später wiederherstellen möchten, klicken Sie auf Übernehmen.

Schritt 2 (optional): Webhooks auf eine URL-Zulassungsliste beschränken

Unterstützte Versionen für diese Funktion: Business Plus; Enterprise Standard und Enterprise Plus; Education Standard und Education Plus. Versionen vergleichen

Sie können Webhook-Schritte so einschränken, dass nur Daten von bestimmten Domains und URLs auf der Zulassungsliste gesendet oder empfangen werden. Dazu wird die gemeinsame URL-Zulassungsliste für Google Drive, Docs, Sheets und Apps Script verwendet.

Hinweis: Bei Versionen, die keine URL-Zulassungslisten unterstützen, können Webhooks mit allen gültigen URLs verbunden werden, wenn die Funktion aktiviert ist.

URL-Zulassungsliste verwalten

  1. Öffnen Sie in der Admin-Konsole das Menü  und dann Apps und dann Google Workspace und dann Drive und Docs und dann Funktionen und Anwendungen.

    Hierfür ist die Adminberechtigung „Diensteinstellungen“ erforderlich.

  2. Klicken Sie auf Importieren und Abrufen von URLs.
  3. Wählen Sie Importieren und Abrufen nur von den folgenden URLs zulassen aus:
  4. Geben Sie die autorisierten URLs oder Domains ein (z. B. https://api.example.com).
  5. Klicken Sie auf Speichern.

Nutzergenehmigung für Webhook-Schritte

Da Webhook-Schritte mit externen Endpunkten kommunizieren, werden sie als sensible Aktionen behandelt. Wenn ein Flow einen Webhook-Schritt verwendet, muss der Nutzer, der den Flow ausführt oder startet, die Aktion in Workspace Studio prüfen und bestätigen, bevor sie ausgeführt wird.

Sie können die Einstellungen für Nutzergenehmigungen in der Admin-Konsole verwalten. Weitere Informationen finden Sie im Hilfeartikel Genehmigung für Abläufe mit externen Nutzern erforderlich machen.

Webhook-Aktivität mit Protokollereignissen überwachen

Sie können die Webhook-Nutzung anhand der Workspace Studio-Protokollereignisse in der Admin-Konsole überprüfen.

Bevor Sie beginnen:Webhook-Protokollereignisdaten enthalten vertrauliche Inhalte wie URLs. Um diese Inhalte anzusehen, müssen Sie Super Admin sein oder Ihr Administrator muss die Einstellung Vertrauliche Inhalte ansehen aktivieren.

  1. Öffnen Sie in der Admin-Konsole das Menü  und dann Berichterstellung und dann Audit und Prüfung und dann Workspace Studio-Protokollereignisse.

    Hierfür ist die Administratorberechtigung Audit- und Prüftool erforderlich.

  2. Klicken Sie auf Filter und dann Filter hinzufügen und dann Schrittname.
  3. Fügen Sie einen Filter mit einem der folgenden Werte hinzu:
    • Wählen Sie Enthält aus und geben Sie dann webhook ein.
    • Wählen Sie Ist aus und geben Sie dann Webhook senden ein.
  4. Prüfen Sie die Ereignisparameter:
    • Webhook-Anfrage-URL: Die Ziel-URL, die vom Webhook-Schritt aufgerufen wird. Die URL wird als sensible Daten behandelt.