pub struct Dh<T>(/* private fields */);
Implementations§
source§impl Dh<Params>
impl Dh<Params>
pub fn from_params( p: BigNum, g: BigNum, q: BigNum, ) -> Result<Dh<Params>, ErrorStack>
sourcepub fn from_pqg(
prime_p: BigNum,
prime_q: Option<BigNum>,
generator: BigNum,
) -> Result<Dh<Params>, ErrorStack>
pub fn from_pqg( prime_p: BigNum, prime_q: Option<BigNum>, generator: BigNum, ) -> Result<Dh<Params>, ErrorStack>
Creates a DH instance based upon the given primes and generator params.
This corresponds to DH_set0_pqg
.
sourcepub fn set_public_key(self, pub_key: BigNum) -> Result<Dh<Public>, ErrorStack>
pub fn set_public_key(self, pub_key: BigNum) -> Result<Dh<Public>, ErrorStack>
Sets the public key on the DH object.
sourcepub fn set_private_key(
self,
priv_key: BigNum,
) -> Result<Dh<Private>, ErrorStack>
pub fn set_private_key( self, priv_key: BigNum, ) -> Result<Dh<Private>, ErrorStack>
Sets the private key on the DH object and recomputes the public key.
sourcepub fn set_key(
self,
pub_key: BigNum,
priv_key: BigNum,
) -> Result<Dh<Private>, ErrorStack>
pub fn set_key( self, pub_key: BigNum, priv_key: BigNum, ) -> Result<Dh<Private>, ErrorStack>
Sets the public and private keys on the DH object.
sourcepub fn generate_params(
prime_len: u32,
generator: u32,
) -> Result<Dh<Params>, ErrorStack>
pub fn generate_params( prime_len: u32, generator: u32, ) -> Result<Dh<Params>, ErrorStack>
Generates DH params based on the given prime_len
and a fixed generator
value.
This corresponds to DH_generate_parameters_ex
.
sourcepub fn generate_key(self) -> Result<Dh<Private>, ErrorStack>
pub fn generate_key(self) -> Result<Dh<Private>, ErrorStack>
Generates a public and a private key based on the DH params.
This corresponds to DH_generate_key
.
sourcepub fn params_from_pem(pem: &[u8]) -> Result<Dh<Params>, ErrorStack>
pub fn params_from_pem(pem: &[u8]) -> Result<Dh<Params>, ErrorStack>
Deserializes a PEM-encoded PKCS#3 DHpararameters structure.
The input should have a header of -----BEGIN DH PARAMETERS-----
.
This corresponds to PEM_read_bio_DHparams
.
sourcepub fn params_from_der(der: &[u8]) -> Result<Dh<Params>, ErrorStack>
pub fn params_from_der(der: &[u8]) -> Result<Dh<Params>, ErrorStack>
Deserializes a DER-encoded PKCS#3 DHparameters structure.
This corresponds to d2i_DHparams
.
sourcepub fn get_1024_160() -> Result<Dh<Params>, ErrorStack>
pub fn get_1024_160() -> Result<Dh<Params>, ErrorStack>
Requires OpenSSL 1.0.2 or newer.
This corresponds to DH_get_1024_160
.
sourcepub fn get_2048_224() -> Result<Dh<Params>, ErrorStack>
pub fn get_2048_224() -> Result<Dh<Params>, ErrorStack>
Requires OpenSSL 1.0.2 or newer.
This corresponds to DH_get_2048_224
.
sourcepub fn get_2048_256() -> Result<Dh<Params>, ErrorStack>
pub fn get_2048_256() -> Result<Dh<Params>, ErrorStack>
Requires OpenSSL 1.0.2 or newer.
This corresponds to DH_get_2048_256
.
source§impl<T> Dh<T>where
T: HasParams,
impl<T> Dh<T>where
T: HasParams,
sourcepub fn prime_p(&self) -> &BigNumRef
pub fn prime_p(&self) -> &BigNumRef
Returns the prime p
from the DH instance.
This corresponds to DH_get0_pqg
.
sourcepub fn prime_q(&self) -> Option<&BigNumRef>
pub fn prime_q(&self) -> Option<&BigNumRef>
Returns the prime q
from the DH instance.
This corresponds to DH_get0_pqg
.
sourcepub fn generator(&self) -> &BigNumRef
pub fn generator(&self) -> &BigNumRef
Returns the generator from the DH instance.
This corresponds to DH_get0_pqg
.
Methods from Deref<Target = DhRef<T>>§
sourcepub fn params_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
pub fn params_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
Serializes the parameters into a PEM-encoded PKCS#3 DHparameter structure.
The output will have a header of -----BEGIN DH PARAMETERS-----
.
This corresponds to PEM_write_bio_DHparams
.
sourcepub fn params_to_der(&self) -> Result<Vec<u8>, ErrorStack>
pub fn params_to_der(&self) -> Result<Vec<u8>, ErrorStack>
Serializes the parameters into a DER-encoded PKCS#3 DHparameter structure.
This corresponds to i2d_DHparams
.
sourcepub fn check_key(&self) -> Result<bool, ErrorStack>
pub fn check_key(&self) -> Result<bool, ErrorStack>
Validates DH parameters for correctness
This corresponds to DH_check_key
.
sourcepub fn public_key(&self) -> &BigNumRef
pub fn public_key(&self) -> &BigNumRef
Returns the public key from the DH instance.
This corresponds to DH_get0_key
.
sourcepub fn compute_key(&self, public_key: &BigNumRef) -> Result<Vec<u8>, ErrorStack>
pub fn compute_key(&self, public_key: &BigNumRef) -> Result<Vec<u8>, ErrorStack>
Computes a shared secret from the own private key and the given public_key
.
This corresponds to DH_compute_key
.
sourcepub fn private_key(&self) -> &BigNumRef
pub fn private_key(&self) -> &BigNumRef
Returns the private key from the DH instance.
This corresponds to DH_get0_key
.