Permitir ou bloquear o envio de um webhook

Edições compatíveis com este recurso: Business Starter, Business Standard e Business Plus; Enterprise Standard e Enterprise Plus; Education Fundamentals, Education Standard, complemento Teaching and Learning e Education Plus. Complementos compatíveis com esse recurso: Google AI Pro for Education.

Este recurso está em visualização limitada.

Os webhooks permitem que os fluxos enviem ou recebam dados com um link ou uma API externa. A etapa de webhook permite que as pessoas se conectem a recursos internos e externos que não são diretamente compatíveis com o Google Workspace Studio. No entanto, as pessoas precisam ter cuidado ao compartilhar dados da organização externamente.

Para proteger os dados da sua organização, o Workspace Studio inclui várias medidas de segurança:

  • Desativados por padrão:os webhooks ficam desativados até que um administrador os ative explicitamente para uma unidade organizacional.
  • Lista de permissões de URL:nas edições compatíveis, os webhooks só enviam dados para domínios e endpoints especificados na lista de permissões de URL da sua organização.
  • Aprovação do usuário:por padrão, uma pessoa precisa revisar e confirmar cada etapa do webhook antes da execução.
  • Dados de eventos de registro:as solicitações de execução de webhook são registradas como eventos de registro do Workspace Studio.

Etapa 1: ativar ou desativar webhooks

Antes de começar:se você precisar criar um departamento ou equipe para essa configuração, acesse Adicionar uma unidade organizacional.

  1. No Google Admin Console, acesse Menu e depois Apps e depois Google Workspace e depois Workspace Studio.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique em Configurações de webhook.
  3. (Opcional) Para aplicar a configuração a um departamento ou equipe, selecione uma unidade organizacional na lateral.
  4. Selecione ATIVADO para permitir que os usuários na unidade organizacional selecionada usem etapas de webhook em fluxos ou DESATIVADO para bloquear essas etapas.
  5. Clique em Salvar. Também é possível clicar em Substituir em uma unidade organizacional.

    Para restaurar depois o valor herdado, clique em Herdar.

Etapa 2: (opcional) restringir webhooks a uma lista de permissões de URLs

Edições compatíveis com este recurso: Business Plus; Enterprise Standard e Enterprise Plus; Education Standard e Education Plus. Compare sua edição.

Você pode restringir as etapas do webhook para enviar ou receber dados apenas de domínios e URLs específicos na lista de permissões. Isso usa a lista de permissões de URL compartilhada do Google Drive, Documentos, Planilhas e Apps Script.

Observação: nas edições que não são compatíveis com listas de permissão de URL, os webhooks podem se conectar a todos os URLs válidos quando o recurso está ativado.

Gerenciar a lista de permissões de URL

  1. No Google Admin Console, acesse Menu e depois Apps e depois Google Workspace e depois Drive e Documentos e depois Recursos e aplicativos.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique em Importação e busca de URLs.
  3. Selecione Permitir a importação e a busca apenas dos seguintes URLs.
  4. Insira os URLs ou domínios autorizados (por exemplo, https://api.example.com).
  5. Clique em Salvar.

Aprovação do usuário para etapas de webhook

Como as etapas de webhook se comunicam com endpoints externos, elas são tratadas como ações sensíveis. Quando um fluxo usa uma etapa de webhook, o Workspace Studio exige que o usuário que está executando ou iniciando o fluxo revise e confirme a ação antes da execução.

É possível gerenciar as configurações de aprovação de usuários no Admin Console. Para mais detalhes, acesse Exigir aprovação para fluxos que incluem usuários externos.

Monitorar a atividade do webhook com eventos de registro

Você pode analisar o uso de webhooks usando os eventos de registro do Workspace Studio no Admin Console.

Antes de começar: os dados de eventos de registro do webhook incluem conteúdo sensível, como URLs. Para acessar essas informações, você precisa ser um superadministrador ou pedir para o administrador ativar a configuração "Ver conteúdo sensível".

  1. No Google Admin Console, acesse Menu e depois Relatórios e depois Auditoria e investigação e depois Eventos de registro do Workspace Studio.

    Exige o privilégio de administrador Ferramenta de auditoria e investigação.

  2. Filtrar por nome da etapa:

    • contains webhook
    • is "Send a webhook"

  3. Inspecione os parâmetros do evento:

    • URL da solicitação de webhook: o URL de destino chamado pela etapa de webhook. O URL é tratado como dados sensíveis.