WifiConfig_NetworkDiagnostics estrutura

Artigo
08/09/2023

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

Informações sobre a falha mais recente ao ligar a uma rede.

Nota

Trata-se de um alias para uma estrutura com versões. Defina WIFICONFIG_STRUCTS_VERSION para utilizar este 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á ativada. O valor é 1 se estiver ativado e 0 se não estiver ativado. Este campo indica o estado atual da rede, não o estado da configuração. O valor será 0 se a rede estiver temporariamente desativada.

uint8_t isConnected

Indica se a rede está ligada. O valor é 1 se estiver ligado e 0 se não estiver ligado.

int32_t erro

O motivo da falha mais recente na ligação a esta rede. Valores possíveis:

Tipo	Valor	Significado
Falha na Ligação	1	Mensagem de erro genérica quando a ligação falha. Para as redes EAP-TLS, este erro é potencialmente causado por não conseguir aceder ao servidor RADIUS ou utilizar uma identidade de cliente que o servidor RADIUS não reconhece.
NetworkNotFound	2	A rede não foi encontrada.
NoPskIncluded	3	A palavra-passe de rede está em falta.
WrongKey	4	A rede está a utilizar uma palavra-passe incorreta.
Falha na Autenticação	5	Falha na autenticação. Este erro aplica-se apenas a 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	A rede não é suportada porque não foi detetado nenhum Conjunto de Serviços Alargados (ESS), Conjunto de Serviços Básico Pessoal (PBSS) ou Standard de Segurança de Linha de Base Mínima (MBSS).
NetworkNotSupported	9	A rede não é suportada.
NetworkNonWpa	10	A rede não é WPA2PSK, WPA2EAP ou Open.

carimbo de data/hora time_t

A hora do SO em que o erro foi registado.

int32_t certError

O erro de certificado, significativo apenas quando error indica AuthenticationFailed. Nota: podem existir condições em que certError pode não devolver 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 Ligaçã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 para o dispositivo.
AC de Raiz Inválida	101	AC de raiz incorreta devido a expiração, cadeia inválida ou outros problemas ao verificar 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 de cliente (por exemplo, um nome de utilizador conhecido com a palavra-passe de outro utilizador).
ID de 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 apenas quando error indica AuthenticationFailed e certDepth é um número não negativo (0 ou positivo).

CertStore_SubjectName certSubject

O assunto do certificado. Relevante apenas quando error indica AuthenticationFailed.

Partilhar via