Le mur
Vous venez de passer une heure à configurer votre authentification centralisée. Vos collègues se connectent à la forge avec leurs identifiants habituels, le bouton fonctionne, les comptes se créent tout seuls. Satisfaction légitime.
Puis quelqu’un tente son premier clone :
git clone https://forge.nordika.local/it/scripts.git
Username for 'https://forge.nordika.local': jdupont
Password for 'https://[email protected]':
Il saisit son mot de passe de domaine. Et selon votre configuration, soit ça échoue, soit — pire — ça fonctionne, et il vient d’enregistrer son mot de passe de domaine dans le gestionnaire d’identifiants de sa machine.
C’est le malentendu le plus coûteux de cette section. Il ne vient pas d’une erreur de configuration, mais d’une propriété fondamentale des protocoles en jeu.
Pourquoi deux chemins
Reprenez le schéma de la leçon 2.6. L’authentification OIDC repose sur des redirections HTTP et une interaction humaine dans un navigateur : l’utilisateur est envoyé chez l’IdP, y saisit son mot de passe, valide éventuellement un second facteur, puis revient.
Maintenant, posez-vous la question : comment git push ferait-il cela ?
Il n’a pas de navigateur. Il ne sait pas suivre une redirection vers une page de connexion. Il ne peut pas afficher un formulaire de double authentification. C’est un client non interactif qui ne connaît qu’une chose : l’authentification HTTP basique — un identifiant, un secret, dans un en-tête.
NAVIGATEUR CLIENT GIT / DOCKER / API
│ │
▼ ▼
Redirection vers l'IdP En-tête d'authentification
Saisie du mot de passe HTTP basique
Second facteur │
Retour avec un jeton signé │
│ │
▼ ▼
┌─────────────────────────────────────────────────────┐
│ FORGEJO │
└─────────────────────────────────────────────────────┘
Le SSO couvre la colonne de gauche. Rien d’autre.
Ce qui n’est pas couvert
La liste est plus longue qu’on ne le croit, et elle recouvre l’essentiel de ce que nous ferons dans les douze sections suivantes.
| Usage | Couvert par le SSO ? | Ce qu’il faut |
|---|---|---|
| Navigation dans l’interface web | ✅ | Rien de plus |
git clone, pull, push en HTTPS |
❌ | Un jeton d’accès |
| L’API REST | ❌ | Un jeton d’accès |
docker login sur le registre (§10) |
❌ | Un jeton d’accès |
| Git LFS | ❌ | Un jeton d’accès |
| Le runner d’intégration continue (§9) | ❌ | Un jeton d’enregistrement dédié |
| Le lanceur de GPO (§7) | ❌ | Un jeton en lecture seule, ou un dépôt public |
| Semaphore, Dockerhand et consorts (§12) | ❌ | Un jeton à portée limitée |
Autrement dit : le SSO règle la question du confort de connexion, pas celle de l’accès machine. Et comme cette formation consiste précisément à faire dialoguer des machines avec la forge, c’est le second sujet qui va nous occuper.
Rappel : nous avons choisi en 2.1 de fonctionner exclusivement en HTTPS, sans SSH. Les jetons ne sont donc pas une option parmi d’autres — ils sont le mécanisme d’authentification machine de votre forge.
Les jetons d’accès personnels
Un jeton est une chaîne aléatoire qui remplace le mot de passe pour les usages non interactifs. Il présente trois avantages décisifs.
Il est révocable individuellement. Un jeton compromis se supprime sans impacter votre compte ni les autres jetons.
Il porte des permissions limitées. Un jeton créé pour lire un dépôt ne peut pas administrer la forge.
Il n’est pas votre mot de passe de domaine. C’est le point essentiel : même stocké en clair sur une machine, il n’ouvre pas vos sessions Windows, votre messagerie et vos partages.
Créer un jeton
Paramètres utilisateur → Applications → Nouveau jeton d’accès.
Un nom explicite. Pas token1, mais poste-romain-vscode ou srv-web01-lecture-scripts. Le jour où vous devrez faire le ménage — et ce jour viendra —, c’est ce nom qui vous permettra de savoir ce que vous cassez en révoquant.
Une portée à deux niveaux. C’est le point important, et il est plus fin qu’il n’y paraît.
Les portées : le moindre privilège
Forgejo procède en deux temps.
D’abord, l’accès aux ressources : le jeton porte-t-il sur tout, sur les seules ressources publiques, ou sur une liste de dépôts que vous choisissez ? Cette dernière option est celle qui rend possible un jeton réellement cantonné à un usage.
Ensuite, les autorisations par catégorie : repository, package, issue, organization, user, notification, admin et quelques autres, chacune réglable indépendamment. Toutes partent d’« aucun accès » — vous n’ouvrez que ce dont vous avez besoin.
| Usage | Portée suffisante |
|---|---|
| Cloner et pousser depuis votre poste | repository en écriture |
| Un serveur qui ne fait que récupérer des scripts | Dépôts spécifiques + repository en lecture |
| Récupérer une image du registre | package en lecture |
| Publier une image depuis un workflow | package en écriture |
| Un outil qui lit la configuration (§12) | Dépôts spécifiques + repository en lecture |
La catégorie admin ne devrait figurer sur aucun jeton de travail quotidien.
⚠️ Forgejo ne propose pas de date d’expiration. Un jeton créé reste valide jusqu’à sa suppression. C’est une différence notable avec d’autres forges, et elle a une conséquence directe : le nommage et la revue périodique sont vos seuls garde-fous. Un jeton oublié ne disparaîtra jamais de lui-même.
Le jeton ne s’affiche qu’une fois
À la création, Forgejo affiche la valeur une seule fois. Ensuite, il n’en conserve qu’une empreinte : personne, pas même vous, ne pourra le relire.
Copiez-le immédiatement dans votre gestionnaire de mots de passe. Si vous le perdez, il faut en générer un nouveau — ce n’est pas grave, mais autant éviter.
L’utiliser
Au moment où Git demande vos identifiants :
Username: jdupont ← votre identifiant
Password: <le jeton> ← et non votre mot de passe
C’est tout. Le jeton prend la place du mot de passe, et le gestionnaire d’identifiants le mémorisera.
Où le jeton est stocké — et pourquoi ça compte
Voici le sujet qu’aucun tutoriel n’aborde et qui devrait vous intéresser, parce qu’il concerne directement vos serveurs.
Sur un poste Windows
Le Git Credential Manager, installé en leçon 1.6, stocke le jeton dans le gestionnaire d’identifiants Windows, chiffré au niveau du profil utilisateur. C’est propre, et vous n’avez rien à faire.
Sur un poste Linux avec environnement graphique
Le trousseau du bureau prend le relais, via libsecret :
git config --global credential.helper libsecret
Même niveau de protection.
Sur un serveur Linux sans interface — le vrai sujet
C’est ici que ça devient intéressant, car c’est exactement la situation des sections 8 et 12 : un serveur qui doit récupérer des choses depuis la forge, sans utilisateur devant l’écran.
Le mécanisme de stockage persistant le plus simple est :
git config --global credential.helper store
Il écrit le jeton en clair dans ~/.git-credentials. Pas chiffré. Simplement un fichier texte contenant votre jeton et l’URL associée.
Ce n’est pas un défaut de Git : sans utilisateur pour saisir une phrase de passe, il n’y a rien pour chiffrer le fichier. C’est une contrainte, pas un bug.
Comment vivre avec — quatre mesures, à appliquer ensemble :
- Un jeton dédié à cette machine, pas le vôtre. Nommé en conséquence.
- En lecture seule, et restreint au strict nécessaire.
- Permissions du fichier :
chmod 600 ~/.git-credentials, et sous un compte de service dédié. - Avec une expiration, et une procédure de renouvellement notée quelque part.
Ainsi, la fuite du fichier expose un droit de lecture sur un dépôt — un incident à traiter, pas une catastrophe.
L’alternative sans stockage consiste à passer par une variable d’environnement lue au moment de l’exécution, ou à ne pas s’authentifier du tout en utilisant un dépôt public sur instance interne. C’est exactement le compromis que nous étudierons en 2.10, puis en section 7 pour les GPO.
Ce qu’il ne faut jamais faire
git clone https://jdupont:[email protected]/it/scripts.git # ❌
Le jeton se retrouve alors en clair dans .git/config, dans l’historique du shell, et potentiellement dans les journaux du serveur et du proxy. C’est la façon la plus efficace de le diffuser.
Le cas particulier du LDAP
Si vous avez configuré une liaison LDAP en 2.7 plutôt qu’un OIDC, une nuance s’impose.
Contrairement à l’OIDC, le LDAP peut répondre à une authentification basique : Git envoie l’identifiant et le mot de passe, Forgejo les valide auprès de l’annuaire. Le clone fonctionne donc avec le mot de passe de domaine.
Ce n’est pas une bonne nouvelle. Cela signifie que le mot de passe de domaine de vos utilisateurs va se retrouver stocké dans les gestionnaires d’identifiants de leurs postes, et en clair dans le ~/.git-credentials de vos serveurs.
Utilisez des jetons quand même, y compris en LDAP. Et si vous voulez fermer définitivement la porte :
- FORGEJO__service__ENABLE_BASIC_AUTHENTICATION=false
Ce réglage interdit l’authentification par mot de passe pour les opérations Git et l’API. Les jetons continuent de fonctionner normalement — c’est même leur raison d’être.
Ne l’activez qu’après avoir prévenu vos utilisateurs et vérifié que vos automatismes utilisent bien des jetons. Sinon, vous casserez des choses sans comprendre pourquoi.
Les autres identités machine
Les jetons personnels ne sont pas les seuls mécanismes que vous croiserez. Autant les situer maintenant.
Le jeton d’enregistrement du runner (section 9) — il ne sert qu’une fois, au moment où le runner se déclare auprès de la forge. Il n’est pas lié à un utilisateur mais à un périmètre : l’instance entière, une organisation, ou un dépôt.
Le jeton automatique des workflows (sections 9 et 10) — Forgejo fournit à chaque exécution un jeton temporaire, limité au dépôt concerné et détruit à la fin. C’est lui que vous utiliserez pour publier une image dans le registre, sans avoir à créer quoi que ce soit à la main.
Les secrets de dépôt et d’organisation (section 9) — pour stocker les identifiants dont vos workflows ont besoin, chiffrés et jamais affichés dans les journaux.
Les clés de déploiement — mécanisme d’accès en lecture seule à un dépôt unique. Elles reposent sur SSH ; comme nous fonctionnons en HTTPS, elles ne nous concernent pas, et nous utiliserons des jetons à portée limitée à la place.
Qui s’authentifie comment : la synthèse
| Acteur | Mécanisme |
|---|---|
| Un humain dans un navigateur | SSO (OIDC ou LDAP) |
| Un humain qui clone depuis son poste | Jeton personnel, dans le coffre du système |
| Un serveur qui récupère des scripts | Jeton dédié, lecture seule, expiration |
| Un workflow d’intégration continue | Jeton temporaire fourni automatiquement |
| Un runner qui se déclare | Jeton d’enregistrement, à usage unique |
| Un outil tiers qui lit la forge | Jeton dédié à portée minimale |
| L’administrateur de secours | Compte local, mot de passe au coffre |
Faire vivre les jetons
Un jeton créé aujourd’hui sera oublié demain. Trois habitudes évitent l’accumulation.
Un jeton par usage et par machine. C’est plus long à créer, et infiniment plus simple à révoquer : vous savez exactement ce que vous cassez.
Une revue périodique. L’écran des applications liste vos jetons avec leur date de dernière utilisation. Un jeton inutilisé depuis six mois n’a probablement plus de raison d’être. Comme rien n’expire automatiquement, c’est cette revue qui tient lieu de purge — nous en ferons un point de contrôle formel en section 14.
Une révocation immédiate en cas de doute. Supprimer un jeton est instantané et sans effet de bord. Dans le doute, révoquez et recréez : le coût est de deux minutes.
Ce qu’il faut retenir
- Le SSO couvre le navigateur, et rien d’autre.
git push, l’API, le registre et vos outils sont des clients non interactifs : ils ne savent faire que de l’authentification basique.- Les jetons d’accès sont le mécanisme d’authentification machine de votre forge.
- Nommez-les explicitement et donnez-leur la portée minimale — au besoin restreinte à un seul dépôt.
- Aucune expiration automatique : nommage et revue périodique sont les seuls garde-fous.
- Le jeton ne s’affiche qu’une fois.
- Sur un serveur sans interface, le stockage persistant est en clair : jeton dédié, lecture seule, permissions restreintes.
- N’écrivez jamais un jeton dans l’URL d’un dépôt.
- En LDAP, le mot de passe de domaine fonctionne pour Git — raison de plus pour utiliser des jetons, voire désactiver l’authentification basique.
Dans la leçon suivante
L’authentification répond à « qui êtes-vous ? ». Passons à « qu’avez-vous le droit de faire ? ».
Nous structurerons la forge en organisations et en équipes : où ranger les dépôts, comment distribuer les droits sans tout ouvrir à tout le monde, et comment faire en sorte qu’un utilisateur ajouté à un groupe de votre annuaire se retrouve automatiquement dans la bonne équipe — sans que vous ayez à intervenir.
C’est aussi le moment de poser une organisation qui tiendra dans trois ans, parce que déplacer des dépôts après coup casse toutes les URL que vous aurez semées dans vos GPO et vos scripts.