✨ (user): Caducidad de sesión por inactividad

- La sesión caduca tras un tiempo sin uso, no desde el login, y se
  prorroga como mucho cada `write_interval_secs`; la cookie de
  "recordarme" se renueva con ella.
- Nueva subsección `[user.session]` con `cookie_name` ("pagetop"),
  `secure_cookie`, `idle_secs`, `remember_idle_secs` y
  `write_interval_secs`.
This commit is contained in:
Manuel Cillero 2026-10-12 08:34:14 +02:00
parent cbe38136c9
commit 98a5768406
7 changed files with 263 additions and 100 deletions

View file

@ -16,35 +16,36 @@ use std::sync::LazyLock;
include_config!(CONFIG_USER: UserTopConfig => [
// Política de registro y verificación.
"user.allow_registration" => true,
"user.require_email_verification" => false,
"user.allow_registration" => true,
"user.require_email_verification" => false,
// Sesiones.
"user.session_cookie_name" => "pgt_session",
"user.session_ttl_secs" => 1_209_600_i64, // 14 días
"user.session_idle_ttl_secs" => 7_200_i64, // 2 horas
"user.secure_cookie" => false,
"user.session.cookie_name" => "pagetop",
"user.session.secure_cookie" => false,
"user.session.idle_secs" => 7_200_i64, // 2 horas
"user.session.remember_idle_secs" => 1_209_600_i64, // 14 días
"user.session.write_interval_secs" => 60_i64, // 1 minuto
// Anti-fuerza-bruta.
"user.max_failed_logins" => 5_i32,
"user.failed_login_window_secs" => 900_i64, // 15 min
"user.locked_for_secs" => 600_i64, // 10 min
"user.max_failed_logins" => 5_i32,
"user.failed_login_window_secs" => 900_i64, // 15 min
"user.locked_for_secs" => 600_i64, // 10 min
// Contraseñas (Argon2id).
"user.password.argon2_m_cost" => 19456_u32,
"user.password.argon2_t_cost" => 2_u32,
"user.password.argon2_p_cost" => 1_u32,
"user.password.min_length" => 8_u64,
"user.password.argon2_m_cost" => 19456_u32,
"user.password.argon2_t_cost" => 2_u32,
"user.password.argon2_p_cost" => 1_u32,
"user.password.min_length" => 8_u64,
// Semilla del primer administrador.
"user.seed.admin_username" => "admin",
"user.seed.admin_email" => "admin@example.com",
"user.seed.admin_username" => "admin",
"user.seed.admin_email" => "admin@example.com",
// Listados de administración (usuarios, roles...).
"user.admin.list_page_size" => 20_u64,
"user.admin.list_page_size" => 20_u64,
// Modo de login.
"user.login_strict" => false,
"user.login_strict" => false,
]);
// **< UserTopConfig >******************************************************************************
@ -63,23 +64,20 @@ pub static SETTINGS: LazyLock<Settings> = LazyLock::new(|| CONFIG_USER.user.clon
// **< Settings >***********************************************************************************
/// Ajustes de la extensión `pagetop-user`, accesibles en la sección `[user]` del TOML.
#[derive(Clone, Debug, Default, Deserialize)]
#[derive(Clone, Debug, Deserialize)]
pub struct Settings {
// Política de registro y verificación.
pub allow_registration: bool,
pub require_email_verification: bool,
// Sesiones.
pub session_cookie_name: String,
pub session_ttl_secs: i64,
pub session_idle_ttl_secs: i64,
pub secure_cookie: bool,
// Anti-fuerza-bruta.
pub max_failed_logins: i32,
pub failed_login_window_secs: i64,
pub locked_for_secs: i64,
// Sesiones.
pub session: SessionConfig,
// Contraseñas.
pub password: PasswordConfig,
@ -94,6 +92,40 @@ pub struct Settings {
pub login_strict: bool,
}
/// Ajustes de la sección `[user.session]`.
#[derive(Clone, Debug, Deserialize)]
pub struct SessionConfig {
/// Nombre de la cookie de sesión.
pub cookie_name: String,
/// Marca la cookie de sesión como `Secure` (sólo HTTPS). Debe activarse en producción.
pub secure_cookie: bool,
/// Segundos sin uso tras los que caduca una sesión iniciada sin "recordarme". El tiempo se
/// cuenta desde la última petición, con la precisión que fija
/// [`write_interval_secs`](Self::write_interval_secs).
pub idle_secs: i64,
/// Segundos sin uso tras los que caduca una sesión iniciada con "recordarme". El tiempo se
/// cuenta desde la última petición, con la precisión que fija
/// [`write_interval_secs`](Self::write_interval_secs).
pub remember_idle_secs: i64,
/// Segundos mínimos entre dos actualizaciones de la misma sesión en la base de datos.
///
/// Cada petición de una sesión válida la prorroga, pero sólo se escribe en la base de datos
/// (y se renueva la cookie de "recordarme") si ha pasado al menos este tiempo desde la última
/// actualización. A cambio, una sesión puede caducar hasta este tiempo antes de lo configurado
/// en [`idle_secs`](Self::idle_secs) y [`remember_idle_secs`](Self::remember_idle_secs). Con
/// `0` se escribe en cada petición.
///
/// El valor por defecto (60) sirve para la mayoría de aplicaciones. Conviene cambiarlo:
///
/// - **Al alza** (p. ej. 180, como Drupal) si hay muchos usuarios simultáneos o la base de
/// datos es remota o lenta, para reducir las escrituras.
/// - **A la baja** (o `0`) si las sesiones caducan tras pocos minutos sin uso y ese margen de
/// adelanto no es aceptable.
///
/// Debe ser siempre muy inferior a `idle_secs`.
pub write_interval_secs: i64,
}
/// Ajustes de la sección `[user.password]`.
#[derive(Clone, Debug, Deserialize)]
pub struct PasswordConfig {
@ -103,19 +135,8 @@ pub struct PasswordConfig {
pub min_length: usize,
}
impl Default for PasswordConfig {
fn default() -> Self {
PasswordConfig {
argon2_m_cost: 19456,
argon2_t_cost: 2,
argon2_p_cost: 1,
min_length: 8,
}
}
}
/// Ajustes de la sección `[user.seed]`.
#[derive(Clone, Debug, Default, Deserialize)]
#[derive(Clone, Debug, Deserialize)]
pub struct SeedConfig {
pub admin_username: String,
pub admin_email: String,
@ -129,12 +150,6 @@ pub struct AdminConfig {
pub list_page_size: u64,
}
impl Default for AdminConfig {
fn default() -> Self {
AdminConfig { list_page_size: 20 }
}
}
// **< Preferencias del usuario >*******************************************************************
// Si se aplica el idioma propio del usuario: no con `lang_negotiation = "ConfigOnly"`, que usa