네임스페이스 apext::tsync

네임스페이스 apext::tsync은 Adaptive 시간 동기화의 Freshness Value Management를 위한 인터페이스 및 데이터 컨테이너를 제공합니다. 재생 공격(Replay Attack)으로부터 시간 메시지를 보호하기 위해 인터페이스 FVM을 통해 신선도 값(Freshness Value)이 FVContainer 인스턴스로 캡슐화됩니다. 초기화 중 복구할 수 없는 오류가 발생하거나 값을 일시적으로 사용할 수 없는 경우, 이는 TsyncFvmErrorDomain의 오류 코드를 통해 매핑됩니다 [SWS_TS_14202]. 이때 표준화된 오류 객체의 인스턴스화는 MakeErrorCode [SWS_TS_14213]을 통해 예외 안전하고 스레드 안전하게 수행됩니다.

자세히 ›

컨텍스트

네임스페이스 apext::tsync은 AUTOSAR Adaptive 시간 동기화(ara::tsync)의 플랫폼별 확장을 나타냅니다. 주요 작업은 시간 동기화된 네트워크에서 재생 공격 및 오래된 상태를 방지하기 위해 시간 정보의 최신성을 보장하는 메커니즘을 제공하는 Freshness Value Management(FVM)입니다. 핵심 구성 요소로는 인터페이스 FVM, 데이터 컨테이너 FVContainer, 오류 도메인 TsyncFvmErrorDomain 및 예외 클래스 TsyncFvmException가 있습니다.

FVContainer 클래스는 비트 단위의 길이와 바이트 벡터 형태의 값 자체를 관리하여 최신성 값을 캡슐화합니다. FVM 인터페이스는 ara::tsync를 위한 기능적 브릿지 역할을 합니다. FVM은(는) ara::tsync의 시간 동기화 인스턴스가 최신 Frischewert를 가져오거나 검증하는 추상화 인터페이스로 기능할 것으로 추정됩니다. 질문 Q-f92f53d92ec347e5 (열림) TsyncFvmErrorDomain 오류 도메인 및 관련 헬퍼 함수는 표준화된 오류 보고를 보장합니다 [SWS_TS_14212].

컨텍스트 다이어그램: apext::tsync 네임스페이스의 컴포넌트 및 ara::tsync와의 상호작용. 출처: [SWS_TS_14202], [SWS_TS_14212].

수명 주기

apext::tsync 네임스페이스 내 컴포넌트의 수명 주기는 초기화, 작동 및 종료 단계로 구분됩니다. 초기화 단계를 위해 TsyncFvmErrc 열거형은 kFVInitializeFailed (= 2) 오류 값을 정의하며, 이는 복구 불가능한 오류(unrecoverable error)로 명시되어 Freshness Value Manager를 사용할 수 없었음을 나타냅니다 [SWS_TS_14202]. kFVInitializeFailed 오류는 Freshness Value를 조회하기 전에 FVM의 초기화 단계를 거쳐야 하며, 이 단계의 실패 시 추가 사용이 배제됨을 시사하는 것으로 추정됩니다. 질문 Q-d9c097d736bae053 (열림)

실행 중인 작동 상태에서 FVContainer 인스턴스는 임시 수명을 가집니다. 즉, 필요에 따라 인스턴스화되고 벡터 및 비트 길이로 채워진 후 동기화 프로토콜 인스턴스로 전달됩니다. 반면에 TsyncFvmErrorDomain 오류 도메인 객체는 전체 프로세스 기간 동안 정적 수명을 가집니다. GetTsyncFvmErrorDomain() 함수는 전역 인스턴스 객체에 대한 참조를 반환합니다 [SWS_TS_14212]. GetTsyncFvmErrorDomain() 및 팩토리 함수 MakeErrorCode() 모두 constexpr 및 noexcept(으)로 선언되어 있으며, 예외 안전(exception-safe) 및 스레드 안전(thread-safe)으로 명시되어 있습니다 [SWS_TS_14212], [SWS_TS_14213]. 이를 통해 동기화 잠금 없이도 동시적 오류 생성 및 조회가 가능합니다.

사용 경로

시간 동기화와 연계된 전형적인 사용 경로는 최신성 값의 제공 및 평가를 포함합니다:

1. ara::tsync의 컴포넌트가 시간 메시지를 보호하기 위해 FVM 인터페이스를 통해 최신 Frischewert를 요청합니다.
2. 값 결정이 성공하면 FVM은(는) 값의 비트 길이와 바이트 벡터로 FVContainer의 인스턴스를 생성하거나 채운 후 이를 호출자에게 반환합니다.
3. 런타임에 Frischewert를 일시적으로 제공할 수 없는 경우, FVM은(는) 복구 가능한 오류 kFVNotAvailable을(를) 보고합니다 [SWS_TS_14202]. 이를 위해 MakeErrorCode()을(를) 통해 제조사별 추가 데이터를 포함하는 적절한 ara::core::ErrorCode 객체가 생성됩니다 [SWS_TS_14213].
4. 호출 컴포넌트는 결과를 평가하고 재시도 여부 또는 대체 조치를 결정합니다.

시퀀스 다이어그램: 최신성 값 조회 및 가능한 오류 상태 처리. 출처: [SWS_TS_14202], [SWS_TS_14213].

오류 시나리오

apext::tsync의 오류 처리는 ara::core::ErrorDomain 및 ara::core::ErrorCode의 아키텍처를 기반으로 합니다. TsyncFvmErrorDomain의 오류 코드는 TsyncFvmErrc 열거형에 나열되어 있으며, 이 열거형의 기본 유형은 ara::core::ErrorDomain::CodeType입니다 [SWS_TS_14202]:

• kFVNotAvailable (= 1): 현재 Freshness Value를 사용할 수 없음을 알리는 복구 가능한 오류(recoverable error)입니다 [SWS_TS_14202]. 호출자는 요청을 다시 보내거나 현재 처리 주기를 건너뛸 수 있습니다.
• kFVInitializeFailed (= 2): Freshness Value Manager를 초기화하거나 사용할 수 없었음을 나타내는 복구 불가능한 오류(unrecoverable error)입니다 [SWS_TS_14202]. 이는 종속된 시간 동기화 서비스의 중단으로 이어집니다.

구체적인 오류 객체의 생성은 열거자와 제조사별 추가 데이터를 전달받는 헬퍼 함수 MakeErrorCode(TsyncFvmErrc code, ara::core::ErrorDomain::SupportDataType data)을(를) 통해 수행됩니다 [SWS_TS_14213]. 선언은 apext/tsync/fvm_error_domain.h 헤더에 위치하며, 전방 선언은 apext/tsync/tsync_fwd.h을(를) 통해 참조할 수 있습니다 [SWS_TS_14202]. 예외 기반 오류 경로를 위해 해당 네임스페이스는 TsyncFvmException 클래스를 제공합니다. TsyncFvmException은(는) TsyncFvmErrorDomain의 오류가 ara::core::ErrorCode 대신 예외 컨텍스트에서 보고될 때 발생하는 것으로 추정됩니다. 질문 Q-a779e133b471f03d (열림)