Versi Tipe Sistem operasi Persyaratan Dependensi Konfigurasi File log lokal Lisensi Penggunaan Lihat juga Changelog

Tunneling yang aman

Dengan aws.greengrass.SecureTunneling komponen ini, Anda dapat membangun komunikasi dua arah yang aman dengan perangkat inti Greengrass yang terletak di belakang firewall terbatas.

Misalnya, bayangkan Anda memiliki perangkat inti Greengrass di belakang firewall yang melarang semua koneksi masuk. Tunneling aman menggunakan MQTT untuk mentransfer token akses ke perangkat dan kemudian menggunakan untuk membuat koneksi SSH WebSockets ke perangkat melalui firewall. Dengan terowongan AWS IoT terkelola ini, Anda dapat membuka koneksi SSH yang diperlukan untuk perangkat Anda. Untuk informasi selengkapnya tentang penggunaan tunneling AWS IoT aman untuk terhubung ke perangkat jarak jauh, lihat tunneling AWS IoT aman di Panduan Pengembang.AWS IoT

Komponen ini berlangganan broker pesan AWS IoT Core MQTT tentang $aws/things/greengrass-core-device/tunnels/notify topik tersebut untuk menerima pemberitahuan tunneling yang aman.

Versi

Komponen ini memiliki versi berikut:

2.0.x
1.1.x
1.0.x

Tipe

Komponen ini adalah komponen generik (aws.greengrass.generic). Inti Greengrass menjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini hanya dapat diinstal pada perangkat inti Linux.

Arsitektur:

Armv71
Armv8 () AArch64
x86_64

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

2.0.x

Minimal ruang disk 4 MB tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama.
Minimal 3 MB RAM tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama.
GNU C Library (glibc) versi 2.35 atau lebih tinggi. Versi sistem operasi dan pustaka yang melewati tanggal akhir masa pakai dukungan jangka panjangnya tidak didukung. Anda harus menggunakan sistem operasi dan perpustakaan dengan dukungan jangka panjang.
Pustaka runtime berikut yang diinstal pada perangkat inti Greengrass:
- libstdc++versi 3.4.29 atau lebih
- libgcc_sversi 3.0 atau lebih
- OpenSSL versi 3.0.0 atau lebih tinggi
Buka lalu lintas keluar pada port 443 pada perangkat inti Greengrass.
Nyalakan dukungan untuk layanan komunikasi yang ingin Anda gunakan untuk berkomunikasi dengan perangkat inti Greengrass. Misalnya, untuk membuka koneksi SSH ke perangkat, Anda harus mengaktifkan SSH pada perangkat itu.

1.0.x - 1.1.x

Minimal 32 MB ruang disk tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama.
Minimal 16 MB RAM tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama. Untuk informasi selengkapnya, lihat Kontrol alokasi memori dengan opsi JVM.
GNU C Library (glibc) versi 2.25 atau lebih tinggi dengan kernel Linux 3.2 atau lebih tinggi diperlukan untuk komponen tunneling aman versi 1.0.12 dan lebih besar. Versi sistem operasi dan pustaka yang melewati tanggal akhir masa pakai dukungan jangka panjangnya tidak didukung. Anda harus menggunakan sistem operasi dan perpustakaan dengan dukungan jangka panjang.
Baik sistem operasi dan runtime Java harus diinstal sebagai 64 bit.
Python 3.5 atau yang lebih baru diinstal pada perangkat inti Greengrass dan ditambahkan ke variabel lingkungan PATH.
libcrypto.so.1.1 diinstal pada perangkat inti Greengrass dan ditambahkan ke variabel lingkungan PATH.
Buka lalu lintas keluar pada port 443 pada perangkat inti Greengrass.
Nyalakan dukungan untuk layanan komunikasi yang ingin Anda gunakan untuk berkomunikasi dengan perangkat inti Greengrass. Misalnya, untuk membuka koneksi SSH ke perangkat, Anda harus mengaktifkan SSH pada perangkat itu.

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik akhir	Port	Diperlukan	Deskripsi
`data.tunneling.iot.region.amazonaws.com`	443	Ya	Membangun terowongan aman.

Dependensi

Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

2.0.0

Versi 2.0.0 dari komponen ini mendukung nukleus Greengrass dan Greengrass nucleus lite. Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass ATAU Greengrass nucleus lite	>=2.0.0 <3.0.0	Lunak

1.0.19 – 1.1.3

Tabel berikut mencantumkan dependensi untuk versi 1.0.19 hingga 1.1.3 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <3.0.0	Lunak

1.0.18

Tabel berikut mencantumkan dependensi untuk versi 1.0.18 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.13.0	Lunak

1.0.16 – 1.0.17

Tabel berikut mencantumkan dependensi untuk versi 1.0.16 hingga 1.0.17 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.12.0	Lunak

1.0.14 – 1.0.15

Tabel berikut mencantumkan dependensi untuk versi 1.0.14 hingga 1.0.15 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.11.0	Lunak

1.0.11 – 1.0.13

Tabel berikut mencantumkan dependensi untuk versi 1.0.11 — 1.0.13 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.10.0	Lunak

1.0.10

Tabel berikut mencantumkan dependensi untuk versi 1.0.10 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.9.0	Lunak

1.0.9

Tabel berikut mencantumkan dependensi untuk versi 1.0.9 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.8.0	Lunak

1.0.8

Tabel berikut mencantumkan dependensi untuk versi 1.0.8 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.7.0	Lunak

1.0.5 - 1.0.7

Tabel berikut mencantumkan dependensi untuk versi 1.0.5 hingga 1.0.7 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.6.0	Lunak

1.0.4

Tabel berikut mencantumkan dependensi untuk versi 1.0.4 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.5.0	Lunak

1.0.3

Tabel berikut mencantumkan dependensi untuk versi 1.0.3 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.4.0	Lunak

1.0.2

Tabel berikut mencantumkan dependensi untuk versi 1.0.2 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.3.0	Lunak

1.0.1

Tabel berikut mencantumkan dependensi untuk versi 1.0.1 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.2.0	Lunak

1.0.0

Tabel berikut mencantumkan dependensi untuk versi 1.0.0 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.3 <2.1.0	Lunak

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

2.0.x

maxConcurrentTunnels

(Opsional) Jumlah maksimum terowongan bersamaan diperbolehkan.

catatan

Nilainya tidak boleh lebih dari 20.

Default: 20

tunnelTimeoutSeconds

(Opsional) Durasi batas waktu terowongan dalam hitungan detik.

Default: 43200 (12 jam)

accessControl

(Opsional) Objek yang berisi kebijakan otorisasi yang memungkinkan komponen untuk berlangganan topik pemberitahuan tunneling aman.

catatan

Jangan mengubah parameter konfigurasi ini jika deployment Anda menargetkan grup objek. Jika penerapan Anda menargetkan perangkat inti individual, dan Anda ingin membatasi langganannya ke topik perangkat, tentukan nama perangkat inti. Dalam resources nilai dalam kebijakan otorisasi perangkat, ganti wildcard topik MQTT dengan nama benda perangkat.


{
  "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"
      ]
    }
  }
}

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan terowongan bersamaan maksimum dan pengaturan batas waktu.


{
  "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

(Opsional) Sistem operasi perangkat inti Anda. Secara default, komponen mencoba mengidentifikasi secara otomatis sistem operasi yang berjalan pada perangkat inti Anda. Jika komponen gagal memulai dengan nilai default, gunakan nilai ini untuk menentukan sistem operasi. Untuk daftar sistem operasi yang didukung untuk komponen ini, lihat Persyaratan perangkat.

Nilai ini dapat berupa salah satu dari yang berikut: auto, ubuntu, amzn2, raspberrypi.

Default: auto

accessControl

(Opsional) Objek yang berisi kebijakan otorisasi yang memungkinkan komponen untuk berlangganan topik pemberitahuan tunneling aman.

catatan


{
  "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"
      ]
    }
  }
}

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk memungkinkan komponen ini untuk membuka terowongan aman pada perangkat inti bernama MyGreengrassCore yang menjalankan Ubuntu.


{
  "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"
        ]
      }
    }
  }
}

File log lokal

Lisensi

Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:

Penggunaan

Untuk menggunakan komponen tunneling aman di perangkat Anda, lakukan hal berikut:

Terapkan komponen tunneling aman ke perangkat Anda.
Buka konsol AWS IoT. Dari menu sebelah kiri, pilih Tindakan jarak jauh, lalu pilih Terowongan aman.
Buat terowongan ke perangkat Greengrass Anda.
Unduh token akses sumber.
Gunakan proxy lokal dengan token akses sumber untuk terhubung ke tujuan Anda. Untuk informasi selengkapnya, lihat Cara menggunakan proxy lokal di Panduan AWS IoT Pengembang.

Lihat juga

AWS IoT tunneling aman di Panduan Pengembang AWS IoT
Cara menggunakan proxy lokal di Panduan AWS IoT Pengembang

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi	Perubahan
2.0.0	Fitur baru Mengganti pembungkus Java dengan pembungkus C. Mengganti Klien AWS IoT Perangkat dengan AWS IoT Securetunneling Localproxy. Mengurangi ukuran biner dari sekitar 36 MB menjadi sekitar 4 MB. Mengurangi jejak memori dari sekitar 100 MB menjadi sekitar 2 MB.
1.1.3	Perbaikan bug dan peningkatan Memutakhirkan AWS IoT Device Client yang mendasari yang dipanggil oleh komponen dari versi 1.10.0 ke versi 1.10.1. Memperbaiki masalah kompatibilitas GNU C Library (glibc) dalam komponen tunneling aman versi 1.1.2.
1.1.2	Awas Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. Perbaikan bug dan peningkatan Memutakhirkan AWS IoT Device Client yang mendasari yang dipanggil oleh komponen dari versi 1.9.0 ke versi 1.10.0. Memperbaiki masalah transfer muatan yang mencegah pengguna meneruskan file besar dari perangkat inti Greengrass V2 ke perangkat sumber melalui terowongan aman.
1.1.1	Perbaikan bug dan peningkatan Menambahkan konfigurasi untuk mendukung Greengrass nucleus lite.
1.1.0	Fitur baru Menambahkan dukungan resep untuk Greengrass nucleus lite.
1.0.19	Perbaikan bug dan peningkatan Memutakhirkan AWS IoT Device Client yang mendasari yang dipanggil oleh komponen dari versi 1.8.0 ke versi 1.9.0. Meningkatkan batas terowongan bersamaan menjadi 20 terowongan pada tingkat komponen. Meningkatkan batas waktu AWS IoT Greengrass Core IPC default dari 3 detik menjadi 10 detik. Awas Jika Anda menggunakan proxy lokal tunneling aman sebagai klien sumber terowongan, jangan perbarui komponen Anda ke versi ini sampai Anda juga memutakhirkan proxy lokal ke versi 3.1.1 atau yang lebih baru.
1.0.18	Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis.
1.0.17	Perbaikan bug dan peningkatan Memperbaiki masalah pembersihan utas yang menghalangi pengguna membuat terowongan. Komponen ini sekarang akan membersihkan utas baik setelah menerima CloseTunnel sinyal atau jika terowongan kedaluwarsa setelah 12 jam.
1.0.16	Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis.
1.0.15	Perbaikan bug dan peningkatan Memperbaiki masalah startup untuk pengguna yang tidak memiliki direktori home di perangkat. Komponen tunneling aman sekarang dimulai tanpa membuat direktori untuk dokumen bayangan.
1.0.14	Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.
1.0.13	Perbaikan bug dan peningkatan Memperbaiki masalah di mana proses klien yatim piatu mencegah lebih dari satu terowongan menargetkan perangkat.
1.0.12	Perbaikan bug dan peningkatan Menambahkan dukungan untuk x86_64 (AMD64) dan ARMv8 (Aarch64) saat berjalan di Raspberry Pi OS.
1.0.11	Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis.
1.0.10	Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis.
1.0.9	Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.
1.0.8	Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.
1.0.7	Perbaikan bug dan peningkatan Memperbaiki masalah saat komponen terputus saat Anda mentransfer file besar melalui SCP.
1.0.6	Versi ini berisi perbaikan bug.
1.0.5	Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.
1.0.4	Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.
1.0.3	Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.
1.0.2	Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.
1.0.1	Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0.
1.0.0	Versi awal.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Secrets manager

Pengelola bayangan

Tunneling yang aman

Topik

Versi

Tipe

Sistem operasi

Persyaratan

Titik akhir dan port

Dependensi

Konfigurasi

catatan

catatan

contoh Contoh: Pembaruan gabungan konfigurasi

catatan

contoh Contoh: Pembaruan gabungan konfigurasi

File log lokal

Untuk melihat log komponen ini

Lisensi

Penggunaan

Lihat juga

Changelog

Awas

Awas