✨ (user): Añade proveedores de autenticación

Otras extensiones pueden comprobar las credenciales del inicio de sesión
con un servicio externo (un directorio LDAP...): módulo público provider
(AuthProvider, ProviderHandle, AccountPolicy, DeclareAuthProviders),
tabla `user_identities`, sección `[user.login]` (sources, local_fallback
y strict, que sustituye a login_strict), estado AwaitingApproval y
acciones AfterSessionResolved, AfterUserStatusChanged y
AdminUserFormExtras.

Las reglas que protegen las cuentas son siempre de pagetop-user: sólo se
vincula una cuenta que un administrador ha permitido para esa persona,
nunca la de un administrador, y una caída del proveedor no bloquea a
nadie.

Añade el límite de fallos por identificador tecleado, guarda las
contraseñas en util::SecretStr, crea en una sola transacción las cuentas
de proveedor y documenta todos los elementos públicos del crate.
This commit is contained in:
Manuel Cillero 2026-11-12 23:13:58 +01:00
parent 9a78b79939
commit 5172da65d6
39 changed files with 4711 additions and 310 deletions

View file

@ -11,18 +11,20 @@
</div>
Añade cuentas de usuario a una aplicación PageTop: registro, inicio de sesión con sesiones en la
base de datos, perfil propio, recuperación de contraseña y verificación del email por correo, y
control de acceso con roles y permisos. Incluye las páginas de administración de usuarios, roles y
permisos en el panel de administración del núcleo, hechas sólo con componentes del núcleo para que
funcionen con cualquier tema.
## Sobre PageTop
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la esencia de la web
clásica para crear soluciones web SSR (*renderizadas en el servidor*) modulares, extensibles y
configurables, basadas en HTML, CSS y JavaScript.
## Descripción general
Añade cuentas de usuario a una aplicación PageTop: registro, inicio de sesión con sesiones en la
base de datos, perfil propio, recuperación de contraseña y verificación del email por correo, y
control de acceso con roles y permisos. Incluye las páginas de administración de usuarios, roles y
permisos en el panel de administración del núcleo, hechas sólo con componentes del núcleo para que
funcionen con cualquier tema.
## Guía rápida
**Añade la dependencia** a tu `Cargo.toml`:
@ -122,6 +124,42 @@ y `ana` son el mismo usuario) y no se admiten nombres que se confunden a simple
existente (`rnaria` si existe `maria`, o `аdmin` con una `а` cirílica). Las reglas completas de
cada política, y las del email, están en `IdentityPolicy` (módulo `config`).
## Proveedores de autenticación
Otras extensiones pueden comprobar las credenciales del inicio de sesión con un servicio externo,
como un directorio LDAP o Active Directory. Cada una declara su proveedor con la acción
`DeclareAuthProviders`, y la configuración decide con qué fuentes, y en qué orden, se comprueban
las credenciales. Por ejemplo, las dos, primero el directorio y después la contraseña local:
```toml
[user.login]
sources = ["ldap", "local"]
```
O sólo el directorio, salvo los administradores, que conservan su contraseña local como acceso de
emergencia por si el directorio no responde (`local_fallback` sólo se aplica cuando `"local"` no
está en `sources`):
```toml
[user.login]
sources = ["ldap"]
local_fallback = "admins"
```
Los límites de intentos, el bloqueo de cuentas, el estado de cada cuenta y las sesiones son los de
`pagetop-user` para todas las fuentes. Una cuenta vinculada a un proveedor sólo se autentica con él,
y lo que su titular puede cambiar (contraseña, email, datos del perfil, roles) lo decide el
proveedor. La contraseña tecleada nunca se guarda ni se escribe en las trazas: el proveedor sólo la
recibe para comprobarla (`pagetop::util::SecretStr`).
Las operaciones que crean cuentas, las vinculan con su identidad externa o cambian sus roles no son
funciones públicas: son métodos de un `ProviderHandle` que sólo
`pagetop-user` construye y que entrega a cada proveedor activo. Así sus reglas viven en un único
sitio: un proveedor sólo actúa sobre sus propias cuentas, una cuenta existente sólo se vincula si un
administrador lo ha permitido en su ficha (y nunca la de un administrador), y nadie puede conceder
el acceso total. Protege de errores en un proveedor, no de código malicioso compilado en la misma
aplicación. Los detalles están en el módulo `provider`.
## Correos
La recuperación de contraseña, la confirmación de una nueva dirección y, con