Aller au contenu principal

Occurrences de secrets

Que sont les occurrences d'un incident ?​

Le même secret peut être vu plusieurs fois dans votre VCS. On les appelle des occurrences.
GitGuardian rationalise le processus de remédiation en regroupant automatiquement plusieurs occurrences d'un même secret en un seul incident de secret.

Ainsi, une occurrence d'un incident de secret est identifiée de manière unique par la combinaison des paramètres suivants :

  • la source (par exemple : un dépôt GitHub ou un projet GitLab) impactée par l'occurrence du secret,
  • le commit dans lequel nous avons détecté l'occurrence du secret,
  • le fichier du commit contenant l'occurrence du secret,
  • la ligne dans le fichier du commit où le secret est apparu.

Les alertes ne sont envoyées que lorsqu'un nouvel incident est créé ou rouvert à la suite d'une régression. Une nouvelle occurrence attachée à un incident de secret ouvert déjà existant ne déclenchera aucune alerte.

GitGuardian fixe une limite maximale de 1 000 occurrences pour un seul incident de secret (cela ne s'applique pas à la plateforme Self-Hosted).

Regroupement des occurrences en incidents de secret​

GitGuardian améliore le processus de remédiation en regroupant automatiquement plusieurs occurrences d'un même secret en un seul incident de secret.
Cependant, au sein des workspaces Enterprise, l'Owner du workspace a la capacité exclusive d'ajuster la manière dont ces occurrences de secrets sont regroupées dans les settings. Deux niveaux de granularité sont disponibles :

  1. par secret [par défaut]
    • Toutes les occurrences d'un même secret à travers différentes sources (par exemple, des dépôts) sont consolidées en un seul incident de secret.
    • Cela signifie que si un secret particulier est trouvé dans plusieurs sources, il ne générera qu'un seul incident de secret.
  2. par secret x source :
    • Les occurrences d'un même secret sont regroupées en incidents de secret distincts en fonction de leurs sources respectives.
    • Cela signifie que si le même secret apparaît dans plusieurs sources, chaque source aura son propre incident de secret individuel.
    • En tant que Manager, vous pouvez toujours savoir si le même incident a créé d'autres incidents dans différentes sources (si vous avez besoin d'aide pour filtrer par ces incidents liés via l'API, contactez support@gitguardian.com pour obtenir un exemple de script). Cette configuration permet d'adapter la stratégie de regroupement afin de l'aligner sur les processus de remédiation et les politiques de confidentialité des données de votre entreprise.

Occurrences grouping setting

attention

La modification du paramètre de regroupement des occurrences doit être effectuée avec la plus grande prudence, car elle a un impact significatif sur la population d'incidents de secret et les analytics. Cette modification doit être considérée comme une action ponctuelle.
Lors de la modification de ce paramètre, tous les incidents de secret existants seront migrés pour se conformer au nouveau mode de regroupement, et veuillez noter que ce processus de migration peut prendre un certain temps.
Occurrences grouping setting warning modal

Les alertes ne sont envoyées que lorsqu'un nouvel incident est créé ou rouvert à la suite d'une régression. Une nouvelle occurrence attachée à un incident de secret ouvert déjà existant ne déclenchera aucune alerte.

GitGuardian fixe une limite maximale de 1 000 occurrences pour un seul incident de secret (cela ne s'applique pas à la plateforme Self-Hosted).