Autenticación en dos pasos
Pocket Alert admite autenticación en dos pasos (2FA) con TOTP, tanto en el panel web como en la aplicación móvil. Una vez activada, la contraseña por sí sola ya no da acceso a tu cuenta.
Configúrala en Cuenta → Seguridad.
Cómo configurarla
- Abre Cuenta → Seguridad e inicia la configuración. Verás un código QR y un secreto.
- Escanéalo con cualquier aplicación de autenticación TOTP: Google Authenticator, 1Password, Authy, Bitwarden.
- Introduce el código de seis dígitos para confirmar. La 2FA no se activa hasta que introduces un código correcto.
- Guarda los códigos de recuperación que se te muestran. Cada uno funciona una sola vez.
La configuración interrumpida es segura
Iniciar una nueva configuración no modifica tu 2FA actual. El nuevo secreto se guarda en un espacio pendiente y solo sustituye al activo cuando confirmas un código. Así, cerrar la pestaña a medio proceso no te deja fuera de tu cuenta.
Cómo cambia el inicio de sesión
Con la 2FA activada, POST /v1/auth/login ya no devuelve un JWT. Devuelve un desafío de corta duración:
{
"two_factor_required": true,
"challenge": "eyJhbGciOiJIUzI1NiIs…"
}Canjea el desafío junto con un código por el token real:
POST https://api.pocketalert.app/v1/auth/2fa/logincurl -X POST "https://api.pocketalert.app/v1/auth/2fa/login" \
-H "Content-Type: application/json" \
-d '{
"challenge": "eyJhbGciOiJIUzI1NiIs…",
"code": "482913"
}'Un canje correcto devuelve el mismo contenido que un inicio de sesión normal: token, name, email, avatar. El campo code acepta un código TOTP de seis dígitos o uno de tus códigos de recuperación.
Los desafíos caducan a los 5 minutos.
Las claves de API no se ven afectadas
Los scripts siguen funcionando
La 2FA se aplica a los inicios de sesión interactivos. Las claves de API de Claves de API se autentican con la cabecera Token y no se les pide el segundo factor. Tus tareas cron, pipelines de CI y webhooks de monitorización seguirán enviando alertas exactamente igual que antes.
Por eso conviene limitar cada clave de API a un servicio: revocar una no afecta a las demás.
Códigos de recuperación
Los códigos de recuperación son de un solo uso y se consumen de forma atómica: dos inicios de sesión en paralelo no pueden gastar el mismo código. Genera un juego nuevo en cualquier momento desde Cuenta → Seguridad. Al emitir códigos nuevos, los anteriores dejan de ser válidos.
¿Has perdido el autenticador y los códigos? Contacta con soporte. No existe un método de desbloqueo por cuenta propia, y esa es precisamente la idea.
Protección frente a fuerza bruta
Cinco códigos incorrectos bloquean la cuenta durante 15 minutos, y los intentos adicionales devuelven 429. El contador se reinicia al iniciar sesión correctamente y al activar o desactivar la 2FA. Como un desafío sigue siendo válido durante sus cinco minutos completos, este límite de intentos, y no la duración del desafío, es lo que hace inviable adivinar un código de seis dígitos.
Notificaciones por correo
Recibes un correo cada vez que se activa o desactiva la 2FA en tu cuenta. Si te llega uno y no has sido tú, cambia la contraseña de inmediato.
Endpoints
| Método | Endpoint | Finalidad |
|---|---|---|
GET | /v1/auth/2fa/status | Indica si la 2FA está activa y cuántos códigos de recuperación quedan |
POST | /v1/auth/2fa/setup | Inicia el registro: devuelve el secreto y los datos del QR |
POST | /v1/auth/2fa/enable | Confirma un código y activa la 2FA |
POST | /v1/auth/2fa/disable | Desactiva la 2FA: requiere un código y tu contraseña |
POST | /v1/auth/2fa/recovery-codes | Emite un juego nuevo de códigos de recuperación |
POST | /v1/auth/2fa/login | Canjea desafío + código por un JWT (sin cabecera de autenticación) |
Todos los endpoints, salvo /auth/2fa/login, requieren una sesión autenticada.
Relacionado
- Inicio de sesión: el primer paso del flujo de inicio de sesión
- Introducción: visión general de la autenticación