Le problème
Prenons une boutique en ligne en monorepo, pilotée par moon.
Les services Symfony order et
stock verrouillent leurs dépendances dans leur
composer.lock, le front Vue
shop dans le yarn.lock du
workspace. Chaque projet hérite d'une tâche
audit que la quality gate exige, comme le
décrit
notre article sur l'héritage de tâches moon.
Un matin, un avis de sécurité est publié sur un paquet
Symfony que order et
stock verrouillent tous les deux. La pull
request qui ajoute un champ à Reservation passe
au rouge sur l'audit, tout comme celle qui corrige un test
de order. Aucune des deux n'a touché une
dépendance.
L'audit n'est pas une vérification comme les autres. Le lint et les tests jugent le diff : même commit, même verdict. L'audit confronte un lockfile à une base d'avis qui change sans commit : le même commit, vert la veille, est rouge ce matin.
Sans routine, la journée tourne mal. Chacun relance son job
en espérant un faux positif, ou embarque un
composer update complet dans sa fonctionnalité.
Quelqu'un ajoute une exception sans date, puis la tâche
audit est désactivée
« temporairement ».
À côté, des alertes Dependabot visent un lockfile que plus rien ne lit. L'équipe apprend à ne plus les regarder.
Les options
Sortir l'audit de la quality gate
-
Ce qu'elle règle : chaque pull
request ne dépend plus que de son diff. Un job planifié
sur
mainpublie le rapport. - Ce qu'elle coûte : un rapport que personne n'est obligé de lire. Une fusion peut ajouter une dépendance vulnérable connue sans que rien ne la retienne.
N'auditer que ce que la pull request change
-
Ce qu'elle règle : le verdict
redevient fonction du diff. Sur GitHub,
dependency-review-actionéchoue si la pull request introduit une dépendance vulnérable. -
Ce qu'elle coûte : les
vulnérabilités déjà présentes sur
mainne bloquent plus rien. Sur un dépôt privé, l'action demande une licence GitHub Advanced Security.
Bloquer au-dessus d'un seuil de sévérité
-
Ce qu'elle règle : moins
d'interruptions.
yarn npm audit --severity high, ouignore-severitycôté Composer, laissent passer les avis mineurs. - Ce qu'elle coûte : la sévérité décrit le paquet, pas votre usage. Un avis moyen sur le parseur qui lit vos requêtes compte plus qu'un avis élevé dans un outil de build.
Garder l'audit bloquant, avec une routine de remédiation
-
Ce qu'elle règle : aucune
vulnérabilité connue ne reste sur
mainau-delà de la remédiation, et chaque exception est écrite. - Ce qu'elle coûte : une interruption imprévisible, à traiter vite, et une routine à connaître avant d'en avoir besoin.
Notre recommandation
Garder l'audit bloquant sur l'ensemble des lockfiles, et répondre à chaque avis par une pull request de remédiation dédiée et minimale, fusionnée en priorité.
Les pull requests bloquées ne se corrigent pas une par une. Une seule pull request, qui ne touche que les paquets signalés, les débloque toutes dès sa fusion. Quand aucune version corrigée n'existe, elle porte une exception datée à la place d'une mise à jour.
| Situation | Geste |
|---|---|
| Version corrigée permise par les contraintes |
mise à jour ciblée :
composer update -w -m,
yarn up -R
|
| Version corrigée hors de la plage d'un parent | résolution Yarn limitée à ce parent |
| Aucune version corrigée | exception motivée, avec une date de revue |
| Alerte sur un lockfile que rien ne lit | suppression du lockfile orphelin |
| Correctif publié il y a une heure | délai d'âge minimal, ou préapprobation de la version exacte |
Un paquet déprécié ou abandonné arrive lui aussi sans diff,
mais il n'expose à rien de neuf le jour où il est signalé.
Il ne bloque donc pas la gate : le rapport planifié sur
main le liste, et les mises à jour régulières
le traitent.
Nous écrivons cette routine dans le fichier d'instructions
du dépôt (AGENTS.md, CLAUDE.md).
Un agent de code la suit, au lieu de noyer un audit rouge
dans un composer update complet.
Les compromis assumés
Une pull request peut rester rouge pour une raison qui
lui est étrangère.
Nous l'acceptons, à condition que la remédiation passe avant
toute autre fusion. Le rouge dit une chose vraie :
main contient une vulnérabilité connue.
Une résolution impose une version que le parent n'a pas testée. Nous lisons ce que le parent appelle dans le paquet, puis nous lançons build et tests. La résolution disparaît dès qu'une version du parent accepte le correctif.
Une exception est un risque accepté. Elle dit pourquoi le code n'est pas exposé, et jusqu'à quand cette analyse vaut. Sans date, elle devient permanente par oubli.
Le délai d'âge retarde aussi les correctifs. Une version corrigée publiée il y a une heure est invisible pour l'installeur. Pour un avis urgent, nous préapprouvons cette version exacte, pas tout le paquet.
Le signal qui doit faire réexaminer ces choix : des remédiations qui traînent plusieurs jours, une
liste d'exceptions qui grossit, une tâche
audit contournée. Le seuil de sévérité ou
l'audit limité au diff redeviennent alors à évaluer.
Mise en œuvre
Les exemples utilisent Composer 2.10.2 ou plus récent, Yarn 4.18, Symfony 7.4 et moon 2.
1. Une tâche audit par projet, sans cache
Notre article sur l'héritage de tâches moon
définit la tâche audit : héritée de
.moon/tasks/, sans cache. Sur une pull request,
elle ne tourne que dans les projets affectés. Avec
runInCI: always, qui audite tous les projets,
la remédiation devrait corriger Composer et Yarn s'ils sont
touchés ensemble, sinon elle resterait rouge.
Par défaut, yarn npm audit ne regarde que les
dépendances directes du workspace ;
--recursive ajoute les transitives. Yarn 4
signale aussi les paquets dépréciés, au niveau
« moderate », et
--no-deprecations les sort de la gate. Côté
Composer, --abandoned=report, que nous ajoutons
à composer audit --locked, fait de même pour
les paquets abandonnés.
2. Une remédiation Composer minimale
# services/order : mettre à jour les seuls paquets signalés
packages=$(composer audit --locked --format=json | jq -r '.advisories | keys | join(" ")')
# Liste vide : ne rien lancer, un composer update sans argument met tout à jour
[ -n "$packages" ] && composer update $packages --with-dependencies --minimal-changes
composer audit --locked
Le JSON de composer audit range les avis par
nom de paquet.
--with-dependencies (-w) autorise
la mise à jour de leurs dépendances, sauf celles que
composer.json exige directement.
--minimal-changes (-m, Composer
2.7) ne les modifie que si c'est indispensable.
Les paquets listés montent à la dernière version permise ;
avec Flex,
extra.symfony.require (7.4.*) les
garde dans la version mineure. Pendant un
update, Composer refuse aussi par défaut une
version visée par un avis :
audit.block-insecure depuis la 2.9,
policy.advisories.block depuis la 2.10.
Nous lançons la même commande dans stock :
les deux services finissent sur les mêmes versions, dans la
même pull request. Le diff des lockfiles se limite aux
paquets signalés et à ce qu'ils exigent : il se relit
vite.
3. Côté Yarn : yarn up -R, puis une
résolution limitée au parent
# Racine du workspace : qui tire le paquet, puis re-résoudre toutes ses plages
yarn why vulnerable-lib -R
yarn up -R vulnerable-lib
yarn npm audit --all --recursive
yarn dedupe --check
Le rapport de Yarn donne, pour chaque avis, son identifiant
numérique (ID), l'URL de l'avis GitHub et les
paquets qui en dépendent. yarn up -R re-résout
toutes les plages qui visent le paquet, souvent vers la plus
haute version permise, et n'écrit que dans le
yarn.lock. Si un parent exige encore
^3.0.0 alors que le correctif n'existe qu'en 4,
la commande ne peut rien.
Il faut alors une résolution, limitée au parent :
// package.json (racine du workspace, extrait)
{
"resolutions": {
"parent-plugin/vulnerable-lib": "^4.0.1"
}
}
Cette clé ne remplace que la copie tirée par
parent-plugin. Une clé globale,
vulnerable-lib seule, remplacerait aussi les
copies d'une autre version majeure, dont l'API peut
différer. Yarn accepte un seul niveau de précision :
parent/dep, éventuellement avec la version du
parent.
Avant la fusion, nous vérifions que l'API appelée par le
parent n'a pas changé, puis
moon run shop:build shop:test fait le reste. Le
package.json n'accepte pas de
commentaire : la raison et la condition de retrait vont
dans la description de la pull request.
4. Aucune version corrigée : une exception datée
// services/order/composer.json (extrait)
{
"config": {
"policy": {
"advisories": {
"ignore-id": {
"GHSA-xxxx-xxxx-xxxx": "Aucune version corrigée. La fonction visée ne lit que notre configuration, jamais une entrée externe. Revue le 2027-01-31."
}
}
}
}
}
Le bloc policy (Composer 2.10) accepte un
identifiant GHSA, CVE ou Packagist (PKSA), avec une raison
libre. Depuis la 2.11, il entre dans l'empreinte du
composer.lock :
composer update --lock accompagne l'exception.
Yarn, lui, n'accepte qu'une liste d'identifiants :
# .yarnrc.yml (extrait)
npmAuditIgnoreAdvisories:
# unmaintained-lib <= 2.3.1 (GHSA-xxxx-xxxx-xxxx, low) : aucune version corrigée.
# Seul parent : un plugin de build qui ne fusionne que ses propres valeurs.
# Revue le 2027-01-31, ou dès qu'une version corrigée sort.
- '1234567'
Yarn compare cette liste à l'identifiant numérique que renvoie le registre npm, jamais au GHSA. Le commentaire garde donc les deux. Une revue planifiée relit les dates :
#!/usr/bin/env sh
# tools/audit-exceptions-due.sh : échoue si une exception a atteint sa date de revue
set -eu
today=$(date +%F)
due=$(grep -hoE 'Revue le [0-9]{4}-[0-9]{2}-[0-9]{2}' .yarnrc.yml services/*/composer.json \
| awk -v today="$today" '$3 <= today { print $3 }')
if [ -n "$due" ]; then
echo "Exceptions d'audit à revoir : $due"
exit 1
fi
Ce script tourne dans le job planifié sur main,
pas dans la gate. Une date dépassée y rendrait rouges toutes
les pull requests le même jour : exactement le problème
de départ.
5. Chasser les lockfiles orphelins
Le graphe de dépendances de GitHub reconnaît
package-lock.json, yarn.lock et
composer.lock, et Dependabot alerte sur ce
qu'ils déclarent. Un package-lock.json oublié
dans un front géré par Yarn ne sert à aucune installation,
mais produit des alertes. À l'inverse, le lockfile d'un
outil sans tâche audit cache de vraies
vulnérabilités à la gate.
#!/usr/bin/env sh
# tools/check-lockfiles.sh : chaque lockfile suivi doit être lu par une tâche audit
set -eu
unexpected=$(git ls-files '*composer.lock' '*package-lock.json' '*pnpm-lock.yaml' '*yarn.lock' \
| grep -vxE 'yarn\.lock|services/[a-z-]+/composer\.lock' || true)
if [ -n "$unexpected" ]; then
echo "Lockfiles sans tâche audit : $unexpected"
exit 1
fi
Ce contrôle dépend du diff : il a sa place dans la gate. Chaque fichier signalé est supprimé si rien ne le lit, ou rattaché à un projet qui l'audite. Dependabot ne marque l'alerte comme corrigée qu'après une modification sur la branche par défaut, donc après la fusion.
6. Un délai d'âge minimal, et une porte pour les correctifs
# .yarnrc.yml (extrait)
npmMinimalAgeGate: 3d
npmPreapprovedPackages:
# Correctif de GHSA-xxxx-xxxx-xxxx, publié avant la fin du délai.
# Revue le 2027-01-31 : retirer une fois le délai passé.
- '[email protected]'
npmMinimalAgeGate (Yarn 4.10.0, 18 septembre
2025) écarte toute version plus jeune que ce délai. Depuis
Yarn 4.15.0 (19 mai 2026), il vaut un jour par défaut, mais
un projet existant garde l'ancien comportement à la montée
de version. Nous l'écrivons donc, avec trois jours :
les 72 heures pendant lesquelles npm permet de dépublier un
nouveau paquet.
Le revers : un correctif plus jeune que le délai est
invisible, et yarn up -R garde la version
vulnérable. npmPreapprovedPackages exempte une
version exacte (paquet@version), de façon
visible dans le dépôt ; --no-time-gate (Yarn
4.15) lève le délai pour une seule commande. Côté PHP,
Composer 2.11.0 (29 octobre 2026) ajoute une politique
cooldown, avec des exceptions par paquet et
l'option --no-cooldown.
7. Débloquer les pull requests en attente
Une fois la remédiation fusionnée, relancer le job d'une
pull request bloquée ne suffit pas. GitHub rejoue le même
GITHUB_SHA, le commit de fusion calculé avant
le correctif. Il faut mettre la branche à jour, par fusion
de main ou rebase.
Si la branche modifie elle aussi un lockfile, nous rejouons
sa commande (composer require,
yarn add) après le rebase. Résoudre le conflit
à la main produit un lockfile que personne n'a calculé.
Checklist
-
Une tâche
auditpar projet, sans cache, exigée par la quality gate. -
Les paquets dépréciés ou abandonnés signalés sans bloquer
(
--no-deprecations,--abandoned=report). - Une pull request de remédiation dédiée, fusionnée avant les autres.
-
Des mises à jour ciblées :
composer update <paquets> -w -m,yarn up -R <paquet>. - Des résolutions limitées à leur parent, retirées dès que le parent suit.
- Des exceptions motivées et datées : GHSA ou CVE pour Composer, identifiant numérique npm pour Yarn.
- Une revue planifiée des dates d'exception, hors de la gate.
-
Chaque lockfile suivi lu par une tâche
audit, contrôlé à chaque pull request. - Un délai d'âge minimal explicite, et la préapprobation d'une version exacte pour un correctif urgent.
-
Les branches bloquées mises à jour depuis
main, pas seulement relancées.
Sources
Versions relevées le 15 novembre 2026 : Composer 2.11.2, Yarn 4.18.1.
-
Composer, commandes
audit
et
update
(
-w,-m,--lock,--no-cooldown), configurationpolicy(ignore-id,abandoned,cooldown). -
Composer,
journal des versions :
--minimal-changesen 2.7.0 (8 février 2024), blocage des versions vulnérables en 2.9.0 (13 novembre 2025), blocpolicyen 2.10.0 (28 mai 2026),cooldownetpolicydans l'empreinte du lockfile en 2.11.0 (29 octobre 2026). -
Symfony,
Upgrading a Minor Version :
extra.symfony.require. -
Yarn,
yarn npm audit
et son
code source :
idnumérique, dépréciations au niveau « moderate ». -
Yarn,
yarn up
(
-R,--no-time-gate), yarn why, yarn dedupe etresolutions. -
Yarn,
réglages
.yarnrc.yml, versions 4.10.0 et 4.15.0, pull request 7135 (délai d'un jour par défaut). -
npm,
Unpublish policy ; moon,
configuration de projet
(
cache,runInCI). -
GitHub,
Dependabot alerts,
événement
dependabot_alert(fixed) et écosystèmes du graphe de dépendances. -
GitHub,
dependency-review-action,
événement
pull_requestet relancer un workflow. - Lychen, pull requests 240, 244, 246, 252 et 258 : une mise en œuvre open source de cette routine de remédiation, dans un monorepo moon.