Struct elliptic_curve::ecdh::EphemeralSecret

pub struct EphemeralSecret<C> where
    C: Curve + ProjectiveArithmetic,  { /* private fields */ }

This is supported on crate feature ecdh only.

Ephemeral Diffie-Hellman Secret.

These are ephemeral “secret key” values which are deliberately designed to avoid being persisted.

To perform an ephemeral Diffie-Hellman exchange, do the following:

• Have each participant generate an EphemeralSecret value
• Compute the PublicKey for that value
• Have each peer provide their PublicKey to their counterpart
• Use EphemeralSecret and the other participant’s PublicKey to compute a SharedSecret value.

⚠️ SECURITY WARNING ⚠️

Ephemeral Diffie-Hellman exchanges are unauthenticated and without a further authentication step are trivially vulnerable to man-in-the-middle attacks!

These exchanges should be performed in the context of a protocol which takes further steps to authenticate the peers in a key exchange.

Implementations

impl<C> EphemeralSecret<C> where
    C: Curve + ProjectiveArithmetic, 

pub fn random(rng: impl CryptoRng + RngCore) -> Self

Generate a cryptographically random EphemeralSecret.

pub fn public_key(&self) -> PublicKey<C>

Get the public key associated with this ephemeral secret.

The compress flag enables point compression.

pub fn diffie_hellman(&self, public_key: &PublicKey<C>) -> SharedSecret<C>

Compute a Diffie-Hellman shared secret from an ephemeral secret and the public key of the other participant in the exchange.

Trait Implementations

impl<C> Drop for EphemeralSecret<C> where
    C: Curve + ProjectiveArithmetic, 

fn drop(&mut self)

Executes the destructor for this type.

impl<C> From<&'_ EphemeralSecret<C>> for PublicKey<C> where
    C: Curve + ProjectiveArithmetic, 

fn from(ephemeral_secret: &EphemeralSecret<C>) -> Self

Performs the conversion.

impl<C> Zeroize for EphemeralSecret<C> where
    C: Curve + ProjectiveArithmetic, 

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.

impl<C> ZeroizeOnDrop for EphemeralSecret<C> where
    C: Curve + ProjectiveArithmetic,