Wiz
GitGuardian s'intègre à Wiz pour transférer les incidents de secrets détectés dans vos sources de gestion de versions vers Wiz en tant que findings de secrets natifs. Les équipes de sécurité disposent ainsi d'une vue unique des risques liés aux secrets et des risques cloud, et peuvent prioriser et remédier aux identifiants divulgués directement depuis Wiz.
Fonctionnement
Une fois par jour, GitGuardian envoie vos incidents de secrets actifs à Wiz :
- Portée : les incidents détectés dans vos sources de gestion de versions (GitHub, GitLab, Bitbucket, Azure DevOps) avec un statut ouvert (triggered ou assigned).
- Granularité : un finding par incident et par dépôt. Un incident regroupe toutes les occurrences d'un même secret : lorsqu'un incident présente plusieurs occurrences dans le même dépôt, seule la plus récemment détectée est envoyée à Wiz, et la liste complète reste disponible dans GitGuardian. Chaque finding comporte le contexte de détection : dépôt, chemin du fichier, commit, détecteur, validité, date de la dernière vérification de validité, gravité, et un lien vers l'incident GitGuardian.
- Confidentialité : GitGuardian n'envoie jamais les valeurs des secrets à Wiz. Les findings ne contiennent qu'un hachage SHA-256 du secret et ses métadonnées.
Chaque synchronisation envoie la liste complète des incidents actifs. Wiz maintient les findings ouverts tant qu'ils sont présents dans le dernier envoi : lorsque vous résolvez ou ignorez un incident dans GitGuardian, il est retiré de la synchronisation suivante et Wiz supprime automatiquement le finding.
Correspondance des gravités
La gravité de l'incident GitGuardian définit la gravité du finding dans Wiz :
| Gravité GitGuardian | Gravité Wiz |
|---|---|
| Critical | Critical |
| High | High |
| Medium | Medium |
| Low | Low |
| Info | Votre choix |
| Unknown | Votre choix |
Wiz ne possède pas de gravité Info ou Unknown, c'est donc à vous de choisir la correspondance effectuée par GitGuardian : vers n'importe quelle gravité Wiz, ou Skip sending pour exclure ces incidents de Wiz.
Vous définissez ces deux correspondances lors de la configuration de l'intégration, et pouvez les modifier à tout moment depuis les paramètres de l'intégration. Un changement s'applique à partir de la synchronisation suivante.
Configurer l'intégration
Vous avez besoin d'un utilisateur Wiz autorisé à ajouter des intégrations. L'intégration GitGuardian dans Wiz crée son propre compte de service avec les permissions requises, vous n'avez donc pas besoin d'en créer un au préalable.
- Dans Wiz, ouvrez l'intégration GitGuardian, ajoutez-la, puis copiez le Client ID, le Client secret, l'Authentication URL et l'API endpoint URL qu'elle affiche.
- Dans GitGuardian, accédez à Settings > Integrations > Wiz et cliquez sur Configure.
- Collez les quatre valeurs issues de Wiz dans le formulaire, puis choisissez comment faire correspondre les gravités Info et Unknown (voir Correspondance des gravités).
- Cliquez sur Add integration.
N'utilisez pas un compte de service créé manuellement depuis les paramètres Wiz. Il ne dispose pas des permissions nécessaires à l'intégration, et la synchronisation échoue. Créez toujours les identifiants depuis l'intégration GitGuardian dans Wiz.
Vous pouvez suspendre ou reprendre la synchronisation à tout moment depuis la page des paramètres de l'intégration.
GitGuardian fait office de source de vérité : un finding ignoré ou résolu dans Wiz est recréé à la synchronisation suivante tant que l'incident correspondant est toujours ouvert dans GitGuardian.
Dépannage
La plupart des problèmes de synchronisation sont gérés par GitGuardian, commencez donc par nous. Le support Wiz n'intervient que pour les sources qui restent Skipped.
Contacter le support GitGuardian
Contactez le support GitGuardian si :
- Une source ne s'est pas synchronisée au cours des dernières 24 heures.
- Une source affiche le statut Failed. Cela peut provenir d'une limitation de débit persistante ou d'une panne du côté de Wiz : nous examinons la situation et coordonnons avec Wiz si nécessaire.
- Une source affiche le statut Syncing depuis plusieurs heures.
- Une source affiche le statut Empty alors qu'elle avait des incidents ouverts au moment de la synchronisation.
- Les findings Wiz ne correspondent pas aux incidents GitGuardian. Certaines propriétés sont mises en correspondance entre les deux produits (voir Correspondance des gravités), de petites différences sont donc attendues.
Contacter le support Wiz
Une source est marquée Skipped lorsque Wiz n'a pas pu ingérer tous ses findings, généralement parce qu'il ne prend pas encore en charge l'un des détecteurs. GitGuardian ajoute continuellement des détecteurs, et Wiz peut mettre plusieurs jours à prendre en charge un nouveau détecteur, un statut Skipped se résout donc souvent de lui-même.
Si une source continue d'afficher Skipped sur plusieurs synchronisations, contactez le support Wiz.
Vous ne savez pas lequel s'applique ? Contactez le support GitGuardian et nous impliquerons Wiz si nécessaire.
Limitations
- Seuls les incidents provenant des sources de gestion de versions sont envoyés. Les secrets détectés dans d'autres sources (Slack, Jira, Confluence, et autres) ne sont pas transférés vers Wiz. Les sources Gerrit ne sont pas prises en charge.
- Les incidents détectés par des détecteurs personnalisés ne sont pas envoyés.
- Les occurrences sans chemin de fichier sont ignorées.
- Wiz ingère les envois par lots : l'apparition de nouveaux findings dans Wiz peut prendre jusqu'à 24 heures.
- Une fois qu'un incident est résolu ou ignoré dans GitGuardian, son finding peut rester visible dans Wiz jusqu'à 7 jours avant que Wiz ne le supprime.
