API deGoogle Cloud

En este documento, se proporciona orientación para ayudarte a configurar y, también, integrar la API deGoogle Cloud con Google Security Operations.

Casos de uso

La integración de la API de Google Cloud usa las funciones de Google SecOps para admitir los siguientes casos de uso:

  • Administración automatizada de recursos: Ejecuta acciones en los servicios de Google Cloud, como Compute Engine o Cloud Storage, para corregir amenazas o administrar la infraestructura de forma dinámica.

  • Administración de identidades y accesos: Ajusta de manera programática las políticas o los roles de Identity and Access Management en respuesta a los incidentes de seguridad detectados.

  • Organización de APIs personalizada: Interactúa con cualquier API de Google Cloud habilitada que no tenga una integración dedicada, lo que proporciona la máxima flexibilidad para guías complejas.

  • Autenticación sin clave: Accede de forma segura a los recursos de Google Cloud con Workload Identity para eliminar los riesgos asociados con las claves de cuenta de servicio estáticas.

Antes de comenzar

Antes de configurar la integración en la plataforma de Google SecOps, verifica que tengas lo siguiente:

  • APIs de destino habilitadas: Identifica y habilita los servicios deGoogle Cloud específicos que planeas automatizar.

  • Permisos de IAM: Asegúrate de que tu identidad tenga los roles necesarios para las acciones específicas que quieres realizar.

  • Método de autenticación: Elige entre Workload Identity recomendado o una clave JSON de cuenta de servicio para la autenticación.

Identifica y habilita las APIs de destino

Como esta integración es una puerta de enlace genérica, no hay APIs fijas. Los requisitos dependen de tu caso de uso específico. Debes habilitar las APIs de destino (como Compute Engine, Cloud Storage o IAM) en tu proyecto para ejecutarlas a través de la integración.

Usa el siguiente procedimiento para identificar y habilitar las APIs de destino:

  1. En la consola de Google Cloud , ve a APIs y servicios > Biblioteca.

  2. Busca y habilita los servicios necesarios.

Configura los permisos de IAM

La cuenta de servicio o la identidad que usa esta integración debe tener los roles de IAM adecuados.

  • Principio de privilegio mínimo: Otorga solo los roles específicos necesarios para las llamadas a la API previstas.

  • Requisitos dinámicos: Los permisos varían según la operación. Por ejemplo, administrar recursos requiere roles diferentes que enumerarlos.

Seleccionar un método de autenticación

Google SecOps admite dos rutas de autenticación para esta integración:

Autentica con una Workload Identity (recomendado)

Workload Identity es el método más seguro, ya que elimina la necesidad de administrar o rotar claves JSON de larga duración. Utiliza la identidad temporal como cuenta de servicio para permitir que la plataforma acceda de forma segura a tus recursos.

Identifica la identidad de la instancia de Google SecOps

Sigue estos pasos para encontrar la identidad única de tu instancia:

  1. En Google SecOps, ve a Centro de contenido > Integraciones de respuesta.

  2. Selecciona la integración de la API deGoogle Cloud .

  3. Ingresa el correo electrónico de la cuenta de servicio de destino en el campo Correo electrónico de Workload Identity.

  4. Haz clic en Guardar y, luego, en Probar. Se espera que la prueba falle.

  5. Haz clic en close_small a la derecha de Prueba y busca en el mensaje de error el correo electrónico de identidad que comienza con gke-init-python@... o soar-python@....

  6. Copia esta dirección de correo electrónico única.

Otorga permisos de uso de identidad

Autoriza la identidad de la instancia para que acceda a tus recursos completando estos pasos:

  1. En la consola de Google Cloud , ve a IAM y administración > Cuentas de servicio.

    Ir a Cuentas de servicio

  2. Selecciona la cuenta de servicio de destino y ve a Permisos > Otorgar acceso.

  3. Pega la dirección de correo electrónico única en el campo Principales nuevas y asigna el rol de Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator).

Autentica con una clave JSON

Solo usa este método si Workload Identity no está disponible en tu entorno.

Usa el siguiente procedimiento para autenticar la integración con una clave JSON de cuenta de servicio:

  1. En la consola de Google Cloud , crea una cuenta de servicio.

  2. Ve a la pestaña Claves y selecciona Agregar clave > Crear clave nueva.

  3. Selecciona JSON como tipo de clave y descarga el archivo.

  4. Copia todo el contenido de este archivo y pégalo en Service Account Json File Content durante la configuración de la integración en Google SecOps.

Integra la API de Google Cloud con Google SecOps SOAR

La integración requiere los siguientes parámetros:

Parámetros Descripción
Test URL Optional

Es una URL de prueba para validar la autenticación en la API de Google Cloud . Este parámetro usa una solicitud GET.
Service Account Json File Content Optional

Es el contenido del archivo JSON de la clave de la cuenta de servicio.

Puedes configurar este parámetro, el parámetro Workload Identity Email o establecer todos los parámetros de integración anteriores.

Para configurar este parámetro, proporciona el contenido completo del archivo JSON de la clave de la cuenta de servicio que descargaste cuando creaste una cuenta de servicio.

Para obtener más información sobre el uso de cuentas de servicio como método de autenticación, consulta Descripción general de las cuentas de servicio y Identidad temporal como cuenta de servicio.

En esta integración, la autenticación con el archivo JSON de la clave de la cuenta de servicio tiene prioridad sobre el correo electrónico de Workload Identity.
Organization ID Optional

Es el ID de organización que se usará en la integración.

Para recuperar el valor de este parámetro durante la ejecución de la acción, establece el siguiente marcador de posición: {{org_id}}.

Project ID Optional

Es el ID del proyecto que se usará en la integración.

Para recuperar el valor de este parámetro durante la ejecución de la acción, establece el siguiente marcador de posición: {{project_id}}.
Quota Project ID Optional

Es el ID del proyecto de Google Cloud que usas para las APIs de Google Cloud y la facturación. Este parámetro requiere que otorgues el rol Service Usage Consumer a tu cuenta de servicio.

La integración adjunta este valor del parámetro a todas las solicitudes a la API.

Si no estableces un valor para este parámetro, la integración recupera el ID del proyecto de tu cuenta de servicio de Google Cloud .
Workload Identity Email Optional

Es la dirección de correo electrónico del cliente de tu cuenta de servicio.

Puedes configurar este parámetro o el parámetro Service Account Json File Content.

En esta integración, la autenticación con el archivo JSON de la clave de la cuenta de servicio tiene prioridad sobre el correo electrónico de Workload Identity.

Para actuar como cuentas de servicio con Workload Identity, otorga el rol Service Account Token Creator a la identidad de la instancia de Google SecOps en tu cuenta de servicio. Para obtener más detalles sobre Workload Identity y cómo trabajar con ellas, consulta Identidades para cargas de trabajo.
OAuth Scopes Optional

Es una lista separada por comas de los permisos de OAuth que se necesitan para ejecutar las solicitudes a la API de Google Cloud .
Verify SSL Obligatorio

Si se selecciona, la integración verifica que el certificado SSL para conectarse al servicio de Google Cloud 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.

Puedes realizar cambios más adelante si es necesario. 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.

Ejecuta una solicitud HTTP

Usa la acción Ejecutar solicitud HTTP para construir y ejecutar una solicitud a la API de HTTP personalizada en una URL de destino.

Esta acción no se ejecuta en las entidades de Google SecOps.

Comportamiento de la acción

Esta acción admite comportamientos complejos, como el sondeo asíncrono, la construcción dinámica de cargas útiles y la administración de archivos.

Sondeo asíncrono

Cuando se proporciona Expected Response Values, la acción opera en modo asíncrono. En este modo, la acción sondea de forma repetida el extremo de destino para hacer un seguimiento del estado de una respuesta (por ejemplo, esperar a que se complete una tarea de larga duración).

La acción evalúa el cuerpo de la respuesta con las condiciones JSON proporcionadas en el parámetro y continúa la ejecución hasta que se cumplan las condiciones o la acción alcance su tiempo de espera.

Lógica de condición

La acción admite la siguiente lógica para hacer un seguimiento de los estados de respuesta:

  • Coincidencia de un solo campo: La acción espera a que un campo específico alcance un solo valor.

    {
  "state": "finished"
}

  • Varios valores (operador lógico O): La acción detiene la ejecución si un campo coincide con cualquier valor de una lista proporcionada. Esto es útil para detenerse en los estados de "éxito" y "error" para evitar sondeos innecesarios.

    {
  "state": ["finished", "error"]
}

  • Varios campos (lógica AND): La acción espera hasta que todos los campos especificados coincidan con sus respectivos valores de forma simultánea.

    {
  "state": "finished",
  "percentage": "100"
}

  • Lógica combinada: Puedes combinar varias condiciones dentro del objeto JSON.

    {
  "state": ["finished", "error"],
  "percentage": "10"
}
Comportamiento del análisis de JSON

Cuando se evalúan las condiciones, la acción sigue estas reglas:

  • Búsqueda global: La acción busca las claves especificadas en todo el objeto de respuesta JSON. Proporciona el nombre de la clave exactamente como aparece en el JSON sin anteponer nombres de objetos superiores ni usar prefijos (por ejemplo, usa "state", no "data_state" ni "data-state").

  • Varias claves idénticas: Si la respuesta contiene varias claves con el mismo nombre en diferentes niveles de la jerarquía de JSON, el resultado esperado solo se alcanza cuando todos los nombres de claves que coinciden cumplen con el valor esperado idéntico.

    Por ejemplo, para buscar el estado finished en la respuesta JSON y ignorar otros estados, establece todas las claves state en Expected Response Values en finished:

    {
"data": {
  "state": "finished"
  },
  "state": "finished"
}
Construcción de la carga útil del cuerpo

La acción construye el cuerpo de la solicitud según el encabezado Content-Type proporcionado en Headers.

Esta es la entrada Body Payload que se usa para los siguientes ejemplos de construcción:

{
  "Id": "123123",
  "sorting": "asc"
}

  • application/x-www-form-urlencoded: La acción genera la carga útil como Id=123123&sorting=asc.

  • application/json: La acción genera la siguiente carga útil de JSON:

    {
  "Id": "123123",
  "sorting": "asc"
}

  • XML: Si el producto de terceros requiere XML, proporciona una entrada con formato XML directamente en Body Payload:

    <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
<soap:Body>
  <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
    <ubiNum>500</ubiNum>
  </NumberToWords>
</soap:Body>
</soap:Envelope>
Manejo de archivos

La acción admite los siguientes flujos de trabajo para administrar archivos:

  • Descarga de archivos:

    • Para devolver los datos del archivo como parte del resultado JSON en formato base64, selecciona Base64 Output.

    • Para guardar un archivo directamente en el muro del caso como un archivo ZIP, selecciona Save To Case Wall.

  • Sube archivos: Para subir un archivo, conviértelo en una cadena codificada en Base64 y, luego, inclúyelo como parte del valor Body Payload.

    En el siguiente ejemplo, se muestra un archivo de imagen convertido en una cadena codificada en base64:

    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

  • Seguridad: Para los archivos sensibles (como el software malicioso), selecciona Password Protect Zip. Esto encripta automáticamente el archivo ZIP guardado que se creó con Save To Case Wall con la contraseña infected.

Configuración del bloque de la guía

En la siguiente configuración, se muestra cómo usar la acción Ejecutar solicitud HTTP dentro de un bloque de guía. Usa este ejemplo para comprender cómo aplicar marcadores de posición y prefijos de entrada.

Cuando uses entradas de bloque como marcadores de posición, debes incluir el prefijo Input. (por ejemplo, [Input.comment]).

  • Método: PUT

  • Ruta de URL:

    https://{API_URL}/[Input.table_name]/[Input.sys_id]

  • Encabezados:

    {
  "Content-type": "application/json; charset=utf-8",
  "Accept": "application/json",
  "User-Agent": "GoogleSecops"
}

  • Carga útil del cuerpo:

    {
  "work_notes": "[Input.comment]"
}

Entradas de acción

La acción Ejecutar solicitud HTTP requiere los siguientes parámetros:

Parámetro Descripción
Method Optional

Es un método que se usará en la solicitud.

El valor predeterminado es GET.

Los valores posibles son los siguientes:
  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS
URL Path Optional

Es una URL para ejecutar.

El valor predeterminado es https://.
URL Params Optional

Son los parámetros de URL.

La acción usa cualquier valor proporcionado junto con los valores que proporcionaste directamente en el parámetro Ruta de URL.

Este parámetro requiere el formato de objeto JSON como entrada. El valor predeterminado es el siguiente:

{
    "URL Field Name": "URL_FIELD_VALUE"
    }
Headers Optional

Son los encabezados que se usarán en la solicitud HTTP.

Este parámetro requiere el formato de objeto JSON como entrada. El valor predeterminado es el siguiente:

{
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
    "User-Agent" : "GoogleSecOps"
    }
Cookie Optional

Son los parámetros que se usarán en el encabezado Cookie.

Este parámetro reemplaza las cookies proporcionadas en el parámetro Encabezados.

Este parámetro requiere el formato de objeto JSON como entrada. El valor predeterminado es el siguiente:

{
    "Cookie_1": "COOKIE_1_VALUE"
    }
Body Payload
 Optional

Un cuerpo para la solicitud HTTP. La acción construye diferentes cargas útiles según el valor del encabezado Content-Type proporcionado en el parámetro Headers.

Este parámetro requiere el formato de objeto JSON como entrada, excepto cuando un producto de terceros requiere XML o el contenido multipart/form-data. Si envías o subes un archivo con la solicitud a la API, proporciona la versión codificada en Base64 del archivo en el parámetro Carga útil del cuerpo y establece el encabezado en "Content-type": "multipart/form-data".

El valor predeterminado es el siguiente:

{
    "Body Field Name": "BODY_FIELD_VALUE"
    }
Expected Response Values

Es opcional.

Es el objeto JSON que contiene los pares campo-valor que definen el estado requerido del cuerpo de la respuesta.
Save To Case Wall Optional

Si se selecciona, la acción guarda el archivo y lo adjunta al muro de casos. El archivo se archiva con la extensión .zip. El archivo .zip no está protegido con contraseña.

No se selecciona de forma predeterminada.
Password Protect Zip Optional

Si se selecciona, la acción agrega una contraseña al archivo .zip creado con el parámetro Save To Case Wall. La contraseña es la siguiente: infected.

Usa este parámetro cuando trabajes con archivos sospechosos.

Esta opción se selecciona de forma predeterminada.
Follow Redirects Optional

Si se selecciona, la acción sigue los redireccionamientos.

Esta opción se selecciona de forma predeterminada.
Fail on 4xx/5xx Optional

Si se selecciona, la acción falla si el código de estado de la respuesta es un error 4xx o 5xx.

Esta opción se selecciona de forma predeterminada.
Base64 Output Optional

Si se selecciona, la acción convierte la respuesta al formato base64.

Usa este parámetro cuando descargues archivos.

El resultado JSON no puede superar los 15 MB.

No se selecciona de forma predeterminada.
Fields To Return Obligatorio

Son los campos que se devolverán. Los valores posibles son los siguientes:

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding
Request Timeout Obligatorio

Es un período de espera para que el servidor envíe datos antes de que falle la acción.

El valor predeterminado es 120 segundos.

Resultados de la acción

La acción Ejecutar solicitud HTTP 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 Disponible
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Ejecutar solicitud HTTP:

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "item",
                       "description": "Object to which the comment belongs to."
                   },
                   {
                       "name": "author",
                       "description": "User who wrote the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "VALUE",
       "Date": "Fri, 03 Nov 2023 16:14:13 GMT",
       "Server": "Google Frontend",
       "Content-Length": "36084"
   },
   "apparent_encoding": "ascii"
}
Mensajes de salida

La acción Ejecutar solicitud HTTP proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully executed API request.

Successfully executed API request, but the status code {4xx/5xx} was returned. Please check the request or try again later.

 La acción se realizó correctamente.
Failed to execute API request. Error: 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 describen los valores del resultado de la secuencia de comandos cuando se usa la acción Ejecutar solicitud HTTP:

Nombre del resultado de la secuencia de comandos Valor
is_success True o False

Ping

Usa la acción Ping para probar la conectividad a Google Cloud.

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 Disponible
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Ping:

{
"endpoint": "TEST_URL"
}
Mensajes de salida

La acción Ping proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje
Successfully tested connectivity. La acción se realizó correctamente.
Failed to test connectivity.

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 describen los valores 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

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.