短信

1 概述

1.1 版本

1.2 功能简介

在乐创者系统中，手机验证登录、信息通知等场景需要用到手机短信功能，常用的短信通道为阿里云短信，为满足客户个性化需求，比如：客户自身有一套发短信服务，则希望使用自身的短信服务，因此，我们也提供了自定义短信可以与第三方短信对接。

2 门户配置

管理员administrator登录乐创者门户，进入“第三方平台＞短信”菜单，可定义多套短信，如下图：

点击“新建”进入配置界面，如下图：

其中，服务提供商支持两种类型：阿里云和自定义，可按需进行选择。
1）阿里云短信配置

需要配置AccessKey Id 和 AccessKey Secret，用于访问身份验证，在阿里云[访问控制]或[AccessKey管理]模块申请。

2）自定义短信配置

需要配置“类名”，即自定义发送短信类，前缀必须是“com.datanew.sms.”，短信类需要按业务自主实现并放到乐创者程序中。
初始化参数为自定义参数。
自定义短信具体操作过程请参考文档：https://lczdev.yuque.com/tv2x3d/wczk2g/rbaw27lmdnzcc9n5

3 应用

3.1 二次验证

用于普通用户使用账号密码登录进行二次验证。具体配置和使用请参考文档：二次验证

3.2 短信登录

短信登录的模板，用于通过手机短信验证登录系统。
1）开启“短信登录”并配置短信登录模板

选择“第三方系统》短信”中配置的短信平台，再配置对应的模板。

2）在登录界面，切换“短信登录”

3）输入手机号码，获取短信验证码，登录系统

3.3 忘记密码

忘记密码的模板，用于系统中的“忘记密码”功能，短信验证通过后，你可以修改密码。
1）开启“忘记密码”并配置忘记密码短信模板

2）若忘记登录密码，登录不了系统。则可以点击“忘记密码”，手机验证后，修改密码

3）输入手机号码、新密码和手机短信验证码，通过后，则密码修改成功

“短信登录”和“忘记密码”的短信模板都属于验证码类型，申请的时候注意。
在阿里云平台申请好短信签名和短信模板后，在此填入 短信签名 和 模板ID。

注意：这两个模板中都需定义验证码变量 “no”，以在模板中显示验证码。

3.4 自主注册

用于多租户环境下，租户注册时的短信验证。
开启“忘记密码”并配置忘记密码短信模板。

3.5 报表

1）短信验证控件
登录设计器，为单元格表单添加短信验证控件，如下图：

点击可进入控件配置界面，如下图：

选择“第三方系统》短信”中配置的短信平台，再配置对应的模板，选择自定义类型的短信平台时，需要自定义配置模板内容，如下图：

2）报表事件
报表全局事件、按钮事件的事件类型选择“短信发送”，选择“第三方系统》短信”中配置的短信平台，再配置对应的模板。