Trait ConfigBuilderExt

pub trait ConfigBuilderExt: Sealed {
    // Required methods
    fn with_platform_verifier(
        self,
    ) -> ConfigBuilder<ClientConfig, WantsClientCert>;
    fn try_with_platform_verifier(
        self,
    ) -> Result<ConfigBuilder<ClientConfig, WantsClientCert>, Error>;
    fn with_native_roots(
        self,
    ) -> Result<ConfigBuilder<ClientConfig, WantsClientCert>, Error>;
    fn with_webpki_roots(self) -> ConfigBuilder<ClientConfig, WantsClientCert>;
}

Methods for configuring roots

This adds methods (gated by crate features) for easily configuring TLS server roots a rustls ClientConfig will trust.

Required Methods

fn with_platform_verifier(self) -> ConfigBuilder<ClientConfig, WantsClientCert>

👎Deprecated since 0.27.7: use try_with_platform_verifier instead

Available on crate feature rustls-platform-verifier only.

Use the platform’s native verifier to verify server certificates.

See the documentation for rustls-platform-verifier for more details.

Panics

Since 0.27.7, this method will panic if the platform verifier cannot be initialized. Use try_with_platform_verifier() instead to handle errors gracefully.

fn try_with_platform_verifier( self, ) -> Result<ConfigBuilder<ClientConfig, WantsClientCert>, Error>

Available on crate feature rustls-platform-verifier only.

Use the platform’s native verifier to verify server certificates.

See the documentation for rustls-platform-verifier for more details.

fn with_native_roots( self, ) -> Result<ConfigBuilder<ClientConfig, WantsClientCert>, Error>

Available on crate feature rustls-native-certs only.

This configures the platform’s trusted certs, as implemented by rustls-native-certs

This will return an error if no valid certs were found. In that case, it’s recommended to use with_webpki_roots.

fn with_webpki_roots(self) -> ConfigBuilder<ClientConfig, WantsClientCert>

Available on crate feature webpki-roots only.

This configures the webpki roots, which are Mozilla’s set of trusted roots as packaged by webpki-roots.

Implementations on Foreign Types

impl ConfigBuilderExt for ConfigBuilder<ClientConfig, WantsVerifier>

fn with_platform_verifier(self) -> ConfigBuilder<ClientConfig, WantsClientCert>

👎Deprecated since 0.27.7: use try_with_platform_verifier instead

Available on crate feature rustls-platform-verifier only.

fn try_with_platform_verifier( self, ) -> Result<ConfigBuilder<ClientConfig, WantsClientCert>, Error>

Available on crate feature rustls-platform-verifier only.

fn with_native_roots( self, ) -> Result<ConfigBuilder<ClientConfig, WantsClientCert>, Error>

Available on crate feature rustls-native-certs only.

fn with_webpki_roots(self) -> ConfigBuilder<ClientConfig, WantsClientCert>

Available on crate feature webpki-roots only.

Implementors