Saltar al contenido principal

Reset User Password (Admin)

POST 
/company/auth/reset/:id

Endpoint para resetear la contraseña de un usuario (operación administrativa). Genera una nueva contraseña aleatoria y la envía por email.

Permitir que los administradores reseteen la contraseña de cualquier usuario generando una contraseña temporal segura y enviándola por email.

Casos de Uso​

  • Administrador necesita resetear contraseña de un usuario bloqueado
  • Usuario no puede acceder y requiere intervención administrativa
  • Soporte técnico resetea credenciales de usuario

Flujo del Proceso​

  1. Administrador solicita reset de contraseña de usuario
  2. Middleware m.isGestor verifica que el usuario tiene rol de gestor/admin/dev (401 si no)
  3. Cliente envía POST con ID del usuario en la URL
  4. Servidor busca usuario por ID en base de datos
  5. Si el usuario no existe, retorna error 404
  6. Si el usuario existe, genera contraseña aleatoria segura
  7. Hashea la nueva contraseña con bcrypt
  8. Guarda nueva contraseña en base de datos
  9. Envía email con la nueva contraseña generada
  10. Retorna datos del usuario actualizados (sin incluir la contraseña)
  11. Registra acción en historial de seguridad

Seguridad​

  • Requiere autenticación y permisos de gestión (rol gestor, admin o dev)
  • Contraseña generada aleatoriamente es segura (mínimo 8 caracteres)
  • Se envía por email para asegurar que el usuario real la reciba
  • Requiere autorización adecuada para realizar esta operación

Request​

Responses​

Contraseña reseteada exitosamente

Response Headers