WifiConfig_NetworkDiagnostics estructura
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.