pub enum CryptographicKeyContext {
OpenPgp {
user_ids: OpenPgpUserIdList,
version: OpenPgpVersion,
},
Raw,
}
Expand description
The cryptographic context in which a key is used
Each key can only be used in one cryptographic context. This is because the NetHSM offers only a single certificate slot per key, which can be used to attach certificates for a specific cryptographic use.
Variants§
OpenPgp
A key is used in an OpenPGP context
Fields
§
user_ids: OpenPgpUserIdList
List of OpenPGP User IDs for the certificate.
§
version: OpenPgpVersion
OpenPGP version for the certificate.
Raw
A key is used in a raw cryptographic context
Implementations§
Source§impl CryptographicKeyContext
impl CryptographicKeyContext
Sourcepub fn validate_signing_key_setup(
&self,
key_type: KeyType,
key_mechanisms: &[KeyMechanism],
signature_type: SignatureType,
) -> Result<(), Error>
pub fn validate_signing_key_setup( &self, key_type: KeyType, key_mechanisms: &[KeyMechanism], signature_type: SignatureType, ) -> Result<(), Error>
Validates the cryptographic context against a signing key setup
§Errors
Returns an Error::Key
if the key setup can not be used for signing
operations in the respective cryptographic context.
§Examples
use nethsm::{
CryptographicKeyContext,
KeyMechanism,
KeyType,
OpenPgpUserIdList,
OpenPgpVersion,
SignatureType,
};
CryptographicKeyContext::Raw.validate_signing_key_setup(
KeyType::Curve25519,
&[KeyMechanism::EdDsaSignature],
SignatureType::EdDsa,
)?;
CryptographicKeyContext::OpenPgp {
user_ids: OpenPgpUserIdList::new(vec!["Foobar McFooface <foobar@mcfooface.org>".parse()?])?,
version: OpenPgpVersion::V4,
}
.validate_signing_key_setup(
KeyType::Curve25519,
&[KeyMechanism::EdDsaSignature],
SignatureType::EdDsa,
)?;
// OpenPGP does not support ECDSA P224
assert!(
CryptographicKeyContext::OpenPgp {
user_ids: OpenPgpUserIdList::new(vec![
"Foobar McFooface <foobar@mcfooface.org>".parse()?
])?,
version: OpenPgpVersion::V4,
}
.validate_signing_key_setup(
KeyType::EcP224,
&[KeyMechanism::EcdsaSignature],
SignatureType::EcdsaP224,
)
.is_err()
);
Trait Implementations§
Source§impl Clone for CryptographicKeyContext
impl Clone for CryptographicKeyContext
Source§fn clone(&self) -> CryptographicKeyContext
fn clone(&self) -> CryptographicKeyContext
Returns a copy of the value. Read more
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moreSource§impl Debug for CryptographicKeyContext
impl Debug for CryptographicKeyContext
Source§impl<'de> Deserialize<'de> for CryptographicKeyContext
impl<'de> Deserialize<'de> for CryptographicKeyContext
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
Source§impl Display for CryptographicKeyContext
impl Display for CryptographicKeyContext
Source§impl Hash for CryptographicKeyContext
impl Hash for CryptographicKeyContext
Source§impl PartialEq for CryptographicKeyContext
impl PartialEq for CryptographicKeyContext
Source§impl Serialize for CryptographicKeyContext
impl Serialize for CryptographicKeyContext
Source§impl TryFrom<SignedPublicKey> for CryptographicKeyContext
impl TryFrom<SignedPublicKey> for CryptographicKeyContext
Source§fn try_from(value: SignedPublicKey) -> Result<Self, Self::Error>
fn try_from(value: SignedPublicKey) -> Result<Self, Self::Error>
Creates a CryptographicKeyContext
from [SignedPublicKey
].
Drops any invalid OpenPGP User ID (e.g. non-UTF-8).
§Errors
Returns an error if
- duplicate OpenPGP User IDs are encountered in
value
, - or no valid OpenPGP version can be derived from the OpenPGP primary key in
value
.
impl Eq for CryptographicKeyContext
impl StructuralPartialEq for CryptographicKeyContext
Auto Trait Implementations§
impl Freeze for CryptographicKeyContext
impl RefUnwindSafe for CryptographicKeyContext
impl Send for CryptographicKeyContext
impl Sync for CryptographicKeyContext
impl Unpin for CryptographicKeyContext
impl UnwindSafe for CryptographicKeyContext
Blanket Implementations§
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
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
Causes
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
Causes
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
Causes
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
Causes
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
Causes
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
Causes
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
Causes
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
Causes
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
Formats each item in a sequence. Read more
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Pipes by value. This is generally the method you want to use. Read more
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
Borrows
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
Mutably borrows
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
Borrows
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
Mutably borrows
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
Borrows
self
, then passes self.deref()
into the pipe function.§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Immutable access to the
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
Mutable access to the
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
Immutable access to the
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
Mutable access to the
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Immutable access to the
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Mutable access to the
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
Calls
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
Calls
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
Calls
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
Calls
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
Calls
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
Calls
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
Calls
.tap_deref()
only in debug builds, and is erased in release
builds.