classe ara::crypto::x509::CertificateValidationResult

L'interface ara::crypto::x509::CertificateValidationResult fournit le résultat d'une validation de certificat X.509 et est typiquement gérée comme un Sptrc immuable [SWS_CRYPT_50093]. Par l'intermédiaire de ses méthodes, l'application interroge le statut global, détermine la chaîne de certificats complète avec le certificat feuille en position 0 ou isole le certificat ayant échoué. Si la vérification a réussi, l'appel visant à déterminer le certificat erroné échoue avec le code d'erreur ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. Toutes les méthodes de l'interface sont conçues pour être thread-safe et exception-safe.

plus ›

Contexte

L'interface ara::crypto::x509::CertificateValidationResult encapsule le résultat d'un processus de validation de certificat X.509 au sein du module Adaptive crypto. Sa responsabilité principale consiste à mettre à la disposition des applications appelantes un résultat de vérification structuré et cohérent. Celui-ci comprend aussi bien le statut de validation agrégé du chemin de certification que l'accès aux objets de certificat impliqués. En tant qu'intermédiaire entre les mécanismes internes de vérification cryptographique et les applications critiques pour la sécurité, la classe permet une évaluation différenciée des hiérarchies de certificats. Parmi ses partenaires d'interaction centraux figurent des instances de Certificate::Sptrc, qui sont soit assemblées sous forme de chaîne de certificats complète, soit désignées en cas d'erreur comme la cause de l'échec.

Cycle de vie

En tant qu'interface purement virtuelle, CertificateValidationResult ne définit aucun constructeur public propre. La durée de vie et les relations de propriété sont principalement régies par le pointeur intelligent typé Sptrc, qui est défini comme std::shared_ptr<const CertificateValidationResult> [SWS_CRYPT_50093]. Ce pointeur constant établit un modèle de propriété partagée et immuable : après l'achèvement d'une validation de certificat, l'objet résultat est mis à disposition sous la forme d'un instantané non modifiable. La création et l'initialisation des instances concrètes devraient s'effectuer en interne par des fonctions de validation de niveau supérieur du backend de la plateforme. Question Q-a5580dcf443b0905 (ouverte) Comme toutes les fonctions membres sont déclarées comme const ainsi que noexcept et explicitement spécifiées comme thread-safe et exception-safe ([SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]), plusieurs threads peuvent accéder de manière concurrente et sans mesures de synchronisation supplémentaires à la même instance, jusqu'à ce que la dernière référence soit libérée.

Parcours d'utilisation

Un chemin d'utilisation typique démarre après la réception d'une instance de CertificateValidationResult::Sptrc issue d'une vérification de certificat préalable. Les appelants effectuent l'évaluation selon une séquence standardisée :

• Tout d'abord, l'application appelle GetValidationStatus() afin d'interroger le résultat fondamental de la validation de certificat sous forme de CertificateValidationStatus [SWS_CRYPT_50094].
• Si la validation a réussi, le client appelle GetCertificateChain() afin de récupérer la chaîne de certificats trouvée au cours du processus de vérification sous forme de ara::core::Vector<Certificate::Sptrc> [SWS_CRYPT_50096]. Selon la spécification, cette chaîne débute toujours à l'index 0 avec le certificat feuille (Leaf Certificate) [SWS_CRYPT_50096].
• Si la validation du chemin a en revanche échoué, l'appelant appelle GetFailedCertificate() pour identifier de manière ciblée le certificat qui a déclenché l'erreur de validation [SWS_CRYPT_50095].

Diagramme de séquence : Déroulement typique pour l'interrogation du statut de validation, de la chaîne de certificats et de la cause de l'erreur. Sources : [SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]

Scénarios d'erreur

La gestion des erreurs de l'interface repose sur ara::core::Result, tous les appels respectant la garantie noexcept et étant sans exception :

• Validation réussie et GetFailedCertificate() : Lorsque la vérification s'est achevée avec succès (valeur de retour kValid), aucun certificat n'a provoqué d'échec. Dans cet état, l'appel de GetFailedCertificate() échoue avec le code d'erreur ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. Les applications doivent interpréter cette erreur comme la confirmation logique d'une chaîne sans défaut ou lier l'appel à un statut négatif.
• Erreurs d'état spécifiques à l'implémentation : Aucun code d'erreur standardisé n'est défini pour GetValidationStatus(), les erreurs spécifiques à l'implémentation étant toutefois encapsulées dans le ara::core::Result retourné [SWS_CRYPT_50094].
• Interrogation de la chaîne de certificats : GetCertificateChain() ne spécifie pas non plus de codes d'erreur standardisés [SWS_CRYPT_50096] ; les éventuels états d'erreur internes sont signalés via le ara::core::Result résultant.