M202 : Sécuriser vos dossiers, équipes et permissions
Qui a le droit de faire quoi, et avec quel compte
Teams et permissions, compte technique, et une production que seul le compte de service peut atteindre.
Ce que vous allez faire
Une tâche automatisée ne doit jamais tourner avec le compte d'une personne. Vous réglez votre template pour qu'il utilise le compte technique, puis vous constatez que la mise en production est réservée au compte de service : vous-même ne pouvez pas la faire.
Votre point de départ
Vous travaillez sur votre template Deploy guestbook, ou sur Deploy guestbook (201 done). Les folders, les teams, le compte technique de Release et le compte de service Gitea svc-xlr-participant-N existent déjà.
Un seul compte par personne
La plateforme est branchée sur l'annuaire : vous restez connecté avec votre compte pendant toute la formation. Les droits se constatent depuis votre compte, dans Release et dans Gitea.
Les trois écrans de la sécurité
Release sépare ce qui est global à la plateforme de ce qui est local à un folder. On règle le premier une fois, dans Users & permissions ; on règle le second folder par folder, dans son onglet Teams & permissions. Les trois écrans, dans l'ordre où on les parcourt :
| Écran | Ce qu'on y fait | Sur votre plateforme |
|---|---|---|
| Users & permissions › Users | Créer les utilisateurs internes (gérés par Release) ou voir les utilisateurs externes (venus d'un annuaire). Un utilisateur n'a aucun droit tant qu'il n'est dans aucun role ni aucune team. | admin, Formateur (externe), CompteApplicatif, test |
| Users & permissions › Roles | Regrouper des utilisateurs dans des roles. Un role sert à porter des permissions globales et peut être mis dans une team. | admin (Formateur, admin), user, Authenticated Users |
| Users & permissions › Permissions | Donner aux roles les permissions globales : administrer la sécurité, créer des folders à la racine, voir les rapports, gérer les connexions partagées. Rien ici ne parle d'un template en particulier. | Le role admin a tout, le role user presque rien |
| Folder › Teams & permissions | Dans un folder : créer des teams (des utilisateurs et des roles), puis dans le tableau Folder permissions, cocher pour chaque action quelles teams ont le droit. Les actions sont groupées : Folders, Teams and permissions, Templates, Releases, Triggers, Delivery patterns, Dashboards. | Trois teams par défaut : Release Admin, Template Owner, Folder Owner, avec Formateur dedans |
La règle à retenir
Les droits se portent sur le folder. On ne donne jamais un droit à une personne sur un template : on met la personne dans une team du folder, et la team a des permissions sur tout ce que le folder contient. Un sous-folder hérite des teams et des permissions de son parent tant qu'on ne les redéfinit pas chez lui.
Les trois teams par défaut se répartissent les actions : Folder Owner édite le folder, ses variables, ses notifications, ses teams ; Template Owner voit et édite les templates, verrouille des tâches, édite les préconditions et les failure handlers ; Release Admin pilote les releases. Ces trois teams sont là par défaut : on ne peut ni les renommer ni les supprimer. On ajoute à côté ses propres teams, aux noms du métier, et on leur coche les actions dont elles ont besoin.
Compte technique contre compte personnel
| Compte | À qui il est | Ce qu'il fait | Où il se règle |
|---|---|---|---|
| Votre compte | Vous, par l'annuaire | Éditer les templates, démarrer les releases, cocher le gate | Les teams du folder |
| Le compte technique de Release | La plateforme | Exécuter les tâches automatisées de vos releases | Propriétés du template, Run automated tasks as user |
Le compte de service Gitea svc-xlr-participant-N | Votre instance Release | Merger vers main : le seul à en avoir le droit | Variable giteaToken du template |
Les branches du dépôt guestbook sont protégées. C'est ce cloisonnement qui oblige la mise en production à passer par Release.
| Branche | Environnement | Qui pousse | Qui merge |
|---|---|---|---|
dev | dev | Vous | Personne |
int | int, la recette | Personne | Vous |
main | prod | Personne | Le compte de service seulement |
Qui a le droit de faire quoi, et avec quel compte : votre compte annuaire agit via les teams du folder, le compte technique exécute les tâches automatisées, et seul le compte de service svc-xlr-participant-N atteint main.
La règle à retenir
Un compte technique par usage, avec les droits de cet usage et rien de plus. Le jour où une personne quitte l'équipe, aucune release ne s'arrête, et la History dit toujours qui a décidé et quel compte a exécuté.
Exercice 4.1 · Le compte technique, et ce que vous n'avez pas le droit de faire
30 minutes, chacun sur sa plateforme, sans changer de compte.
- Lire les droits du folder. Folder
Sandbox, onglet Teams & permissions. Repérez dans quelle team se trouve votre compte, et quelles actions sont cochées pour elle. - Régler le compte technique. Ouvrez votre template, Properties. Dans Run automated tasks as user, saisissez
${global.compte.applicatif.username}et, dans le mot de passe,${global.compte.applicatif.password}. Enregistrez. - Créer la variable du jeton. Menu Variables du template, New variable : nom
giteaToken, type Password, Required et Show on Create Release form décochés. Dans sa valeur, collez le jeton du compte de service que le formateur vous remet. Il est masqué dès l'enregistrement. - Préparer une modification. Dans Gitea, dépôt
guestbook, branchedev, ouvrezvalues.yamlavec le crayon. Remplaceztheme: clairpartheme: terminalet validez surdev. - Essayer de livrer en production vous-même. Toujours dans Gitea, New Pull Request de
devversmain. Créez-la, puis essayez de la merger. - Constater. Gitea refuse. Fermez la pull request sans la merger avec Close.
- Voir qui exécute. Dans Release, démarrez une release et laissez la phase dev se dérouler. Ouvrez History : relevez quel compte a démarré la release et quel compte a exécuté les tâches ArgoCD. Abandonnez ensuite la release.
Ce que vous devez observer
Gitea affiche que vous n'êtes pas autorisé à merger cette pull request. Dans la History, la release est démarrée par votre compte, les tâches automatisées sont exécutées par le compte technique.
Preuve attendue : le message de refus de Gitea, et les deux comptes relevés dans la History.
- Le template exécute ses tâches automatisées avec le compte technique.
- Le jeton du compte de service est dans
giteaToken, masqué. - Vous avez constaté que vous ne pouvez pas merger vers
main. - Votre modification du thème est sur
dev, prête pour la suite.
Support d'exercices de l'offre de service Digital.ai Release - Administration (ACOSS) (OFR0004). Le cas Nexapay est fictif et l'outil Redmine est simulé pour la formation. Une erreur, une suggestion ? Écris à William Gravier, wgravier@arvida.fr.