Struct CertIssuerHttpClient

pub struct CertIssuerHttpClient { /* private fields */ }

An http client used to fetch certs dynamically (DynamicCertIssuer).

There is no server implementation in Rama. It is up to the user of this client to provide their own server.

Implementations

impl CertIssuerHttpClient

pub fn new(endpoint: Uri) -> Self

Create a new CertIssuerHttpClient using the default EasyHttpWebClient.

pub fn try_from_env() -> Result<Self, OpaqueError>

pub fn new_with_client( endpoint: Uri, client: BoxService<Request, Response, OpaqueError>, ) -> Self

Create a new CertIssuerHttpClient using a custom http client.

The custom http client allows you to add whatever layers and client implementation you wish, to allow for custom headers, behaviour and security measures such as authorization.

pub fn with_allow_domain(self, domain: impl AsDomainRef) -> Self

Only allow fetching certs for the given domain.

By default, if none of the allow_* setters are called the client will fetch for any client.

pub fn set_allow_domain(&mut self, domain: impl AsDomainRef) -> &mut Self

Only allow fetching certs for the given domain.

By default, if none of the allow_* setters are called the client will fetch for any client.

pub fn with_allow_domains( self, domains: impl IntoIterator<Item: AsDomainRef>, ) -> Self

Only allow fetching certs for the given domains.

By default, if none of the allow_* setters are called the client will fetch for any client.

pub fn set_allow_domains( &mut self, domains: impl IntoIterator<Item: AsDomainRef>, ) -> &mut Self

Only allow fetching certs for the given domains.

By default, if none of the allow_* setters are called the client will fetch for any client.

pub fn prefetch_certs_in_background(&self, exec: &Executor)

Prefetch all certificates, useful to warm them up at startup time.

Trait Implementations

impl Debug for CertIssuerHttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DynamicCertIssuer for CertIssuerHttpClient

fn issue_cert( &self, client_hello: ClientHello, _server_name: Option<Domain>, ) -> impl Future<Output = Result<ServerAuthData, OpaqueError>> + Send + Sync + '_

fn norm_cn(&self, domain: &Domain) -> Option<&Domain>

Can be used to return a normalized domain for purposes such as caching.