Usuarios y roles
Última actualización:
Lo que aprenderás
- Ciclo de vida de un usuario.
- Restricciones de asignación de rol.
- Efecto de cada cambio sobre las sesiones.
Antes de empezar
- Rol
- Superadministrador · Administrador
- Permiso
- users.manage
Ruta: /settings/users. API: api/Users.
- UsuarioInvitaciónPOST api/Users/invite → estado invited
- SistemaCorreoenlace de un solo uso; reenvío con resend-invitation
- UsuarioActivaciónel invitado define su contraseña → active
Endpoints
Sección titulada «Endpoints»| Método | Ruta | Permiso |
|---|---|---|
GET |
api/Users, api/Users/{id} |
users.read |
GET |
api/Users/assignable-roles |
users.read |
GET |
api/Users/security-events |
users.read |
POST |
api/Users/invite |
users.manage |
POST |
api/Users/{id}/resend-invitation |
users.manage |
PUT |
api/Users/{id} (rol, estado) |
users.manage |
POST |
api/Users/{id}/2fa/reset |
users.manage |
DELETE |
api/Users/{id} |
users.manage |
| Regla | Detalle |
|---|---|
| Asignación | sólo roles cuyo conjunto de permisos está contenido en el del asignador. El intento queda auditado |
| Autoprotección | nadie cambia su propio rol, estado ni resetea su propio 2FA |
| Continuidad | la organización conserva al menos un administrador activo |
| Revocación | cambio de rol, desactivación, reset de 2FA y eliminación incrementan TokenVersion y revocan sesiones; efectivo en ≤ 30 s |
Usuario invited |
si pide restablecer contraseña recibe de nuevo la invitación |
La matriz completa rol → permiso está en Roles y permisos.