classe ara::diag::ExternalAuthentication

Le constructeur explicite [SWS_DM_01193] initialise une instance de la classe de port ara::diag::ExternalAuthentication [SWS_DM_01191] pour l'authentification de clients de diagnostic externes (SWS Diagnostics §8.17 « Header: ara/diag/external_authentication.h »). Comme paramètre, la fonction attend un ara::core::InstanceSpecifier, qui doit référencer un PortPrototype modélisé dans le manifeste d'une instance de service DiagnosticExternalAuthenticationInterface [SWS_DM_01193].

L'appel synchrone est déclaré comme noexcept et spécifié à la fois thread-safe et exception-safe [SWS_DM_01193]. Comme aucune exception n'est levée, les erreurs de modélisation et de configuration entraînent des violations définies du framework [SWS_DM_01193] :

• InstanceSpecifierMappingIntegrityViolation : l'identifiant ne peut pas être résolu dans le contexte de l'exécutable ou référence un élément de modèle autre qu'un PortPrototype.
• PortInterfaceMappingViolation : le PortPrototype référencé n'est pas typé par un DiagnosticExternalAuthenticationInterface.
• ProcessMappingViolation : aucun processus d'exécution modélisé correspondant n'existe pour la référence.
• InstanceSpecifierAlreadyInUseViolation : l'identifiant est déjà utilisé par une autre instance dans le processus en cours d'exécution.

Les opérations de copie sont explicitement interdites pour ExternalAuthentication [SWS_DM_01196] [SWS_DM_01197], tandis que les opérations de déplacement sont prises en charge [SWS_DM_01194] [SWS_DM_01195]. Contrairement au constructeur, le destructeur associé n'est pas thread-safe [SWS_DM_01198]. Après une instanciation réussie, l'objet sert à interroger les instances d'authentification client associées via des méthodes telles que Get ou GetAll [SWS_DM_01201] [SWS_DM_01202].

La méthode synchrone ara::diag::ExternalAuthentication::Get permet à une application adaptative de récupérer l'instance de ara::diag::ClientAuthentication responsable d'une requête de diagnostic [SWS_DM_01199]. Une référence vers metaInfo (const ara::diag::MetaInfo&), qui fournit des métadonnées issues du contexte de la requête de diagnostic, est transmise comme paramètre SWS Diagnostics §7.3.1.1 « MetaInfo class ». La valeur de retour de type ara::core::Result<ClientAuthentication> encapsule l'objet d'authentification correspondant pour gérer l'état d'authentification du client [SWS_DM_01202].

Si une erreur survient, le Result renvoyé contient le code d'erreur spécifique DiagErrc::kServiceNotAvailable [SWS_DM_01199]. Celui-ci signale, avec une sémantique de rollback, que l'appel ne peut pas être exécuté parce que des fonctions essentielles du Diagnostic Manager (DM) ne sont pas disponibles au moment de l'appel [SWS_DM_01199].

Concernant la concurrence, la fonction est spécifiée comme thread-safe ainsi qu'exception safe et déclarée avec noexcept [SWS_DM_01199]. Elle peut donc être appelée de manière sûre depuis des threads parallèles sans mécanismes de verrouillage côté application.

La méthode interagit avec la variante surchargée Get(Address sourceAddress) [SWS_DM_01200], qui permet la même récupération directement via l'adresse source du client [SWS_DM_01202]. Le nombre d'instances disponibles est déterminé par les éléments de modèle DiagnosticExternalAuthenticationIdentification SWS Diagnostics « Get ClientAuthentication Instance ». Interprétation : la fonction devrait déterminer en interne l'adresse source nécessaire à l'affectation à partir des données de transport encapsulées dans metaInfo. Question Q-50d416201ccb5825 (ouverte)

La méthode synchrone Get de la classe ara::diag::ExternalAuthentication permet à une application adaptative de récupérer l'instance de ClientAuthentication qui gère l'état d'authentification du client de diagnostic pour l'adresse source indiquée [SWS_DM_01200]. Le Diagnostic Manager résout ici l'objet d'authentification compétent via l'adresse source transmise [SWS_DM_01202].

L'utilisation et les conditions aux limites comprennent les aspects suivants :

• Appel et paramètres : sourceAddress de type Address est transmis comme paramètre [SWS_DM_01200]. La résolution s'appuie dans le modèle de système sur des éléments configurés de DiagnosticExternalAuthenticationIdentification qui définissent des adresses sources fixes ou des plages d'adresses SWS Diagnostics p. 129 « ClientAuthentication ». De plus, il existe une surcharge de Get qui détermine l'instance via un objet MetaInfo [SWS_DM_01199], [SWS_DM_01202].
• Valeur de retour et gestion des erreurs : la fonction renvoie un ara::core::Result<ClientAuthentication> [SWS_DM_01200]. Si l'exécution n'est pas possible parce que des fonctions essentielles du Diagnostic Manager ne sont pas disponibles, l'erreur DiagErrc::kServiceNotAvailable est renvoyée avec une sémantique de rollback [SWS_DM_01200].
• Concurrence : l'opération est spécifiée comme thread-safe et exception safe et déclarée avec noexcept, raison pour laquelle des appels depuis des threads parallèles peuvent être effectués de manière sûre vis-à-vis des exceptions [SWS_DM_01200].

Utilisation

La méthode GetAll de la classe ara::diag::ExternalAuthentication (fichier d'en-tête ara/diag/external_authentication.h) permet aux applications d'interroger de manière synchrone toutes les instances de ClientAuthentication actuellement gérées par le Diagnostic Manager [SWS_DM_01201], [SWS_DM_01203]. L'appel s'effectue sans paramètre et renvoie un ara::core::Vector<ClientAuthentication> qui contient l'ensemble des objets d'authentification associés [SWS_DM_01201].

Gestion des erreurs et valeurs de retour

La fonction est déclarée comme sûre vis-à-vis des exceptions (exception safe) et noexcept [SWS_DM_01201]. Aucun code d'erreur spécifique ni message vers DET ou DEM n'existe pour cette interface. Si aucun objet d'authentification n'est disponible, cela n'est pas traité comme une erreur, mais la méthode renvoie un vecteur vide [SWS_DM_01201].

Concurrence et restrictions

La spécification désigne GetAll comme thread-safe [SWS_DM_01201]. Interprétation : des appels issus de plusieurs threads applicatifs parallèles devraient ainsi être autorisés sans synchronisation applicative supplémentaire. Question Q-9f26d94068ebd3fe (ouverte)

Interaction

La quantité d'instances pouvant être interrogées correspond aux éléments de modèle configurés de type DiagnosticExternalAuthenticationIdentification, qui définissent des adresses sources fixes ou des plages d'adresses AUTOSAR_AP_SWS_Diagnostics p. 129. Tandis que GetAll met à disposition l'intégralité de toutes les instances [SWS_DM_01203], la méthode Get permet l'interrogation ciblée pour une adresse source ou une métadonnée spécifique [SWS_DM_01202].

Le destructeur ~ExternalAuthentication() met fin au cycle de vie d'une instance de la classe ara::diag::ExternalAuthentication issue de l'en-tête ara/diag/external_authentication.h [SWS_DM_01198]. Il est exécuté de manière synchrone lors de la sortie de la portée ou lors de la libération de l'objet, ne requiert aucun paramètre d'entrée et ne possède aucune valeur de retour AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 « Destructor ».

Concernant la gestion des erreurs, la fonction est pourvue du spécificateur noexcept et formellement définie comme sûre vis-à-vis des exceptions (exception safe) [SWS_DM_01198]. L'appel garantit dès lors qu'en cas d'erreur, aucune exception C++ n'interrompt le processus de destruction ni n'est propagée à l'appelant.

Concernant la concurrence et les restrictions, il convient de noter que le destructeur est spécifié comme non thread-safe (not thread-safe) [SWS_DM_01198]. Les composants appelants doivent par conséquent s'assurer qu'aucun accès simultané n'a lieu sur la même instance de ara::diag::ExternalAuthentication via des threads distincts pendant la destruction. Vraisemblablement, toutes les opérations actives de diagnostic et d'authentification de cette instance devraient être entièrement terminées avant l'appel afin d'éviter des accès mémoire non coordonnés. Question Q-67c112ea87f722d2 (ouverte)

Dans le contexte fonctionnel, l'interface concrétise l'exigence de niveau supérieur RS_Diag_04251 pour le Diagnostic Management (DM) AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 « Destructor ». La désignation tabulaire comme destructeur d'une Dynamic-Access-List devrait être une imprécision rédactionnelle de la spécification, étant donné que la portée et l'espace de noms déterminent la liaison à ExternalAuthentication [SWS_DM_01198]. Question Q-30744aac322624cb (ouverte)