pagetop/extensions/pagetop-user/src/handlers/admin.rs
Manuel Cillero bd54980d0f ✨ (user): Integra pagetop-mail y valida identidades
- Envía por correo la recuperación de contraseña y, con
  `require_email_verification`, la verificación de cuentas nuevas, que
  se confirma con un botón (los escáneres de correo abren los enlaces).
- Nueva política de nombres de usuario (`identity_policy`): sin `@`, sin
  distinguir mayúsculas y sin nombres confusables (UTS #39). Email
  validado con pagetop-mail.
- Tokens de un solo uso atómicos y ligados al usuario. Los correos a
  direcciones sin verificar no incluyen datos elegidos por el usuario.
- Bloqueo por intentos fallidos con su ventana de recuento, y el mismo
  tiempo de respuesta exista o no la cuenta. Argon2 en `spawn_blocking`.
- Límites de longitud del nombre visible y de los roles, y botones sólo
  con el permiso que exigen. Más correcciones en formularios y búsqueda.
2026-10-19 07:57:38 +02:00

75 lines
3.7 KiB
Rust

//! Handlers HTTP para el mantenimiento de usuarios, roles y permisos.
//!
//! Las páginas de usuarios, roles y permisos se registran en el portal de `pagetop-admin` (ver
//! `declare_admin_pages()`). Cada handler comprueba el permiso correspondiente con
//! [`require_permission()`](pagetop::auth::require_permission) antes de construir la página.
pub(crate) mod permissions;
pub(crate) mod roles;
pub(crate) mod users;
use pagetop::prelude::*;
use pagetop_admin::component::AdminFrame;
use crate::LOCALES_USER;
use crate::error::AuthError;
use crate::service::role_admin::ROLE_MACHINE_NAME_MAX_CHARS;
// Envuelve el contenido de una página de administración en el frame de `pagetop-admin`:
// breadcrumb, tareas y acciones locales registradas para la ruta actual en su `AdminRegistry`.
pub(crate) fn frame(title: Lc) -> AdminFrame {
AdminFrame::new().with_title(title)
}
// Traduce un `AuthError` a su clave Lc, para mostrarlo en el formulario que falló. Cubre tanto
// los errores de autenticación existentes como los nuevos de administración.
pub(crate) fn map_auth_error(err: &AuthError) -> Lc {
match err {
AuthError::PasswordTooShort(n) => {
Lc::t("error-password-too-short", &LOCALES_USER).with_arg("n", n.to_string())
}
AuthError::PasswordMismatch => Lc::t("error-password-mismatch", &LOCALES_USER),
AuthError::InvalidTimezone => Lc::t("error-invalid-timezone", &LOCALES_USER),
AuthError::InvalidLanguage => Lc::t("error-invalid-language", &LOCALES_USER),
AuthError::InvalidTheme => Lc::t("error-invalid-theme", &LOCALES_USER),
AuthError::AboutTooLong(n) => {
Lc::t("error-about-too-long", &LOCALES_USER).with_arg("n", n.to_string())
}
AuthError::DisplayNameTooLong(n) => {
Lc::t("error-display-name-too-long", &LOCALES_USER).with_arg("n", n.to_string())
}
AuthError::UsernameTaken => Lc::t("error-username-taken", &LOCALES_USER),
AuthError::InvalidUsername => Lc::t("error-invalid-username", &LOCALES_USER),
AuthError::InvalidEmail => Lc::t("error-invalid-email", &LOCALES_USER),
AuthError::EmailTaken => Lc::t("error-email-taken", &LOCALES_USER),
AuthError::UserNotFound => Lc::t("error-user-not-found", &LOCALES_USER),
AuthError::RoleNotFound => Lc::t("error-role-not-found", &LOCALES_USER),
AuthError::RoleMachineNameTaken => Lc::t("error-role-machine-name-taken", &LOCALES_USER),
AuthError::InvalidMachineName => Lc::t("error-invalid-machine-name", &LOCALES_USER)
.with_number("n", u32::from(ROLE_MACHINE_NAME_MAX_CHARS)),
AuthError::InvalidRoleLabel(n) => {
Lc::t("error-invalid-role-label", &LOCALES_USER).with_arg("n", n.to_string())
}
AuthError::RoleLocked => Lc::t("error-role-locked", &LOCALES_USER),
AuthError::RoleInUse => Lc::t("error-role-in-use", &LOCALES_USER),
AuthError::LastAdministrator => Lc::t("error-last-administrator", &LOCALES_USER),
AuthError::CannotBlockSelf => Lc::t("error-cannot-block-self", &LOCALES_USER),
AuthError::CannotModifyOwnAdminFlag => {
Lc::t("error-cannot-modify-own-admin-flag", &LOCALES_USER)
}
AuthError::UnknownPermission(_) => Lc::t("error-unknown-permission", &LOCALES_USER),
_ => Lc::t("error-internal", &LOCALES_USER),
}
}
// Enlace de vuelta al listado, usado en las pantallas de alta/edición/asignación.
pub(crate) fn back_link(href: impl Into<RoutePath>) -> Html {
let href = href.into();
Html::with(move |cx| {
html! {
p class="user-admin-back-link" {
a href=(href.clone()) { (Lc::t("link-back-to-list", &LOCALES_USER).using(cx)) }
}
}
})
}