跳转到内容

双重身份验证

← 返回文档索引

双重身份验证(2FA)为登录增加了第二个步骤:在输入密码后,您需要输入手机上身份验证器应用生成的6位数字代码。即使有人知道了您的密码,没有您的设备也无法登录。

它兼容任何标准的TOTP身份验证器(如Google Authenticator、Authy、1Password、Microsoft Authenticator等),并且所有账户都可以使用,不仅仅是管理员。保护您自己的登录信息并非服务器管理操作,因此查看者和操作员也可以启用它。

打开账户菜单(您的头像或个人资料图片,右上角),然后选择 2FA。

账户菜单

您将看到一个注册对话框:

注册

  1. 使用您的身份验证器应用扫描二维码,或者点击复制手动输入密钥。
  2. 输入您的应用当前显示的6位数字代码。
  3. 确认您的密码。启用2FA会重新验证您的密码,因此一个未关闭的会话无法在他人设备上启用它。
  4. 点击 启用。

启用2FA后,面板会立即显示一组一次性的备用代码。

备用代码

每个代码只能使用一次,用于在您丢失身份验证器应用访问权限时登录。请将它们保存在安全的地方(密码管理器是理想选择),因为它们不会再次显示。您可以随时重新生成一组新的代码(旧代码将失效)。

此后,登录将需要第二个步骤。在输入用户名和密码后,面板会要求您输入代码:

2FA登录

输入您应用中的当前6位数字代码(或其中一个备用代码),即可登录。在完成此步骤之前,会话未登录:无法访问任何页面或API。

在2FA启用时,通过账户菜单中的相同 2FA 条目进行操作。在确认密码后,您可以:

  • 重新生成备用代码:生成一组新代码并使旧代码失效。
  • 禁用2FA:从您的账户中移除2FA。

两者都会先重新验证您当前的密码。

管理员可以从 设置 → 用户(在该用户的操作菜单中点击 重置2FA)重置其他用户的2FA。这将清除该账户的2FA设置,使用户能够仅凭密码登录并重新设置。管理员无法重置自己的2FA。他们需要通过正常的密码验证流程来禁用2FA,因此被劫持的管理员会话无法移除自身的二次验证。

  • 代码是基于时间的,每30秒轮换一次;面板允许轻微的时钟偏差,并在服务器时钟校正后悄悄恢复。
  • 代码不能重放:一旦用于登录,在有效期内该代码将不再有效。
  • 错误代码会受到速率限制。限制器与密码步骤共享(包括每个账户的锁定以及每个IP的RATE_LIMIT_AUTH_PER_15MIN限制器),因此在猜测6位数字代码之前输入正确的密码无法重置计数器。
  • 2FA的更改(启用、禁用、重置、使用备用代码)都会记录在活动日志中。