GitHub Actions ! Ces petits bouts de YAML qui transforment nos dépôts en usines logicielles, automatisant tests, déploiements, et tout ce qui nous fait gagner un temps précieux. Je les utilise au quotidien pour mes projets Symfony et mes outils Homelab. Mais derrière cette magie se cache un risque souvent sous-estimé : la sécurité de notre chaîne d'approvisionnement logicielle.
Imaginez un instant : une action que vous utilisez, maintenue par un tiers, est compromise. Si vous ne la verrouillez pas, votre pipeline pourrait exécuter du code malveillant sans que vous ne vous en rendiez compte. C'est le genre de cauchemar qui me fait suer froid. C'est pourquoi je veux vous parler du "pinning", ou verrouillage, de vos actions GitHub. Une technique simple, mais redoutablement efficace pour renforcer la robustesse de vos déploiements.
Le risque des dépendances "flottantes" : une porte ouverte aux problèmes
Quand vous utilisez une action GitHub dans votre workflow, comme actions/checkout@v3, vous référencez en fait un tag. Ce tag, v3, est censé pointer vers la dernière version majeure de l'action. C'est pratique, car vous bénéficiez des correctifs et des améliorations sans rien faire. Mais c'est aussi un talon d'Achille.
Le problème ? Un mainteneur malveillant (ou compromis) pourrait déplacer le tag v3 pour qu'il pointe vers un commit contenant du code malicieux. Votre workflow, sans que vous ne le changiez d'un iota, se mettrait alors à exécuter ce nouveau code. C'est ce qu'on appelle une attaque par "repointing" de tags. Et croyez-moi, personne n'a envie de voir son serveur de production chiffré parce qu'une action de linter a été compromise.
Au-delà de la sécurité, il y a la stabilité. Combien de fois ai-je vu un build casser parce qu'une nouvelle version d'une action a introduit un changement "cassant" ou un bug ? En ne verrouillant pas vos actions, vous laissez votre pipeline à la merci des évolutions (bonnes ou mauvaises) des mainteneurs externes. Pour un CI/CD digne de ce nom, la reproductibilité est reine.
Les différentes méthodes de verrouillage : du SHA au tag
Heureusement, GitHub nous offre plusieurs façons de référencer nos actions. Certaines sont plus sûres que d'autres.
1. Le SHA de commit complet (le champion)
C'est la méthode que je recommande et celle que j'essaie d'appliquer partout où c'est possible. Un SHA de commit est un hachage unique de 40 caractères qui pointe vers une version exacte et immuable du code. Si le code change, le SHA change. Simple et efficace.
uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332
Avec ça, vous êtes absolument certain que votre workflow exécutera toujours le même code, celui que vous avez (en théorie) audité et approuvé. L'inconvénient, c'est que pour bénéficier des correctifs de sécurité ou des nouvelles fonctionnalités, il faut mettre à jour le SHA manuellement (ou via un bot, on y viendra).
2. Le tag de version (le compromis)
C'est la méthode la plus courante. Vous référencez l'action par un tag de version majeur (@v3) ou mineur (@v3.2.1).
uses: actions/setup-node@v3
L'avantage, c'est que vous recevez automatiquement les mises à jour (correctifs, petites évolutions) au sein de cette version majeure. L'inconvénient, comme je l'ai dit, c'est que les tags peuvent être déplacés par les mainteneurs, ouvrant la porte aux attaques par repointing.
3. La branche (à éviter comme la peste)
Référencer une action par une branche (@main ou @master) est la méthode la plus risquée.
uses: actions/checkout@main # À ÉVITER ABSOLUMENT
Le code de la branche main est le plus récent, le moins testé, et peut changer à tout moment, introduisant des bugs ou du code non vérifié. C'est l'assurance d'un pipeline instable et potentiellement dangereux. À proscrire pour tout workflow de production.
Mise en pratique : Verrouiller vos actions avec les bons outils
Verrouiller ses actions, c'est bien. Gérer ces verrouillages, c'est mieux. Personne n'a envie de passer sa vie à chercher des SHAs de commit et à les copier-coller. Heureusement, GitHub et la communauté ont pensé à nous.
La politique de verrouillage de GitHub
GitHub propose une fonctionnalité très utile au niveau de l'organisation ou du dépôt : la politique "Require actions to be pinned to a full-length commit SHA". En l'activant, vous forcez tous les workflows à utiliser des SHAs complets, bloquant les références par tag ou branche. C'est un excellent premier pas pour garantir la conformité.
Vous pouvez aussi restreindre les actions tierces autorisées, n'autorisant que celles de GitHub ou des créateurs vérifiés, ou même une liste explicite d'actions. Ça, c'est de la vraie sécurité !
Dependabot : le bot qui veille au grain
Dependabot, le fidèle bot de GitHub, est votre allié pour maintenir vos dépendances à jour, y compris vos actions GitHub. Il peut générer des pull requests pour mettre à jour les SHAs de commit de vos actions.
Pour l'activer, ajoutez simplement un fichier .github/dependabot.yml à la racine de votre dépôt :
version:
2updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
Dependabot va alors scanner vos workflows et vous proposer des PR pour mettre à jour les SHAs. C'est super pratique pour ne pas laisser vos actions vieillir.
gh actions-lock : la solution pour des lockfiles
C'est la découverte récente qui m'a vraiment emballé. L'extension gh actions-lock pour GitHub CLI est un game-changer. Elle permet de générer un fichier de verrouillage (.github/workflows/actions.lock) qui épingle chaque action utilisée dans vos workflows à un commit vérifié, y compris les dépendances transitives.
L'idée, c'est de conserver des références lisibles (par exemple, uses: actions/checkout@v3) dans vos fichiers de workflow YAML, mais d'exécuter en coulisses les commits exacts verrouillés dans le fichier .github/workflows/actions.lock. C'est le meilleur des deux mondes : lisibilité et sécurité.
Pour l'installer, si vous avez GitHub CLI :
gh extension install github/gh-actions-lock
Ensuite, pour générer le lockfile pour tous vos workflows :
gh actions-lock
Ou pour un workflow spécifique :
gh actions-lock .github/workflows/ci.yml
Le fichier actions.lock sera généré et contiendra les SHAs de commit pour chaque action. C'est une approche robuste qui permet de gérer la mutabilité des tags sans sacrifier la lisibilité de vos workflows. Si un tag est déplacé après la génération du lockfile, l'extension le détectera et vous demandera un --relock.
Pièges et limites : ce qu'il faut savoir
Même avec les meilleurs outils, il y a des subtilités à connaître :
- Mises à jour manuelles : Verrouiller à un SHA sans Dependabot ou
gh actions-locksignifie que vous devrez gérer les mises à jour à la main. C'est fastidieux et source d'oubli. - Dépendances transitives : Une action épinglée de niveau supérieur ne rend pas automatiquement les sous-actions sûres si celles-ci appellent des références mutables. L'extension
gh actions-lockgère ce point, ce qui est un gros avantage. - Actions locales : Les actions que vous référencez par un chemin local (
uses: ./mon-action/) ne sont pas gérées pargh actions-lock. Elles exécutent simplement le code présent dans votre dépôt au moment de l'exécution. Assurez-vous que votre propre code est sécurisé ! - Images de runner : L'image
ubuntu-latestévolue. Pour une reproductibilité maximale, il est préférable d'utiliser des versions spécifiques (ubuntu-22.04) ou d'exécuter vos jobs dans une image Docker conteneurisée que vous contrôlez entièrement.
Conclusion : La tranquillité d'esprit à portée de main
Verrouiller vos actions GitHub est une démarche simple, mais son impact sur la sécurité et la stabilité de vos pipelines CI/CD est colossal. Que vous optiez pour le SHA direct, que vous laissiez Dependabot gérer les mises à jour, ou que vous utilisiez l'approche plus sophistiquée des lockfiles avec gh actions-lock, l'important est d'agir.
Personnellement, je commence à intégrer gh actions-lock dans mes projets. L'idée de garder la lisibilité des tags dans le YAML tout en bénéficiant de la sécurité des SHAs via un lockfile est très séduisante. C'est le genre de petite amélioration qui, mise bout à bout, rend nos infrastructures et nos déploiements beaucoup plus robustes et nos nuits un peu plus calmes. Alors, à vos claviers, et verrouillez ces actions !