Manuel PHP
Précédent |  | Suivant

# Chapitre 16. Identification HTTP avec PHP

Les fonctions d'identification HTTP de PHP ne sont disponibles que si PHP est exécuté comme module Apache, et non pas sous la forme d'un CGI. Sous cette forme, il est possible d'utiliser la fonction header() pour demander une identification (`"Authentication Required"`) au client, générant ainsi l'apparition d'une fenêtre de demande d'utilisateur et de mot de passe. Une fois que les champs ont été remplis, l'URL sera de nouveau appelée, avec les variables `$PHP_AUTH_USER`, `$PHP_AUTH_PW` et `$PHP_AUTH_TYPE` contenant respectivement le nom d'utilisateur, le mot de passe et le type d'identification. Actuellement, seule l'identification simple ("Basic") est supportée. Reportez-vous à la fonction header() pour plus d'informations.

> Note sur les versions de PHP : Les auto-globales, telles que `$_SERVER`, ont été ajoutée en `PHP` à partir de la version 4.1.0. `$HTTP_SERVER_VARS` est disponible depuis PHP 3.

Voici un exemple de script qui force l'identification du client pour accéder à une page :

Exemple 16-1. Exemple d'identification HTTP

`<?php if (!isset($_SERVER['PHP_AUTH_USER'])) { header('WWW-Authenticate: Basic realm="My Realm"'); header('HTTP/1.0 401 Unauthorized'); echo 'Texte utilisé si le visiteur utilise le bouton d\'annulation'; exit; } else { echo "<p>Bonjour, {$_SERVER['PHP_AUTH_USER']}.</p>"; echo "<p>Votre mot de passe est {$_SERVER['PHP_AUTH_PW']}.</p>"; } ?>`

> Note de compatibilité : Soyez bien prudent lorsque vous utilisez des en-têtes HTTP avec `PHP`. Afin de garantir un maximum de compatibilité entre les navigateurs, le mot clé "Basic" doit être écrit avec un B majuscule, et le texte de présentation doit être placé entre guillemets simples, et exactement un espace doit précéder le code 401 dans l'en-tête HTTP/1.0 401.

Au lieu d'afficher simplement les variables globales `$PHP_AUTH_USER` et `$PHP_AUTH_PW`, vous préférerez sûrement vérifier la validité du nom d'utilisateur et du mot de passe. Par exemple, en envoyant ces informations à une base de données, ou en recherchant dans un fichier dbm.

Méfiez-vous des navigateurs buggés, tels que Internet Explorer. Ils semblent très susceptibles concernant l'ordre des en-têtes. Envoyer l'en-tête d'identification (`WWW-Authenticate`) avant le code de HTTP/1.0 401 semble lui convenir jusqu'à présent.

Pour éviter que quelqu'un écrive un script qui révèle les mots de passe d'une page, à la quelle on a accédé par une identification traditionnelle, les variables globales PHP_AUTH ne seront pas assignées si l'identification externe a été activée pour cette page. Dans ce cas, la variable `REMOTE_USER` peut être utilisée pour identifier l'utilisateur à l'extérieur. De même que `$_SERVER['REMOTE_USER']`.

> Note de configuration : `PHP` utilise la présence de la directive `AuthType` pour déterminer si une identification externe est activé. évitez donc cette directive de contexte si vous voulez utiliser l'identification de `PHP` (sinon, les deux identifications se contrediront, et échoueront).

Notez cependant que les manipulations ci-dessus n'empêchent pas quiconque possède une page non authentifiée de voler les mots de passe des pages protégées, sur le même serveur.

Netscape et Internet Explorer effaceront le cache d'identification client s'ils reçoivent une réponse 401. Cela permet de déconnecter un utilisateur, pour le forcer à saisir à nouveau son nom de compte et son mot de passe. Certains programmeurs l'utilisent pour donner un délai d'expiration, ou alors, fournissent un bouton de déconnexion.

Exemple 16-2. Identification HTTP avec nom d'utilisateur/mot de passe forcé

`<?php
function authenticate()
{
header('WWW-Authenticate: Basic realm="Test Authentication System"');
header('HTTP/1.0 401 Unauthorized');
echo "Vous devez entrer un identifiant et un mot de passe valide pour accéder
à cette ressource.\n";
exit;
}
if ( !isset($_SERVER['PHP_AUTH_USER']) ||
($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) {
authenticate();
} else {
echo "<p>Welcome: {$_SERVER['PHP_AUTH_USER']}<br>";
echo "Old: {$_REQUEST['OldAuth']}";
echo "<form action='{$_SERVER['PHP_SELF']}' method='POST'>\n";
echo "<input type='hidden' name='SeenBefore' value='1'>\n";
echo "<input type='hidden' name='OldAuth' value='{$_SERVER['PHP_AUTH_USER']}'>\n";
echo "<input type='submit' value='Re Authenticate'>\n";
echo "</form></p>\n";
}
?>`

Ce comportement n'est pas nécessaire par le standard d'identification `HTTP Basic`. Les tests avec Lynx ont montré qu'il n'affectait pas les informations de session lors de la réception d'un message de type 401. Ce qui fait que presser la touche "retour" (`back`) à un client Lynx précédemment identifié donnera l'accès direct à la ressource. Cependant, l'utilisateur peut utiliser la touche `'_'` pour détruire les anciennes identifications.

Notez aussi que tout ceci ne fonctionne pas sous Microsoft IIS et que les limitations de PHP en version CGI sont dues aux limitations de IIS.

> Note : Si le safe mode est activé, l'uid du script es ajouté automatiquement dans l'en-tête `realm`, comme faisant partie de l'en-tête `WWW-Authenticate`.

Précédent | Sommaire | Suivant
Caractéristiques | Niveau supérieur | Cookies