SANGFOR_ACSG WebService短信认证配置指导_20140106.pdfVIP

AC/SG WebService 短信认证配置指导 深信服电子科技有限公司 2013 年9 月11 日 深信服科技 提升带宽价值 第1 章 WebService 简介 AC/SG 从4.6 版本开始用户认证支持短信认证方式，发送短信的方式有短信猫、外置短信 网关、WebService 等，本文重点讲解WebService 短信认证的配置指导。 短信认证的WebService，其原理就是向某个URL 地址传递一些参数，WebService 短信 网关的接口接收到这些参数后就会根据参数发送短信。 在配置WebService 的过程中，需要用到wsdl 文件（HTTP GET 和HTTP POST 方式的不 需要）。wsdl 文件是描述WebService 的接口信息的文件，里面包含了WebService 短信网 关发短信、收短信等接口的xml 信息。我们设备上可以通过此wsdl 文件生成短信模板，将 文件中发短信的接口的xml 剥离出来，后续设备发短信的时候就会根据这个xml 来向指定的 URL 传递参数。 第2 章 WebService 配置介绍 客户使用 WebService 短信平台接口与 AC 相结合进行认证，一般情况下，客户会提供 WebService 接口文档。 1、 配置WebService 基本信息 通过客户给予的文档，可以得出WebService 接口URL 一般格式为: http://IP/services/cmcc_mas_wbs 再根据客户提供的WebService 接口文档（或者咨询第三方），确认客户使用的SOAP 的版本 （SOAP1.1 或SOAP1.2）与请求类型（POST 或GET），进行如下的配置： 深信服科技 提升带宽价值 2、配置WebService 发送短信模板 通过http://IP/services/cmcc_mas_wbs？wsdl 文件（一般情况下就是在WebService 接口URL 后面加个“?wsdl”即可获取到wsdl 文件），这个文件是网页形式的，从浏览器中 导出为html 即可。将此wsdl 文件导入设备，根据客户提供的接口资料判断发送短信的接口 是sendSms （注：这个接口名称特别重要，否则生成提取不了短信模版，不同短信平台可能 不一样，需要根据wdsl 判定），在接口名称中填入sendSms，接收模板客户无特殊要求， 填入200，或者不填。 点击生成请求模版之后，在请求模版里面会生成如下信息： 深信服科技 提升带宽价值 根据客户提供的WebService 接口文档，结合我们的参数变量，对各参数进行修正，将模板 中的固定值替换成我们设备规定的参数变量，修正后如下： 其中： ApplicationID 为MAS 机短信网关上配置的应用ID 或插件ID （需要登录到短信网关上查 看） ExtendCode 指由该应用填写的内部扩展号码，在应用ID 或插件ID 之后显示，这个需要与 第三方进行沟通确认是否开启了这个参数。 DestinationAddress 与 Message 两个参数按照配置短信模版右边的参数修改即可。 MessageFormat 指消息编码类型，一般为 ASCII ，本例为 GB2312(可以咨询第三方)。 SendMethod 指发送消息选项，一般有Normal,本例为Long(可以咨询第三方)。 点击测试，如果能收到短信则大功告成，如果还不行则需检查参数是否正确，需要和第三方 短信厂商沟通参数是否正确（有些短信网关厂商会有demo，可以使用demo 发送短信，再抓 包对比参数） 深信服科技 提升带宽价值 第3 章 HTTP GET 或HTTP POST 配置介绍 客户使用的是http get 或者http post 的短信认证，就需要第三方提供HTTP 文档（类似： 基于双向HTTP 协议接入-使用手册） 1、找到HTTP 文档的如下内容 （注：每个厂家都有可能不相同，但是都是类似的） /GsmsHttp?username=1234password=4