跳转到主要内容
目前支持 3 种身份验证方式。配置完成后,你可以使用以下选项登录,如下图所示。
我们强烈建议你使用 OIDC,因为这是最通用的方式。

OIDC 身份验证

SAML 身份验证

LDAP 身份验证

公开访问

reCAPTCHA

密码限制

全局配置

需要通过环境变量 EXTERNAL_AUTH 来启用特定的身份验证模块。该环境变量指定要激活哪些外部身份验证方式。可用选项如下(小写):
  • saml
  • ldap
  • oidc
如果只允许用户通过这些方式登录,请设置 OVERLEAF_DISABLE_LOCAL_LOGIN=true。这会隐藏邮箱和密码登录。除非 EXTERNAL_AUTH 至少启用了一种方式,否则该设置不会生效(6.3.1 中新增)。

账户和密码

设置 EXTERNAL_AUTH 后,实例中可以同时存在有本地密码和没有本地密码的账户。账户能否设置或修改密码只取决于这一点:有本地密码的账户自行管理密码;没有本地密码的账户只能通过 SSO 登录,也无法从管理员处获得密码。在仅使用 OIDC 的实例上,除非设置了 OVERLEAF_DISABLE_LOCAL_LOGIN=true,否则该账户可以通过重置邮件自行设置密码。
  • LDAP 和 SAML 会在首次登录时接管具有相同邮箱的本地账户,并在每次登录时移除其本地密码。如果邮箱不同,则会创建一个新账户,不影响原有的本地账户。
  • 如果首次通过 LDAP、SAML 或 OIDC 登录时使用的邮箱是另一个账户的辅助邮箱,登录会被拒绝:不会登录到那个账户。
  • OIDC 会关联到一个账户并保留其密码,因此关联到 OIDC 的本地账户可以通过两种方式登录。可以在设置页面上点击 Link 进行关联,或者在邮箱匹配时于首次 OIDC 登录时自动关联。关联方法请参见 OIDC 身份验证。
  • 管理员创建为本地账户的账户会收到一封激活邮件:激活账户时设置密码的方式与通过邮件重置密码相同。
  • 启用多种方式时(例如 EXTERNAL_AUTH=ldap saml oidc),上述规则不变:只看账户的本地密码,没有本地密码的账户无法设置密码,由 OIDC 创建的账户也是如此。
  • 如果你的 IdP 会关闭应失去访问权限的账户(例如离职员工的账户),请在使用 OIDC 的实例上设置 OVERLEAF_DISABLE_LOCAL_LOGIN=true:否则设置过本地密码的人在 IdP 关闭账户后仍能登录。
  • 通过邮件重置需要邮件设置(OVERLEAF_EMAIL_*)。没有这些设置时不会发送邮件,尽管页面显示已发送:此时由管理员在 Admin → Manage Users 中复制重置链接或设置密码。
  • OVERLEAF_DISABLE_LOCAL_LOGIN=true 会隐藏邮箱和密码登录,但会保留密码:重新显示该登录方式后,密码可以再次使用。
  • 设置 EXTERNAL_AUTH 后,无论使用哪种方式,用户都无法在设置页面输入新邮箱:用户首次通过 OIDC 登录时,会关联到拥有该用户邮箱的账户。管理员在 Admin → Manage Users 中修改邮箱。配置了邮件设置后,用户可以添加通过验证码确认的邮箱,并在未启用 LDAP 和 SAML 的实例上将其中一个设为主邮箱。
  • 在启用 OIDC 的实例上,请使用通过激活邮件注册,例如 OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain> 或 @*(激活邮件可以证明邮箱地址的所有权),而不是 true,或者不开放公开注册:如果设置为 true,任何人都可以在同事首次 OIDC 登录之前使用该同事的邮箱注册,这会导致同事被关联到该账户。

问答

回答:可以,从 v6.4.0 开始支持。使用 reCAPTCHA v2 隐形密钥设置 RECAPTCHA_SITE_KEY 和 RECAPTCHA_SECRET_KEY,参见 reCAPTCHA。它涵盖邮箱和密码登录、LDAP 登录、注册以及密码重置。更早的版本没有相关设置;所有版本都会对登录进行速率限制:每个 IP 地址每分钟 20 次尝试,每个邮箱每 2 分钟 10 次尝试。
最后修改于 2026年11月13日