ThingBoard教程（三）：系统设置模块的使用

系统设置模块的使用

上一篇我们讲到了，使用系统管理员登录系统后，对租户，租户配置，部件组模块的操作 这三个部分在平台管理中占据这很重要的地位。特别是部件组模块。还没了解的读者可以先看看上一篇 ThingBoard教程（二）：租户，租户配置，部件组模块的使用

今天这篇我将给大家讲解一下，使用系统管理员登录系统后，对系统做一些定制化操作。设置。包括安全类，邮件，OAuth2。

本篇文章主要讲的内容有这些，

基本设置 发送邮件 SMS服务商 安全设置 OAuth2 基本设置模块

基础设置模块只有二个配置项，即基本URL，和是否禁止从客户端请求头中使用主机名

改项目我是在Windows上使用docker启动的，docker是在虚拟机里跑的，ip与宿主机不一样， 真正的访问路径是 http://192.168.99.102:8080 所以我们要把 http://localhost:8080 改成 http://192.168.99.102:8080

目前我也没搞懂这里的配置项有什么用。

发送邮件模块

发送邮件模块是用于配置邮件发送方和SMTP协议，以及主机和端口。 默认的情况下邮件配置如下图的。底部有一个发送测试邮件，试了一下，果然不行。

目前系统中有几处发送邮件的，告警，激活账号，就是一个租户管理员创建了一个客户，让这个客户激活该账号， 可以选择给他发送一封邮件，或者生成一个激活链接给他。 如下图

那么这里的邮件配置 到底要怎么配那？

首先使用默认的系统管理员用户登录系统，点击右上角的属性按钮，修改系统管理员的电子邮件，

修改之后重新登录系统。使用刚刚修改的电子邮箱。

只是修改系统管理员的电子邮件还不行，你还要正确配置STMP选项才能正确发送邮件。 目前官方提供了二种配置电子邮件的方式，一是Sendgrid配置示例 二是Gmail配置示例

这里我就使用谷歌邮箱Gmail来演示一下，

谷歌的STMP配置参数

在TB中配置

SMS服务商模块

SMS服务上设置其实就是短信平台的设置，目前只支持亚马逊和Twilio二个平台。 如果需要国内的SMS服务商，可以自己开发。 有关SMS的设置，可以查阅官方的帮助文档

安全设置模块

安全模块就是为了防止被人暴力破解，和引导用户加强密码请到的配置

可以配置的项有

登录失败之前的最大登录尝试次数 如果用户账号锁定，请发送通知到电子邮件 最小的密码长度，默认6位 最小大写字母数 最小小写字母数 最小位数 最小特殊字符数 密码有效期（天） 密码重用频率(天) OAuth2模块

OAuth2模块是用于配置多系统单点登录。

ThingsBoard允许你为客户提供单一登录功能，并使用支持OAuth 2.0协议的外部用户管理平台自动创建租户，客户或子客户。 支持OAuth 2.0协议的平台列表：Google，Okta，Auth0等。

基本的流程是这个样子的

ThingsBoard支持授权码授予类型，以交换访问令牌的授权码。 用户通过重定向URL返回ThingsBoard客户端后，平台将从URL获取授权代码，并将其用于从外部用户管理平台请求访问令牌。使用基本映射器或自定义映射器，外部用户信息对象将从外部平台转换为ThingsBoard内部OAuth 2.0用户。此后，将发生常规的ThingsBoard授权流程。

官方提供了二种详细的配置OAuth2模块的方式，一种是Google，一种是OAuth0

使用谷歌的场景描述

使用Google身份验证。用户将登录到租户，并且租户名称将等于用户的电子邮件。如果系统中不存在租户，则将创建新的租户。

第二步，我们将添加新的身份验证外部提供者Auth0。在这种情况下，用户将登录到租户，该租户的名称将等于用户电子邮件域名。此外，对于每个用户，我们将创建一个新的客户，并且客户名称将等于用户电子邮件。

要从Google和Auth0平台映射该外部用户信息，我们将使用内置的基本mapper。

如果基本的映射器功能不适合您的业务需求，则可以配置自定义映射器，以便您可以添加满足特定需求的实现。

以下是配置谷歌OAuth2.0的步骤 设置谷歌OAuth2.0 凭据

配置OAuth2.0

最后结果

结束语

今天的文章就写到这里了，相信大家读了这篇文章一定对TB的发送邮件模块，安全设置OAuth2模块， 有了大致的了解。 下一篇我会给大家讲解一下，使用如何常见一个租户，以及租户管理员操作的那些模块

创作不易，那么多字，在不开空调的房间，手都快冻僵了，为了分享知识，我也是蛮拼的。如果对你有帮助，还请多多支持，点赞收藏，打赏更好。你的点滴鼓励就是我支撑我继续分享的动力。谢谢各位读者。