深信服短信认证云信通短信配置说明

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

名词说明：

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. 短信内容默认。但是默认短信内容中这个字段会在短信内容中产生冒号
   (?、斜杠(/)以及 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 格式的文件，输入其中定义的发送短信的接口名称后，点击“生成请求模版”，在“请求模版”文本框中会自动生成短信请求，也可以手动输入请求内容。
自动生成的短信请求模版中，只包含了各个接口参数的名称，不包含参数内容，内容需 要根据相关接口文档具体填写。个别参数需要用我们的参数变量进行替换，例如手机号码需 要替换为$$MOBIL{E}_{N}UM$$
“接收模版”这个只是给设备定义怎样算是发送成功的，设备向 WEBSERVICE 发送短信请求后，会解析服务器返回的结果，结果中包含对应的字段，则认为发送成功，一般填的是200

常见错误：

1. 抓包发现服务器返回 500 Internal Error
   这个一般是短信请求模版的参数格式有误，确认方法是，重新自动生成模版，然后什么参数都不要修改，直接提交发送测试短信，看是否还回复 500 错误。如果默认参数还是 500 错误，那要么是我们自动生成的模版有问题，要么就是服务器真的有问题了。

2. 在短信请求模版中加入$$SM{S}_{C}ONTENT$$即短信内容后，服务器就返回 500 错误。
   短信内容中默认有这个参数，在发送短信时会转换成 URL，包含特殊字符，服务器可能不认，去掉短信内容模版中的 URL 这一句话试下。

3. 成功发送短信了，但手机没收到。
   对比正常收发短信的请求报文，看各字段格式是否一致。特别是手机号字段，有的短信网关要求指定的手机号格式，如 tel:13800000000 或者+8613800000000 等，此时我们就要填写为 tel:$$MOBIL{E}_{N}UME$$或者+86$$MOBIL{E}_{N}UME$$