DNS Configuratie

Configureer je DNS records correct voor optimale email delivery

Vereiste DNS records ophalen

Via de API

Haal alle benodigde DNS records op voor je domein:

curl -X GET https://api.imply.nl/v1/domains/jouwdomein.nl/dns \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response met alle records:

{
  "domain": "jouwdomein.nl",
  "mail_server_ip": "192.0.2.100",
  "records": [
    {
      "type": "MX",
      "name": "@",
      "value": "mail.jouwdomein.nl",
      "priority": 10,
      "ttl": 3600
    },
    {
      "type": "A",
      "name": "mail",
      "value": "192.0.2.100",
      "ttl": 3600
    },
    {
      "type": "TXT",
      "name": "@",
      "value": "v=spf1 include:_spf.imply.nl ~all",
      "ttl": 3600
    },
    {
      "type": "TXT",
      "name": "mail._domainkey",
      "value": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA...",
      "ttl": 3600
    },
    {
      "type": "TXT",
      "name": "_dmarc",
      "value": "v=DMARC1; p=none; rua=mailto:dmarc@jouwdomein.nl",
      "ttl": 3600
    }
  ]
}

Vereiste DNS records

1. MX Record (Mail Exchange)

De MX record vertelt waar emails voor je domein naartoe moeten worden gestuurd.

2. A Record (Address)

De A record koppelt de mailserver hostname aan een IP adres.

3. SPF Record (TXT)

SPF authoriseert welke servers emails mogen versturen namens je domein.

Zie de DKIM, SPF en DMARC pagina voor meer details.

4. DKIM Record (TXT)

DKIM voegt cryptografische handtekeningen toe aan je emails.

5. DMARC Record (TXT)

DMARC definieert het beleid voor email authenticatie.

DNS toevoegen bij populaire providers

TransIP

Cloudflare

Versio

GoDaddy

Google Domains (Squarespace)

DNS propagatie

DNS propagatie checken

Check of je DNS records al zichtbaar zijn:

# MX record
dig MX jouwdomein.nl +short

# A record voor mailserver
dig A mail.jouwdomein.nl +short

# SPF record
dig TXT jouwdomein.nl +short | grep spf

# DKIM record
dig TXT mail._domainkey.jouwdomein.nl +short

# DMARC record
dig TXT _dmarc.jouwdomein.nl +short

Online propagatie tools

• WhatsMyDNS - Check DNS wereldwijd
• DNS Checker - Multiple locations check
• MXToolbox - Complete DNS analyse

DNS validatie via API

Automatische validatie

Laat Imply je DNS records controleren:

curl -X POST https://api.imply.nl/v1/dns/validate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "jouwdomein.nl"
  }'

Response met validatie resultaten:

{
  "domain": "jouwdomein.nl",
  "valid": false,
  "checks": {
    "mx": {
      "valid": true,
      "records": ["mail.jouwdomein.nl"],
      "message": "MX record correct geconfigureerd"
    },
    "a": {
      "valid": true,
      "ip": "192.0.2.100",
      "message": "A record correct geconfigureerd"
    },
    "spf": {
      "valid": true,
      "record": "v=spf1 include:_spf.imply.nl ~all",
      "message": "SPF record correct"
    },
    "dkim": {
      "valid": false,
      "message": "DKIM record niet gevonden. Wacht op DNS propagatie of controleer de record.",
      "expected": "mail._domainkey.jouwdomein.nl"
    },
    "dmarc": {
      "valid": true,
      "policy": "none",
      "message": "DMARC record correct"
    }
  }
}

Optionele records

Reverse DNS (PTR)

Reverse DNS koppelt het IP adres terug aan de hostname. Dit verbetert deliverability.

AutoDiscover (Outlook/Exchange)

Voor automatische configuratie in Outlook:

AutoConfig (Thunderbird)

Voor automatische configuratie in Thunderbird:

Veelvoorkomende problemen

MX record verwijst naar IP in plaats van hostname

Fout:

MX 10 192.0.2.100

Correct:

MX 10 mail.jouwdomein.nl

Meerdere SPF records

Als je meerdere email providers gebruikt, combineer de includes:

v=spf1 include:_spf.imply.nl include:_spf.google.com ~all

DKIM record te lang

Sommige DNS providers hebben een limiet op TXT record lengte. Oplossingen:

• Gebruik meerdere strings (automatisch bij TransIP, Cloudflare)
• Verklein de DKIM key size naar 1024-bit (minder veilig)
• Gebruik een DNS provider zonder limiet

DNS cache problemen

Als je DNS wijzigingen niet ziet:

• Flush je lokale DNS cache:

# Windows
ipconfig /flushdns

# macOS
sudo dscacheutil -flushcache

# Linux
sudo systemd-resolve --flush-caches

Migatie van andere provider

Stap 1: Voeg nieuwe DNS records toe

Voeg eerst alle Imply DNS records toe ZONDER oude records te verwijderen.

Stap 2: Verlaag TTL

Verlaag de TTL van je huidige MX record naar 300 seconden (5 minuten) een dag voor de migratie.

Stap 3: Test nieuwe configuratie

Stuur test emails om te verifiëren dat alles werkt:

curl -X POST https://api.imply.nl/v1/mail/send \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "test@jouwdomein.nl",
    "to": "jouw-persoonlijke@email.com",
    "subject": "DNS Test",
    "body": "Test of DNS correct werkt"
  }'

Stap 4: Wijzig MX record

Update je MX record om naar Imply te wijzen:

• Verwijder oude MX records
• Zorg dat alleen mail.jouwdomein.nl als MX record staat

Stap 5: Monitor

Monitor je email flow gedurende 48 uur:

• Check of emails binnenkomen
• Verifieer dat versturen werkt
• Bekijk mail logs voor errors

Stap 6: Verhoog TTL terug

Na succesvolle migratie, verhoog TTL terug naar 3600 of hoger.

Best practices

• Gebruik lage TTL tijdens migratie - Dit maakt rollback sneller mogelijk
• Test grondig - Valideer alle DNS records voordat je live gaat
• Backup oude DNS - Bewaar je oude DNS configuratie voor als er iets mis gaat
• Monitor na wijzigingen - Check logs en deliverability na DNS changes
• Gebruik subdomein voor mail - mail.jouwdomein.nl in plaats van root domein
• Implementeer alle authenticatie - SPF, DKIM én DMARC voor beste resultaten

Complete checklist