Integra Formularios de Google con Google SecOps
En este documento, se explica cómo integrar los Formularios de Google con Google Security Operations (Google SecOps).
Antes de comenzar
Antes de configurar la integración de Formularios de Google en Google SecOps, asegúrate de que tus entornos de Google Cloud y Google Workspace estén preparados para el acceso a la API y la personificación.
Para que la integración funcione correctamente, se deben alinear tres elementos para administrar los permisos:
Cuenta de servicio: Actúa como puente entre los sistemas.
Usuario delegado: Es la identidad que la cuenta de servicio suplanta para acceder a los datos del formulario.
Permisos: Son los permisos y los roles que definen lo que la identidad puede hacer.
Si el usuario que suplantas ya tiene los permisos administrativos necesarios, no es necesario crear un rol personalizado. Sin embargo, muchas organizaciones prefieren crear un usuario de servicio dedicado con un rol personalizado para cumplir con el principio de privilegio mínimo.
Completa los siguientes pasos de requisitos previos:
- Crea una cuenta de servicio.
- Crea una clave JSON.
- Habilita las APIs necesarias para tu proyecto.
- Opcional: Crea un rol personalizado para la integración.
- Opcional: Asigna el rol personalizado a un usuario.
- Delega la autoridad para todo el dominio a tu cuenta de servicio.
Crea una cuenta de servicio
La cuenta de servicio representa a un usuario no humano que proporciona una forma segura para que la integración se autentique y reciba autorización para acceder a tus datos.
En la consola de Google Cloud , ve a la página Credenciales.
Selecciona add_2Crear credenciales > Cuenta de servicio.
En Detalles de la cuenta de servicio, ingresa un nombre en el campo Nombre de la cuenta de servicio.
Opcional: Edita el ID de la cuenta de servicio.
Haz clic en Listo.
Crea una clave JSON
Google SecOps requiere un archivo de claves JSON para probar la identidad de la cuenta de servicio y establecer una conexión segura.
Selecciona tu cuenta de servicio y ve a Claves.
Haz clic en Agregar clave > Crear clave nueva.
Para el tipo de clave, selecciona JSON y haz clic en Crear. Aparecerá un diálogo Clave privada guardada en tu computadora y se descargará una copia de la clave privada en tu computadora.
Habilita las APIs necesarias para tu proyecto
Debes habilitar las APIs de Google Cloud específicas que permiten que la integración interactúe con Formularios de Google y el directorio de Google Workspace.
En la consola de Google Cloud , ve a APIs y servicios.
Haz clic en addHabilitar las APIs y los servicios.
Habilita las siguientes APIs para tu proyecto:
API del SDK de Admin
API de Formularios de Google
Opcional: Crea un rol personalizado para la integración
Si la cuenta de usuario que usas para la personificación aún no tiene los permisos administrativos necesarios, puedes crear un rol personalizado con privilegios limitados. Para admitir la integración, el usuario necesita privilegios de la API de Admin para lo siguiente:
Unidades organizativas
Usuarios
Grupos
En la Consola del administrador de Google, ve a Cuenta > Roles de administrador.
Selecciona Crear rol nuevo.
Proporciona un nombre para el nuevo rol personalizado y haz clic en Continuar.
En Seleccionar privilegios, busca la sección Privilegios de la API de Admin.
Selecciona las casillas de verificación de Unidades organizativas, Usuarios y Grupos.
Haz clic en Continuar > Crear rol.
Opcional: Asigna el rol personalizado a un usuario
Si creaste un rol personalizado en el paso anterior, ahora debes asignarlo a la dirección de correo electrónico específica que se usa para la suplantación de identidad.
En la Consola del administrador de Google, ve a Directorio > Usuarios.
Selecciona el usuario que deseas usar para la integración (un administrador existente o un usuario dedicado nuevo).
Abre la configuración del usuario y haz clic en Roles y privilegios de administrador > edit Editar.
Selecciona el rol personalizado que creaste y cambia el botón de activación a Asignado.
Haz clic en Guardar.
Delega autoridad en todo el dominio a tu cuenta de servicio
La delegación de todo el dominio permite que tu cuenta de servicio acceda a los datos de todo tu dominio de Google Workspace suplantando la identidad del usuario autorizado.
En la Consola del administrador de Google de tu dominio, ve a Seguridad > Control de acceso y datos > Controles de API.
En el panel Delegación de todo el dominio, selecciona Administrar la delegación de todo el dominio.
Haz clic en Agregar nueva.
En el campo ID de cliente, ingresa el ID de cliente de la cuenta de servicio creada en el primer paso.
En el campo Permisos de OAuth, ingresa la siguiente lista de permisos obligatorios delimitados por comas:
https://mail.google.com/, https://www.googleapis.com/auth/admin.directory.customer.readonly, https://www.googleapis.com/auth/admin.directory.domain.readonly, https://www.googleapis.com/auth/admin.directory.group, https://www.googleapis.com/auth/admin.directory.group.member, https://www.googleapis.com/auth/admin.directory.orgunit, https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly, https://www.googleapis.com/auth/admin.directory.user, https://www.googleapis.com/auth/admin.directory.user.alias, https://www.googleapis.com/auth/apps.groups.settings, https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/forms.body.readonly, https://www.googleapis.com/auth/forms.responses.readonlyHaz clic en Autorizar.
Parámetros de integración
La integración de Formularios de Google requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Delegated Email |
Obligatorio Es una dirección de correo electrónico que se usará para la identidad temporal y el control de acceso. |
Service Account JSON |
Obligatorio Es el contenido del archivo JSON de la clave de la cuenta de servicio. |
Verify SSL |
Obligatorio Si se selecciona, la integración verifica que el certificado SSL para conectarse a Formularios de Google sea válido. Esta opción se selecciona de forma predeterminada. |
Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.
Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.
Acciones
Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.
Ping
Usa la acción Ping para probar la conectividad con Formularios de Google.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
Ninguno
Resultados de la acción
La acción Ping proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Ping puede devolver los siguientes mensajes de resultado:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Successfully connected to the Google Forms server with the
provided connection parameters! |
La acción se realizó correctamente. |
Failed to connect to the Google Forms server! Error is
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Conectores
Para obtener instrucciones detalladas sobre cómo configurar un conector en Google SecOps, consulta Transferir tus datos (conectores).
Formularios de Google: Conector de respuestas
Usa el conector de respuestas de Formularios de Google para extraer respuestas de Formularios de Google.
El conector de respuestas de Formularios de Google requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Product Field Name |
Obligatorio Es el nombre del campo en el que se almacena el nombre del producto. El valor predeterminado es |
Event Field Name |
Obligatorio Es el nombre del campo que se usa para determinar el nombre del evento (subtipo). El valor predeterminado es |
Environment Field Name |
Optional
Es el nombre del campo en el que se almacena el nombre del entorno. Si no se encuentra el campo de entorno, se establece en el entorno predeterminado. El valor predeterminado es |
Environment Regex Pattern |
Optional
Es un patrón de expresión regular que se ejecuta en el valor que se encuentra en el campo
Usa el valor predeterminado Si el patrón de expresión regular es nulo o está vacío, o el valor del entorno es nulo, el resultado final del entorno es el entorno predeterminado. |
Script Timeout (Seconds) |
Obligatorio Es el límite de tiempo de espera en segundos para el proceso de Python que ejecuta la secuencia de comandos actual. El valor predeterminado es 300 segundos. |
Delegated Email |
Obligatorio Es una dirección de correo electrónico que se usará para la identidad temporal y el control de acceso. |
Service Account JSON |
Obligatorio Es el contenido del archivo JSON de la clave de la cuenta de servicio. |
Form IDs To Track |
Obligatorio Es una lista separada por comas de los IDs de Formularios de Google para hacer un seguimiento de las respuestas. Para recuperar el ID único de un formulario, ábrelo en el editor de Formularios
(no en el vínculo de respuesta público) y copia la cadena ubicada entre
|
Alert Severity |
Optional Es un nivel de gravedad que se asigna a todas las alertas que crea el conector en función de la respuesta de Formularios de Google transferida. Los valores posibles son los siguientes:
El valor predeterminado es |
Max Hours Backwards |
Obligatorio Es la cantidad de horas antes de la primera iteración del conector desde la que se recuperarán las respuestas. Este parámetro se aplica a la iteración inicial del conector después de que lo habilitas por primera vez o al valor de resguardo de una marca de tiempo del conector vencida. El valor predeterminado es de 1 hora. |
Max Responses To Fetch |
Obligatorio Es la cantidad máxima de respuestas que se procesarán para cada iteración del conector. La cantidad máxima es 100. |
Disable Overflow |
Optional Si se selecciona, el conector ignora el mecanismo de desbordamiento de Google SecOps durante la creación de alertas. No se selecciona de forma predeterminada. |
Verify SSL |
Obligatorio Si se selecciona, la integración verifica que el certificado SSL para conectarse a Formularios de Google sea válido. No se selecciona de forma predeterminada. |
Proxy Server Address |
Optional Es la dirección del servidor proxy que se usará. |
Proxy Username |
Optional Es el nombre de usuario del proxy con el que se autenticará. |
Proxy Password |
Optional Es la contraseña del proxy con la que se realizará la autenticación. |
Reglas del conector
El conector de respuestas de Formularios de Google admite proxies.
Eventos de conectores
En el siguiente ejemplo, se muestra el resultado JSON de un evento de Google SecOps que generó el conector de respuestas de Formularios de Google:
{
"responseId": "RESPONSE_ID",
"createTime": "2024-09-05T11:43:13.892Z",
"lastSubmittedTime": "2024-09-05T11:43:13.892123Z",
"event_type": "Question",
"questionId": "78099fe3",
"textAnswers": {
"answers": [
{
"value": "Option 1"
}
]
}
}
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.