WifiConfig_NetworkDiagnostics estructura

Artículo
08/09/2023

Encabezado: #include <applibs/wificonfig.h>

Información sobre el error más reciente al conectarse a una red.

Nota

Se trata de un alias de una estructura versionada. Define WIFICONFIG_STRUCTS_VERSION usar 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;

Miembros

uint8_t isEnabled

Indica si la red está habilitada. El valor es 1 si está habilitado y 0 si no está habilitado. Este campo indica el estado actual de la red, no el estado de la configuración. El valor será 0 si la red está deshabilitada temporalmente.

uint8_t isConnected

Indica si la red está conectada. El valor es 1 si está conectado y 0 si no está conectado.

int32_t error

El motivo del error más reciente al conectarse a esta red. Valores posibles:

Tipo	Valor	Significado
ConexiónFailed	1	Mensaje de error genérico cuando se produce un error en la conexión. Para las redes EAP-TLS, este error es potencialmente causado por no poder alcanzar el servidor radius o usando una identidad de cliente que el servidor radius no reconoce.
NetworkNotFound	2	No se encontró la red.
NoPskIncluded	3	Falta la contraseña de red.
WrongKey	4	La red está usando una contraseña incorrecta.
Autenticación Desactivada	5	Error de autenticación. Este error se aplica solamente a las redes EAP-TLS.
SecurityTypeMismatch	6	El tipo de seguridad de la red almacenada no coincide con la red disponible.
NetworkFrequencyNotAllowed	7	Frecuencia de red no permitida.
NetworkNotEssPbssMbss	8	La red no es compatible porque no se detectó ningún conjunto de servicios extendido (ESS), un conjunto de servicios básicos personales (PBSS) ni un estándar de seguridad de línea base mínima (MBSS).
NetworkNotSupported	9	La red no es compatible.
NetworkNonWpa	10	La red no es WPA2PSK, WPA2EAP ni Abierta.

marca de tiempo time_t

El momento del so en el que se registró el error.

int32_t certError

El error del certificado, significativo solo cuando error indica AuthenticationFailed. Nota: Puede haber condiciones en certError las que no se pueda devolver un error.

Valores posibles:

   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
ConexiónFailed	0	Mensaje de error genérico cuando se produce un error en la validación del certificado.
Certificado no encontrado	100	Certificado incorrecto especificado al configurar la red EAP-TLS, o `ReloadConfig()` no fue llamado después de cargar los Certificados en el dispositivo.
CA raíz no válida	101	CA raíz incorrecta debido a expiración, cadena no válida u otros problemas que verifican el certificado del servidor.
Autenticación de cliente no válida	102	1) un certificado de cliente que el servidor no reconoce o que contiene errores o 2) una identidad de cliente válida asociada incorrectamente con el certificado de cliente (por ejemplo, un nombre de usuario conocido con la contraseña de otro usuario).
Id. de cliente desconocido	103	El servidor de autenticación no ha reconocido la identidad de cliente.

int32_t certDepth

La posición del certificado en la cadena de certificación. Significativo solo cuando error indica AuthenticationFailed y certDepth es un número no negativo (0 o positivo).

CertStore_SubjectName certSubject

El asunto del certificado. Significativo solo cuando error indica AuthenticationFailed.

Compartir vía