Bietet Schnittstellen und Datenstrukturen zur Repräsentation, Konfiguration und Validierung von X.509-Zertifikaten.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c166465f6ba8HerkunftOffene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Bietet Schnittstellen und Datenstrukturen zur Repräsentation, Konfiguration und Validierung von X.509-Zertifikaten.
Der Namespace ara::crypto::x509 stellt Schnittstellen und Datentypen zur Verwaltung, Nutzungsdefinition und Validierung von X.509-Zertifikaten sowie OCSP-Antworten in AUTOSAR Adaptive bereit. Über den Validierungskontext CertificateValidationCtx werden Zertifikatspfade parametrisiert anhand von Optionen wie CertificateValidationOptions[SWS_CRYPT_50107] geprüft. Das Ergebnis wird strukturiert über Statuswerte wie CertificateValidationStatus[SWS_CRYPT_40203] zurückgemeldet, wobei Online-Widerrufsprüfungen per Voreinstellung inaktiv sind und explizit konfiguriert werden müssen.
Kontext
Der Namespace ara::crypto::x509 stellt die zentralen Schnittstellen und Datentypen zur Verarbeitung und Validierung von X.509-Zertifikatsstrukturen in der AUTOSAR Adaptive Platform bereit. Das Schnittstellenmodell umfasst die Repräsentation digitaler Zertifikate (Certificate), Zertifikatssignierungsanfragen (CertSignRequest), Distinguished Names (X509DN) sowie OCSP-Antworten (OcspResponse). Die Instanziierung und Verwaltung dieser kryptografischen Artefakte erfolgt typischerweise über das Provider-Interface X509Provider (Interpretation: Der Provider fungiert als zentrale Fabrikinstanz für X.509-Objekte). Frage Q-449a726a75b1e78d (offen)
Kontextdiagramm: Zusammenspiel der Kernschnittstellen zur Zertifikatsverwaltung und Pfadvalidierung. Quellen: [SWS_CRYPT_40101], [SWS_CRYPT_50097]
Nutzungspfad
Der primäre operative Ablauf im Namespace besteht in der Prüfung von Zertifikatspfaden über CertificateValidationCtx. Das Validierungsverhalten wird über Bitmasken vom Typ CertificateValidationOptions[SWS_CRYPT_50107] parametrisiert. Standardmäßig erfolgt die Pfadprüfung ohne Einbindung von Online-Zertifikatsstatusabfragen über die Option kOcspOff[SWS_CRYPT_50114]. Soll die Gültigkeit online verifiziert werden, kann entweder die Prüfung der gesamten Kette über kOcspResponseCompleteChain[SWS_CRYPT_50112] oder ausschließlich für das Zielzertifikat mittels kOcspResponseTargetOnly[SWS_CRYPT_50113] aktiviert werden.
Für spezifische Prüfszenarien erlauben weitere Validierungsoptionen das Übersteuern von Standardprüfungen: So können zeitliche Gültigkeitsgrenzen über kIgnoreNotBefore[SWS_CRYPT_50108] und kIgnoreNotAfter[SWS_CRYPT_50109] ignoriert werden. Ebenso lässt sich die Auswertung zuvor importierter Zertifikatswiderrufslisten (CRL) mit kIgnoreCrl[SWS_CRYPT_50111] abschalten oder die Fehlersignalisierung bei unbekannten kritischen Erweiterungen via kIgnoreUnknownCriticalExtensions[SWS_CRYPT_50110] unterdrücken. Nach Durchführung der Validierung liefert der Kontext ein Ergebnisobjekt CertificateValidationResult zurück (Interpretation: Der Validierungsaufruf bindet Zielzertifikat, Prüfoptionen und optionale OCSP-Antworten ein und kapselt das Resultat in der Ergebnisklasse). Frage (offen)
Sequenzdiagramm: Ablauf einer Zertifikatsvalidierung mittels Prüfkontext und Auswertung des Resultats. Quellen: [SWS_CRYPT_50107], [SWS_CRYPT_40203]
Fehlerszenarien
Das Ergebnis einer Zertifikatspfadprüfung wird über die Enumeration CertificateValidationStatus[SWS_CRYPT_40203] detailliert aufgeschlüsselt. Eine erfolgreiche Validierung wird durch kValid (= 0) signalisiert. Schlägt die Prüfung fehl, kennzeichnen spezifische Statuswerte die genaue Ursache:
kInvalidSignature (= 1): Eine Signatur innerhalb des Zertifikatspfads konnte nicht erfolgreich verifiziert werden.
kNoPathToTrustedCertificate (= 3): Es konnte kein Pfad zu einem als vertrauenswürdig eingestuften Wurzelzertifikat aufgebaut werden.
kExpired (= 4): Das Zertifikat hat die Gültigkeitsdauer überschritten (Feld notAfter).
kFuture (= 5): Die Gültigkeitsdauer des Zertifikats hat gemäß dem Feld notBefore noch nicht begonnen.
kRevoked (= 6): Das Zertifikat wurde widerrufen; dieser Status resultiert aus importierten CRLs oder einer aktiven OCSP-Prüfung via kOcspResponseCompleteChain oder kOcspResponseTargetOnly.
kUnknownOcspStatus (= 7): Eine eingebundene OCSP-Antwort liefert für das Zertifikat den Zustand „unknown“.
kUnknownCriticalExtension (= 8): Ein Zertifikat enthält eine unbekannte kritische Erweiterung, die weder durch kIgnoreUnknownCriticalExtensions noch durch Vorab-Ausnahmebehandlung ignoriert wurde.
Sofern im Validierungsprozess Online-Statusabfragen verarbeitet werden, signalisiert die Enumeration OcspResponseStatus[SWS_CRYPT_40001] das Resultat des Protokollabrufs. Neben einer erfolgreichen Antwortbestätigung (kSuccessful = 0) können protokollarische und serverseitige Fehler auftreten: ungültige Anfragen (kMalformedRequest = 1), interne Fehler des Ausstellers (kInternalError = 2), temporäre Überlastung (kTryLater = 3), die Notwendigkeit einer Signatur (kSigRequired = 5) oder fehlende Autorisierung (kUnauthorized = 6).
Dieser Leitfaden basiert auf den AUTOSAR-Adaptive-Spezifikationen zum Release R25-11 für das Modul crypto. Er wurde automatisiert erstellt und kuratiert.
KI-gestützte Gruppierung auf Basis der Records und Spezifikationsauszüge; keine Gliederung aus der AUTOSAR-Spezifikation.
Klassendiagramm
Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.
=1 The certificate path validation failed because a signature of a certificate in the path could not be verified.
kNoPathToTrustedCertificate
=3 The certificate path validation failed because no path to a trusted certificate could be found.
kExpired
=4 The certificate path validation failed because a certificate is expired according to the notAfter field.
kFuture
=5 The certificate path validation failed because a certificate is not valid yet according to the notBefore field.
kRevoked
=6 The certificate path validation failed because a certificate has been revoked through a previously imported CRL or through an OCSP response (if OCSP is enabled through kOcspResponseComplete Chain or kOcspResponseTargetOnly)
kUnknownOcspStatus
=7 The certificate path validation failed because a certificate state is ’unknown’ according to an OCSP response (if OCSP is enabled through kOcspResponseCompleteChain or kOcspResponseTarget Only).
kUnknownCriticalExtension
=8 The certificate path validation failed because a certificate contains an unknown critical extension that has not been excluded from validation using the kIgnoreUnknownCriticalExtensions flag or the IgnoreCriticalExtension() function
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-medium· 2026-10-13