Saltar a contenido

app.security.auth

Seguridad del acceso: contraseñas, sesiones y límites de intentos.

  • Contraseñas: PBKDF2-HMAC-SHA256 con sal aleatoria de 16 bytes (pbkdf2_sha256$iteraciones$sal$hash). Se comparan en tiempo constante.
  • Sesión: cookie HttpOnly con un token firmado (HMAC-SHA256 con APP_SESSION_SECRET) que lleva el id de usuario, su rol, su «versión de sesión» y la fecha de caducidad. Cambiar la contraseña, el rol, desactivar la cuenta o cerrar sesión incrementa la versión y anula los tokens anteriores (lo comprueba la dependencia usuario_actual contra la base).
  • Fuerza bruta: 5 fallos seguidos bloquean la cuenta 15 minutos; además, 20 fallos desde una misma IP en 15 minutos devuelven 429.
  • Política de contraseñas: al menos 10 caracteres, con letras y números, y sin contener el nombre de usuario.

PREFIJO_TOKEN = 'v2.' module-attribute

ITERACIONES_POR_DEFECTO = 260000 module-attribute

MAX_FALLOS_CUENTA = 5 module-attribute

MINUTOS_BLOQUEO = 15 module-attribute

MAX_FALLOS_IP = 20 module-attribute

VENTANA_IP_SEGUNDOS = 15 * 60 module-attribute

ROLES = ('ADMIN', 'TESTER') module-attribute

USUARIO_RE = re.compile('^[A-Za-z][A-Za-z0-9._-]{2,49}$') module-attribute

SECRETOS_DE_EJEMPLO = {'default_insecure_secret_replace_in_prod', 'secreto_ficticio_largo_y_complejo'} module-attribute

CLAVES_DE_EJEMPLO = {'contrasena_ficticia'} module-attribute

limite_por_ip = LimiteDeIntentos() module-attribute

LimiteDeIntentos

Cuenta fallos de inicio de sesión por IP en una ventana deslizante (en memoria; se reinicia con el proceso).

bloqueada(ip)

fallo(ip)

reiniciar(ip=None)

hash_password(password)

Devuelve el hash con sal para guardar en la base (nunca la contraseña).

verify_password(password, guardado)

Compara en tiempo constante. Con guardado=None hace el mismo trabajo para no revelar si el usuario existe.

problemas_de_contrasena(password, username='')

Devuelve un mensaje si la contraseña no cumple la política; None si la cumple.

problemas_de_usuario(username)

configuracion_insegura(session_secret, admin_password)

Motivo (sin revelar valores) si el secreto de sesión o la clave del primer administrador son valores de ejemplo.

crear_token(user_id, username, role, session_version, horas=8)

Token firmado con caducidad. Cada usuario y cada inicio de sesión tienen un token distinto (incluye un nonce).

leer_token(token)

Devuelve la carga si la firma es válida y no caducó; si no, None.