Solucionar problemas de rede

Artigo
07/08/2024

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

Verificar o estado da interface de rede

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

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

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 seguintes configurações 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á ativada. Você pode habilitar a interface necessária usando o comando az sphere device network enable ou usando a API Networking_SetInterfaceState Function .
Conectado à rede. Se essa configuração for False:
- Execute az sphere device wifi show-status para verificar se o valor do SSID Wi-Fi corresponde às configurações de Wi-Fi do dispositivo.
- Analise redes para verificar se o SSID nas configurações do dispositivo corresponde ao SSID na rede. Para obter mais informações, consulte o comando wifi scan .
- Se o SSID da sua rede Wi-Fi estiver oculto e a sua aplicação depender de uma análise direcionada, verifique se a análise direcionada está ativada.
Endereço IP adquirido. Se essa configuração for False:
- Aguarde até que uma conexão seja feita.
- Verifique a sua rede para ver se o ponto de acesso e outros dispositivos na rede estão totalmente ligados. 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 a sua rede está ligada à Internet.

Verificar o estado do Wi-Fi

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

Deverá ver um resultado semelhante ao 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 ligação estiver definido como desligado, ative o Wi-Fi no dispositivo.

Verificar o estado da rede

Execute az sphere device network show-status para visualizar o status da rede para o dispositivo conectado.

Deverá ver um resultado semelhante ao seguinte:

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

Se Is device authentication ready retorna False,
- Reinicie o dispositivo e tente o comando novamente.
- Certifique-se de que a sua rede está configurada para permitir tráfego de entrada e saída. Para obter mais informações, consulte Portas e protocolos.
Se o status de sincronização de tempo de rede retornar Incompleto,
- Aguarde até que uma conexão seja feita.
- Certifique-se de que a sua rede está configurada para permitir tráfego de entrada e saída. Para obter mais informações, consulte Portas e protocolos.

Verifique as configurações do firewall

Se o seu 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 o AllowedConnections recurso.
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 o AllowedTcpServerPorts, e AllowedUdpServerPorts os recursos.

Se continuar a ter 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.

Obtenha diagnósticos de rede

Quando ocorre uma falha de rede, você pode obter informações de diagnóstico sobre a falha de duas maneiras: através de uma chamada para a API WifiConfig e da linha de comando.

Um aplicativo de alto nível pode chamar WifiConfig_GetNetworkDiagnostics para coletar informações sobre o problema. Esta função retorna uma WifiConfig_NetworkDiagnostics estrutura 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 e recuperar de falhas comuns de rede.

O exemplo de 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 errados, verifique se a configuração de rede está correta. Se você alterou 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 garantir que a configuração de rede persista nas reinicializações, um aplicativo pode chamar WifiConfig_PersistConfig.

Problemas ao atualizar um certificado de autoridade de certificação raiz

Se o dispositivo não puder se conectar a uma rede EAP-TLS depois de atualizar o certificado de autoridade de certificação raiz, comece 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 pode ser a causa:

O antigo Root CA1 expirou ou foi alterado no servidor RADIUS durante o processo de atualização? Em caso afirmativo, o novo CA2 raiz pode estar incorreto.
Ocorreu alguma outra falha no lado do servidor? Consulte o administrador da rede. O administrador pode ter usado uma autoridade de certificação diferente ou incorreta e talvez precise corrigir isso centralmente.

Se o status indicar um erro de certificado de cliente:

A configuração do novo Network2 estava fora de sincronia com as propriedades Network1? Se as propriedades foram alteradas na Rede 1, mas você tentou se conectar usando propriedades desatualizadas na Rede 2, a Rede 2 pode falhar ao se conectar. Certifique-se de que 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 à Network1 e Network2 e certifique-se de que são os mesmos. Um aplicativo pode usar funções na API CertStore para inspecionar detalhes do certificado.

Se a autoridade de certificação 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 a verificar os dados retornados por WifiConfig_GetNetworkDiagnostics após cada tentativa falhada para saber mais sobre o problema.

Problemas ao atualizar um certificado de cliente

Se o dispositivo não conseguir se conectar a uma rede EAP-TLS depois de atualizar o certificado do cliente, comece com o status retornado pela função WifiConfig_SetNetworkEnabled .