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.
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.