TlsConfig

Struct TlsConfig

pub struct TlsConfig { /* private fields */ }

Expand description

Configuration of TLS.

This configuration is in common for both the different TLS mechanisms (available through feature flags rustls and native-tls).

Implementations§

impl TlsConfig

pub fn builder() -> TlsConfigBuilder

Builder to make a bespoke config.

impl TlsConfig

pub fn provider(&self) -> TlsProvider

The provider to use.

Defaults to TlsProvider::Rustls.

pub fn client_cert(&self) -> Option<&ClientCert>

Client certificate chain with corresponding private key.

Defaults to None.

pub fn root_certs(&self) -> &RootCerts

The set of trusted root certificates to use to validate server certificates.

Defaults to WebPki.

pub fn use_sni(&self) -> bool

Whether to send SNI (Server Name Indication) to the remote server.

This is used by the server to determine which domain/certificate we are connecting to for servers where multiple domains/sites are hosted on the same IP.

Defaults to true.

pub fn disable_verification(&self) -> bool

WARNING Disable all server certificate verification.

This breaks encryption and leaks secrets. Must never be enabled for code where any level of security is required.

pub fn unversioned_rustls_crypto_provider(&self) -> &Option<Arc<CryptoProvider>>

Specific CryptoProvider to use for rustls.

§UNSTABLE API

NOTE: This API is not guaranteed for semver.

rustls is not (yet) semver 1.x and ureq can’t promise that this API is upheld. If rustls makes a breaking change regarding CryptoProvider their configuration, or incompatible data types between rustls versions, ureq will NOT bump a major version.

ureq will update to the latest rustls minor version using ureq minor versions.

Trait Implementations§

impl Clone for TlsConfig

fn clone(&self) -> TlsConfig

Returns a duplicate of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl Debug for TlsConfig

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

Formats the value using the given formatter. Read more

impl Default for TlsConfig

fn default() -> Self

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

impl Hash for TlsConfig

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher. Read more

1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more

Auto Trait Implementations§

impl Freeze for TlsConfig

impl !RefUnwindSafe for TlsConfig

impl Send for TlsConfig

impl Sync for TlsConfig

impl Unpin for TlsConfig

impl !UnwindSafe for TlsConfig

Blanket Implementations§

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

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

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

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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

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

Mutably borrows from an owned value. Read more

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

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

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

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

fn into(self) -> U

Calls U::from(self).

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

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

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

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

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

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

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

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

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

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

The type returned in the event of a conversion error.

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

Performs the conversion.