Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Les droits minimaux d'un travail

Les droits minimaux d'un travail

Secrets et sécurité de la chaîneavance

Chaque travail de GitHub Actions reçoit un jeton de chaîne créé pour lui, valable le temps du travail. La question n'est pas de le protéger — il expire seul — mais de décider ce qu'il a le droit de faire.

permissions:
  contents: read

jobs:
  tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test

Ce bloc n'est pas additif. Déclarer contents: read met tous les autres droits à none. Une ligne ferme donc tout le reste.

Le réglage juste est par travail

Travail Droits nécessaires
Tests contents: read
Commentaire automatique sur une proposition pull-requests: write
Publication d'une version contents: write
Déploiement via identité fédérée id-token: write, contents: read

Un flux qui déclare contents: write en tête donne ce droit d'écriture à son travail de tests, qui n'en fera rien — sauf si quelque chose d'inattendu s'exécute pendant ces tests.

La proposition venue d'un fork

Un flux déclenché par pull_request depuis un fork s'exécute avec un jeton en lecture seule et sans accès aux secrets. C'est voulu : du code proposé par un inconnu tourne, et il n'a rien à sa portée.

Les termes à connaître

Jeton de chaîne

Identifiant créé automatiquement pour la durée d'un travail, qui lui permet d'agir sur le dépôt. Il expire à la fin du travail et n'a pas besoin d'être stocké.

permissions

Bloc déclaratif qui fixe les droits du jeton de chaîne, au niveau du flux ou d'un travail. Déclarer un seul droit met implicitement tous les autres à none.

Moindre privilège

Accorder exactement les droits nécessaires à la tâche, et rien de plus. Appliqué ici travail par travail, parce que tous les travaux d'un flux n'ont pas les mêmes besoins.

pull_request_target

Déclencheur qui exécute le flux dans le contexte du dépôt d'accueil, avec accès aux secrets, pour une proposition venue d'un fork. Il demande une prudence particulière sur ce qu'il récupère.

Jeton de travail GitLab

Équivalent GitLab, émis pour la durée du travail. Son périmètre se règle par une liste de projets autorisés plutôt que par un bloc de droits détaillés.

Approbation d'environnement

Règle attachée à un environnement qui suspend le travail jusqu'à validation humaine. Le seul contrôle qui introduit une personne dans la boucle avant un déploiement.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.