您可以通过物联网平台的安全隧道功能,远程访问、远程诊断和管理设备。本文介绍如何配置C Link SDK,帮助设备开启安全隧道功能,以实现远程登录设备。
前提条件
- 已获取设备认证信息。
- 已获取C Link SDK。
定制SDK时,在SDK定制页面的高级能力区域,选中远程登录。
- 已准备开发环境。
功能原理
应用程序通过调用C Link SDK的API,基于MQTT协议的连接,开启安全隧道,实现远程登录、控制和管理设备。设备开启安全隧道功能后,您可以在物联网平台使用以下功能:
- 安全隧道:在物联网平台创建安全隧道,获取设备端URL和访问端Token,并将其用于访问端应用程序的开发,以建立访问端与物联网平台的WebSocket连接,最终实现远程访问设备。
- 远程登录:在物联网平台开启远程登录功能,直接通过物联网平台远程登录设备。
如下功能时序图,以设备的应用程序./demos/remote_access_basic_demo.c为例,介绍应用程序实现该功能的流程。
安全隧道功能API的详细说明,请参见aiot_ra_api.h。
使用说明
说明 目前,仅华东2(上海)、华北2(北京)、华南1(深圳)地域支持该功能。
限制项 | 描述 | 限制 |
---|---|---|
安全隧道 | 一个实例最多包含安全隧道总数。 | 1000 |
一个设备最多包含安全隧道总数。 | 10 | |
安全隧道创建成功后,可打开的最长时间。
说明 超出该时间后,安全隧道会被强制关闭。已关闭的安全隧道,不支持被重新打开。
|
24小时 | |
安全隧道创建成功后,可保留的最长时间。
说明 超出该时间后,安全隧道会被系统自动删除。
|
30天 | |
安全隧道会话 | 一个安全隧道最多包含Session总数。 | 10 |
数据传输速率 | 一个安全隧道支持的数据传输速率上限。
说明 安全隧道基于流量整形机制实现数据传输限流,数据传输速率到达上限后,隧道帧会被延时传输。请您控制数据的发送速率。
|
100 Kbps |
使用示例
- 安全隧道的应用,请参见以下示例:
- 示例一:安全隧道使用示例。
- 示例二:远程登录使用示例。
- 示例三:业务进程与远程登录进程隔离使用示例。
- 安全隧道功能相关错误码,请参见aiot_ra_api.h中的状态码描述。