Struct DnsConfig 

#[non_exhaustive]
pub struct DnsConfig {
    pub nameserver: String,
    pub txt_prefix: String,
    pub timeout_ms: u64,
}

Configuration for super::DomainVerifier.

Deserializes from YAML via serde. The txt_prefix and timeout_ms fields have defaults and can be omitted.

Example (YAML)

dns:
  nameserver: "8.8.8.8:53"
  txt_prefix: "_myapp-verify"   # default: _modo-verify
  timeout_ms: 5000              # default: 5000

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

nameserver: String

Nameserver address, with or without port. Port 53 is appended when omitted.

Examples: "8.8.8.8:53", "1.1.1.1".

txt_prefix: String

Prefix prepended to the domain when looking up TXT records.

The resolved TXT lookup name is {txt_prefix}.{domain}. Defaults to "_modo-verify".

timeout_ms: u64

UDP receive timeout in milliseconds. Defaults to 5000.

Implementations

impl DnsConfig

pub fn new(nameserver: impl Into<String>) -> Self

Create a DNS configuration with the given nameserver address.

Defaults: txt_prefix = "_modo-verify", timeout_ms = 5000.

pub fn parse_nameserver(&self) -> Result<SocketAddr>

Parse nameserver into a SocketAddr.

If the address already contains a port it is used as-is; otherwise port 53 is appended.

Errors

Returns crate::Error with status 500 when the address is not a valid IP or hostname+port.

Trait Implementations

impl Clone for DnsConfig

fn clone(&self) -> DnsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DnsConfig

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

Formats the value using the given formatter.

impl Default for DnsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DnsConfig

where DnsConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.