Refusez une inscription Auth0 dont l'adresse ne peut pas recevoir d'emails : une Action Pre User Registration interroge PricklyMails avant de créer le compte.
Pas besoin de connecteur : à chaque inscription, Auth0 appelle l'API PricklyMails depuis une Action Pre User Registration, et une adresse qui ne peut pas recevoir d'emails est refusée avant que le compte n'existe.
pm_test_, répond par des résultats prédéfinis, ne facture rien et ne contacte aucun serveur de messagerie.Astuce
L'offre Free ne compte qu'une clé : une fois que tout fonctionne, révoquez la clé de test, puis créez-en une en Production.
La clé va dans les secrets de l'Action, qu'Auth0 chiffre et n'affiche plus jamais : elle reste ainsi hors du code.
pricklymails-check, puis choisissez Pre User Registration comme Trigger et Node 22 comme Runtime.PRICKLYMAILS_KEY comme Name et votre clé de test comme Value, puis sélectionnez Create.Le code demande à PricklyMails de répondre en quelques secondes (Prefer: wait) et cesse d'attendre peu après, pour qu'une inscription ne reste jamais suspendue à la réponse. Il ne refuse l'inscription que si la recommandation est remove, et la laisse passer sinon : adresse risquée, pas de réponse à temps, erreur.
const VERIFY_URL = 'https://api.pricklymails.com/api/verify'
const REFUSAL =
'This email address cannot receive mail. ' +
'Check it for a typo, or use another one.'
// Auth0 gives the trigger 20 seconds: wait 4 for the answer, give up at 5.
async function recommendationFor(email, key) {
try {
const response = await fetch(VERIFY_URL, {
method: 'POST',
headers: {
Authorization: `Bearer ${key}`,
'Content-Type': 'application/json',
Prefer: 'wait=4',
},
body: JSON.stringify({ email }),
signal: AbortSignal.timeout(5000),
})
if (200 !== response.status) {
return null
}
const { verification } = await response.json()
return verification?.recommendation ?? null
} catch {
return null
}
}
exports.onExecutePreUserRegistration = async (event, api) => {
const email = event.user.email
const key = event.secrets.PRICKLYMAILS_KEY
if (email && 'remove' === (await recommendationFor(email, key))) {
api.access.deny('undeliverable_email', REFUSAL)
}
}
Astuce
Avant de déployer, vous pouvez lancer le code depuis l'éditeur : sélectionnez Test (l'icône de lecture) dans sa barre latérale, remplacez l'email de l'utilisateur dans le payload par invalid@example.com, puis sélectionnez Run. Les résultats montrent les étapes suivies par l'Action.
Auth0 n'exécute que la version déployée d'une Action, et seulement une fois qu'elle est placée dans le flux d'un déclencheur.
pricklymails-check dans le flux, entre Start et Complete.Attention
Les secrets suivent les versions de l'Action, et une modification ne s'applique qu'une fois déployée : quand vous remplacez la clé de test par votre clé live, sélectionnez de nouveau Deploy.
invalid, comme invalid@example.com : la clé de test répond remove, et l'inscription est refusée.valid@example.com : le compte est créé.pm_live_ : dès lors, chaque inscription est vérifiée pour de vrai et facturée comme toute vérification.Le code lit la recommandation que l'API donne pour l'adresse, la même que dans le rapport d'une liste.
Refusée : l'adresse n'existe pas, son domaine ne peut pas recevoir d'emails, ou elle est jetable.
Auth0 arrête l'inscription sur-le-champ et ne crée aucun compte. D'après sa documentation, le message passé à api.access.deny peut être affiché tel quel à la personne qui s'inscrit, et la raison, undeliverable_email, est conservée dans les journaux de votre tenant.
Acceptée : domaine qui accepte toutes les adresses, adresse générique comme contact@, ou serveur qui n'a pas répondu. L'adresse peut fonctionner.
Acceptée : l'adresse est valide, ou hébergée chez un grand fournisseur qui accepte toutes les adresses.
Celles qui passent par une connexion Database, avec un email et un mot de passe par exemple, ou par une connexion Passwordless : Auth0 n'exécute le déclencheur Pre User Registration que pour elles, avant la création de l'utilisateur. Une personne qui s'inscrit par une connexion sociale ou d'entreprise n'y passe jamais, pas plus qu'une importation groupée d'utilisateurs : ces comptes sont créés sans vérification. Une inscription sans adresse email, par numéro de téléphone par exemple, est laissée passer par le code.
Dans Monitoring puis api.access.deny, undeliverable_email. Sélectionnez l'événement, puis la vue Action Details, pour voir comment l'Action s'est exécutée et les erreurs éventuelles.
Auth0 les exécute l'une après l'autre, dans l'ordre où elles sont placées dans le flux, et un appel à api.access.deny arrête l'inscription sur-le-champ : aucune Action suivante ne s'exécute. Les 20 secondes accordées par Auth0 valent pour chaque exécution du déclencheur, toutes ses Actions comprises, et le code en prend 5 au plus. Placée en premier, pricklymails-check refuse une adresse avant que les autres ne s'exécutent.
Non, et il n'y a rien à installer : le code ci-dessus appelle l'API PricklyMails avec votre clé.
Ces marques appartiennent à leurs propriétaires respectifs. Les citer n'implique aucun partenariat.
1 000 jetons offerts à l'inscription, sans carte bancaire. Ensuite, vous ne payez que les réponses.