# 平台下发隧道信息
#### 功能介绍
物联网平台向设备侧下发安全隧道信息。设备侧在接收到信息后，可以使用该安全隧道信息建立与物联网平台的WebSocket连接，用户可以在应用端远程登录使用基于安全隧道建链的设备（远程SSH登录服务），进行设备的更新配置、排查诊断、运维变更等操作。
#### Topic
下行：$oc/devices/{device_id}/sys/events/down
#### 参数说明
| 字段名      | 必选/可选 | 类型                   | 参数描述                                                                                         |
|:---|:---|:---|:---|
| services | 可选    | List\<ServiceEvent\> | **参数解释：** 事件服务列表。 |
   
ServiceEvent定义表
| 字段名        | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| service_id | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："$tunnel_manager"。 |
| event_type | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："tunnel_notify"。                             |
| event_time | 可选    | String | **参数解释：** 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。                                                                                                                              |
| paras      | 必选    | Object | **参数解释：** 事件参数JSON对象。                                                                                                                                                    |
   
paras参数列表
| 字段名                 | 必选/可选 | 类型      | 参数描述                                                                  |
|:---|:---|:---|:---|
| tunnel_uri          | 必选    | String  | **参数解释：** 隧道连接地址。      |
| tunnel_access_token | 必选    | String  | **参数解释：** 隧道接入token。 |
| expires_in          | 必选    | Integer | **参数解释：** token有效期。     |
   
#### 示例
```
Topic: $oc/devices/{device_id}/sys/events/down
数据格式：
{ 
    "services": [{ 
        "service_id": "$tunnel_manager", 
        "event_type": "tunnel_notify", 
        "event_time": "20151212T121212Z",
         "paras": { 
              "tunnel_uri": "wss://xxx/v5/iot/tunnels/{tunnel_id}/device-connect",
              "tunnel_access_token": "xxxx",
              "expires_in":86400
         } 
    }] 
}
```