Een aangepast domein verbinden aan een doc site

Met een aangepast domein kunnen lezers je doc site openen op een adres dat je zelf bezit, zoals help.example.com, in plaats van het gratis yoursite.clevera.help-adres. Je voegt één DNS-record toe bij je domeinprovider. Clevera controleert dit, geeft het beveiligingscertificaat uit en vernieuwt het voor je.

Deze pagina behandelt de installatie, elke status en melding op het Domein-scherm, en hoe je elk probleem kunt oplossen. Als er iets niet werkt, ga dan naar Probleemoplossing.

Voordat je begint#

• Plan: aangepaste domeinen zijn inbegrepen in Starter, Pro, Business en Custom. Bij Free toont de Aangepast domein-kaart "Gebruik help.jouwbedrijf.com" en Upgraden.
• Rol: de workspace-eigenaar, beheerders en editors kunnen een domein verbinden, controleren en verwijderen. Andere rollen zien "Alleen beheerders en editors kunnen het domein wijzigen."
• Alleen een subdomein: verbind help.example.com, docs.example.com of support.example.com. Root-domeinen zoals example.com en www.example.com kunnen niet worden verbonden.
• DNS-toegang: je moet een record toevoegen waar de DNS van je domein wordt gehost. Dat is meestal je registrar (GoDaddy, Namecheap, Squarespace) of een DNS-dienst zoals Cloudflare of Route 53.
• Eén domein per site: elke doc site heeft één aangepast domein. Om een ander te gebruiken, verwijder je eerst de huidige.

Je domein verbinden#

1. Open Domein#

   Open je doc site en klik op Domein onder Site in de zijbalk. De Gratis adres-kaart toont het adres dat altijd werkt.

2. Voer je subdomein in#

   Typ in de Aangepast domein-kaart het domein onder Domein, bijvoorbeeld help.example.com. Voer alleen het domein in: geen https:// en geen pad. Klik op Verbinden. Clevera zegt "Voeg het onderstaande DNS-record toe bij je domeinprovider."

3. Voeg het record toe bij je provider#

   Clevera toont DNS-records toevoegen. Log in waar de DNS van je domein wordt gehost en voeg het CNAME-record precies toe zoals getoond. Elke naam en waarde heeft een kopieerknop. Zie DNS-records toevoegen en Stappen voor je provider.

   

4. Controleer het#

   Terug in Clevera klik je op Opnieuw controleren. Clevera controleert in het begin ook elke minuut uit zichzelf, dus je kunt de pagina verlaten. Je krijgt een melding wanneer het domein live is.

5. Wacht op het certificaat#

   Wanneer het record is gevonden, verandert de status naar DNS controleren en daarna Certificaat uitgeven. Het certificaat duurt meestal 5–30 minuten.

   

6. Open je site op het nieuwe adres#

   Wanneer de status Live is, reageert je site op je domein en wordt het gratis adres daarnaartoe omgeleid. De eerste paar minuten kan het nieuwe adres nog "niet gevonden" tonen: zie De site toont "niet gevonden" direct na Live.

DNS-records toevoegen#

• Het CNAME "Verwijst je domein naar deze site". Kopieer de waarde van het Domein-scherm: elke site heeft zijn eigen doel.
• Het TXT-record "Bewijst dat het domein van jou is". Dit wordt alleen vermeld wanneer Clevera bewijs nodig heeft: wanneer het domein is verbonden met een andere Clevera-site, of wanneer je een domein opnieuw verbindt dat je in de afgelopen 90 dagen hebt losgekoppeld. Anders voeg je alleen het CNAME toe.
• Het moet een simpel CNAME zijn. Geen A-record, geen ALIAS of ANAME, geen Route 53 Alias, geen flattened of geproxied record. Onze hostingprovider accepteert alleen een domein waarvan de DNS reageert met een CNAME naar het doel van je site.
• Verwijder eerst andere records op dezelfde naam. Een oud A-, AAAA- of CNAME-record voor help conflicteert met het nieuwe.

Hoe voer je de naam in#

Clevera toont de CNAME-naam kort (help) en de TXT-naam volledig (_clevera-verify.help.example.com). De meeste providers voegen je domein voor je toe aan de naam, dus voer help en _clevera-verify.help in.

Als je bij zo'n provider de volledige naam typt, wordt het record help.example.com.example.com en vindt Clevera het nooit. Als je provider om de volledige naam vraagt (sommige doen dat, en Route 53 toont het domein naast het vak), controleer dan wat er wordt opgeslagen.

Stappen voor je provider#

Het Domein-scherm heeft dezelfde handleidingen onder Hulp voor je provider. "De Naam" en "de Waarde" betekenen de waarden in DNS-records toevoegen.

Wat de statussen betekenen#

De pil naast je domein toont de status. De voortgangsbalk eronder beweegt door DNS-records toevoegen, DNS gevonden, Certificaat en Live.

Hoe vaak Clevera controleert#

• Nu controleren voert direct een controle uit. Je kunt dit eenmaal per minuut gebruiken.
• Wanneer het domein moet worden hersteld of het record ontbreekt, heet de knop Opnieuw controleren. Bij een domein dat is mislukt tijdens het controleren of uitgeven, wordt het hele proces opnieuw gestart, inclusief de minuut-voor-minuut controles.
• Problemen die worden gevonden tijdens Wachten op DNS (verkeerd doel, proxy, flattening, CAA) worden automatisch opnieuw gecontroleerd: herstel het record en het domein gaat verder zonder dat je ergens op hoeft te klikken.

Meldingen#

De eigenaar van de werkruimte, beheerders en editors ontvangen deze in de meldingen van Clevera:

Nadat het domein live is#

• "Lezers op acme-help.clevera.help worden doorgestuurd naar help.example.com." Het gratis adres blijft werken en leidt door, zodat oude links niet kapotgaan.
• "Zoekmachines en links gebruiken help.example.com." Clevera publiceert de site eenmaal opnieuw zodat de links, sitemap en zoekmachinetags het nieuwe adres gebruiken.
• Het certificaat wordt automatisch vernieuwd zolang het CNAME op zijn plek blijft, niet via een proxy loopt en niet geflattened is.
• De records verplaatsen zich naar DNS-records: "Bewaar deze bij je domeinprovider. We controleren ze dagelijks."
• Privésites werken ook op het aangepaste domein; lezers loggen daar in. Zie Bepaal wie een docs-site kan lezen.

Als het record verdwijnt#

Eén mislukte controle verandert niets. Clevera controleert elke 3 uur opnieuw. Als het CNAME 3 controles achter elkaar over ten minste 6 uur mislukt, wordt de status DNS-record ontbreekt en ontvang je "Het DNS-record voor help.example.com is weg".

• "Lezers op acme-help.clevera.help bereiken de site nog steeds."
• Lezers op je aangepaste domein bereiken de site mogelijk niet.
• Plaats het CNAME terug en het domein herstelt zichzelf bij de volgende controle, of direct met Opnieuw controleren.
• Je krijgt herinneringen na 7 en 13 dagen. Als het niet binnen 14 dagen is hersteld, verbreekt Clevera de verbinding met het domein. De datum staat op het Domein-scherm.

Als je abonnement wijzigt#

Als je werkruimte overstapt naar een abonnement zonder aangepaste domeinen, wordt het domein Gepauzeerd en worden lezers naar je gratis adres gestuurd. "We verbreken de verbinding met het domein over 14 dagen, tenzij de site weer op een abonnement met aangepaste domeinen staat." Upgrade voor die tijd en het wordt weer ingeschakeld met dezelfde records.

Hetzelfde gebeurt wanneer een site wordt gepauzeerd omdat je abonnement minder docs-sites bevat: het domein wordt gepauzeerd tot de offline-datum van de site. Zie Docs-site abonnementen en limieten.

Verbinding met een domein verbreken#

Klik op Domein verwijderen onderaan de kaart Aangepast domein en bevestig met Verbinding verbreken.

• "Lezers zien daar een foutmelding totdat je het DNS-record verwijdert." Verwijder daarna het CNAME bij je provider.
• Het gratis adres wordt weer het hoofdadres: "acme-help.clevera.help is weer het hoofdadres."
• "We houden help.example.com 90 dagen vast voor deze werkruimte, zodat niemand anders het kan overnemen." Als je het binnen die 90 dagen opnieuw verbindt, wordt er om het TXT-record gevraagd: "De verbinding met help.example.com was verbroken. Opnieuw verbinden vereist het TXT-record."
• Als het domein live was, publiceert Clevera de site opnieuw zodat de links weer het gratis adres gebruiken.

Om het gratis adres zelf te wijzigen, ga je naar Instellingen → Algemeen. Het oude adres leidt 90 dagen door.

Problemen oplossen#

Zoek hieronder wat je ziet. Elk herstel eindigt met Opnieuw controleren (of Nu controleren) op het Domein-scherm. DNS-wijzigingen kunnen enkele minuten duren om zichtbaar te worden, soms uren: resolvers behouden het oude antwoord totdat de TTL verloopt. Als Clevera direct nadat je het record hebt gewijzigd nog steeds het oude record ziet, wacht dan een paar minuten en controleer opnieuw.

Blijft hangen op Wachten op DNS#

Je ziet: de status blijft Wachten op DNS met "Voeg de onderstaande records toe bij je domeinprovider".

Waarom: Clevera kan nog geen record voor de naam vinden. De gebruikelijke oorzaken:

• Het record staat bij de verkeerde DNS-host. Als de nameservers van je domein ergens anders naar wijzen (bijvoorbeeld Namecheap met aangepaste nameservers, of een domein dat naar Cloudflare is verhuisd), worden records die bij de registrar zijn toegevoegd genegeerd. Voeg het record toe waar de nameservers naar wijzen.
• De naam is dubbel. Je hebt help.example.com ingevoerd waar de provider het domein toevoegt, dus het record is help.example.com.example.com. Wijzig de naam in help.
• Het record is niet opgeslagen. Sommige providers hebben een extra bevestiging nodig (het vinkje van Namecheap).
• Het is nog niet verschenen. Een nieuw record verschijnt meestal binnen enkele minuten; sommige providers hebben een paar uur nodig.

Herstel: corrigeer het record, wacht een paar minuten en klik op Nu controleren. Gebruik Zelf een record controleren om te zien wat de rest van de wereld ziet. Als er na een dag nog niets verschijnt, controleer dan de nameservers.

"Je CNAME wijst ergens anders heen"#

Je ziet: Moet worden hersteld en "help.example.com wijst naar iets. Wijzig het CNAME naar jouw doel."

Waarom: de naam antwoordt, maar niet met het doel van je site:

• Het CNAME bevat een typefout of wijst naar een oude host (je vorige helpdesk of docs-tool).
• Een oud A- of AAAA-record voor help staat er nog, dus de melding toont IP-adressen.
• Je hebt het record net gewijzigd en resolvers hebben nog het oude antwoord.

Herstel: stel de waarde van het CNAME in op het doel dat wordt getoond in Records om toe te voegen, en verwijder elk ander record dat deze naam gebruikt. "Als je het net hebt gewijzigd, wacht dan een paar minuten: DNS-servers kunnen het oude antwoord een tijdje vasthouden." Klik daarna op Opnieuw controleren.

"Je record loopt via de proxy van Cloudflare"#

Je ziet: Moet worden hersteld en "Stel het in op alleen DNS (grijze wolk). De oranje wolk verbergt ons doel en het certificaat kan niet worden uitgegeven."

Waarom: het record is Proxied (oranje wolk), wat de standaardinstelling van Cloudflare is. Cloudflare antwoordt dan met zijn eigen adressen, waardoor onze hostingprovider het CNAME niet kan zien of het certificaat niet kan uitgeven.

Herstel: open in Cloudflare DNS → Records, bewerk het record en stel Proxy status in op DNS only (grijze wolk). Sla op en klik daarna op Opnieuw controleren. Houd het ook op DNS only nadat het domein live is.

"Je DNS-provider flattens het CNAME"#

Je ziet: Moet worden hersteld en "help.example.com antwoordt met adressen in plaats van een CNAME naar jouw doel. Schakel CNAME flattening uit voor dit record."

Waarom: het record wijst naar de juiste plek, maar je provider publiceert de adressen erachter in plaats van het CNAME zelf. Onze hostingprovider accepteert alleen een domein dat antwoordt met een echt CNAME, dus het weigert een geflattened record. Deze flattenen allemaal:

• Cloudflare's zone-instelling DNS → Settings → CNAME flattening → "Flatten all CNAMEs"
• Cloudflare's Flatten-schakelaar op het record
• ALIAS- of ANAME-records (aangeboden door veel DNS-hosts)
• Route 53 Alias-records

Herstel:

• Cloudflare: stel DNS → Settings → CNAME flattening in op "Flatten CNAME at root" en zet de Flatten-schakelaar van het record uit.
• Route 53: verwijder het Alias-record en maak een gewoon CNAME aan met de Alias-schakelaar uit.
• Andere providers: vervang het ALIAS- of ANAME-record door een gewoon CNAME.

Klik daarna op Opnieuw controleren.

"Onze hostingprovider kon het domein niet bevestigen"#

Je ziet: Moet worden hersteld en "Het zag niet dat help.example.com naar jouw doel wijst. Dit betekent meestal dat het record de afgelopen minuten is gewijzigd, of dat je DNS-provider het flattent of via een proxy verstuurt."

Waarom: Clevera vond het record, maar toen onze hostingprovider een moment later keek, zag het het CNAME niet. Meestal:

• Het record is de afgelopen minuten gewijzigd, dus sommige DNS-servers geven nog het oude antwoord.
• Het record is geflattened (zie hierboven) of via een proxy verstuurd (zie hierboven).

Fix: "Zorg dat het een gewoon CNAME-record is zonder proxy, wacht een paar minuten en druk dan op Opnieuw controleren. Lukt het na een uur nog steeds niet? Neem contact op met de ondersteuning." Clevera probeert dit niet automatisch opnieuw, dus klik na elke wijziging op Opnieuw controleren.

Blijft hangen op Certificaat uitgeven, of "Het certificaat is niet uitgegeven"#

Je ziet: Certificaat uitgeven gedurende meer dan een uur, of na ongeveer een dag Moet worden hersteld met "We konden binnen een dag geen certificaat verkrijgen. Meestal blokkeert een CAA-record dit, of het CNAME-record gaat door een proxy of is geflattend."

Waarom: het certificaat wordt gevalideerd via je CNAME, dus het record moet rechtstreeks naar het doel van je site blijven wijzen totdat het is uitgegeven. Het komt niet aan wanneer:

• een CAA-record Amazon niet toestaat (zie de volgende sectie);
• het record werd geproxied of geflattend nadat Clevera het had gevonden;
• het record werd gewijzigd of verwijderd terwijl het certificaat werd uitgegeven.

Normaal duurt dit 5–30 minuten.

Fix: controleer de CAA-records en maak van het CNAME een gewoon, niet-geproxied record dat naar je doel wijst. Klik daarna op Opnieuw controleren. Dit start het proces opnieuw en geeft een nieuw certificaat uit.

"Je CAA-records blokkeren het certificaat"#

Je ziet: Moet worden hersteld en "De CAA-records van je domein staan niet toe dat Amazon een certificaat uitgeeft. Voeg 0 issue "amazon.com" toe als CAA-record op example.com."

Waarom: CAA-records benoemen de certificaatautoriteiten die certificaten mogen uitgeven voor je domein. Certificaten voor elke Clevera-docsite worden uitgegeven via Amazon. De dichtstbijzijnde naam met CAA-records is bepalend: voor help.example.com winnen de CAA-records op help.example.com, anders die op example.com. Als die records andere autoriteiten noemen maar niet Amazon, wordt het certificaat geweigerd. Zonder CAA-records wordt er niets geblokkeerd.

Fix: voeg een CAA-record toe aan de zone die in het bericht wordt genoemd (meestal je hoofddomein):

Behoud je andere CAA-records. Klik daarna op Opnieuw controleren.

"Dit domein wordt al gebruikt door een andere service"#

Je ziet: Moet worden hersteld en "help.example.com is verbonden met een andere hostingservice, wellicht je vorige doc-host. Verwijder het daar eerst."

Waarom: dezelfde hostnaam is ergens anders gekoppeld bij de hostingprovider die we gebruiken, vaak je vorige doc-host of je eigen configuratie daar. Een hostnaam kan slechts één keer worden gekoppeld.

Fix: verwijder help.example.com uit de andere service (de instelling voor aangepaste domeinen van je oude doc-tool, of je eigen hostingconfiguratie) en klik daarna op Opnieuw controleren. Als je niet kunt vinden waar het is gekoppeld, neem dan contact op met de ondersteuning.

"Dit domein is verbonden met een andere Clevera-site"#

Je ziet: Moet worden hersteld, "Voeg het onderstaande TXT-record toe om te bewijzen dat het van jou is.", en een TXT-rij onder Records om toe te voegen.

Waarom: een andere Clevera-docsite heeft dit domein, of hield het vast in de 90 dagen nadat de verbinding was verbroken. Om het te verplaatsen, moet je bewijzen dat je de DNS beheert.

Fix: voeg het TXT-record toe (naam _clevera-verify.help, waarde van Clevera) en laat het CNAME naar het doel van deze site wijzen. Wanneer Clevera beide vindt, wordt het domein verplaatst naar deze site en gaat de andere site terug naar zijn gratis adres. Of verwijder het domein eerst van de andere site. Onbewezen verzoeken worden na 30 dagen verwijderd.

De browser toont "403 ERROR" of "Niet veilig"#

Je ziet: op je aangepaste domein een eenvoudige pagina met de tekst "403 ERROR — The request could not be satisfied. Bad request…", of een "Niet veilig" / certificaatwaarschuwing.

Waarom: dit is normaal totdat de status Live is. Het domein is nog niet verbonden (het certificaat is nog niet uitgegeven), of de verbinding werd verbroken terwijl het CNAME nog naar Clevera wees.

Fix:

• Nog niet live: voltooi de configuratie totdat de status Live is. Lezers kunnen ondertussen je gratis adres gebruiken.
• Verbinding verbroken: verwijder het CNAME bij je provider, of verbind het domein opnieuw.
• Live maar nog steeds zichtbaar: je browser heeft mogelijk de oude pagina in de cache opgeslagen. Vernieuw geforceerd (Cmd+Shift+R op Mac, Ctrl+Shift+R op Windows) of probeer een privévenster.

De site toont "niet gevonden" direct na Live#

Je ziet: de status is Live, maar het aangepaste domein toont de "niet gevonden"-pagina van de site.

Waarom: wanneer het domein live gaat, publiceert Clevera de site opnieuw onder het nieuwe adres. Dat duurt een paar minuten.

Fix: wacht een paar minuten en vernieuw dan geforceerd (Cmd+Shift+R of Ctrl+Shift+R) of open een privévenster.

"We kunnen je CNAME-record niet meer vinden"#

Je ziet: DNS-record ontbreekt en "Lezers kunnen de site mogelijk niet bereiken. We verbreken de verbinding met het domein op datum als het niet is hersteld — voeg het CNAME hieronder opnieuw toe."

Waarom: een live domein heeft de DNS-controle van Clevera gedurende ten minste 6 uur niet doorstaan. Het record is verwijderd of bewerkt, of het bestaat nog wel maar is geproxied of geflattend (beide verbergen het CNAME), of het domein is verhuisd naar een andere DNS-host zonder het record.

Fix: plaats het CNAME exact zoals weergegeven onder Records om toe te voegen terug, als een gewoon record zonder proxy, en klik daarna op Opnieuw controleren. Het domein gaat terug naar Live. Lezers op je gratis adres zien de site in de tussentijd gewoon.

Gepauzeerd#

Je ziet: Gepauzeerd en "help.example.com is gepauzeerd": "Lezers worden voor nu doorgestuurd naar acme-help.clevera.help. We verbreken de verbinding met het domein op datum tenzij de site weer op een abonnement met aangepaste domeinen staat."

Waarom: de werkruimte is overgezet naar een abonnement zonder aangepaste domeinen, of de site is gepauzeerd omdat het abonnement minder docsites bevat.

Fix: upgrade, of behoud deze site wanneer je kiest welke sites je wilt behouden, vóór de getoonde datum. Het domein wordt weer ingeschakeld met hetzelfde record. Laat het CNAME staan.

Andere berichten#

Berichten wanneer je verbinding maakt#

Zelf een record controleren#

Voer dit uit in een terminal (macOS of Linux), met je eigen domein:

dig +short CNAME help.example.com

• Het toont het doel van je site (zoals a1b2c3d4.edge.clevera.help.): het CNAME is correct.
• Het toont iets anders: het CNAME wijst ergens anders heen. Herstel de waarde.
• Het toont niets: voer dig +short help.example.com uit. Als dat IP-adressen toont, is het record geflattend, geproxied of een A-record. Als het ook niets toont, bestaat het record niet waar de wereld kijkt: controleer de naam en de nameservers.

Gebruik op Windows:

nslookup -type=CNAME help.example.com

Een openbare DNS-opzoekwebsite werkt ook: zoek het CNAME-record voor je domein op.

Wat je naar de ondersteuning moet sturen#

Als een fix niet werkt, neem dan contact op met de Clevera-ondersteuning met:

• de naam van de docsite;
• het domein, zoals help.example.com;
• het exacte bericht op het Domein-scherm;
• de uitvoer van dig +short CNAME help.example.com (of de nslookup-regel op Windows).

Gerelateerd#