From 15c4eb2d4017d1152b4af5c6b609ac3d0ba84386 Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Wed, 29 Dec 2010 15:43:54 +0000 Subject: Updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1053655 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/env.xml.fr | 42 +++- docs/manual/howto/cgi.xml.fr | 22 +- docs/manual/mod/core.xml.fr | 181 +++++----------- docs/manual/mod/mod_headers.xml | 2 +- docs/manual/mod/mod_headers.xml.fr | 52 +++-- docs/manual/new_features_2_4.xml.fr | 15 +- docs/manual/vhosts/details.xml.fr | 399 +++++++++++++---------------------- docs/manual/vhosts/examples.xml.fr | 53 ++--- docs/manual/vhosts/index.xml.fr | 3 +- docs/manual/vhosts/name-based.xml.fr | 83 +++----- 10 files changed, 346 insertions(+), 506 deletions(-) (limited to 'docs/manual') diff --git a/docs/manual/env.xml.fr b/docs/manual/env.xml.fr index 5508ca3833..ceaa626c41 100644 --- a/docs/manual/env.xml.fr +++ b/docs/manual/env.xml.fr @@ -1,7 +1,7 @@ - + @@ -151,6 +151,15 @@ seront remplacés par un caractère "sousligné" quand ils seront transmis aux scripts CGI et aux pages SSI. +
  • Les contenus d'en-têtes HTTP transmis aux scripts de type + CGI ou autre via des variables d'environnement constituent un + cas particulier (voir plus loin). Leur nom est converti en + majuscules et seuls les tirets sont remplacés par des + caractères '_' ("souligné") ; si le format du nom de l'en-tête + n'est pas valide, celui-ci est ignoré. Voir plus loin pour une solution de + contournement du problème.
    • +
  • La directive SetEnv s'exécute assez tard au cours du traitement de la requête, ce qui signifie que des @@ -449,6 +458,37 @@
    Exemples +
    + Transmission du contenu d'en-têtes non valides aux scripts + CGI + +

    Avec la version 2.4, Apache est plus strict avec la conversion + des en-têtes HTTP en variables d'environnement dans + mod_cgi et d'autres modules : dans les versions + précédentes, tout caractère invalide dans les noms d'en-têtes + était tout simplement remplacé par un caractère '_', ce qui + pouvait exposer à des attaques de type cross-site-scripting via + injection d'en-têtes (voir Bogues + du Web inhabituelles, planche 19/20).

    + +

    Si vous devez supporter un client qui envoie des en-têtes non + conformes et si ceux-ci ne peuvent pas être corrigés, il existe + une solution de contournement simple mettant en jeu les modules + mod_setenvif et mod_header, + et permettant de prendre en compte ces en-têtes :

    + +
    +# 
+# L'exemple suivant montre comment prendre en compte un en-tête
+# Accept_Encoding non conforme envoyé par un client.
+#
+SetEnvIfNoCase ^Accept.Encoding$ ^(.*)$ fix_accept_encoding=$1
+RequestHeader set Accept-Encoding %{fix_accept_encoding}e env=fix_accept_encoding
+
     + +
    +
    Modification du comportement protocolaire face à des clients réagissant de manière non conforme diff --git a/docs/manual/howto/cgi.xml.fr b/docs/manual/howto/cgi.xml.fr index f78b069c36..38b9e26466 100644 --- a/docs/manual/howto/cgi.xml.fr +++ b/docs/manual/howto/cgi.xml.fr @@ -1,7 +1,7 @@ - + @@ -381,10 +381,6 @@

    Assurez-vous qu'il s'agit bien du chemin correct vers l'interpréteur.

    -

    De plus, si votre programme CGI dépend d'autres variables d'environnement, vous devrez vous - assurer qu'elles lui sont bien transmises par Apache.

    - Lors de l'édition de scripts CGI sous Windows, il se peut que des caractères de fin de ligne soient ajoutés au chemin de @@ -395,6 +391,22 @@ faisant partie du nom de fichier de l'interpréteur. +
    + +
    + Variables d'environnement manquantes + +

    Si votre programme CGI dépend de variables + d'environnement non standards, vous devrez vous assurez que + ces variables lui sont bien transmises par Apache.

    + +

    Lorsque des en-têtes HTTP ne sont pas transmis à + l'environnement, assurez-vous qu'ils sont bien formatés selon la + RFC 2616, section + 4.2 : les noms d'en-têtes doivent commencer par une lettre, + elle-même suivie de lettres, chiffres ou traits d'union. Tout + en-tête dont le nom viole cette règle sera ignoré.

    +
    diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr index d09db31a1b..2546a38070 100644 --- a/docs/manual/mod/core.xml.fr +++ b/docs/manual/mod/core.xml.fr @@ -1,7 +1,7 @@ - + @@ -677,7 +677,7 @@ host </Directory>

    - <Directory /home/>
    + <Directory /home>
    AllowOverride FileInfo
     @@ -2091,11 +2091,9 @@ possible depuis les versions 2.3.2 et supérieures d'Apache httpd -

    Dans un contexte de serveur virtuel à base de nom, c'est le délai - du premier serveur virtuel défini (le serveur par défaut) parmi un - ensemble de directives NameVirtualHost qui sera utilisé. Les - autres valeurs seront ignorées.

    +

    Dans un contexte de serveur virtuel à base de nom, c'est + la valeur de la paire adresse IP/port du serveur virtuel qui + correspond le mieux qui sera utilisée.

    @@ -2363,8 +2361,7 @@ requête HTTP Avertissement

    Dans le cas des serveurs virtuels à base de noms, la valeur de cette directive est extraite du serveur virtuel par défaut (le - premier de la liste) pour lequel la connexion correspondait à la - directive NameVirtualHost.

    + premier de la liste) pour la paire adresse IP/port.

     @@ -2410,10 +2407,9 @@ requête HTTP Avertissement

    Dans le cas des serveurs virtuels à base de noms, la valeur de cette directive est extraite du serveur virtuel par défaut (le - premier de la liste) pour lequel la connexion correspondait à la - directive NameVirtualHost.

    + premier de la liste) pour lequel la paire adresse IP/port + correspond le mieux.

     - @@ -2457,8 +2453,8 @@ HTTP Avertissement

    Dans le cas des serveurs virtuels à base de noms, la valeur de cette directive est extraite du serveur virtuel par défaut (le - premier de la liste) pour lequel la connexion correspondait à la - directive NameVirtualHost.

    + premier de la liste) pour lequel la paire adresse IP/port + correspond le mieux.

     @@ -3083,7 +3079,7 @@ verrou pour tous les mutex ou seulement les mutex spécifiés/var/httpd/locks/mpm-accept.12345.

    Sécurité -

    Il est déconseillé d'éviter de placer les fichiers mutex +

    Il est conseillé d'éviter de placer les fichiers mutex dans un répertoire où tout le monde peut écrire comme /var/tmp, car quelqu'un pourrait initier une attaque par déni de service et empêcher le serveur de démarrer en créant un @@ -3175,86 +3171,15 @@ nom -

    Une seule directive NameVirtualHost permet -d'identifier un ensemble de serveurs virtuels identiques que le serveur -va sélectionner en fonction du nom d'hôte spécifié par le -client. La directive NameVirtualHost est -obligatoire si vous souhaitez configurer des serveurs virtuels à base de nom.

    - -

    Cette directive, ainsi que les directives VirtualHost correspondantes, doit comporter un -numéro de port si le serveur supporte les connexions HTTP et HTTPS.

    - -

    Bien que adresse puisse contenir un nom d'hôte, il est -recommandé d'utiliser plutôt une adresse IP ou un nom d'hôte avec -caractères génériques. Une directive NameVirtualHost contenant des -caractères génériques ne peut correspondre qu'à des serveurs virtuels -qui contiennent aussi des caractères génériques dans leur argument.

    - -

    Dans les cas où un pare-feu ou autre mandataire reçoit les requêtes -et les redirige sous une adresse IP différente vers le serveur, vous -devez spécifier l'adresse IP de l'interface physique de la machine qui -va servir les requêtes.

    - -

    Dans l'exemple ci-dessous, les requêtes reçues sur l'interface -192.0.2.1 et le port 80 ne vont déclencher une sélection que parmi les -deux premiers serveurs virtuels. Les requêtes reçues sur le port 80 et -sur toute interface ne vont déclencher une sélection que parmi les -troisième et quatrième serveurs virtuels. D'une manière générale, -lorsque l'interface ne constitue pas un critère important de sélection, -la valeur "*:80" suffit pour les directives NameVirtualHost et -VirtualHost.

    - - - NameVirtualHost 192.0.2.1:80
    - NameVirtualHost *:80

    - - <VirtualHost 192.0.2.1:80>
    -   ServerName namebased-a.example.com
    - </VirtualHost>
    -
    - <VirtualHost 192.0.2.1:80>
    -   Servername namebased-b.example.com
    - </VirtualHost>
    -
    - <VirtualHost *:80>
    -   ServerName namebased-c.example.com
    - </VirtualHost>
    -
    - <VirtualHost *:80>
    -   ServerName namebased-d.example.com
    - </VirtualHost>
    -
    - -     - -

    Si aucun serveur virtuel ne correspond, c'est le premier serveur - virtuel correspondant à l'adresse IP qui sera utilisé.

    - -

    Les adresses IPv6 doivent être entourées de crochets, comme dans - l'exemple suivant :

    - - - NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080 - - - - - Argument de la directive <directive - type="section">VirtualHost</directive> -

    Notez que l'argument de la directive VirtualHost doit être identique à - l'argument de la directive NameVirtualHost.

    - - - NameVirtualHost 192.0.2.2:80
    - <VirtualHost 192.0.2.2:80>
    - # ...
    - </VirtualHost>
    -     -     +

    Avant la version 2.3.11, il était nécessaire de définir une + directive NameVirtualHost pour indiquer au + serveur qu'une paire adresse IP/port particulière pouvait être + utilisée comme serveur virtuel à base de nom. Depuis la version + 2.3.11, chaque fois qu'une paire adresse IP/port est utilisée dans + plusieurs serveurs virtuels, l'hébergement virtuel à base de nom est + automatiquement activé pour cette adresse.

    + +

    Cette directive n'a actuellement plus aucun effet.

    Documentation sur les serveurs @@ -3387,11 +3312,12 @@ host - est supprimée de la liste des options courantes de la même manière.

    - Avertissement + Note

    Mélanger des Options avec + ou - avec des Options sans + ou - constitue une erreur de syntaxe, et - peut résulter en des comportements inattendus.

    + la vérification de la syntaxe au cours du démarrage du serveur fera + échouer ce dernier.

    Par exemple, sans aucun symbole + et - @@ -3869,7 +3795,6 @@ le serveur HTTP Apache du serveur HTTP Apache UseCanonicalName UseCanonicalPhysicalPort -NameVirtualHost ServerAlias @@ -4382,7 +4307,8 @@ d'hôte spécifique ou à une adresse IP pour un document hébergé par un serveur virtuel particulier, il applique les directives de configuration rassemblées dans la section VirtualHost. adresse - IP peut être :

    + IP peut être une des entités suivantes, éventuellement suivies + d'un caractère ':' et d'un numéro de port (ou *) :

    • L'adresse IP du serveur virtuel ;
      • @@ -4390,18 +4316,16 @@ d'hôte spécifique ou à une adresse IP
    • Un nom de domaine entièrement qualifié correspondant à l'adresse IP du serveur virtuel (non recommandé) ;
      • -
    • Le caractère *, qui n'est utilisé qu'en - combinaison avec NameVirtualHost * pour intercepter - toutes les adresses IP ; ou
      • +
    • Le caractère *, qui agit comme un + caractère générique, et correspond à toute adresse IP.
      • + +
    • La chaîne _default_, dont la signification est + identique à celle du caractère *
      • -
    • La chaîne de caractères _default_, qui n'est - utilisée qu'avec l'hébergement virtuel à base d'adresse IP pour - intercepter les adresses IP qui ne correspondent à aucun serveur - virtuel.
    Exemple - <VirtualHost 10.1.2.3>
    + <VirtualHost 10.1.2.3:80>
    ServerAdmin webmaster@host.example.com
    DocumentRoot /www/docs/host.example.com
    @@ -4419,7 +4343,7 @@ d'hôte spécifique ou à une adresse IP :

    - <VirtualHost [2001:db8::a00:20ff:fea7:ccea]>
    + <VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80>
    ServerAdmin webmaster@host.example.com
    DocumentRoot /www/docs/host.example.com
    @@ -4445,25 +4369,7 @@ d'hôte spécifique ou à une adresse IP dans la liste des adresses précisées par la directive Listen.

     - -

    Avec l'hébergement virtuel à base d'adresse IP, on peut utiliser - le nom spécial _default_, auquel cas le serveur virtuel - considéré interceptera toute adresse IP qui n'est pas explicitement - associée à un autre serveur virtuel. En l'absence de serveur virtuel - associé à _default_, et si l'adresse IP demandée ne - correspond à aucun serveur virtuel, c'est la configuration du - serveur "principal" qui sera utilisée, c'est à dire l'ensemble des - définitions situées en dehors de toute section VirtualHost.

    - -

    Vous pouvez spécifier :port pour modifier le port du - serveur virtuel. S'il n'est pas spécifié, sa valeur par défaut - correspond à celle qui est définie par la dernière directive - Listen du serveur - principal. Vous pouvez aussi spécifier :* pour accepter - tous les ports associés à l'adresse du serveur virtuel (c'est une - configuration recommandée lorsqu'on utilise - _default_).

    - +

    Tout bloc VirtualHost doit comporter une directive ServerName. Dans le cas @@ -4471,10 +4377,23 @@ d'hôte spécifique ou à une adresse IP ServerName issue de la configuration du serveur principal.

    -

    Si aucun serveur virtuel ne correspond, c'est le premier serveur - virtuel correspondant à l'adresse IP qui sera utilisé. Par - conséquent, le premier serveur virtuel défini est le serveur virtuel - par défaut.

    +

    A l'arrivée d'une requête, le serveur tente de la + faire prendre en compte par la section VirtualHost qui correspond le mieux en ne + se basant que sur la paire adresse IP/port. Les chaînes sans + caractères génériques l'emportent sur celles qui en contiennent. Si + aucune correspondance du point de vue de l'adresse IP/port n'est + trouvée, c'est la configuration du serveur "principal" qui sera + utilisée.

    + +

    Si plusieurs serveurs virtuels correspondent du point de vue de + l'adresse IP/port, le serveur sélectionne celui qui correspond le + mieux du point de vue du nom d'hôte de la requête. Si aucune + correspondance du point de vue du nom d'hôte n'est trouvée, c'est le + premier serveur virtuel dont l'adresse IP/port correspond qui sera + utilisé. Par voie de conséquence, le premier serveur virtuel + comportant une certaine paire adresse IP/port est le serveur virtuel + par défaut pour cette paire adresse IP/port.

    Sécurité

    Voir le document sur les header [value] [early|env=[!]variable] server configvirtual host directory.htaccess -Default condition was temporarily changed to "always" in 2.3.9 and 2.3.10 FileInfo +Default condition was temporarily changed to "always" in 2.3.9 and 2.3.10

    This directive can replace, merge or remove HTTP response diff --git a/docs/manual/mod/mod_headers.xml.fr b/docs/manual/mod/mod_headers.xml.fr index 12815f928c..675b13f2af 100644 --- a/docs/manual/mod/mod_headers.xml.fr +++ b/docs/manual/mod/mod_headers.xml.fr @@ -1,7 +1,7 @@ - + @@ -328,8 +328,8 @@ tardif server configvirtual host directory.htaccess FileInfo -La condition par défaut passe de "onsuccess" à "always" à -partir de la version 2.3.9 +La condition par défaut est temporairement passée +à "always" dans les version 2.3.9 et 2.3.10

    Cette directive permet de remplacer, fusionner, ou @@ -338,20 +338,38 @@ partir de la version 2.3.9 s'exécutent, ce qui permet la modification des en-têtes sortants.

    -

    A partir de la version 2.3.9, la condition par défaut est - "always", ce qui implique que cette directive agit sans tenir compte - du code d'état de la réponse. Dans les versions 2.3.8 et - antérieures, "onsuccess" était la condition par défaut, ce qui - impliquait que les en-têtes n'étaient modifiés que pour les réponses - avec code d'état 2xx.

    - -

    Une valeur effective always peut être nécessaire - pour forcer la définition des en-têtes par certains modules internes - (tels que mod_cgi), même dans le cas de réponses - positives, et doit toujours être présente pour modifier les réponses avec un code - d'état autre que 2xx, comme les redirections - ou les erreurs clients.

    - +

    L'argument optionnel condition permet de déterminer + sur quelle table interne d'en-têtes de réponses cette directive va + opérer. D'autres composants du serveur peuvent avoir stocké leurs + en-têtes de réponses dans la table correspondant à + onsuccess ou dans celle correspondant à + always. Dans ce contexte, "Always" fait référence au + choix d'envoyer les en-têtes que vous ajoutez aux réponses, qu'elle + soient avec succès ou échouées ; par contre, si votre action est une + fonction d'un en-tête existant, vous devrez lire la documentation de + manière plus approfondie car dans ce cas, les choses se compliquent.

    + +

    Vous pouvez avoir à changer la valeur par défaut + onsuccess en always dans des circonstances + similaires à celles exposées plus loin. Notez aussi que la répétition + de cette directive avec les deux conditions peut être pertinente + dans certains scénarios, car always n'englobe pas + onsuccess en ce qui concerne les en-têtes existants :

    + +
      +
    • Vous ajoutez un en-tête à une réponse échouée (non-2xx), + une redirection par exemple, et dans ce cas, seule la table + correspondant à always est utilisée dans la réponse + définitive.
      • +
    • Vous modifiez ou supprimez un en-tête généré par un script + CGI, et dans ce cas, les scripts CGI sont dans la table + correspondant à always et non dans la table par + défaut.
      • +
    • Vous modifiez ou supprimez un en-tête généré par tel ou tel + composant du serveur, mais cet en-tête n'est pas trouvé par la + condition par défaut onsuccess.
      • +
    +

    L'action que cette directive provoque est déterminée par le premier argument (ou par le second argument si une condition est spécifiée). Il peut prendre diff --git a/docs/manual/new_features_2_4.xml.fr b/docs/manual/new_features_2_4.xml.fr index 7688bf6b8e..0d70c283d4 100644 --- a/docs/manual/new_features_2_4.xml.fr +++ b/docs/manual/new_features_2_4.xml.fr @@ -3,7 +3,7 @@ - + + @@ -28,160 +28,95 @@

    -

    Le code gérant les serveurs virtuels a été réécrit à partir de - zéro dans Apache 1.3. Ce document vise à expliquer - dans le détail comment Apache procède lors du choix de l'utilisation - d'un serveur virtuel en fonction d'une requête reçue. L'apparition - de la directive NameVirtualHost - a rendu beaucoup plus facile et plus sûre la configuration des - serveurs virtuels par rapport aux versions précédant la 1.3.

    +

    Ce document vise à expliquer dans le détail comment le serveur + HTTP Apache procède lors du choix de l'utilisation + d'un serveur virtuel en fonction d'une requête reçue.

    -

    Si vous voulez juste que ça marche sans en - comprendre le fonctionnement, voici quelques - exemples.

    +

    Il est recommandé de lire la documentation + Serveurs virtuels à base de nom et serveurs virtuels à base + d'adresse IP pour déterminer quel type de serveur virtuel nous + convient le mieux, puis de lire les documentations serveurs virtuels à base de nom ou serveurs virtuels à base d'adresse IP, et enfin + d'étudier quelques exemples.

    + +

    Si vous voulez entrer dans les détails, vous pouvez revenir vers + cette page.

     -
    Interprétation des fichiers -de configuration +Support des serveurs virtuels à base +d'adresse IP +Support des serveurs virtuels à base +de nom +Exemples de serveurs virtuels pour une +configuration courante +Hébergement virtuel de masse configuré +dynamiquement + + +
    Fichier de configuration

    Un serveur principal (main_server) contient toutes les définitions qui apparaissent en dehors des sections - <VirtualHost>. Les serveurs virtuels, aussi + <VirtualHost>.

    + +

    Les serveurs virtuels, aussi appelés vhosts (pour virtual hosts), sont définis par les sections VirtualHost.

    -

    Les directives - Listen, - ServerName, - ServerPath, - et ServerAlias - peuvent être placées n'importe où dans le cadre de définition d'un - serveur. Cependant, chaque fois que l'une d'elles est lue, elle écrase - ses instances précédentes (dans le contexte du même serveur).

    - -

    La valeur par défaut du champ Listen pour le serveur - principal est de 80. Le serveur principal n'a pas de valeur par - défaut pour ServerPath ni pour ServerAlias. - La valeur par défaut de ServerName est déduite à partir - de l'adresses IP du serveur.

    - -

    La directive Listen associée au serveur principal a deux utilités. - La première détermine le port réseau sur lequel Apache va écouter. - La deuxième spécifie le port qui sera utilisé dans les URIs absolus - lors des redirections.

    - -

    À la différence du serveur principal, les ports des serveurs - virtuels n'affectent pas les ports sur lesquels - Apache se met à l'écoute.

    - -

    Chaque adresse incluse dans une directive VirtualHost - peut disposer d'un port optionnel. Si le port n'est pas précisé, il - prend par défaut la dernière valeur de Listen lue dans - la configuration du serveur principal. Le port particulier - * représente un joker qui correspond à tous les ports. - L'ensemble des adresses (y compris les résultats multiples +

    Chaque directive VirtualHost comporte une ou + plusieurs adresses et des ports optionnels.

    + +

    Il est possible d'utiliser des noms d'hôtes dans la définition + d'un serveur virtuel, mais ils seront résolus en adresses IP au + démarrage du serveur, et si une résolution de nom échoue, cette + définition de serveur virtuel sera ignorée. Cette méthode est par + conséquent déconseillée.

    + +

    L'adresse peut + être spécifiée sous la forme *, ce qui conviendra à la + requête si aucun autre serveur virtuel ne possède l'adresse IP + explicite correspondant à celle de la requête.

    + +

    L'adresse qui apparaît dans la directive VirtualHost + peut être associée à un port optionnel. Si aucun port n'est + spécifié, il s'agit d'un port générique qui peut aussi être spécifié + comme *. Le port générique correspond à toutes les + valeurs de port.

    + +

    (Il ne faut pas confondre les numéros de port sur lesquels Apache + est en écoute avec les numéros de port spécifiés dans la directive + VirtualHost ; ces derniers ne servent qu'à définir le + serveur virtuel qui sera sélectionné pour traiter la + requête. Pour définir les ports sur lesquels Apache est en écoute, + utilisez la directive Listen). +

    + +

    L'ensemble des adresses (y compris les résultats multiples A issus des requêtes DNS) est appelé jeu d'adresses du serveur virtuel.

    -

    À moins qu'une directive - NameVirtualHost ne soit utilisée - pour une adresse IP spécifique, le premier serveur virtuel avec - cette adresse est considéré comme un serveur virtuel par-IP. - L'adresse IP peut également prendre la valeur joker *.

    - -

    Dans les cas où l'on souhaite utiliser un serveur virtuel - par nom, la directive NameVirtualHost doit - apparaître avec l'adresse IP choisie. En d'autres termes, vous devez - spécifier dans votre fichier de configuration l'adresse IP des noms - de domaine (CNAME) de vos serveurs virtuels par nom au moyen de - la directive NameVirtualHost.

    - -

    On peut utiliser plusieurs directives NameVirtualHost - pour un groupe de directives VirtualHost, mais seule - une directive NameVirtualHost doit être utilisée pour - chaque couple IP:port donné.

    - -

    L'ordre d'apparition des directives NameVirtualHost - et VirtualHost est sans importance, ce qui fait que - les deux exemples suivants ont des effets identiques (seul l'ordre - des directives VirtualHost pour un jeu - d'adresses est important, voir ci-dessous) :

    - - - - -
    - NameVirtualHost 111.22.33.44
    - <VirtualHost 111.22.33.44>
    - # serveur A
    - ...
    - </VirtualHost>
    - <VirtualHost 111.22.33.44>
    - # serveur B
    - ...
    - </VirtualHost>
    -
    - NameVirtualHost 111.22.33.55
    - <VirtualHost 111.22.33.55>
    - # serveur C
    - ...
    - </VirtualHost>
    - <VirtualHost 111.22.33.55>
    - # serveur D
    - ...
    - </VirtualHost> -    		 - <VirtualHost 111.22.33.44>
    - # serveur A
    - </VirtualHost>
    - <VirtualHost 111.22.33.55>
    - # serveur C
    - ...
    - </VirtualHost>
    - <VirtualHost 111.22.33.44>
    - # serveur B
    - ...
    - </VirtualHost>
    - <VirtualHost 111.22.33.55>
    - # serveur D
    - ...
    - </VirtualHost>
    -
    - NameVirtualHost 111.22.33.44
    - NameVirtualHost 111.22.33.55
    -
    -
    - - -

    (Il est conseillé d'adopter le choix de gauche pour faciliter - la lisibilité des fichiers de configuration.)

    - -

    Après la lecture de la directive VirtualHost, le - serveur virtuel se voit attribuer une valeur Listen - par défaut qui est la valeur du port associé au premier nom spécifié - dans sa directive VirtualHost.

    - -

    La liste complète des noms d'une directive VirtualHost - est gérée exactement comme des ServerAlias (mais ne - sont pas écrasés par d'autres ServerAlias) si tous - les noms sont résolus dans ce jeu d'adresse. À noter que les états - Listen de ce serveur virtuel sont sans incidence sur - les ports attibués au jeu d'adresses.

    - -

    Pendant la phase d'initialisation, une liste de chaque adresse - IP est générée et introduite dans une table de 'hash'. Si une - adresse IP est utilisée dans une directive NameVirtualHost, - cette liste contient les noms des serveurs virtuels pour cette - adresse. Si aucun serveur virtuel n'est défini pour cette adresse, - la directive NameVirtualHost est ignorée et un message - est envoyé au journal d'erreurs. Quand un serveur virtuel par IP - est utilisé, la table de 'hash' reste vide.

    - -

    La fonction de 'hash' étant rapide, le temps d'exécution d'un - 'hash' sur une adresse IP lors d'une requête est minimale et - quasiment imperceptible. De plus, la table est optimisée pour les - adresses IP dont le dernier octet est le seul à changer.

    +

    Apache fait automatiquement sa sélection à partir de l'en-tête + HTTP Host fourni par le client, lorsque la + correspondance la plus exacte du point de vue adresse IP/port a lieu + pour plusieurs serveurs virtuels.

    + +

    La directive ServerName peut + apparaître en quelque endroit de la définition d'un serveur. + Cependant, chaque occurrence écrase la précédente (pour ce serveur). + Si aucune directive ServerName n'est spécifiée, le + serveur tente de déterminer le nom du serveur à partir de l'adresse + IP.

    + +

    Le premier serveur virtuel à base de nom apparaissant dans le + fichier de configuration pour une paire IP:port donnée est + significatif car c'est lui qui sera utilisé pour toutes les requêtes + reçues sur cette adresse IP/port et pour laquelle aucun autre + serveur virtuel ne possède un ServerName ou un ServerAlias + correspondant. Il sera aussi utilisé pour toutes les connexions SSL + si le serveur ne supporte pas l'Indication du nom du serveur.

    Pour chaque serveur virtuel, diverses valeurs sont initialisées par défaut. En particulier :

    @@ -242,79 +177,72 @@ de configuration

    À la réception d'une requête, le serveur procède comme suit pour déterminer quel serveur virtuel utiliser :

    -
    Vérification dans la table de hash +
    Recherche de l'adresse IP -

    Après que le client se soit connecté, l'adresse - IP à laquelle le client s'est connecté est recherchée dans la - table de hash IP interne.

    +

    Lors d'une première connexion sur une adresse/port, le serveur + recherche toutes les directives VirtualHost qui + possèdent la même adresse IP/port.

    -

    Si la résolution de l'adresse IP n'aboutit pas (adresse IP non - trouvée), la requête est servie par le serveur virtuel - _default_ s'il est défini pour le port correspondant - à la requête. Sinon, elle est servie par le serveur principal.

    +

    S'il n'y a aucune correspondance exacte pour cette adresse/port, + la recherche s'effectue sur la valeur générique (*).

    -

    Si l'adresse IP n'est pas trouvée dans la table de hash, la - recherche du numéro de port peut aussi se terminer par une - correspondance à un NameVirtualHost * qui est géré - ensuite comme les autres serveurs virtuels par noms.

    - -

    Si une liste est bien trouvée dans la table pour l'adresse - IP recherchée, l'étape suivante est de déterminer s'il s'agit - d'un serveur virtuel par nom ou par IP.

    +

    Si aucune correspondance n'est enfin trouvée, la requête sera + servie par le serveur principal.

    +

    S'il existe des définitions VirtualHost pour + l'adresse IP, l'étape suivante consiste à déterminer si nous avons à + faire à un serveur virtuel à base de nom ou d'adresse IP.

    +
    Serveur virtuel par IP -

    Si l'entrée trouvée dispose d'une liste de noms vide, c'est - qu'il s'agit d'un serveur virtuel par IP, et aucun autre choix - n'est plus à faire ; la requête est servie par ce serveur virtuel.

    +

    Si une seule section VirtualHost présente la + meilleure correspondance avec la paire adresse IP/port, aucune + action n'est entreprise et la requête est + traitée par le serveur virtuel qui correspond.

    Serveur virtuel par nom -

    Si l'entrée trouvée correspond à un serveur virtuel par nom, - la liste de noms contient au moins une structure de serveurs - virtuels. Les serveurs virtuels se présentent dans cette liste - dans le même ordre que la lecture des directives VirtualHost - dans le fichier de configuration.

    - -

    Le premier serveur virtuel de cette liste (donc, le premier - serveur virtuel du fichier de configuration - attribué à l'adresse IP spécifiée) - se voit attribuer la plus grande priorité, ce - qui signifie que c'est lui qui traite les requêtes présentant un - nom de serveur invalide ou ne présentant pas de champ - Host: dans l'en-tête.

    - -

    Si un champ Host: est transmis dans l'en-tête de - la requête, son occurrence est recherchée dans la liste et le - premier serveur virtuel qui présente un ServerName - ou un ServerAlias correspondant est choisi pour - servir la requête. Il est possible que le champ Host: - contienne un numéro de port, mais Apache utilise toujours le +

    Si plusieurs sections VirtualHost présentent la + meilleure correspondance avec la paire adresse IP/port, le terme + "liste" dans les étapes suivantes fait référence à la liste des + serveurs virtuels qui correspondent, selon l'ordre dans lequel ils + apparaissent dans le fichier de configuration.

    + +

    Si la connexion utilise SSL, si le serveur supporte l'Indication de nom de serveur, + et si la négociation du client SSL inclut l'extension TLS dans le + nom d'hôte requis, alors ce nom d'hôte sera utilisé par la suite, tout + comme un en-tête Host: aurait été utilisé dans le cas + d'une connexion non-SSL. Si ces conditions ne sont pas réunies, le + premier serveur virtuel à base de nom dont l'adresse correspond sera + utilisé pour les connexions SSL. Ceci est important car c'est le + serveur virtuel qui détermine quel certificat le serveur va utiliser + pour la connexion.

    + +

    Si la requête contient un en-tête Host:, on + recherche dans la liste le premier serveur virtuel dont le + ServerName ou le ServerAlias correspond, + et c'est celui-ci qui va traiter la requête. Un en-tête + Host: peut comporter un numéro de port mais Apache + l'ignore systématiquement et utilise toujours le port sur lequel il a effectivement reçu la requête.

    -

    Dans le cas où le client a envoyé une requête en HTTP/1.0 sans - champ d'en-tête Host:, il est impossible de - déterminer le serveur auquel le client veut se connecter ; l'URI - de la requête est recherché dans tous les ServerPath - existants. Le premier chemin trouvé est utilisé et la requête est - servie par le serveur virtuel correspondant.

    - -

    Si aucun serveur virtuel n'est trouvé, la requête est servie - par le premier serveur virtuel qui écoute sur le port demandé et - qui est sur la liste associée à l'adresse IP vers laquelle la - requête a été envoyée (comme déjà précisé ci-avant).

    +

    Le premier serveur virtuel du fichier de configuration qui + possède l'adresse spécifiée est prioritaire et intercepte toutes les + requêtes à destination d'un nom de serveur inconnu, ou toute requête + sans en-tête Host: (comme les requêtes HTTP/1.0).

    Connexions persistantes -

    La recherche par adresse IP décrite ci-avant n'est faite +

    La recherche par adresse IP décrite ci-avant n'est faite qu'une fois pour chaque session TCP/IP, alors que la - recherche par nom est réalisée pour chaque requête au + recherche par nom est réalisée pour chaque requête au cours d'une connexion persistante (KeepAlive). En d'autres termes, il est possible pour un client de faire des requêtes sur différents serveurs virtuels par nom, au cours d'une unique @@ -337,72 +265,43 @@ de configuration

    Observations
      -
    • Les serveurs virtuels par nom et par IP n'interfèrent - jamais entre eux. Les serveurs virtuels par IP ne sont joignables - qu'au travers de leur(s) adresse(s) IP propre(s), et en aucun - cas par une autre adresse. Les serveurs virtuels par nom - ne sont accessibles que par leur(s) adresse(s) IP qui ne peuvent - être définies qu'au moyen de la directive - NameVirtualHost.
      • - -
    • Les vérifications sur ServerAlias et - ServerPath ne sont jamais réalisées pour les - serveurs virtuels par IP.
      • - -
    • L'ordre dans lequel sont agencés dans le fichier de - configuration le serveur virtuel _default_, les - serveurs virtuels par nom et par IP, et la directive - NameVirtualHost est sans incidence sur le - fonctionnement. Seul l'ordre des serveurs virtuels par nom +
    • La sélection d'un serveur virtuel en fonction de son nom est + un processus qui intervient après la sélection par le serveur du + serveur virtuel qui correspond le mieux du point de vue adresse + IP/port.
      • + +
    • Si vous ne tenez pas compte de l'adresse IP à laquelle le + client s'est connecté, indiquez un caractère "*" comme adresse + pour tous les serveurs virtuels, et la sélection du serveur + virtuel en fonction du nom s'appliquera alors à tous les serveurs + virtuels définis.
      • + +
    • Les vérifications sur ServerName et + ServerAlias ne sont jamais + réalisées pour les serveurs virtuels par IP.
      • + +
    • Seul l'ordre des serveurs virtuels par nom pour une adresse donnée a une importance. Le serveur virtuel par nom qui est présent en premier dans la configuration se voit attribué la priorité la plus haute pour les requêtes arrivant sur son jeu d'adresses IP.
      • -
    • Pour des raisons de sécurité, le numéro de port présenté - dans le champ d'en-tête Host: n'est jamais utilisé +
    • Le numéro de port contenu dans l'en-tête Host: n'est jamais utilisé pour les tests de correspondances. Apache ne prend en compte que le numéro de port sur lequel le client a envoyé la requête.
      • -
    • Si une directive ServerPath existe, et se - trouve être préfixe d'une autre directive ServerPath - qui apparaît plus loin dans la configuration, la première - sera toujours utilisée et la deuxième jamais. (Ceci ne se - produit que dans le cas où aucun champ Host: - n'a été présenté par le client pour distinguer les deux.)
      • - -
    • Dans le cas où deux serveurs virtuels par IP ont une - adresse en commun, le serveur virtuel qui apparaît en premier - dans la configuration est toujours choisi. Ce genre de chose - peut arriver par inadvertance. Le serveur envoie une alerte - dans le journal d'erreurs si ce cas se présente.
      • - -
    • Le serveur virtuel _default_ ne sert la requête - que si aucun autre serveur virtuel travaillant sur l'adresse - IP et le port demandés n'est trouvé. La requête n'est - traitée que si le numéro de port qui a reçu la requête est - associé au serveur virtuel _default_ (qui par - défaut, correspond à Listen). Un port joker peut - être spécifié (comme dans _default_:*) - pour récupérer les requêtes sur tous les ports ouverts. Ceci - est également applicable aux serveurs virtuels - NameVirtualHost *.
      • +
    • Si deux serveurs virtuels partagent la même adresse, la + sélection se fera implicitement sur le nom. Il s'agit d'une + nouvelle fonctionnalité de la version 2.3.11.
    • Le serveur principal ne sert les requêtes que lorsque l'adresse IP et le port demandés par le client ne correspondent à aucun serveur virtuel (y compris un serveur - virtuel _default_). En d'autres termes, le serveur + virtuel *). En d'autres termes, le serveur principal n'est utile que pour les combinaisons adresse/port non spécifiées (sauf quand un serveur virtuel _default_ correspond au port).
      • -
    • Ni les serveurs virtuels _default_, ni le - serveur principal ne sont utilisés pour traiter une requête - avec un champ d'en-tête Host: inconnu ou manquant - lorsque l'adresse (et le port) de connexion correspondent à - des serveurs virtuels par nom, par exemple, dans une directive - NameVirtualHost.
      • -
    • Il ne faut jamais employer de noms DNS dans des directives VirtualHost, car cela oblige le serveur a s'appuyer sur le DNS au moment du démarrage. De plus, vous vous exposez @@ -435,17 +334,7 @@ de configuration virtuels peuvent impacter le fonctionnement de tous les serveurs virtuels.)
      • -
    • Toujours regrouper les définitions NameVirtualHost - et VirtualHost correspondantes - dans la configuration pour une meilleure lisibilité.
      • - -
    • Éviter les ServerPaths qui sont préfixes - d'autres ServerPaths. Si cela ne peut être évité, - veillez à ce que le serveur virtuel contenant le préfixe le plus - long (donc le plus précis) apparaisse dans le fichier de - configuration avant le plus court. (par exemple, - "ServerPath /abc" est à spécifier après "ServerPath /abc/def").
      • -
    +
    diff --git a/docs/manual/vhosts/examples.xml.fr b/docs/manual/vhosts/examples.xml.fr index 2a50fae2e0..0e8b1a3ad1 100644 --- a/docs/manual/vhosts/examples.xml.fr +++ b/docs/manual/vhosts/examples.xml.fr @@ -1,7 +1,7 @@ - + @@ -61,9 +61,6 @@ # Apache doit écouter sur le port 80
    Listen 80

    - # Toutes les adresses IP doivent répondre aux requêtes sur les - # serveurs virtuels - NameVirtualHost *:80

    <VirtualHost *:80>
    @@ -99,17 +96,10 @@ Note : -

    Si vous le souhaitez, vous pouvez remplacer * - par l'adresse IP du système. Dans ce cas, l'argument de - VirtualHost doit correspondre à - l'argument de NameVirtualHost :

    - - - NameVirtualHost 172.20.30.40
    -
    - <VirtualHost 172.20.30.40>
    - # etc ... -     +

    Vous pouvez remplacer * + par l'adresse IP du système si vous ne souhaitez pas faire + opérer la sélection du serveur virtuel en fonction de la + paire adresse IP/port.

    En général, il est commode d'utiliser * sur les systèmes dont l'adresse IP n'est pas constante - par @@ -152,9 +142,6 @@ ServerName server.example.com
    DocumentRoot /www/mainserver

    - # l'autre adresse
    - NameVirtualHost 172.20.30.50
    -
    <VirtualHost 172.20.30.50>
    DocumentRoot /www/example.com
    @@ -203,9 +190,7 @@ Configuration du serveur - NameVirtualHost 192.168.1.1
    - NameVirtualHost 172.20.30.40
    -
    +
    <VirtualHost 192.168.1.1 172.20.30.40>
    DocumentRoot /www/server1
    @@ -235,12 +220,10 @@ ports.

    Vous disposez de plusieurs domaines pointant sur la même adresse - IP et vous voulez également servir de multiples ports. Vous y - parviendrez en définissant les ports dans la directive - "NameVirtualHost". Si vous tentez d'utiliser <VirtualHost - name:port> sans directive NameVirtualHost name:port, ou tentez - d'utiliser la directive Listen, votre configuration ne fonctionnera - pas.

    + IP et vous voulez également servir de multiples ports. L'exemple + suivant montre que la sélection en fonction du nom intervient après + la sélection de la meilleure correspondance du point de vue adresse + IP/port.

    Configuration du serveur @@ -248,9 +231,6 @@ Listen 80
    Listen 8080

    - NameVirtualHost 172.20.30.40:80
    - NameVirtualHost 172.20.30.40:8080
    -
    <VirtualHost 172.20.30.40:80>
    ServerName www.example.com
    @@ -366,16 +346,15 @@
    Hébergements virtuels mixtes basé sur les noms et sur IP -

    Pour certaines adresses, des serveurs virtuels seront définis - par nom, et pour d'autres, ils seront définis par IP.

    +

    Toute adresse indiquée comme argument d'une section VirtualHost + et n'apparaissant dans aucun autre serveur virtuel, fait de cette + section un serveur virtuel sélectionnable uniquement en fonction de + son adresse IP.

    Configuration du serveur Listen 80
    -
    - NameVirtualHost 172.20.30.40
    -
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/example1
    @@ -556,8 +535,6 @@ ServerName www.example.com
    DocumentRoot /www/example.com

    - NameVirtualHost 172.20.30.40
    -
    <VirtualHost 172.20.30.40 172.20.30.50>
    DocumentRoot /www/example.org
    @@ -599,8 +576,6 @@ Configuration du serveur - NameVirtualHost 172.20.30.40
    -
    <VirtualHost 172.20.30.40>
    # Serveur virtuel primaire
    diff --git a/docs/manual/vhosts/index.xml.fr b/docs/manual/vhosts/index.xml.fr index 59c46db5f8..f57a35bfd4 100644 --- a/docs/manual/vhosts/index.xml.fr +++ b/docs/manual/vhosts/index.xml.fr @@ -1,7 +1,7 @@ - + @@ -84,7 +84,6 @@
    • VirtualHost
      • -
    • NameVirtualHost
    • ServerName
    • ServerAlias
    • ServerPath
      • diff --git a/docs/manual/vhosts/name-based.xml.fr b/docs/manual/vhosts/name-based.xml.fr index d0a4efd330..62f7c86333 100644 --- a/docs/manual/vhosts/name-based.xml.fr +++ b/docs/manual/vhosts/name-based.xml.fr @@ -1,7 +1,7 @@ - + @@ -69,6 +69,13 @@ qui ne peuvent pas différencier des domaines autrement que par des adresses IP séparées.
    + +

    La sélection du serveur virtuel en fonction du nom s'opère en + dehors de l'algorithme de sélection du serveur virtuel en fonction + de l'adresse IP, ce qui signifie que les recherches du point de vue + du nom du serveur ne s'effectuent que parmi le jeu de serveurs + virtuels pour lesquels la correspondance avec la paire adresse + IP/port est la plus exacte.

    Comment le serveur sélectionne-t-il le serveur @@ -81,27 +88,26 @@ virtuel bas limitant aux candidats qui conviennent le mieux du point de vue IP. La résolution basée sur IP est sans objet si l'on utilise un caractère générique (*) pour l'adresse IP dans - toutes les directives NameVirtualHost et VirtualHost.</p> - - <p>Lorsqu'une requête arrive, le serveur vérifie d'abord si elle - utilise une adresse IP qui correspond exactement à une directive - <directive module="core">NameVirtualHost</directive>. Si c'est le - cas, il va ensuite rechercher toutes les sections <directive - type="section" module="core">VirtualHost</directive> comportant une - adresse IP correspondante, puis essaiera d'en trouver une dont la - directive <directive module="core">ServerName</directive> ou - <directive module="core" >ServerAlias</directive> correspond au nom - d'hôte de la requête. S'il en trouve une, il utilisera la - configuration associée au serveur correspondant.</p> - - <section id="defaultvhost"><title>Le serveur virtuel basé sur le nom - par défaut pour une directive NameVirtualHost -

    Si aucune directive ServerName ou ServerAlias correspondant au - nom d'hôte de la requête n'est trouvée dans l'ensemble des serveurs - virtuels correspondant à la directive NameVirtualHost, c'est - le premier serveur virtuel de la liste de ceux qui - correspondent à l'adresse IP qui sera utilisé.

    + toutes les directives VirtualHost.

    +

    A l'arrivée d'une requête, le serveur va rechercher l'argument de + section VirtualHost présentant la meilleure + (la plus exacte) correspondance avec la paire adresse IP/port + utilisée dans la requête. Si plusieurs serveurs virtuels possèdent + cette même paire adresse IP/port, Apache va ensuite comparer les + valeurs des directives ServerName et module="core">ServerAlias avec le nom de serveur + présent dans la requête.

    + +
    Le serveur virtuel à base de nom + par défaut pour une paire adresse IP/port +

    Si aucune directive ServerName ou ServerAlias ne correspond dans + la liste de serveurs virtuels présentant la meilleure correspondance + du point de vue adresse IP/port, c'est le premier serveur + virtuel de cette liste qui sera utilisé.

    +
    @@ -114,42 +120,16 @@ virtuel bas DocumentRoot - NameVirtualHost ServerAlias ServerName VirtualHost -

    Pour utiliser des serveurs virtuels par nom, vous devez - désigner l'adresse IP (et si possible le port) sur le serveur - devant accepter les requêtes qui doivent être redirigées en fonction - du nom d'hôte. Cette - configuration utilise la directive - NameVirtualHost. Dans un - cas normal où n'importe quelle adresse IP peut être utilisée, - vous pouvez ajouter * comme argument de la directive - NameVirtualHost. Si vous - prévoyez d'utiliser de multiples ports (comme l'emploi de SSL), - vous devez ajouter le port à cet argument tel que - *:80.

    -

    Notez que la simple mention d'une adresse - IP dans une directive - NameVirtualHost ne suffit - pas à faire écouter le serveur sur cette IP. Consultez - Définition des adresses et ports qu'utilise - Apache pour plus - de détails. Par ailleurs, chaque adresse IP spécifiée ici doit - être associée avec une interface réseau sur le serveur.

     - -

    L'étape suivante est la création d'une section +

    La première étape consiste à créer une section VirtualHost - pour chacun des serveurs à créer. L'argument de la directive - VirtualHost - doit être le même que celui de la directive - NameVirtualHost - (dans le cas présent "*:80"). Dans chaque section + pour chacun des serveurs à définir. Dans chaque section VirtualHost, vous devez définir au minimum une directive ServerName pour désigner @@ -184,8 +164,6 @@ virtuel bas suivante à httpd.conf :

    - NameVirtualHost *:80
    -
    <VirtualHost *:80>
    # Le premier serveur virtuel de la liste est aussi le @@ -204,8 +182,7 @@ virtuel bas

    Autrement, vous pouvez spécifiez une adresse IP explicite - à la place de * dans les deux directives - NameVirtualHost et + à la place de * dans la directive VirtualHost. Par exemple, cette méthode est utile si vous souhaitez faire tourner quelques serveurs virtuels par nom sur une même adresse -- cgit v1.2.3