Secrets manager - AWS IoT Greengrass
VersiTipeSistem operasiPersyaratanDependensiKonfigurasiFile log lokalChangelog

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Secrets manager

Komponen secret manager (aws.greengrass.SecretManager) men-deploy rahasia dari AWS Secrets Manager ke perangkat inti Greengrass. Gunakan komponen ini untuk secara aman menggunakan kredensial, seperti kata sandi, dalam komponen kustom pada perangkat inti Greengrass Anda. Untuk informasi lebih lanjut tentang Secrets Manager, lihat Apa Itu AWS Secrets Manager? di Panduan Pengguna AWS Secrets Manager .

Untuk mengakses rahasia komponen ini di komponen Greengrass kustom Anda, gunakan operasi di. GetSecretValue AWS IoT Device SDK Untuk informasi selengkapnya, silakan lihat Gunakan AWS IoT Device SDK untuk berkomunikasi dengan inti Greengrass, komponen lain, dan AWS IoT Core dan Ambil nilai-nilai rahasia.

Komponen ini mengenkripsi rahasia pada perangkat inti untuk menjaga kredensial dan kata sandi Anda tetap aman sampai Anda perlu menggunakannya. Ini menggunakan kunci pribadi perangkat inti untuk mengenkripsi dan mendekripsi rahasia.

Versi

Komponen ini memiliki versi berikut:

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipe

Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen ini di Java Virtual Machine JVM () yang sama dengan nukleus. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat Memantau AWS IoT Greengrass log.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Peran perangkat Greengrass harus mengizinkan tindakan, seperti yang ditunjukkan secretsmanager:GetSecretValue dalam contoh kebijakan berikut. IAM

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:secretsmanager:region:123456789012:secret:MySecret"
      ]
    }
  ]
}
    catatan

    Jika Anda menggunakan AWS Key Management Service kunci yang dikelola pelanggan untuk mengenkripsi rahasia, peran perangkat juga harus mengizinkan tindakan. kms:Decrypt

    Untuk informasi selengkapnya tentang IAM kebijakan Secrets Manager, lihat berikut ini di Panduan AWS Secrets Manager Pengguna:

  • Komponen kustom harus menentukan kebijakan otorisasi yang memungkinkan aws.greengrass#GetSecretValue untuk mendapatkan rahasia yang Anda simpan dengan komponen ini. Dalam kebijakan otorisasi ini, Anda dapat membatasi akses komponen ke rahasia tertentu. Untuk informasi selengkapnya, lihat IPCotorisasi manajer rahasia.

  • (Opsional) Jika Anda menyimpan kunci pribadi dan sertifikat perangkat inti dalam modul keamanan perangkat keras (HSM), RSA kunci HSM harus mendukung, kunci pribadi harus memiliki unwrap izin, dan kunci publik harus memiliki wrap izin.

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 Wajib Deskripsi

secretsmanager.region.amazonaws.com

 443 Ya

Unduh rahasia ke perangkat inti.

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.2.0

Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.13.0 <2.14.0 Lunak
2.1.7 – 2.1.8

Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dan 2.1.8 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.1.6 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.4 dan 2.0.5 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.

periodicRefreshIntervalMin(opsional)

Interval dalam hitungan menit di mana komponen ini menyinkronkan rahasia yang dikonfigurasi pada perangkat inti dengan nilai rahasia terbaru dari AWS Secrets Manager layanan. Jika interval ini tidak dikonfigurasi, manajer rahasia tidak akan menyegarkan rahasia yang dikonfigurasi secara berkala.

{
  "cloudSecrets": [
    {
      "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
    }
  ],
  "periodicRefreshIntervalMin" : 60
}
cloudSecrets

Daftar rahasia Secrets Manager yang akan di-deploy ke perangkat inti. Anda dapat menentukan label untuk menentukan versi mana dari setiap rahasia yang akan di-deploy. Jika Anda tidak menentukan versi, komponen ini akan men-deploy versi dengan label penahapan AWSCURRENT terlampir. Untuk informasi selengkapnya, lihat Label penahapan di Panduan Pengguna AWS Secrets Manager .

Komponen manajer rahasia menyimpan rahasia secara lokal. Jika nilai rahasia berubah di Secrets Manager, komponen ini tidak secara otomatis mengambil nilai baru. Untuk memperbarui salinan lokal, berikan label baru pada rahasia dan konfigurasikan komponen ini untuk mengambil rahasia yang diidentifikasi oleh label baru.

Setiap objek berisi informasi berikut.

arn

Rahasia untuk menyebarkan. ARN ARNRahasianya bisa penuh ARN atau sebagianARN. Kami menyarankan Anda menentukan lengkap ARN daripada sebagianARN. Untuk informasi selengkapnya, lihat Menemukan rahasia dari sebagian ARN. Berikut ini adalah contoh penuh ARN dan sebagianARN:

  • PenuhARN: arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName-abcdef

  • SebagianARN: arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName

labels

(Opsional) Daftar label untuk mengidentifikasi versi rahasia yang akan di-deploy ke perangkat inti.

Setiap label harus berupa string.

contoh Contoh: Pembaruan gabungan konfigurasi
{
  "cloudSecrets": [
    {
      "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
    }
  ]
}

File log lokal

Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

2.2.0
Fitur baru

Menambahkan dukungan untuk penyegaran berkala rahasia yang dikonfigurasi melalui kunci konfigurasi komponen baru.

Menambahkan dukungan untuk parameter permintaan baru dalam GetSecretValue IPC permintaan untuk menyegarkan rahasia per permintaan

2.1.8
Perbaikan bug dan peningkatan

Memperbaiki masalah di mana manajer rahasia tidak menerima sebagian arn.

2.1.7

 Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis.

2.1.6

 Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis.

2.1.5

 Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.

2.1.4
Perbaikan bug dan peningkatan

Memperbaiki masalah saat rahasia yang di-cache dihapus saat manajer rahasia dikerahkan dan inti Greengrass dimulai ulang.

Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis.

2.1.3

 Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis.

2.1.2

Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.

2.1.1

Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.

2.1.0
Fitur baru

  • Menambahkan dukungan untuk integrasi keamanan perangkat keras. Komponen manajer rahasia dapat mengenkripsi dan mendekripsi rahasia menggunakan kunci pribadi yang Anda simpan dalam modul keamanan perangkat keras (). HSM Untuk informasi selengkapnya, lihat Integrasi keamanan perangkat keras.

Perbaikan bug dan peningkatan

  • Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.

2.0.9

Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.

2.0.8

Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.

2.0.7

Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.

2.0.6

Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0.

2.0.5
Perbaikan

  • Tambahkan dukungan untuk Wilayah dan AWS GovCloud (US) Wilayah AWS China.

2.0.4

Versi awal.