什么是安全隧道通信协议

Session说明

设备端与访问端进行Session通信的流程图如下。

序号	流程	说明
1和2	WebSocket建连。	设备端与访问端建立安全的WebSocket通道。
3	创建Session。	由访问端发送给设备端。注意创建Session隧道帧成功发送到设备端后，若超过10秒设备端未返回响应结果，访问端会收到超时异常的信息。
4	创建响应数据。	由物联网平台或设备端返回给访问端的响应结果。说明支持创建不同类型隧道帧的响应数据。
5和6	Session内的数据传输。	设备端和访问端可使用该Session进行数据通信。注意物联网平台不会对Tunnel Payload数据做任何解析，直接中转至设备端或访问端。
7	关闭Session。	应用场景如下：设备端和访问端均可主动关闭Session。物联网平台升级时会关闭Session。此时，访问端需具备被动关闭会话时重连设备的能力。设备端与访问端中任意一端断连，另一端会关闭Session。

Session使用过程中，Tunnel Header中JSON数据和Tunnel Payload的配置，请参见下表。

{
    "code": 0,
    "msg": ""
}

{
    "code": 0,
    "msg": ""
}

表 2. 响应数据的payload参数说明
参数	数据类型	说明
code	Integer	响应结果码，取值范围0~255，0~15为系统预留响应码，16~255可由您自定义。 0：表示创建Session成功，其他表示失败。 1：表示物联网平台的云端识别到单个安全隧道中Session数量已达到上限（10个），无法再创建。 2：表示设备端拒绝创建该Session。
msg	String	创建失败后，返回的错误提示。

表 3. 关闭Session的payload参数说明
参数	数据类型	说明
code	Integer	关闭Session的原因，可取值： 0：表示访问端主动关闭Session。 1：表示设备端主动关闭Session。 2：表示物联网平台因检测到访问端断连，关闭Session。 3：表示物联网平台因检测到设备端断连，关闭Session。 4：表示物联网平台因系统更新，关闭Session，设备端和访问端可以延时1秒后重新建连。
msg	String	关闭Session的相关信息。