Trait Builder 

pub trait Builder: Sized {
    type Output;

    // Required methods
    fn assemble<S>(
        self,
        signature: BitString,
        signer: &S,
    ) -> Result<Self::Output, Error>
       where S: Keypair + DynSignatureAlgorithmIdentifier,
             <S as Keypair>::VerifyingKey: EncodePublicKey;
    fn finalize<S>(&mut self, signer: &S) -> Result<Vec<u8>, Error>
       where S: Keypair + DynSignatureAlgorithmIdentifier,
             <S as Keypair>::VerifyingKey: EncodePublicKey;

    // Provided methods
    fn build<S, Signature>(self, signer: &S) -> Result<Self::Output, Error>
       where S: Signer<Signature> + Keypair + DynSignatureAlgorithmIdentifier,
             <S as Keypair>::VerifyingKey: EncodePublicKey,
             Signature: SignatureBitStringEncoding { ... }
    fn build_with_rng<S, Signature, R>(
        self,
        signer: &S,
        rng: &mut R,
    ) -> Result<Self::Output, Error>
       where S: RandomizedSigner<Signature> + Keypair + DynSignatureAlgorithmIdentifier,
             <S as Keypair>::VerifyingKey: EncodePublicKey,
             Signature: SignatureBitStringEncoding,
             R: CryptoRng + ?Sized { ... }
}

Trait for X509 builders

This trait defines the interface between builder and the signers.

Required Associated Types

type Output

Type built by this builder

Required Methods

fn assemble<S>( self, signature: BitString, signer: &S, ) -> Result<Self::Output, Error>

where S: Keypair + DynSignatureAlgorithmIdentifier, <S as Keypair>::VerifyingKey: EncodePublicKey,

Assemble the final object from signature.

fn finalize<S>(&mut self, signer: &S) -> Result<Vec<u8>, Error>

where S: Keypair + DynSignatureAlgorithmIdentifier, <S as Keypair>::VerifyingKey: EncodePublicKey,

Finalize and return a serialization of the object for signature.

Provided Methods

fn build<S, Signature>(self, signer: &S) -> Result<Self::Output, Error>

where S: Signer<Signature> + Keypair + DynSignatureAlgorithmIdentifier, <S as Keypair>::VerifyingKey: EncodePublicKey, Signature: SignatureBitStringEncoding,

Run the object through the signer and build it.

Notes

When using ECDSA signers, the Signature parameter will need to be explicit as multiple implementation of signature::Signer with various signature are available.

This would look like:

let certificate = builder.build::<_, ecdsa::der::Signature<_>>(&signer).unwrap();

fn build_with_rng<S, Signature, R>( self, signer: &S, rng: &mut R, ) -> Result<Self::Output, Error>

where S: RandomizedSigner<Signature> + Keypair + DynSignatureAlgorithmIdentifier, <S as Keypair>::VerifyingKey: EncodePublicKey, Signature: SignatureBitStringEncoding, R: CryptoRng + ?Sized,

Run the object through the signer and build it.

Notes

When using ECDSA signers, the Signature parameter will need to be explicit as multiple implementation of signature::Signer with various signature are available.

This would look like:

let certificate = builder.build_with_rng::<_, ecdsa::der::Signature<_>, _>(
    &signer,
    &mut rng
).unwrap();

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl Builder for RequestBuilder

type Output = CertReq

impl<P> Builder for CertificateBuilder<P>

where P: BuilderProfile,

type Output = CertificateInner

impl<P> Builder for CrlBuilder<P>

where P: Profile,

type Output = CertificateList<P>