Vibe Coding: cómo diseñar recuperación de contraseñas en un MVP
Estás construyendo un MVP con ayuda de herramientas de inteligencia artificial y el registro de usuarios ya funciona. Entonces aparece una pregunta que parece pequeña, pero afecta directamente la seguridad y la experiencia: ¿qué ocurre cuando una persona olvida su contraseña?
Un flujo de recuperación mal diseñado puede revelar qué correos están registrados, permitir el uso repetido de enlaces o dejar sesiones activas después de cambiar una contraseña. En este artículo aprenderás a definir un flujo de recuperación de contraseñas que sea claro, comprobable y razonable para un MVP, incluso si estás utilizando Vibe Coding para construirlo.
Qué problema debe resolver la recuperación de contraseñas
La recuperación de contraseña permite que una persona vuelva a acceder a su cuenta sin que el sistema conozca su contraseña actual. Para lograrlo, la aplicación debe verificar que quien solicita el cambio controla un canal asociado a la cuenta, normalmente su correo electrónico.
El flujo debe equilibrar dos objetivos:
- Usabilidad: la persona debe poder iniciar el proceso y entender qué hacer a continuación.
- Seguridad: un tercero no debe poder descubrir usuarios, reutilizar enlaces o cambiar una contraseña sin autorización.
En un MVP no es necesario construir una plataforma de identidad completa, pero sí definir explícitamente las reglas principales. La inteligencia artificial puede ayudar a generar pantallas, endpoints o pruebas, pero no sustituye la revisión de estas decisiones.
Cómo funciona un flujo seguro de recuperación
1. Solicitud de recuperación
La persona introduce su correo electrónico en un formulario de “Olvidé mi contraseña”. El backend recibe la solicitud y busca la cuenta correspondiente.
La respuesta visible debe ser la misma tanto si el correo existe como si no. Por ejemplo:
“Si existe una cuenta asociada a este correo, recibirás instrucciones para recuperar el acceso.”
Esto evita revelar si una dirección está registrada. Si la aplicación responde “correo no encontrado”, un atacante podría probar direcciones y construir una lista de usuarios.
2. Generación de un token de un solo uso
Cuando existe una cuenta, el sistema genera un token aleatorio, difícil de adivinar y asociado temporalmente a esa solicitud. El token debe:
- Ser de un solo uso.
- Tener una fecha de expiración.
- Estar vinculado a la cuenta correcta.
- No incluir directamente información sensible de la persona.
- Invalidarse después de completar o cancelar el proceso, según el diseño.
Una práctica habitual es enviar el token dentro de un enlace por correo y almacenar en la base de datos una representación protegida del token, en lugar del valor original. Así, si alguien obtiene acceso de lectura a esa tabla, no obtiene automáticamente enlaces utilizables.
3. Restablecimiento de la contraseña
El enlace dirige a una pantalla donde la persona define una nueva contraseña. El backend debe validar el token antes de aceptar el cambio.
La nueva contraseña no debe almacenarse en texto plano. Debe procesarse con un algoritmo de hashing diseñado para contraseñas, utilizando una configuración adecuada para el entorno y la biblioteca elegida. El detalle concreto puede depender del lenguaje y de la implementación, pero la regla es invariable: la aplicación nunca debería guardar la contraseña original para recuperarla después.
4. Confirmación e invalidación
Después de cambiar la contraseña, el sistema debe mostrar una confirmación clara y enviar, cuando sea apropiado, una notificación al correo de la cuenta.
También hay que decidir qué ocurre con las sesiones existentes. En una aplicación sencilla, puede ser conveniente invalidar todas las sesiones activas después del cambio. En otros sistemas, la decisión puede depender del nivel de riesgo y de cómo se gestionen los tokens de sesión. Lo importante es definirlo explícitamente: cambiar la contraseña puede ser una señal de que una sesión previa está comprometida.
Componentes mínimos que debe definir un MVP
Antes de pedirle a una herramienta de IA que genere código, convierte el flujo en reglas verificables. Como mínimo, define estos componentes:
- Endpoint de solicitud: recibe el correo y devuelve una respuesta uniforme.
- Registro de recuperación: guarda la cuenta, el token protegido, la fecha de expiración, el estado de uso y, si resulta útil, la fecha de creación.
- Endpoint de validación o confirmación: verifica que el token existe, no expiró y no fue utilizado.
- Endpoint de cambio: valida la nueva contraseña, actualiza el hash y consume el token.
- Servicio de correo: envía instrucciones sin incluir la contraseña ni otros secretos.
- Control de intentos: limita solicitudes repetidas por dirección, IP, dispositivo u otra combinación razonable.
- Gestión de sesiones: define si se revocan sesiones o tokens emitidos antes del cambio.
Un token no debería quedar activo indefinidamente. La duración exacta depende del riesgo y del contexto del producto, pero debe existir una expiración definida y comprobada por el backend, no solo por la interfaz.
Ejemplo conceptual del flujo
Imaginemos una aplicación de gestión de gastos personales llamada “Mis Finanzas”. Una persona solicita recuperar su acceso con el correo persona@ejemplo.com.
- La aplicación muestra el formulario de recuperación.
- El backend responde con el mismo mensaje aunque el correo no esté registrado.
- Si la cuenta existe, el sistema crea una solicitud de recuperación con un token aleatorio y una fecha de expiración.
- El correo contiene un enlace que apunta a la pantalla de nueva contraseña.
- La pantalla envía el token y la nueva contraseña al backend.
- El backend verifica el token, actualiza el hash de contraseña y marca el token como utilizado.
- Las sesiones anteriores se invalidan si esa es la política elegida.
- La persona recibe una confirmación y puede iniciar sesión nuevamente.
De forma conceptual, el estado de una solicitud podría representarse así:
{
"accountId": "identificador-interno",
"tokenHash": "representacion-protegida",
"expiresAt": "fecha-de-expiracion",
"usedAt": null
}
Este ejemplo no define una implementación completa ni debe copiarse directamente a producción. Su objetivo es mostrar qué información necesita controlar el backend. Los nombres de campos, el almacenamiento y los mecanismos de sesión dependerán de la arquitectura de la aplicación.
Controles de seguridad y casos de error
No revelar cuentas existentes
La respuesta de la solicitud debe ser uniforme en mensaje y, en lo posible, también razonable en comportamiento. Los registros internos pueden distinguir si el correo existía, pero esa información no debería enviarse al usuario ni aparecer en una respuesta pública.
Limitar abuso y envío de correos
Un atacante podría utilizar el formulario para enviar muchos mensajes a una dirección o para saturar el servicio. Define límites de frecuencia y considera registrar los intentos para detectar patrones anómalos.
Estos límites no deben depender únicamente de la interfaz. El control debe aplicarse en el backend y complementarse con mecanismos de observabilidad adecuados para el tamaño del MVP.
Rechazar tokens inválidos, usados o expirados
La aplicación debe manejar de forma controlada los siguientes casos:
- El token no existe.
- El token fue alterado.
- El token ya fue utilizado.
- El token expiró.
- La cuenta ya no está disponible.
- La nueva contraseña no cumple las reglas definidas.
- Se intenta reutilizar una solicitud antigua después de crear otra.
La interfaz puede mostrar un mensaje como “El enlace no es válido o ya expiró”. No es necesario explicar cuál de las condiciones ocurrió si hacerlo aporta información útil a un atacante.
Evitar datos sensibles en registros
No guardes tokens completos, contraseñas ni enlaces de recuperación en logs accesibles. Los registros deben ayudar a investigar fallos sin convertirse en una fuente adicional de secretos.
Criterios de aceptación para revisar el MVP
Los criterios de aceptación convierten una idea general en un flujo que puede probarse. Un conjunto inicial podría incluir:
- Al enviar un correo, la aplicación muestra el mismo mensaje tanto si existe una cuenta como si no.
- Cuando existe una cuenta, se genera una solicitud de recuperación con expiración.
- El enlace utiliza un token de un solo uso.
- Un token expirado no permite cambiar la contraseña.
- Un token utilizado por primera vez no puede volver a utilizarse.
- Una contraseña nueva se almacena mediante hashing, nunca en texto plano.
- El usuario recibe confirmación después de un cambio exitoso.
- Las sesiones anteriores se invalidan de acuerdo con la política definida.
- Las solicitudes repetidas se limitan para reducir abuso.
- Los errores no exponen si el correo está registrado ni muestran secretos.
También conviene probar el flujo desde varios ángulos: correo inexistente, enlace manipulado, doble clic en el botón de confirmación, token expirado, contraseña inválida, correo retrasado y solicitud de varios enlaces consecutivos.
Errores frecuentes al construirlo con Vibe Coding
- Confiar en un prompt como revisión de seguridad: una instrucción puede producir código plausible, pero no garantiza que el flujo sea resistente a abuso.
- Generar tokens predecibles: usar un identificador incremental, el correo o una fecha no es suficiente.
- Validar la expiración solo en el frontend: el backend debe verificar siempre el estado del token.
- Mostrar “correo no registrado”: esto facilita la enumeración de cuentas.
- No invalidar el token: un enlace reutilizable amplía el impacto si es interceptado.
- Olvidar las sesiones: cambiar la contraseña no resuelve por sí solo una sesión que ya fue comprometida.
- Probar únicamente el camino feliz: los fallos de seguridad suelen aparecer en reintentos, estados intermedios y errores.
La IA puede ayudarte a generar una primera versión, proponer pruebas o explicar un error. Aun así, debes revisar el diseño, inspeccionar el código generado y contrastar el comportamiento con los requisitos de seguridad de tu aplicación. Si utilizas un framework o proveedor de identidad, valida los detalles contra su documentación vigente, porque las capacidades y configuraciones pueden variar.
Conclusión: define el flujo antes de habilitar usuarios
La recuperación de contraseñas no es una pantalla aislada: es un flujo de autenticación que involucra privacidad, sesiones, correo, almacenamiento seguro y manejo de errores. Para un MVP, la base consiste en no revelar cuentas, utilizar tokens de un solo uso con expiración, proteger las contraseñas, limitar intentos y probar explícitamente los casos anómalos.
Antes de habilitar usuarios reales, revisa el checklist de aceptación y verifica que cada regla se cumpla en el backend. Si estás construyendo con Vibe Coding, el siguiente paso no es pedir más código automáticamente, sino aprender a traducir el problema en decisiones y pruebas verificables.
Revisa el checklist antes de habilitar usuarios en tu MVP y conoce el curso de Vibe Coding de Mentores Tech para trabajar estos flujos con criterio técnico.
