klasse ara::crypto::cryp::KeyEncapsulatorPublicCtx

De synchrone methode Encapsulate kapselt een meegegeven symmetrische sleutel (key) in en schrijft het resultaat naar de uitvoerbuffer encapsulatedKey [SWS_CRYPT_21813]. Bij een succesvolle uitvoering levert zij via ara::core::Result<std::size_t> de bytegrootte van de ingekapselde sleutel terug [SWS_CRYPT_21813].

In geval van een fout wordt een overeenkomstige foutcode met rollback-semantiek teruggegeven [SWS_CRYPT_21813]. Relevante foutoorzaken zijn:

• UninitializedContext: De context is niet geïnitialiseerd met een publiekesleutelwaarde [SWS_CRYPT_21813].
• ara::crypto::CryptoErrc::kUsageViolation: De inkapselingssleutel mist de gebruiksvlag kAllowKeyWrapping of de in te kapselen sleutel mist kAllowSecuredExport [SWS_CRYPT_21813].
• ara::crypto::CryptoErrc::kIncompatibleObject of CryptoErrc::kInvalidInputSize: Het sleutelobject is incompatibel of de sleutelgrootte wordt niet ondersteund door de context [SWS_CRYPT_21813].
• CryptoErrc::kUnsupported: De context ondersteunt het inkapselen van verstrekte sleutels niet, omdat deze ze tijdens de inkapseling zelf genereert [SWS_CRYPT_21813].
• ara::crypto::CryptoErrc::kInsufficientCapacity: De buffer encapsulatedKey is te klein gedimensioneerd [SWS_CRYPT_21813].
• ara::crypto::CryptoErrc::kBusyResource of ara::crypto::CryptoErrc::kEmptyKeySlot: Een resource is bezet of een geconfigureerde KeySlot is leeg [SWS_CRYPT_21813].

De bewerking is gedeclareerd als const, noexcept en gespecificeerd als thread-safe en exception safe [SWS_CRYPT_21813].

In samenspel met de module verschilt deze functie van de alternatieve overbelasting [SWS_CRYPT_50011], die geen bestaande sleutel accepteert, maar de symmetrische sleutel dynamisch opnieuw genereert en samen met het inkapselingsresultaat retourneert [SWS_CRYPT_50011].

Gebruik en semantiek

De synchrone methode Encapsulate genereert intern een nieuwe symmetrische sleutel en kapselt deze in met gebruik van de context [SWS_CRYPT_50011]. Als invoerparameters worden het doelalgoritme algId evenals de toegestane gebruiksvlaggen allowedUsage voor de gegenereerde sleutel opgegeven [SWS_CRYPT_50011]. Het cijfer van de sleutel wordt in de uitvoerbuffer encapsulatedKey geschreven [SWS_CRYPT_50011]. De retourwaarde kapselt bij succes een paar bestaande uit de werkelijke bytegrootte van de ingekapselde sleutel en een smart pointer naar het gegenereerde sleutelobject (std::pair<std::size_t, SymmetricKey::Sptr>) binnen een ara::core::Result in [SWS_CRYPT_50011].

Foutafhandeling en beveiliging

In geval van een fout bezitten de retourwaarden overwegend rollback-semantiek [SWS_CRYPT_50011]. Mogelijke foutoorzaken omvatten:

• UninitializedContext: De context is vooraf niet met een publieke sleutel geïnitialiseerd [SWS_CRYPT_50011].
• CryptoErrc::kUsageViolation: De inkapselingssleutel ontbreekt de vlag kAllowKeyWrapping of de doelsleutel ontbreekt kAllowSecuredExport [SWS_CRYPT_50011].
• CryptoErrc::kInsufficientCapacity: De uitvoerbuffer encapsulatedKey biedt niet voldoende capaciteit [SWS_CRYPT_50011].
• CryptoErrc::kUnknownIdentifier of CryptoErrc::kUnsupported: De algId is onbekend of het genereren tijdens het inkapselen wordt niet ondersteund [SWS_CRYPT_50011].
• CryptoErrc::kEmptyKeySlot of CryptoErrc::kBusyResource: Een geconfigureerde KeySlot is leeg of een benodigde resource is bezet [SWS_CRYPT_50011].

Gelijktijdigheid en wisselwerking

De bewerking is gespecificeerd als const, noexcept, thread-safe evenals exception-safe [SWS_CRYPT_50011]. In vergelijking met de overbelasting [SWS_CRYPT_21813], waaraan een bestaande sleutel wordt doorgegeven en die alleen de grootte daarvan retourneert, voert deze methode de sleutelgeneratie en inkapseling in één gezamenlijke stap uit [SWS_CRYPT_50011].

Gebruik

De methode SetKey configureert de instantie van ara::crypto::cryp::KeyEncapsulatorPublicCtx zodanig dat het overgedragen sleutelobject wordt gebruikt als inkapselsleutel [SWS_CRYPT_21815]. Als parameter dient key van het type PublicKey::Sptr [SWS_CRYPT_21815]. De aanroep verloopt synchroon en levert als retourwaarde een ara::core::Result<void> op, die bij succes leeg is of een foutcode transporteert [SWS_CRYPT_21815].

Foutafhandeling

In geval van een fout bezitten alle gemelde foutcodes rollback-semantiek [SWS_CRYPT_21815]:

• ara::crypto::CryptoErrc::kIncompatibleObject: het beschikbaar gestelde sleutelobject is incompatibel met de context [SWS_CRYPT_21815].
• ara::crypto::CryptoErrc::kUsageViolation: het toegestane gebruik van de sleutel bevat niet de vlag kAllowKeyWrapping [SWS_CRYPT_21815].
• ara::crypto::CryptoErrc::kUnsupported: de context ondersteunt uitsluitend het instellen van een sleutel via een KeySlot [SWS_CRYPT_21815].

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als thread-safe en exception safe met noexcept-garantie [SWS_CRYPT_21815].

Samenspel

Door de configuratie van de sleutel wordt de context voorbereid op de sleutelinkapseling, die via de methode Encapsulate wordt uitgevoerd [SWS_CRYPT_50011]. Indien de context de directe sleuteltoewijzing niet ondersteunt of de sleutel moet worden verkregen uit een geheugengebied, is als alternatief de overbelasting van SetKey met een KeySlot::Sptr beschikbaar [SWS_CRYPT_50012].

De methode SetKey van de klasse ara::crypto::cryp::KeyEncapsulatorPublicCtx configureert de context zodanig dat de in een doorgegeven sleutelslot (KeySlot) opgeslagen openbare sleutel wordt gebruikt op het moment van sleutelkapseling [SWS_CRYPT_50012].

Gebruik

De aanroep vindt synchroon plaats en is gespecificeerd als noexcept en exception safe [SWS_CRYPT_50012]. Als parameter dient keySlot van het type KeySlot::Sptr, die een openbare sleutel moet bevatten [SWS_CRYPT_50012]. De retourwaarde is een ara::core::Result<void>, die bij succes geen waarde bevat [SWS_CRYPT_50012].

Foutafhandeling

In geval van een fout wordt een foutcode met rollback-semantiek geretourneerd [SWS_CRYPT_50012]:

• ara::crypto::CryptoErrc::kIncompatibleObject: De doorgegeven keySlot is incompatibel met deze context [SWS_CRYPT_50012].
• ara::crypto::CryptoErrc::kUnsupported: de context ondersteunt uitsluitend het instellen van een PublicKey-object [SWS_CRYPT_50012].

Gelijktijdigheid en wisselwerking

De functie is gedefinieerd als thread-safe [SWS_CRYPT_50012]. Naast de toewijzing via een sleutelslot bestaat er een alternatieve overload voor het direct doorgeven van een PublicKey::Sptr [SWS_CRYPT_21815]. De geconfigureerde sleutel wordt toegepast zodra de sleutelkapseling via Encapsulate [SWS_CRYPT_50011] wordt uitgevoerd. Wat betreft de volgorde moet SetKey vermoedelijk vóór de aanroep van Encapsulate worden uitgevoerd, zodat de context is geïnitialiseerd. Vraag Q-769923d4fb9a3d1e (open)