Accueil » Actualités » Identités & accès » Authelia : SSO et authentification à deux facteurs devant vos applications web
Logo de Authelia — Authelia : SSO et authentification à deux facteurs devant vos applications web

Authelia : SSO et authentification à deux facteurs devant vos applications web

Authelia : un portail d’authentification unique devant vos applications

Dans la plupart des systèmes d’information, les applications web internes se multiplient : tableaux de bord de supervision, consoles d’administration, wikis, outils de développement. Chacune gère ses propres comptes, avec des politiques de mot de passe hétérogènes et, bien souvent, sans second facteur. Résultat : autant de surfaces d’attaque que de services exposés. Authelia répond à ce problème en plaçant un portail de connexion unique, avec authentification multifacteur, directement au niveau du reverse proxy, sans modifier le code des applications.

Cette approche s’inscrit dans une logique Zero Trust : aucune requête n’atteint l’application tant que l’identité de l’utilisateur et le niveau d’authentification exigé n’ont pas été vérifiés.

Qu’est-ce qu’Authelia ?

Authelia est un serveur d’authentification et d’autorisation open source, écrit en Go et distribué sous licence Apache 2.0. Il fournit un portail web de connexion, une authentification unique (SSO) et un second facteur pour les applications publiées derrière un reverse proxy. Il fait également office de fournisseur OpenID Connect 1.0, certifié par l’OpenID Foundation pour les profils Basic OP, Implicit OP, Hybrid OP, Form Post OP et Config OP.

Ses principales fonctionnalités :

  • Second facteur : clés de sécurité FIDO2/WebAuthn (YubiKey…), codes TOTP générés par une application d’authentification, notifications push Duo.

  • Passkeys : authentification sans mot de passe via WebAuthn, apportée par la branche 4.39.

  • Contrôle d’accès fin : règles par domaine, chemin, méthode HTTP, réseau source, utilisateur ou groupe.

  • Protection contre la force brute : le mécanisme de régulation bannit temporairement les utilisateurs, les adresses IP, ou les deux, après des échecs répétés.

  • Haute disponibilité : base de données distante (PostgreSQL, MySQL ou MariaDB) et Redis pour les sessions.

Au moment de la rédaction, la dernière version publiée est la 4.39.28, sortie en septembre 2026.

Architecture et fonctionnement

Authelia ne remplace pas le reverse proxy : il le complète selon le principe de l’authentification déléguée (forward auth). Pour chaque requête vers une application protégée, le proxy interroge le point de terminaison d’autorisation d’Authelia (/api/authz/forward-auth avec Traefik). Trois cas se présentent :

  • la session est valide et le niveau d’authentification suffisant : le proxy laisse passer la requête et transmet l’identité dans des en-têtes (Remote-User, Remote-Groups, Remote-Email, Remote-Name) ;

  • l’utilisateur n’est pas authentifié : il est redirigé vers le portail Authelia ;

  • la règle d’accès refuse la ressource : la requête est bloquée.

Les proxies pris en charge sont NGINX, Traefik, Caddy, HAProxy, Envoy et Skipper. Côté comptes, Authelia s’appuie soit sur un fichier YAML (adapté à un laboratoire ou à une petite équipe), soit sur un annuaire LDAP : OpenLDAP, Active Directory ou tout annuaire compatible. Il n’intègre pas de console d’administration des utilisateurs : la gestion des comptes reste dans l’annuaire, Authelia se concentre sur l’authentification et l’autorisation.

Trois briques complètent l’ensemble : un stockage (SQLite pour les petits déploiements, PostgreSQL recommandé en production) qui conserve les préférences et les enregistrements de second facteur, un gestionnaire de sessions (en mémoire ou Redis), et un notificateur (SMTP en production, simple fichier pour les tests) qui envoie les codes et liens de vérification d’identité.

Installation avec Docker

La méthode la plus répandue consiste à exécuter l’image officielle authelia/authelia aux côtés du reverse proxy ; des paquets Debian et des binaires sont aussi proposés. Commencez par générer les secrets nécessaires (session, chiffrement du stockage, réinitialisation de mot de passe) et le hachage Argon2id du mot de passe de chaque utilisateur, puis rédigez un fichier de configuration minimal :

# Générer un secret aléatoire de 64 caractères (à répéter pour chaque secret)
docker run --rm authelia/authelia:latest authelia crypto rand --length 64 --charset alphanumeric

# Calculer le hachage Argon2id d'un mot de passe
docker run --rm authelia/authelia:latest authelia crypto hash generate argon2 --password 'MotDePasseRobuste'

# /config/configuration.yml minimal (SQLite, notifications dans un fichier)
authentication_backend:
  file:
    path: '/config/users.yml'

access_control:
  default_policy: 'deny'
  rules:
    - domain: 'wiki.example.com'
      policy: 'one_factor'
    - domain: 'admin.example.com'
      subject: 'group:admins'
      policy: 'two_factor'

session:
  secret: 'SECRET_SESSION_64_CARACTERES'
  cookies:
    - domain: 'example.com'
      authelia_url: 'https://auth.example.com'

storage:
  encryption_key: 'CLE_CHIFFREMENT_64_CARACTERES'
  local:
    path: '/config/db.sqlite3'

identity_validation:
  reset_password:
    jwt_secret: 'SECRET_JWT_64_CARACTERES'

notifier:
  filesystem:
    filename: '/config/notification.txt'

Quelques points d’attention sur ce fichier. La politique par défaut deny refuse tout ce qui n’est pas explicitement autorisé. Le domaine du cookie de session doit correspondre au domaine parent des applications et ne peut pas être un suffixe public. L’URL du portail (authelia_url) doit obligatoirement être en HTTPS. Le notificateur fichier convient pour un test, mais en production configurez SMTP afin que les utilisateurs reçoivent réellement leurs codes de vérification.

Le fichier des utilisateurs contient le nom affiché, l’adresse e-mail, les groupes et le hachage du mot de passe ; Authelia le réécrit dans le même format lorsqu’un utilisateur change son mot de passe. Il reste ensuite à déclarer Authelia comme middleware ForwardAuth dans Traefik et à l’appliquer aux routeurs à protéger. Si vous débutez avec ce proxy, le cours Reverse proxy et HTTPS avec Traefik détaille les routeurs, les middlewares et la gestion des certificats.

# /config/users.yml
users:
  jdupont:
    disabled: false
    displayname: 'Jean Dupont'
    password: '$argon2id$v=19$m=65536,t=3,p=4$...'
    email: 'jean.dupont@example.com'
    groups:
      - 'admins'

# docker-compose.yml (extrait) : Authelia et middleware Traefik
services:
  authelia:
    image: authelia/authelia:4.39
    volumes:
      - ./config:/config
    labels:
      - 'traefik.enable=true'
      - 'traefik.http.routers.authelia.rule=Host(`auth.example.com`)'
      - 'traefik.http.middlewares.authelia.forwardAuth.address=http://authelia:9091/api/authz/forward-auth'
      - 'traefik.http.middlewares.authelia.forwardAuth.trustForwardHeader=true'
      - 'traefik.http.middlewares.authelia.forwardAuth.authResponseHeaders=Remote-User,Remote-Groups,Remote-Email,Remote-Name'

  whoami:
    image: traefik/whoami
    labels:
      - 'traefik.enable=true'
      - 'traefik.http.routers.whoami.rule=Host(`admin.example.com`)'
      - 'traefik.http.routers.whoami.middlewares=authelia@docker'

Utilisation au quotidien

Lorsqu’un utilisateur accède pour la première fois à une application protégée, il est redirigé vers le portail Authelia, saisit son identifiant et son mot de passe puis, si la règle l’exige, enregistre un second facteur : application TOTP, clé de sécurité ou passkey. L’ajout d’un nouvel appareil passe par une vérification d’identité (code envoyé par le notificateur). Une fois la session ouverte sur le domaine, l’utilisateur accède aux autres applications protégées sans se reconnecter : c’est le SSO par cookie.

Les règles d’accès sont évaluées dans l’ordre, et la première dont tous les critères correspondent s’applique. Quatre politiques existent : bypass (aucune authentification, par exemple pour un point de contrôle de santé), one_factor (identifiant et mot de passe), two_factor (second facteur obligatoire) et deny. Les critères combinent domaine, expressions régulières sur le chemin (resources), méthodes HTTP, réseaux sources et sujets (user:, group:). Vous pouvez ainsi accepter un seul facteur depuis le réseau interne et exiger le MFA depuis l’extérieur.

Pour les applications compatibles OpenID Connect, préférez déclarer un client OIDC dans Authelia : l’application reçoit alors l’identité de façon standardisée plutôt que de se fier à des en-têtes HTTP.

Authelia face aux alternatives

  • authentik : fournisseur d’identité complet avec interface d’administration, flux d’authentification personnalisables, SAML, LDAP et proxy intégré. Plus riche fonctionnellement, mais plus lourd à exploiter.

  • Keycloak : référence des IAM open source, avec fédération d’identités, SAML 2.0, OpenID Connect et gestion par royaumes. Adapté aux grandes organisations, il demande davantage de ressources et de compétences.

  • oauth2-proxy : proxy léger qui délègue l’authentification à un fournisseur OIDC externe ; il ne gère lui-même ni annuaire ni second facteur.

Authelia se distingue par sa sobriété : un binaire unique, une configuration YAML versionnable et une intégration native avec les principaux reverse proxies. En contrepartie, il ne propose ni SAML ni interface graphique d’administration : si vous devez fédérer des applications SAML ou déléguer la gestion des comptes, un fournisseur d’identité plus complet sera plus adapté.

Bonnes pratiques

  • Partir de default_policy: 'deny' et n’ouvrir que les domaines nécessaires ; réserver bypass aux points techniques (santé, webhooks) en les limitant par chemin.

  • Exiger two_factor sur toutes les consoles d’administration et privilégier WebAuthn ou les passkeys, résistants à l’hameçonnage, plutôt que le TOTP.

  • Générer des secrets aléatoires d’au moins 64 caractères et les fournir via des fichiers de secrets plutôt qu’en clair dans la configuration.

  • En production, utiliser PostgreSQL pour le stockage, Redis pour les sessions et SMTP pour les notifications.

  • Épingler une version précise de l’image et lire les notes de version avant chaque mise à jour : certaines options dépréciées génèrent des avertissements et devraient disparaître en version 5.

  • Rendre les applications joignables uniquement via le reverse proxy : un accès direct contournerait la protection.

  • Avec un annuaire LDAP, utiliser un compte de service aux droits minimaux et une connexion chiffrée (LDAPS ou StartTLS).

  • Centraliser et surveiller les journaux d’Authelia pour repérer les échecs d’authentification répétés et les bannissements.

Conclusion

Authelia est une solution efficace pour ajouter un SSO et un second facteur à des applications web qui n’en disposent pas, sans toucher à leur code. Léger, configurable en YAML et certifié OpenID Connect, il convient particulièrement aux infrastructures auto-hébergées, aux laboratoires et aux PME qui veulent un contrôle d’accès cohérent devant leurs services. Pour la fédération SAML ou la gestion avancée du cycle de vie des identités, un fournisseur plus complet prendra le relais ; pour protéger proprement une série d’applications derrière Traefik ou NGINX, Authelia reste un excellent point de départ.

À lire aussi : FreeIPA : l’Active Directory du monde Linux · Vaultwarden : le gestionnaire de mots de passe auto-hébergé compatible Bitwarden

Partagez cet article !
Défiler vers le haut