Verificaciones de flujos
Traducido automáticamente del inglés.
Leer en inglésUna 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.
Dónde obtenerlos
Sección titulada «Dónde obtenerlos»- Un agente:
get_flow_checksen el MCP server, conflowensign_up,password_resetomagic_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, oGET /v1/flow-checks?flow=sign_upen 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.
Registro
Sección titulada «Registro»| 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 |
Restablecimiento de contraseña
Sección titulada «Restablecimiento de contraseña»| 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ó |
Inicio de sesión con enlace mágico
Sección titulada «Inicio de sesión con enlace mágico»| 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.
Cómo ejecutarlas
Sección titulada «Cómo ejecutarlas»- 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.
Precauciones
Sección titulada «Precauciones»- 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.