Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Intégrer Wiz à Google SecOps

Ce document explique comment intégrer Wiz à Google Security Operations (Google SecOps).

Avant de commencer

Pour utiliser l'intégration, vous avez besoin d'une racine d'API, d'un ID client et d'un code secret du client.

Pour en savoir plus sur la génération de ces identifiants, consultez Paramètres des comptes de service.

Autorisations et champs d'application requis pour le compte de service

Assurez-vous que votre compte de service Wiz dispose des niveaux d'autorisation d'API appropriés pour les opérations que vous souhaitez exécuter dans Google SecOps.

Opérations de lecture et de requête

Opération/Objectif	Utilisé par	Autorisations/Champs d'application requis
Tester la connectivité	Action de ping	`read:issues`
Obtenir les détails du problème	Action "Obtenir les détails du problème"	`read:issues` `read:posture_issues` `read:threat_issues` `read:comments`
Répertorier les résultats de vulnérabilité des ressources	Action "Lister les failles détectées dans les ressources"	`read:vulnerabilities`
Obtenir l'analyse de l'agent bleu	Obtenir l'action d'analyse de l'agent bleu	`read:threat_issues`

Opérations d'écriture et de modification (mutations)

Opération/Objectif	Utilisé par	Autorisations/Champs d'application requis
Rouvrir le problème	Action de réouverture de problème	`write:issue_status` `update:posture_issue_status` `write:threat_issue_status`
Résoudre le problème	Action de résolution du problème	`write:threat_issue_status` `write:threat_issues`
Ignorer le problème	Action "Ignorer le problème"	`update:posture_issue_ignore` `write:issue_ignore`
Ajouter un commentaire au problème	Action "Ajouter un commentaire au problème"	`write:issue_comments` `write:threat_issue_comments` `write:comments`

Paramètres d'intégration

L'intégration Wiz nécessite les paramètres suivants :

Paramètre	Description
`API Root`	Obligatoire. URL du point de terminaison de l'API GraphQL pour votre locataire Wiz. Le point de terminaison doit respecter le format `https://api.<region>.app.wiz.io/graphql` (ou `https://api.<region>.app.wiz.us/graphql` pour Wiz for Gov), où `<region>` représente la région du centre de données Wiz qui vous a été attribuée (par exemple, `us1`, `us2`, `eu1` ou `eu2`). Reportez-vous aux détails de votre locataire Wiz pour obtenir l'URL exacte de votre point de terminaison. N'utilisez pas d'URL régionales génériques non numérotées.
`Authentication URL`	Facultatif. URL d'authentification utilisée pour générer des jetons d'accès OAuth. Pour les environnements commerciaux, utilisez `https://auth.app.wiz.io`. Pour les environnements Wiz for Gov (FedRAMP), utilisez `https://auth.app.wiz.us`. La valeur par défaut est `https://auth.app.wiz.io`.
`Client ID`	Obligatoire. ID client associé à vos identifiants de l'API Wiz.
`Client Secret`	Obligatoire. Le code secret du client associé à vos identifiants de l'API Wiz.
`Verify SSL`	Obligatoire. Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Wiz. Cette option est activée par défaut.

Pour savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.

Ping

Utilisez l'action Ping pour tester la connectivité à Wiz.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

Aucune.

Sorties de l'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Non disponible
Messages de sortie	Disponible
Résultat du script.	Disponible

Messages de sortie

L'action Ping peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Message de sortie	Description du message
`Successfully connected to the Wiz server with the provided connection parameters!`	L'action a réussi.
`Failed to connect to the Wiz server! Error is ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

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

L'action a réussi.

Failed to connect to the Wiz server!
      Error is  ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ping :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Obtenir les détails du problème

Utilisez l'action Obtenir les détails du problème pour obtenir des informations sur un problème spécifié dans Wiz.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Obtenir les détails du problème nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`Issue ID`	Obligatoire. Identifiant unique du problème Wiz à récupérer ou sur lequel agir.

Issue ID

Obligatoire.

Identifiant unique du problème Wiz à récupérer ou sur lequel agir.

Sorties de l'action

L'action Obtenir les détails du problème fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Get Issue Details (Obtenir les détails du problème) :

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

Messages de sortie

L'action Obtenir les détails du problème peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Message de sortie	Description du message
`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'action a réussi.
`Error executing action "Get Issue Details". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

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'action a réussi.

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

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Get Issue Details (Obtenir les détails du problème) :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Rouvrir le problème

Utilisez l'action Rouvrir le problème pour rouvrir un problème spécifié dans Wiz.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Rouvrir le problème nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`Issue ID`	Obligatoire. Identifiant unique du problème dans Wiz à récupérer ou à mettre à jour.

Issue ID

Obligatoire.

Identifiant unique du problème dans Wiz à récupérer ou à mettre à jour.

Sorties de l'action

L'action Rouvrir le problème fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Rouvrir le problème :

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

Messages de sortie

L'action Rouvrir le problème peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Message de sortie	Description du message
`Successfully reopened issue with ID ISSUE_ID` dans Wiz.	L'action a réussi.
`Error executing action "Reopen Issue". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Successfully reopened issue with ID ISSUE_ID dans Wiz.

L'action a réussi.

Error executing action "Reopen Issue". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Rouvrir le problème :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Ignorer le problème

Utilisez l'action Ignorer le problème pour ignorer un problème spécifié dans Wiz.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ignorer le problème nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`Issue ID`	Obligatoire. Identifiant unique du problème dans Wiz.
`Resolution Reason`	Obligatoire. Raison de la résolution du problème. Les valeurs possibles sont les suivantes : `False Positive` `Exception` `Won't Fix~` La valeur par défaut est `False Positive`.
`Resolution Note`	Facultatif. Note fournissant un contexte supplémentaire pour la résolution du problème.

Issue ID

Obligatoire.

Identifiant unique du problème dans Wiz.

Resolution Reason

Obligatoire.

Raison de la résolution du problème.

Les valeurs possibles sont les suivantes :

False Positive
Exception
Won't Fix~

La valeur par défaut est False Positive.

Resolution Note

Facultatif.

Note fournissant un contexte supplémentaire pour la résolution du problème.

Sorties de l'action

L'action Ignorer le problème fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Ignorer le problème :

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

Messages de sortie

L'action Ignorer le problème peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Message de sortie	Description du message
`Successfully ignored issue with ID ISSUE_ID` dans Wiz.	L'action a réussi.
`Error executing action "Ignore Issue". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Successfully ignored issue with ID ISSUE_ID dans Wiz.

L'action a réussi.

Error executing action "Ignore Issue". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ignorer le problème :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Résoudre le problème

Utilisez l'action Résoudre le problème pour résoudre un problème spécifié dans Wiz.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Résoudre le problème nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`Issue ID`	Obligatoire. Identifiant unique du problème dans Wiz.
`Resolution Reason`	Obligatoire. Raison de la résolution du problème. Les valeurs possibles sont les suivantes : `Malicious Threat` `Not Malicious Threat` `Security Test Threat` `Planned Action Threat` `Inconclusive Threat` La valeur par défaut est `Not Malicious Threat`.
`Resolution Note`	Facultatif. Note fournissant un contexte supplémentaire sur la résolution.

Issue ID

Obligatoire.

Identifiant unique du problème dans Wiz.

Resolution Reason

Obligatoire.

Raison de la résolution du problème.

Les valeurs possibles sont les suivantes :

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

La valeur par défaut est Not Malicious Threat.

Resolution Note

Facultatif.

Note fournissant un contexte supplémentaire sur la résolution.

Sorties de l'action

L'action Résoudre le problème fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Résoudre le problème :

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

Messages de sortie

L'action Résoudre le problème peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Message de sortie	Description du message
`Successfully resolved issue with ID ISSUE_ID` dans Wiz.	L'action a réussi.
`Error executing action "Resolve Issue". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Successfully resolved issue with ID ISSUE_ID dans Wiz.

L'action a réussi.

Error executing action "Resolve Issue". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Résoudre le problème :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Ajouter un commentaire au problème

Utilisez l'action Ajouter un commentaire au problème pour ajouter un commentaire à un problème spécifié dans Wiz.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ajouter un commentaire au problème nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`Issue ID`	Obligatoire. Identifiant unique du problème dans Wiz.
`Comment`	Obligatoire. Texte du commentaire à ajouter au problème.

Issue ID

Obligatoire.

Identifiant unique du problème dans Wiz.

Comment

Obligatoire.

Texte du commentaire à ajouter au problème.

Sorties de l'action

L'action Ajouter un commentaire à un problème fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Ajouter un commentaire au problème :

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

Messages de sortie

L'action Ajouter un commentaire au problème peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Message de sortie	Description du message
`Successfully added a comment to the issue with ID ISSUE_ID` dans Wiz.	L'action a réussi.
`Error executing action "Add Comment To Issue". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

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

L'action a réussi.

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

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Add Comment To Issue (Ajouter un commentaire au problème) :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Obtenir l'analyse de l'agent bleu

Utilisez l'action Get Blue Agent Analysis pour obtenir les détails de l'analyse de l'agent Wiz Blue pour une menace spécifiée.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Obtenir l'analyse de l'agent bleu nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`Threat ID`	Obligatoire. Identifiant unique de l'ID de menace Wiz.

Threat ID

Obligatoire.

Identifiant unique de l'ID de menace Wiz.

Sorties de l'action

L'action Get Blue Agent Analysis (Obtenir l'analyse de l'agent bleu) fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Get Blue Agent Analysis :

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

Messages de sortie

L'action Get Blue Agent Analysis peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Message de sortie	Description du message
`Successfully retrieved blue agent analysis for threat ID THREAT_ID` dans Wiz.	L'action a réussi.
`Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

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

L'action a réussi.

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

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Get Blue Agent Analysis :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Jobs

Pour en savoir plus sur les jobs, consultez Configurer un nouveau job et Planification avancée.

Job de synchronisation bidirectionnelle Wiz et Google SecOps

Utilisez le job de synchronisation bidirectionnelle Wiz et Google SecOps pour maintenir une synchronisation continue entre les menaces Wiz et les cas Google SecOps.

Paramètres du job

Le job de synchronisation bidirectionnelle Wiz et Google SecOps nécessite les paramètres suivants :

Paramètre	Description
`Environment Name`	Obligatoire. Nom de l'environnement dans lequel synchroniser les demandes. La valeur par défaut est `Default Environment`.
`Wiz API Root`	Obligatoire. Point de terminaison de l'API GraphQL Wiz pour votre locataire. Le point de terminaison doit respecter le format `https://api.<region>.app.wiz.io/graphql` (ou `https://api.<region>.app.wiz.us/graphql` pour Wiz for Gov), où `<region>` représente la région du centre de données Wiz qui vous a été attribuée (par exemple, `us1`, `us2`, `eu1` ou `eu2`). Reportez-vous aux détails de votre locataire Wiz pour obtenir l'URL exacte de votre point de terminaison. N'utilisez pas d'URL régionales génériques sans numéro. La valeur d'espace réservé par défaut est `https://api.<region>.app.wiz.io/graphql`. Remplacez `<region>` par la région du centre de données Wiz qui vous a été attribuée.
`Wiz Authentication URL`	Facultatif. URL d'authentification utilisée pour générer des jetons d'accès OAuth. Pour les environnements commerciaux, utilisez `https://auth.app.wiz.io`. Pour les environnements Wiz for Gov (FedRAMP), utilisez `https://auth.app.wiz.us`. La valeur par défaut est `https://auth.app.wiz.io`.
`Wiz Client ID`	Obligatoire. ID client du compte de service de l'API Wiz.
`Wiz Client Secret`	Obligatoire. Code secret du client pour le compte de service de l'API Wiz.
`Max Hours Backwards`	Facultatif. Nombre d'heures avant l'itération initiale du job pour récupérer les demandes mises à jour (plage : 1 à 720, valeur par défaut : 24). Ce paramètre s'applique à la première exécution du job ou en tant que solution de secours si le code temporel de la dernière exécution est réinitialisé.
`Verify SSL`	Obligatoire. Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Wiz. Cette option est sélectionnée par défaut.
`Fields to sync`	Obligatoire. Liste d'éléments séparés par une virgule déterminant les champs à synchroniser. Seuls les champs explicitement listés ici seront synchronisés. Les valeurs possibles sont : `Status`, `Comments`, `Product Link`, `Severity`. La valeur par défaut est `Status, Comments, Product Link, Severity`.

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.