Struct KeyExchange 

pub struct KeyExchange { /* private fields */ }

Ephemerales DH-Schluesselpaar fuer einen einzelnen Handshake.

Nach derive_shared_secret ist die Instance verbraucht — das EphemeralPrivateKey erlaubt nach API-Design von ring nur einen agree_ephemeral-Call, was PFS (Perfect Forward Secrecy) erzwingt.

Implementations

impl KeyExchange

pub fn new() -> SecurityResult<Self>

Erzeugt ein frisches X25519-Schluesselpaar (Default).

Errors

CryptoFailed wenn die System-RNG nicht verfuegbar ist (z.B. kein /dev/urandom in einem broken-Sandbox-Szenario).

pub fn with_suite(suite: KxSuite) -> SecurityResult<Self>

Erzeugt ein Schluesselpaar fuer die gewaehlte DH-Suite.

Errors

siehe Self::new.

pub fn suite(&self) -> KxSuite

Liefert die aktive DH-Suite.

pub fn public_key(&self) -> &[u8]

Liefert den lokalen Public-Key als Byte-Slice. Laenge ist suite-abhaengig (siehe KxSuite::public_key_len).

pub fn derive_shared_secret( self, remote_public_key: &[u8], ) -> SecurityResult<Vec<u8>>

Leitet das SharedSecret aus dem Remote-Public-Key ab. Verbraucht das lokale ephemerale Key.

Errors

• BadArgument wenn remote_public_key.len() != suite.public_key_len().
• CryptoFailed wenn ring das Agreement ablehnt (z.B. kleiner-Untergruppen-Angriff, Identity-Punkt, Off-Curve-Point).