Solucionar problemas de rede

Artigo
07/08/2024

Problemas de rede podem ser notoriamente difíceis de diagnosticar e resolver. Por exemplo, você pode descobrir que sua rede Wi-Fi está funcionando bem localmente, mas está desconectada da Internet. Nesse caso, você pode descobrir que seu dispositivo do Azure Sphere não está atualizando corretamente. Este tópico fornece algumas sugestões que podem ajudar a diagnosticar problemas de rede.

Verificar o status do adaptador de rede

Abra uma interface de linha de comando usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux.

Execute az sphere device network list-interfaces para listar os detalhes das interfaces de rede para o dispositivo anexado.

A saída exibe todas as interfaces configuradas para o seu dispositivo. Para cada interface no dispositivo, a saída mostra o seguinte:

[
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": null,
    "interfaceName": "azspheresvc",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": [
      "192.168.35.2"
    ],
    "ipAssignment": null
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": "b2:30:bb:f0:d1:44",
    "interfaceName": "eth0",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": null,
    "ipAssignment": "dynamic"
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": null,
    "interfaceName": "lo",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": [
      "127.0.0.1"
    ],
    "ipAssignment": null
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": "00:02:b5:03:69:ea",
    "interfaceName": "wlan0",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": null,
    "ipAssignment": "dynamic"
  }
]

Verifique se as configurações a seguir para a interface são True.

Interface de rede para cima. Se essa configuração for False:
- Verifique se os dispositivos locais que usam o ponto de acesso estão conectados. Para obter mais informações, consulte Networking_IsNetworkingReady Função.
- Verifique se a interface de rede está habilitada. Você pode habilitar a interface necessária usando o comando az sphere device network enable ou usando a API de Função Networking_SetInterfaceState.
Conectado à rede. Se essa configuração for False:
- Execute az sphere device wifi show-status para verificar se o valor do SSID do Wi-Fi corresponde às configurações de Wi-Fi do dispositivo.
- Procure redes para verificar se o SSID nas configurações do dispositivo corresponde ao SSID em sua rede. Para obter mais informações, consulte o comando wifi scan .
- Se o SSID da sua rede Wi-Fi estiver oculto e seu aplicativo depender de uma verificação direcionada, verifique se a verificação direcionada está ativada.
Endereço IP adquirido. Se essa configuração for False:
- Aguarde até que uma conexão seja feita.
- Verifique sua rede para ver se o ponto de acesso e outros dispositivos na rede estão totalmente conectados. Para obter mais informações, consulte Networking_IsNetworkingReady Função.
- Verifique o intervalo de endereços IP permitidos ou o limite de conexões permitidas em seu ponto de acesso e rede.
Conectado à internet. Se essa configuração for False:
- Verifique se sua rede está conectada à Internet.

Verificar o status do Wi-Fi

Abra uma interface de linha de comando usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux.
Execute az sphere device wifi show-status para exibir informações sobre a conexão Wi-Fi atual no dispositivo.

Será exibida uma saída semelhante à seguinte:

 az sphere device wifi show-status
{
  "SSID": "MSFTGUEST",
  "configurationState": "enabled",
  "connectionState": "connected",
  "frequency": 5660,
  "ipAddress": "10.106.106.40",
  "keyManagement": "NONE",
  "macAddress": "00:02:b5:03:69:ea",
  "mode": "station",
  "securityState": "open",
  "wpaState": "COMPLETED"
}

Se o estado da conexão estiver definido como desconectado, ative o Wi-Fi no seu dispositivo.

Verificar status de rede

Execute az sphere device network show-status para exibir o status da rede para o dispositivo anexado.

Será exibida uma saída semelhante à seguinte:

az sphere device network show-status
{
  "deviceAuthenticationIsReady": false,
  "networkTimeSync": "incomplete",
  "proxy": "disabled"
}

Se a autenticação do dispositivo estiver pronta retornar False,
- Reinicie o dispositivo e tente o comando novamente.
- Certifique-se de que sua rede esteja configurada para permitir o tráfego de entrada e saída. Para obter mais informações, consulte Portas e protocolos.
Se o status da sincronização de horário de rede retornar Incompleto,
- Aguarde até que uma conexão seja feita.
- Certifique-se de que sua rede esteja configurada para permitir o tráfego de entrada e saída. Para obter mais informações, consulte Portas e protocolos.

Verifique as configurações do firewall

Se o aplicativo não conseguir se conectar a um host remoto:

Verifique as configurações de firewall do aplicativo. O manifesto do aplicativo deve especificar os nomes de host ou endereços IP aos quais o aplicativo tem permissão para se conectar, definindo a AllowedConnections funcionalidade.
Se o aplicativo tiver sido configurado para executar a descoberta de serviço, além das entradas no manifesto do aplicativo, os pontos de extremidade descobertos também deverão ser listados na configuração do firewall.

Se os hosts remotos não conseguirem se conectar ao seu aplicativo de servidor:

Verifique as configurações de firewall do aplicativo. O manifesto do aplicativo deve especificar as portas UDP e TCP para as quais o aplicativo está aberto para conexões de entrada, definindo os recursos e AllowedUdpServerPorts .AllowedTcpServerPorts

Se você ainda estiver tendo dificuldades:

Execute az sphere device network list-firewall-rules e verifique se o endereço IP nas regras de firewall e o arquivo de manifesto do aplicativo correspondem.
Verifique se as conexões padrão do sistema estão presentes por padrão.

Obter diagnóstico de rede

Quando ocorre uma falha de rede, você pode obter informações de diagnóstico sobre a falha de duas maneiras: por meio de uma chamada à API WifiConfig e na linha de comando.

Um aplicativo de alto nível pode chamar WifiConfig_GetNetworkDiagnostics para coletar informações sobre o problema. Essa função retorna uma estrutura WifiConfig_NetworkDiagnostics que contém detalhes sobre a falha mais recente na rede especificada. Combine as informações da estrutura de diagnóstico com as dicas a seguir para diagnosticar falhas de rede comuns e recuperar-se delas.

O exemplo WiFi_HighLevelApp mostra como usar o diagnóstico.

Você também pode usar o comando az sphere device network show-diagnostics para exibir informações de diagnóstico sobre o último erro.

Conexão de rede incorreta

Se o dispositivo estiver conectado à rede incorreta ou estiver conectado, mas com os atributos incorretos, verifique se a configuração de rede está correta. Se você tiver alterado a configuração, deverá recarregá-la. Em um aplicativo, chame WifiConfig_ReloadConfig ou na linha de comando, use o comando az sphere device wifi reload-config para recarregar a configuração atual. Para verificar se a configuração de rede persiste entre reinicializações, um aplicativo pode chamar WifiConfig_PersistConfig.

Problemas ao atualizar um Certificado de Autoridade de Certificação raiz

Se o dispositivo não conseguir se conectar a uma rede EAP-TLS após atualizar o Certificado de Autoridade de Certificação raiz, inicie com o status retornado pela função WifiConfig_SetNetworkEnabled.

Se o status indicar um erro de Certificado de Autoridade de Certificação raiz, uma das seguintes opções poderá ser a causa:

A CA1 raiz antiga expirou ou alterou o servidor RADIUS durante o processo de atualização? Em caso afirmativo, a nova CA2 raiz pode estar incorreta.
Alguma outra falha ocorreu no lado do servidor? Verifique com seu administrador da rede. O administrador pode ter usado uma autoridade de certificação diferente ou incorreta e pode precisar corrigir isso de maneira centralizada.

Se o status indicar um erro de certificado do cliente:

A configuração da nova Network2 estava fora de sincronia com as propriedades da Network1? Se as propriedades foram alteradas na Network 1, mas você tentou se conectar usando propriedades desatualizadas na Network2, talvez a Network2 falhe ao se conectar. Verifique se as propriedades de chave são idênticas para as duas redes.
O certificado do cliente foi alterado durante o processo de atualização da rede? Verifique os certificados associados à Rede1 e à Rede2 e verifique se eles são os mesmos. Um aplicativo pode usar funções na API CertStore para inspecionar detalhes do certificado.

Se a CA raiz e o certificado do cliente estiverem corretos, a falha pode estar relacionada ao seu ponto de acesso Wi-Fi ou a algum outro problema.

Continue verificando os dados retornados por WifiConfig_GetNetworkDiagnostics depois de cada tentativa com falha para saber mais sobre o problema.

Problemas ao atualizar um certificado do cliente

Se o dispositivo não conseguir se conectar a uma rede EAP-TLS após atualizar o certificado do cliente, inicie com o status retornado pela função WifiConfig_SetNetworkEnabled.