Permitir ou bloquear o envio de um webhook

Edições que oferecem suporte a 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.

Esse 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. Não é seguro enviar dados por HTTP não criptografado (http://). Use HTTPS (https://).

Para proteger os dados da sua organização, o Workspace Studio inclui várias proteções 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 URLs:nas edições compatíveis, os webhooks só enviam dados para domínios e endpoints especificados na lista de permissões de URLs da sua organização.
  • Aprovação do usuário:por padrão, uma pessoa precisa revisar e confirmar cada etapa do webhook antes que ela seja executada.
  • 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 os 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 selecione DESATIVADO para bloquear as etapas de webhook.
  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 URL

Edições que oferecem suporte a este recurso: Business Plus, Enterprise Standard e Enterprise Plus, Education Standard e Education Plus. Compare sua edição.

É possível 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 URLs compartilhados para o Google Drive, Documentos, Planilhas e Apps Script.

Observação: nas edições que não aceitam listas de permissões 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 que ela seja executada.

Você pode gerenciar as configurações de aprovação do usuário 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 ver esse conteúdo, você precisa ser um superadmin 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. Clique em Filtrar e depois Adicionar um filtro e depois Nome da etapa.
  3. Adicione um filtro usando um dos seguintes valores:
    • Selecione Contém e insira webhook.
    • Selecione É e insira Enviar um webhook.
  4. Revise os parâmetros de evento:
    • URL de solicitação do webhook: o URL de destino chamado pela etapa do webhook. O URL é tratado como dados sensíveis.