klasse ara::crypto::x509::OcspResponse

De interface ara::crypto::x509::OcspResponse kapselt het antwoord van een OCSP-verzoek voor het controleren van de certificaatstatus in AUTOSAR Adaptive in. Aanroepers controleren typisch eerst de status van de respons via GetResponseStatus() [SWS_CRYPT_50130] en halen vervolgens de opgenomen certificaten op met behulp van GetCertificates() [SWS_CRYPT_50131]. De toegang vindt concurrency- en uitzonderingsveilig plaats via shared smart pointers naar onveranderlijke instanties (Sptrc) [SWS_CRYPT_40802].

meer ›

Context

De interface ara::crypto::x509::OcspResponse kapselt in de module crypto van het AUTOSAR Adaptive Platform de gegevens in van een respons conform het Online Certificate Status Protocol (OCSP). Haar primaire verantwoordelijkheid bestaat erin applicaties en beveiligingsfuncties te voorzien van de geldigheids- en herroepingsstatus van X.509-certificaten. In tegenstelling tot statische certificaatintrekkingslijsten (CRL's) maakt OCSP het actueel opvragen van de status van individuele certificaten bij een validatiedienst mogelijk.

In de crypto-architectuur fungeert de interface als informatiebron voor aanroepende componenten zoals authenticatiediensten of TLS-protocolstacks. Ze stelt methoden beschikbaar om zowel de overkoepelende responsstatus van het OCSP-bericht op te vragen [SWS_CRYPT_50130] als de in de respons getransporteerde certificaten uit te lezen [SWS_CRYPT_50131]. Op deze wijze kunnen communicatiepartners de geldigheid van certificaatketens direct verifiëren.

Levenscyclus

Als puur virtuele interface definieert ara::crypto::x509::OcspResponse geen publieke constructors of eigen factory-methoden. De instantiëring vindt typisch platformintern plaats via de driver- en providercomponenten van de cryptostack, die de ontvangen ruwe gegevens van de OCSP-respons parsen (interpretatie: concrete instanties worden gegenereerd door onderliggende X.509-providers). Vraag Q-30d53aa886333cbc (open)

Voor het doorgeven en beheren van instanties specificeert de klasse de type-alias Sptrc als std::shared_ptr<const OcspResponse> [SWS_CRYPT_40802]. Door deze smart pointer wordt een gedeelde eigendomsverhouding met strikte leestoegang gerealiseerd. De levensduur van het object wordt geregeld via de referentietelling van de shared pointer en eindigt automatisch zodra de laatste referentie wordt vrijgegeven.

Wat betreft concurrency en fouttolerantie zijn de methoden GetResponseStatus [SWS_CRYPT_50130] en GetCertificates [SWS_CRYPT_50131] gedeclareerd als uitzonderingsveilig (exception safe) en thread-safe (thread-safe). Aangezien via Sptrc [SWS_CRYPT_40802] uitsluitend constante toegang wordt geboden, kunnen meerdere threads parallel en zonder externe locks dezelfde OCSP-responsinstantie benaderen.

Gebruikspad

Het typische verloop voor de evaluatie van een OCSP-respons omvat de controle van de status en het aansluitend ophalen van ingebedde certificaten:

1. Status opvragen: de aanroeper roept eerst GetResponseStatus() aan [SWS_CRYPT_50130]. De methode levert een ara::core::Result<OcspResponseStatus> op, die aangeeft of de respons succesvol is gegenereerd dan wel of er sprake is van een protocolfout.
2. Resultaat controleren: de applicatie controleert het resultaatobject. Alleen als de OCSP-respons als succesvol is gemarkeerd, is het zinvol om verdere payload te evalueren.
3. Certificaten ophalen: vervolgens roept de applicatie GetCertificates() aan [SWS_CRYPT_50131]. Hierbij wordt een ara::core::Result<ara::core::Vector<Certificate::Sptrc>> geretourneerd dat alle in de OCSP-respons opgenomen certificaten inkapselt.
4. Verificatie uitvoeren: de geëxtraheerde certificaten dienen vermoedelijk om de handtekening van de OCSP-respons of de certificaatketen van de responder te valideren (interpretatie: certificaten ondersteunen de controle van de authenticiteit van de OCSP-gegevens). Vraag Q-4f4a5f1b72358a1f (open)

Sequentiediagram: typische volgorde voor het opvragen van de OCSP-responsstatus en het ophalen van opgenomen certificaten. Bronnen: [SWS_CRYPT_50130], [SWS_CRYPT_50131].

Foutscenario's

Beide methoden van de interface gebruiken ara::core::Result als synchroon retourtype en zijn voorzien van de aanduiding noexcept, waardoor het werpen van synchrone C++-exceptions is uitgesloten [SWS_CRYPT_50130] [SWS_CRYPT_50131].

Voor GetResponseStatus() [SWS_CRYPT_50130] en GetCertificates() [SWS_CRYPT_50131] definieert de AUTOSAR-specificatie expliciet geen gestandaardiseerde foutcodes. Mogelijke foutoorzaken – zoals parseerfouten of platforminterne geheugentekorten – worden implementatiespecifiek gemeld via het foutobject van ara::core::Result. Als voorwaarde geldt het bestaan van een geldige pointer van het type OcspResponse::Sptrc [SWS_CRYPT_40802], aangezien toegang via null-pointers ongedefinieerd gedrag zou veroorzaken.