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

Provisionee

Provisionee adalah komponen Integrasi Terkelola yang memungkinkan penyediaan armada dengan klaim. Dengan provisionee, Anda menyediakan perangkat Anda dengan aman. SDK menciptakan sumber daya yang diperlukan untuk penyediaan perangkat, yang mencakup sertifikat perangkat dan kunci pribadi yang diperoleh dari cloud Integrasi Terkelola. Saat Anda ingin menyediakan perangkat Anda, atau jika ada perubahan yang mengharuskan Anda untuk menyediakan kembali perangkat Anda, Anda dapat menggunakan provisionee.

Alur kerja penyediaan

Proses ini membutuhkan pengaturan di kedua sisi cloud dan perangkat. Pelanggan mengonfigurasi persyaratan cloud seperti titik akhir khusus, profil penyediaan, dan hal-hal terkelola. Pada perangkat pertama dihidupkan, penyediaannya:

Setelah penyediaan berhasil, perangkat berkomunikasi langsung dengan Integrasi Terkelola. Provisionee mengaktifkan hanya untuk tugas penyediaan ulang.

Tetapkan variabel lingkungan

Tetapkan AWS kredensional berikut di lingkungan cloud Anda:

$ export AWS_ACCESS_KEY_ID=YOUR-ACCOUNT-ACCESS-KEY-ID
$ export AWS_SECRET_ACCESS_KEY=YOUR-ACCOUNT-SECRET-ACCESS-KEY
$ export AWS_DEFAULT_REGION=YOUR-DEFAULT-REGION

Daftarkan titik akhir kustom

Gunakan perintah RegisterCustomEndpointAPI di lingkungan cloud Anda untuk membuat titik akhir khusus untuk komunikasi perangkat-ke-cloud.

aws iot-managed-integrations register-custom-endpoint

Contoh respon

{ "EndpointAddress":"[ACCOUNT-PREFIX]-ats.iot.AWS-REGION.amazonaws.com" }

Buat profil penyediaan

Buat profil penyediaan yang menentukan metode penyediaan armada Anda. Jalankan CreateProvisioningProfileAPI di lingkungan cloud Anda untuk mengembalikan sertifikat klaim dan kunci pribadi untuk otentikasi perangkat:

aws iot-managed-integrations create-provisioning-profile \
--provisioning-type "FLEET_PROVISIONING" \
--name "PROVISIONING-PROFILE-NAME"

Contoh respon

{ "Arn":"arn:aws:iot-managed-integrations:AWS-REGION:YOUR-ACCOUNT-ID:provisioning-profile/PROFILE_NAME",
    "ClaimCertificate":"string",
    "ClaimCertificatePrivateKey":"string",
    "Name":"ProfileName",
    "ProvisioningType":"FLEET_PROVISIONING"}
        

Anda dapat mengimplementasikan pustaka abstraksi platform (PAL) CorePKCS11 untuk membuat pustaka CorePKCS11 berfungsi dengan perangkat Anda. Port CorePKCS11 PAL harus menyediakan lokasi untuk menyimpan sertifikat klaim dan kunci pribadi. Dengan menggunakan fitur ini, Anda dapat menyimpan kunci pribadi dan sertifikat perangkat dengan aman. Anda dapat menyimpan kunci pribadi dan sertifikat pada modul keamanan perangkat keras (HSM) atau modul platform tepercaya (TPM).

Buat hal yang dikelola

Daftarkan perangkat Anda dengan cloud Integrasi Terkelola menggunakan CreateManagedThingAPI. Sertakan nomor seri (SN) dan kode produk universal (UPC) perangkat Anda:

aws iot-managed-integrations create-managed-thing —role DEVICE \
  --authentication-material-type WIFI_SETUP_QR_BAR_CODE \
  --authentication-material "SN:DEVICE-SN;UPC:DEVICE-UPC;"

Berikut ini menampilkan contoh respons API.

{
   "Arn":"arn:aws:iot-managed-integrations:AWS-REGION:ACCOUNT-ID:managed-thing/59d3c90c55c4491192d841879192d33f",
   "CreatedAt":1.730960226491E9,
   "Id":"59d3c90c55c4491192d841879192d33f"
}

API mengembalikan ID Managed thing yang dapat digunakan untuk validasi penyediaan. Anda harus memberikan nomor seri perangkat (SN) dan kode produk universal (UPC), yang dicocokkan dengan hal terkelola yang disetujui selama transaksi penyediaan. Transaksi mengembalikan hasil yang mirip dengan berikut ini:

/**
 * @brief Device info structure.
 */
typedef struct iotmiDev_DeviceInfo 
{
    char serialNumber[ IOTMI_DEVICE_MAX_SERIAL_NUMBER_LENGTH + 1U ];
    char universalProductCode[ IOTMI_DEVICE_MAX_UPC_LENGTH + 1U ];
    char internationalArticleNumber[ IOTMI_DEVICE_MAX_EAN_LENGTH + 1U ];
} iotmiDev_DeviceInfo_t;

Penyediaan pengguna Wi-Fi SDK

Produsen perangkat dan penyedia solusi memiliki layanan Wi-Fi penyediaan milik mereka sendiri untuk menerima dan mengonfigurasi kredensi. Wi-Fi Layanan Wi-Fi penyediaan melibatkan penggunaan aplikasi seluler khusus, koneksi Bluetooth Low Energy (BLE), dan protokol eksklusif lainnya untuk mentransfer Wi-Fi kredensil dengan aman untuk proses penyiapan awal.

Konsumen SDK perangkat Akhir harus menerapkan layanan Wi-Fi penyediaan dan perangkat dapat terhubung ke jaringan. Wi-Fi

Atau, SDK perangkat Akhir dapat dibuat menggunakan flag IOTMI_USE_WSS_PROVISIONEE build untuk mengaktifkan penyediaan WiFi Simple Setup (WSS). WSS menggunakan penyedia Hub SDK untuk secara otomatis menyediakan WiFi kredensil, memberikan alternatif untuk metode penyediaan hak milik. WiFi Untuk informasi selengkapnya, lihat WiFi Pengaturan Sederhana untuk onboard dan mengoperasikan perangkat.

Penyediaan armada dengan klaim

Dengan menggunakan provisionee, pengguna akhir dapat memberikan sertifikat unik dan mendaftarkannya ke Integrasi Terkelola menggunakan penyediaan berdasarkan klaim.

ID klien dapat diperoleh baik dari respons templat penyediaan atau sertifikat perangkat <common name>“_”<serial number>

Kemampuan Hal yang Dikelola

Penyedia menemukan kemampuan hal yang dikelola, kemudian mengunggah kemampuan ke Integrasi Terkelola. Itu membuat kemampuan tersedia untuk aplikasi dan layanan lain untuk diakses. Perangkat, klien web lainnya, dan layanan dapat memperbarui kemampuan dengan menggunakan MQTT dan topik MQTT yang dicadangkan, atau HTTP menggunakan REST API.