Definiert Schnittstellen zur Frischewert-Verwaltung und Fehlerbehandlung für abgesicherte Kommunikationskanäle.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 05efd4a1afb9HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Definiert Schnittstellen zur Frischewert-Verwaltung und Fehlerbehandlung für abgesicherte Kommunikationskanäle.
Der Namespace definiert die herstellerspezifische Schnittstelle zur Verwaltung von Frischewerten im Rahmen von Secure Onboard Communication (SecOC) für das AUTOSAR Adaptive Platform Communication Management (SWS Communication Management §C.1 „Header: apext/com/secoc/fvm.h“). Die Lebensdauer und Initialisierung des Freshness Value Managers wird vollständig durch die Kommunikationsverwaltung gesteuert, welche Frischewerte bei konfigurierten Sendevorgängen über die Schnittstelle abfragt ([SWS_CM_11272]). Bei temporärer Nichtverfügbarkeit von Frischewerten erfolgen kontrollierte Wiederholversuche bis zu einem definierten Schwellwert, bevor fehlerhafte Nachrichten verworfen werden. Ergänzend stellt der Namespace eine eigene Fehlerdomäne und standardisierte Fehlercodes für Diagnose- und Ausnahmebehandlungen bereit.
Kontext
Der Namespace apext::com::secoc definiert normative Schnittstellen für Plattform-Erweiterungen (Platform Extension Interfaces) innerhalb des Funktionsclusters Communication Management (ara::com) der AUTOSAR Adaptive Platform (SWS Communication Management §C.1 „Header: apext/com/secoc/fvm.h“). Ziel dieser Erweiterungsschnittstellen ist es, OEMs und Stack-Herstellern die Bereitstellung eines maßgeschneiderten Freshness Value Managers (FVM) zu ermöglichen, welcher die zur Abwehr von Replay-Angriffen erforderlichen Frischewerte für Secure Onboard Communication (SecOC) generiert, verwaltet und verifiziert.
Der Namespace interagiert im Wesentlichen mit drei Rollen: der Kommunikationsverwaltung (ara::com), der standardisierten Schnittstellendefinition (FVM) samt Datenträgern wie FVContainer ([SWS_CM_11286], [SWS_CM_11344]) sowie der konkreten FVM-Implementierung des Fahrzeugherstellers oder Stack-Zulieferers. Interpretation: Es wird davon ausgegangen, dass die herstellerspezifische FVM-Bibliothek im Rahmen der Systemintegration als statische oder dynamische Bibliothek angebunden wird, da die Spezifikation die funktionale Schnittstelle festlegt, die Integrationsform jedoch stackspezifisch offenlässt. Frage Q-256aef3d6698cc3f (offen)
Das Lebenszyklusmanagement einer FVM-Realisierung wird vollständig durch die Kommunikationsverwaltung ara::com gesteuert ([SWS_CM_11272]). Anwendungen und Service-Instanzen erzeugen oder verwalten die FVM-Komponente nicht direkt.
Die Inbetriebnahme erfolgt deterministisch während der Initialisierung des Kommunikationsstapels durch den Aufruf der Bibliotheks-API apext::com::secoc::FVM::Initialize ([SWS_CM_11273]). Kann die Initialisierung herstellerseitig nicht ordnungsgemäß vollendet werden, signalisiert die FVM-Schicht diesen Fehlerzustand über den definierten Fehlercode kFVInitializeFailed ([SWS_CM_11342]). Nach erfolgreichem Initialisierungsaufruf verbleibt der Freshness Value Manager im aktiven Betriebszustand und beantwortet synchrone Anfragen zu Sende- und Empfangsfrischewerten.
Nutzungspfad
Der reguläre Nutzungspfad unterteilt sich in die Sendeabsicherung und die Empfangsverifikation von Nachrichten:
Sendenachrichten: Ist eine Nachricht für den SecOC-Versand konfiguriert, wird sie als authentische Nachricht behandelt ([SWS_CM_11274]). Die Absicherung erfolgt in einer festen Reihenfolge nach Abschluss aller E2E-Schutzberechnungen ([SWS_CM_11274]). Besitzt die Dienstschnittstellen-Konfiguration ein Attribut freshnessValueId, ruft die Kommunikationsverwaltung apext::com::secoc::FVM::GetTxFreshness auf ([SWS_CM_11274], [SWS_CM_11275]). Der Frischewert wird in einer FVContainer-Struktur bereitgestellt, welche die Bitlänge im Attribut length und den Wert selbst hält ([SWS_CM_11286], [SWS_CM_11344]).
Sende-Wiederholmechanismus: Für jede abgesicherte Nachricht führt das System einen Authentication Build Counter ([SWS_CM_11275]). Nach erfolgreicher Generierung wird der Zähler auf 0 zurückgesetzt. Liefert GetTxFreshness den behebbaren Fehler kFVNotAvailable oder misslingt die Authenticator-Berechnung, wird der Zähler inkrementiert und der Aufbau wiederholt ([SWS_CM_11275]). Erreicht der Zähler den Schwellwert SecOCAuthenticationBuildAttempts, wird die Nachricht verworfen ([SWS_CM_11275]).
Empfangsnachrichten: Bei eingehenden SecOC-Nachrichten mit aktiver Verifikation (Attribut securedRxVerification wahr oder ungesetzt) wird der Authenticator extrahiert und die Nachricht vor den E2E-Prüfungen durch Neuberechnung des MAC verifiziert ([SWS_CM_11276], SWS Communication Management §8.1 „SecOC secure channel reception“). Ist securedRxVerification hingegen auf falsch gesetzt, wird die Verifikation umgangen (Bypass) und die Nachricht unüberprüft verarbeitet ([SWS_CM_11372]).
Sequenzdiagramm: Aufruf- und Wiederholungsablauf bei der Absicherung einer Sendenachricht mittels FVM. Quellen: [SWS_CM_11274], [SWS_CM_11275].
Fehlerszenarien
Fehlersituationen innerhalb der FVM-Schnittstelle werden über die typsichere Fehlerdomäne ComSecOcFvmErrorDomain abgewickelt, deren Instanz über GetComSecOcFvmErrorDomain abgerufen werden kann ([SWS_CM_12521]). Die Fehlercodes sind im Enumerationstyp ComSecOcFvmErrc festgelegt ([SWS_CM_11342]):
kFVNotAvailable (Code 1): Der benötigte Frischewert ist temporär nicht verfügbar. Dies signalisiert dem Communication Management einen behebbaren Fehler, der Wiederholversuche gemäß Sendeprotokoll auslöst ([SWS_CM_11275], [SWS_CM_11342]).
kFVInitializeFailed (Code 2): Die Initialisierung des Freshness Value Managers schlug fehl ([SWS_CM_11342]).
Über die Hilfsfunktion MakeErrorCode ([SWS_CM_12522]) lassen sich Fehlercodes zusammen mit herstellerspezifischen Zusatzdaten (SupportDataType) in reguläre ara::core::ErrorCode-Objekte kapseln. Für fehlgeschlagene synchrone Aufrufe in ausnahmebasierten Umgebungen steht die Ausnahmeklasse ComSecOcFvmException bereit.
Dieser Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive Platform R25-11 (Communication Management). Alle Aussagen stützen sich ausschließlich auf die angegebenen Spezifikations- und Dokumentationsreferenzen.
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.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 8b6808ee1e7cHerkunftOffene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung
Die Nicht-Element-Funktion GetComSecOcFvmErrorDomain dient dem Abruf einer Referenz auf das Fehlerbereichs-Objekt des Freshness Value Managements (FVM) für SecOC gemäß [SWS_CM_12521]. Die Funktion ist im Namensraum apext::com::secoc definiert und über die Header-Datei apext/com/secoc/fvm_error_domain.h einzubinden (AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.1 „GetComSecOcFvmErrorDomain“). Sie nimmt keine Parameter entgegen und gibt synchron eine konstante Referenz vom Typ const ara::core::ErrorDomain & auf das Singleton-Objekt apext::com::secoc::ComSecOcFvmErrorDomain zurück.
Fehlerbehandlung
Die Funktion ist als noexcept deklariert und vollständig ausnahmesicher (exception safe) spezifiziert [SWS_CM_12521]. Beim Aufruf treten keine Laufzeitfehler auf, und es werden weder Exceptions geworfen noch Fehlercodes erzeugt. Der zurückgegebene Fehlerbereich dient Entwicklern vielmehr als Referenz, um FVM-spezifische Fehlercodes innerhalb der Fehlerbehandlung von SecOC eindeutig abzugleichen.
Nebenläufigkeit und Einschränkungen
Als zustandslose constexpr-Funktion ohne Seiteneffekte dürfte der Aufruf uneingeschränkt nebenläufig und reentrant sein. Frage Q-16d96e7f64bca93f (offen) Es bestehen gemäß Spezifikation keine Reihenfolgebedingungen oder Beschränkungen hinsichtlich des Aufrufkontextes [SWS_CM_12521].
Zusammenspiel
Die Definition basiert auf den Anforderungen RS_AP_00120 sowie RS_AP_00130 [SWS_CM_12521]. Während die Spezifikation primär den Namensraum apext::com::secoc vorsieht, findet sich an anderer Stelle auch die Angabe ara::com::secoc::GetComSecOcFvmErrorDomain (AUTOSAR_AP_SWS_CommunicationManagement S. 598); dies dürfte eine redaktionelle Variante im Rahmen der Adaptive-Erweiterungen darstellen. Frage Q-b49307e7cc69a94b (offen)
Dieser Nutzungshinweis wurde von einer KI erstellt und basiert auf dem Spezifikationsstand AUTOSAR Adaptive R25-11.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c91e64600342HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung
Die Funktion apext::com::secoc::MakeErrorCode dient der Erzeugung einer Instanz von ara::core::ErrorCode für den Fehlerbereich des Freshness Value Managements (SecOC) gemäß [SWS_CM_12522] (AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.2 „MakeErrorCode“). Der Aufruf erfolgt synchron. Als Parameter erfordert die Funktion einen Fehlercode errorCode vom Typ apext::com::secoc::ComSecOcFvmErrc sowie herstellerspezifische Zusatzdaten data vom Typ ara::core::ErrorDomain::SupportDataType[SWS_CM_12522]. Sie gibt das vollständig initialisierte ara::core::ErrorCode-Objekt zurück [SWS_CM_12522].
Fehlerbehandlung und Nebenläufigkeit
Die Funktion ist als noexcept und exception safe spezifiziert, sodass der Aufruf garantiert keine Exceptions auslöst [SWS_CM_12522]. Spezifische Laufzeitfehlermeldungen wie DET oder DEM sind für diese Konstruktionsfunktion nicht definiert [SWS_CM_12522]. Aufgrund der constexpr-Qualifizierung dürfte die Erzeugung des Fehlercodes bei der Übergabe konstanter Ausdrücke vermutlich bereits zur Übersetzungszeit durchführbar sein. Frage Q-a96337508ba6ecdd (offen)
Zusammenspiel
Die Funktion wird über den Header apext/com/secoc/fvm_error_domain.h im Namensraum apext::com::secoc bereitgestellt [SWS_CM_12522]. Sie entspricht im Aufbau verwandten Fehlercode-Fabriken des Kommunikationsmanagements:
gemini-3.8-flash-medium· 2026-10-13