Ir al contenido

Una prueba de registro que espera el código y lo ingresa demuestra el camino feliz. Los errores que encuentran las personas están en otra parte: un código que funciona dos veces, un enlace de restablecimiento viejo que aún define una contraseña, un enlace mágico que un escáner de correo consume, una segunda cuenta que puede leer los datos de la primera. Proxy Mail QA enumera las verificaciones de cada flujo, con los pasos para ejecutarlas y lo que debe hacer la app.

  • Un agente: get_flow_checks en el MCP server, con flow en sign_up, password_reset o magic_link. El agente ejecuta cada verificación con sus herramientas de navegador o de app e informa aprobada, fallida u omitida.
  • Una prueba: qa.flowChecks('sign_up') en el paquete npm, flow_checks("sign_up") en el helper Python, o GET /v1/flow-checks?flow=sign_up en la REST API.

Cada verificación incluye id (un nombre estable, como code_works_once), checks (lo que verifica), steps, expect (lo que debe hacer la app) y why (lo que les sale mal a las personas cuando no lo hace). Una verificación que no siempre puede ejecutarse tiene needs: lo que necesita, y cuándo omitirla e indicarlo.

Las partes de Proxy Mail QA en los pasos son las habituales: crear una dirección nueva, anotar la hora justo antes de enviar, esperar el código o enlace con since en esa hora, y contar los correos o esperar que no llegue ninguno.

Comprobación Qué debería pasar
Llega un correo de confirmación Exactamente un correo, con un código o enlace, en menos de un minuto
Se rechaza un código incorrecto Cada código incorrecto se rechaza con un mensaje, y tras algunos intentos la app deja de aceptar códigos o pide uno nuevo
El código funciona solo una vez Volver a ingresar el mismo código después de confirmar se rechaza
Se rechaza un código vencido Una vez pasado el tiempo que indica el correo, el código se rechaza y se ofrece una forma de obtener uno nuevo
Tras un reenvío, funciona el código más reciente El código más reciente funciona y el primero se rechaza. Si la app acepta ambos, anótalo
Una cuenta sin confirmar no puede usar la app La app pide confirmar primero el correo y ofrece enviarlo de nuevo
Confirmar inicia la sesión de la persona La persona llega con la sesión iniciada y la mantiene tras recargar, o llega al inicio de sesión con un mensaje que dice que el correo está confirmado. No una página en blanco, un error ni un ciclo de inicio de sesión
Registrarse de nuevo con la misma dirección no crea una segunda cuenta La primera contraseña sigue funcionando y la segunda no. La app dice que la dirección ya está en uso, o muestra el mensaje habitual y envía un correo al dueño
Una segunda persona no puede ver los datos de la primera Con la sesión iniciada en una segunda cuenta, abrir un elemento privado de la primera cuenta da “no encontrado” o “no permitido”, y no aparece en ninguna lista ni búsqueda
Comprobación Qué debería pasar
Hay una forma de restablecer la contraseña La página de inicio de sesión ofrece restablecerla, y llega un correo de restablecimiento en menos de un minuto
Un restablecimiento para una dirección desconocida no revela nada La página muestra el mismo mensaje que para una cuenta real, y no llega ningún enlace de restablecimiento
La nueva contraseña funciona y la anterior no Tras el restablecimiento, la contraseña anterior se rechaza y la nueva funciona
El enlace de restablecimiento funciona solo una vez Abrir el enlace de nuevo después de definir una contraseña se rechaza, con una opción para enviar uno nuevo
Solo funciona el enlace de restablecimiento más reciente Tras pedirlo dos veces, el primer enlace se rechaza y el más reciente funciona
Se rechaza un enlace de restablecimiento vencido Una vez pasado el tiempo que indica el correo, el enlace se rechaza y se ofrece una forma de pedir uno nuevo
El enlace de restablecimiento funciona en otro navegador El restablecimiento funciona allí, o la página indica claramente que se abra el enlace en el navegador desde el que se pidió
Comprobación Qué debería pasar
El enlace inicia la sesión de la persona Sesión iniciada, y sigue iniciada tras recargar
El enlace falla en su segundo uso Abierto de nuevo en otro navegador, no inicia la sesión de nadie e indica que ya se usó
Que un escáner de correo abra primero el enlace no lo consume Tras una solicitud simple al enlace, como la que hace un escáner, el navegador igual inicia sesión: el enlace abre una página con un botón, o el correo también trae un código
Solo funciona el enlace más reciente Tras pedirlo dos veces, el primer enlace se rechaza y el más reciente inicia sesión
Se rechaza un enlace vencido Una vez pasado el tiempo que indica el correo, el enlace se rechaza y se ofrece una forma de pedir uno nuevo
El enlace funciona en otro navegador Sesión iniciada allí, o un mensaje claro para abrir el enlace en el navegador desde el que se pidió

Proxy Mail QA nunca abre los enlaces de tus correos, así que sus propias verificaciones no pueden consumirlos. La verificación del escáner de correo imita lo que hace un escáner de correo corporativo; Cuando un escáner de correo abre primero el enlace explica por qué importa y cómo lo resuelven las apps.

  • Usa una dirección nueva para cada verificación, para que ningún correo anterior coincida y la cuenta de una verificación no afecte a la siguiente.
  • Anota la hora antes de cada envío y pásala como since, para que una espera tras un reenvío o una segunda solicitud encuentre el correo más reciente, no el primero.
  • Omite lo que no se puede ejecutar e indica por qué. Un vencimiento de una hora es demasiado largo para la mayoría de las ejecuciones de prueba: omite la verificación de vencimiento e infórmala como omitida. Nunca cambies la configuración de la app, como acortar el vencimiento o desactivar la confirmación por correo, para que una verificación pase.
  • Solo a través de la app. La verificación de dos usuarios abre páginas y repite solicitudes que hace la propia app, con la sesión iniciada en la segunda cuenta. Nunca lee la base de datos de la app.
  • Regístralas en una ejecución. En una ejecución, un agente agrega cada verificación al informe con add_run_note, marcada como fallida si falló, para que el informe del pull request incluya todas las verificaciones.
  • Prueba tu propia app, en desarrollo o staging. Cada verificación registra cuentas nuevas.
  • La verificación de dos usuarios es una revisión rápida de las páginas que pruebas, no una auditoría de seguridad. Aprobarla no significa que todas las páginas estén protegidas.
  • Las verificaciones de código incorrecto pueden bloquear una cuenta de prueba tras demasiados intentos; eso significa que la verificación funciona.

¿Tienes una pregunta sobre esta página?

Pregunta en cualquier idioma. La documentación puede responderte de inmediato, o puedes enviar tu pregunta al equipo de Proxy Mail QA, que responde en inglés.