classe ara::crypto::x509::X509DN

L'interface ara::crypto::x509::X509DN sert à encapsuler et à mettre à disposition un Distinguished Name X.509 sous la forme d'une structure de données sérialisable au sein du module cryptographique. Via l'alias Sptrc, la propriété partagée et immuable des instances est réalisée sous la forme d'un std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. La méthode centrale ToString() formate le nom complet selon la RFC 4514 et fonctionne de manière sûre au niveau des threads ainsi que sans codes d'erreur standardisés [SWS_CRYPT_40411]. Les appelants reçoivent le résultat sous la forme d'un ara::core::Result<ara::core::String>, dont la validité doit être vérifiée avant tout traitement ultérieur.

plus ›

Contexte

L'interface abstraite ara::crypto::x509::X509DN représente, au sein du module crypto de l'AUTOSAR Adaptive Platform, un Distinguished Name (DN) conformément à la norme X.509. Par héritage de ara::crypto::Serializable, la classe est intégrée dans la hiérarchie des types en tant que structure de données cryptographique sérialisable. La tâche principale de l'interface consiste à encapsuler du côté logiciel les structures de noms des certificats, des détenteurs de certificats (Subjects) ou des émetteurs de certificats (Issuers). La mise à disposition d'une représentation textuelle normalisée y joue un rôle central : conformément à [SWS_CRYPT_40411], la méthode ToString() exporte le Distinguished Name complet sous forme de chaîne de caractères conformément à la spécification RFC 4514. Si le Distinguished Name sous-jacent comprend des attributs non standardisés, l'Object Identifier (OID) respectif est utilisé pour ces attributs [SWS_CRYPT_40411].

Cycle de vie

Puisqu'il s'agit pour ara::crypto::x509::X509DN d'une interface C++ abstraite comportant des méthodes purement virtuelles telles que ToString(), l'instanciation n'est pas effectuée directement par les développeurs d'applications. La charge utile ne spécifie aucun constructeur public ; la création d'instances concrètes s'effectue probablement par des composants de niveau supérieur ou des analyseurs syntaxiques de certificats du sous-système cryptographique. Question Q-108d7589869c7370 (ouverte)

Pour un accès partagé et durable, l'interface définit le spécificateur de type Sptrc comme alias de std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. L'utilisation d'un pointeur partagé constant souligne le concept de propriété et d'accès : les instances de X509DN sont extérieurement immuables. Plusieurs consommateurs peuvent partager de manière sûre et sans état la même représentation d'un Distinguished Name, sans qu'aucun coût de synchronisation ne soit requis lors des accès en lecture. En matière de concurrence, la méthode centrale ToString() est explicitement déclarée comme thread-safe [SWS_CRYPT_40411]. Des appels parallèles via le même pointeur partagé ou à travers différents threads sont ainsi autorisés sans verrous externes. De plus, la spécification garantit une sécurité totale vis-à-vis des exceptions (exception safe) pour cet appel [SWS_CRYPT_40411].

Parcours d'utilisation

Le chemin d'utilisation typique se concentre sur la lecture et le traitement ultérieur du Distinguished Name formaté à des fins de journalisation, d'authentification ou de vérification d'identité. Une application reçoit généralement un pointeur de type ara::crypto::x509::X509DN::Sptrc [SWS_CRYPT_40401].

Sur cette instance, l'appelant exécute la méthode ToString() [SWS_CRYPT_40411]. L'appel s'effectue noexcept et renvoie un ara::core::Result<ara::core::String> [SWS_CRYPT_40411]. En cas d'évaluation réussie, l'objet Result contient la chaîne de caractères formatée selon la RFC 4514, par exemple sous la forme standardisée de paires attribut-valeur telles que CN=... ou en utilisant des OID pour les attributs propriétaires [SWS_CRYPT_40411]. L'application peut ensuite extraire la chaîne résultante et la réutiliser pour des vérifications spécifiques à l'application, des comparaisons ou des journaux d'audit.

Scénarios d'erreur

Lors de l'interaction avec ara::crypto::x509::X509DN, la gestion des erreurs se distingue par une conception claire et minimale. Bien que ToString() utilise le type de retour ara::core::Result<ara::core::String>, la spécification stipule explicitement que la fonction ne définit aucun code d'erreur standardisé [SWS_CRYPT_40411]. Cela signifie qu'aucun motif de rejet fonctionnel ni aucune erreur de validation ne sont prévus pour l'opération de sérialisation dans le contexte régulier de la spécification.

Puisque la fonction est en outre spécifiée comme noexcept et comme exception safe [SWS_CRYPT_40411], les exceptions C++ synchrones sont exclues. Si des états d'erreur surviennent néanmoins au sein du ara::core::Result renvoyé, ils sont probablement dus à des causes spécifiques à la plateforme ou à l'implémentation, telles que des pénuries de mémoire lors de l'allocation de la chaîne de résultat. Question Q-10477dd7d77e3b78 (ouverte) Les appelants doivent donc toujours vérifier avant d'extraire la valeur si le Result contient une valeur valide ou une erreur, même si AUTOSAR ne prescrit aucune constante d'erreur propre au domaine pour cela.