Aller au contenu principal

Reset User Password (Admin)

POST 
/company/auth/reset/:id

Point de terminaison pour réinitialiser le mot de passe d'un utilisateur (opération administrative).
Génère un nouveau mot de passe aléatoire et l'envoie par e-mail.

Permettre aux administrateurs de réinitialiser le mot de passe de n'importe quel utilisateur
en générant un mot de passe temporaire sécurisé et en l'envoyant par e-mail.

Cas d'utilisation​

  • Un administrateur doit réinitialiser le mot de passe d'un utilisateur bloqué
  • Un utilisateur ne peut pas accéder et nécessite une intervention administrative
  • Le support technique réinitialise les identifiants d'un utilisateur

Flux du processus​

  1. L'administrateur demande la réinitialisation du mot de passe d'un utilisateur
  2. Le middleware m.isGestor vérifie que l'utilisateur a le rôle de gestionnaire/administrateur/développeur (401 sinon)
  3. Le client envoie une requête POST avec l'ID de l'utilisateur dans l'URL
  4. Le serveur recherche l'utilisateur par ID dans la base de données
  5. Si l'utilisateur n'existe pas, retourne une erreur 404
  6. Si l'utilisateur existe, génère un mot de passe aléatoire sécurisé
  7. Hache le nouveau mot de passe avec bcrypt
  8. Enregistre le nouveau mot de passe dans la base de données
  9. Envoie un e-mail avec le nouveau mot de passe généré
  10. Retourne les données de l'utilisateur mises à jour (sans inclure le mot de passe)
  11. Enregistre l'action dans l'historique de sécurité

Sécurité​

  • Nécessite une authentification et des autorisations de gestion (rôle gestionnaire, administrateur ou développeur)
  • Le mot de passe généré aléatoirement est sécurisé (minimum 8 caractères)
  • Il est envoyé par e-mail pour garantir que l'utilisateur réel le reçoive
  • Nécessite une autorisation appropriée pour effectuer cette opération

Request​

Responses​

Mot de passe réinitialisé avec succès

Response Headers