TD8 – Authentification & validation par email Sécurité des mots de passe

Créez à partir du code précédent le haché Sha-256 d’un mot du dictionnaire français. Utilisez un site comme md5decrypt pour retrouver le mot de passe originel à partir de son haché.

1. Copiez cette classe dans le fichier src/Lib/MotDePasse.php. Exécutez la commande

   var_dump(MotDePasse::genererChaineAleatoire());
   

   et copiez-le dans l’attribut statique $poivre une fois pour toute.

   Note : Une façon simple d’exécuter la commande est de décommenter temporairement cette ligne dans MotDePasse.php puis d’exécuter la commande suivante dans le terminal (avec pour dossier courant src/Lib)

   php MotDePasse.php
   

2. Nous allons modifier la structure de données utilisateur :
   1. Modifiez la table utilisateur en lui ajoutant une colonne VARCHAR(256) mdpHache non null stockant son mot de passe.
   2. Mettez à jour la classe métier Utilisateur (dossier src/Modele/DataObject) :
      1. ajoutez un attribut private string $mdpHache,
      2. mettez à jour le constructeur,
      3. rajoutez un getter et un setter,
      4. mettez à jour la méthode formatTableau (qui fournit les données des requêtes SQL préparées).
   3. Mettez à jour la classe de persistance UtilisateurRepository :
      1. mettez à jour construireDepuisTableau (qui permet de construire un utilisateur à partir de la sortie d’une requête SQL),
      2. mettez à jour getNomsColonnes.

   Note : L’utilisation d’un framework PHP professionnel nous éviterait ces tâches répétitives.

1. Modifier la vue utilisateur/formulaireCreation.php pour ajouter deux champs password au formulaire

   <p class="InputAddOn">
         <label class="InputAddOn-item" for="mdp_id">Mot de passe&#42;</label>
         <input class="InputAddOn-field" type="password" value="" placeholder="" name="mdp" id="mdp_id" required>
   </p>
   <p class="InputAddOn">
         <label class="InputAddOn-item" for="mdp2_id">Vérification du mot de passe&#42;</label>
         <input class="InputAddOn-field" type="password" value="" placeholder="" name="mdp2" id="mdp2_id" required>
   </p>
   

   Le deuxième champ mot de passe sert à valider le premier.

2. Modifiez l’action creerDepuisFormulaire du utilisateur :

   1. rajoutez la condition que les deux champs mot de passe doivent coïncider avant de sauvegarder l’utilisateur. En cas d’échec, appelez à l’action d’erreur afficherErreur avec un message Mots de passe distincts.

   2. Nous allons changer la manière de construire un objet métier utilisateur à partir des données $_GET du formulaire. Jusqu’à présent, nous appelions Utilisateur::__construct() ou de manière équivalente UtilisateurRepository::construireDepuisTableau(). Mais ces méthodes sont faites pour prendre en entrée un résultat SQL (sous forme de tableau). À cause du mot de passe qui est en clair dans le formulaire, mais haché dans la BDD, il faut changer le code.

      • Créez une méthode

        public static function construireDepuisFormulaire (array $tableauFormulaire) : Utilisateur
        

        dans la classe Utilisateur. Elle appelle le constructeur de Utilisateur en hachant d’abord le mot de passe.

      • Mettez à jour l’action creerDepuisFormulaire pour appeler construireDepuisFormulaire().
      • Puisque construireDepuisTableau() n’est présent que dans AbstractRepository ou ses classes filles (UtilisateurRepository, VoitureRepository, …), passez sa visibilité de public à protected dans AbstractRepository et ses classes filles.

3. Rajoutons au menu de notre site un lien pour s’inscrire. Dans le menu de la vue générique vueGenerale.php, rajoutez une icône cliquable ¹ qui pointe vers l’action afficherFormulaireCreation (contrôleur utilisateur).

4. Testez l’inscription d’un utilisateur avec mot de passe.

1. Modifier la vue formulaireMiseAJour.php pour ajouter trois champs password : l’ancien mot de passe, le nouveau qu’il faut écrire 2 fois pour ne pas se tromper.
2. Modifiez l’action mettreAJour :
   • vérifiez que les 2 nouveaux mots de passe coïncident. En cas d’échec, appelez à l’action d’erreur afficherErreur avec un message Mots de passe distincts.
   • Vérifiez que l’ancien mot de passe est correct. En cas d’échec, appelez à l’action d’erreur afficherErreur avec un message Ancien mot de passe erroné.
   • Le cas échéant, mettez à jour votre utilisateur en appelant les setter. N’oubliez pas de hacher le mot de passe. Enfin, effectuez la mise à jour dans la base de données.
3. Testez la mise à jour du mot de passe d’un utilisateur.

Procédons en plusieurs étapes :

1. Nous allons regrouper les méthodes liées à la connexion d’un utilisateur dans la classe purement statique ConnexionUtilisateur. Créez cette classe dans le fichier src/Lib/ConnexionUtilisateur.php à partir du code suivant et complétez-la pour que :

   • La connexion enregistre le login d’un utilisateur en session dans le champ $cleConnexion.
   • Le client est connecté si et seulement si la session contient un enregistrement associé à la clé $cleConnexion.
   • La déconnexion consiste à supprimer cet enregistrement de la session.
   • getLoginUtilisateurConnecte() renvoie null si le client n’est pas connecté.

   namespace App\Covoiturage\Lib;
   
   class ConnexionUtilisateur
   {
       // L'utilisateur connecté sera enregistré en session associé à la clé suivante 
       private static string $cleConnexion = "_utilisateurConnecte";
   
       public static function connecter(string $loginUtilisateur): void
       {
           // À compléter
       }
   
       public static function estConnecte(): bool
       {
           // À compléter
       }
   
       public static function deconnecter(): void
       {
           // À compléter
       }
   
       public static function getLoginUtilisateurConnecte(): ?string
       {
           // À compléter
       }
   }
   

2. Rajoutons au menu de notre site un lien pour se connecter. Dans le menu de la vue générique vueGenerale.php, rajoutez une icône cliquable qui pointe vers la future action afficherFormulaireConnexion (contrôleur utilisateur).
   Ce lien, ainsi que le lien d’inscription , ne doivent s’afficher que si aucun utilisateur n’est connecté (utiliser une méthode de la classe ConnexionUtilisateur).

   Note : Il est autorisé de mettre un if dans la vue vueGenerale.php.

3. Créons une vue pour afficher un formulaire de connexion :

   1. Créer une vue utilisateur/formulaireConnexion.php qui comprend un formulaire avec deux champs, l’un pour le login, l’autre pour le mot de passe. Ce formulaire appelle la future action connecter du contrôleur utilisateur.
   2. Ajouter une action afficherFormulaireConnexion qui affiche ce formulaire.

4. Créons enfin l’action connecter() du contrôleur utilisateur :

   1. Commençons par les vérifications à faire avant de se connecter. La première vérification est qu’un login et un mot de passe sont transmis dans le query string. Sinon, appelez afficherErreur avec le message Login et/ou mot de passe manquant.
   2. Puis, il faut récupérer l’utilisateur ayant le login transmis. Ceci permettra de vérifier que ce login existe bien et que le mot de passe transmis est correct (utiliser une méthode de la classe MotDePasse). Sinon, appelez afficherErreur avec le message Login inconnu.
   3. Enfin, vous pouvez connecter l’utilisateur (utiliser une méthode de la classe ConnexionUtilisateur). Affichez une nouvelle vue utilisateur\utilisateurConnecte.php qui écrit un message Utilisateur connecté puis appelle la vue detail.php pour afficher l’utilisateur connecté. Cette vue est similaire à utilisateurCree.php.

1. Quand un utilisateur est connecté, ajoutez au menu de la vue générique vueGenerale.php deux cases :
   • la première contient une icône cliquable qui renvoie vers la vue de détail de l’utilisateur connecté.
   • puis une deuxième case avec une icône cliquable qui pointe vers la future action deconnecter (contrôleur utilisateur).

2. Ajouter une action deconnecter qui déconnecte l’utilisateur (utiliser une méthode de la classe ConnexionUtilisateur). Affichez une nouvelle vue utilisateur\utilisateurDeconnecte.php qui affiche le message Utilisateur déconnecté puis la liste des utilisateurs.

   Note : Toutes les vues utilisateurConnecte.php, utilisateurDeconnecte.php, utilisateurCree.php, utilisateurMisAJour.php et utilisateurSupprime.php sont bien sûr redondantes. Nous résoudrons ce problème lors du TD9 sur les messages Flash.

1. Assurez-vous que la vue utilisateur/liste.php n’affiche que les liens vers la vue de détail, pas les liens de modification ou de suppression.

2. Modifier la vue de détail pour qu’elle n’affiche les liens vers la mise à jour ou la suppression que si le login de l’utilisateur concorde avec celui stocké en session.

   Pour vous aider dans cette tâche, rajoutez la méthode suivante à ConnexionUtilisateur

   public static function estUtilisateur($login): bool
   

   qui doit vérifier si un utilisateur est connecté et que son login correspond à celui passé en argument de la fonction.

1. « Hacker » votre site en accédant à la page de mise à jour d’un utilisateur quelconque.

2. Modifier l’action afficherFormulaireMiseAJour du contrôleur utilisateur de sorte que l’accès au formulaire soit restreint à l’utilisateur connecté. En cas de problème, utiliser afficherErreur pour afficher un message La mise à jour n’est possible que pour l’utilisateur connecté.

   Note : la succession des if, else, if pourrait être évité en utilisant des return; dans chaque cas d’erreur. Ce style de codage est plus sûr car on sait plus facilement dans quel cas on est.

1. « Hacker » votre site en effectuant une mise à jour d’un utilisateur quelconque sans changer de code PHP².
   Note : Ce « hack » sera bien plus simple à réaliser si le formulaire de mise à jour est en méthode GET, et pareil pour sa page de traitement. Passez temporairement votre formulaire en cette méthode si nécessaire.

2. Mettez à jour l’action mettreAJour du contrôleur utilisateur pour qu’il effectue toutes les vérifications suivantes, avec afficherErreur en cas de problème :
   • vérifiez que tous les champs obligatoires du formulaire ont été transmis.
   • Vérifiez que le login existe ;
   • Vérifiez que les 2 nouveaux mots de passe coïncident ;
   • Vérifiez que l’ancien mot de passe est correct ;
   • Vérifiez que l’utilisateur mis-à-jour correspond à l’utilisateur connecté.
3. Sécurisez de manière similaire l’accès à l’action supprimer d’un utilisateur.

1. Ajouter un champ estAdmin de type BOOLEAN (ou TINYINT(1)) non NULL à la table utilisateur.

2. Mettez à jour la classe métier Utilisateur (dossier src/Modele/DataObject) :
   1. ajoutez un attribut private bool $estAdmin,
   2. mettez à jour le constructeur,
   3. rajoutez un getter et un setter,

   4. mettez à jour la méthode formatTableau (qui fournit les données des requêtes SQL préparées).

      Attention : SQL stocke différemment les booléens que PHP. En SQL, on encode false avec l’entier 0 et true avec l’entier 1. Il faut donc que votre méthode formatTableau renvoie 0 ou 1 pour le champ estAdminTag.

   5. Mettez à jour construireDepuisFormulaire avec return null;. Nous complèterons cette fonction correctement plus tard.
3. Mettez à jour la classe de persistance UtilisateurRepository :
   1. mettez à jour construireDepuisTableau (qui permet de construire un utilisateur à partir de la sortie d’une requête SQL),
   2. mettez à jour getNomsColonnes.

1. Rajoutez la méthode suivante à ConnexionUtilisateur

   public static function estAdministrateur() : bool
   

   Cette méthode doit renvoyer true si un utilisateur est connecté et qu’il est administrateur. Les informations sur l’utilisateur devront être récupérées de la base de données.

   Remarque optionnelle : On aurait pu coder un système qui récupère une seule fois les données de l’utilisateur connecté à partir de la base de données, et le stocke dans un attribut statique de la classe ConnexionUtilisateur.

1. Rajoutez un bouton checkbox au formulaire de création

   <p class="InputAddOn">
         <label class="InputAddOn-item" for="estAdmin_id">Administrateur</label>
         <input class="InputAddOn-field" type="checkbox" placeholder="" name="estAdmin" id="estAdmin_id">
   </p>
   

2. Pour que l’action creerDepuisFormulaire arrive à construire un utilisateur et à le sauvegarder en base de données, il ne manque que la mise à jour de la méthode construireDepuisFormulaire. Si la case est cochée, alors estAdmin=on sera transmis. Si la case n’est pas cochée, aucune donnée liée au checkbox n’est rajoutée.

   Mettez à jour la méthode construireDepuisFormulaire avec ces explications. Vérifiez dans PHPMyAdmin que vous arrivez à créer des utilisateurs administrateurs ou non.

1. Rajoutez un bouton checkbox au formulaire de mise-à-jour. Faites en sorte que le bouton soit pré-coché (attribut checked) si l’utilisateur est déjà administrateur.

2. Dans l’action mettreAJour, rajoutez un appel au setter setEstAdmin. Vérifiez que la mise à jour fonctionne.

1. Processus de création :

   1. Le champ Administrateur ? du formulaire de création ne doit apparaître que si l’utilisateur connecté est administrateur.

      Note : Vous pouvez mettre un if dans la vue.

   2. Plus important, l’action creerDepuisFormulaire ne doit créer des administrateurs que si l’utilisateur connecté est administrateur.

      Aide : si l’utilisateur connecté n’est pas administrateur, forcez l’utilisateur créé à ne pas être administrateur, indépendamment de la valeur reçue par le formulaire.

2. Processus de mise-à-jour :
   1. Les liens de mise-à-jour d’un utilisateur doivent apparaître quand un administrateur est connecté (utilisez ConnexionUtilisateur::estAdministrateur()).
   2. Le champ Administrateur ? du formulaire de mise-à-jour ne doit apparaître que si l’utilisateur connecté est administrateur.
   3. Plus important, l’action mettreAJour ne doit modifier le statut administrateur que si l’utilisateur connecté est administrateur.
   4. Enfin, un administrateur doit pouvoir modifier n’importe quel utilisateur. Il ne doit pas avoir à fournir l’ancien mot de passe. Si un administrateur est connecté et que le login fourni n’existe pas, affichez un message d’erreur Login inconnu.

1. Ajouter trois champs à la table utilisateur :
   • email de type VARCHAR(256) non NULL,
   • emailAValider de type VARCHAR(256) non NULL,
   • nonce de type VARCHAR(32) non NULL,
2. Mettez à jour la classe métier Utilisateur (dossier src/Modele/DataObject) :
   1. ajoutez les attributs,
   2. mettez à jour le constructeur, les getter et les setter,
   3. mettez à jour la méthode formatTableau (qui fournit les données des requêtes SQL préparées),
   4. vous mettrez à jour la méthode construireDepuisFormulaire plus tard.
3. Mettez à jour la classe de persistance UtilisateurRepository :
   1. mettez à jour construireDepuisTableau (qui permet de construire un utilisateur à partir de la sortie d’une requête SQL),
   2. mettez à jour getNomsColonnes.

1. Créez la classe avec le code suivant, que nous complèterons plus tard

   namespace App\Covoiturage\Lib;
   
   use App\Covoiturage\Configuration\ConfigurationSite;
   use App\Covoiturage\Modele\DataObject\Utilisateur;
   
   class VerificationEmail
   {
      public static function envoiEmailValidation(Utilisateur $utilisateur): void
      {
         $loginURL = rawurlencode($utilisateur->getLogin());
         $nonceURL = rawurlencode($utilisateur->getNonce());
         $URLAbsolue = ConfigurationSite::getURLAbsolue();
         $lienValidationEmail = "$URLAbsolue?action=validerEmail&controleur=utilisateur&login=$loginURL&nonce=$nonceURL";
         $corpsEmail = "<a href=\"$lienValidationEmail\">Validation</a>";
   
         // Temporairement avant d'envoyer un vrai mail
         var_dump($corpsEmail);
      }
   
      public static function traiterEmailValidation($login, $nonce): bool
      {
         // À compléter
         return true;
      }
   
      public static function aValideEmail(Utilisateur $utilisateur) : bool
      {
         // À compléter
         return true;
      }
   }
   

   Rajoutez une méthode ConfigurationSite::getURLAbsolue qui renvoie la base de l’URL de votre site, par exemple

   http://webinfo.iutmontp.univ-montp2.fr/~mon_login/TD-PHP/TD8/web/controleurFrontal.php
   

2. Dans votre formulaire de création d’un utilisateur, rajoutez un champ pour l’adresse email

   <p class="InputAddOn">
         <label class="InputAddOn-item" for="email_id">Email&#42;</label>
         <input class="InputAddOn-field" type="email" value="" placeholder="toto@yopmail.com" name="email" id="email_id" required>
   </p>
   

3. Pour faire fonctionner l’action creerDepuisFormulaire :
   • il faut que l’utilisateur créé avec construireDepuisFormulaire soit correct :
     Mettez à jour la méthode construireDepuisFormulaire pour qu’elle donne la valeur "" à l’email, qu’elle stocke l’adresse mail du formulaire dans emailAValider, et qu’elle crée un nonce aléatoire à l’aide de MotDePasse::genererChaineAleatoire().
   • il faut envoyer l’email de validation en cas de succès de la sauvegarde : appelez la fonction VerificationEmail::envoiEmailValidation.
4. Faisons en sorte que le lien envoyé par mail valide bien l’adresse mail.
   • Ajoutez une action validerEmail au contrôleur Utilisateur qui récupère en GET deux valeurs login et nonce (si elle existe sinon on appelle afficherErreur) et appelle VerificationEmail::traiterEmailValidation() avec ces valeurs.
     En cas de succès, on affiche la page de détail de cet utilisateur. En cas d’échec, on appelle afficherErreur.
   • Codez traiterEmailValidation() :
     Si le login correspond à un utilisateur présent dans la base et que le nonce passé en GET correspond au nonce de la BDD, alors coupez/collez l’email à valider dans l’email et passez à "" le champ nonce de la BDD.

5. Testez que la validation de l’email marche bien après la création d’un utilisateur. Pour ceci, regarder dans la BDD que les données évoluent bien à chaque étape.

6. Modifiez la fonction VerificationEmail::envoiEmailValidation pour qu’elle envoie un mail à l’adresse renseignée avec un lien qui enverra le nonce au site. Pour vous aider, voici un exemple de code utilisant la fonction mail() de PHP.

   $destinataire = 'bob@yopmail.com';
   $sujet = "Validation de l'adresse email";
   $contenuHTML = '<a href="https://www.youtube.com/watch?v=dQw4w9WgXcQ">Un exemple de lien</a>'
   
   // Pour envoyer un email contenant du HTML
   $enTete = "MIME-Version: 1.0" . "\r\n";
   $enTete .= "Content-type:text/html;charset=UTF-8" . "\r\n";
   
   // Envoi du mail. Renvoi true/false selon si l'envoi a fonctionné
   mail($destinataire, $sujet, $contenuHTML, $enTete);
   

   Note : La fonction mail() n’est disponible que sur le serveur webinfo Web de l’IUT. Si vous avez installé un serveur Web local sur votre machine avec MAMP/XAMPP, mail() n’est pas configuré par défaut. XAMPP sur Linux permet d’activer l’envoi, cf. leur FAQ Linux, Windows ou Mac OS.
   La bonne solution multiplateforme nécessite d’installer une bibliothèque PHP, ce que nous apprendrons à faire au semestre 4. Autrement, vous pouvez rester avec mail().

1. Modifiez l’action connecter du contrôleur utilisateur de sorte à accepter la connexion uniquement si l’utilisateur a validé un email.
   • Pour ceci, appelez la méthode VerificationEmail::aValideEmail().
   • Codez cette méthode pour qu’elle regarde si l’utilisateur a un email différent de "".

2. Dans l’action creerDepuisFormulaire du contrôleur utilisateur , vérifiez que l’adresse email envoyée par l’utilisateur en est bien une. Pour cela, vous pouvez par exemple utiliser la fonction filter_var() avec le filtre FILTER_VALIDATE_EMAIL.

3. Mise à jour d’un utilisateur :
   • rajoutez un champ Email prérempli,
   • dans l’action mettreAJour, vérifiez le format de l’email puis écrivez-le dans le champ emailAValider. Créez aussi un nonce aléatoire et envoyez le mail de validation.

1. Rajoutez une méthode ConfigurationSite::getDebug() qui renverra true ou false.

2. La variable globale $_REQUEST est similaire à $_GET et $_POST, à ceci près qu’elle est la fusion de ces tableaux. En cas de conflit, les valeurs de $_POST écrasent celles de $_GET.

   Remplacez tous les $_GET par des appels à $_REQUEST.

   Aide : Utiliser la fonction de remplacement globale (sur tous les fichiers du dossier TD8) pour vous aider.

3. Passez les formulaires formulaireCreation.php, formulaireMiseAJour.php, formulaireConnexion.php et formulairePreference.php en méthode POST si ConfigurationSite::getDebug() est false ou en méthode GET sinon.