klasse ara::crypto::cryp::WriteableKeySlot

De interface ara::crypto::cryp::WriteableKeySlot dient in AUTOSAR Adaptive als schrijfbare abstractie voor sleutelopslaglocaties in een crypto-provider. Instanties kunnen noch gekopieerd noch verplaatst worden ([SWS_CRYPT_50170], [SWS_CRYPT_50168]), maar worden gerefereerd via het smart pointer-type Sptr [SWS_CRYPT_50172]. Via de thread-veilige methode Clear() wordt de inhoud van de sleutelpositie gewist, waarbij in geval van fouten zoals kBusyResource of kUnsupported een rollback-semantiek van toepassing is [SWS_CRYPT_30405].

meer ›

Context

De interface ara::crypto::cryp::WriteableKeySlot definieert binnen het AUTOSAR Adaptive Platform een schrijfbare opslagruimte voor cryptografische sleutels in de context van een crypto-provider. Deze is direct afgeleid van de basisinterface KeySlot en vormt een gestandaardiseerde abstractie om beheerde sleutelposities gericht te wissen en de levenscyclus ervan te beheren. Als essentiële interactiepartners fungeren applicaties van de crypto-stack als consumenten en de concrete crypto-provider, die de binding aan het fysieke of logische sleutelgeheugen beheert. Het aanmaken van concrete instanties gebeurt vermoedelijk via bovenliggende fabrieks- of providermethoden, aangezien de interface fungeert als een zuiver abstracte basisklasse. Vraag Q-5c3b13bb35c3ff53 (open)

Levenscyclus

Het resource- en eigendomsmodel van ara::crypto::cryp::WriteableKeySlot voorkomt strikt het dupliceren van sleutelreferenties via waardesemantiek. Daartoe zijn zowel de copy-constructor [SWS_CRYPT_50170] als de move-constructor [SWS_CRYPT_50171] expliciet verwijderd (=delete). Evenzo verhinderen de verwijderde declaraties van de copy-toekenningsoperator [SWS_CRYPT_50168] en de move-toekenningsoperator [SWS_CRYPT_50169] elke toekenning achteraf.

De referentiële overdracht en het gedeelde beheer verlopen in plaats daarvan via de gedefinieerde smart pointer-typealias Sptr, die is vormgegeven als std::shared_ptr<WriteableKeySlot> [SWS_CRYPT_50172]. De vernietiging van de instantie wordt beveiligd door een virtuele standaarddestructor, die als uitzonderingsveilig (exception safe) is gespecificeerd en geen uitzonderingen genereert (noexcept=default) [SWS_CRYPT_50167]. Dit maakt de veilige polymorfe vrijgave via pointers naar de interface mogelijk. Qua toestand kan een slot bezet of leeg zijn. Het toewijzen van het slot vindt vermoedelijk plaats via afzonderlijke interfaces van de crypto-provider, terwijl het leegmaken wordt gerealiseerd via de thread-veilige methode Clear() [SWS_CRYPT_30405]. Vraag Q-72dfcb17eb3e2d25 (open)

Toestandsdiagram: Toestandsovergangen van de sleutelinhoud door Clear() en foutafhandeling. Bronnen: [SWS_CRYPT_30405]

Gebruikspad

Het centrale gebruikspad concentreert zich op het gecontroleerd resetten respectievelijk wissen van het opgeslagen sleutelmateriaal:

• Referentiëring: De aanroeper benadert de instantie via een gedeelde pointer van het type WriteableKeySlot::Sptr [SWS_CRYPT_50172].
• Verwijderaanroep: Door het aanroepen van de zuiver virtuele methode Clear() wordt het wisproces voor de huidige inhoud van de sleutelpositie geïnitieerd [SWS_CRYPT_30405]. Omdat de methode thread-veilig is, kan de aanroep ook in concurrente contexten plaatsvinden [SWS_CRYPT_30405].
• Resultaatverificatie: De bewerking levert een ara::core::Result<void> op [SWS_CRYPT_30405]. Was de sleutelpositie al leeg of werd de inhoud foutloos verwijderd, dan representeert het resultaat een succesvolle toestand met een lege waarde [SWS_CRYPT_30405].

Foutscenario's

De methode Clear() is gedeclareerd als uitzonderingsveilig en noexcept; foutsituaties worden volgens het foutmodel van AUTOSAR Adaptive getransporteerd via ara::core::Result [SWS_CRYPT_30405]. Mogelijke foutcodes omvatten:

• ara::crypto::CryptoErrc::kUnsupported: Treedt op wanneer de concrete vorm van de sleutelpositie het wissen niet ondersteunt [SWS_CRYPT_30405]. Voor dit geval garandeert de interface een rollback-semantiek, zodat de toestand ongewijzigd blijft [SWS_CRYPT_30405].
• ara::crypto::CryptoErrc::kBusyResource: Wordt geretourneerd indien de wisbewerking tijdelijk niet kan worden uitgevoerd [SWS_CRYPT_30405]. Dit wordt vermoedelijk typisch veroorzaakt door concurrerende toegangen tot hardwaregebonden geheugenresources. Vraag (open) Ook hier waarborgt een rollback-semantiek dat er geen partiële wijzigingen achterblijven [SWS_CRYPT_30405].