klasse ara::crypto::cryp::SymmetricKey

De interface ara::crypto::cryp::SymmetricKey dient in AUTOSAR Adaptive als abstractie voor symmetrische cryptografische sleutels en erft fundamentele eigenschappen over van CryptoObject. Applicaties en cryptocontexten beheren sleutelinstanties primair via het gestandaardiseerde smart-pointertype Sptr (std::shared_ptr<SymmetricKey>) conform header ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801]. Interpretatie: De instantiëring vindt vermoedelijk plaats via speciale creatieroutines van het sleutelbeheer, waarbij de sleutel wordt doorgegeven voor de configuratie van cijfers of MAC's. Als doorslaggevende randvoorwaarde bepaalt de referentietelling van de shared pointer de levensduur, zodat het ingekapselde sleutelobject pas na vrijgave van de laatste referentie wordt vernietigd [SWS_CRYPT_23801]. Vraag Q-f76fecc360d2d3a5 (open)

meer ›

Context

De klasse ara::crypto::cryp::SymmetricKey vormt in het AUTOSAR Adaptive Platform (Release R25-11, module crypto) de centrale interface voor de representatie van symmetrische cryptografische sleutels. Als elementair onderdeel van het cryptografie-subsysteem kapselt de interface alle eigenschappen in die vereist zijn voor symmetrische cryptografische procedures. De klasse is direct afgeleid van CryptoObject (class SymmetricKey : public CryptoObject) en voegt zich daarmee in de uniforme objecthiërarchie voor cryptografische entiteiten van het Adaptive Platform. De interface wordt gedeclareerd in het headerbestand ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801].

Als interactiepartners treden typisch cryptografische uitvoeringscontexten en sleutelbeheerinstanties op. De interface fungeert als schakel tussen het creëren of beschikbaar stellen van sleutelmateriaal en de operatieve toepassing ervan. Interpretatie: Symmetrische sleutels worden vermoedelijk in de eerste plaats toegepast in symmetrische cijferprocedures (zoals blok- of stroomcijfers) en in Message Authentication Codes (MAC), om vertrouwelijkheid en data-integriteit op voertuigniveau te waarborgen. Vraag (open) Door de inkapseling als CryptoObject wordt gegarandeerd dat het sleutelmateriaal ontkoppeld blijft van de concrete cryptografische transformatie.

Levenscyclus

De levenscyclus van ara::crypto::cryp::SymmetricKey-instanties is nauw gekoppeld aan moderne C++-geheugenbeheerpatronen. Conform [SWS_CRYPT_23801] stelt de klasse de type-alias Sptr beschikbaar, die als using Sptr = std::shared_ptr<SymmetricKey>; is gedefinieerd. Via deze gedeelde smart pointer wordt de levenscyclus van het interface-object via referentietelling en op deterministische wijze geregeld.

Interpretatie: De daadwerkelijke creatie en initialisatie van instanties vindt in de praktijk vermoedelijk plaats via gespecialiseerde sleutelgeneratoren, laadroutines of sleutelbeheercomponenten van de cryptostack, aangezien de interfacedefinitie geen openbare standaardconstructors voor directe instantiëring van ruwe sleutels bevat. Vraag Q-51acf16b99d9ad1b (open) Zodra een sleutelinstantie als Sptr is aangemaakt, kan hiernaar door meerdere softwarecomponenten of cryptografische contexten concurrent en met gedeeld eigendom worden verwezen [SWS_CRYPT_23801].

De vrijgave van de onderliggende resources vindt automatisch plaats zodra de laatste actieve Sptr wordt vernietigd of gereset. Interpretatie: De afleiding van CryptoObject doet vermoeden dat gevoelig sleutelmateriaal in het geheugen speciaal beschermd en bij de vernietiging van het object veilig gewist (zeroization) wordt, om uitlezen na afloop van de levensduur te voorkomen. Vraag (open) Het gebruik van std::shared_ptr garandeert bovendien thread-safety bij het beheer van de referentietellers, terwijl de toegang tot het gereferentieerde sleutelobject zelf onderworpen is aan de gebruikelijke synchronisatieregels voor gedeelde resources.

Gebruikspad

Het reguliere gebruik van ara::crypto::cryp::SymmetricKey in een Adaptive-applicatie volgt een gestructureerd verloop dat steunt op de gedefinieerde smart pointer [SWS_CRYPT_23801]:

• Header-opname: Eerst neemt de gebruikende softwarecomponent de header #include "ara/crypto/cryp/cryobj/symmetric_key.h" op om toegang te verkrijgen tot de typedefinitie en de alias Sptr [SWS_CRYPT_23801].
• Sleutelverwerving: De applicatie verkrijgt de interface in de vorm van een ara::crypto::cryp::SymmetricKey::Sptr [SWS_CRYPT_23801], bijvoorbeeld uit een voorafgaand sleutelverstrekkingsproces.
• Geldigheidscontrole: Vóór het operatieve gebruik verifieert de aanroeper dat de verkregen Sptr ongelijk is aan nullptr en naar een intacte CryptoObject verwijst.
• Toewijzing aan crypto-contexten: De sleutelpointer wordt overgedragen aan de verantwoordelijke cryptografische context om deze te configureren voor op handen zijnde ver- of ontsleutelingsbewerkingen dan wel integriteitscontroles.
• Vrijgave: Na voltooiing van de transformaties of bij het beëindigen van de applicatiecontext wordt de pointer verworpen; de vernietiging van de sleutel vindt plaats door het automatische wissen van de laatste Sptr [SWS_CRYPT_23801].