Struct hickory_proto::native_tls::tls_stream::TlsStreamBuilder

pub struct TlsStreamBuilder<S> { /* private fields */ }

Available on crate feature dns-over-native-tls only.

A builder for the TlsStream

Implementations

impl<S: DnsTcpStream> TlsStreamBuilder<S>

pub fn new() -> Self

Constructs a new TlsStreamBuilder

pub fn add_ca(&mut self, ca: Certificate)

Add a custom trusted peer certificate or certificate authority.

If this is the ‘client’ then the ‘server’ must have it associated as it’s identity, or have had the identity signed by this certificate.

pub fn bind_addr(&mut self, bind_addr: SocketAddr)

Sets the address to connect from.

pub fn build_with_future<F>( self, future: F, name_server: SocketAddr, dns_name: String ) -> (Pin<Box<dyn Future<Output = Result<TlsStream<S>, Error>> + Send>>, BufDnsStreamHandle)

where S: DnsTcpStream, F: Future<Output = Result<S>> + Send + Unpin + 'static,

Similar to build, but with customized stream future.

Arguments

• name_server - IP and Port for the remote DNS resolver
• dns_name - The DNS name, Public Key Info (SPKI) name, as associated to a certificate

impl<S: Connect> TlsStreamBuilder<S>

pub fn build( self, name_server: SocketAddr, dns_name: String ) -> (Pin<Box<dyn Future<Output = Result<TlsStream<S>, Error>> + Send>>, BufDnsStreamHandle)

Creates a new TlsStream to the specified name_server

RFC 7858, DNS over TLS, May 2016

3.2.  TLS Handshake and Authentication

  Once the DNS client succeeds in connecting via TCP on the well-known
  port for DNS over TLS, it proceeds with the TLS handshake [RFC5246],
  following the best practices specified in [BCP195].

  The client will then authenticate the server, if required.  This
  document does not propose new ideas for authentication.  Depending on
  the privacy profile in use (Section 4), the DNS client may choose not
  to require authentication of the server, or it may make use of a
  trusted Subject Public Key Info (SPKI) Fingerprint pin set.

  After TLS negotiation completes, the connection will be encrypted and
  is now protected from eavesdropping.

Arguments

• name_server - IP and Port for the remote DNS resolver
• dns_name - The DNS name, Public Key Info (SPKI) name, as associated to a certificate

Trait Implementations

impl<S: Default> Default for TlsStreamBuilder<S>

fn default() -> TlsStreamBuilder<S>

Returns the “default value” for a type.