struktura WifiConfig_NetworkDiagnostics

Artykuł
08/09/2023

Nagłówek: #include <applibs/wificonfig.h>

Informacje o ostatnim niepowodzeniu połączenia z siecią.

Uwaga

To jest alias do wersji struktury. Zdefiniuj WIFICONFIG_STRUCTS_VERSION, aby użyć tego aliasu.

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;

Członków

uint8_t isEnabled

Wskazuje, czy sieć jest włączona. Wartość to 1, jeśli jest włączona, i 0, jeśli nie jest włączona. To pole wskazuje bieżący stan sieci, a nie stan konfiguracji. Jeśli sieć zostanie tymczasowo wyłączona, wartość będzie wynosić 0.

uint8_t jest połączony

Wskazuje, czy sieć jest połączona. Wartość to 1, jeśli jest połączona, i 0, jeśli nie jest połączona.

błąd int32_t

Przyczyna ostatniego niepowodzenia połączenia z tą siecią. Możliwe wartości:

Typu	Wartość	Znaczenie
Połączenie nie powiodło się	1	Ogólny komunikat o błędzie, gdy połączenie nie powiedzie się. W przypadku sieci EAP-TLS ten błąd jest potencjalnie spowodowany brakiem możliwości dotarcia do serwera RADIUS lub używania tożsamości klienta, których serwer RADIUS nie rozpoznaje.
NetworkNotFound	2	Nie znaleziono sieci.
NoPskIncluded	3	Brakuje hasła sieci.
WrongKey	4	Sieć używa nieprawidłowego hasła.
Uwierzytelnianie nie powiodło się	5	Uwierzytelnianie nie powiodło się. Ten błąd dotyczy tylko sieci EAP-TLS.
SecurityTypeMismatch	6	Typ zabezpieczeń przechowywanej sieci nie odpowiada dostępnej sieci.
NetworkFrequencyNotAllowed	7	Częstotliwość sieci jest niedozwolona.
NetworkNotEssPbssMbss	8	Sieć nie jest obsługiwana, ponieważ nie wykryto rozszerzonego zestawu usług (ESS), zestawu usług Personal Basic Service Set (PBSS) ani minimalnego standardu zabezpieczeń wg planu bazowego (MBSS).
NetworkNotSupported	9	Sieć nie jest obsługiwana.
NetworkNonWpa	10	Sieć nie jest WPA2PSK, WPA2EAP lub Open.

sygnatura czasowa time_t

Czas systemu operacyjnego, w którym został zarejestrowany błąd.

int32_t certError

Błąd certyfikatu zrozumiały tylko wtedy, gdy error wskazuje, że uwierzytelnianie nie powiodło się. Uwaga: mogą istnieć warunki, w których certError może nie zostać zwrócony błąd.

Możliwe wartości:

   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:

Typu	Wartość	Znaczenie
Połączenie nie powiodło się	0	Ogólny komunikat o błędzie, gdy sprawdzanie poprawności certyfikatu kończy się niepowodzeniem.
Nie można odnaleźć certyfikatu	100	Niepoprawny certyfikat określony podczas konfigurowania sieci EAP-TLS lub `ReloadConfig()` nie został wywołany po załadowaniu certyfikatów na urządzenie.
Nieprawidłowy główny urząd certyfikacji	101	Główny urząd certyfikacji jest niepoprawny z powodu wygaśnięcia, nieprawidłowego łańcucha lub innych problemów z weryfikacją certyfikatu serwera.
Nieprawidłowe uwierzytelnianie klienta	102	1) certyfikat klienta, który nie jest rozpoznawany przez serwer lub zawierający błędy lub 2) prawidłową tożsamość klienta niepoprawnie skojarzoną z certyfikatem klienta (na przykład znaną nazwę użytkownika z hasłem innego użytkownika).
Nieznany identyfikator klienta	103	Tożsamość klienta nie została rozpoznana przez serwer uwierzytelniania.

int32_t certDepth

Pozycja certyfikatu w łańcuchu certyfikacji. Opisowe tylko wtedy, gdy error wskazuje uwierzytelnianie nie powiodło się i certDepth jest liczbą nie ujemną (0 lub dodatnią).

CertStore_SubjectName certSubject

Temat certyfikatu. Opisowe tylko wtedy, gdy error wskazuje, że uwierzytelnianie nie powiodło się.

Udostępnij za pośrednictwem