As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# WiFi Configuração simples para integrar e operar dispositivos
WiFi O Simple Setup (WSS) é um método automatizado de integração de dispositivos que simplifica o WiFi provisionamento de credenciais para dispositivos de IoT gerenciados por meio das integrações gerenciadas do AWS IoT.
**Nesta página:**
+ [O que é configuração WiFi simples](#managedintegrations-sdk-v2-cookbook-wss-what-is)
+ [Casos de uso comuns](#managedintegrations-sdk-v2-cookbook-wss-use-cases)
+ [Quando usar o WSS](#managedintegrations-sdk-v2-cookbook-wss-when-to-use)
+ [Pré-requisitos](#managedintegrations-sdk-v2-cookbook-wss-prerequisites)
+ [Como o WSS funciona](#managedintegrations-sdk-v2-cookbook-wss-how-it-works)
+ [Fluxo de trabalho do WSS](#managedintegrations-sdk-v2-cookbook-wss-workflow)
+ [Cenários de implantação](#managedintegrations-sdk-v2-cookbook-wss-deployment-scenarios)
## O que é configuração WiFi simples
WiFi A Configuração Simples (WSS) permite que os dispositivos recebam automaticamente WiFi as credenciais de um dispositivo provisionador (como um hub) por meio de um processo seguro e automatizado. Depois de uma única leitura do código de barras, todo o processo de WiFi conexão é concluído automaticamente, sem exigir que os usuários finais WiFi insiram senhas manualmente ou selecionem redes.
### Características principais
+ One-time leitura de código de barras para ativar o dispositivo
+ Descoberta e conexão automáticas
+ Troca segura de credenciais locais usando TLS 1. 2/1.3
+ Janela de ativação configurável com limite de tempo (padrão de 15 minutos)
+ Retorno automático para a configuração guiada pelo usuário, se necessário
## Casos de uso comuns
+ Câmeras domésticas inteligentes que exigem WiFi conectividade
+ Sensores de IoT em ambientes residenciais
+ WiFi-enabled eletrodomésticos e dispositivos
+ Qualquer dispositivo de integrações gerenciadas que exija configuração automatizada WiFi
### Exemplo de cenário
Um cliente compra uma câmera doméstica inteligente. Depois de desembalar, eles digitalizam o código de barras do dispositivo com o aplicativo móvel, ligam a câmera e, em 60 segundos, a câmera se conecta automaticamente à WiFi rede sem digitar a senha manualmente. Como parte do mesmo processo, a câmera também está integrada com integrações gerenciadas e agora pode ser controlada usando APIs de integrações gerenciadas.
## Quando usar o WSS
### Comparação dos métodos de integração
**Comparação do método de integração**
| Método | User Action (Ação do usuário) | Melhor Para | Nível de automação |
| --- | --- | --- | --- |
| WSS | Digitalize o código de barras | WiFi dispositivos que precisam de configuração automatizada | Alto - automático após a digitalização |
| SS (configuração simples) | Emparelhamento manual do Scan QR \+ | Protocol-specific dispositivos (Zigbee,) Z-Wave | Médio - requer etapas de emparelhamento |
| ZTS (Zero Touch) | Nenhum (pré-registrado) | Implantações corporativas com integração de atendimento | Mais alto - totalmente automático |
| UGS (guiado pelo usuário) | Pressionar botões \+ etapas manuais | Recue quando a automação falhar | Intervenção manual baixa |
### Quando escolher o WSS
+ O dispositivo requer WiFi conectividade
+ Hub ou provisionador disponível em casa
+ Experiência de configuração simplificada desejada
+ O aplicativo móvel tem capacidade de leitura de código de barras
### Quando usar alternativas
+ **ZTS:** implantações corporativas com pré-registro no centro de distribuição
+ **SS:** Protocol-specific dispositivos (Zigbee, Z-Wave) com diferentes requisitos de emparelhamento
+ **UGS: Recuar** quando o WSS estiver indisponível ou falhar
## Pré-requisitos
### Para dispositivos provisionadores (hubs)
+ Integração do Hub SDK com conectividade WiFi
+ Capacidade de criação de ponto de acesso de software (SofTap)
+ Acesso às WiFi credenciais locais por meio da API fornecida pelo cliente
+ Registrado como integrações gerenciadas, função de CONTROLADOR com armário de credenciais
### Para dispositivos provisionados
+ Integrações gerenciadas Integração final do SDK do dispositivo com capacidade WiFi
+ Módulo de segurança de hardware (HSM) ou Trusted Platform Module (TPM)
+ Certificado de solicitação e chave privada armazenados com segurança
+ Número de série exclusivo (SN: 12-50 caracteres) e UPC/EAN
+ Etiquetas de código de barras no dispositivo ou na embalagem
**nota**
**EAN Support:** Atualmente, os provisionadores oferecem suporte somente a UPC. O suporte ao EAN está planejado para futuros lançamentos.
### Para implementação pelo cliente
+ Conta de integrações gerenciadas configurada
+ Configuração de provisionamento de frota (endpoint personalizado, perfil de provisionamento, modelo)
+ Aplicativo móvel com capacidade de leitura de código de barras
+ API do cliente para acesso à WiFi credencial
## Como o WSS funciona
### Visão geral da arquitetura
O diagrama a seguir mostra a arquitetura do WSS com serviços em nuvem, hub do provisionador e componentes do dispositivo provisionado:
### Componentes principais
**Serviços em nuvem:** coordene a autenticação, gerencie o ciclo de vida do dispositivo e distribua tokens de sessão para troca segura de credenciais.
**Provisionador (Hub):** WiFi-connected dispositivo que cria um ponto de acesso temporário e compartilha WiFi credenciais com novos dispositivos.
**Provisionado (Dispositivo):** Novo WiFi dispositivo que requer acesso à rede para configuração e operação iniciais.
**Aplicativo móvel: Customer-provided aplicativo** que inicia a configuração por meio da leitura de código de barras.
## Fluxo de trabalho do WSS
O diagrama a seguir mostra o fluxo de trabalho completo do WiFi Simple Setup, desde a leitura do código de barras até a ativação do dispositivo:
### fases do fluxo de trabalho
**Fase 1: vinculação de contas**
End-user digitaliza o código de barras do dispositivo (SN \+ UPC), ativando uma janela de configuração de 15 minutos. A nuvem notifica todos os provisionadores qualificados do domicílio.
**Importante**
Somente um provisionado pode ser integrado por vez. Se você digitalizar vários dispositivos ao mesmo tempo, somente o mais recente será integrado. Se você quiser integrar dispositivos que já foram digitalizados, você precisa executar. `UpdateManagedThing`
**Fase 2: descoberta de dispositivos**
O dispositivo é ligado, calcula as credenciais temporárias e se conecta automaticamente à rede temporária oculta do provisionador.
**Fase 3: Autenticação na nuvem**
O dispositivo conclui o provisionamento da frota por meio do proxy restrito do provisionador, obtendo um certificado permanente. A nuvem valida o relacionamento entre o dispositivo e o provisionador e, em seguida, distribui os tokens da sessão.
**Fase 4: troca de credenciais**
O dispositivo estabelece uma conexão TLS segura com o provisionador usando o token de sessão. O provisionador compartilha credenciais WiFi . O provisionador relata o compartilhamento de credenciais para monitoramento de segurança.
**Fase 5: conexão de rede**
O dispositivo se conecta à WiFi rede e relata o sucesso na nuvem. Configuração concluída — o dispositivo está operacional.
**Recuo:** se alguma fase falhar, o dispositivo volta automaticamente para a Configuração guiada pelo usuário com orientação do aplicativo móvel.
## Cenários de implantação
### Cenário 1: hub padrão com WiFi acesso
Hub conectado WiFi com acesso às credenciais por meio da API do cliente. O Hub compartilha credenciais diretamente com o provisionado sem armazenamento em nuvem. WiFi
### Cenário 2: vários provisionadores
Vários hubs domésticos fornecem redundância. O primeiro provisionador a responder atende o dispositivo. A distribuição automática da carga melhora a confiabilidade.
### Cenário 3: retorno automático
Se o provisionador estiver indisponível ou a conexão falhar, o dispositivo retornará automaticamente à Configuração guiada pelo usuário. O aplicativo móvel orienta o usuário na configuração manual. O fallback é transparente para o usuário final.