Enum PublicKeyEncryptedSessionKey

pub enum PublicKeyEncryptedSessionKey {
    V3 {
        packet_version: Version,
        id: KeyId,
        pk_algo: PublicKeyAlgorithm,
        values: PkeskBytes,
    },
    V6 {
        packet_version: Version,
        fingerprint: Option<Fingerprint>,
        pk_algo: PublicKeyAlgorithm,
        values: PkeskBytes,
    },
    Other {
        packet_version: Version,
        version: u8,
    },
}

Public Key Encrypted Session Key Packet (PKESK) https://www.rfc-editor.org/rfc/rfc9580.html#name-public-key-encrypted-sessio

A PKESK contains an encrypted session key that has been encrypted to a specific public key. PKESK are used in combination with a symmetric encryption container:

• V3 PKESK are used in combination with version 1 Symmetrically Encrypted and Integrity Protected Data Packets.
• V6 PKESK are used in combination with version 2 Symmetrically Encrypted and Integrity Protected Data Packets.

Variants

V3

Fields

packet_version: Version

id: KeyId

pk_algo: PublicKeyAlgorithm

values: PkeskBytes

V6

Fields

packet_version: Version

fingerprint: Option<Fingerprint>

pk_algo: PublicKeyAlgorithm

values: PkeskBytes

Other

Fields

packet_version: Version

version: u8

Implementations

impl PublicKeyEncryptedSessionKey

pub fn from_slice(version: Version, input: &[u8]) -> Result<Self>

Parses a PublicKeyEncryptedSessionKey packet from the given slice.

pub fn from_session_key_v3<R: CryptoRng + Rng>( rng: R, session_key: &[u8], alg: SymmetricKeyAlgorithm, pkey: &impl PublicKeyTrait, ) -> Result<Self>

Encrypts the given session key to pkey as a v3 pkesk.

pub fn from_session_key_v6<R: CryptoRng + Rng>( rng: R, session_key: &[u8], pkey: &impl PublicKeyTrait, ) -> Result<Self>

Encrypts the given session key to pkey as a v6 pkesk.

pub fn match_identity(&self, pkey: &impl PublicKeyTrait) -> bool

Check if a Key matches with this PKESK’s target

• for v3: is PKESK key id the wildcard, or does it match the key id of pkey?
• for v6: is PKESK fingerprint the wildcard (represented as None), or does it match the fingerprint of pkey?

pub fn id(&self) -> Result<&KeyId>

The Key ID in this PKESK. Only available for v3 PKESK (the function returns an Error for v6 PKESK).

The Key ID may consist of all Zero-Bytes (if the PKESK was created for an anonymous recipient).

See https://www.rfc-editor.org/rfc/rfc9580.html#section-5.1.1-3.2

pub fn fingerprint(&self) -> Result<Option<&Fingerprint>>

The Fingerprint in this PKESK. Only available for v6 PKESK (the function returns an Error for v3 PKESK).

Additionally, the Fingerprint may be None (if the PKESK was created for an anonymous recipient).

See https://www.rfc-editor.org/rfc/rfc9580.html#section-5.1.2-3.2

pub fn values(&self) -> Result<&PkeskBytes>

The raw encrypted session key data inside this PKESK. This data is algorithm specific.

See https://www.rfc-editor.org/rfc/rfc9580.html#name-algorithm-specific-fields-f and the following sections.

pub fn algorithm(&self) -> Result<PublicKeyAlgorithm>

The public key algorithm used in this PKESK.

An error is returned for unsupported PKESK versions (any version except “3” and “6”).

pub fn version(&self) -> PkeskVersion

The version of this PKESK (currently “3” and “6” are expected values)

Trait Implementations

impl Clone for PublicKeyEncryptedSessionKey

fn clone(&self) -> PublicKeyEncryptedSessionKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublicKeyEncryptedSessionKey

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

Formats the value using the given formatter.

impl From<PublicKeyEncryptedSessionKey> for Esk

fn from(other: PublicKeyEncryptedSessionKey) -> Esk

Converts to this type from the input type.

impl From<PublicKeyEncryptedSessionKey> for Packet

fn from(other: PublicKeyEncryptedSessionKey) -> Packet

Converts to this type from the input type.

impl PacketTrait for PublicKeyEncryptedSessionKey

fn packet_version(&self) -> Version

fn tag(&self) -> Tag

impl PartialEq for PublicKeyEncryptedSessionKey

fn eq(&self, other: &PublicKeyEncryptedSessionKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PublicKeyEncryptedSessionKey

fn to_writer<W: Write>(&self, writer: &mut W) -> Result<()>

fn to_bytes(&self) -> Result<Vec<u8>>

impl TryFrom<Esk> for PublicKeyEncryptedSessionKey

type Error = Error

The type returned in the event of a conversion error.

fn try_from(other: Esk) -> Result<PublicKeyEncryptedSessionKey, Self::Error>

Performs the conversion.

impl TryFrom<Packet> for PublicKeyEncryptedSessionKey

type Error = Error

The type returned in the event of a conversion error.

fn try_from(other: Packet) -> Result<PublicKeyEncryptedSessionKey, Self::Error>

Performs the conversion.

impl Eq for PublicKeyEncryptedSessionKey

impl StructuralPartialEq for PublicKeyEncryptedSessionKey