À propos de la vérification des dépendances
Une révision des dépendances vous aide à comprendre les changements de dépendances et l’impact de ceux-ci sur la sécurité à chaque demande de tirage. Cette fonctionnalité fournit une visualisation facilement compréhensible des changements de dépendances avec des différences enrichies sous l’onglet « Fichiers modifiés » d’une demande de tirage (pull request). Une révision des dépendances vous informe de ce qui suit :
- Dépendances ajoutées, supprimées ou mises à jour, ainsi que leurs dates de publication
- Nombre de projets utilisant ces composants
- Données de vulnérabilité pour ces dépendances
Certaines fonctionnalités supplémentaires, telles que les vérifications de licence, le blocage des demandes de tirage et l’intégration CI/CD, sont disponibles avec l’action Vérification des dépendances.
Vérifier si votre licence inclut Advanced Security
Vous pouvez identifier si votre entreprise dispose d’une licence pour Advanced Security les produits en examinant les paramètres de votre entreprise. Pour plus d’informations, consultez « Activer les produits GitHub Advanced Security pour votre entreprise ».
Prérequis à la vérification des dépendances
-
Une licence pour GitHub Code Security ou GitHub Advanced Security (voir GitHub Advanced Security facturation des licences).
-
Graphe des dépendances activé pour l’instance. Les administrateurs de site peuvent activer le graphe des dépendances via la console de gestion ou l’interpréteur de commandes d’administration (voir Activation du graphe de dépendances pour votre entreprise).
-
GitHub Connect permet de télécharger et de synchroniser des vulnérabilités depuis le GitHub Advisory Database. Cela est généralement configuré dans le cadre de la configuration Dependabot (voir Activation de Dependabot pour votre entreprise).
Activation et désactivation de la vérification des dépendances
Pour activer ou désactiver la vérification des dépendances, vous devez activer ou désactiver le graphe des dépendances pour votre instance.
Pour plus d’informations, consultez « Activation du graphe de dépendances pour votre entreprise ».
Exécution de la révision des dépendances à l’aide de GitHub Actions
Remarque
Le action de révision des dépendances est actuellement en préversion publique et peut être modifié.
L’action de révision des dépendances est incluse dans votre installation de GitHub Enterprise Server. Il est disponible pour tous les dépôts qui ont GitHub Code Security ou GitHub Advanced Security et pour lesquels le graphe de dépendances est activé.
action de révision des dépendances analyse vos demandes de tirage à la recherche de changements de dépendances et génère une erreur si les nouvelles dépendances présentent des vulnérabilités connues. L’action est prise en charge par un point de terminaison d’API qui compare les dépendances entre deux révisions et signale toutes les différences.
Pour plus d’informations sur l’action et le point de terminaison d’API, consultez dependency-review-action la documentation et Points de terminaison d’API REST pour la révision des dépendances.
Les utilisateurs exécutent l’action de révision des dépendances à l’aide d’un GitHub Actions flux de travail. Si vous n’avez pas encore configuré de runners pour GitHub Actions, vous devez le faire pour permettre aux utilisateurs d’exécuter des flux de travail. Vous pouvez provisionner des exécuteurs auto-hébergés au niveau du dépôt, de l’organisation ou du compte d’entreprise. Pour plus d’informations, consultez Exécuteurs auto-hébergés et Ajout d’exécuteurs auto-hébergés.