Wi-Fi Easy Connect

O Android 10 introduz o suporte ao protocolo Wi-Fi Easy Connect, também conhecido como protocolo de provisionamento de dispositivo (DPP, na sigla em inglês). O Wi-Fi Easy Connect foi introduzido pela Wi-Fi Alliance (WFA) como uma alternativa ao Wi-Fi Protected Setup (WPS). O uso do WPS foi descontinuado no Android 9.

O Wi-Fi Easy Connect oferece um método simples e seguro para:

  • Integre dispositivos Wi-Fi (incluindo dispositivos headless) a uma rede sem digitar uma senha.
  • Conecte-se a redes Wi-Fi sem saber ou digitar uma senha.

O bootstrap e a autenticação são configurados usando um URI, que é adquirido pela leitura de um QR code (usando uma câmera) ou é configurado fora de banda, por exemplo, usando BLE ou NFC.

O Wi-Fi Easy Connect usa um canal criptografado para enviar credenciais de Wi-Fi entre dispositivos e, como frames de ação públicos são usados, os dispositivos podem usar pontos de acesso existentes.

O Android 10 oferece suporte ao Wi-Fi Easy Connect apenas no modo iniciador (o modo de resposta não é compatível). Há suporte para os seguintes modos de operação:

  • Initiator-Configurator:envie credenciais de rede para um novo dispositivo lendo o QR code dele.
  • Iniciador-inscrito:entre em uma rede lendo o QR code da rede.

O Android 10 oferece suporte ao protocolo de chave pré-compartilhada (PSK, na sigla em inglês) para WPA2 e ao protocolo de autenticação simultânea de igual (SAE) para WPA3.

O Wi-Fi Easy Connect só é compatível com o modo de cliente (o modo SoftAP não é compatível).

Implementação

Para oferecer suporte ao Wi-Fi Easy Connect, implemente a interface suplicante fornecida no Android Open Source Project (AOSP). Dependendo da interface que foi implementada, isso fica em:

Os itens a seguir são necessários para a compatibilidade com o DPP:

  • Patches do kernel do Linux para compatibilidade com DPP:

    • (cfg80211)
    • nl80211

  • wpa_supplicant com suporte a DPP

  • Driver de Wi-Fi compatível com DPP

  • Firmware de Wi-Fi compatível com DPP

As APIs públicas estão disponíveis no Android 10 para uso por apps:

Ativar o Wi-Fi Easy Connect

Para ativar o Wi-Fi Easy Connect no framework do Android, inclua a opção de compilação CONFIG_DPP no arquivo de configuração wpa_supplicant, android.config:

# Easy Connect (Device Provisioning Protocol - DPP)
CONFIG_DPP=y

Validação

Para testar a implementação, execute os seguintes testes.

Testes de unidades

Execute DppManagerTest para verificar o comportamento das flags de recurso para o DPP.

atest DppManagerTest

Testes VTS

Se a interface HIDL estiver implementada, execute VtsHalWifiSupplicantV1_2TargetTest para testar o comportamento da HAL v1.2 suplicante.

Se a interface AIDL estiver implementada, execute VtsHalWifiSupplicantStaIfaceTargetTest para testar o comportamento da HAL suplicante.