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

# WiFi Pengaturan Sederhana untuk onboard dan mengoperasikan perangkat
<a name="managedintegrations-sdk-v2-cookbook-wss"></a>

WiFi Simple Setup (WSS) adalah metode orientasi perangkat otomatis yang menyederhanakan WiFi penyediaan kredensyal untuk perangkat IoT yang dikelola melalui AWS IoT Managed Integrations.

**Di halaman ini:**
+ [Apa itu Setup WiFi Sederhana](#managedintegrations-sdk-v2-cookbook-wss-what-is)
+ [Kasus penggunaan umum](#managedintegrations-sdk-v2-cookbook-wss-use-cases)
+ [Kapan menggunakan WSS](#managedintegrations-sdk-v2-cookbook-wss-when-to-use)
+ [Prasyarat](#managedintegrations-sdk-v2-cookbook-wss-prerequisites)
+ [Bagaimana WSS bekerja](#managedintegrations-sdk-v2-cookbook-wss-how-it-works)
+ [Alur kerja WSS](#managedintegrations-sdk-v2-cookbook-wss-workflow)
+ [Skenario penyebaran](#managedintegrations-sdk-v2-cookbook-wss-deployment-scenarios)

## Apa itu Setup WiFi Sederhana
<a name="managedintegrations-sdk-v2-cookbook-wss-what-is"></a>

WiFi Simple Setup (WSS) memungkinkan perangkat untuk secara otomatis menerima WiFi kredensyal dari perangkat penyedia (seperti hub) melalui proses otomatis yang aman. Setelah pemindaian kode batang satu kali, seluruh proses WiFi koneksi selesai secara otomatis tanpa mengharuskan pengguna akhir memasukkan WiFi kata sandi atau memilih jaringan secara manual.

### Karakteristik utama
<a name="managedintegrations-sdk-v2-cookbook-wss-key-characteristics"></a>
+ One-time pemindaian barcode untuk mengaktifkan perangkat
+ Penemuan dan koneksi otomatis
+ Amankan pertukaran kredensyal lokal menggunakan TLS 1. 2/1.3
+ Jendela aktivasi terbatas waktu yang dapat dikonfigurasi (Default 15 menit)
+ Fallback otomatis ke Pengaturan yang Dipandu Pengguna jika diperlukan

## Kasus penggunaan umum
<a name="managedintegrations-sdk-v2-cookbook-wss-use-cases"></a>
+ Kamera rumah pintar yang membutuhkan WiFi konektivitas
+ Sensor IoT di lingkungan perumahan
+ WiFi-enabled peralatan dan perangkat
+ Perangkat integrasi terkelola apa pun yang memerlukan pengaturan otomatis WiFi 

### Contoh skenario
<a name="managedintegrations-sdk-v2-cookbook-wss-example-scenario"></a>

Seorang pelanggan membeli kamera rumah pintar. Setelah membuka kotak, mereka memindai kode batang perangkat dengan aplikasi seluler mereka, menyalakan kamera, dan dalam 60 detik kamera secara otomatis terhubung ke WiFi jaringan mereka tanpa entri kata sandi manual. Sebagai bagian dari proses yang sama, kamera juga dilengkapi dengan integrasi terkelola dan sekarang dapat dikontrol menggunakan API integrasi terkelola.

## Kapan menggunakan WSS
<a name="managedintegrations-sdk-v2-cookbook-wss-when-to-use"></a>

### Perbandingan metode orientasi
<a name="managedintegrations-sdk-v2-cookbook-wss-comparison"></a>


**Perbandingan metode orientasi**  

| Metode | Tindakan Pengguna | Terbaik Untuk | Tingkat Otomasi | 
| --- | --- | --- | --- | 
| WSS | Pindai kode batang | WiFi perangkat yang membutuhkan pengaturan otomatis | Tinggi - otomatis setelah pemindaian | 
| SS (Pengaturan Sederhana) | Pindai pemasangan manual QR \+ | Protocol-specific perangkat (Zigbee,) Z-Wave | Sedang - membutuhkan langkah pemasangan | 
| ZTS (Nol Sentuhan) | Tidak ada (pra-terdaftar) | Penerapan perusahaan dengan integrasi pemenuhan | Tertinggi - sepenuhnya otomatis | 
| UGS (Dipandu Pengguna) | Menekan tombol\+langkah manual | Fallback saat otomatisasi gagal | Intervensi manual rendah | 

### Kapan memilih WSS
<a name="managedintegrations-sdk-v2-cookbook-wss-when-to-choose"></a>
+ Perangkat membutuhkan WiFi konektivitas
+ Hub atau penyedia tersedia di rumah tangga
+ Pengalaman penyiapan yang disederhanakan diinginkan
+ Aplikasi seluler memiliki kemampuan pemindaian kode batang

### Kapan menggunakan alternatif
<a name="managedintegrations-sdk-v2-cookbook-wss-when-alternatives"></a>
+ **ZTS:** Penerapan perusahaan dengan pra-pendaftaran pusat pemenuhan
+ **SS:** Protocol-specific perangkat (Zigbee, Z-Wave) dengan persyaratan pemasangan yang berbeda
+ **UGS:** Fallback ketika WSS tidak tersedia atau gagal

## Prasyarat
<a name="managedintegrations-sdk-v2-cookbook-wss-prerequisites"></a>

### Untuk perangkat penyedia (hub)
<a name="managedintegrations-sdk-v2-cookbook-wss-provisioner-prereqs"></a>
+ Integrasi Hub SDK dengan konektivitas WiFi 
+ Kemampuan pembuatan titik akses perangkat lunak (SofTap)
+ Akses ke WiFi kredensyal lokal melalui API yang disediakan pelanggan
+ Terdaftar sebagai integrasi terkelola peran CONTROLLER dengan loker kredensyal

### Untuk perangkat provisionee
<a name="managedintegrations-sdk-v2-cookbook-wss-provisionee-prereqs"></a>
+ Integrasi terkelola Akhiri integrasi SDK perangkat dengan kemampuan WiFi 
+ Modul keamanan perangkat keras (HSM) atau Trusted Platform Module (TPM)
+ Sertifikat klaim dan kunci pribadi disimpan dengan aman
+ Nomor Seri Unik (SN: 12-50 karakter) dan UPC/EAN
+ Label barcode pada perangkat atau kemasan

**catatan**  
**Dukungan EAN:** Penyedia saat ini hanya mendukung UPC. Dukungan EAN direncanakan untuk rilis future.

### Untuk implementasi pelanggan
<a name="managedintegrations-sdk-v2-cookbook-wss-customer-prereqs"></a>
+ Akun integrasi terkelola dikonfigurasi
+ Pengaturan Penyediaan Armada (titik akhir khusus, profil penyediaan, templat)
+ Aplikasi seluler dengan kemampuan pemindaian kode batang
+ API Pelanggan untuk akses WiFi kredensyal

## Bagaimana WSS bekerja
<a name="managedintegrations-sdk-v2-cookbook-wss-how-it-works"></a>

### Gambaran umum arsitektur
<a name="managedintegrations-sdk-v2-cookbook-wss-architecture"></a>

Diagram berikut menunjukkan arsitektur WSS dengan layanan cloud, hub penyedia, dan komponen perangkat provisionee:

![Diagram arsitektur WSS yang menunjukkan layanan cloud (Layanan Penyediaan, LPWSS, AWS IoT Core), perangkat hub dengan Plugin Penyedia (SofTap Manager, SOCKS5 WiFi Proxy, TLS Server, Credentials Manager), dan perangkat akhir dengan modul WSS (Pemindai, Klien, Penyimpanan Aman) WiFi SOCKS5/TLS](https://docs.aws.amazon.com/id_id/iot-mi/latest/devguide/images/wifi-simple-setup-architecture.png)


### Komponen kunci
<a name="managedintegrations-sdk-v2-cookbook-wss-key-components"></a>

**Layanan cloud:** Mengkoordinasikan otentikasi, mengelola siklus hidup perangkat, dan mendistribusikan token sesi untuk pertukaran kredensyal yang aman.

**Provisioner (Hub):** WiFi-connected perangkat yang membuat jalur akses sementara dan berbagi WiFi kredensyal dengan perangkat baru.

**Provisionee (Perangkat):** WiFi Perangkat baru yang membutuhkan akses jaringan untuk penyiapan dan pengoperasian awal.

**Aplikasi seluler:** Customer-provided aplikasi yang memulai pengaturan melalui pemindaian kode batang.

## Alur kerja WSS
<a name="managedintegrations-sdk-v2-cookbook-wss-workflow"></a>

Diagram berikut menunjukkan alur kerja Setup WiFi Sederhana lengkap dari pemindaian kode batang melalui aktivasi perangkat:

![Diagram alur kerja WiFi Setup Sederhana yang lengkap](https://docs.aws.amazon.com/id_id/iot-mi/latest/devguide/images/wifi-simple-setup-flow.png)


### Fase alur kerja
<a name="managedintegrations-sdk-v2-cookbook-wss-workflow-phases"></a>

**Fase 1: Menautkan akun**

End-user memindai barcode perangkat (SN\+UPC), mengaktifkan jendela pengaturan 15 menit. Cloud memberi tahu semua penyedia yang memenuhi syarat di rumah tangga.

**penting**  
Hanya satu provisionee yang dapat di-onboard pada satu waktu. Jika Anda memindai beberapa perangkat sekaligus, hanya yang terbaru yang akan di-onboard. Jika Anda ingin onboard perangkat yang sudah dipindai, Anda harus menjalankannya. `UpdateManagedThing`

**Fase 2: Penemuan perangkat**

Perangkat diaktifkan, menghitung kredensyal sementara, dan secara otomatis terhubung ke jaringan sementara tersembunyi penyedia.

**Fase 3: Otentikasi cloud**

Perangkat menyelesaikan Penyediaan Armada melalui proxy terbatas penyedia, memperoleh sertifikat permanen. Cloud memvalidasi hubungan perangkat dan penyedia, lalu mendistribusikan token sesi.

**Fase 4: Pertukaran kredensyal**

Perangkat membuat koneksi TLS aman ke penyedia menggunakan token sesi. Penyedia berbagi WiFi kredensyal. Penyedia melaporkan pembagian kredensi untuk pemantauan keamanan.

**Fase 5: Koneksi jaringan**

Perangkat terhubung ke WiFi jaringan dan melaporkan keberhasilan ke cloud. Penyiapan selesai—perangkat beroperasi.

**Fallback:** Jika ada fase yang gagal, perangkat secara otomatis kembali ke Pengaturan Terpandu Pengguna dengan panduan aplikasi seluler.

## Skenario penyebaran
<a name="managedintegrations-sdk-v2-cookbook-wss-deployment-scenarios"></a>

### Skenario 1: Hub standar dengan WiFi akses
<a name="managedintegrations-sdk-v2-cookbook-wss-scenario-1"></a>

Hub terhubung WiFi dengan akses ke kredensyal melalui API pelanggan. Hub berbagi kredensyal secara langsung dengan provisionee tanpa penyimpanan cloud. WiFi 

### Skenario 2: Beberapa penyedia
<a name="managedintegrations-sdk-v2-cookbook-wss-scenario-2"></a>

Beberapa hub di rumah tangga memberikan redundansi. Penyedia pertama yang merespons melayani perangkat. Distribusi beban otomatis meningkatkan keandalan.

### Skenario 3: Fallback otomatis
<a name="managedintegrations-sdk-v2-cookbook-wss-scenario-3"></a>

Jika penyedia tidak tersedia atau koneksi gagal, perangkat secara otomatis kembali ke Pengaturan Terpandu Pengguna. Aplikasi seluler memandu pengguna melalui pengaturan manual. Fallback transparan untuk pengguna akhir.