Skip to content

DNS resolution

DNS resolution not working

  1. Obtain your Enclave local IP address using the enclave get-ip command.

    That's the IP address which the local DNS stub resolver will bind to (udp\53).

    C:\> enclave get-ip
    100.117.177.98
    
  2. Use nslookup to send a test query to the Enclave nameserver identified in step 1 by attempting to resolve the special DNS name _my.id.enclave. It should resolve to your own local Enclave IP address, the same IP as the nameserver you're querying.

    C:\> nslookup _my.id.enclave 100.117.177.98
    Server:   UnKnown
    Address:  100.117.177.98
    
    Name:     _my.id.enclave
    Address:  100.117.177.98
    
  3. If the DNS query fails, check there isn't other software bound to your Enclave Local address on port udp/53

  4. If you're running Enclave on a Linux operating system or inside a container, check that DNS queries from the operating system are reaching the local Enclave DNS stub resolver. See DNS for details on how Enclave's split-tunnel DNS works.

  5. Some ISPs hijack DNS queries to serve ads. Check that your primary recursive nameserver correctly returns a SERVFAIL response when queried with a hostname it should be unable to resolve. Some ISPs run nameservers which return IP addresses for ad servers instead of a SERVFAIL for non-existent domains. The ping request shown below to the non-existing hostname null.enclave.io should fail. If it does not, your ISPs nameservers may be hijacking your DNS requests to serve ads, in which case we recommend contacting your ISP to disable this function or switching to another primary resolver.

    C:\> ping null.enclave.io
    Ping request could not find host null.enclave.io. Please check the name and try again.
    

DNS queries slow to complete

  1. On Windows, check that the Enclave network interface doesn't list more than one DNS nameserver. If it does, please remove the DNS server that does not match the Enclave Local address shown by the enclave get-ip command.

If you're still experiencing DNS issues after working through this checklist, see collecting logs and contact support.