Een domein aan een site toevoegen

Deze gids loodst je door het koppelen van een domein aan een CloudPress-site — een domein dat je al bezit, een domein dat je wilt registreren, of een domein dat je wilt inverhuizen — en het door CloudPress laten instellen van DNS en het laten uitgeven van een SSL-certificaat ervoor. Aan het eind bereiken bezoekers je site via HTTPS op je eigen domein in plaats van op de tijdelijke CloudPress-URL.

Stappen

1. Open de Domeinen-pagina van de site. Open in de linker zijbalk Mijn sites en selecteer de site die je wilt gebruiken. Kies in de zijbalk van de site Domeinen. De pagina heeft als kop Domeinen, met twee kaarten: Jouw domeinen (de domeinen die je hebt gekoppeld, elk met het label Primair of Alias) en Systeem domeinen — de altijd beschikbare CloudPress-adressen, gemarkeerd als Automatisch beheerd · alleen-lezen.

2. Begin met het toevoegen van een domein. Klik op Domein toevoegen. Er opent een wizard van drie stappen: Domein → Koppelen → Verifiëren.

3. Voer het domein in. Typ het onder Welk domein wil je gebruiken? in het veld Domein en klik op Doorgaan. CloudPress controleert het domein en toont je wat het heeft gevonden.

   Note

   Zowel een apex-domein (example.com) als een subdomein (shop.example.com) wordt geaccepteerd. Een hostnaam die al aan een andere site in de workspace is gekoppeld, wordt geweigerd, met de reden op deze stap.

4. Kies wat je ermee wilt doen. Wat je vervolgens ziet, hangt af van de controle:

   • Klaar om te koppelen — "example.com is klaar om te koppelen". CloudPress host de DNS voor dit domein al, dus er hoeft niets te wijzigen bij een registrar. Staat er niets in de weg, dan zie je "Niets om te vervangen" en een knop Domein koppelen. Heeft de zone al records op die naam, dan worden ze opgesomd onder "Dit vervangt de volgende record(s):" en wordt de knop Vervangen & koppelen.

   • Beschikbaar om te registreren — "example.com is beschikbaar", met het domein, de prijs ervan en een knop Dit domein registreren die het aan je winkelwagen toevoegt. Registreren is de hele installatie: CloudPress laat DNS naar de site verwijzen en geeft het certificaat uit zodra het afrekenen is voltooid. Voor een premiumnaam staat er in plaats daarvan Neem contact op. Host CloudPress daarnaast al DNS voor de naam, dan staat er onder het aanbod een kleinere optie Koppelen zonder te registreren.

   • Geregistreerd bij een andere provider — "example.com is geregistreerd bij een andere provider". Je kunt Dit domein overzetten naar CloudPress, wat facturering, DNS en verlengingen hierheen brengt (er is een autorisatiecode (EPP) van je huidige registrar voor nodig en het duurt enkele dagen). Of gebruik het gedeelte "Of koppel hier alleen DNS — geen overdracht nodig" verderop op hetzelfde scherm en klik op Koppelen zonder over te zetten.

   • Iets anders — een korte banner legt uit wat CloudPress heeft gevonden (je bezit het al; de extensie is er geen die wij registreren of overzetten; de beschikbaarheidscontrole gaf geen antwoord, met een knop Opnieuw proberen; of het domein is geregistreerd of DNS-gehost buiten je workspace), en met de koppelopties eronder kun je hoe dan ook verder.

   Waar registreren of overzetten niet mogelijk is, is koppelen dat nog steeds wel — de wizard laat je altijd een manier om het domein naar je site te laten verwijzen.

5. Laat je DNS naar CloudPress verwijzen. Tenzij het domein in stap 4 klaar om te koppelen was, kom je terecht bij Hoe wil je het koppelen? met twee opties; de optie die CloudPress voorstelt, draagt de badge Aanbevolen.

   • Nameservers instellen. Wijzig de nameservers van het domein bij je registrar naar de getoonde nameservers (elk met een knop Kopiëren). CloudPress beheert dan de volledige DNS-zone en SSL voor je. Dit is de aanbevolen optie voor een apex-domein.

   • Een CNAME-record toevoegen. Laat DNS staan waar het staat en voeg het getoonde CNAME-record toe — Type, Naam en Waarde staan vermeld met kopieerknoppen. Dit is de aanbevolen optie voor een subdomein.

   Kies er een en klik op Domein koppelen.

   Note

   Voor een domein waarvan de registratie of de DNS-zone buiten je workspace ligt, wordt de nameserver-optie niet aangeboden — alleen het CNAME-record wordt getoond, zodat je kunt aantonen dat je het beheert zonder de zone van iemand anders over te nemen.

   Warning

   Als je DNS bij Cloudflare staat, schakel dan niet de oranje-cloud-proxy in op dit record. Laat het ingesteld op DNS only — CloudPress bevestigt het domein door in het antwoord te zoeken naar de vingerafdruk van zijn eigen CDN, en een proxy ervoor verbergt die, waardoor het domein lijkt ergens anders naartoe te wijzen en er geen certificaat wordt uitgegeven.

6. Kijk hoe het live gaat. Na het versturen kom je op de eigen pagina van het domein, die zichzelf bijwerkt naarmate het werk vordert — je hoeft er niet te blijven. CloudPress mailt je zodra het domein live is.

Een domein toevoegen met de API

Je kunt het domein aanmaken en de teruggegeven taak pollen in plaats van het dashboard te gebruiken. provision_method moet de exacte string dns zijn om via nameservers te provisionen; elke andere waarde (of weglaten) wordt behandeld als cname:

curl -X POST \
  -H "Authorization: Bearer $CLOUDPRESS_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","provision_method":"dns"}' \
  https://my.cloudpress.com/api/sites/$SITE_ID/domains

De aanroep geeft 202 terug plus een taak die je kunt pollen tot deze is afgerond. Een dns-koppeling die bestaande records zou overschrijven in een zone die wij hosten, wordt afgewezen met conflicts_found; stuur de aanvraag opnieuw met replace_records op true om toch door te gaan. Zie Domains voor de volledige request/response-vorm, promotie en verwijdering.

Voortgang volgen op de pagina van het domein

Elk domein in Jouw domeinen is een link naar zijn eigen pagina. Die pagina toont de huidige status, een live beeld van wat CloudPress aan het doen is en — in elke staat — de beheeracties die worden beschreven in Het domein daarna beheren. Met Alle domeinen ga je terug naar de lijst.

Terwijl het instellen loopt, krijg je een kaart Installatievoortgang met vijf stappen:

Daarnaast vind je de koppelmethode, de SSL-status, wanneer er voor het laatst is gecontroleerd, en een knop Nu controleren als je niet op de volgende automatische controle wilt wachten.

Er kunnen nog drie andere statussen verschijnen:

• Probleem — CloudPress kan het domein na ongeveer vijf controles nog steeds niet bereiken. De pagina toont de reden, een lijst Wat te controleren (DNS verwijst naar ons, propagatie, geen parkeerpagina die verkeer onderschept), hoeveel pogingen er zijn gedaan, een knop Nu opnieuw controleren en een gedeelte Technische details. Het opnieuw proberen gaat automatisch door, met steeds grotere tussenpozen.

• Actie vereist — CloudPress heeft iets van je nodig. Meestal is dat het DNS TXT-record dat wordt beschreven onder Een SSL-certificaat vooraf uitgeven (optioneel). Het kan ook betekenen dat een CAA-record op je domein de uitgifte blokkeert: de pagina meldt dan "Een CAA-record blokkeert je certificaat" en geeft je een lijst Zo los je dit op plus een paneel Wat we hebben gevonden dat het aangetroffen record noemt en de certificaatautoriteiten die het op dit moment toestaat. Voeg onze certificaatautoriteit toe aan dat record of verwijder het record; CloudPress blijft het vanzelf opnieuw proberen, en met Nu opnieuw controleren sla je het wachten over.

• DNS-probleem — het certificaat is nog geldig, maar het domein wijst niet meer naar ons. CloudPress hercontroleert live domeinen ongeveer twee keer per dag en meldt dit pas nadat twee controles op rij zijn mislukt, dus een kortstondige hapering veroorzaakt het niet. De pagina toont Wijs het hierheen met het doel dat je DNS zou moeten gebruiken, en met Controleer nu opnieuw voer je de controle direct opnieuw uit en hoor je of het domein weer naar ons wijst.

Een SSL-certificaat vooraf uitgeven (optioneel)

Wil je een geldig certificaat voordat je verkeer naar je domein omleidt — om een HTTPS-onderbreking tijdens de overstap te voorkomen — dan kun je er een vooraf uitgeven met een DNS-01-challenge.

1. Klik op de pagina van het domein op SSL-certificaat vooraf uitgeven (geavanceerd). De knop verschijnt op de installatievoortgangs- en probleemweergave zolang de CDN van de site actief is, er nog geen certificaat is uitgegeven en er nog geen challenge loopt.

2. CloudPress genereert een TXT-record en de pagina schakelt over naar Domeineigendom verifiëren, waar het Type, de Naam en de Waarde van het record onder Voeg dit DNS-record toe worden getoond met kopieerknoppen.

3. Voeg dat record toe bij je DNS-provider en klik daarna op Ik heb het toegevoegd — nu verifiëren. Is het record nog niet zichtbaar, dan krijg je te horen dat het niet kon worden geverifieerd en dat je het opnieuw moet proberen zodra DNS is gepropageerd; CloudPress blijft ook zelf controleren en mailt je zodra het is geverifieerd.

Het domein daarna beheren

De eigen pagina van het domein draagt deze acties in de kop, in elke staat:

• DNS beheren opent de DNS-records voor het domein, wanneer CloudPress de zone ervan host. Zie DNS beheren.
• Maak primair promoveert een alias tot het primaire domein van de site, na een bevestiging.
• Domein verwijderen ontkoppelt het van de site, na een bevestiging. Verwijder je het primaire domein, dan valt de site terug op zijn CloudPress-systeemadres — promoveer eerst een vervanger.

Zodra het domein live is, biedt de pagina ervan ook Bekijken om de site in een nieuw tabblad te openen.

Volgende stappen

• Laat je records verwijzen of bewerk ze in DNS beheren
• Heb je het domein nog niet? Koop een domein
• Automatiseer het met de Domains API