
Authentification OIDC
Authentification SAML
Authentification LDAP
Accès public
reCAPTCHA
Restrictions sur les mots de passe
Configuration globale
La variable d’environnementEXTERNAL_AUTH est requise pour activer le module d’authentification correspondant. Elle indique quelles méthodes d’authentification externes sont activées. Les options disponibles sont (en minuscules) :
- saml
- ldap
- oidc
OVERLEAF_DISABLE_LOCAL_LOGIN=true. Cela masque la connexion par e-mail et mot de passe. Ce paramètre n’a aucun effet si EXTERNAL_AUTH n’active pas au moins une méthode (ajouté dans la version 6.3.1).
Comptes et mots de passe
LorsqueEXTERNAL_AUTH est défini, une instance peut contenir des comptes avec et sans mot de passe local. Le fait qu’un compte puisse définir ou modifier un mot de passe ne dépend que de cela : un compte avec un mot de passe local le gère, un compte sans mot de passe local se connecte uniquement via SSO et ne peut pas en obtenir un auprès d’un administrateur. Sur une instance dont OIDC est la seule méthode, il peut en définir un lui-même avec un e-mail de réinitialisation, sauf si OVERLEAF_DISABLE_LOCAL_LOGIN=true.
- LDAP et SAML reprennent le compte local ayant la même adresse e-mail lors de sa première connexion, et suppriment son mot de passe local à chaque connexion. Avec une autre adresse e-mail, ils créent un nouveau compte et ne touchent pas au compte local.
- Une première connexion LDAP, SAML ou OIDC dont l’adresse e-mail est une adresse e-mail secondaire d’un autre compte est refusée : elle ne connecte pas à ce compte.
- OIDC se lie à un compte et conserve son mot de passe : un compte local lié à OIDC peut donc se connecter des deux manières. La liaison se fait avec Link sur la page des paramètres, ou lors de la première connexion OIDC lorsque l’adresse e-mail correspond. Consultez Authentification OIDC pour la liaison.
- Un compte qu’un administrateur crée en tant que compte local reçoit un e-mail d’activation : l’activer définit son mot de passe de la même manière qu’une réinitialisation par e-mail.
- Lorsque plusieurs méthodes sont activées, par exemple
EXTERNAL_AUTH=ldap saml oidc, les règles ci-dessus restent les mêmes : seul le mot de passe local du compte compte, et un compte sans mot de passe local ne peut pas en définir un, y compris un compte créé par OIDC. - Si votre IdP ferme les comptes qui doivent perdre l’accès, comme ceux d’anciens employés, définissez
OVERLEAF_DISABLE_LOCAL_LOGIN=truesur une instance OIDC : sinon, une personne ayant défini un mot de passe local peut toujours se connecter après la fermeture du compte par l’IdP. - La réinitialisation par e-mail nécessite les paramètres d’e-mail (
OVERLEAF_EMAIL_*). Sans eux, aucun e-mail n’est envoyé, bien que la page l’indique : un administrateur copie alors un lien de réinitialisation ou définit le mot de passe dans Admin → Manage Users. OVERLEAF_DISABLE_LOCAL_LOGIN=truemasque la connexion par e-mail et mot de passe, mais conserve les mots de passe : ils fonctionnent à nouveau lorsque la connexion est de nouveau affichée.- Lorsque
EXTERNAL_AUTHest défini, les utilisateurs ne peuvent pas saisir une nouvelle adresse e-mail sur la page des paramètres, quelle que soit la méthode : la première connexion OIDC d’un utilisateur associe le compte qui possède son adresse e-mail. Les administrateurs modifient les adresses e-mail dans Admin → Manage Users. Avec les paramètres d’e-mail, les utilisateurs ajoutent des adresses e-mail qu’ils confirment avec un code, et peuvent en définir une comme principale sur une instance sans LDAP ni SAML. - Sur une instance avec OIDC, utilisez l’inscription avec e-mail d’activation, par exemple
OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain>ou@*(l’e-mail d’activation prouve l’adresse) plutôt quetrue, ou désactivez l’inscription publique : avectrue, n’importe qui pourrait s’inscrire avec l’adresse e-mail d’un collègue avant la première connexion OIDC de ce dernier, ce qui lierait le collègue à ce compte.
Questions/réponses
Puis-je activer un CAPTCHA pour la connexion ou l'inscription ?
Puis-je activer un CAPTCHA pour la connexion ou l'inscription ?
Réponse : Oui, à partir de la version 6.4.0. Définissez
RECAPTCHA_SITE_KEY et RECAPTCHA_SECRET_KEY à partir d’une clé reCAPTCHA v2 invisible, voir reCAPTCHA. Cela couvre la connexion par e-mail et mot de passe, la connexion LDAP, l’inscription et la réinitialisation du mot de passe. Les versions antérieures ne proposent aucun paramètre à cet effet ; les connexions sont limitées en débit dans toutes les versions : 20 tentatives par minute par adresse IP et 10 tentatives toutes les 2 minutes par adresse e-mail.
