Wiz
Connectez OverView à Wiz via l'API GraphQL pour récupérer les ressources cloud, les vulnérabilités, l'inventaire logiciel, les identités cloud et les résultats de conformité
Le connecteur Wiz permet à OverView de récupérer directement depuis votre tenant Wiz vos ressources cloud, vulnérabilités, inventaire logiciel, identités cloud et résultats de conformité, pour une vue consolidée de votre posture de sécurité cloud.
Objectif
Le connecteur Wiz récupère les informations suivantes :
- Ressources cloud — machines virtuelles, conteneurs, bases de données, stockage et ressources serverless
- Vulnérabilités détectées
- Logiciels et paquets installés (SBOM)
- Identités cloud et rôles IAM
- Résultats de conformité (CIS, NIST, PCI DSS et autres référentiels)
Prérequis
- Accès à la console Wiz avec l'autorisation de gérer les comptes de service
- Un compte de service de type Custom Integration (GraphQL API)
- Les scopes en lecture listés dans la procédure ci-dessous attribués à ce compte de service
Informations à fournir dans OverView
Contactez le support OverSOC pour configurer ce connecteur. Vous devrez fournir :
| Champ | Description |
|---|---|
| Identifiant client | ID client du compte de service |
| Secret client | Secret client du compte de service (affiché une seule fois à la création) |
| URL de l'API | Endpoint GraphQL de votre tenant, ex. https://api.us1.app.wiz.io/graphql (Settings > Tenant Info) |
Procédure
Créer un compte de service dans Wiz
- Connectez-vous à la console Wiz.
- Accédez à Settings > Access Management > Service Accounts.
- Cliquez sur Add Service Account.
- Saisissez un nom pour le compte (ex. « OverView Connector »).
- Sélectionnez le type Custom Integration (GraphQL API).
- Attribuez les scopes API en lecture seule suivants :
read:resources— ressources cloud, identités cloud, rôles IAMread:vulnerabilities— vulnérabilités détectéesread:cloud_configuration— résultats de conformité et référentiels de sécuritéread:inventory— inventaire des technologiesread:sbom_artifacts— paquets installés (scope distinct, non couvert parread:resources)
- Cliquez sur Add Service Account.
- Copiez le Client ID et le Client Secret, puis transmettez-les à OverView.
Le Client Secret n'est affiché qu'une seule fois, à la création. Si vous quittez la page sans le copier, vous devrez créer un nouveau compte de service.
Récupérer votre endpoint API
- Dans la console Wiz, accédez à Settings > Tenant Info.
- Copiez l'API Endpoint URL — il s'agit de l'API URL à fournir à OverView.
L'endpoint est spécifique au tenant (format https://api.<region>.app.wiz.io/graphql) et ne peut pas être deviné : il doit être récupéré depuis votre tenant.
Bonnes pratiques de sécurité
- Utilisez un compte de service dédié pour l'intégration OverView plutôt qu'un compte partagé ou personnel.
- Attribuez uniquement des scopes en lecture seule — OverView n'a besoin que de lire les données d'inventaire, de détection et d'identité.
- Conservez le Client Secret en lieu sûr : il n'est affiché qu'une seule fois et ne peut pas être récupéré ensuite.
- Renouvelez les identifiants régulièrement, conformément à la politique de sécurité de votre organisation.
Documentation officielle
- Documentation Wiz
- Référence de l'API Wiz : disponible dans la console Wiz sous Settings > API Explorer
Alternative : import par fichiers via DropPoint
L'accès API décrit plus haut est la méthode recommandée pour ce connecteur. Lorsqu'il n'est pas disponible (réseau cloisonné, version ou licence sans API, export déjà produit par ailleurs), OverView accepte des exports de fichiers, à déposer dans le bucket dédié à Wiz.
Bucket : s3://wiz/
Exemple : s3://wiz/export.csv
La procédure est décrite dans le guide OverView DropPoint : génération des credentials, configuration du client, puis envoi des fichiers depuis l'interface web OverView, l'AWS CLI ou un SDK. Les exemples y sont préremplis avec ce bucket lorsque vous suivez ce lien.