添加安全隧道

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

本文介绍在物联网平台为设备添加安全隧道,并进行管理的具体操作。

前提条件

  • 已创建产品和设备,具体操作,请参见创建设备
  • 设备已完成安全隧道功能开发,并接入到物联网平台,且设备当前处于在线状态。具体操作,请参见开发设备

背景信息

访问端和设备端通过安全隧道进行通信的完整流程,请参见使用安全隧道访问设备

创建安全隧道

  1. 登录物联网平台控制台

  2. 实例概览页签的全部环境下,找到对应的实例,单击实例卡片。

  3. 在左侧导航栏,选择监控运维 > 安全隧道
  4. 安全隧道页面,单击创建安全隧道
  5. 创建隧道对话框,设置以下参数,单击确定
    参数说明
    所属产品选择设备所属的产品。

    仅支持选择使用当前阿里云账号创建的产品,不支持授权的产品。授权产品说明,请参见授权产品

    设备选择安全隧道所属的设备。设备必须处于在线状态。
    推送给设备的自定义信息输入自定义的信息。

    创建安全隧道后,物联网平台向设备推送安全隧道创建通知时,会将该自定义信息下发给设备。

    描述描述当前安全隧道作用,用于后续区别使用。
  6. 在弹出的对话框中,单击一键复制,获取访问端连接安全隧道的URL和Token。
    请妥善保存Token和URL信息,访问端开发连接设备安全隧道功能时,需使用该信息。安全隧道

    创建安全隧道成功后,状态默认为已打开,设备端状态为已连接

    重要 安全隧道创建24小时后,状态自动更新为已关闭,创建30天后,会被系统自动删除。
    状态

管理安全隧道

  1. 安全隧道页面,选择产品、设备或安全隧道ID,然后输入设备名称或安全隧道ID,搜索查看指定设备的安全隧道信息,例如安全隧道状态、设备端与访问端的连接状态等。
    设备端或访问端连接状态为已连接时,表示已与物联网平台建立安全的WebSocket通道。两端都连接后,可实现访问端远程登录设备。安全隧道列表
  2. 在安全隧道列表中,选中安全隧道前的复选框,单击列表上方的批量操作,可批量关闭通道批量删除隧道
    警告 关闭安全隧道后,访问端与设备端立即断开连接,且无法重新打开进行再次访问,可能导致服务不可用或影响用户的业务。请谨慎操作。
    您也可单击操作列的操作按钮,查看安全隧道详情、关闭或删除单个安全隧道。
    重要
    • 仅支持关闭已打开的安全隧道。

      安全隧道关闭状态下,设备端和访问端无法建立远程访问通道进行通信。

    • 仅支持删除已关闭的安全隧道。
    批量操作

相关API

API

描述

MQTT型实例下是否支持

CreateDeviceTunnel

创建安全隧道。

否。

CloseDeviceTunnel

关闭状态为已打开的安全隧道。

DeleteDeviceTunnel

删除状态为已关闭的安全隧道。

QueryDeviceTunnel

查询单个安全隧道的详细信息,包括安全隧道的所属设备、创建时间、ID、连接状态等。