class ara::crypto::x509::OcspResponse

Die Schnittstelle ara::crypto::x509::OcspResponse kapselt die Antwort einer OCSP-Abfrage zur Überprüfung des Zertifikatsstatus in AUTOSAR Adaptive. Aufrufer prüfen typischerweise zunächst den Status der Antwort über GetResponseStatus() [SWS_CRYPT_50130] und rufen anschließend die enthaltenen Zertifikate mittels GetCertificates() ab [SWS_CRYPT_50131]. Der Zugriff erfolgt nebenläufigkeits- und ausnahmesicher über Shared-Smart-Pointer auf unveränderliche Instanzen (Sptrc) [SWS_CRYPT_40802].

mehr ›

Kontext

Die Schnittstelle ara::crypto::x509::OcspResponse kapselt im Modul crypto der AUTOSAR Adaptive Platform die Daten einer Antwort gemäß dem Online Certificate Status Protocol (OCSP). Ihre primäre Verantwortung besteht darin, Anwendungen und Sicherheitsfunktionen den Gültigkeits- und Widerrufsstatus von X.509-Zertifikaten bereitzustellen. Im Gegensatz zu statischen Zertifikatssperrlisten (CRLs) ermöglicht OCSP eine zeitnahe Statusabfrage einzelner Zertifikate bei einem Validierungsdienst.

In der Krypto-Architektur agiert die Schnittstelle als Informationsquelle für aufrufende Komponenten wie Authentifizierungsdienste oder TLS-Protokoll-Stacks. Sie stellt Methoden bereit, um sowohl den übergeordneten Antwortstatus der OCSP-Nachricht abzufragen [SWS_CRYPT_50130] als auch die in der Antwort transportierten Zertifikate auszulesen [SWS_CRYPT_50131]. Auf diese Weise können Kommunikationspartner die Gültigkeit von Zertifikatsketten unmittelbar verifizieren.

Lebenszyklus

Als rein virtuelle Schnittstelle definiert ara::crypto::x509::OcspResponse keine öffentlichen Konstruktoren oder eigenen Fabrikmethoden. Die Instanziierung erfolgt typischerweise plattformintern über die Treiber- und Provider-Komponenten des Krypto-Stacks, welche empfangene Rohdaten der OCSP-Antwort parsen (Interpretation: konkrete Instanzen werden durch zugrundeliegende X.509-Provider erzeugt). Frage Q-30d53aa886333cbc (offen)

Für die Weitergabe und Verwaltung von Instanzen spezifiziert die Klasse den Typalias Sptrc als std::shared_ptr<const OcspResponse> [SWS_CRYPT_40802]. Durch diesen Smart-Pointer wird ein geteiltes Besitzverhältnis mit striktem Lesezugriff etabliert. Die Lebensdauer des Objekts wird über die Referenzzählung des Shared-Pointers geregelt und endet automatisch, sobald die letzte Referenz freigegeben wird.

Hinsichtlich Nebenläufigkeit und Fehlertoleranz sind die Methoden GetResponseStatus [SWS_CRYPT_50130] und GetCertificates [SWS_CRYPT_50131] als ausnahmesicher (exception safe) und threadsicher (thread-safe) deklariert. Da über Sptrc [SWS_CRYPT_40802] ausschließlich konstanter Zugriff gewährt wird, können mehrere Threads parallel und ohne externe Sperren auf dieselbe OCSP-Antwortinstanz zugreifen.

Nutzungspfad

Der typische Ablauf zur Auswertung einer OCSP-Antwort umfasst die Prüfung des Status und den anschließenden Abruf eingebetteter Zertifikate:

1. Status abfragen: Der Aufrufer ruft zunächst GetResponseStatus() auf [SWS_CRYPT_50130]. Die Methode liefert ein ara::core::Result<OcspResponseStatus> zurück, welches angibt, ob die Antwort erfolgreich erzeugt wurde oder ein Protokollfehler vorliegt.
2. Ergebnis prüfen: Die Anwendung prüft das Result-Objekt. Nur wenn die OCSP-Antwort als erfolgreich gekennzeichnet ist, ist das Auswerten weiterer Nutzdaten sinnvoll.
3. Zertifikate beziehen: Anschließend ruft die Anwendung GetCertificates() auf [SWS_CRYPT_50131]. Hierbei wird ein ara::core::Result<ara::core::Vector<Certificate::Sptrc>> zurückgegeben, das alle in der OCSP-Antwort enthaltenen Zertifikate kapselt.
4. Verifikation durchführen: Die extrahierten Zertifikate dienen vermutlich dazu, die Signatur der OCSP-Antwort oder die Zertifikatskette des Responders zu validieren (Interpretation: Zertifikate unterstützen die Authentizitätsprüfung der OCSP-Daten). Frage Q-4f4a5f1b72358a1f (offen)

Sequenzdiagramm: Typische Abfolge zur Abfrage des OCSP-Antwortstatus und Abholung enthaltener Zertifikate. Quellen: [SWS_CRYPT_50130], [SWS_CRYPT_50131].

Fehlerszenarien

Beide Methoden der Schnittstelle nutzen ara::core::Result als synchronen Rückgabetyp und sind mit dem Bezeichner noexcept versehen, wodurch das Werfen synchroner C++-Ausnahmen ausgeschlossen ist [SWS_CRYPT_50130] [SWS_CRYPT_50131].

Für GetResponseStatus() [SWS_CRYPT_50130] und GetCertificates() [SWS_CRYPT_50131] definiert die AUTOSAR-Spezifikation explizit keine standardisierten Fehlercodes. Mögliche Fehlerursachen – wie etwa Parsing-Fehler oder plattforminterne Speicherengpässe – werden implementierungsspezifisch über das Fehlerobjekt von ara::core::Result gemeldet. Als Vorbedingung gilt die Existenz eines gültigen Zeigers vom Typ OcspResponse::Sptrc [SWS_CRYPT_40802], da ein Zugriff über Nullzeiger undefiniertes Verhalten hervorrufen würde.