klasse ara::crypto::cryp::CryptoContext

De interface dient als gemeenschappelijke basisklasse voor veranderlijke cryptografische contexten die niet vast aan een individueel crypto-object zijn gebonden. Via de puur virtuele methode GetAlgId() maakt zij het thread-safe opvragen van de algoritme-identificatie als ara::core::Result [SWS_CRYPT_20411] mogelijk. Om ongewenste toestandduplicaties te voorkomen, zijn kopieer- en verplaatsingsbewerkingen volledig geblokkeerd [SWS_CRYPT_41003]. Het vrijgeven gebeurt deterministisch en veilig via een virtuele standaarddestructor.

meer ›

Context

De interface ara::crypto::cryp::CryptoContext definieert de fundamentele abstractie voor veranderlijke cryptografische contexten (mutable cryptographic contexts) binnen de cryptomodule van de AUTOSAR Adaptive Platform. In tegenstelling tot statische crypto-objecten is een dergelijke context niet star aan een individueel cryptografisch object gebonden. Deze dient veeleer als gemeenschappelijke basisklasse voor verschillende cryptografische verwerkingscontexten waarvan de interne toestand tijdens het uitvoeren van cryptografische bewerkingen kan veranderen.

Als centraal element van deze basisinterface fungeert de puur virtuele lidfunctie GetAlgId(). Deze stelt interactiepartners in staat om de identificatie van het actueel in de context geconfigureerde cryptografische algoritme op te vragen [SWS_CRYPT_20411]. Concrete cryptografische berekenings- en transformatiecontexten, zoals bijvoorbeeld voor hash-, signatuur- of versleutelingsdiensten, worden in het systeem vermoedelijk afgeleid van CryptoContext om specifieke algoritmefunctionaliteiten beschikbaar te stellen. Vraag Q-203d40209cd355fa (open)

Levenscyclus

De levenscyclus van CryptoContext wordt gekenmerkt door een unieke identiteit en strikte eigendomsverhoudingen. Om ongecontroleerd dupliceren of inconsistente overdrachten van contexttoestanden tijdens compileertijd te voorkomen, zijn semantische kopieeracties volledig verboden. Zowel de kopieerconstructor [SWS_CRYPT_41003] als de kopietoekenningsoperator [SWS_CRYPT_30214] zijn expliciet als verwijderd gedeclareerd (=delete).

Op dezelfde wijze verhindert de interfacedefinitie het verplaatsen van contexten: zowel de verplaatsingsconstructor [SWS_CRYPT_41004] als de verplaatsingstoekenningsoperator [SWS_CRYPT_30215] zijn verwijderd (=delete). Instanties van afgeleide klassen blijven daarom permanent op hun oorspronkelijke geheugenlocatie. De vernietiging en het vrijgeven van resources vindt deterministisch plaats via de virtuele destructor, die is gedefinieerd als default en noexcept [SWS_CRYPT_20401]. Dit waarborgt dat afgeleide contextobjecten veilig en zonder resourcelekken kunnen worden vrijgegeven via pointers naar de basisinterface.

Met betrekking tot concurrency specificeert de eis voor GetAlgId() uitdrukkelijk thread-safety [SWS_CRYPT_20411]. Meerdere threads kunnen zodoende gelijktijdig en zonder externe synchronisatie de algoritme-identificator van dezelfde context uitlezen.

Gebruikspad

Aangezien CryptoContext een puur virtuele interface is, kunnen applicatieontwikkelaars geen directe instanties creëren. Instanties van gespecialiseerde contextklassen zullen typisch via factory-functies of provider-componenten van de cryptostack worden geïnstantieerd en via pointers of referenties aan de aanroeper beschikbaar worden gesteld. Vraag Q-728a7b6dd526eb64 (open) Het typische gebruiksverloop op het niveau van de basisinterface omvat de volgende fasen:

• Beschikbaarstelling: Een aanroeper ontvangt een referentie of een pointer naar een geconfigureerde context van een crypto-provider.
• Algoritmecontrole: Via de aanroep van GetAlgId() wordt de algoritme-identificatie opgevraagd en geëvalueerd [SWS_CRYPT_20411] om te waarborgen dat de context aan de vereiste specificaties voldoet.
• Bewerking en opschoning: Na uitvoering van de algoritmespecifieke bewerkingen via de afgeleide interface wordt de context via de virtuele destructor automatisch vrijgegeven [SWS_CRYPT_20401].

Foutscenario's

Het foutafhandelingsconcept van CryptoContext volgt het algemene foutveilige ontwerp van de AUTOSAR Adaptive Platform en ziet af van C++-excepties. De methode GetAlgId() is gespecificeerd als exceptieveilig (exception safe) en levert haar resultaat terug in een ara::core::Result<ara::crypto::AlgIdString> [SWS_CRYPT_20411]. Treedt bij het bepalen van het algoritme-ID een fout op, dan wordt deze getransporteerd in het foutkanaal van het Result-object.

Volgens de specificatie definieert GetAlgId() geen gestandaardiseerde foutcodes [SWS_CRYPT_20411]. Aanroepers moeten daarom primair controleren of de Result een geldige waarde bevat voordat zij toegang zoeken tot de tekenreeks van het algoritme-ID. Bij het afbreken van het object waarborgt de met noexcept gedeclareerde virtuele destructor dat tijdens de vernietiging geen excepties worden gepropageerd en de opschoning altijd betrouwbaar wordt voltooid [SWS_CRYPT_20401].