Aller au contenu principal

Examiner les incidents

Aperçu de l'examen​

Un examen approprié est crucial pour une remédiation efficace des secrets. Comprendre le contexte complet d'une exposition de secret vous aide à prendre des décisions éclairées sur la priorité et l'approche de remédiation.

Avant de remédier aux incidents, exploitez tout le contexte et les informations de GitGuardian pour une remédiation sûre et efficace.

Score de risque​

Plans Growth et Enterprise

Seuls les workspaces disposant d'un plan Growth ou Enterprise peuvent accéder au score de risque.

Chaque incident inclut un score de risque (0-100) qui fournit des informations de priorisation assistées par ML, où 100 indique le risque le plus élevé et 0 le plus faible. Le score est affiché de manière proéminente dans la page de détail de l'incident avec une explication détaillée des facteurs contributifs.

Fonctionnalités clés :

  • Scoring dynamique qui se met à jour à mesure que le contexte de l'incident évolue
  • Explication en langage naturel des principaux facteurs de risque
  • Mécanisme de feedback pour aider à améliorer la fonctionnalité Le score de risque vous aide à évaluer rapidement si un incident nécessite une attention immédiate ou peut être traité via des workflows standard.

→ En savoir plus sur le Score de risque et comment l'utiliser

Ce que GitGuardian fournit pour l'examen​

Pour chaque incident, GitGuardian vous fournit les métadonnées suivantes concernant le secret et ses occurrences :

  • Type de secret (relevé par le détecteur)
  • Date (à laquelle l'occurrence du secret a été committée)
  • E-mail de l'auteur du commit (développeur impliqué)
  • Nom du dépôt
  • Nom et extension du fichier
  • Hash SHA-1 du commit
  • Présence dans l'historique git (lorsque possible)
  • Validité (lorsque possible - voir la section dédiée)
  • Tags supplémentaires (par exemple, Default branch, From historical scan, Publicly leaked, Vaulted, Regression, Test file, Revocable by GitGuardian, etc.)

Vérifications de présence des secrets​

Avec la vérification de présence, il est possible de vérifier la présence (et donc l'accessibilité) de chaque occurrence du secret dans vos dépôts. Pour chaque incident, GitGuardian affiche les dates auxquelles chaque occurrence a été vue pour la première et la dernière fois, et si elle est toujours présente dans le dépôt.

Occurrences visible in git

Une fois que vous avez entièrement supprimé le dépôt ou réécrit l'historique git, revenez à la page de votre incident pour obtenir la preuve de suppression de l'occurrence du secret (voir la capture d'écran ci-dessous). Une fois qu'une occurrence n'est plus visible dans l'historique git, GitGuardian cessera de vérifier sa présence.

Occurrences no longer visible in git

GitGuardian vérifie régulièrement la présence des occurrences, dans la mesure du possible et en tenant compte des limites de débit existantes de l'API VCS, afin de refléter l'état de votre dépôt git. Vous pouvez également exécuter manuellement la vérification de présence si vous avez besoin de forcer la mise à jour du statut des occurrences d'un incident.

Les vérifications de présence récurrentes s'exécutent sur les plans Growth et Enterprise. Sur le plan Free, exécutez la vérification de présence manuellement depuis l'incident.

La fréquence des vérifications récurrentes dépend du statut et de l'ancienneté de l'incident de secret :

Statut de l'incidentAncienneté de l'incidentFréquence
OpenMoins de six moisQuotidienne
OpenPlus de six moisHebdomadaire
IgnoredMoins de six moisSemestrielle
IgnoredPlus de six moisJamais
ResolvedMoins de six moisMensuelle
ResolvedPlus de six moisSemestrielle

Si vous hébergez GitGuardian on-premise, vous pouvez modifier ces fréquences dans votre zone d'administration.

⚠️ Vérifications de présence et commits orphelins

Lorsque vous supprimez un dépôt, tous ses commits sont définitivement supprimés. Cependant, utiliser git push --force pour supprimer un commit spécifique dans un dépôt ne le supprime pas définitivement. Il devient un commit orphelin, qui existe toujours mais n'est plus référencé par aucune branche. Il est impossible de voir les commits orphelins dans une pull request ou dans une branche existante à moins d'avoir accès à l'identifiant unique (sha) du commit. GitGuardian considère l'occurrence d'un secret dans un commit orphelin comme présente. Les VCS fournissent un ramasse-miettes (garbage collection), vidant complètement la corbeille des commits orphelins. Dans le cas de :

  • GitHub, il est nécessaire de contacter le support pour exécuter le ramasse-miettes
  • GitLab, la fréquence du ramasse-miettes est décidée par l'administrateur du VCS

Lorsque vous décidez d'arrêter de surveiller un dépôt, GitGuardian perd par conséquent l'accès à ce dépôt, ce qui amène la vérification de présence à perdre sa capacité à mettre à jour les valeurs concernant ses occurrences correspondantes. GitGuardian affichera une icône pour indiquer que le dépôt n'est plus surveillé.

Pour les incidents contenant des occurrences liées à plus d'un dépôt, la vérification de présence continuera de fonctionner pour le reste des occurrences liées aux sources surveillées jusqu'à ce que la dernière source surveillée soit retirée du périmètre.

Informations sur l'exposition publique​

Lorsqu'un secret a été trouvé dans des emplacements publics, GitGuardian le marque avec le tag Publicly leaked et fournit des informations détaillées sur l'exposition. Comprendre la nature et l'étendue de l'exposition publique est important pour une remédiation efficace.

Secret publicly leaked

Types d'exposition publique​

GitGuardian catégorise l'exposition publique en trois types :

La source est publiquement visible​

Ce type d'exposition indique que l'incident a au moins une occurrence dans une source surveillée qui est publiquement visible.

Ce que cela signifie :

  • Le secret a été committé dans une source que votre organisation a intégrée à GitGuardian Internal Monitoring
  • Cette source est publiquement visible

A un incident public lié​

Le même secret apparaît également dans un ou plusieurs incidents publics détectés par GitGuardian Public Monitoring.

Ce que cela signifie : Le secret a été trouvé dans le périmètre public de votre entreprise (activité de développeur surveillée ou dépôts publics suivis par Public Monitoring)

info

Tous les clients SaaS peuvent voir ce type d'exposition ; les détails complets (incidents liés) nécessitent un abonnement à Public Monitoring. Dans Public Monitoring, ces incidents affichent le tag réciproque Internally leaked

Trouvé hors périmètre​

Le secret a été trouvé dans des emplacements publics entièrement en dehors du périmètre surveillé de votre entreprise.

Ce que cela signifie :

  • La capacité HMSL (Has My Secret Leaked) de GitGuardian a détecté le secret sur GitHub public
  • Le secret apparaît dans des dépôts ou des emplacements non détenus ni surveillés par votre organisation
  • Cela peut indiquer que le secret a été copié, partagé ou divulgué par des tiers externes

Informations fournies :

Pour chaque endroit où le secret a été trouvé (jusqu'à 10), GitGuardian fournit :

  • Le type d'endroit (dépôt GitHub)
  • Un lien vers la source originale

Fréquence de vérification automatique :

GitGuardian vérifie régulièrement la présence de nouvelles occurrences en dehors de votre périmètre. La fréquence dépend de votre plan, du statut de l'incident et de la validité du secret :

PlanStatut de l'incidentValidité du secretAncienneté de l'incidentFréquence
Growth et EnterpriseOpenedNon invalideMoins d'un anQuotidienne
Growth et EnterpriseOpenedNon invalidePlus d'un anHebdomadaire
Growth et EnterpriseResolvedNon invalideTouteMensuelle
Growth et EnterpriseIgnoredNon invalideTouteJamais
Growth et EnterpriseOpenedInvalideTouteJamais
Growth et EnterpriseResolvedInvalideTouteJamais
Growth et EnterpriseIgnoredInvalideTouteJamais
remarque

La vérification « Trouvé hors périmètre » n'est pas prise en charge pour les secrets multi-match. Les secrets détectés en dehors de votre périmètre dans plus de 10 endroits sont considérés comme des faux positifs (par exemple, des identifiants de test standard) et n'afficheront pas ce type d'exposition.

Pour les utilisateurs de l'API

Vous pouvez rencontrer deux champs, secret_hash et hmsl_hash, lorsque vous travaillez avec les incidents de secrets, par exemple.

  • Le champ secret_hash est un identifiant interne pour chaque secret détecté.
  • Le hmsl_hash est associé au service Has My Secret Leaked de GitGuardian. GitGuardian utilise l'algorithme de hachage HMSL pour comparer votre secret — de manière sécurisée et confidentielle — avec des secrets précédemment trouvés sur GitHub public. Cela permet à GitGuardian de vérifier si votre secret est apparu publiquement, sans exposer la valeur réelle du secret. Le même algorithme de hachage est également utilisé avec ggscout pour identifier les secrets stockés dans un coffre-fort (vaulted).

Travailler avec l'exposition publique​

Utilisez la vue enregistrée par défaut « Public exposure » pour vous concentrer sur les incidents ayant été exposés publiquement. Cette vue affiche uniquement les incidents ouverts divulgués publiquement et inclut la colonne « Public exposure » pour une visibilité rapide.

Vous pouvez également filtrer par le tag Publicly leaked ou par types d'exposition spécifiques, et ajouter la colonne Public exposure à n'importe quelle vue personnalisée.

Les détails de chaque type d'exposition sont affichés dans le panneau latéral de la page de détail de l'incident.

Incident with all three exposure types

Installations self-hosted

Pour les installations self-hosted, seul le type d'exposition Source publicly visible est disponible. Les types d'exposition Public incident linked et Outside perimeter ne sont pas du tout disponibles sur Self-Hosted, car ils nécessitent l'infrastructure Public Monitoring de GitGuardian.

Informations issues de l'intégration Secret Manager​

Comprendre votre paysage de gestion des secrets est crucial pour une planification efficace de la remédiation. L'intégration de GitGuardian avec les Secret Managers via ggscout fournit un contexte précieux pendant l'examen.

Identification des secrets stockés dans un coffre-fort​

Lors de l'examen des incidents, GitGuardian peut identifier si le secret exposé est déjà stocké dans l'un de vos Secret Managers connectés :

  • Tag Vaulted : Les incidents sont automatiquement taggés lorsque le secret est trouvé dans votre Secret Manager.
  • Emplacement de stockage : Voir quel Secret Manager contient le secret et son chemin.

Ces informations vous aident à :

  • Augmenter la confiance dans le fait que l'incident est un vrai positif, lorsque le secret associé est stocké dans un coffre-fort. C'est particulièrement utile lorsque GitGuardian ne peut pas évaluer la validité du secret.
  • Déterminer si les applications utilisent à la fois des versions codées en dur et stockées dans un coffre-fort.
  • Comprendre quelles étapes doivent être envisagées pour la remédiation.

Évaluation de l'aptitude au push-to-vault​

Pendant l'examen, évaluez si le secret est prêt pour l'intégration dans un Secret Manager :

  • Architecture de l'application : Les applications affectées peuvent-elles récupérer les secrets depuis vos Secret Managers ?
  • Modèles d'accès : À quelle fréquence le secret est-il consulté et par quels services ?
  • Considérations d'environnement : Faut-il des secrets différents pour dev/staging/prod ?

Ces questions devraient vous aider à identifier où les secrets devraient être déplacés, dans quelle instance de Secret Manager et à quel emplacement ?

Implications du workflow Secret Manager​

Votre examen doit tenir compte de la façon dont l'intégration Secret Manager affecte la remédiation :

  • Infrastructure existante : Quelle configuration de Secret Manager est déjà en place ?
  • Contrôles d'accès : Qui a les permissions pour gérer les secrets dans votre Secret Manager ?
  • Capacités de rotation : Votre Secret Manager prend-il en charge la rotation automatique pour ce type de secret ?
  • Dépendances de déploiement : Comment les applications seront-elles mises à jour pour utiliser le Secret Manager ?

En savoir plus sur les intégrations Secret Manager

Regroupement d'incidents similaires assisté par ML​

Sources VCS uniquement

Le regroupement d'incidents similaires assisté par ML n'est actuellement disponible que pour les incidents détectés à partir de sources de systèmes de contrôle de version (VCS). Les sources non-VCS (telles que les intégrations de messagerie, de ticketing ou de documentation) ne sont pas encore prises en charge.

remarque

Le regroupement d'incidents similaires basé sur le ML est disponible pour les plans Growth et Enterprise.

Le regroupement d'incidents similaires basé sur le ML de GitGuardian vous aide à identifier et gérer plus efficacement les incidents liés en détectant automatiquement les incidents qui partagent des caractéristiques et un contexte similaires.

Fonctionnement​

Lorsque vous consultez la page de détail d'un incident, vous verrez une section Similar Incidents dans la barre latérale qui affiche les incidents présentant des patterns similaires détectés par nos algorithmes de machine learning. Cette fonctionnalité analyse le contexte du code dans le patch pour identifier des relations pertinentes entre les incidents.

Scénarios de regroupement courants​

L'algorithme de ML identifie différents types d'incidents similaires :

  • Tokens en rotation dans des fichiers automatisés : un même fichier qui fuit continuellement différents tokens via l'automatisation
  • Identifiants de test QA : des clés de test (bots Slack, clés d'API Postman) apparaissant dans des contextes similaires
  • Chaînes de connexion à des bases de données : plusieurs chaînes de connexion vers le même environnement avec des identifiants différents
  • Faux positifs répétés : des chaînes à haute entropie dans les logs ou les scripts de test qui sont probablement générées par le système
  • Fuites de code de templating : plusieurs développeurs utilisant des tutoriels ou des templates partagés avec des secrets fuités similaires
  • Patterns bruyants connus : des faux positifs récurrents provenant de types de fichiers ou de services internes spécifiques

Utiliser les incidents similaires pour l'investigation​

  1. Depuis les détails de l'incident : consultez les incidents similaires dans la barre latérale et cliquez sur « View X similar incidents » pour les afficher dans la liste principale des incidents
  2. Filtrer par similarité : dans la boîte de recherche, utilisez similar_to pour afficher uniquement les incidents similaires à un incident spécifique
  3. Trier par nombre d'incidents similaires : utilisez la colonne « Similar incidents » pour trier les incidents par nombre croissant ou décroissant d'incidents similaires

Cette fonctionnalité est particulièrement utile pour :

  • Identifier les faux positifs : repérer les patterns qui indiquent des incidents de type faux positif
  • Remédiation cohérente : appliquer la même approche de remédiation aux incidents nécessitant des corrections similaires
  • Comprendre les patterns d'incidents : découvrir les problèmes récurrents dans votre codebase

ML Similar Incident Grouping

Une fois que vous avez identifié des incidents similaires, vous pouvez utiliser les actions groupées pour les résoudre, les assigner ou les tagger ensemble efficacement.

Nous valorisons vos retours

Le regroupement d'incidents similaires utilise des modèles de machine learning qui sont continuellement améliorés sur la base des retours utilisateurs. Si vous remarquez des incidents avec des regroupements inattendus, nous vous encourageons à partager vos retours directement via le dashboard — votre contribution nous aide à affiner le modèle de regroupement.

Étapes suivantes : passer à la remédiation​

Une fois votre examen terminé et que vous comprenez le contexte de l'exposition du secret, vous êtes prêt à commencer la remédiation. Votre examen devrait vous avoir aidé à déterminer :

  • Ce à quoi le secret donne accès - Quels systèmes, services ou ressources
  • Niveau de privilège - Accès administratif, en lecture seule ou à portée limitée
  • Dépendances - Quelles applications ou services dépendent de ce secret
  • Chronologie de l'exposition - Quand le secret a été exposé pour la première fois et pendant combien de temps
  • Visibilité publique - Si le secret est exposé publiquement

Choisir votre approche de remédiation​

En fonction des conclusions de votre examen :

Prêt à commencer la remédiation ?​

Rappel : Le temps consacré à un examen approfondi vous fera gagner du temps et réduira les risques pendant la remédiation. Ne vous précipitez pas dans la remédiation sans comprendre l'impact complet.