Skip to main content

Restablecer o contrasinal do usuario (Administrador)

POST 
/company/auth/reset/:id

Endpoint para restablecer o contrasinal dun usuario (operación administrativa).
Xera un novo contrasinal aleatorio e envíao por correo electrónico.

Permitir que os administradores restablezan o contrasinal de calquera usuario
xerando un contrasinal temporal seguro e enviándoo por correo electrónico.

Casos de Uso​

  • O administrador precisa restablecer o contrasinal dun usuario bloqueado
  • O usuario non pode acceder e require intervención administrativa
  • O soporte técnico restablece as credenciais do usuario

Fluxo do Proceso​

  1. O administrador solicita o restablecemento do contrasinal do usuario
  2. O middleware m.isGestor verifica que o usuario ten rol de xestor/admin/dev (401 se non)
  3. O cliente envía POST co ID do usuario na URL
  4. O servidor busca o usuario polo ID na base de datos
  5. Se o usuario non existe, retorna erro 404
  6. Se o usuario existe, xera un contrasinal aleatorio seguro
  7. Cifra o novo contrasinal con bcrypt
  8. Garda o novo contrasinal na base de datos
  9. Envía un correo electrónico co novo contrasinal xerado
  10. Retorna os datos do usuario actualizados (sen incluír o contrasinal)
  11. Rexistra a acción no historial de seguridade

Seguridade​

  • Require autenticación e permisos de xestión (rol xestor, admin ou dev)
  • O contrasinal xerado aleatoriamente é seguro (mínimo 8 caracteres)
  • Envíase por correo electrónico para asegurar que o usuario real o reciba
  • Require autorización adecuada para realizar esta operación

Request​

Responses​

Contrasinal restablecido con éxito

Response Headers