namespace apext::com::secoc

De namespace definieert de fabrikantspecifieke interface voor het beheer van versheidswaarden in het kader van Secure Onboard Communication (SecOC) voor AUTOSAR Adaptive Platform Communication Management (SWS Communication Management §C.1 “Header: apext/com/secoc/fvm.h”). De levensduur en initialisatie van de Freshness Value Manager wordt volledig gestuurd door het communicatiebeheer, dat versheidswaarden bij geconfigureerde verzendprocessen via de interface opvraagt ([SWS_CM_11272]). Bij tijdelijke niet-beschikbaarheid van versheidswaarden vinden gecontroleerde herhaalpogingen plaats tot aan een gedefinieerde drempelwaarde, voordat foutieve berichten worden verworpen. Aanvullend stelt de namespace een eigen foutdomein en gestandaardiseerde foutcodes voor diagnose- en uitzonderingsafhandeling beschikbaar.

meer ›

Context

De namespace apext::com::secoc definieert normatieve interfaces voor platformuitbreidingen (Platform Extension Interfaces) binnen het functiecluster Communication Management (ara::com) van het AUTOSAR Adaptive Platform (SWS Communication Management §C.1 “Header: apext/com/secoc/fvm.h”). Het doel van deze uitbreidingsinterfaces is om OEM's en stackfabrikanten in staat te stellen een op maat gemaakte Freshness Value Manager (FVM) aan te bieden, die de voor de afweer van replay-aanvallen vereiste versheidswaarden voor Secure Onboard Communication (SecOC) genereert, beheert en verifieert.

De namespace interacteert in wezen met drie rollen: het communicatiebeheer (ara::com), de gestandaardiseerde interfacedefinitie (FVM) inclusief gegevensdragers zoals FVContainer ([SWS_CM_11286], [SWS_CM_11344]) en de concrete FVM-implementatie van de voertuigfabrikant of stackleverancier. Interpretatie: er wordt van uitgegaan dat de fabrikantspecifieke FVM-bibliotheek in het kader van de systeemintegratie als statische of dynamische bibliotheek wordt gekoppeld, aangezien de specificatie de functionele interface vastlegt, maar de integratievorm stackspecifiek openlaat. Vraag Q-256aef3d6698cc3f (open)

Contextdiagram: integratie van de namespace apext::com::secoc tussen Communication Management en de fabrikantspecifieke FVM-implementatie. Bronnen: [SWS_CM_11272], SWS Communication Management §C.1 “Header: apext/com/secoc/fvm.h”.

Levenscyclus

Het levenscyclusbeheer van een FVM-realisatie wordt volledig gestuurd door het communicatiebeheer ara::com ([SWS_CM_11272]). Applicaties en service-instanties creëren of beheren de FVM-component niet rechtstreeks.

De inbedrijfstelling vindt deterministisch plaats tijdens de initialisatie van de communicatiestack door het aanroepen van de bibliotheek-API apext::com::secoc::FVM::Initialize ([SWS_CM_11273]). Indien de initialisatie aan fabrikantzijde niet correct kan worden voltooid, signaleert de FVM-laag deze fouttoestand via de gedefinieerde foutcode kFVInitializeFailed ([SWS_CM_11342]). Na een succesvolle initialisatie-aanroep blijft de Freshness Value Manager in actieve bedrijfstoestand en beantwoordt synchrone verzoeken om verzend- en ontvangstversheidswaarden.

Gebruikspad

Het reguliere gebruikspad is onderverdeeld in de verzendbeveiliging en de ontvangstverificatie van berichten:

• Verzendberichten: als een bericht is geconfigureerd voor SecOC-verzending, wordt het als een authentiek bericht behandeld ([SWS_CM_11274]). De beveiliging vindt plaats in een vaste volgorde na voltooiing van alle E2E-beveiligingsberekeningen ([SWS_CM_11274]). Als de serviceschnittstellen-configuratie een attribuut freshnessValueId heeft, roept het communicatiebeheer apext::com::secoc::FVM::GetTxFreshness aan ([SWS_CM_11274], [SWS_CM_11275]). De versheidswaarde wordt ter beschikking gesteld in een FVContainer-structuur, die de bitlengte in het attribuut length en de waarde zelf bevat ([SWS_CM_11286], [SWS_CM_11344]).
• Verzend-herhaalmechanisme: voor elk beveiligd bericht houdt het systeem een Authentication Build Counter bij ([SWS_CM_11275]). Na succesvolle generatie wordt de teller op 0 gereset. Levert GetTxFreshness de herstelbare fout kFVNotAvailable op of mislukt de berekening van de authenticator, dan wordt de teller verhoogd en de opbouw herhaald ([SWS_CM_11275]). Bereikt de teller de drempelwaarde SecOCAuthenticationBuildAttempts, dan wordt het bericht verworpen ([SWS_CM_11275]).
• Ontvangstberichten: bij binnenkomende SecOC-berichten met actieve verificatie (attribuut securedRxVerification waar of niet ingesteld) wordt de authenticator geëxtraheerd en het bericht vóór de E2E-controles geverifieerd door herberekening van de MAC ([SWS_CM_11276], SWS Communication Management §8.1 “SecOC secure channel reception”). Is securedRxVerification daarentegen op onwaar ingesteld, dan wordt de verificatie omzeild (bypass) en het bericht ongecontroleerd verwerkt ([SWS_CM_11372]).

Sequentiediagram: aanroep- en herhalingsverloop bij het beveiligen van een verzendbericht via FVM. Bronnen: [SWS_CM_11274], [SWS_CM_11275].

Foutscenario's

Foutsituaties binnen de FVM-interface worden afgehandeld via het typeveilige foutdomein ComSecOcFvmErrorDomain, waarvan de instantie kan worden opgevraagd via GetComSecOcFvmErrorDomain ([SWS_CM_12521]). De foutcodes zijn vastgelegd in het enumeratietype ComSecOcFvmErrc ([SWS_CM_11342]):

• kFVNotAvailable (code 1): de benodigde versheidswaarde is tijdelijk niet beschikbaar. Dit signaleert een herstelbare fout aan Communication Management, wat herhaalpogingen volgens het verzendprotocol triggert ([SWS_CM_11275], [SWS_CM_11342]).
• kFVInitializeFailed (code 2): de initialisatie van de Freshness Value Manager is mislukt ([SWS_CM_11342]).

Via de hulpfunctie MakeErrorCode ([SWS_CM_12522]) kunnen foutcodes samen met fabrikantspecifieke aanvullende gegevens (SupportDataType) worden ingekapseld in reguliere ara::core::ErrorCode-objecten. Voor mislukte synchrone aanroepen in op excepties gebaseerde omgevingen staat de exceptieklasse ComSecOcFvmException ter beschikking.