# Évaluation des alertes à partir de l’analyse des secrets Découvrez les fonctionnalités supplémentaires qui peuvent vous aider à évaluer les alertes et hiérarchiser leur correction, par exemple la vérification de la validité d’un secret. ## À propos de l’évaluation des alertes Certaines fonctionnalités supplémentaires peuvent vous aider à évaluer les alertes afin de mieux les hiérarchiser et les gérer. Vous pouvez: * Vérifier la validité d’un secret pour voir s’il est toujours actif. **S’applique uniquement aux GitHub jetons**. Consultez [Vérification de la validité d’un secret](#checking-a-secrets-validity). * Effectuer un contrôle de validité « à la demande » pour obtenir le statut de validation le plus à jour. Consultez [Effectuer une vérification de validité à la demande](#performing-an-on-demand-validity-check). * Passer en revue les métadonnées d'un jeton. **S’applique uniquement aux GitHub jetons**. Par exemple, pour voir quand le jeton a été utilisé pour la dernière fois. Consultez [Révision des GitHub métadonnées de jeton](#reviewing-github-token-metadata). * Revoyez les vérifications étendues des métadonnées pour un secret exposé, afin de voir les détails comme qui possède le secret et comment contacter le propriétaire du secret. **S’applique uniquement aux jetons de l’API OpenAI, de Google OAuth, de Slack et de Replicate**. Consultez [Révision des métadonnées étendues pour un jeton](#reviewing-extended-metadata-for-a-token). * Examinez les étiquettes attribuées à l’alerte. Pour plus d’informations, consultez [Révision des étiquettes d’alerte](#reviewing-alert-labels). ## Vérification de la validité d’un secret Les contrôles de validité vous aident à classer par ordre de priorité les alertes en vous indiquant quels secrets sont `active` ou `inactive`. Un secret `active` est un secret qui pourrait encore être exploité, de sorte que ces alertes doivent être examinées et corrigées en priorité. Par défaut, GitHub vérifie la validité des jetons et affiche l’état de GitHub validation du jeton dans la vue d’alerte. Les organisations utilisant GitHub Team, GitHub Enterprise Cloud avec une licence pour GitHub Secret Protection, ou GitHub Enterprise Server avec une licence pour GitHub Secret Protection peuvent également activer les vérifications de validité pour les modèles partenaires. Pour plus [d’informations, consultez Vérification de la validité d’un secret](/fr/enterprise-cloud@latest/code-security/tutorials/remediate-leaked-secrets/evaluating-alerts#checking-a-secrets-validity). | Validité | État | Résultat | | --------------------------- | ---------- | ------------------------------------------------------------------------------------------ | | Secret actif | `active` | GitHub a vérifié auprès du fournisseur de ce secret et a constaté que le secret est actif | | Secret éventuellement actif | `unknown` | GitHub ne prend pas encore en charge les vérifications de validation pour ce type de jeton | | Secret éventuellement actif | `unknown` | GitHub n’a pas pu vérifier ce secret | | Secret inactif | `inactive` | Vous devez vous assurer qu’aucun accès non autorisé n’a déjà eu lieu | Les vérifications de validité des modèles partenaires sont disponibles pour les types de référentiels suivants : * Référentiels appartenant à l’organisation sur GitHub Team ou GitHub Enterprise Cloud avec [GitHub Secret Protection](/fr/enterprise-cloud@latest/get-started/learning-about-github/about-github-advanced-security) activé Pour plus d’informations sur l’activation des vérifications de validité pour les modèles de partenaires, consultez [Activer les vérifications de validité pour votre référentiel](/fr/enterprise-cloud@latest/code-security/how-tos/secure-your-secrets/customize-leak-detection/enable-validity-checks) et pour plus d’informations sur les modèles de partenaires actuellement pris en charge, consultez [Modèles de détection de secrets pris en charge](/fr/enterprise-cloud@latest/code-security/reference/secret-security/supported-secret-scanning-patterns). Vous pouvez activer les vérifications de validité des modèles partenaires à l’aide de configurations de sécurité, définies au niveau de l’entreprise ou au niveau de l’organisation. Voir [Création d’une configuration de sécurité personnalisée pour votre entreprise](/fr/enterprise-cloud@latest/code-security/how-tos/secure-at-scale/configure-enterprise-security/establish-complete-coverage/create-custom-configuration) et [Création d’une configuration de sécurité personnalisée](/fr/enterprise-cloud@latest/code-security/how-tos/secure-at-scale/configure-organization-security/establish-complete-coverage/create-custom-configuration). Pour plus d’informations sur les modèles partenaires actuellement pris en charge, consultez [Modèles de détection de secrets pris en charge](/fr/enterprise-cloud@latest/code-security/reference/secret-security/supported-secret-scanning-patterns). Avec une GitHub Copilot Enterprise licence, vous pouvez demander Copilot Chat de l’aide pour mieux comprendre les alertes de sécurité, notamment secret scanning les alertes, dans les dépôts de votre organisation. Pour plus d’informations, consultez « [Poser des questions à GitHub Copilot sur GitHub](/fr/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/chat-with-copilot/chat-in-github#asking-questions-about-alerts-from-github-advanced-security-features) ». Vous pouvez utiliser l’API REST pour obtenir une liste indiquant le statut de validation le plus récent pour chacun de vos jetons. Pour plus d’informations, consultez [Points de terminaison d’API REST pour l’analyse de secrets](/fr/enterprise-cloud@latest/rest/secret-scanning) dans la documentation de l’API REST. Vous pouvez également utiliser des webhooks pour être informé de l’activité liée à une secret scanning alerte. Pour plus d’informations, consultez l'événement `secret_scanning_alert` dans [Événements et charges utiles du webhook](/fr/enterprise-cloud@latest/webhooks/webhook-events-and-payloads?actionType=created#secret_scanning_alert). ## Exécution d’un contrôle de validité à la demande Une fois que vous avez activé les vérifications de validité des modèles partenaires pour votre référentiel, vous pouvez effectuer une vérification de validité « à la demande » pour tout secret pris en charge en cliquant sur ** Vérifier le secret** dans la vue d’alerte. GitHub envoie le modèle au partenaire approprié et affiche l’état de validation du secret dans la vue d’alerte. ![Capture d’écran de l'interface utilisateur montrant une alerte secret scanning. Un bouton intitulé « Vérifier le secret » est mis en évidence par un contour orange.](/assets/images/help/security/secret-scanning-verify-secret.png) ## Examen des métadonnées de GitHub jeton > \[!NOTE] > Les métadonnées pour les GitHub jetons sont actuellement dans préversion publique et sont sujettes à modification. Dans la vue d’une alerte de jeton actif GitHub , vous pouvez passer en revue certaines métadonnées sur le jeton. Ces métadonnées peuvent vous aider à identifier le jeton et à déterminer les étapes de correction à prendre. Les jetons, comme personal access token et d’autres informations d’identification, sont considérés comme des informations personnelles. Pour plus d'informations sur l’utilisation des jetons GitHub, consultez [la Déclaration de confidentialité de GitHub](/fr/site-policy/privacy-policies/github-general-privacy-statement) et les [Politiques d’utilisation acceptable](/fr/site-policy/acceptable-use-policies/github-acceptable-use-policies). ![Capture d’écran de l’interface utilisateur d’un jeton GitHub, montrant les métadonnées de jeton.](/assets/images/help/repository/secret-scanning-github-token-metadata.png) Les métadonnées des tokens GitHub sont disponibles pour les tokens actifs de tout référentiel pour lequel l’analyse des secrets est activée. Si un jeton a été révoqué ou si son état ne peut pas être validé, les métadonnées ne sont pas disponibles. GitHub révoque automatiquement des jetons GitHub dans des référentiels publics. Les métadonnées pour GitHub les jetons dans les référentiels publics sont donc peu susceptibles d’être disponibles. Les métadonnées suivantes sont disponibles pour les jetons actifs GitHub : | Métadonnées | Descriptif | | ----------------------- | ------------------------------------------------------ | | Nom du secret | Nom donné au GitHub jeton par son créateur | | Propriétaire du secret | L’identifiant GitHub du propriétaire du jeton | | Date de création | Date de création du jeton | | A expiré le | Date d’expiration du jeton | | Dernière utilisation le | Date de la dernière utilisation du jeton | | Access | Si le jeton dispose ou non d’un accès à l’organisation | Seules les personnes disposant d’autorisations d’administrateur dans le référentiel contenant un secret divulgué peuvent afficher les détails de l’alerte de sécurité et les métadonnées de jeton pour une alerte. Les propriétaires d’entreprise peuvent demander un accès temporaire au référentiel à cet effet. Si l’accès est accordé, GitHub avertira le propriétaire du dépôt contenant le secret divulgué, consignera l’action dans les journaux d’audit du propriétaire du dépôt et de l’entreprise, et activera l’accès pendant 2 heures. Pour plus d’informations, consultez [Accès aux dépôts appartenant aux utilisateurs dans votre entreprise](/fr/enterprise-cloud@latest/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/accessing-user-owned-repositories-in-your-enterprise). ## Examen des métadonnées étendues pour un jeton > \[!NOTE] Les vérifications de métadonnées étendues pour les jetons sont en préversion publique et peuvent être modifiées. Dans la vue d’une alerte de jeton actif GitHub , vous pouvez voir des informations de métadonnées étendues, telles que le propriétaire et les coordonnées. Le tableau suivant présente **toutes les métadonnées disponibles**. Notez que les vérifications des métadonnées sont actuellement limitées à l’API OpenAI, à Google OAuth, à Slack et aux jetons Replicate, et que les métadonnées affichées pour chaque jeton peuvent ne représenter qu’un sous-ensemble des métadonnées existantes. | Type de métadonnées | Descriptif | | ------------------------------ | ------------------------------------------------------------------------------------------------------ | | ID du propriétaire | Identificateur unique du fournisseur pour l’utilisateur ou le compte de service propriétaire du secret | | Nom du propriétaire | Nom d'utilisateur ou nom d'affichage compréhensible du propriétaire du secret | | Adresse e-mail du propriétaire | Adresse e-mail associée au propriétaire | | Nom de l’organisation | Nom de l’organisation / espace de travail / projet auquel appartient le secret | | Org ID | Identificateur unique du fournisseur pour cette organisation | | Date d’émission du secret | Horodatage lorsque le secret (jeton ou clé) a été créé ou le plus récemment émis | | Date d’expiration du secret | Horodatage à laquelle le secret est prévu pour expirer | | Nom du secret | Nom d’affichage ou étiquette attribué par l’utilisateur pour le secret | | ID secret | Identificateur unique du fournisseur pour le secret | ## Poser des questions sur les alertes GitHub Copilot Chatsecret scanning Avec une GitHub Copilot Enterprise licence, vous pouvez demander Copilot Chat de l’aide pour mieux comprendre les alertes de sécurité, notamment secret scanning les alertes, dans les dépôts de votre organisation. Pour plus d’informations, consultez « [Poser des questions à GitHub Copilot sur GitHub](/fr/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/chat-with-copilot/chat-in-github#asking-questions-about-alerts-from-github-advanced-security-features) ». ## Examen des étiquettes d’alerte Dans la fenêtre des alertes, vous pouvez consulter toutes les étiquettes attribuées à l’alerte. Les étiquettes donnent des détails supplémentaires sur l’alerte, ce qui peut éclairer l’approche que vous adoptez pour la correction. Secret scanning les alertes peuvent leur attribuer les étiquettes suivantes. Suivant les étiquettes affectées, vous verrez des informations supplémentaires dans la fenêtre des alertes. | Étiquette | Descriptif | Informations sur la fenêtre d'alerte | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `public leak` | Le secret détecté dans votre dépôt a également été identifié comme ayant fait l’objet d’une fuite publique par au moins une analyse de GitHubportant sur du code, des discussions, des gists, des tickets, des demandes de fusion et des wikis. Cela peut vous obliger à traiter l’alerte avec plus d’urgence ou à la corriger différemment par rapport à un jeton exposé en privé. | Vous trouverez des liens vers les lieux publics spécifiques où la divulgation du secret a été détectée. | | `multi-repo` | Le secret détecté dans votre référentiel a été trouvé dans plusieurs dépôts de votre organisation ou entreprise. Ces informations peuvent vous aider à déduire plus facilement l’alerte au sein de votre organisation ou entreprise. | Si vous disposez des autorisations nécessaires, vous verrez des liens vers les alertes spécifiques pour le même secret dans votre organisation ou entreprise. |