Struct elliptic_curve::ecdh::EphemeralSecret

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

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

Converts to this type from the input type.

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,