Struct ClientTlsConfigBuilder 

pub struct ClientTlsConfigBuilder { /* private fields */ }

Incremental builder for ClientTlsConfig.

Implementations

impl ClientTlsConfigBuilder

pub fn ca(self, src: PemSource) -> Self

Set the trusted CA bundle (verifies the server’s certificate).

pub fn client_cert(self, src: PemSource) -> Self

Set the client certificate chain.

pub fn client_key(self, src: PemSource) -> Self

Set the client private key.

pub fn with_alpn<I, S>(self, protocols: I) -> Self

where I: IntoIterator<Item = S>, S: Into<Vec<u8>>,

Set the ALPN protocol list, in preference order.

Pass ["h2"] for gRPC-only, ["h2", "http/1.1"] for HTTP (default is empty).

pub fn ca_pem_file(self, path: impl Into<PathBuf>) -> Self

Convenience: trusted CA bundle from a file path.

pub fn ca_pem_bytes(self, bytes: impl Into<Vec<u8>>) -> Self

Convenience: trusted CA bundle from in-memory bytes.

pub fn client_cert_pem_file(self, path: impl Into<PathBuf>) -> Self

Convenience: client cert chain from a file path.

pub fn client_cert_pem_bytes(self, bytes: impl Into<Vec<u8>>) -> Self

Convenience: client cert chain from in-memory bytes.

pub fn client_key_pem_file(self, path: impl Into<PathBuf>) -> Self

Convenience: client private key from a file path.

pub fn client_key_pem_bytes(self, bytes: impl Into<Vec<u8>>) -> Self

Convenience: client private key from in-memory bytes.

pub fn build(self) -> Result<ClientTlsConfig, TlsError>

Finalize the configuration.

Requires ca. Rejects an unpaired client cert/key with TlsError::MissingField ("client_cert" or "client_key"). Does no I/O: the PEM sources are read by ClientTlsConfig::into_rustls_config.

Example

use solti_tls::{ClientTlsConfig, TlsError};

// A client cert without its key is rejected.
let err = ClientTlsConfig::builder()
    .ca_pem_bytes(b"-----BEGIN CERTIFICATE-----\n...".to_vec())
    .client_cert_pem_bytes(b"cert".to_vec())
    .build()
    .unwrap_err();
assert!(matches!(err, TlsError::MissingField("client_key")));

Trait Implementations

impl Clone for ClientTlsConfigBuilder

fn clone(&self) -> ClientTlsConfigBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientTlsConfigBuilder

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

Formats the value using the given formatter.

impl Default for ClientTlsConfigBuilder

fn default() -> ClientTlsConfigBuilder

Returns the “default value” for a type.