深信服短信认证短信接口说明

深信服短信认证短信接口说明

作者:admin 来源: 日期:2019/7/25 13:56:11

深信服-云信通企业信使短信配置说明

名词说明:

1. WEBSERVICE

一种服务导向架构的技术,通过标准的 Web 协议提供服务,目的是保证不同平台的应用服务可以相互操作。根据 W3C 的定义,WEBSERVICE 应当是一个软件系统,用以支持网络间不同机器的互动操作。WEBSERVICE   通常是许多应用程序接口(API)所组成的,通过网络在远程服务器端执行客户端所提交服务的请求。

2. SOAP

简单对象访问协议(SOAP,全写为 Simple Object Access Protocol),一个基于 XML的可扩展消息信封格式,需同时绑定一个传输用协议。这个协议通常是 HTTP 或 HTTPS, 但也可能是 SMTP 或 XMPP。

3. WSDL

一个 XML 格式文档,用以描述程序(服务)接口访问方式和使用协议的细节,通常用来辅助生成服务器和客户端代码及配置信息。

信息准备:
1. WEBSERVICE 服务器请求地址,SOAP 版本(SOAP1.1/SOAP1.2),请求类型(GET/POST)等。
2. 短信发送模版等相关文档,包括:
a) 短信接口描述 WSDL 文件,WSDL(Web Services Description Language 的缩写) 是一个用来描述 Web 服务和说明如何与 Web 服务通信的 XML 语言,也就是为用户提供详细的接口说明书。
b) 短信接口说明使用文档及相关参数信息
c) 其他系统正常发送短信的实际配置实例或抓包结果
 

配置步骤:

1. [认证服务器]-新增[短信认证]

2. 短信内容默认。但是默认短信内容中<VERIFYURL>这个字段会在短信内容中产生冒号
(:)、斜杠(/)以及 AND(&)等符号,通常在 WEBSERVICE  中有特殊含义,我们没有进行转义处理,服务器会返回 500 Internal Server Error。所以通过 WEBSERVICE 发送短信时建议先将这一段话去掉。

 
短信认证可以做免认证
短信认证可以做短信后微信连 wifi 认证
3. 默认选择通过设备内置短信模块发送

4. 参数设定,网关类型选择“HTTP 协议”
5.帐号密码可以直接到云信通平台11467.cn注册开通 企业ID  帐号   密码
参数说明:
(1) 发短信国家码可选,根据短信平台要求勾选
(2) URL 地址,请求 WEBSERVICE 的完整 URL
(3) 页面编码,通常为 UTF-8
(4) SOAP 版本,包括 1.1、1.2 两个版本,主要是请求头部的差别,通常是用 SOAP1.1
(5) 请求类型,通过 GET 或者 POST 请求发送短信,通常都是 POST 方式

(6) 配置短信模版


配置短信模版:


接口名称:WSDL 文件中定义的发送短信的函数接口,如 sendSMS

WSDL 文件:上传 WSDL 文件,用于解析请求模版

点击“浏览”选择本地的 WSDL 或 XML 格式的文件,输入其中定义的发送短信的接口名称后,点击“生成请求模版”,在“请求模版”文本框中会自动生成短信请求,也可以手动输入请求内容。

自动生成的短信请求模版中,只包含了各个接口参数的名称,不包含参数内容,内容需     要根据相关接口文档具体填写。个别参数需要用我们的参数变量进行替换,例如手机号码需     要替换为$$MOBILE_NUM$$

“接收模版”这个只是给设备定义怎样算是发送成功的,设备向 WEBSERVICE 发送短信请求后,会解析服务器返回的结果,结果中包含对应的字段,则认为发送成功,一般填的是200