pub struct Dh<T>(_, _);
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_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 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 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
.