2.5 : Choisir son mode d'authentification

Où nous en sommes

Votre forge tourne avec un unique compte : celui d’administration locale créé en 2.4. Il est temps d’ouvrir la porte à vos collègues.

Le réflexe le plus répandu consiste à brancher l’application sur l’Active Directory et à passer à autre chose. C’est ce que font 90 % des tutoriels, et c’est ce que je vais vous déconseiller.

Cette leçon ne configure rien. Elle sert à choisir, parce que c’est une décision qu’on prend une fois et qu’on traîne ensuite pendant des années — sur cette application comme sur les vingt suivantes.


Les modes disponibles

Forgejo sait s’authentifier de plusieurs manières. Vous les retrouverez dans Administration du site → Sources d’authentification.

Mode Principe Cas d’usage
Local Comptes créés dans Forgejo Compte d’administration de secours
LDAP (BindDN) Forgejo interroge l’annuaire avec un compte de service Annuaire sans IdP devant
LDAP (simple auth) Forgejo se connecte directement avec les identifiants saisis Rare, peu recommandé
OAuth2 / OpenID Connect Forgejo délègue à un fournisseur d’identité Le mode à privilégier
Authentification par en-tête Le reverse proxy authentifie et transmet l’identité Architectures particulières
PAM, FreeIPA Cas spécifiques Environnements Unix dédiés

Une remarque au passage : la documentation officielle de Forgejo consacre une page entière à LDAP, PAM et FreeIPA — et n’y documente pas OAuth2, qui se configure entièrement depuis l’interface d’administration. Ne concluez pas de ce déséquilibre que le LDAP est la voie recommandée. C’est un héritage de documentation, pas une préconisation.


Ma position : OIDC d’abord

Je vais être direct, parce que c’est une position tranchée : je ne recommande pas de brancher vos applications directement sur vos contrôleurs de domaine. Chaque fois que c’est possible, préférez un fournisseur d’identité — Authentik, Keycloak, ADFS, Entra ID — et l’OpenID Connect.

Cinq raisons, par ordre d’importance.

1. Forgejo ne voit jamais le mot de passe

C’est l’argument de fond, et il suffirait à lui seul.

En LDAP, l’utilisateur saisit son mot de passe de domaine dans le formulaire de Forgejo. L’application le reçoit, le manipule, puis le transmet à l’annuaire pour vérification. Votre mot de passe Active Directory — celui qui ouvre les sessions, les partages, la messagerie — transite par une application web.

En OIDC, l’utilisateur est redirigé vers le fournisseur d’identité, s’authentifie chez lui, et revient avec un jeton signé. Forgejo reçoit une preuve d’identité, jamais le secret. Compromettre l’application ne compromet plus les identifiants du domaine.

Multipliez ce raisonnement par le nombre d’applications de votre SI, et l’écart devient considérable.

2. Plus de compte de service qui lit l’annuaire

Une liaison LDAP par BindDN exige un compte de service capable de parcourir l’annuaire. Son mot de passe est stocké dans l’application — chiffré, certes, mais présent.

Vous vous retrouvez donc avec autant de comptes de service que d’applications, chacun disposant d’un droit de lecture sur votre annuaire, chacun avec un mot de passe qui ne sera jamais changé parce que personne ne sait plus où il est utilisé.

Avec un IdP, ce compte existe une seule fois, entre l’IdP et l’annuaire. Les applications, elles, n’ont qu’un identifiant client et un secret propres, révocables individuellement.

3. Vos contrôleurs de domaine vont changer

C’est l’argument le plus concret pour un administrateur système.

Une liaison LDAP pointe sur un nom de serveur. Vous migrez vers Windows Server plus récent, vous renommez, vous ajoutez un site, vous décommissionnez un DC. Chaque changement vous oblige à reprendre toutes les applications liées, une par une, en espérant n’en oublier aucune — et vous en oublierez.

Un fournisseur d’identité est une couche d’abstraction. Vos applications pointent sur lui ; lui seul connaît vos contrôleurs de domaine. Le jour où l’infrastructure d’annuaire évolue, il y a un seul point à modifier.

C’est exactement le raisonnement que vous appliquez déjà à un reverse proxy : les clients ne connaissent pas les serveurs finaux.

4. La double authentification et les politiques d’accès

Une liaison LDAP ne sait faire qu’une chose : vérifier un couple identifiant / mot de passe. Pas de second facteur, pas de politique conditionnelle, pas de restriction horaire ou géographique.

Un IdP porte tout cela, pour toutes les applications à la fois. Vous décidez que l’accès à la forge exige un second facteur : c’est une règle dans l’IdP, aucune modification côté Forgejo.

Souvenez-vous de ce que votre forge distribuera bientôt : du code exécuté avec des privilèges élevés sur deux cents postes. La double authentification n’y est pas un luxe.

5. La révocation et la traçabilité

Un départ, une compromission, un compte à couper en urgence ? Avec un IdP, vous désactivez dans un seul endroit et l’accès tombe partout, immédiatement.

Et vous disposez d’un journal unique des connexions, au lieu de logs éparpillés dans vingt applications.


Ce que ça coûte — soyons honnêtes

Un IdP est un composant supplémentaire : à installer, à maintenir, à sauvegarder, à mettre à jour. Il faut l’apprendre. Et c’est un point de défaillance unique de plus : s’il tombe, plus personne ne se connecte nulle part.

Trois réponses à cela.

Le compte d’administration local de la leçon 2.4 prend ici tout son sens. C’est votre porte de secours quand l’IdP est indisponible. Si vous ne l’avez pas créé, remontez d’une leçon.

Le calcul s’inverse vite. Pour une seule application, l’IdP est un surcoût. À partir de trois ou quatre, il devient rentable. Et vous en aurez plus que ça : supervision, sauvegarde, portail, outils métier.

Ce n’est pas un projet démesuré. Authentik se déploie en Docker Compose, comme votre forge. Comptez une demi-journée pour une première mise en service fonctionnelle.


Quand le LDAP reste justifié

Je ne prétends pas que le LDAP soit à proscrire. Il reste le bon choix dans trois situations.

L’application ne sait pas faire d’OIDC ni de SAML. C’est le cas d’usage principal, et il concerne beaucoup d’outils d’infrastructure. Forgejo, lui, sait faire de l’OIDC — donc ce cas ne s’applique pas ici.

Vous n’avez pas d’IdP et vous ne pouvez pas en déployer un maintenant. Structure très petite, contrainte de temps, décision qui ne vous appartient pas. Une liaison LDAP correctement configurée reste infiniment préférable à des comptes locaux gérés à la main. La leçon 2.7 est là pour ça.

Vous n’avez pas d’annuaire du tout. Comptes locaux, et on passe à la suite.

Le pattern à retenir : l’IdP en frontal LDAP

Quand vous devez malgré tout faire du LDAP — pour une application qui ne sait pas faire autrement — il existe une solution nettement plus élégante que de la brancher sur vos DC.

Authentik peut lui-même jouer le rôle de fournisseur LDAP. L’application legacy se connecte alors à Authentik en LDAP ; Authentik, lui, est intégré à l’Active Directory. Vous conservez le point unique, les politiques et la journalisation, sans exposer vos contrôleurs de domaine.

   Application OIDC ──────────┐
   Application SAML ──────────┤
                              ├──▶  Authentik  ──▶  Active Directory
   Application LDAP ──────────┘      (IdP)           (contrôleurs)
      (legacy)

J’ai documenté les deux volets de ce montage sur le site :

C’est le schéma que j’applique aujourd’hui : une seule application connaît mes contrôleurs de domaine.


L’arbre de décision

        Votre application sait-elle faire de l'OIDC ou du SAML ?
                          │
            ┌─────────────┴─────────────┐
           OUI                          NON
            │                            │
   Avez-vous un IdP ?          Avez-vous un IdP ?
            │                            │
     ┌──────┴──────┐              ┌──────┴──────┐
    OUI           NON            OUI           NON
     │             │              │             │
   OIDC ✅   Déployez-en un   LDAP vers    LDAP direct
             (ou LDAP en       l'IdP        (leçon 2.7,
              attendant)        ✅          avec précautions)

Pour Forgejo, la réponse à la première question est oui. Nous partons donc sur l’OIDC en leçon 2.6, avec le LDAP traité en 2.7 pour ceux qui n’ont pas le choix.


Le vocabulaire OIDC, si vous débutez

Six termes suffisent à comprendre ce que nous ferons en 2.6.

Fournisseur d’identité (IdP) — le service qui authentifie : Authentik, Keycloak, ADFS, Entra ID.

Client — l’application qui délègue l’authentification. Ici, Forgejo. Chaque application est déclarée comme un client distinct dans l’IdP.

Identifiant et secret client — le couple qui permet à Forgejo de prouver à l’IdP qu’il est bien l’application déclarée. Le secret se traite comme un mot de passe : il ira dans votre .env.

URI de redirection — l’adresse à laquelle l’IdP renvoie l’utilisateur après authentification. Elle doit être déclarée à l’identique des deux côtés. C’est la première source d’erreur, et elle produit un message assez peu explicite.

Scopes — les catégories d’informations demandées : openid, profile, email, éventuellement groups.

Claims — les informations effectivement transmises dans le jeton : nom, adresse, appartenance à des groupes. Ce sont elles qui alimenteront la mise en correspondance avec les équipes Forgejo.

Point de découverte — l’URL en /.well-known/openid-configuration qui décrit automatiquement toute la configuration de l’IdP. Forgejo sait la consommer : vous n’aurez souvent qu’une seule adresse à saisir.


Une distinction à garder en tête

L’authentification répond à « qui êtes-vous ? ». L’autorisation répond à « qu’avez-vous le droit de faire ? ».

L’OIDC règle la première question. La seconde — qui peut lire quel dépôt, qui peut pousser, qui peut valider une modification — reste du ressort de Forgejo, via les organisations et les équipes que nous verrons en 2.9.

Le lien entre les deux se fait par les groupes transmis dans le jeton. Bien configuré, il permet qu’un utilisateur ajouté au groupe « Informatique » de votre annuaire se retrouve automatiquement dans la bonne équipe Forgejo, sans intervention. Nous mettrons cela en place en 2.9.


Ce qu’il faut retenir

  • Ne branchez pas vos applications directement sur vos contrôleurs de domaine quand vous pouvez l’éviter.
  • En OIDC, l’application ne voit jamais le mot de passe de l’utilisateur.
  • Une liaison LDAP impose un compte de service par application, avec droit de lecture sur l’annuaire.
  • Un IdP est une couche d’abstraction : vos DC peuvent changer sans que les applications le sachent.
  • L’IdP apporte la double authentification et les politiques d’accès à toutes les applications d’un coup.
  • Le coût est un composant de plus à maintenir — d’où l’importance du compte d’administration local.
  • Le LDAP reste justifié pour les applications incompatibles ; dans ce cas, faites-le passer par l’IdP plutôt que par les DC.
  • Authentification et autorisation sont deux questions distinctes.

Dans la leçon suivante

Passons à la pratique. Nous allons déclarer Forgejo comme client OIDC dans Authentik — avec les équivalences Keycloak et ADFS — puis configurer la source d’authentification côté forge.

Nous verrons comment choisir le nom d’utilisateur créé automatiquement, comment gérer le cas d’un compte qui existe déjà avec la même adresse, et comment récupérer les groupes dans le jeton. Nous traiterons aussi la question qui fâche : faut-il conserver la possibilité de se connecter avec un mot de passe local, et si oui, pour qui ?

📎 Ressources 2