struct WifiConfig_NetworkDiagnostics

Artigo
08/09/2023

Cabeçalho: #include <applibs/wificonfig.h>

Informações sobre a falha mais recente em se conectar a uma rede.

Nota

Este é um alias para uma estrutura com versão. Defina WIFICONFIG_STRUCTS_VERSION para usar esse alias.

typedef struct WifiConfig_NetworkDiagnostics {

    uint8_t isEnabled;
    uint8_t isConnected;
    int32_t error;
    time_t timestamp;
    int32_t certError;
    int32_t certDepth;
    CertStore_SubjectName certSubject;
} WifiConfig_NetworkDiagnostics;

Membros

uint8_t isEnabled

Indica se a rede está habilitada. O valor será 1 se habilitado e 0 se não estiver habilitado. Esse campo indica o estado atual da rede, não o estado da configuração. O valor será 0 se a rede estiver temporariamente desabilitada.

uint8_t isConnected

Indica se a rede está conectada. O valor será 1 se conectado e 0 se não estiver conectado.

int32_t erro

O motivo da falha mais recente em se conectar a essa rede. Valores possíveis:

Tipo	Valor	Significado
Falha na conexão	1	Mensagem de erro genérica quando a conexão falha. Para redes EAP-TLS, esse erro é potencialmente causado por não conseguir alcançar o servidor RADIUS ou usar uma identidade de cliente que o servidor RADIUS não reconhece.
NetworkNotFound	2	A rede não foi encontrada.
NoPskIncluded	3	A senha de rede está ausente.
WrongKey	4	A rede está usando uma senha incorreta.
Falha na autenticação	5	Falha na autenticação. Esse erro se aplica apenas às redes EAP-TLS.
SecurityTypeMismatch	6	O tipo de segurança da rede armazenada não corresponde à rede disponível.
NetworkFrequencyNotAllowed	7	Frequência de rede não permitida.
NetworkNotEssPbssMbss	8	Não há suporte para rede porque não foi detectado nenhum ESS (Conjunto de Serviço Estendido), PBSS (Conjunto de Serviços Básico Pessoal) ou MBSS (Padrão Mínimo de Segurança de Linha de Base).
NetworkNotSupported	9	Não há suporte para rede.
NetworkNonWpa	10	A rede não é WPA2PSK, WPA2EAP ou Open.

carimbo de data/hora time_t

O tempo do sistema operacional em que o erro foi registrado.

int32_t certError

O erro de certificado, significativo somente quando error indica Falha de Autenticação. Observação: pode haver condições em que certError pode não retornar um erro.

Valores possíveis:

   ERRID                          Potential Problem
   Unspecified = 0:               Generic error message when certificate validation fails.
   Certificate Not Found = 100:   This could be due to an incorrect certificate specified when configuring the EAP-TLS network, or ReloadConfig() was not called after loading   the certificates onto the device.
   Invalid Root CA= 101:          Root CA incorrect due to expiry, invalid chain, or other issues verifying the server certificate.
   Invalid client authentication  Invalid client certificate or using a valid client identity but incorrectly associated with client certificate.
   =102:

Tipo	Valor	Significado
Falha na conexão	0	Mensagem de erro genérica quando a validação do certificado falha.
Certificado não encontrado	100	Certificado incorreto especificado ao configurar a rede EAP-TLS ou `ReloadConfig()` não foi chamado depois de carregar os certificados no dispositivo.
AC raiz inválida	101	A AC raiz incorreta devido à expiração, cadeia inválida ou outros problemas que verificam o certificado do servidor.
Autenticação de cliente inválida	102	1) um certificado de cliente que não é reconhecido pelo servidor ou que contém erros ou 2) uma identidade de cliente válida incorretamente associada ao certificado do cliente (por exemplo, um nome de usuário conhecido com a senha de outro usuário).
ID do cliente desconhecido	103	A identidade do cliente não foi reconhecida pelo servidor de autenticação.

int32_t certDepth

A posição do certificado na cadeia de certificação. Significativo somente quando error indica Falha de Autenticação e certDepth é um número não negativo (0 ou positivo).

CertStore_SubjectName certSubject

O assunto do certificado. Significativo somente quando error indica Falha de Autenticação.

Compartilhar via