Les fournisseurs d'autorisation implémentés par le module
.htaccess
pour
contrôler l'accès à certaines zones du serveur. Le contrôle d'accès
peut être effectué en fonction du nom d'hôte, de l'adresse IP, ou
d'autres caractéristiques de la requête client, telles qu'elles sont
enregistrées dans des variables
d'environnement.
En général, les directives de restriction d'accès s'appliquent à
toutes les méthodes d'accès (GET
, PUT
,
POST
, etc...). C'est d'ailleurs ce que l'on souhaite
dans la plupart des cas. Il est cependant possible de ne restreindre
l'accès que pour certaines méthodes, tout en laissant les autres
méthodes sans protection, en plaçant les directives dans une section
La directive Apache env
, ip
,
host
et all
. D'autres types d'autorisation
sont aussi disponibles, mais nécessitent le chargement des modules
d'autorisation appropriés.
Ces fournisseurs d'autorisation permettent de déterminer quels hôtes peuvent accéder à une zone du serveur. On peut contrôler l'accès en fonction du nom d'hôte, de l'adresse IP, d'un intervalle d'adresses IP, ou d'autres caractéristiques de la requête client enregistrées dans des variables d'environnement.
Le fournisseur env
permet de contrôler l'accès au
serveur en fonction de l'existence d'une variable d'environnement. Lorsque
Require env env-var
est spécifié, la
requête est autorisée si la variable d'environnement
env-var existe. Le serveur fournit la possibilité
de définir des variables d'environnement avec une grande souplesse
en fonction des caractéristiques de la requête client à l'aide des
directives fournies par le module User-Agent
(type de
navigateur), Referer
, etc...
Dans cet exemple, les navigateurs dont la chaîne de description
de l'en-tête user-agent commence par KnockKnock/2.0
se
verront accorder l'accès, alors que tous les autres se le verront
refuser.
Le fournisseur ip
permet de contrôler l'accès au
serveur en fonction de l'adresse IP du client distant. Lorsque
Require ip adresse-ip
est spécifié, la
requête est autorisée si l'adresse IP du client distant correspond
à
Une adresse IP complète :
L'adresse IP d'un hôte pour qui l'accès est accordé
Une adresse IP partielle :
Les 1 à 3 premiers octets d'une adresse IP, pour une restriction à un sous-réseau.
Une paire réseau/masque de sous-réseau :
Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z. pour une restriction de sous-réseau plus fine.
Une spécification CIDR réseau/nnn :
Identique au cas précédent, excepté que le masque de sous-réseau représente les nnn premiers bits de poids fort.
Notez que les trois derniers exemples correspondent exectement au même ensemble d'hôtes.
On peut spécifier des adresses et des sous-réseaux IPv6 comme suit :
Le fournisseur host
permet de contrôler l'accès au
serveur en fonction du nom d'hôte du client distant. Lorsque
Require host nom-hôte
est spécifié, la
requête est autorisée si le nom d'hôte correspond à
Un nom de domaine (éventuellement partiel)
Les hôtes dont les noms correspondent ou se terminent par la
chaîne spécifiée se voient accorder l'accès. Seuls les élément de
nom de domaine complets sont mis en correspondance ; ainsi,
l'exemple ci-dessus correspondra à foo.apache.org
, mais
ne correspondra pas à fooapache.org
. Avec cette
configuration, Apache va effectuer une double recherche DNS sur
l'adresse IP du client, sans tenir compte de la définition de la
directive
Le fournisseur all
imite la fonctionnalité
précédemment fournie par les directives 'Allow from all' et 'Deny
from all'. Le fournisseur accepte un des deux arguments 'granted' ou
'denied'. Dans les exemples suivants, le premier
accorde l'accès à toutes les requêtes, alors que le second le
refuse.