View a markdown version of this page

安全隧道 - AWS IoT Greengrass
版本Type操作系统要求依赖项配置本地日志文件许可证用法另请参阅更改日志

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

安全隧道

借助 aws.greengrass.SecureTunneling 组件，您可以与位于受限防火墙后面的 Greengrass 核心设备建立安全的双向通信。

例如，假设您的 Greengrass 核心设备位于防火墙后面，防火墙禁止所有传入连接。安全隧道使用 MQTT 将访问令牌传输到设备，然后使用 WebSockets 通过防火墙与设备建立 SSH 连接。使用此 AWS IoT 管理的隧道，您可以打开设备所需的 SSH 连接。有关使用 AWS IoT 安全隧道连接远程设备的更多信息，请参阅《开发人员指南》中的AWS IoT 安全隧道。AWS IoT

此组件订阅$aws/things/greengrass-core-device/tunnels/notify主题上的 AWS IoT Core MQTT 消息代理以接收安全隧道通知。

版本

此组件具有以下版本：

  • 2.0.x

  • 1.1.x

  • 1.0.x

Type

此组件是一个通用组件 (aws.greengrass.generic)。Greengrass Nucleus 运行组件的生命周期脚本。

有关更多信息，请参阅组件类型。

操作系统

此组件只能安装在 Linux 核心设备上。

架构：

  • Armv71

  • Armv8 () AArch64

  • x86_64

要求

此组件具有以下要求：

2.0.x

  • 安全隧道组件至少有 4 MB 的可用磁盘空间。此要求不包括运行在同一设备上的 Greengrass 核心软件或其它组件。

  • 至少 3 MB RAM 可用于安全隧道组件。此要求不包括运行在同一设备上的 Greengrass 核心软件或其它组件。

  • GNU C 库 (glibc) 版本 2.35 或更高版本。不支持超过长期支持终止使用日期的操作系统和库的版本。您应该使用具有长期支持的操作系统和库。

  • Greengrass 核心设备上安装了以下运行时库：

    • libstdc++版本 3.4.29 或更高版本

    • libgcc_s3.0 或更高版本

    • OpenSSL 版本 3.0.0 或更高版本

  • 打开 Greengrass 核心设备 443 端口的出站流量。

  • 开启对用以与 Greengrass 核心设备通信的通信服务的支持。例如，要打开与设备的 SSH 连接，则必须在该设备上打开 SSH。

1.0.x - 1.1.x

  • 安全隧道组件的可用磁盘空间不得低于 32 MB。此要求不包括运行在同一设备上的 Greengrass 核心软件或其它组件。

  • 安全隧道组件至少需要 16 MB 的可用内存。此要求不包括运行在同一设备上的 Greengrass 核心软件或其它组件。有关更多信息，请参阅 使用 JVM 选项控制内存分配。

  • 安全隧道组件版本 1.0.12 及更高版本要求 GNU C 库（glibc）版本 2.25 或更高版本以及 Linux 内核 3.2 或更高版本。不支持超过长期支持终止使用日期的操作系统和库的版本。您应该使用具有长期支持的操作系统和库。

  • 操作系统和 Java 运行时都必须安装为 64 位。

  • Python 3.5 或更高版本已安装在 Greengrass 核心设备上，并已添加到 PATH 环境变量中。

  • libcrypto.so.1.1 已安装在 Greengrass 核心设备上并已添加到 PATH 环境变量中。

  • 打开 Greengrass 核心设备 443 端口的出站流量。

  • 开启对用以与 Greengrass 核心设备通信的通信服务的支持。例如，要打开与设备的 SSH 连接，则必须在该设备上打开 SSH。

端点和端口

除了基本操作所需的端点和端口外，此组件还必须能够对以下端点和端口执行出站请求。有关更多信息，请参阅 允许设备流量通过代理或防火墙。

端点 端口： 必需 说明

data.tunneling.iot.region.amazonaws.com

 443 是

建立安全隧道。

依赖项

部署组件时， AWS IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求，才能成功部署组件。本部分列出了此组件的已发布版本的依赖关系，以及定义每个依赖关系的组件版本的语义版本约束。您还可以在 AWS IoT Greengrass 控制台中查看每个组件版本的依赖关系。在组件详细信息页面上，查找依赖关系列表。

2.0.0

该组件的 2.0.0 版本同时支持 Greengrass nucleus 和 Greengrass nucleus lite。下表列出了此组件版本 2.0.0 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass nucleus or Greengrass nucleus lite >=2.0.0 <3.0.0 软性
1.0.19 – 1.1.3

下表列出了此组件的 1.0.19 到 1.1.3 版本的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <3.0.0 软性
1.0.18

下表列出了此组件版本 1.0.18 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.13.0 软性
1.0.16 – 1.0.17

下表列出了此组件版本 1.0.16 至 1.0.17 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.12.0 软性
1.0.14 – 1.0.15

下表列出了此组件版本 1.0.14 至 1.0.15 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.11.0 软性
1.0.11 – 1.0.13

下表列出了此组件版本 1.0.11 至 1.0.13 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.10.0 软性
1.0.10

下表列出了此组件版本 1.0.10 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.9.0 软性
1.0.9

下表列出了此组件版本 1.0.9 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.8.0 软性
1.0.8

下表列出了此组件版本 1.0.8 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.7.0 软性
1.0.5 - 1.0.7

下表列出了此组件版本 1.0.5 到 1.0.7 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.6.0 软性
1.0.4

下表列出了此组件的版本 1.0.4 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.5.0 软性
1.0.3

下表列出了此组件版本 1.0.3 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.4.0 软性
1.0.2

下表列出了此组件版本 1.0.2 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.3.0 软性
1.0.1

下表列出了此组件版本 1.0.1 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.0 <2.2.0 软性
1.0.0

下表列出了此组件的版本 1.0.0 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.0.3 <2.1.0 软性

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件提供您可以在部署组件时自定义的以下配置参数。

2.0.x
maxConcurrentTunnels

（可选）允许的最大并发隧道数。

注意

该值不能超过 20。

默认值：20

tunnelTimeoutSeconds

（可选）隧道超时持续时间（以秒为单位）。

默认：43200（12 小时）

accessControl

（可选）包含允许组件订阅安全隧道通知主题的授权策略的对象。

注意

如果您的部署以事物组为目标，请勿修改此配置参数。如果您的部署以单个核心设备为目标，并且您想将其订阅限制为该设备的主题，请指定核心设备的事物名称。在设备授权策略的 resources 值中，将 MQTT 主题通配符替换为设备的事物名称。

{
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.SecureTunneling:mqttproxy:1": {
      "policyDescription": "Access to tunnel notification pubsub topic",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "$aws/things/+/tunnels/notify"
      ]
    }
  }
}
例示例：配置合并更新

以下示例配置指定了最大并发隧道数和超时设置。

{
  "maxConcurrentTunnels": 20,
  "tunnelTimeoutSeconds": 43200,
  "accessControl": {
    "aws.greengrass.ipc.mqttproxy": {
      "aws.greengrass.SecureTunneling:mqttproxy:1": {
        "policyDescription": "Access to tunnel notification pubsub topic",
        "operations": [
          "aws.greengrass#SubscribeToIoTCore"
        ],
        "resources": [
          "$aws/things/MyGreengrassCore/tunnels/notify"
        ]
      }
    }
  }
}
1.0.x - 1.1.x
OS_DIST_INFO

（可选）核心设备的操作系统。默认情况下，该组件会尝试自动识别核心设备上运行的操作系统。如果组件无法使用默认值启动，请使用此值来指定操作系统。有关此组件支持的操作系统类型的完整列表，请参阅设备要求。

它可以是以下值之一：auto、ubuntu、amzn2、raspberrypi。

默认值：auto

accessControl

（可选）包含允许组件订阅安全隧道通知主题的授权策略的对象。

注意

如果您的部署以事物组为目标，请勿修改此配置参数。如果您的部署以单个核心设备为目标，并且您想将其订阅限制为该设备的主题，请指定核心设备的事物名称。在设备授权策略的 resources 值中，将 MQTT 主题通配符替换为设备的事物名称。

{
  "aws.greengrass.ipc.mqttproxy": {
    "aws.iot.SecureTunneling:mqttproxy:1": {
      "policyDescription": "Access to tunnel notification pubsub topic",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "$aws/things/+/tunnels/notify"
      ]
    }
  }
}
例示例：配置合并更新

以下示例配置指定允许此组件在运行 Ubuntu 的名为 MyGreengrassCore 的核心设备上打开安全隧道。

{
  "OS_DIST_INFO": "ubuntu",
  "accessControl": {
    "aws.greengrass.ipc.mqttproxy": {
      "aws.iot.SecureTunneling:mqttproxy:1": {
        "policyDescription": "Access to tunnel notification pubsub topic",
        "operations": [
          "aws.greengrass#SubscribeToIoTCore"
        ],
        "resources": [
          "$aws/things/MyGreengrassCore/tunnels/notify"
        ]
      }
    }
  }
}

本地日志文件

Greengrass nucleus

此组件使用以下日志文件。

/greengrass/v2/logs/aws.greengrass.SecureTunneling.log
查看此组件的日志

  • 在核心设备上运行以下命令可实时查看此组件的日志文件。/greengrass/v2替换为 AWS IoT Greengrass 根文件夹的路径。

    sudo tail -f /greengrass/v2/logs/aws.greengrass.SecureTunneling.log
Greengrass nucleus lite

在核心设备上运行以下命令以查看此组件的日志。

journalctl -xeau ggl.aws.greengrass.SecureTunneling.service

在核心设备上运行以下命令以实时查看此组件的日志。

journalctl -fau ggl.aws.greengrass.SecureTunneling.service

许可证

此组件包含以下第三方软件/许可：

2.0.x
1.0.x - 1.1.x

用法

要在设备上使用安全隧道组件，请执行以下操作：

  1. 将安全隧道组件部署到您的设备上。

  2. 打开 AWS IoT 控制台。从左侧菜单中选择远程操作，然后选择安全隧道。

  3. 创建一个连接 Greengrass 设备的隧道。

  4. 下载源访问令牌。

  5. 使用带有源访问令牌的本地代理连接到您的目标。有关更多信息，请参阅《AWS IoT 开发人员指南》中的如何使用本地代理。

另请参阅

更改日志

下表介绍每个组件版本的更改。

版本

更改

2.0.0
新特征

  • 用 C 封装器替换 Java 封装器。

  • 将 AWS IoT 设备客户端替换为AWS IoT 安全隧道本地代理。

  • 将二进制文件大小从大约 36 MB 减少到大约 4 MB。

  • 将内存占用量从大约 100 MB 减少到大约 2 MB。

1.1.3
错误修复和改进

  • 将组件调用的底层AWS IoT 设备客户端从 1.10.0 版升级到 1.10.1 版。

  • 修复了安全隧道组件版本 1.1.2 中的 GNU C 库（glibc）兼容性问题。

1.1.2
警告

此版本不再可用。此版本的改进将在此组件的更高版本中提供。

错误修复和改进

  • 将组件调用的底层 AWS IoT 设备客户端版本从 1.9.0 升级至 1.10.0。

  • 修复了有效负载的传输问题，即用户无法通过安全隧道将大文件从 Greengrass V2 核心设备转发至源设备。

1.1.1
错误修复和改进

  • 添加了支持 Greengrass Nucleus Lite 的配置。

1.1.0
新特征

  • 增加了对 Greengrass Nucleus Lite 的配方支持。

1.0.19
错误修复和改进

  • 将组件调用的底层 AWS IoT 设备客户端版本从 1.8.0 升级至 1.9.0。

  • 将组件级别的并发隧道限制增加至 20 个。

  • 将默认 AWS IoT Greengrass 酷睿 IPC 超时时间从 3 秒增加到 10 秒。

警告

如果您使用安全隧道本地代理作为隧道源客户端，将本地代理升级到版本 3.1.1 或更高版本之后，才能将组件更新到此版本。

1.0.18

 版本更新为 Greengrass Nucleus 版本 2.12.0 发布版。

1.0.17
错误修复和改进

  • 修复了阻碍用户创建隧道的线程清理问题。现在，该组件将在线程接收到 CloseTunnel 信号后或隧道在 12 小时后过期时对其进行清理。

1.0.16

 版本更新为 Greengrass Nucleus 版本 2.11.0 发布版。

2016-09-01
错误修复和改进

  • 修复了设备上没有主目录的用户的启动问题。现在，安全隧道组件无需为影子文档创建目录即可启动。

1.0.14

 版本更新为 Greengrass Nucleus 版本 2.10.0 发布版。

1.0.13
错误修复和改进

  • 修复了孤立客户端进程阻止多个隧道以设备为目标的问题。

1.0.12
错误修复和改进

  • 在 Raspberry Pi 操作系统上运行时添加了对 x86_64 ARMv8 (AMD64) 和 (Aarch64) 的支持。

2016-09-01

 对 Greengrass Nucleus版本 2.9.0 发行版进行了版本更新。

2016-09-01

 版本更新为 Greengrass Nucleus 版本 2.8.0 发布版。

1.0.9

版本更新为 Greengrass Nucleus 版本 2.7.0 发布版。

1.0.8

版本更新为 Greengrass Nucleus 版本 2.6.0 发布版。

1.0.7
错误修复和改进

  • 修复了通过 SCP 传输大文件时组件断开连接的问题。

1.0.6

此版本包含错误修复。

1.0.5

版本更新为 Greengrass Nucleus 版本 2.5.0 发布版。

1.0.4

版本更新为 Greengrass Nucleus 版本 2.4.0 发布版。

1.0.3

版本更新为 Greengrass Nucleus 版本 2.3.0 发布版。

1.0.2

对 Greengrass Nucleus 版本 2.2.0 发行版进行了版本更新。

1.0.1

对 Greengrass Nucleus 版本 2.1.0 发行版进行了版本更新。

1.0.0

初始版本。