Saltar al contenido

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 ​

  1. Abre Cuenta → Seguridad e inicia la configuración. Verás un código QR y un secreto.
  2. Escanéalo con cualquier aplicación de autenticación TOTP: Google Authenticator, 1Password, Authy, Bitwarden.
  3. Introduce el código de seis dígitos para confirmar. La 2FA no se activa hasta que introduces un código correcto.
  4. 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:

json
{
  "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/login
bash
curl -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étodoEndpointFinalidad
GET/v1/auth/2fa/statusIndica si la 2FA está activa y cuántos códigos de recuperación quedan
POST/v1/auth/2fa/setupInicia el registro: devuelve el secreto y los datos del QR
POST/v1/auth/2fa/enableConfirma un código y activa la 2FA
POST/v1/auth/2fa/disableDesactiva la 2FA: requiere un código y tu contraseña
POST/v1/auth/2fa/recovery-codesEmite un juego nuevo de códigos de recuperación
POST/v1/auth/2fa/loginCanjea 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 ​

Documentación de Pocket Alert