Een webhook sturen toestaan of blokkeren

Deze functie wordt ondersteund in de volgende versies: Business Starter, Business Standard, Business Plus, Enterprise Standard, Enterprise Plus, Education Fundamentals, Education Standard, Teaching and Learning-add-on en Education Plus. Ondersteunde add-ons voor deze functie: Google AI Pro for Education.

Deze functie is een beperkte preview.

Met webhooks kunnen flows gegevens sturen of krijgen via een externe link of API. Met de webhookstap kunnen mensen verbinding maken met interne en externe bronnen die niet rechtstreeks worden ondersteund door Google Workspace Studio. Mensen moeten wel voorzichtig zijn als ze de gegevens van uw organisatie extern delen. Gegevens sturen via niet-versleutelde HTTP (http://) is niet beveiligd. Gebruik HTTPS (https://).

Workspace Studio bevat meerdere beveiligingsmaatregelen om de gegevens van je organisatie te beschermen:

  • Standaard uit: Webhooks staan uit totdat een beheerder ze expliciet aanzet voor een organisatie-eenheid.
  • Toelatingslijst voor URL's: Voor ondersteunde versies sturen webhooks alleen gegevens naar domeinen en eindpunten die zijn opgegeven in de toelatingslijst voor URL's van je organisatie.
  • Gebruikersgoedkeuring: Standaard moet een persoon elke webhookstap beoordelen en bevestigen voordat deze wordt uitgevoerd.
  • Gebeurtenisgegevens in het logboek: Uitvoeringsverzoeken voor webhooks worden geregistreerd als Workspace Studio-logboekgebeurtenissen.

Stap 1: Zet webhooks aan of uit

Voordat u begint: Als u een afdeling of team wilt instellen voor deze instelling, gaat u naar Een organisatie-eenheid toevoegen.

  1. Ga in de Google Beheerdersconsole naar Menu en dan Apps en dan Google Workspace en dan Workspace Studio.

    Hiervoor is het beheerdersrecht Service-instellingen vereist.

  2. Klik op Webhookinstellingen.
  3. (Optioneel) Als je de instelling wilt toepassen op een afdeling of team, selecteer je aan de zijkant een organisatie-eenheid.
  4. Selecteer AAN om gebruikers in de geselecteerde organisatie-eenheid webhookstappen te laten gebruiken in flows of selecteer UIT om webhookstappen te blokkeren.
  5. Klik op Opslaan. U kunt ook op Overschrijven klikken voor een organisatie-eenheid.

    Als u de overgenomen waarde later wilt herstellen, klikt u op Overnemen.

Stap 2: (Optioneel) Webhooks beperken tot een toelatingslijst met URL's

Deze functie wordt ondersteund in de volgende versies: Business Plus, Enterprise Standard, Enterprise Plus, Education Standard en Education Plus. Versies vergelijken.

U kunt webhookstappen beperken zodat ze alleen gegevens sturen naar of krijgen van specifieke domeinen en URL's op de toelatingslijst. Hiervoor wordt de gedeelde URL-toelatingslijst voor Google Drive, Documenten, Spreadsheets en Apps Script gebruikt.

Opmerking: Voor versies die geen URL-toelatingslijsten ondersteunen, kunnen webhooks verbinding maken met alle geldige URL's als de functie aanstaat.

De toelatingslijst met URL's beheren

  1. Ga in de Google Beheerdersconsole naar Menu en dan Apps en dan Google Workspace en dan Drive en Documenten en dan Functies en apps.

    Hiervoor is het beheerdersrecht Service-instellingen vereist.

  2. Klik op Importeren en ophalen uit URL's
  3. Selecteer Alleen importeren en ophalen uit de volgende URL's toestaan.
  4. Voer de geautoriseerde URL's of domeinen in (bijvoorbeeld https://api.example.com).
  5. Klik op Opslaan.

Gebruikersgoedkeuring voor webhookstappen

Omdat webhookstappen communiceren met externe eindpunten, worden ze behandeld als gevoelige acties. Als een flow een webhookstap gebruikt, vereist Workspace Studio dat de gebruiker die de flow uitvoert of start, de actie beoordeelt en bevestigt voordat deze wordt uitgevoerd.

U kunt de instellingen voor gebruikersgoedkeuring beheren in de Beheerdersconsole. Ga naar Goedkeuring vereisen voor flows met externe gebruikers voor meer informatie.

Webhook-activiteit controleren met logboekgebeurtenissen

U kunt het gebruik van webhooks controleren via de gebeurtenissen in het logboek Workspace Studio in de Beheerdersconsole.

Voordat u begint: Gebeurtenisgegevens in het webhooklogboek bevatten gevoelige content, zoals URL's. Als u deze content wilt bekijken, moet u hoofdbeheerder zijn of moet uw beheerder de instelling Gevoelige content bekijken aanzetten.

  1. Ga in de Google Beheerdersconsole naar Menu en dan Rapportage en dan Controle en onderzoek en dan Gebeurtenissen in het logboek Workspace Studio.

    Hiervoor is het beheerdersrecht Controle- en onderzoekstool vereist.

  2. Klik op Filteren en dan Een filter toevoegen en dan Stapnaam.
  3. Voeg een filter toe met een van de volgende waarden:
    • Selecteer Bevat en voer webhook in.
    • Selecteer Is en voer Een webhook sturen in.
  4. Controleer de gebeurtenisparameters:
    • Webhook-verzoek-URL: De doel-URL die wordt aangeroepen door de webhook-stap. De URL wordt behandeld als gevoelige gegevens.