Een domein aan een site toevoegen

Deze gids loodst je door het koppelen van een domein dat je al bezit aan een SuperSpace-site, het laten verwijzen van je DNS naar ons, en het automatisch laten aanmaken van een SSL-certificaat door SuperSpace. Aan het eind bereiken bezoekers je site via HTTPS op je eigen domein in plaats van op de tijdelijke SuperSpace-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 Domain Management.

2. Begin met het toevoegen van een domein. Klik op Add Domain. Het eerste domein dat je toevoegt, vult de tabel Primary Domain; latere domeinen worden toegevoegd als Domain Aliases (extra domeinen die naar dezelfde site verwijzen).

3. Voer het domein in. Typ in het veld Domain het registreerbare domein dat je wilt gebruiken (bijvoorbeeld example.com) en klik daarna op Continue. SuperSpace controleert het domein en toont je de volgende stap op basis van wat het vindt.

   Note

   Voer het apex-domein in, niet een subdomein. Een voorafgaande www. wordt automatisch verwijderd (dus www.example.com wordt behandeld als example.com), en elk ander subdomein (zoals blog.example.com) wordt geweigerd.

4. Kies hoe je het wilt verbinden. Wat SuperSpace vervolgens toont, hangt af van wat de controle voor dat domein heeft gevonden:

   • Al in je SuperSpace-workspace — je ziet "example.com is already in your workspace" met een knop Connect domain. Door het te verbinden laat je de bestaande DNS-zone naar deze site verwijzen.

     Warning

     Het verbinden van een domein dat al een DNS-zone in je workspace heeft, overschrijft de bestaande DNS-records in die zone. Je wordt gevraagd dit te bevestigen voordat het wordt uitgevoerd.

   • Beschikbaar om te registreren — je ziet een aanbod "Register example.com" met een knop Register this domain (en de registratieprijs). Dit domein is nog nergens geregistreerd, dus de DNS-verwijzingsopties hieronder verschijnen niet — registreer het eerst (zie Een domein kopen), waarna het in je workspace staat.

   • Elders geregistreerd — je ziet een aanbod "Transfer example.com to your account" met een knop Transfer this domain. Wil je het domein liever bij je huidige registrar houden, sla de verhuizing dan over en ga verder naar de volgende stap om het bestaande domein in plaats daarvan naar SuperSpace te laten verwijzen.

   De opties onder Confirm DNS Settings for New Domain in de volgende stap verschijnen voor een elders geregistreerd domein (en blijven beschikbaar, ook als het domein niet kan worden verhuisd). Ze verschijnen niet voor een domein dat beschikbaar is om te registreren of voor een domein dat al in je workspace staat.

5. Laat je DNS naar SuperSpace verwijzen (elders geregistreerde domeinen). Gebruik een van deze twee methodes vanaf het scherm Confirm DNS Settings for New Domain:

   • Nameservers (aanbevolen). Stel onder Update Domain Name Servers (Recommended) de nameservers van je domein bij je registrar in op de twee die op het scherm worden getoond, en klik daarna op Create Domain. De exacte nameservers staan op het scherm — ze zijn specifiek voor je account, dus gebruik de getoonde waarden in plaats van waarden uit deze gids. Met SuperSpace-nameservers kunnen wij de volledige DNS-zone voor je beheren.

   • CNAME (DNS bij je huidige provider houden). Open Alternate Method: Create a CNAME, voeg een CNAME-record voor je domein toe dat verwijst naar het op het scherm getoonde doel, en klik daarna op Create using the alternate CNAME method.

     Warning

     Als je DNS bij Cloudflare staat, schakel dan niet de oranje-cloud-proxy in op dit record. Laat het ingesteld op DNS only, anders mislukt de uitgifte van het certificaat en de routering naar de origin.

6. Wacht op de provisioning. Een domein toevoegen verloopt asynchroon — SuperSpace maakt een achtergrondtaak aan en brengt je terug naar de pagina Domain Management, waar het nieuwe domein met een status verschijnt. De status van het domein wordt bijgewerkt naarmate het werk wordt afgerond.¹

SuperSpace genereert je SSL-certificaat automatisch zodra het de juiste DNS-instellingen detecteert, dus zodra je nameserver- of CNAME-wijziging is gepropageerd, wordt het certificaat uitgegeven zonder verdere actie. Houd de Status van het domein op de pagina Domain Management in de gaten om de voortgang te volgen.

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 $SUPERSPACE_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","provision_method":"dns"}' \
  https://control.superspace.nl/api/sites/$SITE_ID/domains

De aanroep geeft 202 terug plus een taak die je kunt pollen tot deze is afgerond. Zie Domains voor de volledige request/response-vorm, promotie en verwijdering.

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. Dit is beschikbaar zodra de CDN van de site actief is en er nog geen certificaat is uitgegeven.

1. Klik op de pagina Domain Management op Pre-issue SSL naast het domein.

2. Klik op Request certificate. SuperSpace genereert een TXT-record (een Name en een Value) die je kunt kopiëren.

3. Voeg dat TXT-record toe bij je DNS-provider en klik daarna op Verify & complete. Er is geen automatische polling — klik op verify zodra het record live is. Wanneer het valideert, toont het paneel Certificate issued.

Het domein daarna beheren

• Zodra een domein een SuperSpace-DNS-zone heeft, verschijnt er een knop Manage ernaast om DNS-records te bewerken. Zie DNS beheren.
• Om te wisselen welk domein primair is, gebruik je Make Primary op een alias.
• Delete verwijdert een domein van de site; als je het primaire domein verwijdert, valt de site terug op zijn tijdelijke SuperSpace-URL. Promoot een vervanger tot primair domein voordat je het oude verwijdert.

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