class ara::crypto::x509::X509DN

Die Schnittstelle ara::crypto::x509::X509DN dient der Kapselung und Bereitstellung eines X.509 Distinguished Name als serialisierbare Datenstruktur innerhalb des Krypto-Moduls. Über den Alias Sptrc wird der gemeinsame, unveränderliche Besitz der Instanzen als std::shared_ptr<const X509DN> realisiert [SWS_CRYPT_40401]. Die zentrale Methode ToString() formatiert den vollständigen Namen nach RFC 4514 und arbeitet threadsicher sowie ohne standardisierte Fehlercodes [SWS_CRYPT_40411]. Aufrufer erhalten das Ergebnis als ara::core::Result<ara::core::String>, das vor der Weiterverarbeitung auf Gültigkeit geprüft werden muss.

mehr ›

Kontext

Die abstrakte Schnittstelle ara::crypto::x509::X509DN repräsentiert innerhalb des Moduls crypto der AUTOSAR Adaptive Platform einen Distinguished Name (DN) gemäß dem X.509-Standard. Durch die Vererbung von ara::crypto::Serializable ist die Klasse als serialisierbare kryptografische Datenstruktur in die Typenhierarchie eingebettet. Die primäre Aufgabe des Interfaces besteht darin, Namensstrukturen von Zertifikaten, Zertifikatsinhabern (Subjects) oder Zertifikatsausstellern (Issuers) softwareseitig zu kapseln. Eine zentrale Rolle nimmt dabei die Bereitstellung einer normierten Textrepräsentation ein: Gemäß [SWS_CRYPT_40411] exportiert die Methode ToString() den vollständigen Distinguished Name als Zeichenkette entsprechend der Spezifikation RFC 4514. Sollte der zugrunde liegende Distinguished Name nicht-standardisierte Attribute umfassen, wird für diese Attribute die jeweilige Object Identifier (OID) herangezogen [SWS_CRYPT_40411].

Lebenszyklus

Da es sich bei ara::crypto::x509::X509DN um eine abstrakte C++-Schnittstelle mit rein virtuellen Methoden wie ToString() handelt, erfolgt die Instanziierung nicht direkt durch Anwendungsentwickler. Der Payload spezifiziert keinen öffentlichen Konstruktor; die Erzeugung konkreter Instanzen dürfte vermutlich durch übergeordnete Komponenten oder Zertifikatsparser des kryptografischen Subsystems erfolgen. Frage Q-108d7589869c7370 (offen)

Für den gemeinsamen und langlebigen Zugriff definiert die Schnittstelle den Typspezifikator Sptrc als Alias für std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. Die Verwendung eines konstanten Shared Pointers unterstreicht das Besitz- und Zugriffskonzept: Instanzen von X509DN sind nach außen hin unveränderlich (immutable). Mehrere Konsumenten können dieselbe Repräsentation eines Distinguished Name sicher und zustandslos teilen, ohne dass Synchronisierungsaufwände bei Lesezugriffen anfallen. Hinsichtlich der Nebenläufigkeit ist die zentrale Methode ToString() explizit als thread-safe deklariert [SWS_CRYPT_40411]. Parallele Aufrufe über denselben Shared Pointer oder über verschiedene Threads hinweg sind somit ohne externe Locks zulässig. Zudem sichert die Spezifikation für diesen Aufruf vollkommene Exception-Sicherheit (exception safe) zu [SWS_CRYPT_40411].

Nutzungspfad

Der typische Nutzungspfad konzentriert sich auf das Auslesen und die Weiterverarbeitung des formatierten Distinguished Name zur Protokollierung, Authentifizierung oder Identitätsprüfung. Eine Anwendung empfängt üblicherweise einen Zeiger vom Typ ara::crypto::x509::X509DN::Sptrc [SWS_CRYPT_40401].

Auf dieser Instanz führt der Aufrufer die Methode ToString() aus [SWS_CRYPT_40411]. Der Aufruf erfolgt noexcept und liefert ein ara::core::Result<ara::core::String> zurück [SWS_CRYPT_40411]. Bei erfolgreicher Auswertung enthält das Result-Objekt die nach RFC 4514 formatierte Zeichenkette, beispielsweise in der standardisierten Form von Attribut-Wert-Paaren wie CN=... oder unter Verwendung von OIDs bei proprietären Attributen [SWS_CRYPT_40411]. Die Anwendung kann den resultierenden String anschließend extrahieren und für anwendungsspezifische Prüfungen, Vergleiche oder Audit-Logs weiterverwenden.

Fehlerszenarien

Bei der Interaktion mit ara::crypto::x509::X509DN zeichnet sich die Fehlerbehandlung durch ein klares, minimales Design aus. Obwohl ToString() den Rückgabetyp ara::core::Result<ara::core::String> nutzt, legt die Spezifikation explizit fest, dass die Funktion keine standardisierten Fehlercodes definiert [SWS_CRYPT_40411]. Dies bedeutet, dass im regulären Spezifikationskontext keine fachlichen Ablehnungsgründe oder Validierungsfehler für den Serialisierungsvorgang vorgesehen sind.

Da die Funktion zudem als noexcept und als exception safe spezifiziert ist [SWS_CRYPT_40411], scheiden synchrone C++-Exceptions aus. Treten dennoch Fehlerzustände innerhalb des zurückgegebenen ara::core::Result auf, dürften diese vermutlich auf plattform- oder implementierungsspezifische Ursachen wie Speicherengpässe bei der Allokation des Ergebnis-Strings zurückzuführen sein. Frage Q-10477dd7d77e3b78 (offen) Aufrufer müssen daher vor dem Entpacken des Wertes stets prüfen, ob das Result einen gültigen Wert oder einen Fehler enthält, auch wenn AUTOSAR hierfür keine domainspezifischen Fehlerkonstanten vorgibt.