klasse ara::crypto::x509::X509DN

De interface ara::crypto::x509::X509DN dient voor het inkapselen en beschikbaar stellen van een X.509 Distinguished Name als serialiseerbare datastructuur binnen de crypto-module. Via de alias Sptrc wordt het gedeelde, onveranderlijke bezit van de instanties als std::shared_ptr<const X509DN> gerealiseerd [SWS_CRYPT_40401]. De centrale methode ToString() formatteert de volledige naam volgens RFC 4514 en werkt thread-veilig en zonder gestandaardiseerde foutcodes [SWS_CRYPT_40411]. Aanroepers ontvangen het resultaat als ara::core::Result<ara::core::String>, dat vóór verdere verwerking op geldigheid moet worden gecontroleerd.

meer ›

Context

De abstracte interface ara::crypto::x509::X509DN representeert binnen de module crypto van het AUTOSAR Adaptive Platform een Distinguished Name (DN) conform de X.509-standaard. Door overerving van ara::crypto::Serializable is de klasse als serialiseerbare cryptografische datastructuur ingebed in de typehiërarchie. De primaire taak van de interface bestaat uit het softwarematig inkapselen van naamstructuren van certificaten, certificaathouders (subjects) of certificaatuitgevers (issuers). Een centrale rol wordt daarbij ingenomen door het beschikbaar stellen van een genormeerde tekstrepresentatie: conform [SWS_CRYPT_40411] exporteert de methode ToString() de volledige Distinguished Name als tekenreeks overeenkomstig de specificatie RFC 4514. Mocht de onderliggende Distinguished Name niet-gestandaardiseerde attributen bevatten, dan wordt voor deze attributen de respectievelijke Object Identifier (OID) gebruikt [SWS_CRYPT_40411].

Levenscyclus

Aangezien ara::crypto::x509::X509DN een abstracte C++-interface is met puur virtuele methoden zoals ToString(), vindt instantiatie niet rechtstreeks plaats door applicatieontwikkelaars. De payload specificeert geen publieke constructor; de creatie van concrete instanties gebeurt vermoedelijk door bovenliggende componenten of certificaatparsers van het cryptografische subsysteem. Vraag Q-108d7589869c7370 (open)

Voor gedeelde en langdurige toegang definieert de interface de typespecificator Sptrc als alias voor std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. Het gebruik van een constante shared pointer onderstreept het eigendoms- en toegangsconcept: instanties van X509DN zijn naar buiten toe onveranderlijk (immutable). Meerdere consumenten kunnen dezelfde representatie van een Distinguished Name veilig en staatloos delen, zonder dat er synchronisatie-overhead optreedt bij leestoegang. Wat betreft gelijktijdigheid is de centrale methode ToString() expliciet gedeclareerd als thread-safe [SWS_CRYPT_40411]. Parallelle aanroepen via dezelfde shared pointer of over verschillende threads heen zijn daardoor toegestaan zonder externe locks. Bovendien verzekert de specificatie voor deze aanroep volledige uitzonderingsveiligheid (exception safe) [SWS_CRYPT_40411].

Gebruikspad

Het typische gebruikspad richt zich op het uitlezen en verder verwerken van de geformatteerde Distinguished Name voor logging, authenticatie of identiteitsverificatie. Een applicatie ontvangt gewoonlijk een pointer van het type ara::crypto::x509::X509DN::Sptrc [SWS_CRYPT_40401].

Op deze instantie voert de aanroeper de methode ToString() uit [SWS_CRYPT_40411]. De aanroep geschiedt noexcept en retourneert een ara::core::Result<ara::core::String> [SWS_CRYPT_40411]. Bij een succesvolle evaluatie bevat het Result-object de volgens RFC 4514 geformatteerde tekenreeks, bijvoorbeeld in de gestandaardiseerde vorm van attribuut-waarde-paren zoals CN=... of met gebruik van OID's bij propriëtaire attributen [SWS_CRYPT_40411]. De applicatie kan de resulterende string vervolgens extraheren en verder gebruiken voor applicatiespecifieke controles, vergelijkingen of auditlogs.

Foutscenario's

Bij de interactie met ara::crypto::x509::X509DN kenmerkt de foutafhandeling zich door een helder, minimaal ontwerp. Hoewel ToString() het retourtype ara::core::Result<ara::core::String> gebruikt, legt de specificatie expliciet vast dat de functie geen gestandaardiseerde foutcodes definieert [SWS_CRYPT_40411]. Dit betekent dat er in de reguliere specificatiecontext geen functionele afwijzingsgronden of validatiefouten voor het serialisatieproces zijn voorzien.

Aangezien de functie bovendien gespecificeerd is als noexcept en als exception safe [SWS_CRYPT_40411], zijn synchrone C++-exceptions uitgesloten. Mochten er toch fouttoestanden optreden binnen het geretourneerde ara::core::Result, dan zijn deze vermoedelijk terug te voeren op platform- of implementatiespecifieke oorzaken, zoals geheugentekorten bij de allocatie van de resultaat-string. Vraag Q-10477dd7d77e3b78 (open) Aanroepers moeten daarom vóór het uitpakken van de waarde altijd controleren of de Result een geldige waarde of een fout bevat, zelfs als AUTOSAR hiervoor geen domeinspecifieke foutconstanten voorschrijft.