Skip to main content

TlsConfig

Struct TlsConfig 

Source
pub struct TlsConfig { /* private fields */ }
Expand description

Immutable shared TLS configuration for a client.

Construct via TlsConfig::builder() or TlsConfig::builder_with_defaults().

Implementations§

Source§

impl TlsConfig

Source

pub fn builder() -> TlsConfigBuilder

Create a builder with secure defaults (verification enabled, native roots preferred, SNI enabled).

Source

pub fn builder_with_defaults() -> TlsConfigBuilder

Create a builder from the default configuration.

This is identical to TlsConfig::builder() and exists for discoverability.

Source

pub fn danger_accept_invalid_certs(self, accept: bool) -> Self

Enable or disable certificate and hostname verification while retaining the rest of this configuration.

Source

pub fn tls_connector(&self) -> Result<TlsConnector>

Build a tokio_rustls::TlsConnector from this TLS configuration.

This is the convenience entry point for crate::network_stream::UpgradedStream::start_tls and other contexts where a generic TLS upgrade must reflect the full configured policy (custom CA, verification, SNI, version bounds, client identity).

§Errors

Returns an error if the underlying rustls configuration cannot be built (see Self::build_rustls_config).

Source

pub fn build_rustls_config(&self) -> Result<ClientConfig>

Build a rustls::ClientConfig from this TLS configuration.

§Errors

Returns an error if the trust store, client certificates, or protocol versions cannot be configured.

Source

pub fn verify_hostname(&self) -> bool

Returns true if hostname verification is enabled.

Source

pub fn verify_certificate(&self) -> bool

Returns true if certificate verification is enabled.

Source

pub fn sni_enabled(&self) -> bool

Returns true if SNI is enabled.

Trait Implementations§

Source§

impl Clone for TlsConfig

Source§

fn clone(&self) -> TlsConfig

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for TlsConfig

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for TlsConfig

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more