WifiConfig_NetworkDiagnostics struct

Article
08/09/2023

En-tête : #include <applibs/wificonfig.h>

Informations sur l’échec le plus récent de connexion à un réseau.

Note

Il s’agit d’un alias pour une structure avec version. Définissez WIFICONFIG_STRUCTS_VERSION pour utiliser cet 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;

Membres

uint8_t isEnabled

Indique si le réseau est activé. La valeur est 1 si activé et 0 s’il n’est pas activé. Ce champ indique l’état actuel du réseau, et non l’état de la configuration. La valeur est 0 si le réseau est temporairement désactivé.

uint8_t isConnected

Indique si le réseau est connecté. La valeur est 1 si connecté et 0 s’il n’est pas connecté.

erreur int32_t

Raison de l’échec le plus récent de connexion à ce réseau. Valeurs possibles :

Type	Valeur	Sens
Échec de la connexion	1	Message d’erreur générique en cas d’échec de la connexion. Pour les réseaux EAP-TLS, cette erreur est potentiellement due à l’impossibilité d’atteindre le serveur RADIUS ou à l’utilisation d’une identité cliente que le serveur RADIUS ne reconnaît pas.
NetworkNotFound	2	Réseau introuvable.
NoPskIncluded	3	Mot de passe réseau manquant.
Clé incorrecte	4	Le réseau utilise un mot de passe incorrect.
Échec de l’authentification	5	Échec de l’authentification. Cette erreur s’applique uniquement aux réseaux EAP-TLS.
SecurityTypeMismatch	6	Le type de sécurité du réseau stocké ne correspond pas au réseau disponible.
NetworkFrequencyNotAllowed	7	Fréquence réseau non autorisée.
NetworkNotEssPbssMbs	8	Le réseau n’est pas pris en charge, car aucun ensemble de services étendus (ESS), PBSS (Personal Basic Service Set) ou MBSS (Minimum Baseline Security Standard) n’a été détecté.
NetworkNotSupported	9	Le réseau n’est pas pris en charge.
NetworkNonWpa	10	Le réseau n’est pas WPA2PSK, WPA2EAP ou Open.

horodatage time_t

Heure du système d’exploitation à laquelle l’erreur a été enregistrée.

int32_t certError

Erreur de certificat, significative uniquement quand error indique AuthenticationFailed. Remarque : Il peut y avoir des conditions où certError peut ne pas retourner une erreur.

Valeurs possibles :

   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:

Type	Valeur	Sens
Échec de la connexion	0	Message d’erreur générique en cas d’échec de la validation du certificat.
Certificat introuvable	100	Certificat incorrect spécifié lors de la configuration du réseau EAP-TLS, ou `ReloadConfig()` n’a pas été appelé après le chargement des certificats sur l’appareil.
Autorité de certification racine non valide	101	L’autorité de certification racine est incorrecte en raison de l’expiration, d’une chaîne non valide ou d’autres problèmes de vérification du certificat de serveur.
Authentification du client non valide	102	1) un certificat client qui n’est pas reconnu par le serveur ou qui contient des erreurs ou 2) une identité client valide incorrectement associée au certificat client (par exemple, un nom d’utilisateur connu avec le mot de passe d’un autre utilisateur).
ID client inconnu	103	L’identité du client n’a pas été reconnue par le serveur d’authentification.

int32_t certDepth

Position du certificat dans la chaîne de certification. Significatif uniquement quand error indique AuthenticationFailed et certDepth est un nombre non négatif (0 ou positif).

CertStore_SubjectName certSubject

Objet du certificat. Significatif uniquement quand error indique AuthenticationFailed.

Partage via