actix_tls::connect::rustls_0_21::reexports

# Struct ClientConfig

    pub struct ClientConfig {
        pub alpn_protocols: Vec<Vec<u8>>,
        pub resumption: Resumption,
        pub max_fragment_size: Option<usize>,
        pub client_auth_cert_resolver: Arc<dyn ResolvesClientCert>,
        pub enable_sni: bool,
        pub key_log: Arc<dyn KeyLog>,
        pub enable_early_data: bool,
        /* private fields */
    }

Expand description

Common configuration for (typically) all connections made by a program.

Making one of these is cheap, though one of the inputs may be expensive: gathering trust roots from the operating system to add to the `RootCertStore` passed to `with_root_certificates()` (the rustls-native-certs crate is often used for this) may take on the order of a few hundred milliseconds.

These must be created via the `ClientConfig::builder()` function.

## §Defaults

- `ClientConfig::max_fragment_size`: the default is `None`: TLS packets are not fragmented to a specific size.
- `ClientConfig::resumption`: supports resumption with up to 256 server names, using session ids or tickets, with a max of eight tickets per server.
- `ClientConfig::alpn_protocols`: the default is empty – no ALPN protocol is negotiated.
- `ClientConfig::key_log`: key material is not logged.

## Fields§

§ `alpn_protocols: Vec<Vec<u8>>`

Which ALPN protocols we include in our client hello. If empty, no ALPN extension is sent.

§ `resumption: Resumption`

How and when the client can resume a previous session.

§ `max_fragment_size: Option<usize>`

The maximum size of TLS message we’ll emit. If None, we don’t limit TLS message lengths except to the 2**16 limit specified in the standard.

rustls enforces an arbitrary minimum of 32 bytes for this field. Out of range values are reported as errors from ClientConnection::new.

Setting this value to the TCP MSS may improve latency for stream-y workloads.

§ `client_auth_cert_resolver: Arc<dyn ResolvesClientCert>`

How to decide what client auth certificate/keys to use.

§ `enable_sni: bool`

Whether to send the Server Name Indication (SNI) extension during the client handshake.

The default is true.

§ `key_log: Arc<dyn KeyLog>`

How to output key material for debugging. The default does nothing.

§ `enable_early_data: bool`

Whether to send data on the first flight (“early data”) in TLS 1.3 handshakes.

The default is false.

## Implementations§

§

### impl ClientConfig

#### pub fn builder() -> ConfigBuilder<ClientConfig, WantsCipherSuites>

Create a builder to build up the client configuration.

For more information, see the [`ConfigBuilder`] documentation.

## Trait Implementations§

§

### impl Clone for ClientConfig

§

#### fn clone(&self) -> ClientConfig

Returns a copy of the value. Read more
1.6.0 · source §

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

Performs copy-assignment from `source`. Read more
§

### impl Debug for ClientConfig

§

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

Formats the value using the given formatter. Read more
§

### impl ConfigSide for ClientConfig

## Auto Trait Implementations§

§

### impl Freeze for ClientConfig

§

### impl !RefUnwindSafe for ClientConfig

§

### impl Send for ClientConfig

§

### impl Sync for ClientConfig

§

### impl Unpin for ClientConfig

§

### impl !UnwindSafe for ClientConfig

## 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, dst: *mut T)

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

### impl<T> From<T> for T

source §

#### fn from(t: T) -> T

Returns the argument unchanged.

§

### impl<T> Instrument for T

§

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

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

#### 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 = Infallible

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

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

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.
§

### impl<T> WithSubscriber for T

§

#### 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
§

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

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