class ara::crypto::x509::CertificateValidationResult

Die Schnittstelle ara::crypto::x509::CertificateValidationResult stellt das Ergebnis einer X.509-Zertifikatsvalidierung bereit und wird typischerweise als unveränderlicher Sptrc verwaltet [SWS_CRYPT_50093]. Über ihre Methoden fragt die Anwendung den Gesamtstatus ab, ermittelt die vollständige Zertifikatkette mit dem Blattzertifikat an Position 0 oder isoliert das fehlgeschlagene Zertifikat. War die Prüfung erfolgreich, schlägt der Aufruf zur Ermittlung des fehlerhaften Zertifikats mit dem Fehlercode ara::crypto::CryptoErrc::kNoSuchValue fehl [SWS_CRYPT_50095]. Sämtliche Schnittstellenmethoden sind dabei threadsicher und exceptionsicher ausgelegt.

mehr ›

Kontext

Die Schnittstelle ara::crypto::x509::CertificateValidationResult kapselt das Ergebnis eines X.509-Zertifikatsvalidierungsvorgangs innerhalb des Adaptive-Moduls crypto. Ihre primäre Verantwortung besteht darin, aufrufenden Anwendungen ein strukturiertes und konsistentes Prüfergebnis zur Verfügung zu stellen. Dieses umfasst sowohl den aggregierten Validierungsstatus des Zertifikatspfads als auch den Zugriff auf die beteiligten Zertifikatsobjekte. Als Vermittler zwischen den internen kryptografischen Verifikationsmechanismen und sicherheitskritischen Anwendungen ermöglicht die Klasse eine differenzierte Auswertung von Zertifikatshierarchien. Zu ihren zentralen Interaktionspartnern zählen Instanzen von Certificate::Sptrc, die entweder als vollständige Zertifikatkette zusammengestellt oder im Fehlerfall als Verursacher des Fehlschlags ausgewiesen werden.

Lebenszyklus

Als rein virtuelle Schnittstelle definiert CertificateValidationResult keine eigenen öffentlichen Konstruktoren. Die Lebensdauer und Besitzverhältnisse werden maßgeblich durch den typisierten Smart Pointer Sptrc gesteuert, der als std::shared_ptr<const CertificateValidationResult> definiert ist [SWS_CRYPT_50093]. Dieser konstante Zeiger etabliert ein geteiltes, unveränderliches Besitzmodell: Nach Abschluss einer Zertifikatsvalidierung wird das Ergebnisobjekt als unmodifizierbare Momentaufnahme bereitgestellt. Die Erzeugung und Initialisierung konkreter Instanzen dürfte dabei intern durch übergeordnete Validierungsfunktionen des Plattform-Backends erfolgen. Frage Q-a5580dcf443b0905 (offen) Da sämtliche Elementfunktionen als const sowie noexcept deklariert und explizit als thread-safe und exception-safe spezifiziert sind ([SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]), können mehrere Threads nebenläufig und ohne zusätzliche Synchronisationsmaßnahmen auf dieselbe Instanz zugreifen, bis die letzte Referenz freigegeben wird.

Nutzungspfad

Ein typischer Nutzungspfad startet nach dem Empfang einer CertificateValidationResult::Sptrc-Instanz aus einer vorangegangenen Zertifikatsprüfung. Aufrufer vollziehen die Auswertung in einer standardisierten Abfolge:

• Zunächst ruft die Anwendung GetValidationStatus() auf, um das grundlegende Ergebnis der Zertifikatsvalidierung als CertificateValidationStatus abzufragen [SWS_CRYPT_50094].
• War die Validierung erfolgreich, ruft der Client GetCertificateChain() auf, um die während des Prüfvorgangs gefundene Zertifikatkette als ara::core::Vector<Certificate::Sptrc> abzurufen [SWS_CRYPT_50096]. Gemäß Spezifikation beginnt diese Kette an Indexposition 0 stets mit dem Blattzertifikat (Leaf Certificate) [SWS_CRYPT_50096].
• Ist die Pfadvalidierung hingegen fehlgeschlagen, ruft der Aufrufer GetFailedCertificate() auf, um gezielt dasjenige Zertifikat zu ermitteln, welches den Validierungsfehler ausgelöst hat [SWS_CRYPT_50095].

Sequenzdiagramm: Typischer Ablauf zur Abfrage von Validierungsstatus, Zertifikatkette und Fehlerursache. Quellen: [SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]

Fehlerszenarien

Das Fehlermanagement der Schnittstelle stützt sich auf ara::core::Result, wobei alle Aufrufe die noexcept-Garantie einhalten und exceptionsicher sind:

• Erfolgreiche Validierung und GetFailedCertificate(): Wenn die Prüfung erfolgreich abgeschlossen wurde (Rückgabewert kValid), hat kein Zertifikat ein Fehlschlagen verursacht. In diesem Zustand schlägt der Aufruf von GetFailedCertificate() mit dem Fehlercode ara::crypto::CryptoErrc::kNoSuchValue fehl [SWS_CRYPT_50095]. Anwendungen müssen diesen Fehler als logische Bestätigung einer fehlerfreien Kette interpretieren oder den Aufruf an einen negativen Status koppeln.
• Implementationsspezifische Statusfehler: Für GetValidationStatus() sind keine standardisierten Fehlercodes definiert, implementationsspezifische Fehler werden jedoch im zurückgegebenen ara::core::Result gekapselt [SWS_CRYPT_50094].
• Zertifikatskettenabfrage: Auch GetCertificateChain() spezifiziert keine standardisierten Fehlercodes [SWS_CRYPT_50096]; allfällige interne Fehlerzustände werden über das resultierende ara::core::Result signalisiert.