Problemen met White Label-DNS oplossen

De meeste DNS-problemen met White Label Lite hebben een van vier oorzaken: het record ontbreekt, de waarde verschilt van die in de Branding-tabel, er is een proxy ingeschakeld of de certificaatstap vraagt aandacht.

Begin bij de tabel DNS for your brand op het tabblad Branding van het domein. Dit is de bepalende bron voor je hostnaam en doelwaarde. Kopieer geen CNAME-doel uit een ouder artikel, een ander account of een DNS-controleprogramma.

Snelle aanpak

1. Open Branding en kopieer de host, het type en de waarde voor het getroffen adres.
2. Maak dat record aan of corrigeer het bij de DNS-provider die de actieve DNS-zone host.
3. Houd het record in de modus alleen DNS als de provider een proxyschakelaar aanbiedt.
4. Ga terug naar Branding en selecteer Verify DNS. Deel het adres pas wanneer de status Active is.

DNS controleren zonder terminal

Vergelijk vóór andere probleemoplossing het record bij je DNS-provider met de rij in Branding:

• Host of Name
• Type, dat voor een aangepaste dashboard- of webmailhost CNAME is
• Value of Target
• De proxyinstelling, die uitgeschakeld moet zijn voor een aangepaste host die Cloudflare gebruikt

Gebruik de actie Verify DNS in Branding nadat je het record hebt opgeslagen. Daarmee wordt een nieuwe controle in de wachtrij gezet en toont de pagina de resulterende status.

Voor een onafhankelijke controle kun je een openbare DNS-zoekdienst gebruiken of je DNS-provider vragen de volledige hostnaam als CNAME op te zoeken. Het antwoord moet exact overeenkomen met het huidige veld Value in Branding. Een openbaar hulpmiddel kan bevestigen wat het ziet, maar vervangt de platformstatus Active niet.

Je hebt geen terminal nodig om deze configuratie af te ronden. Als je er een gebruikt, vraag dan de volledige hostnaam op en vergelijk de geretourneerde CNAME met de waarde in Branding.

Status is "Pending DNS"

Pending DNS betekent dat het platform het verwachte record voor die host nog niet heeft gevonden. Selecteer Verify DNS nadat je een record hebt gecorrigeerd en ga na de statusupdate terug naar het tabblad Branding. Voer deze controles in de aangegeven volgorde uit:

Je hebt de verkeerde DNS-provider bewerkt. Controleer welke provider autoritatief is voor de DNS van je domein. Mogelijk bewerk je het paneel van een registrar terwijl de actieve DNS-zone elders wordt gehost.

Het CNAME-doel is niet actueel. Kopieer Value of Target uit de Branding-tabel. Verwijder een oud conflicterend record voor dezelfde hostnaam pas nadat je hebt vastgesteld dat een andere dienst het niet gebruikt.

Het recordtype is onjuist. Een dashboard- of webmailhost heeft het CNAME-record nodig dat in Branding wordt getoond. Een A- of AAAA-record op dezelfde hostnaam kan het verwachte resultaat verhinderen.

De hostnaam is in de verkeerde vorm ingevoerd. Sommige providers verwachten alleen het voorvoegsel, zoals dashboard, terwijl andere de volledige hostnaam vragen. Volg de aanwijzing bij het veld van de provider en vergelijk het resulterende record met de host in Branding.

Als het record overeenkomt, laat je het staan en gebruik je Verify DNS opnieuw. Een correct record steeds wijzigen kan de tijd verlengen voordat alle DNS-resolvers hetzelfde antwoord zien.

De oranje wolk van Cloudflare verhindert SSL-inrichting

Als je Cloudflare als DNS-provider gebruikt, zie je naast elk record een wolkpictogram. Een oranje wolk betekent dat Cloudflare het verzoek via een proxy leidt. De CNAME voor een aangepast dashboard of aangepaste webmail moet in de modus alleen DNS staan, zodat het platform deze kan controleren en het certificaat kan uitgeven.

Oplossing: selecteer de wolk naast de CNAME van de getroffen aangepaste host totdat deze grijs is en sla het record op. Ga terug naar Branding en selecteer Verify DNS.

Dit geldt voor het record van de aangepaste host, niet automatisch voor alle andere records van het domein. Als een andere provider een proxy- of CDN-schakelaar heeft, schakel je deze voor die CNAME uit tenzij de Branding-tabel andere instructies geeft.

Status is "SSL could not be issued" en vermeldt CAA

Een CAA-record vertelt certificaatproviders welke organisaties een certificaat voor je domein mogen uitgeven. Wijzig dit alleen wanneer de status in Branding of ondersteuning CAA uitdrukkelijk als blokkering aanwijst.

Laat de CNAME ongewijzigd en controleer of het domein al een CAA-record heeft. Je DNS-provider kan dit tonen of een onafhankelijke DNS-zoekopdracht kan het hoofddomein opvragen.

Als het record de certificaatuitgever van het platform moet toestaan, voeg je de exacte CAA-waarde toe die ondersteuning verstrekt of die in de huidige productinstructies staat. Verwijder geen ongerelateerde CAA-items alleen om deze stap te laten slagen. Meerdere CAA-records kunnen naast elkaar bestaan.

Voor het huidige certificaatproces is de vereiste waarde normaal gesproken:

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

Als je geen CAA-records hebt, voeg er dan niet uit voorzorg een toe. Ga na een CAA-wijziging terug naar Branding en selecteer Verify DNS.

Status is zonder reden "SSL could not be issued"

De CNAME is mogelijk al correct. Verwijder het record niet steeds opnieuw om het daarna weer aan te maken. Doe in plaats daarvan het volgende:

1. Controleer of het record nog overeenkomt met de host en het doel in Branding en niet via een proxy loopt.
2. Selecteer eenmaal Verify DNS.
3. Als de status ongewijzigd blijft, neem je contact op met ondersteuning en stuur je de hostnaam, de getoonde status en een schermafbeelding van het DNS-record mee.

Certificaatwerk is geen wijziging die je kunt oplossen door een al correcte CNAME te bewerken. Het ondersteuningsteam kan het resultaat aan de kant van het platform bekijken zonder je om inloggegevens van de DNS-provider te vragen.

Domein was actief, maar de status is gewijzigd

Zodra een host Active is, is deze gereed voor gebruik. Als de status later verandert:

• Terug naar "Pending DNS": vergelijk de huidige CNAME met de Branding-tabel. Het record is mogelijk gewijzigd, verwijderd of via een proxy gaan werken.
• "SSL could not be issued": laat een overeenkomende CNAME staan, selecteer Verify DNS en neem contact op met ondersteuning als de status aanhoudt.
• Off: controleer of Branding voor dat domein is uitgeschakeld of het White Label-abonnement niet actief is. Als geen van beide een verklaring biedt, neem je contact op met ondersteuning.

Veelvoorkomende situaties

"Ik heb mijn CNAME gewijzigd, maar de status blijft in behandeling." Controleer of je de autoritatieve DNS-provider hebt bewerkt en of de nieuwe CNAME exact overeenkomt met Branding. Gebruik daarna Verify DNS. Wissel de waarden niet steeds terwijl de controle wordt uitgevoerd.

"Ik heb de oude CNAME bij mijn vorige provider verwijderd, maar de nieuwe wordt niet gevonden." Als je van DNS-provider bent veranderd, controleer je of de registrar het domein naar de nameservers van de nieuwe provider delegeert. Vraag anders de provider van de autoritatieve DNS-zone om het record te bevestigen.

"Mijn hoofdwebsite gebruikt een proxy. Kan de aangepaste host die ook gebruiken?" Houd de aangepaste CNAME in de modus alleen DNS. De rest van het domein mag eigen proxyinstellingen gebruiken zolang de specifieke host in Branding niet via een proxy loopt.

"Kan ik een wildcard-CNAME gebruiken?" Configureer de specifieke hostnaam die in Branding wordt weergegeven. Zo krijgt het platform een eenduidig adres om te controleren en te testen. Vervang de host in de tabel niet door een wildcard-record.

"Ik wil een ander subdomein gebruiken." Wijzig het label op het tabblad Branding van het domein en sla één host tegelijk op. Kopieer de nieuwe CNAME uit de tabel, test de nieuwe host pas wanneer deze Active wordt en houd het oude klantadres beschikbaar tot de overgang is voltooid.

"Eén netwerk kan het nieuwe record niet zien." Test via een ander netwerk of vraag de getroffen klant het later opnieuw te proberen. Als de Branding-tabel Active aangeeft en de host elders werkt, bevindt de resterende vertraging zich waarschijnlijk in de DNS-cache van dat netwerk.

Volgende stappen

• White Label Lite instellen: de oorspronkelijke configuratiestappen als je nog niet klaar bent.
• Veelgestelde vragen over prijzen van White Label Lite: vragen over facturering.
• White Label Lite annuleren: wat er bij annulering met je domein gebeurt.
• Aanbevolen DNS-records: het ruimere overzicht van DNS-records die TrekMail gebruikt.

Als je nog steeds vastloopt, open je een ondersteuningsticket met de hostnaam, de exacte status uit Branding, de DNS-provider en een schermafbeelding van het record. Stuur geen wachtwoorden of API-tokens van je DNS-provider.