E-maildomeinen verifiëren
Een e-maildomein verifiëren bewijst dat je organisatie het bezit. Je voegt een DNS TXT-record toe dat XFA opzoekt. Een geverifieerd domein toont een groene status Geverifieerd onder Instellingen → Domeinen, en je kunt het aanmelden en de onboarding via een identity provider (IdP) beperken tot geverifieerde domeinen.
Voor je begint
- Je bent beheerder van je organisatie in XFA.
- Je kunt de DNS-records van het domein bewerken.
- Het domein is een van de e-maildomeinen van je organisatie, vermeld onder Instellingen → Domeinen. Klik op Domein toevoegen om er een toe te voegen. De IdP-gidsen aanvaarden deze naast de Toegestane e-maildomeinen van elke koppeling. Openbare e-mailproviders zoals
gmail.comofoutlook.comkunnen niet worden toegevoegd: XFA antwoordt "Dit is een publieke e-mailprovider. Voeg het eigen domein van uw organisatie toe."
Het record
| Veld | Waarde |
|---|---|
| Type | TXT |
| Host | _xfa-<label> (de volledige naam is _xfa-<label>.<domain>) |
| Waarde | xfa-domain-verification=<token> |
Het label en het token zijn specifiek voor je organisatie en het domein, dus de host is voor elke organisatie en elk domein anders, bijvoorbeeld _xfa-k7q2m4x9p3r5t6v8 voor acme.com. Niemand kan aan de DNS zien welke domeinen XFA gebruiken. Open Instellingen → Domeinen, klik naast het domein op Verifiëren en gebruik Host kopiëren en Waarde kopiëren in het dialoogvenster om ze exact zoals getoond te kopiëren. Het dialoogvenster toont onder Host ook de volledige naam van het record.
Voer de host in ten opzichte van je DNS-zone. Is het e-maildomein de zone zelf, zoals acme.com in de zone acme.com, dan is dat de gekopieerde host. Is het e-maildomein een subdomein dat in een bovenliggende zone wordt gehost, voeg het subdomein dan toe aan de host. Voor staff.example.com in de zone example.com is de naam _xfa-<label>.staff. Controleer of de volledige naam die je DNS-provider toont overeenkomt met de volledige naam in het dialoogvenster.
Je kunt andere TXT-records op dezelfde naam hebben, zoals SPF of andere verificatierecords. XFA zoekt naar het record met exact die waarde.
Het record toevoegen
Waar je het record toevoegt, hangt af van wie je DNS host. Staan je domeinnaam en DNS bij verschillende bedrijven, gebruik dan het bedrijf dat de DNS host (de name servers).
Cloudflare
- Open het domein in het Cloudflare-dashboard en ga naar DNS → Records.
- Klik op Add record.
- Zet Type op
TXT, voer de host in Name in zoals beschreven in Het record en plak de waarde in Content. - Klik op Save.
Google Domains en Squarespace
Google Domains heet nu Squarespace Domains.
- Open het domein en ga naar DNS → DNS settings.
- Klik onder Custom records op Add record.
- Zet Type op
TXT, voer de host in Host in zoals beschreven in Het record en plak de waarde in Data. - Klik op Save.
GoDaddy
- Open het domein en ga naar DNS.
- Klik op Add New Record.
- Zet Type op
TXT, voer de host in Name in zoals beschreven in Het record en plak de waarde in Value. - Klik op Save.
Amazon Route 53
- Open de hosted zone van het domein.
- Klik op Create record.
- Voer de host in Record name in zoals beschreven in Het record, zet Record type op
TXTen plak de waarde in Value. Laat de waarde tussen dubbele aanhalingstekens staan als de console erom vraagt. - Klik op Create records.
DNS-wijzigingen kunnen tot een uur duren voor ze XFA bereiken.
Het record controleren
- Ga naar Instellingen → Domeinen.
- Klik naast het domein op Verifiëren.
- Klik op Nu controleren.
Wordt het record gevonden, dan bevestigt het dialoogvenster Domein geverifieerd en toont het domein Geverifieerd. Anders vertelt het dialoogvenster je waarom:
| Bericht | Wat het betekent |
|---|---|
Nog geen TXT-record gevonden op _xfa-k7q2m4x9p3r5t6v8.acme.com | XFA vond geen record op de naam die het dialoogvenster toont. Controleer de host en wacht tot DNS bijgewerkt is. |
| Het record is gevonden, maar de waarde komt niet overeen | Er bestaat een record, maar met een andere waarde, vaak een token van een eerdere poging. Kopieer de waarde opnieuw uit het dialoogvenster. |
| De opzoeking is mislukt, probeer het zo opnieuw | De DNS-opzoeking werd niet afgerond. Klik zo opnieuw op Nu controleren. |
De kolom Status in Instellingen → Domeinen bewaart de reden van de laatste controle onder een niet-geverifieerd domein: Geen TXT-record gevonden, Recordwaarde komt niet overeen of DNS-opzoeking mislukt. Laatst gecontroleerd toont wanneer.
Alleen geverifieerde domeinen kunnen aanmelden
De schakelaar Alleen geverifieerde domeinen kunnen aanmelden in Instellingen → Domeinen verschijnt zodra minstens één domein geverifieerd is. Hij staat uit voor organisaties die bestonden vóór de domeinverificatie, en standaard aan voor nieuwe organisaties. Staat hij aan, dan kunnen mensen alleen aanmelden of onboarden via je identity providers met een e-mailadres op een geverifieerd domein. De schakelaar wordt direct opgeslagen zodra je hem wijzigt. Voor hij aangaat, vraagt XFA Mensen op niet-geverifieerde domeinen buitensluiten? en vertelt het hoeveel ingerichte gebruikers op niet-geverifieerde domeinen niet meer kunnen aanmelden tot die domeinen geverifieerd zijn. Klik op Inschakelen om te bevestigen.
De schakelaar beperkt de e-maildomeinen van de organisatie. Een domein dat bij Toegestane e-maildomeinen van een koppeling staat, blijft voor die koppeling toegestaan, geverifieerd of niet. Verwijder nadat je de domeinen van je organisatie hebt geverifieerd de vermeldingen die ze herhalen uit de koppelingen, zodat verificatie beslist.
Staat de schakelaar uit, dan is verificatie louter informatief: niet-geverifieerde domeinen blijven werken.
Wekelijkse hercontrole
XFA controleert het record van elk geverifieerd domein één keer per week. Laat het record dus staan.
- Na drie mislukte controles op rij blijft het domein geverifieerd en krijgen alle beheerders een waarschuwingsmail.
- Na de vierde toont het domein Verificatie verloren en krijgen alle beheerders een tweede e-mail die het record noemt dat je moet herstellen. Staat Alleen geverifieerde domeinen kunnen aanmelden aan, dan stopt het aanmelden via het domein, tenzij een koppeling het domein nog vermeldt bij Toegestane e-maildomeinen. Staat hij uit, dan verandert er verder niets.
Wil je het domein terug, herstel dan het record en klik naast het domein op Verifiëren en op Nu controleren.
Meerdere organisaties op één domein
Meerdere organisaties kunnen hetzelfde domein verifiëren. Beheer je meerdere XFA-organisaties, bijvoorbeeld één per dochterbedrijf, voeg het domein dan toe en verifieer het in elk ervan. Elke organisatie krijgt een eigen record, en de records bestaan naast elkaar in de zone.
Opmerkingen en probleemoplossing
- De host en het token horen bij één organisatie en domein. Kopieer ze opnieuw uit het dialoogvenster als je niet zeker weet welk record van jou is.
- Sommige DNS-panelen voegen het domein zelf aan de host toe. Vindt Nu controleren niets, controleer dan of het record niet op
_xfa-k7q2m4x9p3r5t6v8.acme.com.acme.comstaat. - De waarde moet exact overeenkomen, zonder extra spaties of aanhalingstekens erin.