WifiConfig_NetworkDiagnostics Struktur

  • Artikel

Header: #include <applibs/wificonfig.h>

Informationen zum letzten Fehler beim Herstellen einer Verbindung mit einem Netzwerk.

Hinweis

Dies ist ein Alias für eine Struktur mit Versionsverwaltung. Definieren Sie WIFICONFIG_STRUCTS_VERSION, um diesen Alias zu verwenden.

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;

Mitglieder

uint8_t isEnabled

Gibt an, ob das Netzwerk aktiviert ist. Der Wert ist 1, wenn aktiviert, und 0, wenn nicht aktiviert. Dieses Feld gibt den aktuellen Zustand des Netzwerks an, nicht den Status der Konfiguration. Der Wert ist 0, wenn das Netzwerk vorübergehend deaktiviert ist.

uint8_t isConnected

Gibt an, ob das Netzwerk verbunden ist. Der Wert ist 1, wenn verbunden und 0, wenn keine Verbindung besteht.

int32_t Fehler

Der Grund für den letzten Fehler beim Herstellen einer Verbindung mit diesem Netzwerk. Mögliche Werte:

Typ Wert Bedeutung
ConnectionFailed 1 Generische Fehlermeldung, wenn die Verbindung fehlschlägt. Bei EAP-TLS-Netzwerken wird dieser Fehler möglicherweise dadurch verursacht, dass der RADIUS-Server nicht erreichbar ist oder eine Clientidentität verwendet wird, die der RADIUS-Server nicht erkennt.
NetworkNotFound 2 Das Netzwerk wurde nicht gefunden.
NoPskIncluded 3 Das Netzwerkkennwort fehlt.
WrongKey 4 Das Netzwerk verwendet ein falsches Kennwort.
AuthenticationFailed 5 Fehler bei der Authentifizierung. Dieser Fehler gilt nur für EAP-TLS-Netzwerke.
SecurityTypeMismatch 6 Der Sicherheitstyp des gespeicherten Netzwerks stimmt nicht mit dem verfügbaren Netzwerk überein.
NetworkFrequencyNotAllowed 7 Die Netzwerkhäufigkeit ist nicht zulässig.
NetworkNotEssPbssMbss 8 Netzwerk wird nicht unterstützt, da kein erweiterter Dienstsatz (ESS), Personal Basic Service Set (PBSS) oder Minimum Baseline Security Standard (MBSS) erkannt wurde.
NetworkNotSupported 9 Netzwerk wird nicht unterstützt.
NetworkNonWpa 10 Das Netzwerk ist nicht WPA2PSK, WPA2EAP oder Open.

time_t Zeitstempel

Die Betriebssystemzeit, zu der der Fehler aufgezeichnet wurde.

int32_t certError

Der Zertifikatfehler, der nur dann aussagekräftig ist, wenn error AuthenticationFailed angegeben ist. Hinweis: Möglicherweise gibt es Bedingungen, bei denen certError möglicherweise kein Fehler zurückgegeben wird.

Mögliche Werte:

   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:
Typ Wert Bedeutung
ConnectionFailed 0 Generische Fehlermeldung, wenn die Zertifikatüberprüfung fehlschlägt.
Zertifikat nicht gefunden 100 Falsches Zertifikat, das beim Konfigurieren des EAP-TLS-Netzwerks angegeben wurde oder ReloadConfig() nicht aufgerufen wurde, nachdem die Zertifikate auf das Gerät geladen wurden.
Ungültige Stammzertifizierungsstelle 101 Die Stammzertifizierungsstelle ist aufgrund eines Ablaufs, einer ungültigen Kette oder anderer Probleme bei der Überprüfung des Serverzertifikats falsch.
Ungültige Clientauthentifizierung 102 1) Ein Clientzertifikat, das vom Server nicht erkannt wird oder fehler enthält, oder 2) eine gültige Clientidentität, die fälschlicherweise dem Clientzertifikat zugeordnet ist (z. B. ein bekannter Benutzername mit dem Kennwort eines anderen Benutzers).
Unbekannte Client-ID 103 Die Clientidentität wurde vom Authentifizierungsserver nicht erkannt.

int32_t certDepth

Die Position des Zertifikats in der Zertifizierungskette. Aussagekräftig ist nur, wenn error AuthenticationFailed angibt und certDepth eine nicht negative (0 oder positive) Zahl ist.

CertStore_SubjectName certSubject

Der Antragsteller des Zertifikats. Nur sinnvoll, wenn error AuthenticationFailed angibt.