Aller au contenu

Un test d’inscription qui attend le code et le saisit prouve le cas nominal. Les bugs que rencontrent les gens sont ailleurs : un code qui fonctionne deux fois, un ancien lien de réinitialisation qui définit encore un mot de passe, un lien magique consommé par un scanner de messagerie, un second compte qui peut lire les données du premier. Proxy Mail QA liste les vérifications de chaque parcours, avec les étapes pour les lancer et ce que l’app doit faire.

  • Un agent : get_flow_checks sur le MCP server, avec flow réglé sur sign_up, password_reset ou magic_link. L’agent lance chaque vérification avec ses outils de navigateur ou d’app et indique réussie, échouée ou ignorée.
  • Un test : qa.flowChecks('sign_up') dans le paquet npm, flow_checks("sign_up") dans l’utilitaire Python, ou GET /v1/flow-checks?flow=sign_up sur le REST API.

Chaque vérification comporte id (un nom stable, comme code_works_once), checks (ce qu’elle vérifie), steps, expect (ce que l’app doit faire) et why (ce qui ne va pas pour les gens sinon). Une vérification qui ne peut pas toujours être lancée a needs : ce dont elle a besoin, et quand l’ignorer en le signalant.

Les parties Proxy Mail QA des étapes sont les habituelles : créer une nouvelle adresse, noter l’heure juste avant l’envoi, attendre le code ou le lien avec since réglé sur cette heure, et compter les e-mails ou n’en attendre aucun.

Vérification Ce qui doit se passer
Un seul e-mail de confirmation arrive Exactement un e-mail, avec un code ou un lien, en moins d’une minute
Un code erroné est refusé Chaque code erroné est refusé avec un message, et après quelques essais l’app n’accepte plus de codes ou en demande un nouveau
Le code ne fonctionne qu’une fois Saisir à nouveau le même code après confirmation est refusé
Un code expiré est refusé Une fois passé le délai indiqué dans l’e-mail, le code est refusé avec un moyen d’en obtenir un nouveau
Après un renvoi, le code le plus récent fonctionne Le code le plus récent fonctionne et le premier est refusé. Si l’app accepte les deux, notez-le
Un compte non confirmé ne peut pas utiliser l’app L’app demande d’abord de confirmer l’e-mail et propose de le renvoyer
La confirmation connecte la personne La personne arrive connectée et le reste après un rechargement, ou arrive sur la connexion avec un message indiquant que l’e-mail est confirmé. Pas de page blanche, d’erreur ni de boucle de connexion
Se réinscrire avec la même adresse ne crée pas de second compte Le premier mot de passe fonctionne toujours et le second non. L’app indique que l’adresse est prise, ou affiche le message habituel et envoie un e-mail au titulaire
Une seconde personne ne peut pas voir les données de la première Connecté avec un second compte, ouvrir l’élément privé du premier compte renvoie « introuvable » ou « non autorisé », et il n’apparaît dans aucune liste ni recherche
Vérification Ce qui doit se passer
Il existe un moyen de réinitialiser un mot de passe La page de connexion propose une réinitialisation, et un seul e-mail de réinitialisation arrive en moins d’une minute
Une réinitialisation pour une adresse inconnue ne révèle rien La page affiche le même message que pour un vrai compte, et aucun lien de réinitialisation n’arrive
Le nouveau mot de passe fonctionne et l’ancien non Après la réinitialisation, l’ancien mot de passe est refusé et le nouveau fonctionne
Le lien de réinitialisation ne fonctionne qu’une fois Rouvrir le lien après avoir défini un mot de passe est refusé, avec une proposition d’en envoyer un nouveau
Seul le lien de réinitialisation le plus récent fonctionne Après deux demandes, le premier lien est refusé et le plus récent fonctionne
Un lien de réinitialisation expiré est refusé Une fois passé le délai indiqué dans l’e-mail, le lien est refusé avec un moyen d’en demander un nouveau
Le lien de réinitialisation fonctionne dans un autre navigateur La réinitialisation y fonctionne, ou la page indique clairement d’ouvrir le lien dans le navigateur d’où il a été demandé
Vérification Ce qui doit se passer
Le lien connecte la personne Connectée, et toujours connectée après un rechargement
Le lien échoue à sa deuxième utilisation Rouvert dans un autre navigateur, il ne connecte personne et indique qu’il a déjà été utilisé
Un scanner de messagerie qui ouvre le lien en premier ne le consomme pas Après une simple requête vers le lien, comme celle d’un scanner, le navigateur se connecte toujours : le lien ouvre une page avec un bouton, ou l’e-mail contient aussi un code
Seul le lien le plus récent fonctionne Après deux demandes, le premier lien est refusé et le plus récent connecte
Un lien expiré est refusé Une fois passé le délai indiqué dans l’e-mail, le lien est refusé avec un moyen d’en demander un nouveau
Le lien fonctionne dans un autre navigateur Connecté là-bas, ou un message clair invitant à ouvrir le lien dans le navigateur d’où il a été demandé

Proxy Mail QA n’ouvre jamais les liens de vos e-mails, donc ses propres vérifications ne peuvent pas en consommer un. La vérification du scanner de messagerie reproduit ce que fait un scanner de messagerie professionnelle ; Quand un scanner de messagerie ouvre le lien en premier explique pourquoi c’est important et comment les apps le contournent.

  • Utilisez une nouvelle adresse pour chaque vérification, afin qu’aucun e-mail antérieur ne corresponde et que le compte d’une vérification n’affecte pas la suivante.
  • Notez l’heure avant chaque envoi et passez-la comme since, pour qu’une attente après un renvoi ou une seconde demande trouve l’e-mail le plus récent, pas le premier.
  • Ignorez ce qui ne peut pas être lancé, et dites pourquoi. Une expiration d’une heure est trop longue pour la plupart des tests : ignorez la vérification d’expiration et signalez-la comme ignorée. Ne modifiez jamais les réglages de l’app, comme raccourcir l’expiration ou désactiver la confirmation par e-mail, pour faire réussir une vérification.
  • Uniquement via l’app. La vérification à deux utilisateurs ouvre des pages et répète des requêtes que l’app fait elle-même, connectée avec le second compte. Elle ne lit jamais la base de données de l’app.
  • Enregistrez-les dans une exécution. Dans une exécution, un agent ajoute chaque vérification au rapport avec add_run_note, marquée échouée en cas d’échec, pour que le rapport de la pull request liste toutes les vérifications.
  • Testez votre propre app, en développement ou en préproduction. Chaque vérification crée de nouveaux comptes.
  • La vérification à deux utilisateurs est un contrôle rapide des pages que vous essayez, pas un audit de sécurité. La réussir ne signifie pas que chaque page est protégée.
  • Les vérifications de code erroné peuvent verrouiller un compte de test après trop d’essais ; c’est la vérification qui fonctionne.

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