klasse ara::crypto::x509::CertificateValidationResult

De interface ara::crypto::x509::CertificateValidationResult stelt het resultaat van een X.509-certificaatvalidatie beschikbaar en wordt typisch als onveranderlijke Sptrc beheerd [SWS_CRYPT_50093]. Via haar methoden vraagt de applicatie de algehele status op, bepaalt zij de volledige certificaatketen met het bladcertificaat op positie 0 of isoleert zij het mislukte certificaat. Was de controle succesvol, dan mislukt de aanroep voor het bepalen van het foutieve certificaat met de foutcode ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. Alle interfacemethoden zijn daarbij thread-veilig en exception-safe ontworpen.

meer ›

Context

De interface ara::crypto::x509::CertificateValidationResult kapselt het resultaat in van een X.509-certificaatvalidatieproces binnen de Adaptive-module crypto. Haar primaire verantwoordelijkheid bestaat erin aanroepende applicaties te voorzien van een gestructureerd en consistent controleresultaat. Dit omvat zowel de geaggregeerde validatiestatus van het certificaatpad als de toegang tot de betrokken certificaatobjecten. Als bemiddelaar tussen de interne cryptografische verificatiemechanismen en veiligheidskritieke applicaties maakt de klasse een gedifferentieerde evaluatie van certificaathiërarchieën mogelijk. Tot haar centrale interactiepartners behoren instanties van Certificate::Sptrc, die hetzij als volledige certificaatketen worden samengesteld, hetzij in geval van een fout worden aangewezen als veroorzaker van de mislukking.

Levenscyclus

Als puur virtuele interface definieert CertificateValidationResult geen eigen openbare constructors. De levensduur en eigendomsverhoudingen worden hoofdzakelijk gestuurd door de getypeerde smart pointer Sptrc, die gedefinieerd is als std::shared_ptr<const CertificateValidationResult> [SWS_CRYPT_50093]. Deze constante pointer vestigt een gedeeld, onveranderlijk eigendomsmodel: na afronding van een certificaatvalidatie wordt het resultaatobject als onwijzigbare momentopname beschikbaar gesteld. De creatie en initialisatie van concrete instanties vindt daarbij vermoedelijk intern plaats via bovenliggende validatiefuncties van de platform-backend. Vraag Q-a5580dcf443b0905 (open) Aangezien alle lidfuncties als const evenals noexcept zijn gedeclareerd en expliciet als thread-safe en exception-safe zijn gespecificeerd ([SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]), kunnen meerdere threads gelijktijdig en zonder aanvullende synchronisatiemaatregelen toegang verkrijgen tot dezelfde instantie, totdat de laatste referentie wordt vrijgegeven.

Gebruikspad

Een typisch gebruikspad start na ontvangst van een CertificateValidationResult::Sptrc-instantie uit een voorafgaande certificaatcontrole. Aanroepers voltooien de evaluatie in een gestandaardiseerde volgorde:

• Eerst roept de applicatie GetValidationStatus() aan om het fundamentele resultaat van de certificaatvalidatie als CertificateValidationStatus op te vragen [SWS_CRYPT_50094].
• Was de validatie succesvol, dan roept de client GetCertificateChain() aan om de tijdens het controleproces gevonden certificaatketen als ara::core::Vector<Certificate::Sptrc> op te halen [SWS_CRYPT_50096]. Volgens de specificatie begint deze keten op indexpositie 0 altijd met het bladcertificaat (Leaf Certificate) [SWS_CRYPT_50096].
• Is de padvalidatie daarentegen mislukt, dan roept de aanroeper GetFailedCertificate() aan om doelgericht het certificaat te bepalen dat de validatiefout heeft veroorzaakt [SWS_CRYPT_50095].

Sequentiediagram: Typisch verloop voor het opvragen van validatiestatus, certificaatketen en foutoorzaak. Bronnen: [SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]

Foutscenario's

Het foutbeheer van de interface steunt op ara::core::Result, waarbij alle aanroepen aan de noexcept-garantie voldoen en exception-safe zijn:

• Succesvolle validatie en GetFailedCertificate(): Wanneer de controle met succes is afgerond (retourwaarde kValid), heeft geen enkel certificaat een mislukking veroorzaakt. In deze toestand mislukt de aanroep van GetFailedCertificate() met de foutcode ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. Applicaties moeten deze fout interpreteren als een logische bevestiging van een foutloze keten of de aanroep koppelen aan een negatieve status.
• Implementatiespecifieke statusfouten: Voor GetValidationStatus() zijn geen gestandaardiseerde foutcodes gedefinieerd, maar implementatiespecifieke fouten worden ingekapseld in de geretourneerde ara::core::Result [SWS_CRYPT_50094].
• Opvragen van de certificaatketen: Ook GetCertificateChain() specificeert geen gestandaardiseerde foutcodes [SWS_CRYPT_50096]; eventuele interne fouttoestanden worden gesignaleerd via de resulterende ara::core::Result.