产品定价 立即试用
云平台
社区版 专业版 云平台 边缘 PE边缘 IoT网关 许可证服务器 Trendz Analytics 移动应用 PE移动应用 MQTT Broker PE MQTT Broker
欧洲地区
北美地区 弗吉尼亚北部区域 欧洲地区 法兰克福区域
文档 > 安全 > 双因素认证
入门
指南 API 常见问题
目录

双因素认证

双因素认证（2FA）为登录增加一层安全验证。启用2FA后，用户除输入密码外还需完成额外身份验证。

即使凭证泄露，也能显著降低未授权访问风险。

ThingsBoard支持多种2FA验证方式，可由管理员启用和配置，并按tenant选择性启用。

image

双因素认证方式

  • 电子邮箱：登录时，一次性验证码将发送至用户的电子邮箱。要使用基于电子邮箱的2FA，系统管理员应配置一台外发邮件服务器。
  • 短信：登录时，一次性验证码将通过SMS发送至用户的手机号码。要使用基于短信的2FA，系统管理员应配置一个短信提供商。
  • 认证器应用 (TOTP)：基于时间的一次性密码 (TOTP)由外部认证器应用程序生成。用户可以使用流行的应用，如 Google Authenticator、Authy 或 Duo。
  • 备份码：备份码是由用户生成且安全存储的一次性码（可下载或打印）。备份码只能与至少一个其他已启用的2FA方法配合使用，不能作为独立的认证方式配置。

配置双因素认证

租户管理员 可以使用系统管理员的2FA配置，也可以为自己和用户定义自定义2FA配置。

配置2FA：

  • 以 租户管理员 身份登录ThingsBoard。
  • 导航至\u201cSecurity\u201d→\u201cTwo-factor authentication\u201d。
  • 取消选中”Use system two factor auth settings”以配置租户特定的设置。
  • 启用一个或多个验证方法：
    • 认证器应用
    • 短信
    • 电子邮箱
    • 备份码
  • 配置提供商特定的选项，例如：
    • 验证限制
    • 验证码检查速率限制
  • 点击”Save”保存配置。

说明： 最终用户可用的2FA方式取决于本页配置。

以租户管理员身份登录ThingsBoard。<br>- 导航至<b>Security</b> ⇾ <b>Two-factor authentication</b> (1)。<br>- 取消选中"Use system two factor auth settings"标签的框(2)。
以租户管理员身份登录ThingsBoard。
- 导航至Security ⇾ Two-factor authentication (1)。
- 取消选中"Use system two factor auth settings"标签的框(2)。
- 选择一个或多个2FA验证方法(3)，设置验证消息模板、验证码有效期、验证总允许时间等详细信息。<br>- 保存更改(4)以应用配置。
- 选择一个或多个2FA验证方法(3)，设置验证消息模板、验证码有效期、验证总允许时间等详细信息。
- 保存更改(4)以应用配置。

为用户账号启用2FA

用户可使用管理员配置的一种或多种方式为自身账号启用2FA。

以用户身份启用2FA：

  • 登录ThingsBoard。
  • 点击右上角用户菜单（三个点）并选择\u201cAccount\u201d。
  • 进入\u201cSecurity\u201d选项卡。
  • 启用一种或多种可用2FA方式并完成设置步骤。
登录ThingsBoard。<br>打开右上角的用户菜单（三个点）(1)，选择"Account"(2)。
登录ThingsBoard。
打开右上角的用户菜单（三个点）(1)，选择"Account"(2)。
导航至"Security"选项卡(3)。启用一个或多个可用的2FA方法并完成设置步骤(4)。
导航至"Security"选项卡(3)。启用一个或多个可用的2FA方法并完成设置步骤(4)。
文档信息图标

重要提示！ 可用的2FA选项列表取决于“双因素认证”页面上的设置。

Authenticator app（认证应用）

启用认证应用验证：

  • 打开\u201cAccount\u201d→\u201cSecurity\u201d。
  • 启用Authenticator app认证。
  • 在手机打开认证应用。
  • 扫描显示的二维码。
  • 输入应用生成的6位验证码。
  • 点击\u201cDone\u201d。
启用认证器应用身份验证(1)。
启用认证器应用身份验证(1)。
在手机上打开认证器应用(2)，点击"Next"(3)。
在手机上打开认证器应用(2)，点击"Next"(3)。
用验证应用扫描显示的二维码(4)。
用验证应用扫描显示的二维码(4)。
输入应用生成的6位代码(5)，点击"Next"(6)。
输入应用生成的6位代码(5)，点击"Next"(6)。
点击"Done"(7)。
点击"Done"(7)。
身份验证应用2FA已启用。
身份验证应用2FA已启用。

使用认证应用登录：

  • 输入用户名和密码。
  • 输入认证应用生成的6位验证码。
登录时，用户首先输入他们的电子邮件和密码(1)。
登录时，用户首先输入他们的电子邮件和密码(1)。
之后，用户必须输入认证器应用生成的安全代码(2)，点击"Continue"(3)。
之后，用户必须输入认证器应用生成的安全代码(2)，点击"Continue"(3)。

SMS验证

启用SMS验证：

  • 打开\u201cAccount\u201d→\u201cSecurity\u201d。
  • 启用SMS认证。
  • 输入手机号。
  • 输入通过SMS收到的6位验证码。
  • 点击\u201cDone\u201d。
启用SMS身份验证(1)。
启用SMS身份验证(1)。
输入有效的电话号码(2)，点击"Send code"(3)。
输入有效的电话号码(2)，点击"Send code"(3)。
输入来自验证SMS的6位代码(4)，然后点击"Activate"(5)。
输入来自验证SMS的6位代码(4)，然后点击"Activate"(5)。
用户下次登录时，需要输入来自SMS的代码。点击"Done"(6);
用户下次登录时，需要输入来自SMS的代码。点击"Done"(6);
SMS 2FA已启用。
SMS 2FA已启用。

使用SMS登录

登录时：

  • 输入用户名和密码。
  • 输入通过SMS收到的验证码。
登录时，用户首先输入他们的电子邮件和密码(1)。
登录时，用户首先输入他们的电子邮件和密码(1)。
之后，用户必须输入来自SMS消息的安全代码(2)，点击"Continue"(3)。
之后，用户必须输入来自SMS消息的安全代码(2)，点击"Continue"(3)。

邮箱验证

启用邮箱验证：

  • 打开\u201cAccount\u201d→\u201cSecurity\u201d。
  • 启用Email认证。
  • 输入通过邮箱收到的6位验证码。
  • 点击\u201cDone\u201d，然后\u201cSave\u201d。
启用电子邮件身份验证(1)。
启用电子邮件身份验证(1)。
输入电子邮件以接收密钥(2)，点击"Send code"(3)。
输入电子邮件以接收密钥(2)，点击"Send code"(3)。
输入来自验证电子邮件的6位代码(4)，然后点击"Activate"(5)。
输入来自验证电子邮件的6位代码(4)，然后点击"Activate"(5)。
点击"Done"(6)。
点击"Done"(6)。
电子邮件2FA已启用;
电子邮件2FA已启用;

使用邮箱登录：

  • 输入用户名和密码。
  • 输入通过邮箱收到的验证码。
登录时，用户首先输入他们的电子邮件和密码(1)。
登录时，用户首先输入他们的电子邮件和密码(1)。
之后，用户必须输入来自其邮箱中传入电子邮件的安全代码(2)，点击"Continue"(3)。
之后，用户必须输入来自其邮箱中传入电子邮件的安全代码(2)，点击"Continue"(3)。

Backup codes（备份码）

当其他2FA方式不可用时（例如手机丢失），备份码可作为替代认证方式。

注意： 此方式仅能与至少一种其他已启用的2FA方式配合使用，不能单独作为认证方式。

生成备份码：

  • 打开\u201cAccount\u201d→\u201cSecurity\u201d。
  • 启用backup codes认证。
  • 下载或打印生成的备份码并安全保存。
  • 点击\u201cDone\u201d。

每个备份码仅能使用一次。

启用备份代码身份验证(1)。
启用备份代码身份验证(1)。
下载或打印生成的备份代码(2)并安全地保存它们。点击"Done"(3)。
下载或打印生成的备份代码(2)并安全地保存它们。点击"Done"(3)。
备份代码2FA已启用。
备份代码2FA已启用。

使用备份码登录：

  • 输入用户名和密码开始登录。
  • 点击\u201cTry another way\u201d。
  • 选择\u201cBackup code\u201d。
  • 输入列表中未使用的备份码。
  • 点击\u201cContinue\u201d。
登录时，用户首先输入他们的电子邮件和密码(1)。
登录时，用户首先输入他们的电子邮件和密码(1)。
点击"Try another way"(2)。
点击"Try another way"(2)。
Select "Backup code" (3).
Select "Backup code" (3).
After that, the user must enter a valid 8-digit code from their backup codes list (4), and click "Continue" (5).
After that, the user must enter a valid 8-digit code from their backup codes list (4), and click "Continue" (5).

下一步