klasse ara::crypto::x509::CertificateValidationCtx

Gebruik

De methode AddOcspResponse van de klasse ara::crypto::x509::CertificateValidationCtx valideert een doorgegeven OCSP-respons (ocspResponse) en voegt deze bij geldigheid toe aan de verzameling reeds opgeslagen OCSP-responsen in de validatiecontext [SWS_CRYPT_50124]. Aan een context kunnen meerdere responsen worden toegevoegd [SWS_CRYPT_50124]. Via de optionele parameter trustedOcspIssuerCertificate kan een specifiek certificaat worden doorgegeven dat bij de controle van de OCSP-respons als betrouwbaar geldt; wordt deze parameter weggelaten, dan gebruikt de validatie de eerder via AddTrustedCertificate geconfigureerde certificaten [SWS_CRYPT_50124].

De synchrone aanroep levert een ara::core::Result<CertificateValidationStatus> op, die bij succesvolle overname de status kValid bevat of anders het resultaat van de OCSP-validatie dan wel een fout weergeeft [SWS_CRYPT_50124].

Foutafhandeling

De specificatie definieert geen gestandaardiseerde foutcodes voor deze aanroep [SWS_CRYPT_50124]. Faalt de bewerking, dan wordt ofwel de overeenkomstige validatiestatus in het resultaat overgebracht of een implementatiespecifieke fout via het Result-object gesignaleerd [SWS_CRYPT_50124].

Gelijktijdigheid en beperkingen

De bewerking is gespecificeerd als thread-safe en exception-safe [SWS_CRYPT_50124]. Om de validatie van de OCSP-respons te laten slagen, moet aan een van de volgende voorwaarden worden voldaan [SWS_CRYPT_50124]:

• De uitgever is eerder in de context als betrouwbaar of onbetrouwbaar certificaat opgeslagen [SWS_CRYPT_50124].
• De handtekening is afkomstig van een certificaat met gezette extensie id-kp-OCSPSigning van dezelfde certificeringsinstantie (CA) [SWS_CRYPT_50124].
• De handtekening is afkomstig van een betrouwbare CA die direct via trustedOcspIssuerCertificate is doorgegeven [SWS_CRYPT_50124].

Samenspel

De geregistreerde OCSP-responsen worden meegenomen in daaropvolgende validatiecontroles, zoals uitgevoerd door [SWS_CRYPT_50122] (ValidateCertificate) en [SWS_CRYPT_50123] (ValidateCertificateChain). Interpretatie: De OCSP-responsen moeten vermoedelijk vóór de start van de padvalidatie worden toegevoegd, zodat rekening kan worden gehouden met de intrekkingsstatus van de certificaten. Vraag Q-fbb0711617fd7895 (open)

De methode AddTrustedCertificate van de klasse ara::crypto::x509::CertificateValidationCtx breidt de verzameling vertrouwde certificaten voor daaropvolgende validaties uit met een extra certificaat [SWS_CRYPT_50117].

Gebruik

De aanroep vindt plaats via de interface in ara/crypto/x509/certificate_validation_ctx.h. Als parameter wordt trustedCertificate van het type Certificate::Sptrc doorgegeven, dat bij de certificaatpadvalidatie als vertrouwd wordt beschouwd [SWS_CRYPT_50117]. De functie retourneert bij een succesvolle uitvoering een lege ara::core::Result<void> [SWS_CRYPT_50117].

Foutafhandeling

De specificatie definieert geen gestandaardiseerde foutcodes voor deze functie [SWS_CRYPT_50117]. Als er tijdens de verwerking een fout optreedt, wordt een implementatiespecifieke fout teruggemeld via de ara::core::Result [SWS_CRYPT_50117].

Gelijktijdigheid en beperkingen

De methode is gedeclareerd als noexcept=0, geldt als uitzonderingsveilig (exception safe) en is expliciet gespecificeerd als thread-veilig (thread-safe) [SWS_CRYPT_50117].

Samenspel

De geregistreerde vertrouwde certificaten werken samen met andere functies van de validatiecontext:

• In ValidateCertificateChain wordt een certificaatketen volgens RFC 5280 gevalideerd tegen de vertrouwde certificaten die eerder via AddTrustedCertificate zijn vastgelegd, terwijl niet-vertrouwde certificaten worden genegeerd [SWS_CRYPT_50123].
• Bij AddOcspResponse kan een eerder in de context ingesteld vertrouwd certificaat als uitgever worden gebruikt om de geldigheid van het OCSP-antwoord te controleren [SWS_CRYPT_50124].

De methode AddUntrustedCertificate van het contexttype ara::crypto::x509::CertificateValidationCtx voegt een niet-vertrouwd certificaat toe aan de verzameling van eerder geregistreerde certificaten, zodat dit tijdens de certificaatpadvalidatie kan worden meegenomen [SWS_CRYPT_50118]. De opname vindt plaats via het headerbestand #include "ara/crypto/x509/certificate_validation_ctx.h" [SWS_CRYPT_50118]. Als parameter wordt een smart pointer naar het mee te nemen certificaat (Certificate::Sptrc untrustedCertificate) doorgegeven [SWS_CRYPT_50118]. Aangezien de methode direct een ara::core::Result<void> retourneert, wordt de registratie vermoedelijk synchroon afgehandeld [SWS_CRYPT_50118]. Vraag Q-879b384ff6efe687 (open)

Met betrekking tot foutafhandeling specificeert AUTOSAR geen gestandaardiseerde foutcodes voor deze interface [SWS_CRYPT_50118]. In geval van succes bevat de geretourneerde ara::core::Result geen waarde (void); in geval van een fout levert deze een implementatiespecifieke foutcode op [SWS_CRYPT_50118]. Aanroepers moeten het Result-object daarom vóór het verdere gebruik van de validatiecontext controleren op fouten. De methode is gedeclareerd als noexcept en geclassificeerd als uitzonderingsveilig (exception safe), waardoor er geen C++-excepties over de interfacegrens worden gepropageerd [SWS_CRYPT_50118].

De operatie is expliciet gedeclareerd als thread-safe (thread-safe) [SWS_CRYPT_50118]. Meerdere threads kunnen zodoende gelijktijdig certificaten aanleveren aan dezelfde validatiecontext. De aanroep dient idealiter vóór de start van de padvalidatie plaats te vinden om te waarborgen dat alle benodigde certificaten beschikbaar zijn voor het validatie-algoritme [SWS_CRYPT_50118].

Gebruik

De methode IgnoreCriticalExtension op [SWS_CRYPT_50119] configureert de instantie van ara::crypto::x509::CertificateValidationCtx zodanig dat een specifieke certificaatextensie bij de controle van certificaten en OCSP-antwoorden wordt genegeerd. Dit geldt ook wanneer de extensie als kritiek is gemarkeerd en van oorsprong niet wordt ondersteund door de validatiecontext. De parameter ignoredExtensionOid neemt de OID van de te negeren extensie over als ara::core::StringView. Meervoudige aanroepen leiden ertoe dat alle meegegeven extensie-OID's worden genegeerd. De uitvoering vindt synchroon plaats en is gedeclareerd als noexcept.

Foutafhandeling en gelijktijdigheid

De functie specificeert geen gestandaardiseerde foutcodes; bij succes levert zij een lege ara::core::Result<void> op, terwijl in geval van een fout een implementatiespecifieke foutcode aanwezig is [SWS_CRYPT_50119]. Wat betreft gelijktijdigheid is de interface gespecificeerd als thread-safe (thread-safe) en uitzonderingsveilig (exception safe).

Beperkingen en interactie

Wordt een kritieke extensie genegeerd, dan ligt de functionele validatie van deze extensie volledig bij de verantwoordelijkheid van de applicatie [SWS_CRYPT_50119]. Voor zover de validatieoptie kIgnoreUnknownCriticalExtensions is ingesteld, heeft de aanroep geen extra effect. Het negeren van niet-ondersteunde kritieke extensies voorkomt vermoedelijk dat de latere padcontrole in het kader van [SWS_CRYPT_40203] (bijvoorbeeld bij het bepalen van de CertificateValidationStatus) mislukt. Vraag Q-a087c9a9543c092a (open)

Gebruik

De methode SetValidationOptions van de klasse ara::crypto::x509::CertificateValidationCtx dient er conform [SWS_CRYPT_50120] voor om de opties voor het uitvoeren van een certificaatvalidatie vast te leggen. Als parameter verwacht de puur virtuele functie CertificateValidationOptions, een bitmasker ter identificatie van de gewenste validatieopties. De aanroep wordt beschikbaar gesteld via de header ara/crypto/x509/certificate_validation_ctx.h.

Foutafhandeling

De interface retourneert conform [SWS_CRYPT_50120] een ara::core::Result<void>. Bij een succesvolle uitvoering bevat het resultaat geen waarde (leeg resultaat). Indien er een ongeldige waarde voor de opties wordt doorgegeven, mislukt de operatie met de foutcode ara::crypto::CryptoErrc::kInvalidArgument. Daarbij is een rollback-semantiek van kracht. Als er een andere fout optreedt, kan een implementatiespecifieke foutcode worden geretourneerd.

Gelijktijdigheid en beperkingen

Conform [SWS_CRYPT_50120] is de methode gespecificeerd als thread-veilig (thread-safe) en mag deze gelijktijdig worden aangeroepen. Deze is bovendien gedeclareerd als uitzonderingsveilig (exception safe) en met noexcept, waardoor er geen excepties over de interfacegrens mogen worden geworpen.

De methode ValidateCertificate van de klasse ara::crypto::x509::CertificateValidationCtx uit de header ara/crypto/x509/certificate_validation_ctx.h voert een synchrone certificaatpadvalidatie uit conform RFC 5280 [SWS_CRYPT_50122]. De validatiecontrole vindt plaats op basis van de voorafgaande configuratie van de instantiecontext. Als enige invoerparameter wordt het te valideren certificaat via de pointer certificate van het type Certificate::Sptrc doorgegeven [SWS_CRYPT_50122].

Als retourtype dient ara::core::Result<CertificateValidationResult::Sptrc>, dat in geval van succes een pointer naar het validatieresultaat bevat of in geval van fouten een foutcode levert [SWS_CRYPT_50122]. Naast implementatiespecifieke fouten kan de specifieke foutcode ara::crypto::CryptoErrc::kIncompatibleArguments optreden [SWS_CRYPT_50122]. Deze heeft rollback-semantiek en wordt geretourneerd wanneer via AddOcspResponse een OCSP-respons is opgeslagen, maar de geconfigureerde CertificateValidationOptions geen OCSP-gedrag specificeren.

Wat betreft uitvoeringsveiligheid en concurrency is de methode als thread-safe (thread-safe) en uitzonderingsveilig (exception safe) gespecificeerd en werpt zij geen uitzonderingen op (noexcept) [SWS_CRYPT_50122]. Als volgordevoorwaarde moet in acht worden genomen dat de validatiecontext vooraf geïnitialiseerd en geconfigureerd moet zijn, aangezien de controle direct voortbouwt op de voorinstellingen daarvan [SWS_CRYPT_50122].

De methode ValidateCertificateChain in context ara::crypto::x509::CertificateValidationCtx voert een synchrone padvalidatie van een certificaatketen volgens RFC 5280 uit [SWS_CRYPT_50123].

Gebruik en parameters

Als invoer verwacht de functie via de parameter certificateChain een keten van het type ara::core::Span<Certificate::Sptrc>. Daarbij vertegenwoordigt element 0 het bladcertificaat (Leaf Certificate), terwijl elk opvolgend element de uitgever van het telkens voorafgaande certificaat moet bevatten [SWS_CRYPT_50123]. De functie negeert certificaten die eerder via AddUntrustedCertificate zijn geregistreerd, en valideert de doorgegeven keten uitsluitend tegen trust anchors die middels AddTrustedCertificate zijn opgeslagen [SWS_CRYPT_50123].

Foutafhandeling

Het resultaat wordt ingekapseld als ara::core::Result<CertificateValidationResult::Sptrc> bereitgesteld, dat hetzij een pointer naar het validatieresultaat hetzij een foutcode bevat [SWS_CRYPT_50123]. De fout ara::crypto::CryptoErrc::kIncompatibleArguments treedt op met rollback-semantiek wanneer eerder via AddOcspResponse een OCSP-antwoord is ingesteld, maar de huidige CertificateValidationOptions geen OCSP-gedrag definiëren [SWS_CRYPT_50123]. Andere foutoorzaken worden als implementatiespecifieke foutcodes teruggemeld [SWS_CRYPT_50123].

Gelijktijdigheid en uitvoeringsveiligheid

De interface is gedeclareerd als noexcept, geldt als uitzonderingsveilig (exception safe) en is voor gelijktijdige toegang geclassificeerd als thread-safe (thread-safe) [SWS_CRYPT_50123].