概述
深信服-云信通企业信使短信配置说明
名词说明:
- WEBSERVICE
一种服务导向架构的技术,通过标准的 Web 协议提供服务,目的是保证不同平台的应用服务可以相互操作。根据 W3C 的定义,WEBSERVICE 应当是一个软件系统,用以支持网络间不同机器的互动操作。WEBSERVICE 通常是许多应用程序接口(API)所组成的,通过网络在远程服务器端执行客户端所提交服务的请求。
- SOAP
简单对象访问协议(SOAP,全写为 Simple Object Access Protocol),一个基于 XML的可扩展消息信封格式,需同时绑定一个传输用协议。这个协议通常是 HTTP 或 HTTPS, 但也可能是 SMTP 或 XMPP。
- WSDL
一个 XML 格式文档,用以描述程序(服务)接口访问方式和使用协议的细节,通常用来辅助生成服务器和客户端代码及配置信息。
信息准备:
- WEBSERVICE 服务器请求地址,SOAP 版本(SOAP1.1/SOAP1.2),请求类型(GET/POST)等。
- 短信发送模版等相关文档,包括:
a) 短信接口描述 WSDL 文件,WSDL(Web Services Description Language 的缩写) 是一个用来描述 Web 服务和说明如何与 Web 服务通信的 XML 语言,也就是为用户提供详细的接口说明书。
b) 短信接口说明使用文档及相关参数信息
c) 其他系统正常发送短信的实际配置实例或抓包结果
配置步骤:
-
[认证服务器]-新增[短信认证]
-
短信内容默认。但是默认短信内容中这个字段会在短信内容中产生冒号
(?、斜杠(/)以及 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 格式的文件,输入其中定义的发送短信的接口名称后,点击“生成请求模版”,在“请求模版”文本框中会自动生成短信请求,也可以手动输入请求内容。
自动生成的短信请求模版中,只包含了各个接口参数的名称,不包含参数内容,内容需 要根据相关接口文档具体填写。个别参数需要用我们的参数变量进行替换,例如手机号码需 要替换为
M
O
B
I
L
E
N
U
M
MOBILE_NUM
MOBILENUM
“接收模版”这个只是给设备定义怎样算是发送成功的,设备向 WEBSERVICE 发送短信请求后,会解析服务器返回的结果,结果中包含对应的字段,则认为发送成功,一般填的是200
常见错误:
-
抓包发现服务器返回 500 Internal Error
这个一般是短信请求模版的参数格式有误,确认方法是,重新自动生成模版,然后什么参数都不要修改,直接提交发送测试短信,看是否还回复 500 错误。如果默认参数还是 500 错误,那要么是我们自动生成的模版有问题,要么就是服务器真的有问题了。 -
在短信请求模版中加入 S M S C O N T E N T SMS_CONTENT SMSCONTENT即短信内容后,服务器就返回 500 错误。
短信内容中默认有这个参数,在发送短信时会转换成 URL,包含特殊字符,服务器可能不认,去掉短信内容模版中的 URL 这一句话试下。 -
成功发送短信了,但手机没收到。
对比正常收发短信的请求报文,看各字段格式是否一致。特别是手机号字段,有的短信网关要求指定的手机号格式,如 tel:13800000000 或者+8613800000000 等,此时我们就要填写为 tel: M O B I L E N U M E MOBILE_NUME MOBILENUME或者+86 M O B I L E N U M E MOBILE_NUME MOBILENUME
最后
以上就是安静便当为你收集整理的深信服短信认证云信通短信配置说明的全部内容,希望文章能够帮你解决深信服短信认证云信通短信配置说明所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复