Pular para o conteúdo principal

Reset User Password (Admin)

POST 
/company/auth/reset/:id

Endpoint para redefinir a senha de um usuário (operação administrativa).
Gera uma nova senha aleatória e a envia por e-mail.

Permitir que os administradores redefinam a senha de qualquer usuário gerando uma senha temporária segura e enviando-a por e-mail.

Casos de Uso​

  • Administrador precisa redefinir a senha de um usuário bloqueado
  • Usuário não consegue acessar e requer intervenção administrativa
  • Suporte técnico redefine as credenciais do usuário

Fluxo do Processo​

  1. Administrador solicita a redefinição de senha do usuário
  2. Middleware m.isGestor verifica se o usuário tem papel de gestor/admin/dev (401 caso contrário)
  3. Cliente envia POST com o ID do usuário na URL
  4. Servidor busca o usuário pelo ID no banco de dados
  5. Se o usuário não existir, retorna erro 404
  6. Se o usuário existir, gera uma senha aleatória segura
  7. Faz o hash da nova senha com bcrypt
  8. Salva a nova senha no banco de dados
  9. Envia e-mail com a nova senha gerada
  10. Retorna os dados do usuário atualizados (sem incluir a senha)
  11. Registra a ação no histórico de segurança

Segurança​

  • Requer autenticação e permissões de gestão (papel de gestor, admin ou dev)
  • A senha gerada aleatoriamente é segura (mínimo de 8 caracteres)
  • É enviada por e-mail para garantir que o usuário real a receba
  • Requer autorização adequada para realizar esta operação

Request​

Responses​

Senha redefinida com sucesso

Response Headers