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包是否存在冲突）