Struct RpkKeyDef

pub struct RpkKeyDef<PK: KeyComponent<Rpk>, SK: KeyComponent<Rpk>> { /* private fields */ }

Key definition for a DTLS key consisting of a private and public key component without a signed certificate.

Note on key construction

For maximum compatibility, you should stick to the with_* constructors defined for this type. While in theory you could use an arbitrary combination of key component types for a key definition, those defined using with_* match explicit key types provided in libcoap and should therefore always be supported.

Implementations

impl<PK: KeyComponent<Rpk>, SK: KeyComponent<Rpk>> RpkKeyDef<PK, SK>

pub fn new( public_key: PK, private_key: SK, user_pin: Option<CString>, asn1_private_key_type: Asn1PrivateKeyType, ) -> Self

Creates a new key definition using the given components.

Parameters

• public_key: The public key component of this key.
• private_key: The private key.
• user_pin: The PIN that should be used when unlocking a token (for PKCS11 keys stored on a token, ignored otherwise)
• asn1_private_key_type: The type of the private key (only used for DER/ASN.1 encoded keys).

impl RpkKeyDef<PemMemoryKeyComponent, PemMemoryKeyComponent>

pub fn with_pem_memory( public_key: impl Into<PemMemoryKeyComponent>, private_key: impl Into<PemMemoryKeyComponent>, ) -> Self

Creates a new key definition using PEM-encoded byte sequences in memory as components.

See the documentation of RpkKeyDef::new for more information on the parameters.

impl RpkKeyDef<Pkcs11KeyComponent, Pkcs11KeyComponent>

pub fn with_pkcs11( public_key: impl Into<Pkcs11KeyComponent>, private_key: impl Into<Pkcs11KeyComponent>, user_pin: Option<CString>, ) -> Self

Creates a new key definition using PKCS11 URIs as components.

See the documentation of RpkKeyDef::new for more information on the parameters.

Trait Implementations

impl<PK: Clone + KeyComponent<Rpk>, SK: Clone + KeyComponent<Rpk>> Clone for RpkKeyDef<PK, SK>

fn clone(&self) -> RpkKeyDef<PK, SK>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<PK: Debug + KeyComponent<Rpk>, SK: Debug + KeyComponent<Rpk>> Debug for RpkKeyDef<PK, SK>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<PK: KeyComponent<Rpk>, SK: KeyComponent<Rpk>> KeyDef for RpkKeyDef<PK, SK>

type KeyType = Rpk

The key type of this key definition.