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 ulteriori informazioni su come generare queste credenziali, consulta Impostazioni dei service account.

Ambiti e autorizzazioni 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 richiesti
Test di connettività	Azione Ping	`read:issues`
Visualizzare i dettagli del problema	Azione Ottieni dettagli problema	`read:issues` `read:posture_issues` `read:threat_issues` `read:comments`
Elenca i risultati delle vulnerabilità delle risorse	Azione Elenca risultati di vulnerabilità delle risorse	`read:vulnerabilities`
Ottenere l'analisi dell'agente blu	Ottieni l'azione di analisi dell'agente blu	`read:threat_issues`

Operazioni di scrittura e modifica (mutazioni)

Operazione / Scopo	Utilizzato da	Autorizzazioni / ambiti richiesti
Riapri problema	Azione Riapri problema	`write:issue_status` `update:posture_issue_status` `write:threat_issue_status`
Risolvi il problema	Azione Risolvi problema	`write:threat_issue_status` `write:threat_issues`
Ignora problema	Azione Ignora problema	`update:posture_issue_ignore` `write:issue_ignore`
Aggiungi commento al problema	Aggiungi commento all'azione relativa 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`). Per ottenere l'URL dell'endpoint esatto, consulta i dettagli del tuo tenant Wiz. 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 credenziali API Wiz.
`Client Secret`	Obbligatorio. Il client secret associato alle credenziali API di Wiz.
`Verify SSL`	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server Wiz. Abilitato per impostazione predefinita.

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

Se necessario, potrai 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 ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

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 casi	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 è riuscita.
`Failed to connect to the Wiz server! Error is ERROR_REASON`	L'azione non è riuscita. 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 è riuscita.

Failed to connect to the Wiz server!
      Error is  ERROR_REASON

L'azione non è riuscita.

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 Ping:

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

Ottieni i dettagli del problema

Utilizza l'azione Ottieni dettagli problema per ottenere informazioni su un problema specifico in Wiz.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Recupera dettagli problema richiede i seguenti parametri:

Parametro Descrizione

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

Issue ID

Obbligatorio.

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

Output azione

L'azione Recupera dettagli problema fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 Ottieni dettagli 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."
       }
   ]
}

Messaggi di output

L'azione Ottieni dettagli problema 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 è riuscita.
`Error executing action "Get Issue Details". Reason: ERROR_REASON`	L'azione non è riuscita. 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 è riuscita.

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

L'azione non è riuscita.

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 Ottieni dettagli problema:

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

Riapri problema

Utilizza l'azione Riapri problema per riaprire un problema specifico 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 casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza 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 è riuscita.
`Error executing action "Reopen Issue". Reason: ERROR_REASON`	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Successfully reopened issue with ID ISSUE_ID in Wiz.

L'azione è riuscita.

Error executing action "Reopen Issue". Reason: ERROR_REASON

L'azione non è riuscita.

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 Riapri problema:

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

Ignora problema

Utilizza l'azione Ignora problema per ignorare un problema specifico 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 casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza 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 è riuscita.
`Error executing action "Ignore Issue". Reason: ERROR_REASON`	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Successfully ignored issue with ID ISSUE_ID in Wiz.

L'azione è riuscita.

Error executing action "Ignore Issue". Reason: ERROR_REASON

L'azione non è riuscita.

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 Ignora problema:

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

Risolvi problema

Utilizza l'azione Risolvi problema per risolvere un problema specifico 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 casi	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 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 è riuscita.
`Error executing action "Resolve Issue". Reason: ERROR_REASON`	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Successfully resolved issue with ID ISSUE_ID in Wiz.

L'azione è riuscita.

Error executing action "Resolve Issue". Reason: ERROR_REASON

L'azione non è riuscita.

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 Risolvi problema:

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

Aggiungi commento al problema

Utilizza l'azione Aggiungi commento al problema per aggiungere un commento a un problema specifico 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 casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza 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 è riuscita.
`Error executing action "Add Comment To Issue". Reason: ERROR_REASON`	L'azione non è riuscita. 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 è riuscita.

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

L'azione non è riuscita.

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 Aggiungi commento al problema:

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

Ottenere l'analisi di Blue Agent

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

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Ottieni analisi agente blu richiede i seguenti parametri:

Parametro Descrizione

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

Threat ID

Obbligatorio.

L'identificatore univoco dell'ID minaccia di Wiz.

Output azione

L'azione Ottieni analisi dell'agente blu fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Ottieni analisi dell'agente blu:

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

Messaggi di output

L'azione Ottieni analisi dell'agente blu 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 è riuscita.
`Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON`	L'azione non è riuscita. 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 è riuscita.

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

L'azione non è riuscita.

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 Ottieni analisi dell'agente blu:

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

Job

Per saperne di più sui job, vedi Configurare 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 la sincronizzazione continua tra le minacce di Wiz e le richieste di Google SecOps.

Parametri del job

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

Parametro	Descrizione
`Environment Name`	Obbligatorio. Il nome dell'ambiente in cui sincronizzare le richieste. Il valore predefinito è `Default Environment`.
`Wiz API Root`	Obbligatorio. L'endpoint dell'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`). Per ottenere l'URL dell'endpoint esatto, consulta i dettagli del tuo tenant Wiz. Non utilizzare URL regionali generici e non numerati. Il valore predefinito del segnaposto è `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 API Wiz.
`Wiz Client Secret`	Obbligatorio. Client secret per il service account API Wiz.
`Max Hours Backwards`	Facoltativo. Numero di ore prima dell'iterazione iniziale del job per recuperare i casi aggiornati (intervallo: da 1 a 720, valore predefinito: 24). Questo parametro si applica alla prima esecuzione del job o come fallback se il timestamp dell'ultima esecuzione viene reimpostato.
`Verify SSL`	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server Wiz. Questa opzione è selezionata per impostazione predefinita.
`Fields to sync`	Obbligatorio. Un elenco separato da virgole di elementi che determinano 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.