Struct elliptic_curve::ecdh::EphemeralSecret
source · [−]pub struct EphemeralSecret<C> where
C: Curve + ProjectiveArithmetic, { /* private fields */ }
ecdh
only.Expand description
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’sPublicKey
to compute aSharedSecret
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
Generate a cryptographically random EphemeralSecret
.
Get the public key associated with this ephemeral secret.
The compress
flag enables point compression.
Compute a Diffie-Hellman shared secret from an ephemeral secret and the public key of the other participant in the exchange.
Trait Implementations
Performs the conversion.