Une décision plus lourde qu’elle n’en a l’air
Vos collègues peuvent se connecter. Reste à décider où vont vivre les dépôts et qui a le droit de quoi.
Cela ressemble à une formalité. Ça n’en est pas une, pour une raison très concrète : l’organisation apparaît dans l’URL de chaque dépôt.
https://forge.nordika.local/infrastructure/scripts-powershell.git
└──────┬──────┘
l'organisation
Et cette URL, vous allez la semer partout. Dans le lanceur de vos stratégies de groupe en section 7. Dans vos scripts d’amorçage Linux en section 8. Dans les références d’images de vos fichiers Compose en section 10. Dans la configuration de Semaphore en section 12.
Renommer une organisation trois mois plus tard, ce n’est donc pas cliquer sur un bouton : c’est reprendre tout ce qui précède. Prenez quinze minutes maintenant.
Le modèle de Forgejo
Quatre niveaux, empilés simplement.
ORGANISATION ──── « infrastructure »
│
├── ÉQUIPES ──── Owners · Administrateurs · Lecteurs
│ │
│ └── contient des UTILISATEURS
│
└── DÉPÔTS ──── scripts-powershell · stacks-docker · docs
L’utilisateur est une personne. Il peut posséder ses propres dépôts.
L’organisation est un propriétaire collectif. Les dépôts lui appartiennent, pas à une personne.
L’équipe regroupe des utilisateurs et porte des droits sur des dépôts de l’organisation. C’est le seul endroit où l’on attribue des permissions.
Le dépôt appartient soit à un utilisateur, soit à une organisation.
Le piège n°1 : le dépôt personnel
C’est l’erreur que fait tout le monde au démarrage, y compris moi.
Vous êtes connecté, vous créez un dépôt, il atterrit sous votre compte :
https://forge.nordika.local/romain.dupont/scripts-powershell.git
Ça fonctionne parfaitement. Et vous venez de créer trois problèmes.
Le dépôt vous appartient personnellement. Le référentiel de scripts de l’entreprise est la propriété d’un individu. Ce n’est pas une subtilité juridique, c’est un problème d’exploitation : le jour où vous partez, où votre compte est désactivé par la synchronisation de l’annuaire, ou simplement où vous êtes en congé, personne n’a la main.
Votre nom est dans l’URL. Cette URL sera inscrite dans les GPO qui s’exécutent sur deux cents postes. Le jour où le dépôt change de mains, tout casse.
Les droits se gèrent à la main, collaborateur par collaborateur, dépôt par dépôt. À trois dépôts c’est supportable, à trente c’est ingérable.
La règle est donc simple : aucun dépôt de travail sous un compte personnel. Les dépôts personnels servent aux essais et aux bacs à sable. Tout le reste appartient à une organisation.
Découper ses organisations
Trois modèles possibles.
Par service — infrastructure, developpement, support. Simple, aligné sur l’organigramme, et donc naturellement compatible avec vos groupes d’annuaire.
Par nature de contenu — scripts, stacks, images, documentation. Aligné sur les quatre patterns de la formation, mais tend à disperser des choses qui vont ensemble.
Par projet ou par client — pertinent en ESN ou en infogérance, peu adapté à une DSI interne.
Ma recommandation
Peu d’organisations, découpées selon qui doit y accéder.
C’est le critère qui compte : deux contenus lus par les mêmes personnes n’ont pas besoin d’organisations distinctes. Deux contenus dont les publics diffèrent en méritent.
Pour une PME comme Nordika, deux organisations suffisent au démarrage :
| Organisation | Contenu | Qui y accède |
|---|---|---|
infrastructure |
Scripts, stacks Docker, configurations, documentation d’exploitation | L’équipe informatique |
public-interne |
Uniquement ce qui doit être lisible sans authentification (§7) | Tout le monde, en lecture |
La seconde mérite une explication, et elle fait le lien avec la leçon suivante : les scripts distribués par GPO doivent pouvoir être récupérés par des machines qui ne s’authentifient pas. Les isoler dans une organisation dédiée permet de leur appliquer une visibilité différente sans exposer le reste.
Vous ajouterez d’autres organisations quand un besoin réel apparaîtra. Il est facile d’en créer une nouvelle ; il est coûteux de découper après coup.
Nommer
Le nom entre dans toutes vos URL. Trois règles :
- En minuscules, sans accent, sans espace — les URL n’aiment ni les majuscules ni les caractères composés.
- Court — vous le taperez souvent.
- Fonctionnel plutôt qu’organisationnel —
infrastructuresurvivra mieux qu’un nom de direction, qui changera au prochain organigramme.
Les équipes et les niveaux d’accès
Une organisation fraîchement créée contient une équipe Owners, dont vous êtes membre. Elle a tous les droits, y compris celui de supprimer l’organisation.
Vous en créerez d’autres, chacune combinant trois éléments : des membres, un périmètre de dépôts, et un niveau d’accès.
Le périmètre
Une équipe porte soit sur tous les dépôts de l’organisation, soit sur une sélection. Le premier cas est plus simple à maintenir, le second plus fin. Commencez par le premier, affinez si le besoin apparaît.
Le niveau d’accès
| Niveau | Ce qu’il permet |
|---|---|
| Lecture | Cloner, consulter, ouvrir un ticket, commenter |
| Écriture | Pousser, créer des branches, fusionner |
| Administration | Gérer les paramètres, les branches protégées, les webhooks |
| Owners | Tout, plus la gestion de l’organisation elle-même |
Forgejo permet en outre de régler les droits par unité : le code, les tickets, les pull requests, les versions, les paquets, le wiki. Vous pouvez ainsi autoriser une équipe à ouvrir des tickets sans lui donner accès au code.
C’est utile dans un cas précis que vous rencontrerez : donner à des collègues hors informatique la possibilité de signaler un problème sur un script, sans leur ouvrir le référentiel.
La règle d’or
Les droits s’attribuent à des équipes, jamais à des personnes.
Ajouter un collaborateur directement sur un dépôt semble plus rapide sur le moment. Mais six mois plus tard, personne ne sait plus qui a accès à quoi, et le jour du départ, il faut faire le tour de tous les dépôts.
Avec des équipes, la question « à quoi a accès Untel ? » se répond en un écran.
Une matrice de départ
Voici une structure qui fonctionne pour une équipe informatique de trois à dix personnes.
| Équipe | Membres | Périmètre | Niveau |
|---|---|---|---|
Owners |
2 personnes maximum | Tous | Propriétaire |
admins-si |
L’équipe infrastructure | Tous | Administration |
techniciens |
Support de niveau 1 et 2 | Tous | Écriture |
lecteurs |
Autres services concernés | Sélection | Lecture |
Deux propriétaires, pas un. Le compte d’administration local créé en 2.4, plus votre compte nominatif. C’est votre filet de sécurité en cas d’indisponibilité de l’un des deux.
Pas tout le monde en administration. La différence entre écriture et administration est celle qui vous permettra, en section 14, de protéger les branches — et de faire en sorte que personne ne contourne cette protection.
La correspondance automatique avec l’annuaire
Voici la partie qui transforme une configuration confortable en configuration qui se maintient toute seule.
L’idée : un utilisateur ajouté au groupe « Informatique » de votre annuaire se retrouve automatiquement dans l’équipe correspondante de Forgejo, sans intervention de votre part. Et retiré du groupe, il en sort.
Où cela se configure
Dans la source d’authentification créée en 2.6 ou 2.7, un champ permet de déclarer une correspondance entre les groupes reçus et les équipes de vos organisations. Il attend une structure au format JSON, sur ce principe :
{
"Forge-Admins": { "infrastructure": ["admins-si"] },
"Forge-Techniciens": { "infrastructure": ["techniciens"] },
"Forge-Lecteurs": { "infrastructure": ["lecteurs"] }
}
À gauche, le groupe tel qu’il arrive dans le jeton ou dans l’annuaire. À droite, l’organisation et la ou les équipes correspondantes.
Le format de la clé de gauche diffère selon la source : en OIDC, c’est le nom du groupe tel que le transmet votre IdP ; en LDAP, c’est généralement le DN complet du groupe. Vérifiez sur votre instance avant de bâtir une correspondance complète — un test avec un seul groupe vous fera gagner du temps.
L’option qui compte
Une case associée permet de retirer les utilisateurs des équipes synchronisées lorsqu’ils ne sont plus membres du groupe correspondant.
Activez-la. Sans elle, la correspondance ne fait qu’ajouter : un collaborateur qui change de service conserve ses accès indéfiniment. Avec elle, la sortie du groupe vaut retrait des droits — ce qui est précisément le comportement attendu.
Ce que ça vous apporte
Le jour où un technicien rejoint l’équipe, vous n’avez rien à faire dans Forgejo. Le jour où il part, non plus. La gestion des accès à la forge redevient ce qu’elle doit être : une conséquence de la gestion des comptes, pas une tâche supplémentaire.
C’est aussi ce qui rend votre configuration auditable : la réponse à « qui a accès à la forge ? » est « les membres de tel groupe », et non « il faudrait que je regarde ».
Les pièges à connaître
Renommer une organisation casse les URL. Forgejo met généralement en place une redirection, mais ne comptez pas dessus pour des URL inscrites dans des GPO ou des scripts. Traitez le nom comme définitif.
Déplacer un dépôt d’une organisation à une autre produit le même effet. C’est faisable, mais c’est une opération à planifier, pas à improviser.
Un dépôt personnel dont le compte est désactivé devient difficile d’accès. Raison de plus pour n’en avoir aucun d’important.
Les membres de l’équipe Owners ne peuvent pas être limités. Ils ont tous les droits sur tout, y compris la suppression. Deux personnes suffisent.
Attention à DEFAULT_ALLOW_CREATE_ORGANIZATION. Par défaut, tout utilisateur peut créer une organisation. Sur une instance d’entreprise, cela produit rapidement des organisations parasites créées par erreur. Le paramètre [admin] DISABLE_REGULAR_ORG_CREATION=true réserve cette action aux administrateurs.
Ce qu’il faut retenir
- L’organisation figure dans l’URL de chaque dépôt : choisissez son nom définitivement.
- Aucun dépôt de travail sous un compte personnel.
- Découpez selon qui doit accéder, pas selon l’organigramme.
- Peu d’organisations au démarrage : il est facile d’en ajouter, coûteux de découper après coup.
- Les droits s’attribuent à des équipes, jamais à des personnes.
- Deux propriétaires : votre compte et le compte d’administration de secours.
- La correspondance groupes → équipes rend la gestion des accès automatique.
- Activez le retrait automatique des équipes, sans quoi les droits ne sont jamais repris.
- Réservez la création d’organisations aux administrateurs.
Dans la leçon suivante
Dernière leçon de la section, et pas la moins importante : la visibilité des dépôts.
Nous verrons ce que « public » signifie réellement sur une instance interne, pourquoi cette question conditionne tout le mécanisme de distribution par GPO de la section 7, et comment arbitrer entre un dépôt public sans authentification et un jeton en lecture seule embarqué dans un lanceur.
C’est une décision de sécurité, et elle mérite d’être prise en connaissance de cause plutôt que par défaut.