Vérifications de parcours
Traduit automatiquement de l’anglais.
Lire en anglaisUn 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.
Où les obtenir
Section intitulée « Où les obtenir »- Un agent :
get_flow_checkssur le MCP server, avecflowréglé sursign_up,password_resetoumagic_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, ouGET /v1/flow-checks?flow=sign_upsur 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.
Inscription
Section intitulée « Inscription »| 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 |
Réinitialisation du mot de passe
Section intitulée « Réinitialisation du mot de passe »| 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é |
Connexion par lien magique
Section intitulée « Connexion par lien magique »| 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.
Les lancer
Section intitulée « Les lancer »- 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.
Précautions
Section intitulée « Précautions »- 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.