DNS

  2 minute read  

The DNS feature allows nodes in the virtual network to act as DNS servers for ingress VPN traffic. The node can resolve queries custom defines DNS zones and records, or forward queries to upstream DNS servers.

DNS Settings

Field NameDescription
Enable/Disable DNSThis field enables or disables the DNS feature on the virtual network.
DNS Server IPThis is the IP address that should be used as the resolver. There is no need to create a VPN route for this IP. If the ingress node was the DNS feature enabled it will automatically handle responses for the query.
DNS Settings

After making any changes to the DNS settings you will need to review and apply changes for the updates to take effect.

DNS Zones

Optionally you can create custom DNS zones and either:

  • Configure specific DNS records to resolve to IPs/hosts on the virtual network
  • Configure a node as a resolver for this zone. Requests will be forwarded to that node and resolved by its DNS servers or configured upstream servers.
DNS Zone Settings

Adding a DNS Zone

To add a custom DNS zone:

  1. Click the “Add Zone” button.
  2. Provide a name for the zone (e.g. example.com).
  3. Optionally, provide a description for the zone.
  4. Review and apply changes to save the zone.
Adding a DNS Zone

Once a zone has been added, you can configure either a DNS resolver or specific DNS records.

Configuring a DNS Resolver

  1. Click on the zone name to enter its configuration page.
  2. Under “Resolver”, select a node from the dropdown.
  3. Click “Save” to save the resolver configuration.
  4. Review and apply changes to update the DNS configuration.

Configuring DNS Records

DNS records allow mapping names to IP addresses for hosts on the virtual network. DNS records have the following fields:

Field NameDescription
NameThe hostname being mapped (e.g. www). The zone name will be automatically appended.
Record Type
  • A - for records that should resolve to an IP address
  • CNAME - for alias/canonical name records
ValueThe IP address or hostname being mapped to for A/CNAME records respectively.
TTLTime To Live - how long records may be cached by other resolvers.

To add a DNS record:

  1. Click on the zone name to enter its configuration page.
  2. Under “DNS Records”, click “Add Record”
  3. Provide the required fields
    Add DNS Record prompt
  4. Click save.
  5. (Optional) repeat to add more records to the current zone.
  6. Review and apply changes to save the record(s).