Formation Arvida›Digital.ai Release›Cas d'usage Nexapay›Module 202

Sommaire
ARVIDA OFFRE DE SERVICE Digital.ai Release · OFR0004-202

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.

Durée 1 h 30Exercice 30 minJour 1

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 :

ÉcranCe qu'on y faitSur votre plateforme
Users & permissions › UsersCré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 › RolesRegrouper 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 › PermissionsDonner 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 & permissionsDans 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 estCe qu'il faitOù il se règle
Votre compteVous, par l'annuaireÉditer les templates, démarrer les releases, cocher le gateLes teams du folder
Le compte technique de ReleaseLa plateformeExécuter les tâches automatisées de vos releasesPropriétés du template, Run automated tasks as user
Le compte de service Gitea svc-xlr-participant-NVotre instance ReleaseMerger vers main : le seul à en avoir le droitVariable 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.

BrancheEnvironnementQui pousseQui merge
devdevVousPersonne
intint, la recettePersonneVous
mainprodPersonneLe compte de service seulement
GLOBAL · USERS & PERMISSIONS · réglé une fois pour la plateforme Users Internes ou externes (annuaire). Aucun droit par eux-mêmes. Votre compte Formateur admin CompteApplicatif Votre compte vient de l'annuaire : vous restez connecté avec lui. Roles Groupes d'utilisateurs. Portent les permissions globales. adminFormateur, admin uservotre compte Authenticated Userstout utilisateur connecté Permissions Globales, données aux roles. Jamais sur un template. ▸ Admin : sécurité, utilisateurs, roles ▸ Créer des folders à la racine ▸ Voir les rapports, gérer les connexions ▸ Éditer les variables globales (compte applicatif) Role admin : tout. Role user : presque rien. membre de reçoit LOCAL · FOLDER SANDBOX · TEAMS & PERMISSIONS Teams Des users ou des roles. Trois par défaut, fixes. Les vôtres à côté. Folder OwnerFormateur Template OwnerFormateur Release AdminFormateur PAR DÉFAUT Votre teamvotre compte AJOUTÉE POUR VOUS Les droits se portent sur le folder : votre compte entre dans une team, la team a des permissions sur tout ce que le folder contient. Folder permissions Un tableau : une ligne par action, les teams cochées en face. FoldersView folder · Edit folder · Edit folder variables TeamsView · Edit teams and permissions TemplatesView · Edit · Create release · Lock task · Triggers ReleasesView · Start · Abort · Edit task · Task transition AutresDelivery patterns · Dashboards Votre teamView folder, View templates, Create release, View releases, Start release, Edit task, Task transition cochée sur votre compte entre dans une team un role peut aussi entrer dans une team GIT · BRANCHES PROTÉGÉES DU DÉPÔT GUESTBOOK · qui écrit, qui merge devenvironnement dev Vous poussez. Personne ne merge. intrecette Vous mergez vers int. Personne ne pousse directement. mainprod Seul svc-xlr-participant-N merge, appelé par la release après le gate Go/No Go. Dans Release, les droits passent par les teams du folder ; dans Gitea, main n'accepte que le compte de service.

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.

  1. 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.
  2. 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.
  3. 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.
  4. Préparer une modification. Dans Gitea, dépôt guestbook, branche dev, ouvrez values.yaml avec le crayon. Remplacez theme: clair par theme: terminal et validez sur dev.
  5. Essayer de livrer en production vous-même. Toujours dans Gitea, New Pull Request de dev vers main. Créez-la, puis essayez de la merger.
  6. Constater. Gitea refuse. Fermez la pull request sans la merger avec Close.
  7. 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.