Integra Wiz con Google SecOps

En este documento, se explica cómo integrar Wiz en Google Security Operations (Google SecOps).

Antes de comenzar

Para usar la integración, necesitas una raíz de API, un ID de cliente y un secreto de cliente.

Para obtener más información sobre cómo generar estas credenciales, consulta Configuración de cuentas de servicio.

Permisos y permisos de acceso obligatorios de la cuenta de servicio

Asegúrate de que a tu cuenta de servicio de Wiz se le otorguen los permisos de API adecuados para las operaciones que quieras ejecutar en Google SecOps.

Operaciones de lectura y consulta

Operación/propósito Usado por Permisos y permisos necesarios
Prueba la conectividad Acción de ping read:issues
Obtén detalles del problema Acción para obtener detalles del problema read:issues
read:posture_issues
read:threat_issues
read:comments
Enumera los hallazgos de vulnerabilidades de recursos Acción para enumerar los hallazgos de vulnerabilidades de recursos read:vulnerabilities
Obtén el análisis de Blue Agent Obtén la acción de análisis del agente azul read:threat_issues

Operaciones de escritura y modificación (mutaciones)

Operación/propósito Usado por Permisos y permisos necesarios
Reabrir problema Acción para volver a abrir un problema write:issue_status
update:posture_issue_status
write:threat_issue_status
Resolver problema Acción para resolver el problema write:threat_issue_status
write:threat_issues
Ignorar problema Acción para ignorar el problema update:posture_issue_ignore
write:issue_ignore
Agrega un comentario al problema Acción Agregar comentario al problema write:issue_comments
write:threat_issue_comments
write:comments

Parámetros de integración

La integración de Wiz requiere los siguientes parámetros:

Parámetro Descripción
API Root

Obligatorio.

Es la URL del extremo de API de GraphQL para tu usuario de Wiz.

El extremo debe seguir el formato https://api.<region>.app.wiz.io/graphql (o https://api.<region>.app.wiz.us/graphql para Wiz for Gov), en el que <region> representa la región del centro de datos de Wiz asignada (como us1, us2, eu1 o eu2).

Consulta los detalles de tu usuario de Wiz para obtener la URL exacta de tu extremo. No uses URLs regionales genéricas sin numerar.

Authentication URL

Es opcional.

Es la URL de autenticación que se usa para generar tokens de acceso de OAuth. Para entornos comerciales, usa https://auth.app.wiz.io. Para los entornos de Wiz for Gov (FedRAMP), usa https://auth.app.wiz.us.

El valor predeterminado es https://auth.app.wiz.io.

Client ID

Obligatorio.

Es el ID de cliente asociado con tus credenciales de la API de Wiz.

Client Secret

Obligatorio.

Es el secreto del cliente asociado a tus credenciales de la API de Wiz.

Verify SSL

Obligatorio.

Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Wiz.

Habilitada 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 Wiz.

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
Es el resultado de la 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 Wiz server with the provided connection parameters!

La acción se realizó correctamente.
Failed to connect to the Wiz 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

Obtén detalles del problema

Usa la acción Obtener detalles del problema para obtener información sobre un problema específico en Wiz.

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

Entradas de acción

La acción Get Issue Details requiere los siguientes parámetros:

Parámetro Descripción
Issue ID

Obligatorio.

Es el identificador único del problema de Wiz que se recuperará o sobre el que se actuará.

Resultados de la acción

La acción Get Issue Details 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 muestra el resultado en JSON que se recibe cuando se usa la acción Obtener detalles del problema:

{
   "id": "f54e3fb9-a520-4e99-aacc-b99f6ae7f28d",
   "createdAt": "2025-07-26T11:47:43.94524Z",
   "updatedAt": "2025-07-31T07:34:54.445702Z",
   "status": "RESOLVED",
   "severity": "CRITICAL",
   "type": "TOXIC_COMBINATION",
   "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc.",
   "resolvedAt": "2025-07-31T07:34:54.445702Z",
   "entitySnapshot": {
       "cloudPlatform": "GCP",
       "id": "1971f945-3476-5b3d-a5a1-ab166c3e2eca",
       "name": "cluster-solr",
       "region": "us-central1",
       "subscriptionName": "Wiz-Labs",
       "type": "KUBERNETES_CLUSTER"
   },
   "projects": [
       {
           "id": "904cbc14-1c52-571c-a6b8-46fee263eb0f",
           "name": "GCP Lab"
       }
   ],
   "sourceRules": [
       {
           "id": "wc-id-1038",
           "name": "Container using an image infected with critical/high severity malware",
           "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc."
       }
   ]
}
Mensajes de salida

La acción Obtener detalles del problema puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully returned details for the following issue using information from Wiz: ISSUE_ID

The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID

La acción se realizó correctamente.
Error executing action "Get Issue Details". Reason: 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 muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener detalles del problema:

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

Volver a abrir el problema

Usa la acción Volver a abrir el problema para volver a abrir un problema específico en Wiz.

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

Entradas de acción

La acción Reabrir problema requiere los siguientes parámetros:

Parámetro Descripción
Issue ID

Obligatorio.

Es el identificador único del problema en Wiz que se recuperará o actualizará.

Resultados de la acción

La acción Reabrir problema 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 muestra el resultado JSON que se recibe cuando se usa la acción Reopen Issue:

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "OPEN",
    "dueAt": null,
    "resolutionReason": null
}
Mensajes de salida

La acción Reopen Issue puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully reopened issue with ID ISSUE_ID en Wiz.

La acción se realizó correctamente.
Error executing action "Reopen Issue". Reason: 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 muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Reabrir problema:

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

Ignorar problema

Usa la acción Ignorar problema para ignorar un problema específico en Wiz.

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

Entradas de acción

La acción Ignorar problema requiere los siguientes parámetros:

Parámetro Descripción
Issue ID

Obligatorio.

Es el identificador único del problema en Wiz.

Resolution Reason

Obligatorio.

Es el motivo de la resolución del problema.

Los valores posibles son los siguientes:

  • False Positive
  • Exception
  • Won't Fix~

El valor predeterminado es False Positive.

Resolution Note

Es opcional.

Es una nota que proporciona contexto adicional para la resolución del problema.

Resultados de la acción

La acción Ignorar problema 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 muestra el resultado JSON que se recibe cuando se usa la acción Ignorar problema:

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "REJECTED",
    "dueAt": null,
    "resolutionReason": "FALSE_POSITIVE"
}
Mensajes de salida

La acción Ignorar problema puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully ignored issue with ID ISSUE_ID en Wiz.

La acción se realizó correctamente.
Error executing action "Ignore Issue". Reason: 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 Ignorar problema:

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

Resolver problema

Usa la acción Resolve Issue para resolver un problema específico en Wiz.

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

Entradas de acción

La acción Resolver problema requiere los siguientes parámetros:

Parámetro Descripción
Issue ID

Obligatorio.

Es el identificador único del problema en Wiz.

Resolution Reason

Obligatorio.

Es el motivo de la resolución del problema.

Los valores posibles son los siguientes:

  • Malicious Threat
  • Not Malicious Threat
  • Security Test Threat
  • Planned Action Threat
  • Inconclusive Threat

El valor predeterminado es Not Malicious Threat.

Resolution Note

Es opcional.

Es una nota que proporciona contexto adicional sobre la resolución.

Resultados de la acción

La acción Resolver problema 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 muestra el resultado JSON que se recibe cuando se usa la acción Resolver problema:

{
    "id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
    "resolutionNote": "",
    "status": "RESOLVED",
    "dueAt": null,
    "resolutionReason": "NOT_MALICIOUS_THREAT"
}
Mensajes de salida

La acción Resolver problema puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully resolved issue with ID ISSUE_ID en Wiz.

La acción se realizó correctamente.
Error executing action "Resolve Issue". Reason: 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 muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Resolver problema:

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

Agregar comentario al error

Usa la acción Agregar comentario al problema para agregar un comentario a un problema especificado en Wiz.

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

Entradas de acción

La acción Add Comment To Issue requiere los siguientes parámetros:

Parámetro Descripción
Issue ID

Obligatorio.

Es el identificador único del problema en Wiz.

Comment

Obligatorio.

Es el texto del comentario que se agregará al problema.

Resultados de la acción

La acción Add Comment To Issue 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 muestra el resultado JSON que se recibe cuando se usa la acción Agregar comentario al problema:

{
  "createdAt": "2025-08-01T11:59:00.843434941Z", "id":
  "6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}
Mensajes de salida

La acción Add Comment To Issue puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully added a comment to the issue with ID ISSUE_ID en Wiz.

La acción se realizó correctamente.
Error executing action "Add Comment To Issue". Reason: 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 muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Agregar comentario al problema:

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

Obtén el análisis del agente azul

Usa la acción Get Blue Agent Analysis para obtener detalles del análisis del agente azul de Wiz para una amenaza específica.

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

Entradas de acción

La acción Get Blue Agent Analysis requiere los siguientes parámetros:

Parámetro Descripción
Threat ID

Obligatorio.

Es el identificador único del ID de amenaza de Wiz.

Resultados de la acción

La acción Get Blue Agent Analysis 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 muestra el resultado JSON que se recibe cuando se usa la acción Obtener análisis del agente azul:

{
  "id": "threat-12345",
  "threatType": "MALWARE_DETECTION",
  "status": "COMPLETED",
  "analysis": {
    "summary": "Blue Agent analysis details",
    "riskScore": "HIGH"
  }
}
Mensajes de salida

La acción Get Blue Agent Analysis puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully retrieved blue agent analysis for threat ID THREAT_ID en Wiz.

La acción se realizó correctamente.
Error executing action "Get Blue Agent Analysis". Reason: 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 muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener análisis del agente azul:

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

Trabajos

Para obtener más información sobre los trabajos, consulta Configura un trabajo nuevo y Programación avanzada.

Trabajo de sincronización bidireccional de Wiz y Google SecOps

Usa el trabajo de sincronización bidireccional de Wiz y Google SecOps para mantener la sincronización continua entre las amenazas de Wiz y los casos de Google SecOps.

Parámetros del trabajo

El trabajo de sincronización bidireccional de Wiz y Google SecOps requiere los siguientes parámetros:

Parámetro Descripción
Environment Name

Obligatorio.

Es el nombre del entorno en el que se sincronizarán los casos.

El valor predeterminado es Default Environment.

Wiz API Root

Obligatorio.

Es el extremo de API de GraphQL de Wiz para tu inquilino.

El extremo debe seguir el formato https://api.<region>.app.wiz.io/graphql (o https://api.<region>.app.wiz.us/graphql para Wiz for Gov), en el que <region> representa la región del centro de datos de Wiz asignada (como us1, us2, eu1 o eu2).

Consulta los detalles de tu usuario de Wiz para obtener la URL exacta de tu extremo. No uses URLs regionales genéricas sin numerar.

El valor predeterminado del marcador de posición es https://api.<region>.app.wiz.io/graphql. Reemplaza <region> por la región del centro de datos de Wiz que se te asignó.

Wiz Authentication URL

Es opcional.

Es la URL de autenticación que se usa para generar tokens de acceso de OAuth. Para entornos comerciales, usa https://auth.app.wiz.io. Para los entornos de Wiz for Gov (FedRAMP), usa https://auth.app.wiz.us.

El valor predeterminado es https://auth.app.wiz.io.

Wiz Client ID

Obligatorio.

ID de cliente de la cuenta de servicio de la API de Wiz.

Wiz Client Secret

Obligatorio.

Secreto del cliente para la cuenta de servicio de la API de Wiz.

Max Hours Backwards

Es opcional.

Es la cantidad de horas antes de la iteración inicial del trabajo para recuperar los casos actualizados (rango: de 1 a 720, valor predeterminado: 24). Este parámetro se aplica a la primera ejecución del trabajo o como resguardo si se restablece la marca de tiempo de la última ejecución.

Verify SSL

Obligatorio.

Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Wiz.

Esta opción se selecciona de forma predeterminada.

Fields to sync

Obligatorio.

Es una lista de elementos separados por comas que determina qué campos se deben sincronizar. Solo se sincronizarán los campos que se indiquen de forma explícita aquí. Los valores posibles son los siguientes: Status, Comments, Product Link, Severity.

El valor predeterminado es Status, Comments, Product Link, Severity.

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