WifiConfig_NetworkDiagnostics struct

Artikel
08/09/2023

Header: #include <applibs/wificonfig.h>

Informatie over de meest recente fout bij het maken van verbinding met een netwerk.

Opmerking

Dit is een alias voor een structuur met versiebeheer. Definieer WIFICONFIG_STRUCTS_VERSION om deze alias te gebruiken.

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;

Leden

uint8_t isInabled

Geeft aan of het netwerk is ingeschakeld. De waarde is 1 indien ingeschakeld en 0 als deze niet is ingeschakeld. Dit veld geeft de huidige status van het netwerk aan, niet de status van de configuratie. De waarde is 0 als het netwerk tijdelijk is uitgeschakeld.

uint8_t is Verbonden

Geeft aan of het netwerk is verbonden. De waarde is 1 als deze is verbonden en 0 als deze niet is verbonden.

int32_t fout

De reden voor de meest recente fout bij het maken van verbinding met dit netwerk. Mogelijke waarden:

Type	Waarde	Betekenis
ConnectionFailed	1	Algemeen foutbericht wanneer de verbinding mislukt. Voor EAP-TLS-netwerken wordt deze fout mogelijk veroorzaakt door het niet kunnen bereiken van de RADIUS-server of het gebruik van een client-identiteit die de RADIUS-server niet herkent.
NetworkNotFound	2	Netwerk is niet gevonden.
NoPskIncluded	3	Het netwerkwachtwoord ontbreekt.
WrongKey	4	Netwerk gebruikt een onjuist wachtwoord.
AuthenticationFailed	5	Verificatie is mislukt. Deze fout is alleen van toepassing op EAP-TLS-netwerken.
SecurityTypeMismatch	6	Het beveiligingstype van het opgeslagen netwerk komt niet overeen met het beschikbare netwerk.
NetworkFrequencyNotAllowed	7	Netwerkfrequentie niet toegestaan.
NetworkNotEssPbssMbss	8	Netwerk wordt niet ondersteund omdat er geen Extended Service Set (ESS), Personal Basic Service Set (PBSS) of Minimum Baseline Security Standard (MBSS) is gedetecteerd.
NetworkNotSupported	9	Netwerk wordt niet ondersteund.
NetworkNonWpa	10	Netwerk is niet WPA2PSK, WPA2EAP of Open.

time_t tijdstempel

Het besturingssysteemtijdsgetijde waarop de fout is vastgelegd.

int32_t certError

De certificaatfout is alleen zinvol wanneer error AuthenticationFailed wordt aangegeven. Opmerking: er kunnen voorwaarden zijn waarbij certError er mogelijk geen fout wordt geretourneerd.

Mogelijke waarden:

   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	Waarde	Betekenis
ConnectionFailed	0	Algemeen foutbericht wanneer certificaatvalidatie mislukt.
Certificaat niet gevonden	100	Onjuist certificaat opgegeven bij het configureren van het EAP-TLS-netwerk of `ReloadConfig()` is niet aangeroepen na het laden van de certificaten op het apparaat.
Ongeldige basis-CA	101	De basis-CA is onjuist vanwege verlopen, ongeldige keten of andere problemen met het verifiëren van het servercertificaat.
Ongeldige clientverificatie	102	1) een clientcertificaat dat niet wordt herkend door de server of dat fouten bevat of 2) een geldige client-id die onjuist is gekoppeld aan het clientcertificaat (bijvoorbeeld een bekende gebruikersnaam met het wachtwoord van een andere gebruiker).
Onbekende client-id	103	De client-identiteit is niet herkend door de verificatieserver.

int32_t certDepth

De positie van het certificaat in de certificeringsketen. Alleen zinvol wanneer error AuthenticationFailed wordt aangegeven en certDepth een niet-negatief (0 of positief) getal is.

CertStore_SubjectName certSubject

Het onderwerp van het certificaat. Alleen zinvol wanneer error AuthenticationFailed wordt aangegeven.

Share via