Struct elliptic_curve::ecdh::SharedSecret

pub struct SharedSecret<C: Curve> { /* private fields */ }

This is supported on crate feature ecdh only.

Shared secret value computed via ECDH key agreement.

This value contains the raw serialized x-coordinate of the elliptic curve point computed from a Diffie-Hellman exchange.

⚠️ WARNING: NOT UNIFORMLY RANDOM! ⚠️

This value is not uniformly random and should not be used directly as a cryptographic key for anything which requires that property (e.g. symmetric ciphers).

Instead, the resulting value should be used as input to a Key Derivation Function (KDF) or cryptographic hash function to produce a symmetric key.

Implementations

impl<C: Curve> SharedSecret<C>

pub fn as_bytes(&self) -> &FieldBytes<C>

Shared secret value, serialized as bytes.

As noted in the comments for this struct, this value is non-uniform and should not be used directly as a symmetric encryption key, but instead as input to a KDF (or failing that, a hash function) used to produce a symmetric key.

Trait Implementations

impl<C: Curve> Drop for SharedSecret<C>

fn drop(&mut self)

Executes the destructor for this type.

impl<C: Curve> From<GenericArray<u8, <<C as Curve>::UInt as ArrayEncoding>::ByteSize>> for SharedSecret<C>

fn from(secret_bytes: FieldBytes<C>) -> Self

NOTE: this impl is intended to be used by curve implementations to instantiate a SharedSecret value from their respective AffinePoint type.

Curve implementations should provide the field element representing the affine x-coordinate as secret_bytes.

impl<C: Curve> Zeroize for SharedSecret<C>

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.