更新时间:2023-12-07
1云MAS功能概述
本文阐述了我司网络控制器NAC对接中国移动云MAS短信业务平台实现短信认证的具体配置流程、配置信息和注意事项。
目前3.7.4.2以上版本均支持对接,需要补丁支持,可通过办事处或者400获取对应版本的补丁包,获取后需要在【系统维护】-【系统更新】-【控制器升级】-【补丁包升级】打上对应的补丁包才可以对接。
说明:中国移动云MAS通常有两种短信接口,一种是普通短信,一种是模板短信,具体对接哪种取决于客户购买的时候是买的哪种,可以根据客户购买的短信平台账号找对应的短信平台技术确认清楚,再进行对接。
接下来将根据两种不同的短信接口的对接过程进行配置说明讲解。
2 普通短信对接步骤
2.1 短信平台创建接口
1,登录云mas平台(http://112.35.2.24:18888/masmgc/login),在管理--->接口管理创建接口账号,如图:


然后点下面保存,接口账号就创建好了。注:协议务必选HTTP,用户名为文档中apid参数,用户密码为文档中secretKey参数,集团名称为文档中的ecname参数
2,签名下载(就是文档中的sign参数):


注:是否可扩展选项为“是”的话,不支持扩展码,此addSerial参数要为空;是否可扩展选项为“否”的话,支持扩展码,此addSerial参数可以根据自己业务需要添加(一般为5到6位的数字)。整体长度为:服务代码+扩展码<=20位的数字。
2.2 控制器上配置
2.2.1短信模板配置
URL地址:http://112.35.1.155:1992/sms/norsubmit
Content-Type:application/x-www-form-urlencoded


2.2.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
字段注释:

2.2.4认证短信内容配置

3 模板短信对接步骤
3.1 短信平台创建接口
1,登录云mas平台(http://112.35.2.24:18888/masmgc/login),在管理--->接口管理创建接口账号,如图:


然后点下面保存,接口账号就创建好了。注:协议务必选HTTP,用户名为文档中apid参数,用户密码为文档中secretKey参数,集团名称为文档中的ecname参数
2,签名下载(就是文档中的sign参数):


注:是否可扩展选项为“是”的话,不支持扩展码,此addSerial参数要为空;是否可扩展选项为“否”的话,支持扩展码,此addSerial参数可以根据自己业务需要添加(一般为5到6位的数字)。整体长度为:服务代码+扩展码<=20位的数字。
3.创建短信模板—生成短信参数得模板ID
查看短信类型是模板短信

说明:相对于普通短信来说,模板短信需要额外申请一个模板,申请之后需要等短信平台审批之后才可以生成模板ID.


3.2 控制器上配置
3.2.1短信模板配置
URL地址:http://112.35.1.155:1992/sms/tmpsubmit
Content-Type:application/x-www-form-urlencoded

3.2.2请求模板内容填写

{"addSerial":"","apId":"","secretKey":"","ecName":"","mac":"$$CUSTOM_MAC$$","mobiles":"","params":"[\"$$SMS_CONTENT$$\"]","sign":"","templateId":""}
注:以下参数需要填写下列对应值(nac请求模板中的参数),其它参数需填写对应客户的值(比如apId和sign值要写上客户自己的参数)
mac:$$CUSTOM_MAC$$(接收模板的MD5值)
params : [\"$$SMS_CONTENT$$\"]
3.2.3接收模板参数填写
将mac值的组合的值从前到后按依次顺序填进去即可

接收模板示例(请勿使用示例参数,填写客户自己的真实参数)
接收模板举例说明


字段注释:

3.2.4短信认证短信内容配置

4 测试短信格式
短信内容统一按这个纯数字格式测试。

5 中国移动云MAS接口文档附件
此附件为接口文档附件,有更详细的说明,如果上述步骤配置完还有其他疑问或者遇到故障需要排错,可以参考此文档。