classe ara::crypto::x509::CertificateValidationCtx

Utilisation

La méthode AddOcspResponse de la classe ara::crypto::x509::CertificateValidationCtx valide une réponse OCSP transmise (ocspResponse) et l'ajoute, si elle est valide, à l'ensemble des réponses OCSP déjà enregistrées dans le contexte de validation [SWS_CRYPT_50124]. Plusieurs réponses peuvent être ajoutées à un même contexte [SWS_CRYPT_50124]. Le paramètre optionnel trustedOcspIssuerCertificate permet de transmettre un certificat spécifique considéré comme digne de confiance lors de la vérification de la réponse OCSP ; si ce paramètre est omis, la validation fait appel aux certificats préalablement configurés au moyen de AddTrustedCertificate [SWS_CRYPT_50124].

L'appel synchrone renvoie un ara::core::Result<CertificateValidationStatus> qui, en cas de prise en charge réussie, contient le statut kValid ou, dans le cas contraire, reflète le résultat de la validation OCSP ou une erreur [SWS_CRYPT_50124].

Gestion des erreurs

La spécification ne définit aucun code d'erreur standardisé pour cet appel [SWS_CRYPT_50124]. Si l'opération échoue, soit le statut de validation correspondant est véhiculé dans le résultat, soit une erreur spécifique à l'implémentation est signalée via l'objet Result [SWS_CRYPT_50124].

Concurrence et restrictions

L'opération est spécifiée comme thread-safe et exception-safe [SWS_CRYPT_50124]. Pour que la validation de la réponse OCSP réussisse, l'une des conditions suivantes doit être remplie [SWS_CRYPT_50124] :

• L'émetteur a été préalablement enregistré dans le contexte en tant que certificat digne de confiance ou non digne de confiance [SWS_CRYPT_50124].
• La signature provient d'un certificat avec l'extension id-kp-OCSPSigning définie de la même autorité de certification (CA) [SWS_CRYPT_50124].
• La signature provient d'une CA digne de confiance transmise directement via trustedOcspIssuerCertificate [SWS_CRYPT_50124].

Interaction

Les réponses OCSP enregistrées sont intégrées dans les contrôles de validation en aval, tels qu'effectués par [SWS_CRYPT_50122] (ValidateCertificate) et [SWS_CRYPT_50123] (ValidateCertificateChain). Interprétation : les réponses OCSP devraient devoir être ajoutées avant le début de la validation du chemin pour que le statut de révocation des certificats puisse être pris en compte. Question Q-fbb0711617fd7895 (ouverte)

La méthode AddTrustedCertificate de la classe ara::crypto::x509::CertificateValidationCtx ajoute un certificat supplémentaire à l'ensemble des certificats de confiance pour les validations ultérieures [SWS_CRYPT_50117].

Utilisation

L'appel s'effectue via l'interface dans ara/crypto/x509/certificate_validation_ctx.h. Le paramètre transmis est trustedCertificate de type Certificate::Sptrc, qui est considéré comme digne de confiance lors de la validation du chemin de certification [SWS_CRYPT_50117]. En cas d'exécution réussie, la fonction renvoie un ara::core::Result<void> vide [SWS_CRYPT_50117].

Gestion des erreurs

La spécification ne définit aucun code d'erreur standardisé pour cette fonction [SWS_CRYPT_50117]. Si une erreur survient pendant le traitement, une erreur spécifique à l'implémentation est signalée via le ara::core::Result [SWS_CRYPT_50117].

Concurrence et restrictions

La méthode est déclarée comme noexcept=0, est considérée comme sûre face aux exceptions (exception safe) et est explicitement spécifiée comme sûre pour les threads (thread-safe) [SWS_CRYPT_50117].

Interaction

Les certificats de confiance enregistrés interagissent avec d'autres fonctions du contexte de validation :

• Dans ValidateCertificateChain, une chaîne de certificats selon la RFC 5280 est validée par rapport aux certificats de confiance préalablement enregistrés via AddTrustedCertificate, tandis que les certificats non fiables sont ignorés [SWS_CRYPT_50123].
• Pour AddOcspResponse, un certificat de confiance préalablement défini dans le contexte peut être utilisé comme émetteur afin de vérifier la validité de la réponse OCSP [SWS_CRYPT_50124].

La méthode AddUntrustedCertificate du type de contexte ara::crypto::x509::CertificateValidationCtx ajoute un certificat non approuvé à l'ensemble des certificats préalablement enregistrés afin qu'il puisse être pris en compte lors de la validation du chemin de certification [SWS_CRYPT_50118]. L'intégration s'effectue via le fichier d'en-tête #include "ara/crypto/x509/certificate_validation_ctx.h" [SWS_CRYPT_50118]. Un pointeur intelligent vers le certificat à prendre en compte (Certificate::Sptrc untrustedCertificate) est transmis en tant que paramètre [SWS_CRYPT_50118]. Étant donné que la méthode renvoie immédiatement un ara::core::Result<void>, l'enregistrement devrait se dérouler de manière synchrone [SWS_CRYPT_50118]. Question Q-879b384ff6efe687 (ouverte)

Concernant le traitement des erreurs, AUTOSAR ne spécifie aucun code d'erreur standardisé pour cette interface [SWS_CRYPT_50118]. En cas de succès, le ara::core::Result renvoyé ne contient aucune valeur (void) ; en cas d'erreur, il fournit un code d'erreur spécifique à l'implémentation [SWS_CRYPT_50118]. Les appelants doivent donc vérifier l'absence d'erreurs dans l'objet Result avant toute utilisation ultérieure du contexte de validation. La méthode est déclarée comme noexcept et classée comme sûre vis-à-vis des exceptions (exception safe), ce qui signifie qu'aucune exception C++ n'est propagée au-delà de la frontière de l'interface [SWS_CRYPT_50118].

L'opération est explicitement déclarée comme sûre vis-à-vis des threads (thread-safe) [SWS_CRYPT_50118]. Plusieurs threads peuvent ainsi injecter de manière concurrente des certificats dans le même contexte de validation. Il est judicieux d'effectuer l'appel avant le démarrage de la validation de chemin afin de garantir que tous les certificats requis sont prêts pour l'algorithme de validation [SWS_CRYPT_50118].

Utilisation

La méthode IgnoreCriticalExtension sur [SWS_CRYPT_50119] configure l'instance de ara::crypto::x509::CertificateValidationCtx de manière à ignorer une extension de certificat spécifique lors de la vérification de certificats ainsi que de réponses OCSP. Ceci s'applique également lorsque l'extension est marquée comme critique et n'est pas prise en charge à l'origine par le contexte de validation. Le paramètre ignoredExtensionOid reçoit l'OID de l'extension à ignorer sous la forme de ara::core::StringView. Des appels multiples ont pour conséquence que tous les OID d'extension transmis sont ignorés. L'exécution s'effectue de manière synchrone et est déclarée comme noexcept.

Gestion des erreurs et concurrence

La fonction ne spécifie aucun code d'erreur standardisé ; en cas de succès, elle renvoie un ara::core::Result<void> vide, tandis qu'en cas d'erreur, un code d'erreur spécifique à l'implémentation est contenu [SWS_CRYPT_50119]. Concernant la concurrence, l'interface est spécifiée comme thread-safe et exception safe.

Restrictions et interaction

Si une extension critique est ignorée, la validation métier de cette extension relève entièrement de la responsabilité de l'application [SWS_CRYPT_50119]. Dans la mesure où l'option de validation kIgnoreUnknownCriticalExtensions est définie, l'appel ne produit aucun effet supplémentaire. Le fait d'ignorer des extensions critiques non prises en charge devrait éviter que la vérification ultérieure de chemin n'échoue dans le cadre de [SWS_CRYPT_40203] (par exemple lors de la détermination de CertificateValidationStatus). Question Q-a087c9a9543c092a (ouverte)

Utilisation

La méthode SetValidationOptions de la classe ara::crypto::x509::CertificateValidationCtx sert, conformément à [SWS_CRYPT_50120], à définir les options pour l'exécution d'une validation de certificat. Comme paramètre, la fonction purement virtuelle attend CertificateValidationOptions, un masque de bits servant à identifier les options de validation souhaitées. L'appel est mis à disposition via l'en-tête ara/crypto/x509/certificate_validation_ctx.h.

Gestion des erreurs

L'interface renvoie un ara::core::Result<void> conformément à [SWS_CRYPT_50120]. En cas d'exécution réussie, le résultat ne contient aucune valeur (résultat vide). Si une valeur non valide est transmise pour les options, l'opération échoue avec le code d'erreur ara::crypto::CryptoErrc::kInvalidArgument. Une sémantique de rollback s'applique alors. Si une autre erreur survient, un code d'erreur spécifique à l'implémentation peut être renvoyé.

Concurrence et restrictions

Conformément à [SWS_CRYPT_50120], la méthode est spécifiée comme sûre pour les threads (thread-safe) et peut être appelée de manière concurrente. Elle est en outre déclarée sûre face aux exceptions (exception safe) ainsi qu'avec noexcept, raison pour laquelle aucune exception ne doit être levée au-delà de la frontière de l'interface.

La méthode ValidateCertificate de la classe ara::crypto::x509::CertificateValidationCtx issue de l'en-tête ara/crypto/x509/certificate_validation_ctx.h effectue une validation synchrone de chemin de certification conformément à la RFC 5280 [SWS_CRYPT_50122]. Le contrôle de validation s'effectue sur la base de la configuration préalable du contexte d'instance. Le certificat à valider est transmis comme unique paramètre d'entrée via le pointeur certificate de type Certificate::Sptrc [SWS_CRYPT_50122].

ara::core::Result<CertificateValidationResult::Sptrc> sert de type de retour, qui contient en cas de succès un pointeur vers le résultat de validation ou fournit un code d'erreur en cas d'erreur [SWS_CRYPT_50122]. En plus des erreurs spécifiques à l'implémentation, le code d'erreur spécifique ara::crypto::CryptoErrc::kIncompatibleArguments peut survenir [SWS_CRYPT_50122]. Celui-ci possède une sémantique de rollback et est renvoyé lorsqu'une réponse OCSP a été enregistrée au moyen de AddOcspResponse, mais que les CertificateValidationOptions configurés ne spécifient aucun comportement OCSP.

Concernant la sécurité d'exécution et la concurrence, la méthode est spécifiée comme sûre vis-à-vis des threads (thread-safe) et des exceptions (exception safe), et ne lève aucune exception (noexcept) [SWS_CRYPT_50122]. Comme condition d'ordonnancement, il convient de noter que le contexte de validation doit être préalablement initialisé et configuré, car le contrôle s'appuie directement sur ses préréglages [SWS_CRYPT_50122].

La méthode ValidateCertificateChain dans le contexte ara::crypto::x509::CertificateValidationCtx effectue une validation de chemin synchrone d'une chaîne de certificats conformément à la RFC 5280 [SWS_CRYPT_50123].

Utilisation et paramètres

En entrée, la fonction attend via le paramètre certificateChain une chaîne de type ara::core::Span<Certificate::Sptrc>. L'élément 0 y représente le certificat feuille (Leaf Certificate), tandis que chaque élément suivant doit contenir l'émetteur du certificat immédiatement précédent [SWS_CRYPT_50123]. La fonction ignore les certificats précédemment enregistrés via AddUntrustedCertificate et valide la chaîne transmise exclusivement par rapport à des ancres de confiance déposées au moyen de AddTrustedCertificate [SWS_CRYPT_50123].

Gestion des erreurs

Le résultat est mis à disposition sous forme encapsulée en tant que ara::core::Result<CertificateValidationResult::Sptrc>, qui contient soit un pointeur vers le résultat de validation, soit un code d'erreur [SWS_CRYPT_50123]. L'erreur ara::crypto::CryptoErrc::kIncompatibleArguments survient avec une sémantique de rollback lorsqu'une réponse OCSP a été préalablement définie via AddOcspResponse, mais que les CertificateValidationOptions actuels ne définissent aucun comportement OCSP [SWS_CRYPT_50123]. Les autres causes d'erreur sont signalées sous forme de codes d'erreur spécifiques à l'implémentation [SWS_CRYPT_50123].

Concurrence et sécurité d'exécution

L'interface est déclarée comme noexcept, est considérée comme sûre vis-à-vis des exceptions (exception safe) et est classée comme thread-safe pour les accès concurrents [SWS_CRYPT_50123].