Overview-IoT Platform (Deprecated)(IoT)-阿里云帮助中心

Use the secure tunnel feature of IoT Platform to remotely access, diagnose, and manage your devices. This topic describes how to configure the C Link software development kit (SDK) to enable the secure tunnel feature for remote device logon.

Prerequisites

You have the device authentication information.
When customizing the SDK, on the SDK Customization page, go to the Advanced Features area and select Remote Logon.
Set up the development environment.

How it works

The secure tunnel feature uses a Message Queuing Telemetry Transport (MQTT) protocol connection to enable remote logon, control, and management of devices. After you enable the secure tunnel feature for a device, you can use the following features in IoT Platform:

Secure tunnel: Create a secure tunnel in IoT Platform to obtain a device-side URL and an access-side token. You can use them in your access-side application to establish a WebSocket connection between the access side and IoT Platform. This enables remote access to the device.
Remote logon: Enable the remote logon feature in IoT Platform to log on to a device remotely from the platform.

./demos/remote_access_basic_demo.c

For a detailed description of the secure tunnel feature APIs, see aiot_ra_api.h.

Usage notes

Note This feature is available only in the China (Shanghai), China (Beijing), and China (Shenzhen) regions.

Limit	Description	Limit
Secure tunnel	The maximum number of secure tunnels that an instance can contain.	1000
	The maximum number of secure tunnels that a device can contain.	10
	The maximum duration that a secure tunnel can remain open after it is created. Note After this duration, the secure tunnel is forcibly closed. A closed secure tunnel cannot be reopened.	24 hours
	The maximum retention period for a secure tunnel after it is created. Note After this period, the secure tunnel is automatically deleted by the system.	30 days
Secure tunnel session	The maximum number of sessions that a secure tunnel can contain.	10
Data transfer rate	The maximum data transfer rate supported by a secure tunnel. Note Secure tunnels use a traffic shaping mechanism to limit the data transfer rate. If the rate reaches the upper limit, tunnel frames are delayed. Control the data sending rate.	100 Kbps

Examples

For examples of secure tunnel applications, see the following:
- Example 1: Secure tunnel usage example.
- Example 3: Isolating service processes from remote logon processes.
- Example 3: Example of isolating the business process from the remote logon process.
Secure tunnel: See aiot_ra_api.h for status code descriptions.