pub struct KeyEncryptionKey;Expand description
A key-encryption-key (KEK): a key that can be used to encrypt other keys, and shared between users. It MAY be re-used for multiple encrypt operations.
New KEKs are XAES-256-GCM keys (see KeyEncryptionKey::make). AES-256-CBC-HMAC keys are also
accepted as KEKs, so that existing (V1) keys that act as KEKs, such as user keys and cipher
keys, can adopt safe objects before they are rotated. AES-256-CBC-HMAC uses a random 128-bit IV,
so it does not have the nonce-reuse problem that rules out plain AES-256-GCM for a reused key.
See the key_hierarchy module documentation for its place in the key hierarchy.
Implementations§
Source§impl KeyEncryptionKey
impl KeyEncryptionKey
Sourcepub fn make<Ids: KeySlotIds>(
ctx: &mut KeyStoreContext<'_, Ids>,
) -> Ids::Symmetric
pub fn make<Ids: KeySlotIds>( ctx: &mut KeyStoreContext<'_, Ids>, ) -> Ids::Symmetric
Generates a fresh key-encryption-key, stores it in the key store context, and returns its key id. Key material never leaves the key store.
Sourcepub(crate) fn get_cose_key_view<'k, Ids: KeySlotIds>(
ctx: &'k KeyStoreContext<'_, Ids>,
key_id: Ids::Symmetric,
) -> Result<CoseKeyView<'k>, KeyEncryptionKeyError>
pub(crate) fn get_cose_key_view<'k, Ids: KeySlotIds>( ctx: &'k KeyStoreContext<'_, Ids>, key_id: Ids::Symmetric, ) -> Result<CoseKeyView<'k>, KeyEncryptionKeyError>
Looks up the symmetric key key_id refers to and returns a CoseKeyView of it, if it is
an XAES-256-GCM or AES-256-CBC-HMAC key, the algorithms accepted for a KeyEncryptionKey.
Auto Trait Implementations§
impl Freeze for KeyEncryptionKey
impl RefUnwindSafe for KeyEncryptionKey
impl Send for KeyEncryptionKey
impl Sync for KeyEncryptionKey
impl Unpin for KeyEncryptionKey
impl UnsafeUnpin for KeyEncryptionKey
impl UnwindSafe for KeyEncryptionKey
Blanket Implementations§
§impl<T> AnySync for T
impl<T> AnySync for T
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
§impl<T> CompatExt for T
impl<T> CompatExt for T
§impl<T, UT> HandleAlloc<UT> for T
impl<T, UT> HandleAlloc<UT> for T
§fn new_handle(value: Arc<T>) -> Handle
fn new_handle(value: Arc<T>) -> Handle
§unsafe fn clone_handle(handle: Handle) -> Handle
unsafe fn clone_handle(handle: Handle) -> Handle
§unsafe fn consume_handle(handle: Handle) -> Arc<T> ⓘ
unsafe fn consume_handle(handle: Handle) -> Arc<T> ⓘ
Arc<> Read more§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more