Struct ReqwestClient 

pub struct ReqwestClient { /* private fields */ }

Available on crate feature did-web and crate feature reqwest and (crate features did-jwk or did-key or did-web) only.

An HttpClient over reqwest hardened for fetching DID documents from the public web.

ReqwestClient::new builds a client that:

• speaks HTTPS only, with the platform’s root certificates and rustls;
• follows no redirect, so a document is fetched from the URL its DID maps to and nowhere else;
• resolves host names itself and refuses loopback, private, link-local and other non-public addresses, so a DID cannot point the resolver at internal services;
• stops reading a body over DEFAULT_MAX_BODY bytes;
• times out after DEFAULT_TIMEOUT.

ReqwestClient::from_client wraps a client the application configured itself, keeping only the HTTPS-only rule, the refusal of non-public IP literals and the body limit; the other protections are then the application’s.

Implementations

impl ReqwestClient

pub const DEFAULT_MAX_BODY: usize

The largest body new reads: 1 MiB, far above any DID document.

pub const DEFAULT_TIMEOUT: Duration

The request timeout of new.

pub fn new() -> Result<Self, HttpError>

A hardened client with the defaults above.

Errors

HttpError when the TLS backend cannot be initialized.

pub const fn from_client(client: Client) -> Self

A client over client as the application configured it, still HTTPS-only, refusing non-public IP literals, and reading at most DEFAULT_MAX_BODY bytes of body.

pub const fn with_max_body(self, max_body: usize) -> Self

This client reading at most max_body bytes of body.

pub const fn max_body(&self) -> usize

The body limit.

pub const fn client(&self) -> &Client

The underlying client.

Trait Implementations

impl Clone for ReqwestClient

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ReqwestClient

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

Formats the value using the given formatter.

impl HttpClient for ReqwestClient

fn get<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 Url, ) -> Pin<Box<dyn Future<Output = Result<HttpResponse, HttpError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches url, returning the status and the body of the final response.