„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 Daten über einen externen Link oder eine API gesendet oder empfangen werden. Mit dem Webhook-Schritt können Nutzer eine Verbindung zu internen und externen Ressourcen herstellen, die von Google Workspace Studio nicht direkt unterstützt werden. Nutzer müssen jedoch vorsichtig sein, wenn sie Daten Ihrer Organisation extern freigeben.

Workspace Studio bietet mehrere Sicherheitsvorkehrungen zum Schutz der Daten Ihrer Organisation:

  • Standardmäßig deaktiviert:Webhooks sind deaktiviert, bis ein Administrator sie explizit für eine Organisationseinheit aktiviert.
  • URL-Zulassungsliste:In unterstützten Versionen werden Daten über Webhooks nur an Domains und Endpunkte gesendet, 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 das Dreistrich-Menü  und dann Apps und dann Google Workspace und dann Workspace Studio.

    Hierfür ist die Administratorberechtigung „Diensteinstellungen“ erforderlich.

  2. Klicken Sie auf Webhooks-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 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 Zulassungsliste von URLs 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 zugelassenen Domains und URLs 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 eine Verbindung zu allen gültigen URLs herstellen, wenn die Funktion aktiviert ist.

URL-Zulassungsliste verwalten

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

    Hierfür ist die Administratorberechtigung „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.beispiel.de.
  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 überprüfen und bestätigen, bevor sie ausgeführt wird.

Sie können die Einstellungen für die Nutzergenehmigung in der Admin-Konsole verwalten. Weitere Informationen finden Sie unter Genehmigung für Flows mit externen Nutzern erforderlich.

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 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 Dreistrich-Menü  und dann Berichterstellung und dann Audit und Prüfung und dann Workspace Studio-Protokollereignisse.

    Hierfür ist die Administratorberechtigung Prüf- und Untersuchungstool erforderlich.

  2. Nach Schrittname filtern:

    • contains webhook
    • is "Send a webhook"

  3. Ereignisparameter prüfen:

    • Webhook-Anfrage-URL: Die Ziel-URL, die vom Webhook-Schritt aufgerufen wird. Die URL wird als sensible Daten behandelt.