DEENESPTFRRUARHIKOZHNL

네임스페이스 apext::com::secoc

사용자 가이드AI 생성

보안 통신 채널을 위한 신선도 값 관리 및 오류 처리 인터페이스를 정의합니다.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 05efd4a1afb9 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

보안 통신 채널을 위한 신선도 값 관리 및 오류 처리 인터페이스를 정의합니다.

이 네임스페이스는 AUTOSAR Adaptive Platform Communication Management(SWS Communication Management §C.1 “Header: apext/com/secoc/fvm.h”)를 위한 Secure Onboard Communication(SecOC) 프레임워크 내에서 신선도 값을 관리하기 위한 공급업체별 인터페이스를 정의합니다. Freshness Value Manager의 수명 주기 및 초기화는 구성된 전송 작업 중에 인터페이스를 통해 신선도 값을 쿼리하는 통신 관리에 의해 완전히 제어됩니다([SWS_CM_11272]). 신선도 값이 일시적으로 사용 불가능한 경우, 결함이 있는 메시지가 폐기되기 전에 정의된 임계값까지 제어된 재시도가 수행됩니다. 또한 네임스페이스는 진단 및 예외 처리를 위한 자체 오류 도메인과 표준화된 오류 코드를 제공합니다.

컨텍스트

네임스페이스 apext::com::secoc은 AUTOSAR Adaptive Platform(SWS Communication Management §C.1 “Header: apext/com/secoc/fvm.h”)의 Communication Management(ara::com) 기능 클러스터 내에서 플랫폼 확장 인터페이스(Platform Extension Interfaces)에 대한 규범적 인터페이스를 정의합니다. 이러한 확장 인터페이스의 목표는 OEM 및 스택 공급업체가 Secure Onboard Communication(SecOC)에 필요한 재생 공격 방지용 신선도 값을 생성, 관리 및 검증하는 맞춤형 Freshness Value Manager(FVM)를 제공할 수 있도록 하는 것입니다.

이 네임스페이스는 기본적으로 세 가지 역할과 상호작용합니다: 통신 관리(ara::com), FVContainer([SWS_CM_11286], [SWS_CM_11344])와 같은 데이터 캐리어를 포함한 표준화된 인터페이스 정의(FVM), 그리고 차량 제조업체 또는 스택 공급업체의 구체적인 FVM 구현입니다. Interpretation: 사양에는 기능적 인터페이스가 명시되어 있지만 통합 형태는 스택별로 개방되어 있으므로, 공급업체별 FVM 라이브러리는 시스템 통합의 일환으로 정적 또는 동적 라이브러리로 연결된다고 가정합니다. 질문 Q-256aef3d6698cc3f (열림)

SecOcKontext AraCom Communication Management (ara::com) SecOcExt Platform Extension Interface (apext::com::secoc) AraCom->SecOcExt verwaltet Lebenszyklus ruft FVM::Initialize AraCom->SecOcExt fragt Frische ab (FVM::GetTxFreshness) FvmImpl OEM / Stack-Vendor FVM-Implementierung FvmImpl->SecOcExt implementiert FVM-Interface

컨텍스트 다이어그램: Communication Management와 공급업체별 FVM 구현 간의 apext::com::secoc 네임스페이스 통합. 출처: [SWS_CM_11272], SWS Communication Management §C.1 “Header: apext/com/secoc/fvm.h”.

수명 주기

FVM 구현의 수명 주기 관리는 통신 관리 ara::com에 의해 완전히 제어됩니다([SWS_CM_11272]). 애플리케이션 및 서비스 인스턴스는 FVM 컴포넌트를 직접 생성하거나 관리하지 않습니다.

시운전은 라이브러리 API apext::com::secoc::FVM::Initialize을 호출하여 통신 스택 초기화 중에 결정론적으로 수행됩니다([SWS_CM_11273]). 공급업체 측에서 초기화가 올바르게 완료될 수 없는 경우, FVM 계층은 정의된 오류 코드 kFVInitializeFailed를 통해 이 오류 상태를 알립니다([SWS_CM_11342]). 성공적인 초기화 호출 후 Freshness Value Manager는 활성 작동 상태를 유지하며 송신 및 수신 신선도 값에 대한 동기 요청에 응답합니다.

사용 경로

일반적인 사용 경로는 메시지의 송신 보안과 수신 검증으로 나뉩니다:

  • 송신 메시지: 메시지가 SecOC 전송용으로 구성된 경우 신뢰할 수 있는 메시지로 처리됩니다([SWS_CM_11274]). 보안 적용은 모든 E2E 보호 계산이 완료된 후 고정된 순서로 수행됩니다([SWS_CM_11274]). 서비스 인터페이스 구성에 속성 freshnessValueId가 있는 경우 통신 관리는 apext::com::secoc::FVM::GetTxFreshness을 호출합니다([SWS_CM_11274], [SWS_CM_11275]). 신선도 값은 속성 length에 비트 길이를 보유하고 값 자체를 보유하는 FVContainer 구조체로 제공됩니다([SWS_CM_11286], [SWS_CM_11344]).
  • 송신 재시도 메커니즘: 보안이 적용된 각 메시지에 대해 시스템은 Authentication Build Counter을 유지합니다([SWS_CM_11275]). 성공적으로 생성된 후 카운터는 0으로 재설정됩니다. GetTxFreshness가 복구 가능한 오류 kFVNotAvailable을 반환하거나 Authenticator 계산이 실패하면 카운터가 증가하고 생성이 재시도됩니다([SWS_CM_11275]). 카운터가 임계값 SecOCAuthenticationBuildAttempts에 도달하면 메시지가 폐기됩니다([SWS_CM_11275]).
  • 수신 메시지: 활성 검증(속성 securedRxVerification이 참이거나 설정되지 않음)이 있는 인바운드 SecOC 메시지의 경우 Authenticator가 추출되고 E2E 검사 전에 MAC 재계산을 통해 메시지가 검증됩니다([SWS_CM_11276], SWS Communication Management §8.1 “SecOC secure channel reception”). 반면 securedRxVerification이 거짓으로 설정된 경우 검증이 우회(Bypass)되고 메시지가 검사 없이 처리됩니다([SWS_CM_11372]).
송신 시 메시지 보호 절차Communication Management (ara::com)FVM (apext::com::secoc)Use Case: E2E 보호 및 준비E2E 계산 완료Authentic Message bereitstellenUse Case: Frischewert-AbfrageGetTxFreshness(freshnessValueId, ...)altErfolg신선도 값을 포함한 FVContainer 반환Authenticator berechnenSecOC-Nachricht versendenAuthentication Build Counter = 0kFVNotAvailableFehler kFVNotAvailable meldenAuthentication Build Counter inkrementierenWiederholversuch bis Schwellwert

시퀀스 다이어그램: FVM을 사용한 송신 메시지 보안 적용 시 호출 및 재시도 흐름. 출처: [SWS_CM_11274], [SWS_CM_11275].

오류 시나리오

FVM 인터페이스 내의 오류 상황은 타입 안전 오류 도메인 ComSecOcFvmErrorDomain을 통해 처리되며, 해당 인스턴스는 GetComSecOcFvmErrorDomain을 통해 조회할 수 있습니다([SWS_CM_12521]). 오류 코드는 열거형 ComSecOcFvmErrc에 정의되어 있습니다([SWS_CM_11342]):

  • kFVNotAvailable(코드 1): 필요한 신선도 값을 일시적으로 사용할 수 없습니다. 이는 Communication Management에 복구 가능한 오류임을 알리고, 전송 프로토콜에 따라 재시도를 트리거합니다([SWS_CM_11275], [SWS_CM_11342]).
  • kFVInitializeFailed(코드 2): Freshness Value Manager 초기화에 실패했습니다([SWS_CM_11342]).

도우미 함수 MakeErrorCode([SWS_CM_12522])을 통해 오류 코드를 공급업체별 추가 데이터(SupportDataType)와 함께 일반 ara::core::ErrorCode 객체로 캡슐화할 수 있습니다. 예외 기반 환경에서 실패한 동기 호출을 위해 예외 클래스 ComSecOcFvmException가 제공됩니다.

이 가이드는 AUTOSAR Adaptive Platform R25-11(Communication Management) 사양을 기반으로 합니다. 모든 진술은 명시된 사양 및 문서 참조만을 근거로 합니다.

주제 맵

클래스 다이어그램

Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.

G cluster_ns apext::com::secoc napext__com__secoc__ComSecOcFvmErrorDomain ComSecOcFvmErrorDomain next_ara__core__ErrorDomain ara::core::ErrorDomain napext__com__secoc__ComSecOcFvmErrorDomain->next_ara__core__ErrorDomain napext__com__secoc__ComSecOcFvmException ComSecOcFvmException next_ara__core__Exception ara::core::Exception napext__com__secoc__ComSecOcFvmException->next_ara__core__Exception napext__com__secoc__FVContainer «struct» FVContainer napext__com__secoc__FVM FVM

상세 보기

개요에서 항목을 선택하세요.

클래스

Defines a class representing the SecOc Freshness Value Manager error domain

상속 대상 ara::core::ErrorDomain

Defines a class for exceptions to be thrown by the SecOc Freshness Value Manager

상속 대상 ara::core::Exception

FVContainer 클래스

A container to hold the length of freshness value in bits and the freshness value itself

FVM 클래스

A freshness value management interface to be implemented by the OEM/stack vendor

함수

Returns a reference to the apext::com::secoc::ComSecOcFvmErrorDomain object

constexpr const ara::core::ErrorDomain & GetComSecOcFvmErrorDomain () noexcept;

Creates an instance of ara::core::ErrorCode

constexpr ara::core::ErrorCode MakeErrorCode (apext::com::secoc::Com SecOcFvmErrc errorCode, ara::core::ErrorDomain::SupportDataType data) noexcept;

타입 및 상수

ComSecOcFvmErrc 열거형

Defines the error codes for the apext::com::secoc::ComSecOcFvmErrorDomain

enum class ComSecOcFvmErrc : ara::core::ErrorDomain::CodeType {...};

열거형

열거형 ComSecOcFvmErrc [SWS_CM_11342] Upstream: RS_AP_00130

enum class ComSecOcFvmErrc :          ara::core::ErrorDomain::CodeType {...};

Defines the error codes for the apext::com::secoc::ComSecOcFvmErrorDomain

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Forwarding-Header#include "apext/com/com_fwd.h"
Scopenamespace apext::com::secoc
SymbolComSecOcFvmErrc
Basistypara::core::ErrorDomain::CodeType

Werte

EnumeratorBeschreibung
kFVNotAvailable=1 Freshness Value not available
kFVInitializeFailed=2 Initialization of Freshness Value Manager failed

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11342
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11342@rel:R25-11#53c5acc7
Content hash
53c5acc7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11342
Status: valid/unmigrated Version: rel:R25-11#7146e1f4 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11342@rel:R25-11#7146e1f4
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#50596d252026-09-30
  • R20-11rel:R20-11#9e1f02d92026-10-14
  • R21-11rel:R21-11#9e1f02d92026-10-14
  • R22-11rel:R22-11#e70607272026-10-14
  • R23-11rel:R23-11#0578ae272026-10-14
  • R24-11rel:R24-11#0c1f38782026-10-14
  • R25-11rel:R25-11#7146e1f42026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

자유 함수 문서

함수 GetComSecOcFvmErrorDomain [SWS_CM_12521] Upstream: RS_AP_00120, RS_AP_00130

constexpr const ara::core::ErrorDomain & GetComSecOcFvmErrorDomain () noexcept;

Returns a reference to the apext::com::secoc::ComSecOcFvmErrorDomain object

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 8b6808ee1e7c 출처 열린 질문 (2)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

비멤버 함수 GetComSecOcFvmErrorDomain은(는) [SWS_CM_12521]에 따라 SecOC용 Freshness Value Management(FVM)의 오류 도메인 객체에 대한 참조를 가져오는 데 사용됩니다. 이 함수는 네임스페이스 apext::com::secoc에 정의되어 있으며 헤더 파일 apext/com/secoc/fvm_error_domain.h을(를) 통해 포함해야 합니다(AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.1 “GetComSecOcFvmErrorDomain”). 매개변수를 받지 않으며 싱글톤 객체 apext::com::secoc::ComSecOcFvmErrorDomain에 대한 const ara::core::ErrorDomain & 타입의 상수 참조를 동기식으로 반환합니다.

오류 처리

이 함수는 noexcept(으)로 선언되어 있으며 완전한 예외 안전(exception safe)으로 명세되어 있습니다 [SWS_CM_12521]. 호출 시 런타임 오류가 발생하지 않으며 예외가 발생하거나 오류 코드가 생성되지 않습니다. 반환된 오류 영역은 오히려 개발자가 SecOC의 오류 처리 내에서 FVM 관련 오류 코드를 고유하게 대조하기 위한 참조 역할을 합니다.

동시성 및 제약사항

부수 효과가 없는 상태 비저장(stateless) constexpr 함수로서, 호출은 제한 없이 동시적이고 재진입 가능할 것으로 보입니다. 질문 Q-16d96e7f64bca93f (열림) 명세에 따른 순서 조건이나 호출 컨텍스트에 관한 제한은 없습니다 [SWS_CM_12521].

상호 작용

이 정의는 요구사항 RS_AP_00120 및 RS_AP_00130을 기반으로 합니다 [SWS_CM_12521]. 명세에서는 주로 apext::com::secoc 네임스페이스를 규정하고 있으나, 다른 위치에서는 ara::com::secoc::GetComSecOcFvmErrorDomain라는 명시도 발견되며(AUTOSAR_AP_SWS_CommunicationManagement 598쪽), 이는 Adaptive 확장의 틀 내에서 편집상의 변형일 것으로 보입니다. 질문 Q-b49307e7cc69a94b (열림)

이 사용 지침은 AI에 의해 작성되었으며 AUTOSAR Adaptive R25-11 명세 버전을 기반으로 합니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopenamespace apext::com::secoc
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
const ara::core::ErrorDomain &Reference to the apext::com::secoc:: ComSecOcFvmErrorDomain object

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_12521
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12521@rel:R25-11#73f01d58
Content hash
73f01d58
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12521
Status: valid/unmigrated Version: rel:R25-11#8e770345 Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_12521@rel:R25-11#8e770345
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#61e04edc2026-09-30
  • R22-11rel:R22-11#149eb8902026-10-14
  • R23-11rel:R23-11#2dfcc3f12026-10-14
  • R24-11rel:R24-11#40d4bc762026-10-14
  • R25-11rel:R25-11#8e7703452026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

함수 MakeErrorCode [SWS_CM_12522] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

constexpr ara::core::ErrorCode MakeErrorCode (apext::com::secoc::Com SecOcFvmErrc errorCode, ara::core::ErrorDomain::SupportDataType data) noexcept;

Creates an instance of ara::core::ErrorCode

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: c91e64600342 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

함수 apext::com::secoc::MakeErrorCode은 [SWS_CM_12522](AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.2 “MakeErrorCode”)에 따라 Freshness Value Management(SecOC)의 오류 도메인에 대한 ara::core::ErrorCode의 인스턴스를 생성하는 역할을 합니다. 호출은 동기식으로 수행됩니다. 매개변수로 이 함수는 apext::com::secoc::ComSecOcFvmErrc 타입의 오류 코드 errorCode 및 ara::core::ErrorDomain::SupportDataType 타입의 제조사별 추가 데이터 data을 필요로 합니다 [SWS_CM_12522]. 완전히 초기화된 ara::core::ErrorCode 객체를 반환합니다 [SWS_CM_12522].

오류 처리 및 동시성

이 함수는 noexcept 및 exception safe로 지정되어 있으므로, 호출 시 예외를 발생시키지 않음이 보장됩니다 [SWS_CM_12522]. 이 생성 함수에 대해 DET 또는 DEM과 같은 특정 런타임 오류 메시지는 정의되어 있지 않습니다 [SWS_CM_12522]. constexpr 한정자로 인해 상수 표현식 전달 시 오류 코드 생성이 아마도 이미 컴파일 시점에 수행 가능할 것으로 보입니다. 질문 Q-a96337508ba6ecdd (열림)

상호 작용

이 함수는 헤더 apext/com/secoc/fvm_error_domain.h을 통해 네임스페이스 apext::com::secoc에서 제공됩니다 [SWS_CM_12522]. 이 함수는 구조상 통신 관리의 관련 오류 코드 팩토리와 일치합니다:

AUTOSAR 사양 R25-11을 바탕으로 자동 생성된 사용 지침.

구현자 가이드 준비 중 (복잡도 I2)

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopenamespace apext::com::secoc
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
errorCodeError code number.
dataVendor defined data associated with the error

Rückgabewert

TypBeschreibung
ara::core::ErrorCodeAn ara::core::ErrorCode object.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_12522
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12522@rel:R25-11#0c4d9d07
Content hash
0c4d9d07
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12522
Status: valid/unmigrated Version: rel:R25-11#12f48f61 Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_12522@rel:R25-11#12f48f61
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#208bfd1b2026-09-30
  • R22-11rel:R22-11#fd00e04d2026-10-14
  • R23-11rel:R23-11#5a8150df2026-10-14
  • R24-11rel:R24-11#2565df5c2026-10-14
  • R25-11rel:R25-11#12f48f612026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill