Permitir o bloquear el envío de un webhook

Ediciones admitidas para esta función: Business Starter, Business Standard y Business Plus; Enterprise Standard y Enterprise Plus; Education Fundamentals, Education Standard, el complemento Teaching and Learning Upgrade y Education Plus. Complementos admitidos para esta función: Google AI Pro for Education.

Esta función está disponible en la versión preliminar limitada.

Los webhooks permiten que los flujos envíen o reciban datos con un vínculo externo o una API. El paso de webhook permite que las personas se conecten a recursos internos y externos que no son compatibles directamente con Google Workspace Studio. Sin embargo, las personas deben tener cuidado al compartir los datos de tu organización de forma externa.

Para proteger los datos de tu organización, Workspace Studio incluye varias medidas de seguridad:

  • Desactivados de forma predeterminada: Los webhooks están desactivados hasta que un administrador los active explícitamente para una unidad organizativa.
  • Lista de URLs permitidas: En las ediciones compatibles, los webhooks solo envían datos a los dominios y extremos especificados en la lista de URLs permitidas de tu organización.
  • Aprobación del usuario: De forma predeterminada, una persona debe revisar y confirmar cada paso de webhook antes de que se ejecute.
  • Registro de auditoría: Las solicitudes de ejecución de webhook y los códigos de estado de respuesta HTTP se registran en los registros de auditoría del administrador.

Paso 1: Activa o desactiva los webhooks

  1. En la Consola del administrador de Google, ve a Menú y luego Apps y luego Google Workspace y luego Workspace Studio.

    Es necesario tener el privilegio de administrador de la configuración del servicio.

  2. Haz clic en Configuración de webhooks.
  3. (Opcional) Para aplicar el parámetro de configuración a un departamento o equipo, en el costado, selecciona una unidad organizativa.
  4. Selecciona ACTIVADO para permitir que los usuarios de la unidad organizativa seleccionada usen pasos de webhook en los flujos o selecciona DESACTIVADO para bloquearlos.
  5. Haz clic en Guardar. También puedes hacer clic en Anular para una unidad organizativa.

    Para restablecer después el valor heredado, haz clic en Heredar.

Paso 2: Restringe los webhooks a una lista de URLs permitidas (opcional)

Ediciones admitidas para esta función: Business Plus, Enterprise Standard y Enterprise Plus, Education Standard y Education Plus. Compara tu edición.

Puedes restringir los pasos de webhook para que solo envíen o reciban datos de dominios y URLs específicos que se encuentren en la lista de entidades permitidas. Esto usa la lista de URLs permitidas compartida para Google Drive, Documentos, Hojas de cálculo y Apps Script.

Nota: En las ediciones que no admiten listas de URLs permitidas, los webhooks pueden conectarse a todas las URLs válidas cuando la función está activada.

Administra la lista de URLs permitidas

  1. En la Consola del administrador de Google, ve a Menú y luego Apps y luego Google Workspace y luego Drive y Documentos y luego Funciones y aplicaciones.

    Es necesario tener el privilegio de administrador de la configuración del servicio.

  2. Haz clic en Importa y recupera a partir de las URLs.
  3. Selecciona Permite importar y recuperar solo a partir de las siguientes URLs.
  4. Ingresa las URLs o los dominios autorizados (por ejemplo, https://api.example.com).
  5. Haz clic en Guardar.

Aprobación del usuario para los pasos de webhook

Dado que los pasos de webhook se comunican con extremos externos, se consideran acciones sensibles. Cuando un flujo usa un paso de webhook, Workspace Studio requiere que el usuario que ejecuta o inicia el flujo revise y confirme la acción antes de que se ejecute.

Puedes administrar la configuración de aprobación del usuario en la Consola del administrador. Para obtener más información, consulta Cómo exigir la aprobación para los flujos que incluyen usuarios externos.

Supervisa la actividad de webhook en los registros de auditoría

Puedes revisar el uso de webhooks y solucionar problemas de fallas de flujo con los eventos de registro de Workspace Studio en la Consola del administrador.

  1. En la Consola del administrador de Google, ve a Menú y luego Informes y luego Auditoría y administración y luego Eventos de registro de Workspace Studio.

    Requiere tener el privilegio de administrador de la herramienta de auditoría y administración.

  2. Filtra por nombre del evento:

    • workflow_execution_success
    • workflow_execution_failure

  3. Inspecciona los parámetros del evento:

    • URL de solicitud de webhook: Es la URL de destino que invoca el paso de webhook.
    • Código de respuesta de webhook: Es el código de estado HTTP que muestra el extremo de destino. Por ejemplo, 200, 404, 500.