Traduit automatiquement de l’anglais.

Lire en anglais
Proxy Mail QA

Laisser passer les adresses de test malgré un blocage des e-mails jetables, en développement uniquement

Bloquer les adresses jetables écarte les faux comptes de votre application en production. Cela écarte aussi vos propres tests. La solution n’est pas de désactiver le blocage : c’est une courte liste d’autorisation qui n’existe qu’en développement et en préproduction.

Mis à jour le

De nombreux formulaires d’inscription refusent les adresses sur des domaines connus pour les e-mails jetables. La vérification peut être une liste dans votre code, un package comme une liste de domaines jetables, un paramètre de votre fournisseur d’authentification, ou un service de vérification d’e-mails appelé par votre formulaire. Les domaines de Proxy Mail QA peuvent se retrouver sur ces listes, car n’importe qui peut y créer une adresse.

Gardez le blocage, ajoutez une liste d’autorisation pour les environnements de test

Le blocage fait son travail en production. Il vous faut une courte liste de domaines qui y échappent, lue depuis une variable d’environnement que seuls le développement et la préproduction définissent :

// Read once at start-up. Unset in production, so the list is empty there.
const TEST_DOMAINS = (process.env.ALLOW_TEST_EMAIL_DOMAINS ?? '')
.split(',')
.map((domain) => domain.trim().toLowerCase())
.filter(Boolean);
export function isBlockedDomain(email: string, blocked: Set<string>): boolean {
const domain = email.split('@').pop()?.toLowerCase() ?? '';
if (TEST_DOMAINS.includes(domain)) return false;
return blocked.has(domain);
}

Puis, en développement et en préproduction uniquement :

ALLOW_TEST_EMAIL_DOMAINS=mailclub.dev,enable.li,valida.te.it
  • Nommez les domaines, pas un motif. Autorisez exactement les domaines avec lesquels vous testez, jamais *.dev ni tout domaine contenant un point.
  • Lisez-la côté serveur. Une vérification exécutée uniquement dans le navigateur est contournée par quiconque envoie le formulaire directement, en production aussi.
  • Échouez en mode fermé. Si la variable est absente, la liste est vide et le blocage s’applique ; un paramètre manquant ne peut donc pas ouvrir la production.

Si le blocage se trouve dans un service que vous appelez

Les services de vérification d’e-mails et les fournisseurs d’authentification ont généralement leur propre liste d’autorisation. Ajoutez-y nos domaines dans le projet de développement ou de préproduction uniquement, si le fournisseur les sépare. Quand un seul paramètre couvre tous les environnements, désactivez la vérification du service en développement et en préproduction et laissez-la active en production, ou sautez l’appel quand la variable d’environnement ci-dessus liste le domaine.

Vérifiez ce que voit l’utilisateur

Pendant que vous y êtes, testez le blocage lui-même :

  • Une adresse sur un domaine bloqué est refusée avec un message qui indique quoi faire (« Utilisez votre adresse e-mail professionnelle ou personnelle »), pas une erreur générique.
  • Le refus a lieu avant la création du compte, pour qu’aucun utilisateur à moitié créé ne reste.
  • L’adresse d’une vraie personne avec un tag + (name+news@example.org) passe toujours, sauf si vous avez décidé de refuser aussi celles-là.

Pour la validation propre au formulaire, les adresses inhabituelles mais valides couvrent les majuscules, les tags + et un domaine en trois parties.

Essayez-le lors de votre prochain test d’inscription

Offre gratuite, sans carte bancaire. Créez une adresse et regardez arriver le code ou le lien.

Créer un compte gratuitOuvrir l'application

Questions

Quels domaines les adresses Proxy Mail QA utilisent-elles ?

mailclub.dev, enable.li et valida.te.it. Un projet en choisit un comme domaine de messagerie dans Project settings, et le sélecteur de domaine d’Add account le change pour une adresse.

Dois-je aussi autoriser ces domaines en production ?

Non. Proxy Mail QA sert au développement, à la préproduction et aux versions de prévisualisation de votre application. Gardez la liste d’autorisation hors de vos paramètres de production, pour que l’application en production traite nos domaines comme n’importe quel autre domaine jetable.

Mon formulaire refuse l’adresse avant même de consulter une liste. Pourquoi ?

Certains formulaires vérifient la forme de l’adresse plutôt que le domaine : ils refusent un tag +, un domaine avec plus d’un point, ou un domaine qu’ils ne reconnaissent pas. Essayez d’abord l’adresse sur mailclub.dev ; si elle est aussi refusée, le problème vient de la validation du formulaire, pas d’une liste de blocage.

Puis-je vérifier que le blocage fonctionne toujours ?

Oui. Avec la liste d’autorisation active, inscrivez-vous avec une adresse sur un domaine jetable connu qui ne figure pas sur votre liste : le formulaire doit la refuser avec un message clair. Utilisez un domaine qui ne reçoit aucun e-mail, pour que rien n’atteigne un inconnu.

Vous avez créé votre application avec un outil d’IA ? Choisissez le vôtre

Une question sur cette page ?

Posez votre question dans la langue de votre choix. La documentation peut y répondre tout de suite, ou vous pouvez l'envoyer à l'équipe Proxy Mail QA, qui répond en anglais.

Interroger la documentation