klasse ara::crypto::cryp::PublicKey

De interface ara::crypto::cryp::PublicKey representeert een algemeen asymmetrisch openbaar-sleutelobject in de module crypto en is afgeleid van CryptoObject. Voor referentiëring en overdracht stelt de klasse de type-alias Sptr als std::shared_ptr<PublicKey> beschikbaar, die via de header "ara/crypto/cryp/cryobj/public_key.h" wordt opgenomen [SWS_CRYPT_22701]. Interpretatie: Applicaties geven vermoedelijk instanties van PublicKey::Sptr [SWS_CRYPT_22701] door aan cryptografische contextklassen voor asymmetrische verificatie of versleuteling. Vraag (open) De levensduur en vrijgave van de openbare sleutel wordt daarbij volledig gestuurd via de referentieteller van de gedeelde smart pointer.

meer ›

Context

De klasse ara::crypto::cryp::PublicKey definieert de algemene interface voor asymmetrische openbare sleutels (General Asymmetric Public Key interface) binnen de module crypto van het AUTOSAR Adaptive Platform. Conform haar syntactische declaratie erft de klasse publiek over van CryptoObject. In deze rol fungeert zij als basistype en uniform interfacecontract voor alle asymmetrische openbare-sleutelstructuren die in cryptografische bewerkingen worden ingezet. Als openbare sleutel representeert een object van deze klasse het wiskundig open deel van een asymmetrisch sleutelpaar, dat bedoeld is voor verificatie- of versleutelingsdoeleinden en geen gevoelige privésleutelparameters bevat. De toegang tot de interfacedefinitie verloopt via het headerbestand #include "ara/crypto/cryp/cryobj/public_key.h" conform [SWS_CRYPT_22701]. Interpretatie: Aangezien PublicKey direct is afgeleid van CryptoObject, deelt de interface vermoedelijk gemeenschappelijke eigenschappen en conventies voor cryptografische objecten van het platform, terwijl zij gelijktijdig de specifieke abstractie van een asymmetrische sleutel biedt. Vraag Q-83979c7ba039e328 (open)

Levenscyclus

Voor het beheer en de overdracht van instanties stelt de klasse de type-alias Sptr beschikbaar, die als std::shared_ptr<PublicKey> is gedefinieerd [SWS_CRYPT_22701]. De eigendomsverhoudingen van een openbare sleutel zijn zodoende gebaseerd op gedeeld eigendom (shared ownership). Dit stelt verschillende systeemcomponenten en aanroepers in staat om parallel naar dezelfde sleutelinstantie te verwijzen, zonder dat er dwingend een exclusieve eigenaar hoeft te worden vastgelegd. De levenscyclus van een concrete sleutelinstantie wordt gestuurd via de referentieteller van de standaard smart pointer. Zodra de laatste referentie wordt vrijgegeven en de teller nul bereikt, vindt de gecontroleerde vernietiging van het object plaats. Interpretatie: Het expliciet aanbieden van de alias Sptr [SWS_CRYPT_22701] wijst er vermoedelijk op dat instanties van PublicKey gewoonlijk via factories of laadroutines van de cryptomodule worden gecreëerd en direct als shared pointer aan gebruikers worden overgedragen, in plaats van te worden beheerd als raw pointers of waarde-objecten. Vraag Q-0cdb961ab357bc3b (open) Wat gelijktijdigheid betreft, maakt de referentiëring via std::shared_ptr de thread-overschrijdende overdracht van de pointer mogelijk, waarbij parallelle modificaties bij een zuiver openbare sleutel typisch niet voorkomen, aangezien deze hoofdzakelijk dient als onveranderlijke referentieparameter.

Gebruikspad

Een typisch gebruikspad voor ara::crypto::cryp::PublicKey begint met het opnemen van het betreffende headerbestand "ara/crypto/cryp/cryobj/public_key.h" [SWS_CRYPT_22701]. Aansluitend verkrijgt de applicatie een referentie naar het sleutelobject in de vorm van de getypeerde smart pointer ara::crypto::cryp::PublicKey::Sptr [SWS_CRYPT_22701]. Deze pointer representeert het direct inzetbare asymmetrische sleutelobject. Interpretatie: De verkregen Sptr-instantie [SWS_CRYPT_22701] wordt in opvolgende stappen vermoedelijk doorgegeven aan cryptografische contextklassen, bijvoorbeeld om digitale handtekeningen te verifiëren of gegevens asymmetrisch te versleutelen. Vraag Q-b4800044ca9f058a (open) Na afronding van de cryptografische verificatie- of rekenbewerkingen blijft het sleutelobject hetzij in gedeeld bezit voor toekomstige controleprocessen, hetzij wordt het automatisch vrijgegeven zodra de scope van de lokale Sptr wordt verlaten. Door de inkapseling als abstracte interface hoeven aanroepers de interne algoritmedetails van de sleutel niet te kennen, maar communiceren zij via de uniforme interface van PublicKey.