产品定价 立即试用
专业版
文档 > 安全 > 安全设置
入门
指南 安装 架构 API 常见问题
目录

安全设置

用户使用用户名和密码登录ThingsBoard。为提升账户安全,可调整安全设置。配置这些设置需使用 System Administrator 账户登录 ThingsBoard

image

通用策略

本部分可配置用户账户的整体安全规则:

  • Maximum number of failed login attempts – 设置账户锁定前允许的失败登录次数。

  • Notification on account lockout – 指定在用户账户被锁定时接收通知的邮箱地址。

  • User activation link TTL – 定义发送给新用户的激活链接有效期(单位:小时)。超过该时间后链接将失效。

  • Password reset link TTL – 设置通过邮件发送的密码重置链接的有效期(单位:小时)。

  • Mobile secret key length – 设定用于移动端认证的密钥长度。

文档信息图标

注意User ActivationPassword Reset 链接的 TTL 可在1至24小时范围内配置。该范围为固定值,不可修改。

密码策略

密码策略规定ThingsBoard用户密码必须满足的规则。可配置以下选项:

  • Minimum password length - 设置密码最少字符数。最小长度范围为6至50;

  • Maximum password length - 设置密码最多字符数。最大长度须大于最小长度;

  • Minimum number of uppercase letters - 设置密码中最少大写字母数;

  • Minimum number of lowercase letters - 设置密码中最少小写字母数;

  • Minimum number of digits - 设置密码中最少数字数;

  • Minimum number of special characters - 设置密码中最少特殊字符数;

  • Password expiration period in days - 强制密码过期。密码过期后,ThingsBoard将要求用户修改密码,以确保用户定期更新;

  • Password reuse frequency in days - 禁止在指定天数内使用相同密码;

  • Allow whitespace - 勾选后,密码中允许包含空格;

  • Force to reset password if not valid - 密码不符合验证规则的用户需通过邮件重置密码。

配置完成后,点击 Save 按钮应用更改。

JWT安全设置

本部分可配置 ThingsBoard 用于认证和会话管理的 JSON Web Token (JWT) 参数。可控制token的生成、过期和签名。

  • Issuer name – 指定JWT token的签发者名称。该值将包含在所有生成的token中,可用于验证其来源。

  • Signing key – 输入Base64编码字符串,表示至少512位数据。该密钥用于签名JWT token并验证完整性。也可使用“Generate key”按钮生成新密钥。

  • Token expiration time – 设置JWT token的有效期(秒)。过期后token失效,用户需重新认证。默认值为9000秒。最小值为60秒。

  • Refresh token expiration time – 设置refresh token的有效期(秒)。Refresh token允许用户在无需重新认证的情况下获取新的JWT token。默认值为604800秒。最小值为900秒。

image

配置完成后,点击 Save 按钮应用更改。

实用建议

  • 配置系统以要求用户使用包含大小写字母、数字和特殊字符的强密码;
  • 实施双因素认证以增强安全性。