Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Integra Wiz con Google SecOps

Questo documento spiega come integrare Wiz con Google Security Operations (Google SecOps).

Prima di iniziare

Per utilizzare l'integrazione, devi disporre di una radice API, un ID client e un client secret.

Per saperne di più su come generare queste credenziali, consulta Impostazioni dei service account.

Ambiti e autorizzazioni dei service account richiesti

Assicurati che al tuo service account Wiz siano concessi gli ambiti di autorizzazione API appropriati per le operazioni che intendi eseguire in Google SecOps.

Operazioni di lettura e query

Operazione/Scopo	Utilizzato da	Autorizzazioni/ambiti obbligatori
Testa la connettività	Azione di ping	`read:issues`
Visualizza i dettagli del problema	Azione Ottieni dettagli del problema	`read:issues` `read:posture_issues` `read:threat_issues` `read:comments`
Elenca i risultati delle vulnerabilità delle risorse	Azione Elenca i risultati delle vulnerabilità delle risorse	`read:vulnerabilities`
Ottieni l'analisi dell'agente blu	Get Blue Agent Analysis Action	`read:threat_issues`

Operazioni di scrittura e modifica (mutazioni)

Operazione/Scopo	Utilizzato da	Autorizzazioni/ambiti obbligatori
Riapri problema	Azione di riapertura del problema	`write:issue_status` `update:posture_issue_status` `write:threat_issue_status`
Risolvi il problema	Azione per risolvere il problema	`write:threat_issue_status` `write:threat_issues`
Ignora problema	Azione Ignora problema	`update:posture_issue_ignore` `write:issue_ignore`
Add Comment To Issue	Azione Aggiungi commento al problema	`write:issue_comments` `write:threat_issue_comments` `write:comments`

Parametri di integrazione

L'integrazione di Wiz richiede i seguenti parametri:

Parametro	Descrizione
`API Root`	Obbligatorio. L'URL dell'endpoint API GraphQL per il tuo tenant Wiz. L'endpoint deve seguire il formato `https://api.<region>.app.wiz.io/graphql` (o `https://api.<region>.app.wiz.us/graphql` per Wiz for Gov), dove `<region>` rappresenta la regione del data center Wiz assegnata (ad esempio `us1`, `us2`, `eu1` o `eu2`). Consulta i dettagli del tuo tenant Wiz per ottenere l'URL esatto dell'endpoint. Non utilizzare URL regionali generici e non numerati.
`Authentication URL`	Facoltativo. L'URL di autenticazione utilizzato per generare i token di accesso OAuth. Per gli ambienti commerciali, utilizza `https://auth.app.wiz.io`. Per gli ambienti Wiz for Gov (FedRAMP), utilizza `https://auth.app.wiz.us`. Il valore predefinito è `https://auth.app.wiz.io`.
`Client ID`	Obbligatorio. L'ID client associato alle tue credenziali API Wiz.
`Client Secret`	Obbligatorio. Il client secret associato alle tue credenziali API Wiz.
`Verify SSL`	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Wiz. Abilitato per impostazione predefinita.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Dindin

Utilizza l'azione Ping per testare la connettività a Wiz.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Non disponibile
Messaggi di output	Disponibile
Risultato dello script.	Disponibile

Messaggi di output

L'azione Ping può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Messaggio di output	Descrizione del messaggio
`Successfully connected to the Wiz server with the provided connection parameters!`	L'azione è andata a buon fine.
`Failed to connect to the Wiz server! Error is ERROR_REASON`	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Successfully connected to the Wiz server with the provided connection parameters!

L'azione è andata a buon fine.

Failed to connect to the Wiz server!
      Error is  ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script	Valore
`is_success`	`True` o `False`

Ottieni i dettagli del problema

Utilizza l'azione Get Issue Details per ottenere informazioni su un problema specificato in Wiz.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Issue Details richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Issue ID`	Obbligatorio. L'identificatore univoco del problema Wiz da recuperare o su cui agire.

Issue ID

Obbligatorio.

L'identificatore univoco del problema Wiz da recuperare o su cui agire.

Output azione

L'azione Get Issue Details fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Get Issue Details:

{
   "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."
       }
   ]
}

Messaggi di output

L'azione Get Issue Details può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Messaggio di output	Descrizione del messaggio
`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`	L'azione è andata a buon fine.
`Error executing action "Get Issue Details". Reason: ERROR_REASON`	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

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

L'azione è andata a buon fine.

Error executing action "Get Issue Details". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera dettagli problema:

Nome del risultato dello script	Valore
`is_success`	`True` o `False`

Riapri problema

Utilizza l'azione Riapri problema per riaprire un problema specificato in Wiz.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Riapri problema richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Issue ID`	Obbligatorio. L'identificatore univoco del problema in Wiz da recuperare o aggiornare.

Issue ID

Obbligatorio.

L'identificatore univoco del problema in Wiz da recuperare o aggiornare.

Output azione

L'azione Riapri problema fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Riapri problema:

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

Messaggi di output

L'azione Riapri problema può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Messaggio di output	Descrizione del messaggio
`Successfully reopened issue with ID ISSUE_ID` in Wiz.	L'azione è andata a buon fine.
`Error executing action "Reopen Issue". Reason: ERROR_REASON`	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Successfully reopened issue with ID ISSUE_ID in Wiz.

L'azione è andata a buon fine.

Error executing action "Reopen Issue". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Riapri problema:

Nome del risultato dello script	Valore
`is_success`	`True` o `False`

Ignora problema

Utilizza l'azione Ignora problema per ignorare un problema specificato in Wiz.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Ignora problema richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Issue ID`	Obbligatorio. L'identificatore univoco del problema in Wiz.
`Resolution Reason`	Obbligatorio. Il motivo della risoluzione del problema. I valori possibili sono: `False Positive` `Exception` `Won't Fix~` Il valore predefinito è `False Positive`.
`Resolution Note`	Facoltativo. Una nota che fornisce un contesto aggiuntivo per la risoluzione del problema.

Issue ID

Obbligatorio.

L'identificatore univoco del problema in Wiz.

Resolution Reason

Obbligatorio.

Il motivo della risoluzione del problema.

I valori possibili sono:

False Positive
Exception
Won't Fix~

Il valore predefinito è False Positive.

Resolution Note

Facoltativo.

Una nota che fornisce un contesto aggiuntivo per la risoluzione del problema.

Output azione

L'azione Ignora problema fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Ignora problema:

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

Messaggi di output

L'azione Ignora problema può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Messaggio di output	Descrizione del messaggio
`Successfully ignored issue with ID ISSUE_ID` in Wiz.	L'azione è andata a buon fine.
`Error executing action "Ignore Issue". Reason: ERROR_REASON`	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Successfully ignored issue with ID ISSUE_ID in Wiz.

L'azione è andata a buon fine.

Error executing action "Ignore Issue". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ignora problema:

Nome del risultato dello script	Valore
`is_success`	`True` o `False`

Risolvi il problema

Utilizza l'azione Risolvi problema per risolvere un problema specificato in Wiz.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Risolvi problema richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Issue ID`	Obbligatorio. L'identificatore univoco del problema in Wiz.
`Resolution Reason`	Obbligatorio. Il motivo della risoluzione del problema. I valori possibili sono: `Malicious Threat` `Not Malicious Threat` `Security Test Threat` `Planned Action Threat` `Inconclusive Threat` Il valore predefinito è `Not Malicious Threat`.
`Resolution Note`	Facoltativo. Una nota che fornisce un contesto aggiuntivo sulla risoluzione.

Issue ID

Obbligatorio.

L'identificatore univoco del problema in Wiz.

Resolution Reason

Obbligatorio.

Il motivo della risoluzione del problema.

I valori possibili sono:

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

Il valore predefinito è Not Malicious Threat.

Resolution Note

Facoltativo.

Una nota che fornisce un contesto aggiuntivo sulla risoluzione.

Output azione

L'azione Risolvi problema fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Risolvi il problema:

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

Messaggi di output

L'azione Risolvi problema può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Messaggio di output	Descrizione del messaggio
`Successfully resolved issue with ID ISSUE_ID` in Wiz.	L'azione è andata a buon fine.
`Error executing action "Resolve Issue". Reason: ERROR_REASON`	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

Successfully resolved issue with ID ISSUE_ID in Wiz.

L'azione è andata a buon fine.

Error executing action "Resolve Issue". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Risolvi il problema:

Nome del risultato dello script	Valore
`is_success`	`True` o `False`

Aggiungi commento al problema

Utilizza l'azione Add Comment To Issue (Aggiungi commento al problema) per aggiungere un commento a un problema specificato in Wiz.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi commento al problema richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Issue ID`	Obbligatorio. L'identificatore univoco del problema in Wiz.
`Comment`	Obbligatorio. Il testo del commento da aggiungere al problema.

Issue ID

Obbligatorio.

L'identificatore univoco del problema in Wiz.

Comment

Obbligatorio.

Il testo del commento da aggiungere al problema.

Output azione

L'azione Aggiungi commento al problema fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi commento al problema:

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

Messaggi di output

L'azione Aggiungi commento al problema può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Messaggio di output	Descrizione del messaggio
`Successfully added a comment to the issue with ID ISSUE_ID` in Wiz.	L'azione è andata a buon fine.
`Error executing action "Add Comment To Issue". Reason: ERROR_REASON`	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

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

L'azione è andata a buon fine.

Error executing action "Add Comment To Issue". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi commento al problema:

Nome del risultato dello script	Valore
`is_success`	`True` o `False`

Ottieni l'analisi dell'agente blu

Utilizza l'azione Get Blue Agent Analysis per ottenere i dettagli dell'analisi dall'agente Wiz Blue per una minaccia specificata.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Blue Agent Analysis richiede i seguenti parametri:

Parametro Descrizione

Parametro	Descrizione
`Threat ID`	Obbligatorio. L'identificatore univoco dell'ID minaccia Wiz.

Threat ID

Obbligatorio.

L'identificatore univoco dell'ID minaccia Wiz.

Output azione

L'azione Get Blue Agent Analysis fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca richieste	Non disponibile
Link alla bacheca casi	Non disponibile
Tabella della bacheca casi	Non disponibile
Tabella di arricchimento	Non disponibile
Risultato JSON	Disponibile
Messaggi di output	Disponibile
Risultato dello script	Disponibile

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Get Blue Agent Analysis:

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

Messaggi di output

L'azione Get Blue Agent Analysis può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Messaggio di output	Descrizione del messaggio
`Successfully retrieved blue agent analysis for threat ID THREAT_ID` in Wiz.	L'azione è andata a buon fine.
`Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON`	L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali.

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

L'azione è andata a buon fine.

Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Get Blue Agent Analysis:

Nome del risultato dello script	Valore
`is_success`	`True` o `False`

Job

Per saperne di più sui job, consulta Configura un nuovo job e Pianificazione avanzata.

Job di sincronizzazione bidirezionale di Wiz e Google SecOps

Utilizza il job di sincronizzazione bidirezionale di Wiz e Google SecOps per mantenere una sincronizzazione continua tra le minacce Wiz e i casi Google SecOps.

Parametri del job

Il job di sincronizzazione bidirezionale di Wiz e Google SecOps richiede i seguenti parametri:

Parametro	Descrizione
`Environment Name`	Obbligatorio. Nome dell'ambiente in cui sincronizzare le richieste. Il valore predefinito è `Default Environment`.
`Wiz API Root`	Obbligatorio. L'endpoint API Wiz GraphQL per il tuo tenant. L'endpoint deve seguire il formato `https://api.<region>.app.wiz.io/graphql` (o `https://api.<region>.app.wiz.us/graphql` per Wiz for Gov), dove `<region>` rappresenta la regione del data center Wiz assegnata (ad esempio `us1`, `us2`, `eu1` o `eu2`). Consulta i dettagli del tuo tenant Wiz per ottenere l'URL esatto dell'endpoint. Non utilizzare URL regionali generici e non numerati. Il valore segnaposto predefinito è `https://api.<region>.app.wiz.io/graphql`. Sostituisci `<region>` con la regione del data center Wiz assegnata.
`Wiz Authentication URL`	Facoltativo. L'URL di autenticazione utilizzato per generare i token di accesso OAuth. Per gli ambienti commerciali, utilizza `https://auth.app.wiz.io`. Per gli ambienti Wiz for Gov (FedRAMP), utilizza `https://auth.app.wiz.us`. Il valore predefinito è `https://auth.app.wiz.io`.
`Wiz Client ID`	Obbligatorio. ID client per il service account dell'API Wiz.
`Wiz Client Secret`	Obbligatorio. Client secret per il service account dell'API Wiz.
`Max Hours Backwards`	Facoltativo. Numero di ore prima dell'iterazione iniziale del job da cui recuperare le richieste aggiornate (intervallo: da 1 a 720, valore predefinito: 24). Questo parametro si applica alla prima esecuzione del job o come riserva se il timestamp dell'ultima esecuzione viene reimpostato.
`Verify SSL`	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Wiz. Questo tipo di annuncio sarà selezionato per impostazione predefinita.
`Fields to sync`	Obbligatorio. Un elenco di elementi separati da virgole che determina quali campi devono essere sincronizzati. Verranno sincronizzati solo i campi elencati esplicitamente qui. I valori possibili sono: `Status`, `Comments`, `Product Link`, `Severity`. Il valore predefinito è `Status, Comments, Product Link, Severity`.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.