À 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 **
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 Dependabot security updates et les Dependabot version updates nécessitent GitHub Actions pour s’exécuter sur GitHub Enterprise Server. Les Dependabot alerts ne nécessitent pas GitHub Actions. Pour plus d’informations, consultez « Activation de Dependabot pour votre entreprise ».
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 :
- Les nouvelles données d’avis sont synchronisées avec votre instance chaque heure depuis GitHub.com. Pour plus d’informations, consultez « Exploration des avis de sécurité dans la base de données GitHub Advisory ».
- 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
-
**Graphe des dépendances et Dependabot alerts :** non activés par défaut. Les deux fonctionnalités sont configurées au niveau de l’entreprise par le propriétaire de l’entreprise. Pour plus d’informations, consultez « [AUTOTITLE](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise) » et « [AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise) ». -
**Révision des dépendances :** disponible lorsque le graphe des dépendances est activé pour votre instance et que GitHub Code Security or GitHub Advanced Security est activé pour l’organisation ou le dépôt. Pour plus d’informations, consultez « [AUTOTITLE](/get-started/learning-about-github/about-github-advanced-security) ». -
**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 [AUTOTITLE](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates). -
**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 [AUTOTITLE](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates).