Vérifier les domaines d'e-mail
Vérifier un domaine d'e-mail prouve que votre organisation le possède. Vous ajoutez un enregistrement DNS TXT que XFA consulte. Un domaine vérifié affiche un statut vert Vérifié dans Paramètres → Domaines, et vous pouvez limiter la connexion et l'onboarding via un fournisseur d'identité (IdP) aux domaines vérifiés.
Avant de commencer
- Vous êtes administrateur de votre organisation dans XFA.
- Vous pouvez modifier les enregistrements DNS du domaine.
- Le domaine fait partie des domaines d'e-mail de votre organisation, listés sous Paramètres → Domaines. Cliquez sur Ajouter un domaine pour en ajouter un. Les guides IdP les acceptent en plus des Domaines d'e-mail autorisés de chaque connexion. Les fournisseurs d'e-mail publics comme
gmail.comououtlook.comne peuvent pas être ajoutés : XFA répond « Il s'agit d'un fournisseur de messagerie public. Ajoutez le domaine propre à votre organisation. »
L'enregistrement
| Champ | Valeur |
|---|---|
| Type | TXT |
| Hôte | _xfa-<label> (le nom complet est _xfa-<label>.<domain>) |
| Valeur | xfa-domain-verification=<token> |
Le label et le jeton sont propres à votre organisation et au domaine, donc l'hôte est différent pour chaque organisation et chaque domaine, par exemple _xfa-k7q2m4x9p3r5t6v8 pour acme.com. Personne ne peut deviner depuis le DNS quels domaines utilisent XFA. Ouvrez Paramètres → Domaines, cliquez sur Vérifier à côté du domaine, puis utilisez Copier l'hôte et Copier la valeur dans la boîte de dialogue pour les copier exactement comme affichés. La boîte de dialogue affiche aussi le nom complet de l'enregistrement sous Hôte.
Saisissez l'hôte relativement à votre zone DNS. Lorsque le domaine d'e-mail est la zone elle-même, comme acme.com dans la zone acme.com, il s'agit de l'hôte copié. Lorsque le domaine d'e-mail est un sous-domaine hébergé dans une zone parente, ajoutez le sous-domaine à l'hôte. Pour staff.example.com dans la zone example.com, le nom est _xfa-<label>.staff. Vérifiez que le nom complet affiché par votre fournisseur DNS correspond au nom complet de la boîte de dialogue.
Vous pouvez avoir d'autres enregistrements TXT sous le même nom, comme SPF ou d'autres enregistrements de vérification. XFA recherche celui qui a exactement la bonne valeur.
Ajouter l'enregistrement
L'endroit où ajouter l'enregistrement dépend de qui héberge votre DNS. Si votre nom de domaine et votre DNS sont chez des sociétés différentes, utilisez celle qui héberge le DNS (les serveurs de noms).
Cloudflare
- Ouvrez le domaine dans le tableau de bord Cloudflare et allez dans DNS → Records.
- Cliquez sur Add record.
- Définissez Type sur
TXT, saisissez l'hôte dans Name comme décrit dans L'enregistrement, et collez la valeur dans Content. - Cliquez sur Save.
Google Domains et Squarespace
Google Domains est désormais Squarespace Domains.
- Ouvrez le domaine et allez dans DNS → DNS settings.
- Sous Custom records, cliquez sur Add record.
- Définissez Type sur
TXT, saisissez l'hôte dans Host comme décrit dans L'enregistrement, et collez la valeur dans Data. - Cliquez sur Save.
GoDaddy
- Ouvrez le domaine et allez dans DNS.
- Cliquez sur Add New Record.
- Définissez Type sur
TXT, saisissez l'hôte dans Name comme décrit dans L'enregistrement, et collez la valeur dans Value. - Cliquez sur Save.
Amazon Route 53
- Ouvrez la zone hébergée du domaine.
- Cliquez sur Create record.
- Saisissez l'hôte dans Record name comme décrit dans L'enregistrement, définissez Record type sur
TXT, et collez la valeur dans Value. Gardez la valeur entre guillemets doubles si la console les demande. - Cliquez sur Create records.
Les modifications DNS peuvent mettre jusqu'à une heure pour parvenir à XFA.
Vérifier l'enregistrement
- Allez dans Paramètres → Domaines.
- Cliquez sur Vérifier à côté du domaine.
- Cliquez sur Vérifier maintenant.
Lorsque l'enregistrement est trouvé, la boîte de dialogue confirme Domaine vérifié et le domaine affiche Vérifié. Sinon, la boîte de dialogue vous en indique la raison :
| Message | Signification |
|---|---|
Aucun enregistrement TXT trouvé pour _xfa-k7q2m4x9p3r5t6v8.acme.com pour le moment | XFA n'a trouvé aucun enregistrement au nom indiqué dans la boîte de dialogue. Vérifiez l'hôte et attendez que le DNS se propage. |
| L'enregistrement a été trouvé, mais sa valeur ne correspond pas | Un enregistrement existe, mais avec une autre valeur, souvent un jeton d'une tentative précédente. Copiez à nouveau la valeur depuis la boîte de dialogue. |
| La recherche a échoué, réessayez dans un instant. | La recherche DNS n'a pas abouti. Cliquez à nouveau sur Vérifier maintenant dans un instant. |
La colonne Statut de Paramètres → Domaines conserve la raison de la dernière vérification sous un domaine non vérifié : Aucun enregistrement TXT trouvé, La valeur de l'enregistrement ne correspond pas ou Échec de la recherche DNS. Dernière vérification indique quand.
Seuls les domaines vérifiés peuvent se connecter
Le commutateur Seuls les domaines vérifiés peuvent se connecter dans Paramètres → Domaines apparaît dès qu'au moins un domaine est vérifié. Il est désactivé pour les organisations qui existaient avant la vérification des domaines, et activé par défaut pour les nouvelles organisations. Lorsqu'il est activé, les personnes ne peuvent se connecter ou s'intégrer via vos fournisseurs d'identité qu'avec une adresse e-mail d'un domaine vérifié. Le commutateur s'enregistre dès que vous le modifiez. Avant son activation, XFA demande Bloquer les personnes des domaines non vérifiés ? et vous indique combien d'utilisateurs provisionnés de domaines non vérifiés ne pourront plus se connecter tant que ces domaines ne sont pas vérifiés. Cliquez sur Activer pour confirmer.
Le commutateur limite les domaines d'e-mail de l'organisation. Un domaine listé dans les Domaines d'e-mail autorisés d'une connexion reste autorisé pour cette connexion, vérifié ou non. Après avoir vérifié les domaines de votre organisation, supprimez des connexions les entrées qui les répètent, afin que la vérification décide.
Lorsque le commutateur est désactivé, la vérification est purement informative : les domaines non vérifiés continuent de fonctionner.
Revérification hebdomadaire
XFA vérifie l'enregistrement de chaque domaine vérifié une fois par semaine. Laissez l'enregistrement en place.
- Après trois vérifications échouées d'affilée, le domaine reste vérifié et tous les administrateurs reçoivent un e-mail d'avertissement.
- Après la quatrième, le domaine affiche Vérification perdue et tous les administrateurs reçoivent un second e-mail qui nomme l'enregistrement à rétablir. Si Seuls les domaines vérifiés peuvent se connecter est activé, la connexion via le domaine s'arrête, sauf si une connexion liste encore le domaine dans ses Domaines d'e-mail autorisés. S'il est désactivé, rien d'autre ne change.
Pour récupérer le domaine, rétablissez l'enregistrement, puis cliquez sur Vérifier à côté du domaine et sur Vérifier maintenant.
Plusieurs organisations sur un même domaine
Plusieurs organisations peuvent vérifier le même domaine. Si vous gérez plusieurs organisations XFA, par exemple une par filiale, ajoutez et vérifiez le domaine dans chacune d'elles. Chacune obtient son propre enregistrement, et les enregistrements coexistent dans la zone.
Notes et dépannage
- L'hôte et le jeton appartiennent à une seule organisation et à un seul domaine. Copiez-les à nouveau depuis la boîte de dialogue si vous ne savez pas quel enregistrement est le vôtre.
- Certains panneaux DNS ajoutent d'eux-mêmes le domaine à l'hôte. Si Vérifier maintenant ne trouve rien, vérifiez que l'enregistrement n'est pas sous
_xfa-k7q2m4x9p3r5t6v8.acme.com.acme.com. - La valeur doit correspondre exactement, sans espaces superflus ni guillemets à l'intérieur.