CODEOWNERS : imposer une revue sur vos workflows

Un fichier CODEOWNERS déclare qui doit relire quoi. Appliqué à .github/workflows/, c'est le contrôle de gouvernance qui rapporte le plus pour le moins d'effort : il ferme le chemin d'attaque le plus direct, celui du workflow ajouté ou modifié sans relecture compétente.

Ce que vous allez apprendre

• Écrire un CODEOWNERS correct et comprendre sa règle de précédence
• Protéger spécifiquement le répertoire des workflows
• Activer l'exigence de revue, sans laquelle le fichier n'est qu'indicatif
• Anticiper la limite de l'auto-approbation sur un dépôt à mainteneur unique

Pourquoi ce répertoire avant tous les autres

Une modification de .github/workflows/ ne se lit pas comme une modification de code applicatif. Elle peut accorder des permissions, atteindre des secrets, publier un artefact, ou s'exécuter sur votre infrastructure. Un relecteur qui valide une pull request applicative sans regarder le workflow qui l'accompagne laisse passer le changement le plus lourd de conséquences.

L'incident GhostAction de septembre 2025 illustre exactement ce chemin : aucune faille de workflow exploitée, seulement un workflow malveillant commité dans des dépôts dont les attaquants avaient pris le contrôle. Une revue obligatoire sur ce répertoire, par des personnes qui savent lire un permissions:, transforme cette opération silencieuse en demande visible.

Écrire le fichier

CODEOWNERS se place à la racine, dans .github/, ou dans docs/. La convention la plus lisible est .github/CODEOWNERS, à côté de ce qu'il protège.

.github/CODEOWNERS

# Propriétaires par défaut de tout le dépôt
*                       @mon-org/mainteneurs

# La CI et sa configuration : revue par l'équipe sécurité
/.github/workflows/     @mon-org/securite @mon-org/mainteneurs
/.github/actions/       @mon-org/securite
/.github/dependabot.yml @mon-org/securite
/.github/CODEOWNERS     @mon-org/securite

# La chaîne de build : même exigence
/Dockerfile             @mon-org/securite
/requirements*.txt      @mon-org/securite

Trois points de syntaxe suffisent à éviter les erreurs courantes :

• La dernière règle qui correspond gagne. Contrairement à .gitignore, l'ordre est décisif : placez les règles générales en haut, les spécifiques en bas. Une ligne * placée en dernier annulerait tout le reste.
• Un chemin qui commence par / est ancré à la racine. Sans la barre initiale, le motif correspond à n'importe quel niveau de l'arborescence.
• Les propriétaires sont des comptes (@utilisateur), des équipes (@org/equipe) ou des adresses de courriel. Une équipe doit avoir un accès en écriture au dépôt pour être un propriétaire valide, sinon la ligne est ignorée en silence.

Protégez le fichier par lui-même

La ligne /.github/CODEOWNERS @mon-org/securite n'est pas une coquetterie. Sans elle, quiconque peut modifier le dépôt peut se déclarer propriétaire de .github/workflows/ et s'auto-attribuer la revue qu'il devait subir. Le fichier qui définit la gouvernance doit être couvert par cette gouvernance.

Le fichier seul ne bloque rien

C'est le malentendu le plus fréquent. CODEOWNERS désigne des relecteurs et déclenche automatiquement une demande de revue. Il n'impose rien.

Pour qu'il morde, il faut activer l'exigence correspondante dans le ruleset ou la protection de branche :

REPO=mon-org/mon-projet

# Vérifier que la revue code owner est bien exigée
gh api "repos/$REPO/rulesets/RULESET_ID" \
  --jq '.rules[] | select(.type=="pull_request") | .parameters.require_code_owner_review'

La réponse attendue est true. Sur false, votre CODEOWNERS est une suggestion : les relecteurs sont notifiés, la fusion passe sans eux.

Vérifiez également que le fichier est syntaxiquement valide. GitHub affiche les erreurs dans l'interface, onglet Code owners des réglages du dépôt, et une ligne invalide est ignorée sans avertissement dans les pull requests. Une équipe mal orthographiée, ou sans droit d'écriture, produit exactement l'effet d'une protection absente.

La limite du dépôt à mainteneur unique

Un fait de GitHub structure toute la suite : on ne peut pas approuver sa propre pull request. Aucune configuration ne lève cette règle.

Sur un dépôt où une seule personne contribue, exiger la revue code owner rend donc la fusion impossible par construction : l'auteur est le seul propriétaire, et il ne peut pas s'approuver. Trois sorties existent, à choisir en connaissance de cause.

Sortie	Ce qu'elle coûte
Désigner un second relecteur réel	Une dépendance à sa disponibilité
Inscrire le rôle administrateur dans la bypass list du ruleset	Le contrôle devient déclaratif pour vous
Réserver l'exigence aux chemins sensibles	Les workflows restent protégés, le reste circule

Glissez pour voir

La troisième est la plus souvent pertinente, et elle est peu connue : rien n'oblige à couvrir tout le dépôt. Un CODEOWNERS limité à .github/workflows/, au Dockerfile et aux fichiers de dépendances protège ce qui compte, tout en laissant le code applicatif suivre un circuit normal.

.github/CODEOWNERS, version ciblée

# Rien sur '*' : le code applicatif ne demande pas de revue code owner
/.github/workflows/     @mon-org/securite
/.github/CODEOWNERS     @mon-org/securite
/Dockerfile             @mon-org/securite

Le relecteur doit savoir quoi regarder

Désigner une équipe ne suffit pas si elle ne sait pas lire un workflow. Les six points bloquants tiennent en une ligne chacun : permissions explicites et minimales, actions épinglées par SHA, aucune donnée externe interpolée dans un run:, secrets passés par env:, pas de pull_request_target dangereux, timeout-minutes défini. C'est le contenu de la checklist sécurité, et elle gagne à être collée dans le gabarit de pull request.

Vérifier que le dispositif fonctionne

Un contrôle de gouvernance qu'on n'a jamais vu se déclencher n'est pas un contrôle, c'est une intention. Le test tient en quatre gestes :

# Sur une branche de test, modifier un workflow
git switch -c test-codeowners
printf '\n# test\n' >> .github/workflows/ci.yml
git commit -am "test: vérifier la revue code owner"
git push -u origin test-codeowners

gh pr create --fill
gh pr view --json reviewRequests --jq '.reviewRequests'

La sortie doit nommer les propriétaires déclarés, et la pull request doit afficher la revue comme requise, pas seulement demandée. Supprimez la branche ensuite.

Contrôle de connaissances

Vérifiez que l'essentiel de ce guide est acquis. Les questions portent uniquement sur ce qui vient d'être expliqué ici.

Contrôle de connaissances

Validez vos connaissances avec ce quiz interactif

6 questions

6 min.

70% requis

Informations

• Le chronomètre démarre au clic sur Démarrer
• Questions à choix multiples, vrai/faux et réponses courtes
• Vous pouvez naviguer entre les questions
• Les résultats détaillés sont affichés à la fin

Démarrer le quiz

Lance le quiz et démarre le chronomètre

À retenir

• .github/workflows/ est le répertoire dont une modification a le plus de conséquences : permissions, secrets, publication, infrastructure.
• GhostAction n'a exploité aucune faille de workflow, seulement l'absence de revue sur l'ajout d'un fichier de workflow.
• Dans CODEOWNERS, la dernière règle qui correspond gagne : les motifs généraux vont en haut, les spécifiques en bas.
• Une équipe propriétaire doit avoir un accès en écriture, sinon la ligne est ignorée en silence.
• Couvrez le fichier CODEOWNERS lui-même, faute de quoi n'importe qui peut se déclarer propriétaire de ce qu'il devait faire relire.
• Le fichier seul ne bloque rien : l'exigence require_code_owner_review doit être active dans le ruleset.
• On ne peut pas approuver sa propre pull request : sur un dépôt à mainteneur unique, prévoyez un second relecteur, une bypass list, ou une couverture limitée aux chemins sensibles.

Pour aller plus loin

• Runner groups et frontière réseau : Le contrôle qui borne ce qu'une exécution compromise atteint, quand la revue a laissé passer.
• GitHub CLI (gh) : L'outil qui permet de vérifier en une commande que la revue est réellement exigée, et pas seulement demandée.
• ActionLint : Le contrôle automatique qui allège la revue humaine en écartant d'emblée les erreurs de syntaxe.

×

📖 Voir la documentation →