À propos de la sécurité de la chaîne d’approvisionnement

GitHub vous aide à sécuriser votre chaîne d’approvisionnement, en vous permettant de comprendre les dépendances de votre environnement et d’identifier les vulnérabilités présentes dans ces dépendances afin de les corriger.

Dans cet article

À propos de la sécurité de la chaîne d’approvisionnement chez GitHub

Lors du développement d’un projet logiciel, vous utilisez probablement d’autres logiciels pour générer et exécuter votre application, comme des bibliothèques open source, des frameworks ou d’autres outils. Ces ressources sont collectivement appelées « dépendances », car votre projet dépend d’elles pour fonctionner correctement. Votre projet peut s’appuyer sur des centaines de ces dépendances, formant ce qu’on appelle votre « chaîne d’approvisionnement ».

Votre chaîne d’approvisionnement peut poser un problème de sécurité. Si l’une de vos dépendances présente une faiblesse de sécurité connue ou un bogue, des acteurs malveillants peuvent exploiter cette vulnérabilité pour, par exemple, insérer du code malveillant (« programme malveillant »), voler des données sensibles ou provoquer d’autres types de perturbation dans votre projet. Ce type de menace est appelé « attaque de la chaîne d’approvisionnement ». Le fait d’avoir des dépendances vulnérables dans votre chaîne d’approvisionnement compromet également la sécurité de votre propre projet et expose vos utilisateurs à des risques.

L’une des actions les plus importantes que vous pouvez faire pour protéger votre chaîne d’approvisionnement consiste à corriger vos dépendances vulnérables et à remplacer tout programme malveillant.

Vous ajoutez les dépendances directement à votre chaîne d’approvisionnement quand vous les spécifiez dans un fichier manifeste ou un fichier de verrouillage. Les dépendances peuvent également être incluses transitivement ; même si vous ne spécifiez pas une dépendance particulière, mais qu’une de vos dépendances l’utilise, vous êtes également dépendant de cette dépendance.

GitHub offre une gamme de fonctionnalités pour vous aider à comprendre les dépendances de votre environnement, à connaître les vulnérabilités de ces dépendances et à les corriger.

Les fonctionnalités de la chaîne d’approvisionnement sur GitHub sont les suivantes : * Graphe des dépendances * Révision des dépendances * Dependabot alerts

  •           **Dependabot updates**
    * Dependabot security updates 
    •           **Dependabot version updates **

  •         **Versions immuables**

  •           **Attestations d’artefacts**

Le graphe de dépendances joue un rôle essentiel pour la sécurité de la chaîne d’approvisionnement. Le graphe de dépendances identifie toutes les dépendances en amont et les éléments dépendants en aval publics d’un dépôt ou d’un package. Le graphe des dépendances suit et affiche les dépendances de votre dépôt ainsi que certaines de leurs propriétés, telles que les informations sur les vulnérabilités.

Les fonctionnalités de la chaîne d’approvisionnement suivantes sur GitHub reposent sur les informations fournies par le graphique de dépendances.

  • La révision des dépendances utilise le graphe de dépendances pour identifier les modifications de dépendance et vous aider à comprendre l’impact de ces modifications sur la sécurité quand vous passez en revue les demandes de tirage (pull request).
  • Dependabot croise les données de dépendances fournies par le graphe des dépendances avec la liste des avis publiés dans la GitHub Advisory Database, analyse vos dépendances et génère des Dependabot alerts en cas de détection d’une vulnérabilité potentielle.
  • Les Dependabot security updates utilisent le graphe des dépendances et les Dependabot alerts pour vous aider à mettre à jour les dépendances présentant des vulnérabilités connues dans votre dépôt.

Les Dependabot version updates n’utilisent pas le graphe de dépendances et s’appuient plutôt sur le versioning sémantique des dépendances. Les Dependabot version updates vous aident à maintenir vos dépendances mises à jour, même quand elles n’ont pas de vulnérabilités.

Pour obtenir des guides de meilleures pratiques sur la sécurité de la chaîne d’approvisionnement de bout en bout, y compris la protection des comptes personnels, du code et des processus de build, consultez Sécurisation de votre chaîne d’approvisionnement de bout en bout.

Vue d’ensemble des fonctionnalités

À quoi ressemble le graphique de dépendance ?

Pour générer le graphe de dépendances, GitHub examine les dépendances explicites d’un dépôt déclarées dans le manifeste et les fichiers de verrouillage. Quand il est activé, le graphe de dépendances analyse automatiquement tous les fichiers manifestes de package connus dans le dépôt, puis, à partir des informations recueillies, construit un graphe avec les noms et les versions de dépendances connues.

  • Le graphe de dépendances inclut des informations sur vos dépendances directes et vos dépendances transitives.
  • Le graphe de dépendances est automatiquement mis à jour quand vous poussez (push) un commit vers GitHub qui change ou ajoute un manifeste ou un fichier de verrouillage pris en charge à la branche par défaut et quand toute personne pousse une modification vers le dépôt de l’une de vos dépendances.
  • Le graphe des dépendances peut également inclure les informations que vous fournissez lors de la génération de votre projet à l’aide de GitHub Actions. Certains écosystèmes de packages récupèrent la plupart de leurs dépendances transitives au moment de la génération, de sorte que la soumission des informations de dépendance pendant la génération permet d’avoir une vue plus complète de la chaîne d’approvisionnement.
  • Vous pouvez consulter le graphe des dépendances en ouvrant la page principale du dépôt sur GitHub, puis en accédant à l’onglet Insights.
  • Si vous disposez au moins d’un accès en lecture au dépôt, vous pouvez exporter les graphe des dépendances pour le dépôt en tant que nomenclature logicielle compatible SPDX (SBOM), via l’interface utilisateur de GitHub ou l’API REST GitHub. Pour plus d’informations, consultez « Exportation d’une nomenclature logicielle pour votre dépôt ».

Vous pouvez utiliser le API de soumission de dépendances pour envoyer des dépendances à partir du gestionnaire de package ou de l’écosystème de votre choix, même si l’écosystème n’est pas pris en charge par le graphique de dépendances pour l’analyse du manifeste ou du verrouillage des fichiers. Les dépendances soumises à un projet à l’aide de API de soumission de dépendances indiqueront quel détecteur a été utilisé pour leur soumission et quand elles ont été soumises. Pour plus d'informations sur l'API API de soumission de dépendances, consultez Utilisation de l’API de soumission de dépendances.

Pour plus d’informations sur le graphe des dépendances, consultez À propos du graphe de dépendances.

Qu’est-ce que la révision des dépendances ?

La révision des dépendances aide les réviseurs et les contributeurs à comprendre les modifications de dépendance et leur impact sur la sécurité dans chaque demande de tirage.

  • La révision des dépendances vous indique quelles dépendances ont été ajoutées, supprimées ou mises à jour, dans une demande de tirage. Vous pouvez utiliser les dates de publication, la popularité des dépendances et les informations de vulnérabilité pour vous aider à décider s’il faut accepter la modification.
  • Vous pouvez voir la révision des dépendances pour une demande de tirage en affichant la différence enrichie sous l’onglet Fichiers modifiés.

Pour plus d’informations sur la révision de dépendances, consultez À propos de la vérification des dépendances.

Qu’est-ce que Dependabot ?

Dependabot maintient vos dépendances à jour en vous informant de toute vulnérabilité de sécurité présente dans vos dépendances et en ouvrant automatiquement des demandes de tirage pour les mettre à niveau. Les demandes de tirage Dependabot cibleront la prochaine version sécurisée disponible lorsqu’une alerte Dependabot est déclenchée, ou la dernière version lorsqu’une nouvelle version est publiée.

Le terme « Dependabot » englobe les fonctionnalités suivantes :

  • Dependabot alerts : notification affichée sous l’onglet Sécurité du dépôt et dans le graphe des dépendances du dépôt. L’alerte contient un lien vers le fichier affecté dans le projet et des informations sur une version corrigée.
  • Dependabot updates :
    • Dependabot security updates : mises à jour déclenchées pour mettre à niveau vos dépendances vers une version sécurisée quand une alerte est déclenchée.
    • Dependabot version updates : mises à jour planifiées pour maintenir vos dépendances à jour avec la dernière version.

Les demandes de tirage ouvertes par Dependabot peuvent déclencher des workflows qui exécutent des actions. Pour plus d’informations, consultez Automatisation de Dependabot avec GitHub Actions.

Par défaut :

  • Si GitHub Actions est activé pour le dépôt, GitHub exécute les Dependabot updates sur GitHub Actions.

  • Si GitHub Actions n’est pas activé pour le dépôt, GitHub génère des Dependabot alerts à l’aide de son application intégrée Dependabot.

Pour plus d’informations, consultez « À propos de Dependabot sur les exécuteurs GitHub Actions ».

Les Dependabot security updates peuvent corriger les dépendances vulnérables dans GitHub Actions. Lorsque les mises à jour de sécurité sont activées, Dependabot déclenche automatiquement une demande de tirage pour mettre à jour les GitHub Actions vulnérables utilisées dans vos workflows vers la version corrigée minimale. Pour plus d’informations, consultez À propos des mises à jour de sécurité Dependabot.

Qu’est-ce que les alertes Dependabot ?

Les Dependabot alerts mettent en évidence les dépôts affectés par une vulnérabilité nouvellement découverte en se basant sur le graphe des dépendances et sur la GitHub Advisory Database, qui contient les avis relatifs aux vulnérabilités connues.

  • Dependabot effectue une analyse pour détecter les dépendances non sécurisées et émet des Dependabot alerts quand :
    • Un nouvel avis est ajouté à la GitHub Advisory Database.
    • Le graphe de dépendances d’un dépôt change.
  • Les Dependabot alerts sont affichée sous l’onglet Sécurité du dépôt et dans le graphe des dépendances du dépôt. L’alerte contient un lien vers le fichier affecté dans le projet et des informations sur une version corrigée.

Pour plus d’informations, consultez « À propos des alertes Dependabot ».

Qu’est-ce que les mises à jour Dependabot ?

Il existe deux types de Dependabot updates : les mises à jour de version et les mises à jour de sécurité Dependabot. Dependabot génère des demandes de tirage automatiques pour mettre à jour vos dépendances dans les deux cas, mais il existe plusieurs différences.

Dependabot security updates :

  • Déclenchées par une alerte Dependabot
  • Mettent à jour les dépendances vers la version minimale qui résout une vulnérabilité connue
  • Prises en charge pour les écosystèmes pris en charge par le graphe de dépendances
  • Ne nécessite pas de fichier de configuration, mais vous pouvez en utiliser un pour remplacer le comportement par défaut

Dependabot version updates :

  • Requiert un fichier de configuration
  • Exécutées selon une planification que vous configurez
  • Mettent à jour les dépendances vers la dernière version qui correspond à la configuration
  • Prises en charge pour un autre groupe d’écosystèmes

Pour plus d’informations sur les Dependabot updates, consultez À propos des mises à jour de sécurité Dependabot et À propos des mises à jour de version Dependabot.

Qu’est-ce que les versions immuables ?

Les référentiels peuvent activer les versions immuables pour empêcher les ressources et la balise Git associée d’une version d’être modifiée après la publication. Cela réduit le risque d’attaques de chaîne d’approvisionnement en empêchant les attaquants d’injecter des vulnérabilités dans les versions que vous consommez. Cela signifie également que les projets qui s’appuient sur des versions spécifiques sont moins susceptibles de s’interrompre.

La création d’une version immuable génère automatiquement une attestation pour la version. Vous pouvez utiliser cette attestation pour vous assurer que la version et ses artefacts correspondent aux informations publiées.

Qu’est-ce que les attestations d’artefact ?

Les fournisseurs de logiciels peuvent générer des attestations pour les logiciels créés avec GitHub Actions. Les attestations sont des déclarations cryptographiquement signées qui établissent la provenance de la version (le code source et le workflow utilisé pour la générer) ou la liste des composants logiciels associée (SBOM).

Vous pouvez augmenter la sécurité de la chaîne logistique en vérifiant les attestations de vos dépendances. Bien que les attestations ne garantissent pas la sécurité, elles vous fournissent des informations sur l’emplacement et la façon dont les logiciels ont été créés, afin que vous ayez davantage confiance que vos dépendances n’ont pas été compromises. Vous pouvez gérer les déploiements à l’aide d’un outil comme le contrôleur d’admission Kubernetes pour empêcher le déploiement de builds non testées.

Lorsque vous utilisez GitHub Actions pour générer des attestations pour les propres builds de votre organisation, les artefacts générés sont automatiquement chargés sur le linked artifacts page. Cette plateforme vous permet d’afficher les enregistrements de stockage et de déploiement de tous les artefacts liés. Vous pouvez donc trouver le code source et l’exécution du flux de travail utilisés pour générer un artefact ou filtrer des alertes de sécurité en fonction du contexte de déploiement.

Disponibilité des fonctionnalités

Dépôts publics : * Graphe des dépendances : activé par défaut et ne peut pas être désactivé. * Révision des dépendances : activée par défaut et ne peut pas être désactivée. * Dependabot alerts : non activées par défaut. GitHub détecte les dépendances non sécurisées et affiche des informations dans le graphe de dépendances, mais ne génère pas d’Dependabot alerts par défaut. Les propriétaires de dépôts ou les personnes disposant d’un accès administrateur peuvent activer les Dependabot alerts. Vous pouvez également activer ou désactiver les alertes Dependabot pour tous les dépôts appartenant à votre compte d’utilisateur ou organisation. Pour plus d'informations, consultez Gestion des fonctionnalités de sécurité et d’analyse ou Gestion des paramètres de sécurité et d'analyse pour votre organisation. * Attestations d'artefact : Disponibles dans tous les référentiels publics, mais vous devez générer explicitement des attestations dans vos workflows de création. Consultez Utilisation d’attestations d’artefact pour établir la provenance des builds.

Dépôts privés : * Graphe des dépendances : non activé par défaut. La fonctionnalité peut être activée par les administrateurs de dépôt. Pour plus d’informations, consultez « Exploration des dépendances d’un dépôt ». * Révision des dépendances : Disponible dans les dépôts privés appartenant à des organisations qui utilisent GitHub Team ou GitHub Enterprise Cloud et disposent d’une licence pour GitHub Code Security or GitHub Advanced Security. Pour plus d’informations, consultez « À propos de GitHub Advanced Security » et « Exploration des dépendances d’un dépôt ». * Dependabot alerts : non activées par défaut. Les propriétaires de dépôts privés ou les personnes disposant d’un accès administrateur peuvent activer les Dependabot alerts en activant le graphe de dépendances et les Dependabot alerts pour leurs dépôts. Vous pouvez également activer ou désactiver les alertes Dependabot pour tous les dépôts appartenant à votre compte d’utilisateur ou organisation. Pour plus d'informations, consultez Gestion des fonctionnalités de sécurité et d’analyse ou Gestion des paramètres de sécurité et d'analyse pour votre organisation. * Attestations d’artefact : Disponible uniquement dans les référentiels privés sur GitHub Enterprise Cloud.

Tout type de dépôt : * Dependabot security updates : non activées par défaut. Vous pouvez activer les Dependabot security updates pour n’importe quel dépôt qui utilise les Dependabot alerts et le graphe de dépendances. Pour plus d’informations sur l’activation des mises à jour de sécurité, consultez Configuration des mises à jour de sécurité Dependabot. * Dependabot version updates : non activées par défaut. Les personnes disposant d’autorisations d’écriture sur un dépôt peuvent activer les Dependabot version updates. Pour plus d’informations sur l’activation des mises à jour de versions, consultez Configuration de mises à jour de version Dependabot. * Versions immuables :* Non activé par défaut. Vous pouvez activer l’immuabilité des versions pour un référentiel ou une organisation. Consultez Prévention des modifications de vos releases.