PDF《云通信》

CallbackCommand=Group.CallbackAfterNewMemberJoin&

contenttype= json&

ClientIP=$ClientIP&

OptPlatform=$OptPlatform HTTP/1.1 Host: www.example.com Content-Length:

337 云通信 版权所有:腾讯云计算(北京)有限责任公司 第6 共87页{ CallbackCommand : Group.CallbackAfterNewMemberJoin , GroupId : @TGS#2J4SZEAEL , Type : Public , JoinType : Apply , Operator_Account : leckie , NewMemberList : [ { Member_Account : jared }, { Member_Account : tommy } ] } 回调应答示例: HTTP/1.1

200 OK Server: nginx/1.7.10 Date: Fri,

09 Oct

2015 02:59:55 GMT Content-Length:

75 { ActionStatus : OK , ErrorInfo : , ErrorCode :

0 } 回调超时时间 云通信回调 App 后台的超时时间为

2 秒,且没有重试.如果回调超时,后续处理逻辑与没有配置回调时相同(例如,假设 发送群消息之前回调 超时,消息会正常下发). 为确保回调成功率,第三方 App 应当尽可能加快回调处理速度,例如先发送回调应答,然后再处理具体业务逻辑. 安全考虑 云通信支持三种回调类型: 1. HTTP 回调. 2. HTTPS 回调,App 后台的 WebServer 配置的是 CA 机构签发的证书或者是云通信免费签发的证书. 云通信 版权所有:腾讯云计算(北京)有限责任公司 第7 共87页3. HTTPS 双向认证回调,App 后台的 WebServer 配置的是 CA 机构签发的证书或者是云通信免费签发的证书,且 启用双向认证能力. 三种方案的安全性逐步递增: 1. HTTP 回调存在两个缺陷:一是明文传输的数据容易被窃听,二是第三方 App 无法判断回调请求是否真正来自于 云通信. 2. 对于 HTTPS 回调,如果不启用双向认证,可以解决数据的加密问题,但依然无法确保回调的请求来源是云通信. 3. 只有 HTTPS 与双向认证结合,才能确保第三方回调的安全性. 我们强烈建议 App 使用第三种方式实现回调,且云通信签发证书完全免费. 回调配置 目前云通信控制台支持自助配置回调,包括配置回调 URL 以及启用哪些回调.配置方法参见 第三方回调配置 文档. 回调不通的常见原因 如果遇到回调不通的情况,App 先依照如下清单排查一下设置的回调服务是否存在问题. 回调不通的现象 可能存在的原因 注意: 控制台自助配置的回调仅支持 HTTP/HTTPS 回调.如果您需要启用安全级别最强的 HTTPS 双向认证: 1. 在控制台中配置回调 URL(必须为 HTTPS 域名)、回调开启. 2. 给云通信提需求工单,由云通信给 App 签发双向认证所需的证书,所需要的资料包括: i. SdkAppid ii. App 名称 iii. 回调 URL(必须与控制台中自助配置的回调URL一致) 3. 拿到证书之后,依照如下两篇指引配置 HTTPS 双向认证: i. Apache 配置 HTTPS 双向认证指南 ii. Nginx 配置 HTTPS 双向认证指南 云通信 版权所有:腾讯云计算(北京)有限责任公司 第8 共87页 回调不通的现象 可能存在的原因 回调 URL 访问超 时1. 云通信无法完成 DNS 解析,请确认该域名是否在公网生效.(例如,回调 HOST 为http://notexist.com ,该域名不存在,云通........