✨ (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:
parent
9a78b79939
commit
5172da65d6
39 changed files with 4711 additions and 310 deletions
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue