Struct Dsa
pub struct Dsa<T>(/* private fields */);
Expand description
Object representing DSA keys.
A DSA object contains the parameters p, q, and g. There is a private and public key. The values p, g, and q are:
p
: DSA prime parameterq
: DSA sub-prime parameterg
: DSA base parameter
These values are used to calculate a pair of asymetrical keys used for signing.
OpenSSL documentation at DSA_new
§Examples
use rama_boring::dsa::Dsa;
use rama_boring::error::ErrorStack;
use rama_boring::pkey::Private;
fn create_dsa() -> Result<Dsa<Private>, ErrorStack> {
let sign = Dsa::generate(2048)?;
Ok(sign)
}
Implementations§
§impl Dsa<Private>
impl Dsa<Private>
pub fn generate(bits: u32) -> Result<Dsa<Private>, ErrorStack>
pub fn generate(bits: u32) -> Result<Dsa<Private>, ErrorStack>
Generate a DSA key pair.
Calls DSA_generate_parameters_ex
to populate the p
, g
, and q
values.
These values are used to generate the key pair with DSA_generate_key
.
The bits
parameter corresponds to the length of the prime p
.
pub fn from_private_components(
p: BigNum,
q: BigNum,
g: BigNum,
priv_key: BigNum,
pub_key: BigNum,
) -> Result<Dsa<Private>, ErrorStack>
pub fn from_private_components( p: BigNum, q: BigNum, g: BigNum, priv_key: BigNum, pub_key: BigNum, ) -> Result<Dsa<Private>, ErrorStack>
Create a DSA key pair with the given parameters
p
, q
and g
are the common parameters.
priv_key
is the private component of the key pair.
pub_key
is the public component of the key. Can be computed via g^(priv_key) mod p
§impl Dsa<Public>
impl Dsa<Public>
pub fn public_key_from_pem(pem: &[u8]) -> Result<Dsa<Public>, ErrorStack>
pub fn public_key_from_pem(pem: &[u8]) -> Result<Dsa<Public>, ErrorStack>
Decodes a PEM-encoded SubjectPublicKeyInfo structure containing a DSA key.
The input should have a header of -----BEGIN PUBLIC KEY-----
.
This corresponds to PEM_read_bio_DSA_PUBKEY
.
pub fn public_key_from_der(der: &[u8]) -> Result<Dsa<Public>, ErrorStack>
pub fn public_key_from_der(der: &[u8]) -> Result<Dsa<Public>, ErrorStack>
Decodes a DER-encoded SubjectPublicKeyInfo structure containing a DSA key.
This corresponds to d2i_DSA_PUBKEY
.
pub fn from_public_components(
p: BigNum,
q: BigNum,
g: BigNum,
pub_key: BigNum,
) -> Result<Dsa<Public>, ErrorStack>
pub fn from_public_components( p: BigNum, q: BigNum, g: BigNum, pub_key: BigNum, ) -> Result<Dsa<Public>, ErrorStack>
Create a new DSA key with only public components.
p
, q
and g
are the common parameters.
pub_key
is the public component of the key.
Methods from Deref<Target = DsaRef<T>>§
pub fn public_key_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
pub fn public_key_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
Serialies the public key into a PEM-encoded SubjectPublicKeyInfo structure.
The output will have a header of -----BEGIN PUBLIC KEY-----
.
This corresponds to PEM_write_bio_DSA_PUBKEY
.
pub fn public_key_to_der(&self) -> Result<Vec<u8>, ErrorStack>
pub fn public_key_to_der(&self) -> Result<Vec<u8>, ErrorStack>
Serializes the public key into a DER-encoded SubjectPublicKeyInfo structure.
This corresponds to i2d_DSA_PUBKEY
.
pub fn private_key_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
pub fn private_key_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
Serializes the private key to a PEM-encoded DSAPrivateKey structure.
The output will have a header of -----BEGIN DSA PRIVATE KEY-----
.
This corresponds to PEM_write_bio_DSAPrivateKey
.
pub fn private_key_to_pem_passphrase(
&self,
cipher: Cipher,
passphrase: &[u8],
) -> Result<Vec<u8>, ErrorStack>
pub fn private_key_to_pem_passphrase( &self, cipher: Cipher, passphrase: &[u8], ) -> Result<Vec<u8>, ErrorStack>
Serializes the private key to a PEM-encoded encrypted DSAPrivateKey structure.
The output will have a header of -----BEGIN DSA PRIVATE KEY-----
.
This corresponds to PEM_write_bio_DSAPrivateKey
.
Trait Implementations§
§impl<T> ForeignType for Dsa<T>
impl<T> ForeignType for Dsa<T>
impl<T> Send for Dsa<T>
impl<T> Sync for Dsa<T>
Auto Trait Implementations§
impl<T> Freeze for Dsa<T>
impl<T> RefUnwindSafe for Dsa<T>where
T: RefUnwindSafe,
impl<T> Unpin for Dsa<T>where
T: Unpin,
impl<T> UnwindSafe for Dsa<T>where
T: UnwindSafe,
Blanket Implementations§
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
§fn with_current_context(self) -> WithContext<Self> ⓘ
fn with_current_context(self) -> WithContext<Self> ⓘ
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
§fn and<P, B, E>(self, other: P) -> And<T, P>
fn and<P, B, E>(self, other: P) -> And<T, P>
Policy
that returns Action::Follow
only if self
and other
return
Action::Follow
. Read more