WifiConfig_NetworkDiagnostics 구조체

아티클
08/09/2023

헤더: #include <applibs/wificonfig.h>

네트워크에 연결하지 못한 최신 오류에 대한 정보입니다.

참고

버전이 지정된 구조체의 별칭입니다. 이 별칭을 사용할 WIFICONFIG_STRUCTS_VERSION 정의합니다.

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;

멤버

uint8_t IsEnabled

네트워크를 사용할 수 있는지 여부를 나타냅니다. 활성화된 경우 값은 1이고, 활성화되지 않은 경우 0입니다. 이 필드는 구성 상태가 아니라 네트워크의 현재 상태를 나타냅니다. 네트워크가 일시적으로 비활성화된 경우 값은 0이 됩니다.

uint8_t 연결됨

네트워크가 연결되어 있는지 여부를 나타냅니다. 연결된 경우 값은 1이고 연결되지 않은 경우 0입니다.

int32_t 오류

가장 최근에 이 네트워크에 연결하지 못한 이유입니다. 가능한 값:

형식	값	의미
ConnectionFailed	1	연결이 실패하면 일반적인 오류 메시지입니다. EAP-TLS 네트워크의 경우 이 오류는 RADIUS 서버에 연결할 수 없거나 RADIUS 서버가 인식하지 못하는 클라이언트 ID를 사용하여 발생할 수 있습니다.
NetworkNotFound	2	네트워크를 찾을 수 없습니다.
NoPskIncluded	3	네트워크 암호가 없습니다.
WrongKey	4	네트워크에서 잘못된 암호를 사용하고 있습니다.
AuthenticationFailed	5	인증에 실패했습니다. 이 오류는 EAP-TLS 네트워크에만 적용됩니다.
SecurityTypeMismatch	6	저장된 네트워크의 보안 유형이 사용 가능한 네트워크와 일치하지 않습니다.
NetworkFrequencyNotAllowed	7	네트워크 빈도는 허용되지 않습니다.
NetworkNotEssPbssMbss	8	ESS(확장 서비스 집합), PBSS(Personal Basic Service Set) 또는 최소 기준 보안 표준(MBSS)이 검색되지 않았기 때문에 네트워크가 지원되지 않습니다.
NetworkNotSupported	9	네트워크는 지원되지 않습니다.
NetworkNonWpa	10	네트워크가 WPA2PSK, WPA2EAP 또는 Open이 아닙니다.

time_t 타임스탬프

오류가 기록된 OS 시간입니다.

int32_t certError

AuthenticationFailed를 나타내는 경우에만 error 의미 있는 인증서 오류입니다. 참고: 오류를 반환하지 않을 수 있는 certError 조건이 있을 수 있습니다.

가능한 값:

   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:

형식	값	의미
ConnectionFailed	0	인증서 유효성 검사가 실패할 때의 일반 오류 메시지입니다.
인증서를 찾을 수 없음	100	EAP-TLS 네트워크를 구성할 때 잘못된 인증서가 지정되었거나 `ReloadConfig()` 디바이스에 인증서를 로드한 후 호출되지 않았습니다.
잘못된 루트 CA	101	만료, 잘못된 체인 또는 서버 인증서를 확인하는 기타 문제로 인해 루트 CA가 잘못되었습니다.
잘못된 클라이언트 인증	102	1) 서버에서 인식되지 않거나 오류가 포함된 클라이언트 인증서 또는 2) 클라이언트 인증서와 잘못 연결된 유효한 클라이언트 ID(예: 다른 사용자의 암호가 있는 알려진 사용자 이름)입니다.
알 수 없는 클라이언트 ID	103	클라이언트 ID가 인증 서버에서 인식되지 않았습니다.

int32_t certDepth

인증 체인에서 인증서의 위치입니다. AuthenticationFailed를 나타내고 certDepth 가 음수가 아닌(0 또는 양수) 숫자인 경우에만 error 의미가 있습니다.

CertStore_SubjectName certSubject

인증서의 주체입니다. AuthenticationFailed를 error 나타내는 경우에만 의미가 있습니다.

Share via