更新时间:2024-07-01
1功能简介
1.1应用场景
控制器对接移动云mas短信平台,以实现短信认证功能
1.2适用版本
NAC3.13.0
1.3配置思路
简述配置此功能的几大步骤。
一、普通短信对接
1、短信平台创建接口
2、控制器上配置
3、短信模板配置
4、请求模板内容填写
5、认证短信内容配置
二、模板短信对接
1、短信平台创建接口
2、控制器上配置
3、短信模板配置
4、请求模板内容填写
5、接受模板参数填写
6、短信认证短信内容配置
2注意事项
2.1配置注意事项
1、控制器可以联通外网,并且可以正常解析域名
2、控制器系统时间需要和现实时间一致,可以同步NTP服务器时间
3、控制器需要打上对接移动云MAS短信网关KB包(KB包在文档最后)
3普通短信对接步骤
3.1短信平台创建接口
1、登录移动云平台(https://mas.10086.cn/login),登录平台(账号信息由平台提供),在【管理】--【接口】管理创建接口账号,如图
然后点下面保存,接口账号就创建好了。“注意:协议务必选 HTTP,用户名为文档中 apid 参数,用户密码为文档中 secretKey 参数,集团名称为文档中的 ecname 参数。”
2、签名下载对应文档中的sign值。
“注意:是否可扩展选项为“是”的话,不支持扩展码,此 addSerial 参数要为空;是否可扩 展选项为“否”的话,支持扩展码,此 addSerial 参数可以根据自己业务需要添加(一般为 5 到 6 位的数字)。整体长度为:服务代码+扩展码<=20 位的数字。”
3.2控制器上配置
1、点击【系统管理】-【服务管理】-【短信设置】,勾选【启用短信服务】、【短信网关】,发送参数的网关类型选择HTTP协议
URL地址:http://112.35.1.155:1992/sms/norsubmit
Content-Type:application/x-www-form-urlencoded
2、请求模板内容填写
{"addSerial":"","apId":"","content":"$$SMS_CONTENT$$","ecName":"","mac":"$$CUSTOM_MAC$$","mobiles":"$$MOBILE_NUM$$","secretKey":"","sign":""}
注:以下参数需要填写下列对应值(wac请求模板中的参数),其它参数需填写对应客户的值(比如apId和sign值要写上客户自己的参数)
content:$$SMS_CONTENT$$
mac:$$CUSTOM_MAC$$(接收模板的MD5值)
mobiles:$$MOBILE_NUM$$
2.2.3接收模板内容填写
将mac值的组合的值从前到后按依次顺序填进去即可
举例说明:
比如ecname为信锐公司,apid为sundray,secretkey为sundray123,sign为HKksad123
最终接收模板为
信锐公司sundraysundray123$$MOBILE_NUM$$$$SMS_CONTENT$$HKksad123
字段注释:
3、认证短信内容配置
4模板短信对接步骤
4.1短信平台创建接口
1、登录移动云平台(https://mas.10086.cn/login),登录平台(账号信息由平台提供),在【管理】-【接口】管理创建接口账号,如图
然后点下面保存,接口账号就创建好了。“注意:协议务必选HTTP,用户名为文档中apid参数,用户密码为文档中secretKey参数,集团名称为文档中的ecname参数”
2、签名下载(就是文档中的sign参数)
“注意:是否可扩展选项为“是”的话,不支持扩展码,此addSerial参数要为空;是否可扩展选项为“否”的话,支持扩展码,此addSerial参数可以根据自己业务需要添加(一般为5到6位的数字)。整体长度为:服务代码+扩展码<=20位的数字。”
3、创建短信模板—生成短信参数得模板ID
查看短信类型是模板短信
说明:相对于普通短信来说,模板短信需要额外申请一个模板,申请之后需要等短信平台审批之后才可以生成模板ID。
4.2控制器上配置
1、短信模板配置
2、URL地址:http://112.35.1.155:1992/sms/tmpsubmit
Content-Type:application/x-www-form-urlencoded
3、请求模板内容填写
{"addSerial":"","apId":"","secretKey":"","ecName":"","mac":"$$CUSTOM_MAC$$","mobiles":"","params":"[\"$$SMS_CONTENT$$\"]","sign":"","templateId":""}
注:以下参数需要填写下列对应值(nac请求模板中的参数),其它参数需填写对应客户的值(比如apId和sign值要写上客户自己的参数)
mac:$$CUSTOM_MAC$$(接收模板的MD5值)
params : [\"$$SMS_CONTENT$$\"]
4、接收模板参数填写
将mac值的组合的值从前到后按依次顺序填进去即可
接收模板示例(请勿使用示例参数,填写客户自己的真实参数)
接收模板举例说明
字段注释:
5、短信认证短信内容配置
5测试短信格式
短信内容统一按这个纯数字格式测试。
6效果演示
对接成功之后,终端进行短信认证可以收到验证码提示。
7接口文档附件以及控制器KB包
此附件为接口文档附件,有更详细的说明,如果上述步骤配置完还有其他疑问或者遇到故障需要排错,可以参考此文档。
控制器对接移动云MAS需要打上此KB包(控制器如果存在其他KB包,请拨打400-878-3389核实该KB包是否和现有KB包是否存在冲突)