namespace apext::com::secoc

Le namespace définit l'interface spécifique au constructeur pour la gestion des valeurs de fraîcheur dans le cadre de Secure Onboard Communication (SecOC) pour le Communication Management de l'AUTOSAR Adaptive Platform (SWS Communication Management §C.1 « Header: apext/com/secoc/fvm.h »). Le cycle de vie et l'initialisation du Freshness Value Manager sont entièrement pilotés par la gestion de la communication, qui interroge les valeurs de fraîcheur via l'interface lors des opérations d'émission configurées ([SWS_CM_11272]). En cas d'indisponibilité temporaire des valeurs de fraîcheur, des tentatives de répétition contrôlées sont effectuées jusqu'à un seuil défini avant que les messages défaillants ne soient rejetés. En complément, le namespace fournit son propre domaine d'erreurs ainsi que des codes d'erreur standardisés pour le diagnostic et le traitement des exceptions.

plus ›

Contexte

Le namespace apext::com::secoc définit des interfaces normatives pour les extensions de plateforme (Platform Extension Interfaces) au sein du cluster fonctionnel Communication Management (ara::com) de l'AUTOSAR Adaptive Platform (SWS Communication Management §C.1 « Header: apext/com/secoc/fvm.h »). L'objectif de ces interfaces d'extension est de permettre aux constructeurs automobiles (OEM) et aux fournisseurs de piles de mettre à disposition un Freshness Value Manager (FVM) sur mesure, qui génère, gère et vérifie les valeurs de fraîcheur requises pour Secure Onboard Communication (SecOC) afin de contrer les attaques par rejeu.

Le namespace interagit pour l'essentiel avec trois rôles : la gestion de la communication (ara::com), la définition d'interface standardisée (FVM) avec ses conteneurs de données tels que FVContainer ([SWS_CM_11286], [SWS_CM_11344]), ainsi que l'implémentation concrète du FVM par le constructeur automobile ou le fournisseur de pile. Interprétation : il est supposé que la bibliothèque FVM spécifique au constructeur est intégrée sous la forme d'une bibliothèque statique ou dynamique dans le cadre de l'intégration système, étant donné que la spécification fixe l'interface fonctionnelle mais laisse ouverte la forme d'intégration propre à la pile. Question Q-256aef3d6698cc3f (ouverte)

Diagramme de contexte : intégration du namespace apext::com::secoc entre le Communication Management et l'implémentation FVM spécifique au constructeur. Sources : [SWS_CM_11272], SWS Communication Management §C.1 « Header: apext/com/secoc/fvm.h ».

Cycle de vie

La gestion du cycle de vie d'une réalisation du FVM est entièrement pilotée par la gestion de la communication ara::com ([SWS_CM_11272]). Les applications et les instances de service ne créent ni ne gèrent directement le composant FVM.

La mise en service s'effectue de manière déterministe pendant l'initialisation de la pile de communication par l'appel de l'API de bibliothèque apext::com::secoc::FVM::Initialize ([SWS_CM_11273]). Si l'initialisation ne peut pas être achevée correctement du côté du constructeur, la couche FVM signale cet état d'erreur via le code d'erreur défini kFVInitializeFailed ([SWS_CM_11342]). Après un appel d'initialisation réussi, le Freshness Value Manager reste dans l'état de fonctionnement actif et répond aux requêtes synchrones portant sur les valeurs de fraîcheur d'émission et de réception.

Parcours d'utilisation

Le chemin d'utilisation régulier se divise en sécurisation à l'émission et en vérification à la réception des messages :

• Messages d'émission : si un message est configuré pour l'envoi SecOC, il est traité comme un message authentique ([SWS_CM_11274]). La sécurisation s'effectue selon un ordre fixe après l'achèvement de tous les calculs de protection E2E ([SWS_CM_11274]). Si la configuration de l'interface de service possède un attribut freshnessValueId, la gestion de la communication appelle apext::com::secoc::FVM::GetTxFreshness ([SWS_CM_11274], [SWS_CM_11275]). La valeur de fraîcheur est fournie dans une structure FVContainer qui conserve la longueur en bits dans l'attribut length ainsi que la valeur elle-même ([SWS_CM_11286], [SWS_CM_11344]).
• Mécanisme de répétition à l'émission : pour chaque message sécurisé, le système gère un Authentication Build Counter ([SWS_CM_11275]). Après une génération réussie, le compteur est réinitialisé à 0. Si GetTxFreshness renvoie l'erreur récupérable kFVNotAvailable ou si le calcul de l'authentificateur échoue, le compteur est incrémenté et la construction est répétée ([SWS_CM_11275]). Si le compteur atteint le seuil SecOCAuthenticationBuildAttempts, le message est rejeté ([SWS_CM_11275]).
• Messages de réception : pour les messages SecOC entrants avec vérification active (attribut securedRxVerification vrai ou non défini), l'authentificateur est extrait et le message est vérifié avant les contrôles E2E par recalcul du MAC ([SWS_CM_11276], SWS Communication Management §8.1 « SecOC secure channel reception »). En revanche, si securedRxVerification est défini à faux, la vérification est contournée (bypass) et le message est traité sans vérification ([SWS_CM_11372]).

Diagramme de séquence : déroulement d'appel et de répétition lors de la sécurisation d'un message d'émission au moyen du FVM. Sources : [SWS_CM_11274], [SWS_CM_11275].

Scénarios d'erreur

Les situations d'erreur au sein de l'interface FVM sont traitées via le domaine d'erreurs à sûreté de typage ComSecOcFvmErrorDomain, dont l'instance peut être obtenue via GetComSecOcFvmErrorDomain ([SWS_CM_12521]). Les codes d'erreur sont définis dans le type énuméré ComSecOcFvmErrc ([SWS_CM_11342]) :

• kFVNotAvailable (code 1) : la valeur de fraîcheur requise est temporairement indisponible. Cela signale au Communication Management une erreur récupérable qui déclenche des tentatives de répétition conformément au protocole d'émission ([SWS_CM_11275], [SWS_CM_11342]).
• kFVInitializeFailed (code 2) : l'initialisation du Freshness Value Manager a échoué ([SWS_CM_11342]).

La fonction utilitaire MakeErrorCode ([SWS_CM_12522]) permet d'encapsuler les codes d'erreur avec des données supplémentaires spécifiques au constructeur (SupportDataType) dans des objets ara::core::ErrorCode réguliers. Pour les appels synchrones défaillants dans des environnements basés sur les exceptions, la classe d'exception ComSecOcFvmException est disponible.