Protéger un dossier avec un .htaccess

Lorsque vous réalisez votre site en PHP, vous êtes souvent amenés à créer une zone « Admin » où l'accès est limité… Et il vaut mieux, vu que les personnes qui ont accès à la zone Admin peuvent en général tout supprimer si elles le désirent.

Supposons que vous ayez créé un dossier « Admin » dans lequel il y a tous les fichiers d'administration de votre site. Comment empêcher que n'importe qui accède à ces pages ?

C'est là que les fichiers .htaccess vont bien nous aider : on peut très facilement créer une protection par login/mot de passe qui empêche l'accès à tous les fichiers du dossier.

Il va falloir créer deux fichiers :

· .htaccess : ce fichier contiendra l'adresse du .htpasswd et quelques autres options que vous pourrez définir ;

· .htpasswd : ce fichier contiendra une liste de logins/mots de passe, pour chaque personne autorisée à accéder aux pages !

La première étape est de créer sur votre disque dur un fichier appelé .htaccess. Oui, c'est un fichier qui n'a pas de nom et qui a seulement une extension, à savoir .htaccess. Ne soyez donc pas étonnés s'il commence par un point.

Ouvrez un nouveau fichier avec votre éditeur de texte favori. Nous allons écrire des codes qui n'ont rien à voir avec du HTML ou du PHP : ce sont des instructions pour le serveur. Elles vont lui expliquer que seules certaines personnes sont autorisées à accéder au dossier. Copiez-y ce code :

AuthName "Page d'administration protégée"

AuthType Basic

AuthUserFile "/home/site/www/admin/.htpasswd"

Require valid-user

Parmi ces quatre lignes, il y en a deux que vous allez devoir changer :

· AuthName : c'est le texte qui invitera l'utilisateur à inscrire son login et son mot de passe. Vous pouvez personnaliser ce texte comme bon vous semble ;

· AuthUserFile : là c'est plus délicat ; c'est le chemin absolu vers le fichier .htpasswd (que vous mettrez dans le même répertoire que le .htaccess).

Mais comment je trouve ce chemin absolu, moi ?

En effet, la plupart du temps, cela s'avère délicat à trouver car cela dépend du serveur. Heureusement, il existe une fonction PHP qui va beaucoup nous aider : realpath. Cette fonction donne le chemin absolu vers le fichier que vous indiquez. Vous allez donc faire comme suit pour trouver le chemin absolu.

1. Créez un fichier appelé chemin.php.

2. Inscrivez juste cette ligne de code à l'intérieur :

<?php echo realpath('chemin.php'); ?>

3. Envoyez ce fichier sur votre serveur avec votre logiciel FTP, et placez-le dans le dossier que vous voulez protéger.

4. Ouvrez votre navigateur et allez voir ce fichier PHP. Il vous donne le chemin absolu, par exemple dans mon cas :

/home/site/www/admin/chemin.php

5. Copiez ce chemin dans votre .htaccess, et remplacez le chemin.php par .htpasswd, ce qui nous donne au final par exemple :

/home/site/www/admin/.htpasswd

6. Supprimez le fichier chemin.php de votre serveur, il ne nous sert plus à rien maintenant qu'il nous a donné le chemin absolu.

Si vous êtes hébergés chez Free, il y a une petite subtilité dans la gestion de la localisation du .htpasswd : vous ne devez pas renseigner la ligne AuthUserFile par le chemin absolu du fichier, mais par son chemin relatif à partir de la racine de votre espace perso. Exemple : si vous utilisez un espace Free nommé monftpfree, et que vous placez votre fichier .htpasswd dans un répertoire admin, le fichier chemin.php vous renverra un chemin sous la forme /mnt/XXX/sda/X/X/monftpfree/admin/.htpasswd. Vous devez alors simplement écrire : /monftpfree/admin/.htpasswd.

Enregistrez le fichier en inscrivant le nom entre guillemets, comme ceci : ".htaccess". Cela permet de forcer l'éditeur à enregistrer un fichier qui commence par un point.

Voilà : on a fini de créer le .htaccess, on peut maintenant passer au .htpasswd ! ;-)

Créez maintenant un nouveau fichier avec votre éditeur de texte.

Le .htpasswd va contenir la liste des personnes autorisées à accéder aux pages du dossier. On y inscrit une personne par ligne, sous cette forme :

Au final, votre fichier .htpasswd devrait ressembler à ceci :

mateo21:$1$MEqT//cb$hAVid.qmmSGFW/wDlIfQ81

ptipilou:$1$/lgP8dYa$sQNXcCP47KhP1sneRIZoO0

djfox:$1$lT7nqnsg$cVtoPfe0IgrjES7Ushmoy.

vincent:$1$h4oVHp3O$X7Ejpn.uuOhJRkT3qnw3i0

Dans cet exemple, il y a quatre personnes autorisées à accéder au dossier : mateo21, ptipilou, djfox et vincent.

Comment peut-on crypter les mots de passe ?

Bonne question ! Encore une fois, il y a une super fonction PHP qui va nous tirer d'affaire : crypt. Vous lui donnez un mot de passe et elle vous le crypte (ne cherchez pas à savoir comment).

Par exemple, si mon mot de passe est « kangourou », voici le code PHP que je devrai écrire pour l'obtenir en version cryptée :

<?php echo crypt('kangourou'); ?>

Crypter ses mots de passe est très utile : en effet, si quelqu'un vient un jour à lire votre fichier .htpasswd (quelqu'un qui utilise le même PC que vous par exemple), il ne verra que le mot de passe crypté. Et là, aucun risque qu'il ne retrouve votre mot de passe : ce cryptage est indéchiffrable. Il est à sens unique (il s'agit en fait d'une autre forme de hachage que l'on a découvert dans le TP espace membres).

Bon : on pourrait en théorie s'arrêter là pour le .htpasswd, mais mon âme de codeur PHP me commande de créer un petit script qui va bien vous être utile (non, non, ne me remerciez pas, c'est tout naturel !).

<?php

if (isset($_POST['login']) AND isset($_POST['pass']))

{

$login = $_POST['login'];

$pass_crypte = crypt($_POST['pass']); // On crypte le mot de passe

echo '<p>Ligne à copier dans le .htpasswd :<br />' . $login . ':' . $pass_crypte . '</p>';

}

else // On n'a pas encore rempli le formulaire

{

<p>Entrez votre login et votre mot de passe pour le crypter.</p>

<p>

Mot de passe : <input type="text" name="pass"><br /><br />

</p>

</form>

<?php

}

Essayer !

Il y a deux parties dans ce code :

1. SI les variables $_POST['login'] et $_POST['pass'] existent, alors c'est qu'on vient de valider le formulaire.

On crypte le mot de passe qu'on a entré, et on affiche $login:$pass_crypte pour que vous n'ayez plus qu'à copier la ligne dans le .htpasswd ;

2. SINON, si les variables $_POST['login'] ou $_POST['pass'] n'existent pas, on affiche donc le formulaire pour demander d'entrer un login et un mot de passe.

Le formulaire recharge la même page car il n'y a pas d'attribut action dans la balise <form>, comme on l'a vu dans le chapitre sur les formulaires. Lors du rechargement de la page, les variables $_POST['login'] et $_POST['pass'] existeront puisque vous venez d'entrer le login et le mot de passe. Ce dernier sera alors crypté !

Je vous conseille de créer cette page quelque part sur votre disque dur (ou sur votre serveur, peu importe), pour que vous puissiez crypter rapidement vos mots de passe pour le .htpasswd.

Si vous avez la flemme de la créer, pas de souci, vous n'avez qu'à vous servir du code web ci-dessus.

Il y a certains cas dans lesquels vous ne devrez pas crypter les mots de passe. Sous WAMP ou sur les serveurs de Free.fr par exemple, vous ne DEVEZ PAS crypter vos mots de passe pour que cela fonctionne. Vous devrez donc les écrire directement. Par exemple :

mateo21:kangourou

Collé à partir de <http://fr.openclassrooms.com/informatique/cours/concevez-votre-site-web-avec-php-et-mysql/proteger-un-dossier-avec-un-htaccess>