Objectif
À l’issue de ce TP, vous disposerez d’une forge réellement utilisable en production — pas d’un bac à sable. C’est celle que vous garderez pour toute la suite de la formation, et probablement au-delà.
Vous allez :
- déployer Forgejo et sa base de données ;
- le publier sous son nom définitif, en HTTPS ;
- valider l’installation avec les bons réglages ;
- raccorder l’authentification à votre annuaire ou votre fournisseur d’identité ;
- structurer les organisations et les équipes ;
- et surtout vérifier que votre accès de secours fonctionne — le contrôle que tout le monde oublie.
Prérequis
| Élément | Détail |
|---|---|
| Une VM Linux | Docker et Docker Compose installés |
| Un nom DNS | Résolvant vers la VM, en interne |
| Un reverse proxy | Nginx, Traefik ou Caddy — ou aucun, voir parcours minimal |
| Un certificat | Autorité interne, Let’s Encrypt, ou auto-signé pour un lab |
| (optionnel) Un IdP | Authentik, Keycloak, ADFS, Entra ID |
| (optionnel) Un annuaire | Active Directory avec un compte de service |
Trois parcours possibles pour la partie authentification, selon ce dont vous disposez :
- Parcours A — vous avez un fournisseur d’identité → mission 5A
- Parcours B — vous avez un annuaire mais pas d’IdP → mission 5B
- Parcours C — ni l’un ni l’autre → mission 5C
⚠️ Avant de commencer : notez vos décisions
Reprenez la checklist de la leçon 2.1 et remplissez-la. Vous en aurez besoin à chaque mission, et certaines de ces valeurs sont difficiles à changer après coup.
| # | Décision | Votre valeur |
|---|---|---|
| 1 | Nom DNS de la forge | |
| 2 | Type de certificat | |
| 3 | Chemin des données sur l’hôte | |
| 4 | Nom de l’organisation principale | |
| 5 | Nom de la source d’authentification | |
| 6 | Emplacement de sauvegarde |
Mission 1 — Déployer
Préparez l’arborescence sur l’hôte, avec les bonnes permissions, puis déployez Forgejo et PostgreSQL.
Contraintes :
- Le mot de passe de la base ne doit apparaître nulle part dans le
docker-compose.yml. - L’image doit être épinglée sur une version majeure.
- La base ne doit être joignable que par Forgejo.
- Aucun port ne doit être publié sur l’hôte (sauf si vous suivez le parcours sans reverse proxy).
- Forgejo ne doit pas démarrer avant que la base ne soit réellement prête.
💡 Indices
- Le mot de passe passe par un fichier
.envet une substitution${...}. - Les permissions du dossier de données doivent correspondre à
USER_UIDetUSER_GID. - Un
depends_onsimple ne suffit pas : il faut y associer unhealthchecksur la base. - Deux réseaux : un privé pour la base, un partagé avec le proxy.
Point de contrôle : docker compose ps affiche deux services running, dont la base marquée healthy.
Mission 2 — Publier, puis vérifier
Publiez la forge derrière votre reverse proxy, sous son nom définitif, en HTTPS.
⚠️ Ne validez pas l’assistant d’installation à ce stade.
Contraintes :
- Redirection automatique de HTTP vers HTTPS.
- Les envois volumineux ne doivent pas être bloqués.
- Les barres obliques encodées doivent être transmises correctement.
- Les WebSockets doivent passer.
- Forgejo doit voir l’adresse réelle des clients, pas celle du proxy.
💡 Indices
- Côté Nginx :
client_max_body_size,merge_slashes off, les en-têtesConnectionetUpgrade. - Côté Traefik : attention au conteneur rattaché à deux réseaux.
- Côté Forgejo :
REVERSE_PROXY_TRUSTED_PROXIESdoit couvrir la plage du réseau Docker de votre proxy. Trouvez-la avecdocker network inspect.
Points de contrôle :
curl -I http://forge.votre-domaine # 301
curl -I https://forge.votre-domaine # 200
docker compose logs forge-server | tail # votre IP, pas celle du proxy
Mission 3 — Valider l’assistant
Accédez à la forge par son nom définitif et déroulez l’assistant.
Contraintes :
- Ne touchez à aucun champ de la section base de données.
- Le serveur SSH doit être désactivé.
- L’URL de base doit être exacte, barre oblique finale comprise.
- L’inscription libre doit être fermée.
- Le compte administrateur créé ici ne doit pas être votre compte nominatif.
- Configurez l’envoi de courriels si vous disposez d’un relais.
💡 Indices
- Le port SSH se désactive en vidant le champ.
- Sur un relais interne en port 25, laissez identifiant et mot de passe vides — l’authentification exigerait TLS.
- Le compte administrateur est votre porte de secours : nommez-le en conséquence, et rangez son mot de passe dans votre coffre.
Point de contrôle : vous êtes connecté, et le pied de page affiche la version de Forgejo.
Mission 4 — Durcir
Ajoutez au compose les réglages qui ne figurent pas dans l’assistant, puis redémarrez.
À obtenir :
- Double authentification obligatoire pour les administrateurs.
- Tout nouveau dépôt créé privé par défaut.
- Cache dimensionné pour une petite instance.
- Création d’organisations réservée aux administrateurs.
💡 Indice
Quatre variables, dans les sections security, repository, cache et admin. Reportez-vous à la leçon 2.4.
Point de contrôle : à la reconnexion, Forgejo vous invite à configurer un second facteur. Faites-le tout de suite, sur votre compte comme sur le compte de secours.
Mission 5A — Authentification par OIDC (parcours A)
Déclarez Forgejo comme client dans votre fournisseur d’identité, puis créez la source côté forge.
Contraintes :
- Seuls les membres d’un groupe donné doivent pouvoir se connecter.
- Les comptes doivent être créés automatiquement à la première connexion.
- Un utilisateur dont l’adresse existe déjà localement doit devoir prouver qu’il possède le compte avant rattachement.
- Les groupes doivent remonter dans le jeton.
💡 Indices
- Décidez le nom de la source avant de configurer l’IdP : il détermine l’URI de redirection.
- Les groupes ne sont presque jamais transmis par défaut : scope, mapper ou règle de revendication selon votre produit.
ACCOUNT_LINKINGdoit rester àlogin.- Pour vérifier que les groupes arrivent : renseignez temporairement le champ « groupe administrateur ».
Points de contrôle :
- Un compte de test membre du groupe se connecte et son compte est créé.
- Un compte non membre du groupe est refusé.
- Le compte d’administration local se connecte toujours par mot de passe.
Mission 5B — Authentification par LDAP (parcours B)
Créez une source LDAP via BindDN vers votre Active Directory.
Contraintes :
- Connexion chiffrée.
- Compte de service dédié, en lecture seule.
- Seuls les membres d’un groupe donné peuvent se connecter.
- Un compte désactivé dans l’annuaire ne doit pas pouvoir se connecter.
- N’activez pas encore la synchronisation périodique.
💡 Indices
- Validez votre filtre côté annuaire avant de le saisir dans Forgejo :
ldapsearchouGet-ADUser -LDAPFilter. - L’exclusion des comptes désactivés passe par une comparaison binaire sur
UserAccountControl. - L’attribut e-mail est requis : un compte sans adresse ne sera pas créé.
Points de contrôle :
- Un compte du groupe se connecte, avec nom, prénom et adresse renseignés.
- Un compte hors du groupe est refusé.
- Un compte désactivé est refusé.
- Le compte d’administration local fonctionne toujours.
Mission 5C — Sans annuaire (parcours C)
Créez deux comptes locaux supplémentaires depuis l’administration du site, avec des rôles différents. Vous les utiliserez pour tester les permissions en mission 6.
Notez que vous pourrez revenir sur cette mission plus tard : ajouter une source d’authentification n’invalide pas les comptes locaux existants.
Mission 6 — Structurer
Créez la structure d’organisations et d’équipes qui portera vos dépôts.
À obtenir :
- Une organisation principale pour le travail de l’équipe informatique.
- Une organisation distincte destinée à ce qui devra être distribué largement.
- Au moins trois équipes avec des niveaux d’accès différents.
- Deux propriétaires sur l’organisation principale, dont le compte de secours.
- (Parcours A ou B) Une correspondance automatique entre vos groupes et vos équipes, avec retrait des utilisateurs qui quittent le groupe.
💡 Indices
- Reportez-vous à la matrice de la leçon 2.9.
- La correspondance se déclare dans la source d’authentification, au format JSON.
- Testez avec un seul groupe avant de bâtir la correspondance complète : le format de la clé diffère entre OIDC et LDAP.
- N’oubliez pas la case de retrait automatique, sans quoi les droits ne sont jamais repris.
Point de contrôle : ajoutez votre compte de test au groupe, reconnectez-vous, et vérifiez qu’il apparaît dans la bonne équipe. Retirez-le du groupe, reconnectez-vous, vérifiez qu’il en sort.
Mission 7 — Visibilité
Créez deux dépôts vides :
scripts-powershelldans l’organisation principale, privé ;gpodans l’organisation de distribution, public.
Puis vérifiez réellement ce que chacun expose.
💡 Comment vérifier
Ouvrez une fenêtre de navigation privée, sans être connecté :
- Le dépôt privé doit renvoyer une page d’erreur ou une invitation à se connecter.
- Le dépôt public doit s’afficher.
Puis testez en ligne de commande, sans authentification :
curl -I https://forge.votre-domaine/public-interne/gpo
Avant de valider cette mission, déroulez les quatre contrôles d’exposition de la leçon 2.10. Si l’un d’eux échoue, repassez le dépôt en privé.
Mission 8 — Le contrôle que tout le monde oublie
C’est la mission la plus importante du TP, et la plus rapide.
Simulez l’indisponibilité de votre authentification externe et vérifiez que vous pouvez toujours entrer.
💡 Comment procéder
Le plus simple, sans rien casser : ouvrez une session de navigation privée et connectez-vous uniquement avec le compte d’administration local et son mot de passe.
Si vous voulez aller plus loin, désactivez temporairement la source d’authentification depuis l’administration du site, vérifiez que la connexion locale fonctionne, puis réactivez-la.
Puis documentez-le. Écrivez, quelque part que vos collègues trouveront, la procédure d’accès de secours : quel compte, où est le mot de passe, quoi faire si l’IdP est en panne.
Le jour où ce sera nécessaire, ce ne sera peut-être pas vous qui serez devant l’écran.
🎁 Bonus
Bonus 1 — Envoyez un courriel de test depuis Administration du site → Configuration.
Bonus 2 — Consultez le fichier de configuration généré et comparez-le à vos variables :
docker compose exec forge-server cat /data/gitea/conf/app.ini
Bonus 3 — Redéployez votre forge sans assistant, dans un environnement de test : toute la configuration dans le compose, INSTALL_LOCK=true, et création du compte administrateur en ligne de commande. C’est l’approche que vous voudrez adopter en production.
Ce que vous devez avoir à la fin
- Une forge joignable en HTTPS sous son nom définitif
- Aucun secret en clair dans le
docker-compose.yml - Les journaux affichant l’adresse réelle des clients
- L’inscription libre fermée
- La double authentification active sur les comptes administrateurs
- Une authentification centralisée fonctionnelle (parcours A ou B)
- Un compte de test refusé lorsqu’il n’appartient pas au groupe autorisé
- Deux organisations, trois équipes, deux propriétaires
- Un dépôt privé invisible sans authentification, un dépôt public accessible
- Un accès de secours testé et documenté
Ce que ce TP vous a réellement appris
La mission 8 paraît anecdotique — trois minutes, une connexion en navigation privée. Elle est pourtant la seule qui vous sauvera un jour.
Une forge est un service de production dont dépendront bientôt vos stratégies de groupe, vos déploiements et vos images de conteneurs. Le jour où votre fournisseur d’identité tombera, ce n’est pas « l’accès au code » que vous perdrez : c’est la capacité à corriger quoi que ce soit.
La plupart des administrateurs découvrent qu’ils n’ont pas d’accès de secours au moment précis où ils en auraient besoin. Vous, non.