Ga naar inhoud

Je domein verifiëren

Voordat CloudPress mail voor een domein gaat hosten, moet duidelijk zijn dat het domein echt van jou is. Voor de meeste bestellingen betekent dat één DNS-TXT-record publiceren en op een knop klikken. Deze handleiding loopt die stap door, van het record dat we je tonen tot het moment dat je mailomgeving klaar is met aanmaken.

Dit is een eenmalige controle per domein. Het record bewijst alleen het eigendom — het is geen onderdeel van de mailbezorging, en je kunt het daarna weghalen: We gebruiken deze record alleen om het eigendom te bevestigen. Je kunt hem verwijderen zodra je domein is geverifieerd. Het kan een paar minuten duren voordat DNS-wijzigingen zijn doorgevoerd.

Voordat je begint

  • Een betaalde mailbestelling. De mailomgeving zelf wordt pas aangemaakt nadat de betaling is verwerkt, en hij begint met wachten op verificatie als we het eigendom niet zelf kunnen bevestigen — zie Een mailomgeving bestellen.
  • De mogelijkheid om een DNS-record voor het domein toe te voegen, hier (als wij de DNS beheren) of daar waar de DNS wordt gehost.
  • Een rol in de workspace die wijzigingen mag maken. De verificatieactie is afgeschermd met rechten; een lid dat alleen mag meekijken en er toch op klikt, wordt teruggestuurd naar de Mailspace-lijst met Je hebt geen toestemming om deze actie uit te voeren.
  • Mailspace in de zijbalk van de workspace. Is e-mailhosting helemaal niet aangezet voor het dashboard, dan word je doorgestuurd met Mailspace is niet geconfigureerd. — neem contact op en we kijken het na.

Wanneer je moet verifiëren

We slaan de TXT-stap alleen over als het domein bij ons is geregistreerd — door deze workspace of door een andere in dezelfde facturatiefamilie. Dat is het enige signaal dat bewijst dat jij het domein beheert zonder dat we je er iets voor hoeven te vragen. De DNS-zone van het domein bij ons hosten is bewust niet genoeg op zichzelf: een zone aanmaken vereist alleen bewerkrechten en een geldige TLD, dus daarmee is een echte eigenaar niet te onderscheiden van iemand die een domein intypt dat hij niet beheert.

In de praktijk dus:

Het domein is… Wat er gebeurt
Bij ons geregistreerd Meteen als geverifieerd gemarkeerd; de mailomgeving gaat direct door naar aanmaken
Elders geregistreerd, DNS bij ons gehost Jij voegt het TXT-record toe (dat kan hier)
Elders geregistreerd en gehost Jij voegt het TXT-record toe bij je DNS-provider

De badge kan hoe dan ook even verschijnen

De mailomgeving wordt op de achtergrond op de mailserver aangemaakt, dus de Mailspace-lijst toont de badge Wacht op verificatie bij elke mailomgeving die nog niet op de mailserver staat — ook bij een domein dat je al bezit, gedurende de paar momenten voordat het instellen klaar is. Zegt de pagina die je opent dat het domein al is geverifieerd, dan hoef je alleen te wachten.

Stappen

  1. Open de verificatiepagina. Kies Mailspace in de zijbalk van de workspace. De rij van de nieuwe mailomgeving heeft een badge Wacht op verificatie en de knop leest Domein verifiëren in plaats van Beheren. Klik erop. (Elke andere pagina van een nog niet afgeronde mailomgeving stuurt je hier ook naartoe, dus verdwalen kan niet.)

    De pagina heet example.com verifiëren, onder het opschrift Mailspace, met rechtsboven Terug naar overzicht.

  2. Lees de voortgang. De linkerkaart, Voortgang installatie, is een stappenteller met vier stappen — Besteld, Domein verifiëren, Instellen en Actief — waarbij de huidige stap draait. Zolang het eigendom niet is bevestigd staat er Voeg de onderstaande DNS TXT-record toe om eigendom te bevestigen en luidt de kop van de kaart We controleren automatisch….

    De kaart ernaast noemt drie gegevens: Verificatie (DNS TXT-record), Status (een pil met Verifiëren, Instellen of Actief) en Laatst gecontroleerd — Nog niet gecontroleerd tot de eerste poging.

  3. Kopieer het verificatierecord. Lager op de pagina bevat de kaart Verificatierecord precies één rij, met de kolommen Type, Naam / host en Waarde:

    Kolom Wat erin staat
    Type TXT
    Naam / host _mailspace-verify — met daaronder Volledige naam: met de hele host, bijvoorbeeld _mailspace-verify.example.com
    Waarde Een lange willekeurige token, uniek voor deze mailomgeving

    De host is altijd het vaste voorvoegsel _mailspace-verify gevolgd door het domein van je mailomgeving. Gebruik de knop Waarde kopiëren in plaats van de token over te typen.

  4. Voeg het record toe bij wie je DNS beheert.

    • Hosten wij de DNS van het domein, voeg het dan toe in de DNS-editor — zie DNS beheren. Kies TXT, zet _mailspace-verify in Record Name (de zonenaam wordt voor je toegevoegd) en plak de token in Content.
    • Ligt je DNS elders, voeg dan hetzelfde record toe bij je DNS-provider: een TXT-record, op de host die als Volledige naam wordt getoond, met de token als waarde. Beheerschermen verschillen — sommige vragen om de volledige host, andere alleen om het label _mailspace-verify, en het veld voor de waarde kan een andere naam hebben — dus zoek naar de drie onderdelen hierboven in plaats van naar identieke bewoordingen. Twijfel je, dan is de documentatie van je provider over het toevoegen van een TXT-record de plek om te kijken.

    Splitst je provider de waarde over meerdere strings, dan is dat geen probleem: we vergelijken de token met elke string én met het samengevoegde resultaat.

  5. Klik op Domein nu verifiëren. Gebruik terug op de verificatiepagina de knop Domein nu verifiëren. We bevragen meteen publieke DNS-resolvers — geen lokale cache — zodat een record dat je zojuist hebt toegevoegd niet achter een verouderd negatief antwoord blijft hangen.

    • Bij succes laadt de pagina opnieuw met Domain verified — we're setting up your mailspace account now.
    • Is het record nog niet zichtbaar, dan zie je We couldn't find the verification record yet. DNS changes can take a few minutes to propagate. Er gaat niets verloren — wacht even en probeer het opnieuw.
    • Mislukt de opzoeking zelf, dan zie je We couldn't complete the DNS lookup. Please try again shortly.

    Je hoeft niet op die knop te blijven drukken. We controleren elk wachtend domein zelf elke vijf minuten opnieuw, en de pagina zegt dat ook: We controleren ook zelf elke paar minuten opnieuw, dus je kunt deze pagina gerust verlaten en later terugkomen.

  6. Wacht tot de mailomgeving is aangemaakt. Zodra het eigendom is bevestigd, gaat dezelfde pagina vanzelf verder. De kop verandert in We maken je mailomgeving aan… en de notitie ernaast luidt example.com is geverifieerd. We maken nu je mailomgeving aan — dit duurt meestal minder dan een minuut en deze pagina werkt zichzelf bij. Verversen hoeft niet.

    Zodra het domein is geverifieerd, wordt Domein nu verifiëren vervangen door Installatie opnieuw proberen — de hele aanmaakfase lang, dus niet alleen als er iets is misgegaan. Klikken start het instellen opnieuw; er is geen tweede DNS-controle die je moet doorstaan. Gaat er wel iets mis, dan staat de status op Installatie gepauzeerd en markeert de stappenteller de stap waarop het is blijven steken.

  7. Ga door naar de mailomgeving. Als het klaar is, luidt de kop Helemaal klaar, staat de statuspil op Actief en biedt de pagina Verder naar je mailomgeving: example.com is klaar. Je mailomgeving is aangemaakt op de mailserver. Ga verder om mailboxen toe te voegen en de DNS af te ronden. Die knop brengt je naar de pagina met de mail-DNS-records van het domein zolang die records nog moeten worden ingesteld, en anders naar het overzicht van de mailomgeving. In de Mailspace-lijst leest de knop op de rij nu Beheren.

Als het nog steeds niet lukt

  • Controleer de host, niet alleen de waarde. Het record moet op de volledige naam staan die de pagina toont. In een editor die de zone voor je toevoegt, vul je alleen _mailspace-verify in; in een editor die de hele host wil, vul je _mailspace-verify.example.com in.
  • Geef het tijd. De voettekst van de pagina en de foutmelding zeggen hetzelfde — DNS-wijzigingen hebben een paar minuten nodig. Laatst gecontroleerd op de gegevenskaart vertelt je wanneer we hebben gekeken; elke poging, geslaagd of niet, werkt dat bij.
  • Laat het even en kom terug. De automatische hercontrole loopt elke vijf minuten. Voor een mailomgeving die al lang onbevestigd staat, stopt die sweep wel, maar de knop Domein nu verifiëren blijft werken — één klik en de controle loopt opnieuw.
  • Een tweede domein later toevoegen werkt hetzelfde. Een domein dat je aan een bestaande mailomgeving toevoegt en waarvan we het eigendom niet kunnen bevestigen, wordt geparkeerd met een eigen kaart Verificatierecord en een eigen knop Domein nu verifiëren, op een pagina die ook example.com verifiëren heet.

Van gedachten veranderd

Zolang een mailomgeving nog wacht op instellen, biedt de verificatiepagina ook Bestelling annuleren. Je wordt gevraagd je identiteit te bevestigen met je passkey of wachtwoord, als je dat niet recent hebt gedaan, en daarna volgt Deze mailomgeving annuleren? met de waarschuwing Je krijgt alles wat je hebt betaald terug als tegoed en deze mailomgeving (example.com) wordt verwijderd. Dit kan niet worden teruggedraaid. Alles wat daadwerkelijk voor de mailomgeving is betaald, komt terug als tegoed op de workspace en de mailomgeving stopt met verlengen.

Zodra het instellen klaar is, is die knop weg — een actieve mailomgeving verwijder je via de normale verwijderstroom. Zie Een mailomgeving verwijderen en herstellen.

Via de API

Er is geen API-aanroep die een verificatiecontrole start. Publiceer het TXT-record; de automatische hercontrole pikt het op.

Wat de API je wel geeft, is het record zelf. GET /api/mailspace/{id} geeft een blok verification terug — txt_prefix, txt_host, txt_value — zolang het domein op verificatie wacht. Het verdwijnt zodra het eigendom is bevestigd, dus behandel de afwezigheid ervan als "niets te publiceren" en niet als "nog niet klaar". De lijst- en detailpayloads bevatten ook de vlaggen needs_domain_verification, verified en provisioned die je kunt pollen.

curl -H "Authorization: Bearer $CLOUDPRESS_TOKEN" -H "X-Auth-Account: $ACCOUNT_ID" \
  "https://my.cloudpress.com/api/mailspace/$MAILSPACE_ID"

De API kan geen mail kopen voor een domein dat nergens is geregistreerd

POST /api/mailspace vereist dat het domein al bestaat — bij ons geregistreerd of bij een andere registrar — en weigert al het andere met domain_not_registered. De checkout van het dashboard werkt anders: die kan het domein registreren als onderdeel van dezelfde bestelling. Dat verschil gaat over kopen, niet over verifiëren; een domein dat bij een andere registrar staat, heeft deze TXT-stap nog steeds nodig, ongeacht hoe je hebt besteld.

Zie Mailspace voor de volledige payload en foutenlijst.

Volgende stappen

  • Rond de mail-DNS-records van het domein af — de MX-, SPF-, DKIM- en DMARC-records die de mailbezorging echt nodig heeft. Beheren wij de DNS van het domein, zie dan DNS beheren; anders voeg je ze toe bij je DNS-provider.
  • Maak je mailboxen aan — zie Mailboxen beheren.
  • Stel je mailprogramma in — zie Een mailclient verbinden.