pub struct HttpsConnectorBuilder<State>(/* private fields */);
Expand description
A builder for an HttpsConnector
This makes configuration flexible and explicit and ensures connector features match crate features
§Examples
use hyper_rustls::HttpsConnectorBuilder;
let https = HttpsConnectorBuilder::new()
.with_webpki_roots()
.https_only()
.enable_http1()
.build();
Implementations§
Source§impl ConnectorBuilder<WantsTlsConfig>
impl ConnectorBuilder<WantsTlsConfig>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates a new ConnectorBuilder
Sourcepub fn with_tls_config(
self,
config: ClientConfig,
) -> ConnectorBuilder<WantsSchemes>
pub fn with_tls_config( self, config: ClientConfig, ) -> ConnectorBuilder<WantsSchemes>
Passes a rustls ClientConfig
to configure the TLS connection
The alpn_protocols
field is
required to be empty (or the function will panic) and will be
rewritten to match the enabled schemes (see
enable_http1
,
enable_http2
) before the
connector is built.
Sourcepub fn with_native_roots(self) -> Result<ConnectorBuilder<WantsSchemes>>
Available on (crate features ring
or aws-lc-rs
) and crate feature rustls-native-certs
only.
pub fn with_native_roots(self) -> Result<ConnectorBuilder<WantsSchemes>>
ring
or aws-lc-rs
) and crate feature rustls-native-certs
only.Shorthand for using rustls’ default crypto provider and safe defaults, with native roots.
Sourcepub fn with_provider_and_native_roots(
self,
provider: impl Into<Arc<CryptoProvider>>,
) -> Result<ConnectorBuilder<WantsSchemes>>
Available on crate feature rustls-native-certs
only.
pub fn with_provider_and_native_roots( self, provider: impl Into<Arc<CryptoProvider>>, ) -> Result<ConnectorBuilder<WantsSchemes>>
rustls-native-certs
only.Shorthand for using a custom CryptoProvider
and native roots
Source§impl ConnectorBuilder<WantsSchemes>
impl ConnectorBuilder<WantsSchemes>
Sourcepub fn https_only(self) -> ConnectorBuilder<WantsProtocols1>
pub fn https_only(self) -> ConnectorBuilder<WantsProtocols1>
Enforce the use of HTTPS when connecting
Only URLs using the HTTPS scheme will be connectable.
Sourcepub fn https_or_http(self) -> ConnectorBuilder<WantsProtocols1>
pub fn https_or_http(self) -> ConnectorBuilder<WantsProtocols1>
Allow both HTTPS and HTTP when connecting
HTTPS URLs will be handled through rustls, HTTP URLs will be handled by the lower-level connector.
Source§impl ConnectorBuilder<WantsProtocols1>
impl ConnectorBuilder<WantsProtocols1>
Sourcepub fn enable_http1(self) -> ConnectorBuilder<WantsProtocols2>
Available on crate feature http1
only.
pub fn enable_http1(self) -> ConnectorBuilder<WantsProtocols2>
http1
only.Enable HTTP1
This needs to be called explicitly, no protocol is enabled by default
Sourcepub fn with_server_name_resolver(
self,
resolver: impl ResolveServerName + 'static + Sync + Send,
) -> Self
pub fn with_server_name_resolver( self, resolver: impl ResolveServerName + 'static + Sync + Send, ) -> Self
Override server name for the TLS stack
By default, for each connection hyper-rustls will extract host portion of the destination URL and verify that server certificate contains this value.
If this method is called, hyper-rustls will instead use this resolver to compute the value used to verify the server certificate.
Sourcepub fn with_server_name(self, override_server_name: String) -> Self
👎Deprecated since 0.27.1: use Self::with_server_name_resolver with FixedServerNameResolver instead
pub fn with_server_name(self, override_server_name: String) -> Self
Override server name for the TLS stack
By default, for each connection hyper-rustls will extract host portion of the destination URL and verify that server certificate contains this value.
If this method is called, hyper-rustls will instead verify that server
certificate contains override_server_name
. Domain name included in
the URL will not affect certificate validation.
Source§impl ConnectorBuilder<WantsProtocols2>
impl ConnectorBuilder<WantsProtocols2>
Sourcepub fn build(self) -> HttpsConnector<HttpConnector>
pub fn build(self) -> HttpsConnector<HttpConnector>
This builds an HttpsConnector
built on hyper’s default HttpConnector
Sourcepub fn wrap_connector<H>(self, conn: H) -> HttpsConnector<H>
pub fn wrap_connector<H>(self, conn: H) -> HttpsConnector<H>
This wraps an arbitrary low-level connector into an HttpsConnector
Trait Implementations§
Source§impl Default for ConnectorBuilder<WantsTlsConfig>
impl Default for ConnectorBuilder<WantsTlsConfig>
Auto Trait Implementations§
impl<State> Freeze for ConnectorBuilder<State>where
State: Freeze,
impl<State> RefUnwindSafe for ConnectorBuilder<State>where
State: RefUnwindSafe,
impl<State> Send for ConnectorBuilder<State>where
State: Send,
impl<State> Sync for ConnectorBuilder<State>where
State: Sync,
impl<State> Unpin for ConnectorBuilder<State>where
State: Unpin,
impl<State> UnwindSafe for ConnectorBuilder<State>where
State: UnwindSafe,
Blanket Implementations§
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> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
Source§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
Source§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Layout§
Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.