Apache Module mod_alias

Available Languages: en | + fr | ja | ko | tr

@@ -453,6 +454,7 @@ and designates the target as a CGI script

Available Languages: en | + fr | ja | ko | tr

diff --git a/docs/manual/mod/mod_alias.html.fr b/docs/manual/mod/mod_alias.html.fr new file mode 100644 index 0000000000..24eaad322f --- /dev/null +++ b/docs/manual/mod/mod_alias.html.fr @@ -0,0 +1,495 @@ + + + +mod_alias - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_alias

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ + + +

Description:	Permet d'atteindre différentes parties du système de +fichiers depuis l'arborescence des documents du site web, ainsi que la +redirection d'URL
Statut:	Base
Identificateur de Module:	alias_module
Fichier Source:	mod_alias.c

Sommaire

+ +

Les directives fournies par ce module permettent de manipuler et + de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les + directives Alias et + ScriptAlias permettent de + faire correspondre des URLs avec des chemins du système de fichiers. + Ceci permet de servir des contenus qui ne sont pas situés dans + l'arborescence de DocumentRoot comme s'ils y étaient + réellement. La directive ScriptAlias a pour effet + supplémentaire de marquer le répertoire cible comme conteneur de + scripts CGI.

+ +

Les directives Redirect + indiquent aux clients qu'ils doivent effectuer une nouvelle requête + avec une URL différente. Elles sont souvent utilisées lorsqu'une + ressource a été déplacée.

+ +

mod_alias est conçu pour traiter des tâches + simples de manipulation d'URL. Pour des tâches plus complexes comme + la manipulation des chaînes d'arguments des requêtes, utilisez + plutôt les outils fournis par le module mod_rewrite

+ +

Sujets

Chronologie du traitement

Voir aussi

Chronologie du traitement

+ +

Les alias et redirections apparaissant dans différents contextes + sont traités comme les autres directives en respectant les règles de fusion standards. Par + contre, ils sont traités selon une chronologie particulière + lorsqu'ils apparaissent dans le même contexte (par exemple, dans la + même section <VirtualHost>).

+ +

Premièrement, toutes les redirections sont traitées avant les + alias, et ainsi, une requête qui correspond à une directive + Redirect ou RedirectMatch ne se verra jamais + appliquer d'alias. Deuxièmement, les alias et redirections sont + traités selon l'ordre dans lequel ils apparaissent dans le fichier + de configuration, seule la première correspondance étant prise en + compte.

+ +

Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au + même sous-répertoire, vous devez classer les chemins du plus précis + au moins précis afin que toutes les directives puissent + éventuellement s'appliquer, comme dans l'exemple suivant :

+ +

+ Alias /foo/bar /baz + Alias /foo /gaq +

+ +

Si l'ordre des directives était inversé, la directive Alias ayant pour argument + /foo serait toujours appliquée avant la directive + Alias ayant pour argument + /foo/bar, et cette dernière serait toujours + ignorée.

+ +

Alias Directive

+ + + + + + +

Description:	Met en correspondance des URLs avec des chemins du système +de fichiers
Syntaxe:	`Alias chemin URL +chemin fichier\|chemin répertoire`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_alias

+ +

La directive Alias permet de stocker des + documents (destinés à être servis) dans des zones du système de + fichiers situées en dehors de l'arborescence du site web DocumentRoot. Les URLs dont le chemin + (décodé avec caractères %) commence par chemin URL seront + mises en correspondance avec des fichiers locaux dont le chemin + commence par chemin répertoire. Le chemin URL + est sensible à la casse, même sur les systèmes de fichiers + insensibles à la casse.

+ +

Exemple :

+ Alias /image /ftp/pub/image +

+ +

Une requête pour http://myserver/image/foo.gif fera + renvoyer par le serveur le fichier + /ftp/pub/image/foo.gif. Seuls les éléments de chemin + complets sont testés ; ainsi l'alias précédent ne conviendra pas + pour une requête du style http://myserver/imagefoo.gif. + Pour des mises en correspondance plus complexes faisant intervenir + les expressions rationnelles, veuillez vous reporter à la directive + AliasMatch.

+ +

Notez que si vous ajoutez un slash de fin au chemin + URL, vous devrez aussi ajouter un slash de fin au chemin de la + requête. Autrement dit, si vous définissez

+ +

Alias /icons/ /usr/local/apache/icons/

+ +

l'alias précédent ne s'appliquera pas à l'url + /icons.

+ +

Notez qu'il pourra s'avérer nécessaire de définir des sections + <Directory> + supplémentaires qui couvriront la destination des alias. + Le traitement des alias intervenant avant le traitement des sections + <Directory>, + seules les cibles des alias sont affectées (Notez cependant + que les sections <Location> sont traitées avant les alias, et + s'appliqueront donc).

+ +

En particulier, si vous créez un alias ayant pour cible un + répertoire situé en dehors de l'arborescence de votre site web + DocumentRoot, vous devrez + probablement permettre explicitement l'accès à ce répertoire.

+ +

Exemple :

+ Alias /image /ftp/pub/image + <Directory /ftp/pub/image> + + Order allow,deny + Allow from all + + </Directory> +

+ + +

AliasMatch Directive

+ + + + + + +

Description:	Met en correspondance des URLs avec le système de fichiers +en faisant intervenir les expressions rationnelles
Syntaxe:	`AliasMatch regex +chemin fichier\|chemin répertoire`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_alias

Cette directive est identique à la directive Alias, mais fait appel aux expressions rationnelles, à la place d'une + simple mise en correspondance de préfixe. L'expression rationnelle + fournie est mise en correspondance avec le chemin URL, et si elle + correspond, le serveur va substituer toute partie de chemin + correspondant à l'expression entre parenthèses dans la chaîne + fournie et l'utiliser comme nom de fichier. + Par exemple, pour activer le répertoire /icons, on peut + utiliser :

+ +

+ AliasMatch ^/icons(.*) /usr/local/apache/icons$1 +

+ +

On peut aussi construire un alias qui met en correspondance le + chemin URL sans tenir compte de la casse :

+ +

+ AliasMatch (?i)^/image(.*) /ftp/pub/image$1 +

+ + +

Redirect Directive

+ + + + + + + +

Description:	Envoie une redirection externe demandant au client +d'effectuer une autre requête avec une URL différente
Syntaxe:	`Redirect [statut] chemin URL +URL`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_alias

La directive Redirect permet de faire correspondre une ancienne + URL à une nouvelle en demandant au client d'aller chercher la ressource à + une autre localisation.

+ +

L'ancien chemin URL est un chemin sensible à la casse + (décodé à l'aide de caractères %) commençant par un slash. Les + chemins relatifs ne sont pas autorisés.

+ +

La nouvelle URL + peut être une URL absolue commençant par un protocole et un nom + d'hôte, mais on peut aussi utiliser un chemin URL commençant par un + slash, auquel cas le protocole et le nom d'hôte du serveur local + seront ajoutés.

+ +

Ensuite, toute requête commençant par chemin URL va + renvoyer une redirection au client vers l'URL cible. Tout + élément de chemin supplémentaire situé en aval du chemin + URL sera ajouté à l'URL cible.

+ +

Exemple :

+ # Redirige vers une URL sur un serveur différent + Redirect /service http://foo2.exemple.com/service + + # Redirige vers une URL sur le même serveur + Redirect /one /two +

+ +

Si le client effectue une requête pour l'URL + http://example.com/service/foo.txt, il lui sera demandé + d'en effectuer une autre pour l'URL + http://foo2.example.com/service/foo.txt. Seuls les + éléments de chemin complets sont testés, si bien que l'exemple + précédent ne s'appliquera pas à l'URL + http://example.com/servicefoo.txt. Pour des mises en + correspondance plus complexes faisant intervenir les expressions + rationnelles, veuillez vous reporter à la directive RedirectMatch.

+ + +

Note

Les directives de redirection ont priorité sur les directives + Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le + fichier de configuration.

+ +

Si aucun argument statut n'est spécifié, la + redirection sera temporaire (statut HTTP 302). Le client est alors + informé que la ressource a été temporairement déplacée. On peut + utiliser l'argument statut pour renvoyer d'autres codes + de statut HTTP :

+ +

permanent: Renvoie un statut de redirection permanente (301), indiquant + que la ressource a été définitivement déplacée.
temp: Renvoie un statut de redirection temporaire (302). C'est le + comportement par défaut.
seeother: Renvoie un statut "See Other" (303) indiquant que la ressource + a été remplacée par une autre.
gone: Renvoie un statut "Gone" (410) indiquant que la ressource a + été définitivement supprimée. Lorsque ce statut est défini, on ne + doit pas utiliser l'argument URL.

+ +

On peut renvoyer d'autres codes de statut en spécifiant le code + de statut numérique comme valeur de l'argument of statut. + Si le code de statut est compris entre 300 et 399, l'argument + URL doit être présent, sinon il ne doit pas être utilisé. + Notez que le statut doit être connu du code d'Apache (voir la + fonction send_error_response dans + http_protocol.c).

+ +

Exemple :

+ Redirect permanent /un http://exemple.com/deux + Redirect 303 /trois http://exemple.com/autre +

+ + +

RedirectMatch Directive

+ + + + + + + +

Description:	Envoie une redirection externe faisant appel aux +expressions rationnelles pour la mise en correspondance de l'URL +courante
Syntaxe:	`RedirectMatch [statut] regex +URL`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_alias

Cette directive est identique à la directive Redirect, mais fait appel aux + expressions rationnelles, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin correspondante entre parenthèses dans la chaîne spécifiée et + l'utiliser comme nom de fichier. Par exemple, pour rediriger tous + les fichiers GIF vers les fichiers JPEG de même nom sur un autre + serveur, on peut utiliser :

+ +

+ RedirectMatch (.*)\.gif$ http://www.autre-serveur.com$1.jpg +

+ +

RedirectPermanent Directive

+ + + + + + + +

Description:	Envoie une redirection externe permanente demandant au +client d'effectuer une nouvelle requête avec une URL +différente
Syntaxe:	`RedirectPermanent chemin URL URL`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_alias

Cette directive informe le client que la redirection est + permanente (statut 301). Son comportement est exactement le même + que celui de Redirect permanent.

+ +

RedirectTemp Directive

+ + + + + + + +

Description:	Envoie une redirection externe temporaire demandant au +client d'effectuer une nouvelle requête avec une URL +différente
Syntaxe:	`RedirectTemp chemin URL URL`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_alias

Cette directive informe le client que la redirection n'est + que temporaire (statut 302). Son comportement est exactement le même + que celui de Redirect temp.

+ +

ScriptAlias Directive

+ + + + + + +

Description:	Fait correspondre une URL à une zone du système de fichiers +et désigne la cible comme script CGI
Syntaxe:	`ScriptAlias chemin URL +chemin fichier\|chemin répertoire`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_alias

La directive ScriptAlias présente le même + comportement que la directive Alias, mais désigne en plus le + répertoire cible comme conteneur de scripts CGI qui seront traitées + par le gestionnaire cgi-script du module mod_cgi. + Les URLs dont le chemin URL sensible à la casse (décodé avec + caractères %) commence par chemin URL seront mises en + correspondance avec les scripts dont le chemin commence par le + second argument, qui est un chemin complet dans le système de + fichiers local.

+ +

Exemple :

+ ScriptAlias /cgi-bin/ /web/cgi-bin/ +

+ +

Une requête pour http://mon-serveur/cgi-bin/foo + ferait exécuter par le serveur le script + /web/cgi-bin/foo. Cette configuration est sensiblement + équivalente à :

+ Alias /cgi-bin/ /web/cgi-bin/ + <Location /cgi-bin > + + SetHandler cgi-script + Options +ExecCGI + + </Location> +

+ +

Vous pouvez aussi utiliser ScriptAlias + avec un script ou gestionnaire de votre cru. Par exemple :

+ +

+ ScriptAlias /cgi-bin/ /web/cgi-handler.pl +

+ +

Dans ce scénario, tous les fichiers faisant l'objet d'une requête + dans /cgi-bin/ seront traités par le fichier que vous + avez spécifié, ce qui vous permet d'utiliser votre propre + gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour + les scripts CGI afin d'ajouter du contenu, ou autre action "maison".

+ +

Il est préférable d'éviter de placer les + scripts CGI dans l'arborescence de DocumentRoot afin d'éviter de révéler + accidentellement leur code source lors d'une modification de + configuration. On y parvient aisément avec + ScriptAlias en mettant en correspondance une + URL et en désignant la cible comme scripts CGI par la même occasion. + Si vous choisissez de placer vos scripts CGI dans un répertoire + accessible depuis le web, n'utilisez pas + ScriptAlias. Utilisez plutôt <Directory>, SetHandler, et Options comme dans l'exemple suivant : +

+ <Directory /usr/local/apache2/htdocs/cgi-bin > + + SetHandler cgi-script + Options ExecCGI + + </Directory> +

+ Ceci est nécessaire car plusieurs chemins URL peuvent + correspondre à la même zone du système de fichiers, court-circuitant + ainsi la directive ScriptAlias et révélant le + code source des scripts CGI s'ils ne sont pas protégés par une + section Directory.

+ + +

Voir aussi

Tutoriel CGI

ScriptAliasMatch Directive

+ + + + + + +

Description:	Fait correspondre une URL à une zone du système de fichiers +en faisant appel aux expressions rationnelles et en désignant la cible +comme un script CGI
Syntaxe:	`ScriptAliasMatch regex +chemin fichier\|chemin répertoire`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_alias

Cette directive est équivalente à la directive ScriptAlias, mais fait appel aux + expressions rationnelles, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin entre parenthèses dans la chaîne spécifiée et l'utiliser + comme nom de fichier. Par exemple, pour activer le répertoire + standard /cgi-bin, on peut utiliser :

+ +

+ ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 +

+ +

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_alias.xml.fr b/docs/manual/mod/mod_alias.xml.fr new file mode 100644 index 0000000000..c159b5fde3 --- /dev/null +++ b/docs/manual/mod/mod_alias.xml.fr @@ -0,0 +1,482 @@ + + + + + + + + + + + +mod_alias +Permet d'atteindre différentes parties du système de +fichiers depuis l'arborescence des documents du site web, ainsi que la +redirection d'URL +Base +mod_alias.c +alias_module + +

Les directives fournies par ce module permettent de manipuler et + de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les + directives Alias et + ScriptAlias permettent de + faire correspondre des URLs avec des chemins du système de fichiers. + Ceci permet de servir des contenus qui ne sont pas situés dans + l'arborescence de DocumentRoot comme s'ils y étaient + réellement. La directive ScriptAlias a pour effet + supplémentaire de marquer le répertoire cible comme conteneur de + scripts CGI.

+ +

Les directives Redirect + indiquent aux clients qu'ils doivent effectuer une nouvelle requête + avec une URL différente. Elles sont souvent utilisées lorsqu'une + ressource a été déplacée.

+ +

mod_alias est conçu pour traiter des tâches + simples de manipulation d'URL. Pour des tâches plus complexes comme + la manipulation des chaînes d'arguments des requêtes, utilisez + plutôt les outils fournis par le module mod_rewrite

+ +

+ +mod_rewrite Mise en correspondance des URLs avec le +système de fichiers + +

Chronologie du traitement + +

+ +

Premièrement, toutes les redirections sont traitées avant les + alias, et ainsi, une requête qui correspond à une directive + Redirect ou RedirectMatch ne se verra jamais + appliquer d'alias. Deuxièmement, les alias et redirections sont + traités selon l'ordre dans lequel ils apparaissent dans le fichier + de configuration, seule la première correspondance étant prise en + compte.

+ +

+ + + Alias /foo/bar /baz
+ Alias /foo /gaq + + +

Si l'ordre des directives était inversé, la directive Alias ayant pour argument + /foo serait toujours appliquée avant la directive + Alias ayant pour argument + /foo/bar, et cette dernière serait toujours + ignorée.

+ +

+ + +Alias +Met en correspondance des URLs avec des chemins du système +de fichiers +Alias chemin URL +chemin fichier|chemin répertoire +server configvirtual host + + + + +

La directive Alias permet de stocker des + documents (destinés à être servis) dans des zones du système de + fichiers situées en dehors de l'arborescence du site web DocumentRoot. Les URLs dont le chemin + (décodé avec caractères %) commence par chemin URL seront + mises en correspondance avec des fichiers locaux dont le chemin + commence par chemin répertoire. Le chemin URL + est sensible à la casse, même sur les systèmes de fichiers + insensibles à la casse.

+ + Exemple : + Alias /image /ftp/pub/image + + +

+ +

Notez que si vous ajoutez un slash de fin au chemin + URL, vous devrez aussi ajouter un slash de fin au chemin de la + requête. Autrement dit, si vous définissez

+ +

Alias /icons/ /usr/local/apache/icons/

+ +

l'alias précédent ne s'appliquera pas à l'url + /icons.

+ +

Notez qu'il pourra s'avérer nécessaire de définir des sections + Directory + supplémentaires qui couvriront la destination des alias. + Le traitement des alias intervenant avant le traitement des sections + Directory, + seules les cibles des alias sont affectées (Notez cependant + que les sections Location sont traitées avant les alias, et + s'appliqueront donc).

+ +

En particulier, si vous créez un alias ayant pour cible un + répertoire situé en dehors de l'arborescence de votre site web + DocumentRoot, vous devrez + probablement permettre explicitement l'accès à ce répertoire.

+ + Exemple : + Alias /image /ftp/pub/image
+ <Directory /ftp/pub/image>
+ + Order allow,deny
+ Allow from all
+ + </Directory> + + + + + + +AliasMatch +Met en correspondance des URLs avec le système de fichiers +en faisant intervenir les expressions rationnelles +AliasMatch regex +chemin fichier|chemin répertoire +server configvirtual host + + + +

Cette directive est identique à la directive Alias, mais fait appel aux expressions rationnelles, à la place d'une + simple mise en correspondance de préfixe. L'expression rationnelle + fournie est mise en correspondance avec le chemin URL, et si elle + correspond, le serveur va substituer toute partie de chemin + correspondant à l'expression entre parenthèses dans la chaîne + fournie et l'utiliser comme nom de fichier. + Par exemple, pour activer le répertoire /icons, on peut + utiliser :

+ + + AliasMatch ^/icons(.*) /usr/local/apache/icons$1 + + +

On peut aussi construire un alias qui met en correspondance le + chemin URL sans tenir compte de la casse :

+ + + AliasMatch (?i)^/image(.*) /ftp/pub/image$1 + + + + + + +Redirect +Envoie une redirection externe demandant au client +d'effectuer une autre requête avec une URL différente +Redirect [statut] chemin URL +URL +server configvirtual host +directory.htaccess +FileInfo + + +

La directive Redirect permet de faire correspondre une ancienne + URL à une nouvelle en demandant au client d'aller chercher la ressource à + une autre localisation.

+ +

L'ancien chemin URL est un chemin sensible à la casse + (décodé à l'aide de caractères %) commençant par un slash. Les + chemins relatifs ne sont pas autorisés.

+ +

+ + Exemple : + # Redirige vers une URL sur un serveur différent
+ Redirect /service http://foo2.exemple.com/service
+
+ # Redirige vers une URL sur le même serveur
+ Redirect /one /two + + +

+ + + Note +

Les directives de redirection ont priorité sur les directives + Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le + fichier de configuration.

+ +

permanent: Renvoie un statut de redirection permanente (301), indiquant + que la ressource a été définitivement déplacée.
temp: Renvoie un statut de redirection temporaire (302). C'est le + comportement par défaut.
seeother: Renvoie un statut "See Other" (303) indiquant que la ressource + a été remplacée par une autre.
gone: Renvoie un statut "Gone" (410) indiquant que la ressource a + été définitivement supprimée. Lorsque ce statut est défini, on ne + doit pas utiliser l'argument URL.

+ +

+ + Exemple : + Redirect permanent /un http://exemple.com/deux
+ Redirect 303 /trois http://exemple.com/autre + + + + + + +RedirectMatch +Envoie une redirection externe faisant appel aux +expressions rationnelles pour la mise en correspondance de l'URL +courante +RedirectMatch [statut] regex +URL +server configvirtual host +directory.htaccess +FileInfo + + +

Cette directive est identique à la directive Redirect, mais fait appel aux + expressions rationnelles, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin correspondante entre parenthèses dans la chaîne spécifiée et + l'utiliser comme nom de fichier. Par exemple, pour rediriger tous + les fichiers GIF vers les fichiers JPEG de même nom sur un autre + serveur, on peut utiliser :

+ + + RedirectMatch (.*)\.gif$ http://www.autre-serveur.com$1.jpg + + + + + +RedirectTemp +Envoie une redirection externe temporaire demandant au +client d'effectuer une nouvelle requête avec une URL +différente +RedirectTemp chemin URL URL +server configvirtual host +directory.htaccess +FileInfo + + +

Cette directive informe le client que la redirection n'est + que temporaire (statut 302). Son comportement est exactement le même + que celui de Redirect temp.

+ + + + +RedirectPermanent +Envoie une redirection externe permanente demandant au +client d'effectuer une nouvelle requête avec une URL +différente +RedirectPermanent chemin URL URL +server configvirtual host +directory.htaccess +FileInfo + + +

Cette directive informe le client que la redirection est + permanente (statut 301). Son comportement est exactement le même + que celui de Redirect permanent.

+ + + + +ScriptAlias +Fait correspondre une URL à une zone du système de fichiers +et désigne la cible comme script CGI +ScriptAlias chemin URL +chemin fichier|chemin répertoire +server configvirtual host + + + +

La directive ScriptAlias présente le même + comportement que la directive Alias, mais désigne en plus le + répertoire cible comme conteneur de scripts CGI qui seront traitées + par le gestionnaire cgi-script du module mod_cgi. + Les URLs dont le chemin URL sensible à la casse (décodé avec + caractères %) commence par chemin URL seront mises en + correspondance avec les scripts dont le chemin commence par le + second argument, qui est un chemin complet dans le système de + fichiers local.

+ + Exemple : + ScriptAlias /cgi-bin/ /web/cgi-bin/ + + +

Une requête pour http://mon-serveur/cgi-bin/foo + ferait exécuter par le serveur le script + /web/cgi-bin/foo. Cette configuration est sensiblement + équivalente à :

+ + Alias /cgi-bin/ /web/cgi-bin/
+ <Location /cgi-bin >
+ + SetHandler cgi-script
+ Options +ExecCGI
+ + </Location> + + +

Vous pouvez aussi utiliser ScriptAlias + avec un script ou gestionnaire de votre cru. Par exemple :

+ + + ScriptAlias /cgi-bin/ /web/cgi-handler.pl + + +

+ + Il est préférable d'éviter de placer les + scripts CGI dans l'arborescence de DocumentRoot afin d'éviter de révéler + accidentellement leur code source lors d'une modification de + configuration. On y parvient aisément avec + ScriptAlias en mettant en correspondance une + URL et en désignant la cible comme scripts CGI par la même occasion. + Si vous choisissez de placer vos scripts CGI dans un répertoire + accessible depuis le web, n'utilisez pas + ScriptAlias. Utilisez plutôt Directory, SetHandler, et Options comme dans l'exemple suivant : + + <Directory /usr/local/apache2/htdocs/cgi-bin >
+ + SetHandler cgi-script
+ Options ExecCGI
+ + </Directory> + + Ceci est nécessaire car plusieurs chemins URL peuvent + correspondre à la même zone du système de fichiers, court-circuitant + ainsi la directive ScriptAlias et révélant le + code source des scripts CGI s'ils ne sont pas protégés par une + section Directory. + + +Tutoriel CGI + + + +ScriptAliasMatch +Fait correspondre une URL à une zone du système de fichiers +en faisant appel aux expressions rationnelles et en désignant la cible +comme un script CGI +ScriptAliasMatch regex +chemin fichier|chemin répertoire +server configvirtual host + + + +

Cette directive est équivalente à la directive ScriptAlias, mais fait appel aux + expressions rationnelles, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin entre parenthèses dans la chaîne spécifiée et l'utiliser + comme nom de fichier. Par exemple, pour activer le répertoire + standard /cgi-bin, on peut utiliser :

+ + + ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 + + + + + diff --git a/docs/manual/mod/mod_alias.xml.meta b/docs/manual/mod/mod_alias.xml.meta index 9ca883a782..59278b77b2 100644 --- a/docs/manual/mod/mod_alias.xml.meta +++ b/docs/manual/mod/mod_alias.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko tr diff --git a/docs/manual/mod/mod_auth_basic.html b/docs/manual/mod/mod_auth_basic.html index 1df9fdba6c..a3f5884f6a 100644 --- a/docs/manual/mod/mod_auth_basic.html +++ b/docs/manual/mod/mod_auth_basic.html @@ -4,6 +4,10 @@ URI: mod_auth_basic.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_auth_basic.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_auth_basic.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_auth_basic.html.en b/docs/manual/mod/mod_auth_basic.html.en index f0cb8f6723..44201ec885 100644 --- a/docs/manual/mod/mod_auth_basic.html.en +++ b/docs/manual/mod/mod_auth_basic.html.en @@ -22,6 +22,7 @@

Apache Module mod_auth_basic

Available Languages: en | + fr | ja | ko

@@ -124,6 +125,7 @@ lower level modules

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_auth_basic.html.fr b/docs/manual/mod/mod_auth_basic.html.fr new file mode 100644 index 0000000000..9670d37340 --- /dev/null +++ b/docs/manual/mod/mod_auth_basic.html.fr @@ -0,0 +1,145 @@ + + + +mod_auth_basic - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_auth_basic

Langues Disponibles: en | + fr | + ja | + ko

+ + + + +

Description:	Authentification de base
Statut:	Base
Identificateur de Module:	auth_basic_module
Fichier Source:	mod_auth_basic.c
Compatibilité:	Disponible depuis la version 2.1 d'Apache

Sommaire

+ +

Ce module permet d'utiliser l'authentification basique HTTP pour + restreindre l'accès en recherchant les utilisateurs dans les + fournisseurs d'authentification spécifiés. Il est en général + combiné avec au moins un module d'authentification comme + mod_authn_file et un module d'autorisation comme + mod_authz_user. L'authentification HTTP à + base de condensé (digest), quant à elle, est fournie par le module + mod_auth_digest.

Directives

AuthBasicAuthoritative
AuthBasicProvider

Voir aussi

+ +

AuthBasicAuthoritative Directive

+ + + + + + + + +

Description:	Définit si les processus d'autorisation et +d'authentification peuvent être confiés à des modules de plus bas +niveau
Syntaxe:	`AuthBasicAuthoritative On\|Off`
Défaut:	`AuthBasicAuthoritative On`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Base
Module:	mod_auth_basic

Normalement, chaque module d'autorisation énuméré dans la + directive AuthBasicProvider va tenter de + vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des + fournisseurs, l'accès sera refusé. Définir explicitement la + directive AuthBasicAuthoritative à + Off permet de confier l'autorisation et + l'authentification à d'autres modules non basés sur les fournisseurs + si aucun identifiant utilisateur ou aucune + règle ne correspondent à l'identifiant utilisateur + spécifié. Ceci ne peut s'avérer nécessaire que lorsque + mod_auth_basic est combiné avec des modules tiers + qui n'ont pas été configurés à l'aide de la directive AuthBasicProvider. Lorsqu'on + utilise de tels modules, l'ordre dans lequel s'effectue le + traitement est défini dans le code source des modules et n'est pas + configurable.

+ +

AuthBasicProvider Directive

+ + + + + + + + +

Description:	Définit le(les) fournisseur(s) d'authentification pour +cette zone du site web
Syntaxe:	`AuthBasicProvider nom fournisseur +[nom fournisseur] ...`
Défaut:	`AuthBasicProvider file`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Base
Module:	mod_auth_basic

La directive AuthBasicProvider permet de + définir le fournisseur utilisé pour authentifier les utilisateurs + pour la zone du site web concernée. Le fournisseur par défaut + file est implémenté par le module + mod_authn_file. Assurez-vous que le module + implémentant le fournisseur choisi soit bien présent dans le + serveur.

+ +

Exemple

+ <Location /secure> + + AuthType basic + AuthName "private area" + AuthBasicProvider dbm + AuthDBMType SDBM + AuthDBMUserFile /www/etc/dbmpasswd + Require valid-user + + </Location> +

+ +

Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un + d'entre eux trouve une correspondance pour le nom d'utilisateur de + la requête ; alors, ce dernier fournisseur sera le seul à vérifier + le mot de passe. Un échec dans la vérification du mot de passe + n'entraîne pas le passage du contrôle au fournisseur suivant.

+ +

Les différents fournisseurs disponibles sont implémentés par les + modules mod_authn_dbm, + mod_authn_file, mod_authn_dbd, et + mod_authnz_ldap.

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_auth_basic.xml.fr b/docs/manual/mod/mod_auth_basic.xml.fr new file mode 100644 index 0000000000..5c72085a72 --- /dev/null +++ b/docs/manual/mod/mod_auth_basic.xml.fr @@ -0,0 +1,129 @@ + + + + + + + + + + + +mod_auth_basic +Authentification de base +Base +mod_auth_basic.c +auth_basic_module +Disponible depuis la version 2.1 d'Apache + +

Ce module permet d'utiliser l'authentification basique HTTP pour + restreindre l'accès en recherchant les utilisateurs dans les + fournisseurs d'authentification spécifiés. Il est en général + combiné avec au moins un module d'authentification comme + mod_authn_file et un module d'autorisation comme + mod_authz_user. L'authentification HTTP à + base de condensé (digest), quant à elle, est fournie par le module + mod_auth_digest.

+AuthName +AuthType +Require +Match +Mode d'emploi de +l'authentification + + +AuthBasicProvider +Définit le(les) fournisseur(s) d'authentification pour +cette zone du site web +AuthBasicProvider nom fournisseur +[nom fournisseur] ... +AuthBasicProvider file +directory.htaccess + +AuthConfig + + +

La directive AuthBasicProvider permet de + définir le fournisseur utilisé pour authentifier les utilisateurs + pour la zone du site web concernée. Le fournisseur par défaut + file est implémenté par le module + mod_authn_file. Assurez-vous que le module + implémentant le fournisseur choisi soit bien présent dans le + serveur.

+ + Exemple + <Location /secure>
+ + AuthType basic
+ AuthName "private area"
+ AuthBasicProvider dbm
+ AuthDBMType SDBM
+ AuthDBMUserFile /www/etc/dbmpasswd
+ Require valid-user
+ + </Location> + + +

+ +

Les différents fournisseurs disponibles sont implémentés par les + modules mod_authn_dbm, + mod_authn_file, mod_authn_dbd, et + mod_authnz_ldap.

+ + + + +AuthBasicAuthoritative +Définit si les processus d'autorisation et +d'authentification peuvent être confiés à des modules de plus bas +niveau +AuthBasicAuthoritative On|Off +AuthBasicAuthoritative On +directory.htaccess + +AuthConfig + + +

Normalement, chaque module d'autorisation énuméré dans la + directive AuthBasicProvider va tenter de + vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des + fournisseurs, l'accès sera refusé. Définir explicitement la + directive AuthBasicAuthoritative à + Off permet de confier l'autorisation et + l'authentification à d'autres modules non basés sur les fournisseurs + si aucun identifiant utilisateur ou aucune + règle ne correspondent à l'identifiant utilisateur + spécifié. Ceci ne peut s'avérer nécessaire que lorsque + mod_auth_basic est combiné avec des modules tiers + qui n'ont pas été configurés à l'aide de la directive AuthBasicProvider. Lorsqu'on + utilise de tels modules, l'ordre dans lequel s'effectue le + traitement est défini dans le code source des modules et n'est pas + configurable.

+ + + + diff --git a/docs/manual/mod/mod_auth_basic.xml.meta b/docs/manual/mod/mod_auth_basic.xml.meta index b6db2c4c4d..1c0c396040 100644 --- a/docs/manual/mod/mod_auth_basic.xml.meta +++ b/docs/manual/mod/mod_auth_basic.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_authn_file.html b/docs/manual/mod/mod_authn_file.html index 1f67fc3f4d..c718bed0b8 100644 --- a/docs/manual/mod/mod_authn_file.html +++ b/docs/manual/mod/mod_authn_file.html @@ -4,6 +4,10 @@ URI: mod_authn_file.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_authn_file.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_authn_file.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authn_file.html.en b/docs/manual/mod/mod_authn_file.html.en index e8dfcebae7..ea8887d1bf 100644 --- a/docs/manual/mod/mod_authn_file.html.en +++ b/docs/manual/mod/mod_authn_file.html.en @@ -22,6 +22,7 @@

Apache Module mod_authn_file

Available Languages: en | + fr | ja | ko

@@ -124,6 +125,7 @@ passwords for authentication

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_authn_file.html.fr b/docs/manual/mod/mod_authn_file.html.fr new file mode 100644 index 0000000000..416b8cb4e6 --- /dev/null +++ b/docs/manual/mod/mod_authn_file.html.fr @@ -0,0 +1,139 @@ + + + +mod_authn_file - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_authn_file

Langues Disponibles: en | + fr | + ja | + ko

+ + + + +

Description:	Authentification utilisateur à l'aide de fichiers +texte
Statut:	Base
Identificateur de Module:	authn_file_module
Fichier Source:	mod_authn_file.c
Compatibilité:	Disponible depuis les versions 2.1 et supérieures +d'Apache

Sommaire

+ +

Ce module permet aux frontaux d'authentification comme + mod_auth_digest et mod_auth_basic + d'authentifier les utilisateurs en les recherchant dans des fichiers + de mots de passe au format texte. mod_authn_dbm + fournit une fonctionnalité similaire.

+ +

Lorsqu'on utilise mod_auth_basic ou + mod_auth_digest, ce module peut être invoqué en + affectant la valeur file à la directive AuthBasicProvider ou AuthDigestProvider.

Directives

AuthUserFile

Voir aussi

+ +

AuthUserFile Directive

+ + + + + + + +

Description:	Définit le nom d'un fichier texte pour l'authentification +contenant la liste des utilisateurs et de leurs mots de +passe
Syntaxe:	`AuthUserFile chemin-fichier`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Base
Module:	mod_authn_file

La directive AuthUserFile permet de + définir le nom d'un fichier texte pour l'authentification contenant + la liste des utilisateurs et de leurs mots de passe. + chemin-fichier est le chemin vers le fichier + des utilisateurs. S'il n'est pas absolu, il est considéré comme + relatif au répertoire défini par la directive ServerRoot.

+ +

Chaque ligne du fichier des utilisateurs se compose du nom de + l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le + même identifiant utilisateur est référencé plusieurs fois, + mod_authn_file utilisera la première occurence pour + vérifier le mot de passe.

+ +

Pour l'Authentification de base HTTP, on utilise + l'utilitaire htpasswd, installé avec la + distribution binaire ou se trouvant dans src/support, + pour maintenir le fichier des mots de passe. Voir sa page de manuel pour plus de + détails. En bref :

+ +

On crée un fichier de mots de passe nom-fichier avec + nom-utilisateur comme identifiant initial. Le mot de + passe correspondant sera alors demandé :

+ +

+ htpasswd -c nom-fichier nom-utilisateur +

+ +

Pour ajouter ou modifier nom-utilisateur2 dans le + fichier de mots de passe nom-fichier :

+ +

+ htpasswd nom-fichier nom-utilisateur2 +

+ +

Noter qu'une recherche dans de grands fichiers texte peut être + très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM + avec la directive AuthDBMUserFile.

+ +

Si vous utilisez l'Authentification HTTP à base de + condensé, l'utilitaire htpasswd ne convient + pas. Vous devez utiliser htdigest à la place. + Notez que vous ne pouvez pas mélanger des données utilisateur pour + l'Authentification HTTP à base de condensé et des données pour + l'Authentification de Base dans le même fichier.

+ +

Sécurité

Assurez-vous que le fichier AuthUserFile + soit bien stocké en dehors de l'arborescence des documents du + serveur web. Ne placez pas ce fichier dans le + répertoire qu'il protège. Dans le cas contraire, les clients + seraient en mesure de télécharger le fichier des mots de passe.

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_authn_file.xml.fr b/docs/manual/mod/mod_authn_file.xml.fr new file mode 100644 index 0000000000..c684bcd174 --- /dev/null +++ b/docs/manual/mod/mod_authn_file.xml.fr @@ -0,0 +1,127 @@ + + + + + + + + + + + +mod_authn_file +Authentification utilisateur à l'aide de fichiers +texte +Base +mod_authn_file.c +authn_file_module +Disponible depuis les versions 2.1 et supérieures +d'Apache + +

Ce module permet aux frontaux d'authentification comme + mod_auth_digest et mod_auth_basic + d'authentifier les utilisateurs en les recherchant dans des fichiers + de mots de passe au format texte. mod_authn_dbm + fournit une fonctionnalité similaire.

+ +

Lorsqu'on utilise mod_auth_basic ou + mod_auth_digest, ce module peut être invoqué en + affectant la valeur file à la directive AuthBasicProvider ou AuthDigestProvider.

+ + AuthBasicProvider + + + AuthDigestProvider + +htpasswd +htdigest + + +AuthUserFile +Définit le nom d'un fichier texte pour l'authentification +contenant la liste des utilisateurs et de leurs mots de +passe +AuthUserFile chemin-fichier +directory.htaccess + +AuthConfig + + +

La directive AuthUserFile permet de + définir le nom d'un fichier texte pour l'authentification contenant + la liste des utilisateurs et de leurs mots de passe. + chemin-fichier est le chemin vers le fichier + des utilisateurs. S'il n'est pas absolu, il est considéré comme + relatif au répertoire défini par la directive ServerRoot.

+ +

Chaque ligne du fichier des utilisateurs se compose du nom de + l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le + même identifiant utilisateur est référencé plusieurs fois, + mod_authn_file utilisera la première occurence pour + vérifier le mot de passe.

+ +

Pour l'Authentification de base HTTP, on utilise + l'utilitaire htpasswd, installé avec la + distribution binaire ou se trouvant dans src/support, + pour maintenir le fichier des mots de passe. Voir sa page de manuel pour plus de + détails. En bref :

+ +

On crée un fichier de mots de passe nom-fichier avec + nom-utilisateur comme identifiant initial. Le mot de + passe correspondant sera alors demandé :

+ + + htpasswd -c nom-fichier nom-utilisateur + + +

Pour ajouter ou modifier nom-utilisateur2 dans le + fichier de mots de passe nom-fichier :

+ + + htpasswd nom-fichier nom-utilisateur2 + + +

Noter qu'une recherche dans de grands fichiers texte peut être + très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM + avec la directive AuthDBMUserFile.

+ +

Si vous utilisez l'Authentification HTTP à base de + condensé, l'utilitaire htpasswd ne convient + pas. Vous devez utiliser htdigest à la place. + Notez que vous ne pouvez pas mélanger des données utilisateur pour + l'Authentification HTTP à base de condensé et des données pour + l'Authentification de Base dans le même fichier.

+ + Sécurité +

Assurez-vous que le fichier AuthUserFile + soit bien stocké en dehors de l'arborescence des documents du + serveur web. Ne placez pas ce fichier dans le + répertoire qu'il protège. Dans le cas contraire, les clients + seraient en mesure de télécharger le fichier des mots de passe.

+ + + + + diff --git a/docs/manual/mod/mod_authn_file.xml.meta b/docs/manual/mod/mod_authn_file.xml.meta index ad6bbc4baf..de79635381 100644 --- a/docs/manual/mod/mod_authn_file.xml.meta +++ b/docs/manual/mod/mod_authn_file.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_authz_host.html b/docs/manual/mod/mod_authz_host.html index 374fb7f4fd..f46aa2e275 100644 --- a/docs/manual/mod/mod_authz_host.html +++ b/docs/manual/mod/mod_authz_host.html @@ -3,3 +3,7 @@ URI: mod_authz_host.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_authz_host.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_authz_host.html.en b/docs/manual/mod/mod_authz_host.html.en index 141faff98c..bc46c8c722 100644 --- a/docs/manual/mod/mod_authz_host.html.en +++ b/docs/manual/mod/mod_authz_host.html.en @@ -21,7 +21,8 @@

Apache Module mod_authz_host

Available Languages: en

Available Languages: en | + fr

@@ -215,7 +216,8 @@ address)

Available Languages: en

Available Languages: en | + fr

diff --git a/docs/manual/mod/mod_authz_host.html.fr b/docs/manual/mod/mod_authz_host.html.fr new file mode 100644 index 0000000000..26ace39635 --- /dev/null +++ b/docs/manual/mod/mod_authz_host.html.fr @@ -0,0 +1,230 @@ + + + +mod_authz_host - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_authz_host

Langues Disponibles: en | + fr

Description:	Group authorizations based on host (name or IP address)

+ + + +

Description:	Autorisations de groupe basées sur l'hôte (nom ou adresse +IP)
Statut:	Base
Identificateur de Module:	authz_host_module
Fichier Source:	mod_authz_host.c
Compatibilité:	Disponible depuis les versions 2.3 et supérieures +d'Apache

Sommaire

+ +

Les fournisseurs d'autorisation implémentés par le module + mod_authz_host sont enregistrés à l'aide des + directives Require ou + Match. On peut + utiliser ces directives à l'intérieur de sections <Directory>, <Files>, ou <Location> ou de fichiers + .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 + <Limit>.

Directives

Ce module ne fournit aucune directive.

Sujets

Les directives Require

Voir aussi

Authentification, autorisation et +contrôle d'accès
Require
Match

Les directives Require

+ +

Les directives d'Apache Require et Match sont utilisées au cours de + la phase d'autorisation pour vérifier si un utilisateur se voit + accorder ou refuser l'accès à une ressource. mod_authz_host fournit + les types d'autorisation 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.

+ +

Require env

+ +

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 mod_setenvif. On + peut ainsi utiliser cette directive pour contrôler l'accès en + fonction de certains en-têtes comme User-Agent (type de + navigateur), Referer, etc...

+ +

Exemple :

+ SetEnvIf User-Agent ^KnockKnock/2\.0 laisse_moi_entrer + <Directory /docroot> + + Require env laisse_moi_entrer + + </Directory> +

+ +

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.

+ + + +

Require ip

+ +

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 :

+ +

+ Require ip 10.1.2.3 + Require ip 192.168.1.104 192.168.1.205 +

+ +

L'adresse IP d'un hôte pour qui l'accès est accordé

+ +

Une adresse IP partielle :

+ +

+ Require ip 10.1 + Require ip 10 172.20 192.168.2 +

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 :

+ +

+ Require ip 10.1.0.0/255.255.0.0 +

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 :

+ +

+ Require ip 10.1.0.0/16 +

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 :

+ +

+ Require ip 2001:db8::a00:20ff:fea7:ccea + Require ip 2001:db8::a00:20ff:fea7:ccea/10 +

+ + + + +

Require host

+ +

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)

+ +

+ Require host apache.org + Require host .net example.edu +

+ +

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 HostnameLookups. Il + va effectuer une recherche DNS inverse sur l'adresse IP pour trouver + le nom d'hôte associé, puis une recherche DNS directe sur le nom + d'hôte pour vérifier qu'il correspond bien à l'adresse IP originale. + L'accès ne sera accordé que si le nom d'hôte correspond et si les + recherches DNS inverse et directe sont cohérentes.

+ + + +

Require all

+ +

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.

+ +

+ Require all granted +

+ +

+ Require all denied +

+ + + + +

Langues Disponibles: en | + fr

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_authz_host.xml.fr b/docs/manual/mod/mod_authz_host.xml.fr new file mode 100644 index 0000000000..d287df21af --- /dev/null +++ b/docs/manual/mod/mod_authz_host.xml.fr @@ -0,0 +1,224 @@ + + + + + + + + + + + +mod_authz_host +Autorisations de groupe basées sur l'hôte (nom ou adresse +IP) +Base +mod_authz_host.c +authz_host_module +Disponible depuis les versions 2.3 et supérieures +d'Apache + +

Les fournisseurs d'autorisation implémentés par le module + mod_authz_host sont enregistrés à l'aide des + directives Require ou + Match. On peut + utiliser ces directives à l'intérieur de sections Directory, Files, ou Location ou de fichiers + .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.

+ +

+ +Authentification, autorisation et +contrôle d'accès +Require +Match + +

Les directives Require + +

Les directives d'Apache Require et Match sont utilisées au cours de + la phase d'autorisation pour vérifier si un utilisateur se voit + accorder ou refuser l'accès à une ressource. mod_authz_host fournit + les types d'autorisation env, ip, + host et all. D'autres types d'autorisation + sont aussi disponibles, mais nécessitent le chargement des modules + d'autorisation appropriés.

+ +

Require env + +

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 mod_setenvif. On + peut ainsi utiliser cette directive pour contrôler l'accès en + fonction de certains en-têtes comme User-Agent (type de + navigateur), Referer, etc...

+ + Exemple : + SetEnvIf User-Agent ^KnockKnock/2\.0 laisse_moi_entrer
+ <Directory /docroot>
+ + Require env laisse_moi_entrer
+ + </Directory> + + +

+ +

Require ip + +

+ +

Une adresse IP complète :

+ + + Require ip 10.1.2.3
+ Require ip 192.168.1.104 192.168.1.205 + + +

L'adresse IP d'un hôte pour qui l'accès est accordé

+ +

Une adresse IP partielle :

+ + + Require ip 10.1
+ Require ip 10 172.20 192.168.2 + +

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 :

+ + + Require ip 10.1.0.0/255.255.0.0 + +

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 :

+ + + Require ip 10.1.0.0/16 + +

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 :

+ + + Require ip 2001:db8::a00:20ff:fea7:ccea
+ Require ip 2001:db8::a00:20ff:fea7:ccea/10 + + + +

+ +

Require host + +

+ +

Un nom de domaine (éventuellement partiel)

+ + + Require host apache.org
+ Require host .net example.edu + + +

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 HostnameLookups. Il + va effectuer une recherche DNS inverse sur l'adresse IP pour trouver + le nom d'hôte associé, puis une recherche DNS directe sur le nom + d'hôte pour vérifier qu'il correspond bien à l'adresse IP originale. + L'accès ne sera accordé que si le nom d'hôte correspond et si les + recherches DNS inverse et directe sont cohérentes.

+ +

Require all + +

+ + + Require all granted
+ + + + Require all denied
+ + +

+ + +

+ + + diff --git a/docs/manual/mod/mod_authz_host.xml.meta b/docs/manual/mod/mod_authz_host.xml.meta index b98a1852c1..697c3af893 100644 --- a/docs/manual/mod/mod_authz_host.xml.meta +++ b/docs/manual/mod/mod_authz_host.xml.meta @@ -8,5 +8,6 @@ en + fr diff --git a/docs/manual/mod/mod_authz_owner.html b/docs/manual/mod/mod_authz_owner.html index b70f2eab69..e021070ec1 100644 --- a/docs/manual/mod/mod_authz_owner.html +++ b/docs/manual/mod/mod_authz_owner.html @@ -4,6 +4,10 @@ URI: mod_authz_owner.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_authz_owner.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_authz_owner.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authz_owner.html.en b/docs/manual/mod/mod_authz_owner.html.en index bfb323d44b..f69f6031ae 100644 --- a/docs/manual/mod/mod_authz_owner.html.en +++ b/docs/manual/mod/mod_authz_owner.html.en @@ -22,6 +22,7 @@

Apache Module mod_authz_owner

Available Languages: en | + fr | ja | ko

@@ -139,6 +140,7 @@

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_authz_owner.html.fr b/docs/manual/mod/mod_authz_owner.html.fr new file mode 100644 index 0000000000..6a105d90e4 --- /dev/null +++ b/docs/manual/mod/mod_authz_owner.html.fr @@ -0,0 +1,162 @@ + + + +mod_authz_owner - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_authz_owner

Langues Disponibles: en | + fr | + ja | + ko

+ + + + +

Description:	Autorisation basée sur l'appartenance des +fichiers
Statut:	Extension
Identificateur de Module:	authz_owner_module
Fichier Source:	mod_authz_owner.c
Compatibilité:	Disponible depuis les versions 2.1 et supérieures +d'Apache

Sommaire

+ +

Ce module permet de contrôler l'accès aux fichiers en comparant + l'identifiant utilisateur ayant servi à l'authentification HTTP + (l'identifiant utilisateur web) avec le propriétaire ou le groupe + du fichier demandé du point de vue du système de fichiers. Le nom + d'utilisateur et le mot de passe doivent déjà avoir été vérifiés par + un module d'authentification comme mod_auth_basic + ou mod_auth_digest. + mod_authz_owner reconnaît deux arguments pour la + directive Require : + file-owner et file-group :

+ +

file-owner: Le nom d'utilisateur web utilisé pour l'authentification doit + correspondre au nom système du propriétaire du fichier demandé. En + d'autres termes, si le système indique jones comme + propriétaire du fichier demandé, le nom d'utilisateur fourni pour + l'authentification HTTP doit aussi être jones.
file-group: Le nom du groupe système du fichier demandé doit être présent + dans une base de données de groupes fournie, par exemple, par + mod_authz_groupfile ou + mod_authz_dbm, et le nom d'utilisateur web fourni + pour l'authentification doit être un membre de ce groupe. Par + exemple, si le système indique que le groupe (système) du fichier + demandé est accounts, le groupe accounts + doit apparaître dans la base de données des groupes, et le nom + d'utilisateur web utilisé pour l'authentification doit être un + membre de ce groupe.

+ +

Note

Si le module mod_authz_owner est utilisé pour + vérifier l'autorisation d'accès à une ressource qui n'est pas + vraiment présente dans le système de fichiers (en d'autres termes + une ressource virtuelle), il refusera l'accès.

+ +

En particulier, il n'accordera jamais l'accès à une ressource + du type "Vues + multiples" (MultiViews) d'un contenu négocié.

Directives

Ce module ne fournit aucune directive.

Sujets

Exemples de configuration

Voir aussi

Require

Exemples de configuration

+ +

Require file-owner

Considérons un serveur Web Apache fonctionnant sous un système + multi-utilisateurs, où les fichiers de chaque utilisateur sont + stockés dans ~/public_html/private. En supposant + qu'il n'existe qu'une seule base de données contenant les noms + d'utilisateurs web, et que ces noms d'utilisateurs correspondent + aux noms d'utilisateurs système qui sont les propriétaires + effectifs des fichiers, la configuration de l'exemple suivant + n'accordera l'autorisation d'accès aux fichiers qu'à leur + propriétaire. L'utilisateur jones ne sera pas + autorisé à accéder aux fichiers situés dans + /home/smith/public_html/private, à moins que leur + propriétaire ne soit jones au lieu de + smith.

+ +

+ <Directory /home/*/public_html/private> + + AuthType Basic + AuthName mes-fichiers-prive + AuthBasicProvider dbm + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all + Require file-owner + + </Directory> +

+ + +

Require file-group

Considérons un système similaire à celui décrit ci-dessus, mais + où certains utilisateurs partagent leurs fichiers de projets dans + ~/public_html/project-foo. Le groupe système des + fichiers est foo, et il n'existe qu'une seule base de + données AuthDBMGroupFile qui contient + tous les noms d'utilisateurs web et leurs groupes d'appartenance. + Ces noms d'utilisateurs web doivent alors appartenir au moins au + groupe foo. En d'autres termes, si jones + et smith sont tous deux membres du groupe + foo, ils seront autorisés à accéder aux + répertoires project-foo de chacun d'entre eux.

+ +

+ <Directory /home/*/public_html/project-foo> + + AuthType Basic + AuthName "Project Foo Files" + AuthBasicProvider dbm + + # combined user/group database + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all + AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all + + Satisfy All + Require file-group + + </Directory> +

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_authz_owner.xml.fr b/docs/manual/mod/mod_authz_owner.xml.fr new file mode 100644 index 0000000000..914e5171e9 --- /dev/null +++ b/docs/manual/mod/mod_authz_owner.xml.fr @@ -0,0 +1,146 @@ + + + + + + + + + + + + +mod_authz_owner +Autorisation basée sur l'appartenance des +fichiers +Extension +mod_authz_owner.c +authz_owner_module +Disponible depuis les versions 2.1 et supérieures +d'Apache + +

Ce module permet de contrôler l'accès aux fichiers en comparant + l'identifiant utilisateur ayant servi à l'authentification HTTP + (l'identifiant utilisateur web) avec le propriétaire ou le groupe + du fichier demandé du point de vue du système de fichiers. Le nom + d'utilisateur et le mot de passe doivent déjà avoir été vérifiés par + un module d'authentification comme mod_auth_basic + ou mod_auth_digest. + mod_authz_owner reconnaît deux arguments pour la + directive Require : + file-owner et file-group :

+ +

file-owner: Le nom d'utilisateur web utilisé pour l'authentification doit + correspondre au nom système du propriétaire du fichier demandé. En + d'autres termes, si le système indique jones comme + propriétaire du fichier demandé, le nom d'utilisateur fourni pour + l'authentification HTTP doit aussi être jones.
file-group: Le nom du groupe système du fichier demandé doit être présent + dans une base de données de groupes fournie, par exemple, par + mod_authz_groupfile ou + mod_authz_dbm, et le nom d'utilisateur web fourni + pour l'authentification doit être un membre de ce groupe. Par + exemple, si le système indique que le groupe (système) du fichier + demandé est accounts, le groupe accounts + doit apparaître dans la base de données des groupes, et le nom + d'utilisateur web utilisé pour l'authentification doit être un + membre de ce groupe.

+ + Note +

Si le module mod_authz_owner est utilisé pour + vérifier l'autorisation d'accès à une ressource qui n'est pas + vraiment présente dans le système de fichiers (en d'autres termes + une ressource virtuelle), il refusera l'accès.

+ +

En particulier, il n'accordera jamais l'accès à une ressource + du type "Vues + multiples" (MultiViews) d'un contenu négocié.

+ +

+Require + +

Exemples de configuration + +

Require file-owner +

+ + + <Directory /home/*/public_html/private>
+ + AuthType Basic
+ AuthName mes-fichiers-prive
+ AuthBasicProvider dbm
+ AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
+ Require file-owner
+ + </Directory> + +

+ +

Require file-group +

Considérons un système similaire à celui décrit ci-dessus, mais + où certains utilisateurs partagent leurs fichiers de projets dans + ~/public_html/project-foo. Le groupe système des + fichiers est foo, et il n'existe qu'une seule base de + données AuthDBMGroupFile qui contient + tous les noms d'utilisateurs web et leurs groupes d'appartenance. + Ces noms d'utilisateurs web doivent alors appartenir au moins au + groupe foo. En d'autres termes, si jones + et smith sont tous deux membres du groupe + foo, ils seront autorisés à accéder aux + répertoires project-foo de chacun d'entre eux.

+ + + <Directory /home/*/public_html/project-foo>
+ + AuthType Basic
+ AuthName "Project Foo Files"
+ AuthBasicProvider dbm
+
+ # combined user/group database
+ AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
+ AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all
+
+ Satisfy All
+ Require file-group
+ + </Directory> + +

+ + diff --git a/docs/manual/mod/mod_authz_owner.xml.meta b/docs/manual/mod/mod_authz_owner.xml.meta index 4c449c23ff..949ea64125 100644 --- a/docs/manual/mod/mod_authz_owner.xml.meta +++ b/docs/manual/mod/mod_authz_owner.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_authz_user.html b/docs/manual/mod/mod_authz_user.html index e0ec3cc654..82294b4184 100644 --- a/docs/manual/mod/mod_authz_user.html +++ b/docs/manual/mod/mod_authz_user.html @@ -4,6 +4,10 @@ URI: mod_authz_user.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_authz_user.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_authz_user.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authz_user.html.en b/docs/manual/mod/mod_authz_user.html.en index 63c6f25b51..efc912c3e2 100644 --- a/docs/manual/mod/mod_authz_user.html.en +++ b/docs/manual/mod/mod_authz_user.html.en @@ -22,6 +22,7 @@

Apache Module mod_authz_user

Available Languages: en | + fr | ja | ko

@@ -50,6 +51,7 @@

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_authz_user.html.fr b/docs/manual/mod/mod_authz_user.html.fr new file mode 100644 index 0000000000..73f6a00039 --- /dev/null +++ b/docs/manual/mod/mod_authz_user.html.fr @@ -0,0 +1,61 @@ + + + +mod_authz_user - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_authz_user

Langues Disponibles: en | + fr | + ja | + ko

+ + + + +

Description:	Autorisation basée sur l'utilisateur
Statut:	Base
Identificateur de Module:	authz_user_module
Fichier Source:	mod_authz_user.c
Compatibilité:	Disponible depuis les versions 2.1 et supérieures +d'Apache

Sommaire

+ +

Ce module permet d'accorder ou de refuser l'accès à certaines + zones du site web aux utilisateurs authentifiés. + mod_authz_user accorde l'accès si l'utilisateur + authentifié fait partie de la liste spécifiée par une directive + Require user. On peut aussi utiliser la directive + Require valid-user pour accorder l'accès à tous les + utilisateurs qui ont été authentifiés avec succès.

Directives

Ce module ne fournit aucune directive.

Voir aussi

Require

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_authz_user.xml.fr b/docs/manual/mod/mod_authz_user.xml.fr new file mode 100644 index 0000000000..05b3a6ef31 --- /dev/null +++ b/docs/manual/mod/mod_authz_user.xml.fr @@ -0,0 +1,46 @@ + + + + + + + + + + + +mod_authz_user +Autorisation basée sur l'utilisateur +Base +mod_authz_user.c +authz_user_module +Disponible depuis les versions 2.1 et supérieures +d'Apache + +

Ce module permet d'accorder ou de refuser l'accès à certaines + zones du site web aux utilisateurs authentifiés. + mod_authz_user accorde l'accès si l'utilisateur + authentifié fait partie de la liste spécifiée par une directive + Require user. On peut aussi utiliser la directive + Require valid-user pour accorder l'accès à tous les + utilisateurs qui ont été authentifiés avec succès.

+Require + + diff --git a/docs/manual/mod/mod_authz_user.xml.meta b/docs/manual/mod/mod_authz_user.xml.meta index 5b8a9fca59..dd1e0c706e 100644 --- a/docs/manual/mod/mod_authz_user.xml.meta +++ b/docs/manual/mod/mod_authz_user.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_buffer.html b/docs/manual/mod/mod_buffer.html index e427e44f19..8f90c41661 100644 --- a/docs/manual/mod/mod_buffer.html +++ b/docs/manual/mod/mod_buffer.html @@ -3,3 +3,7 @@ URI: mod_buffer.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_buffer.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_buffer.html.en b/docs/manual/mod/mod_buffer.html.en index 60ea0f20c9..d565745e31 100644 --- a/docs/manual/mod/mod_buffer.html.en +++ b/docs/manual/mod/mod_buffer.html.en @@ -21,7 +21,8 @@

Apache Module mod_buffer

Available Languages: en

Available Languages: en | + fr

@@ -94,7 +95,8 @@

Available Languages: en

Available Languages: en | + fr

diff --git a/docs/manual/mod/mod_buffer.html.fr b/docs/manual/mod/mod_buffer.html.fr new file mode 100644 index 0000000000..7053daa81a --- /dev/null +++ b/docs/manual/mod/mod_buffer.html.fr @@ -0,0 +1,106 @@ + + + +mod_buffer - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_buffer

Langues Disponibles: en | + fr

Description:	Support for request buffering
Status:	Extension

+ + + +

Description:	Support de la mise en tampon des requêtes
Statut:	Extension
Identificateur de Module:	buffer_module
Fichier Source:	mod_buffer.c
Compatibilité:	Disponible depuis les versions 2.3 et supérieures +d'Apache

Sommaire

+ +

Ce module fournit la possibilité de mettre en tampon les piles + des filtres en entrée et sortie.

+ +

Dans certaines situations, les générateurs de contenu créent des + contenus composés de petits tronçons. Afin de permettre la + réutilisation de la mémoire, les éléments de mémoire attribués aux + tronçons ont toujours une taille de 8k, quelle que soit la taille du + tronçon lui-même. Lorsqu'une requête génère de nombreux petits + tronçons, une grande quantité de mémoire peut être mobilisée par le + traitement de la requête, et une grande quantité de données + transmises sans nécessité. Pour y remédier, l'utilisation d'un + tampon rassemble la réponse en un nombre de tronçons le plus petit + possible.

+ +

Lorsque httpd est utilisé comme frontal d'un générateur de + contenu consommant beaucoup de ressources, la mise en tampon de la + réponse peut permettre à ce dernier d'effectuer le traitement et de + libérer les ressources plus ou moins rapidement, en fonction de la + manière dont il a été conçu.

+ +

Le filtre de mise en tampon peut être ajouté aux piles des + filtres en entrée ou en sortie, selon les besoins, à l'aide des + directives SetInputFilter, + SetOutputFilter, AddOutputFilter ou AddOutputFilterByType.

+ +

Utilisation d'un tampon avec mod_include

+ AddOutputFilterByType INCLUDES;BUFFER text/html +

+ +

Les filtres de mise en tampon lisent la + requête/réponse en RAM, puis la reconditionnent sous la forme d'un + nombre d'éléments mémoire le plus petit possible, au prix d'une + consommation de temps CPU. Lorsque la requête/réponse est déjà + conditionnée de manière satisfaisante, sa mise en tampon pourrait + s'avérer encore plus lente qu'en l'absence d'utilisation de tampon. + C'est pourquoi ces filtres doivent être utilisés avec précautions, + et seulement si nécessaire.

+ +

Directives

BufferSize

Voir aussi

Les filtres

+ +

BufferSize Directive

+ + + + + + + +

Description:	Taille maximale en octets du filtre par tampon
Syntaxe:	`BufferSize entier`
Défaut:	`BufferSize 131072`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Statut:	Extension
Module:	mod_buffer

La directive BufferSize permet de spécifier la + quantité de données en octets qui sera mise en tampon avant d'être + lue depuis ou écrite vers chaque requête. La valeur par défaut est + 128 ko.

+ +

Langues Disponibles: en | + fr

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_buffer.xml.fr b/docs/manual/mod/mod_buffer.xml.fr new file mode 100644 index 0000000000..4fe8e5da1d --- /dev/null +++ b/docs/manual/mod/mod_buffer.xml.fr @@ -0,0 +1,99 @@ + + + + + + + + + + + +mod_buffer +Support de la mise en tampon des requêtes +Extension +mod_buffer.c +buffer_module +Disponible depuis les versions 2.3 et supérieures +d'Apache + +

Ce module fournit la possibilité de mettre en tampon les piles + des filtres en entrée et sortie.

+ +

Le filtre de mise en tampon peut être ajouté aux piles des + filtres en entrée ou en sortie, selon les besoins, à l'aide des + directives SetInputFilter, + SetOutputFilter, AddOutputFilter ou AddOutputFilterByType.

+ + Utilisation d'un tampon avec mod_include + AddOutputFilterByType INCLUDES;BUFFER text/html
+ + + Les filtres de mise en tampon lisent la + requête/réponse en RAM, puis la reconditionnent sous la forme d'un + nombre d'éléments mémoire le plus petit possible, au prix d'une + consommation de temps CPU. Lorsque la requête/réponse est déjà + conditionnée de manière satisfaisante, sa mise en tampon pourrait + s'avérer encore plus lente qu'en l'absence d'utilisation de tampon. + C'est pourquoi ces filtres doivent être utilisés avec précautions, + et seulement si nécessaire. + +

+Les filtres + + +BufferSize +Taille maximale en octets du filtre par tampon +BufferSize entier +BufferSize 131072 +server config +virtual host +directory +.htaccess + + + +

La directive BufferSize permet de spécifier la + quantité de données en octets qui sera mise en tampon avant d'être + lue depuis ou écrite vers chaque requête. La valeur par défaut est + 128 ko.

+ + + + diff --git a/docs/manual/mod/mod_buffer.xml.meta b/docs/manual/mod/mod_buffer.xml.meta index 8b2eb8efd8..7e26364e54 100644 --- a/docs/manual/mod/mod_buffer.xml.meta +++ b/docs/manual/mod/mod_buffer.xml.meta @@ -8,5 +8,6 @@ en + fr diff --git a/docs/manual/mod/mod_dir.html.fr b/docs/manual/mod/mod_dir.html.fr index 5092791bde..f3d2d29e3e 100644 --- a/docs/manual/mod/mod_dir.html.fr +++ b/docs/manual/mod/mod_dir.html.fr @@ -59,37 +59,12 @@ de r

Directives

DefaultMapping
DirectoryIndex
DirectorySlash
FallbackResource

DefaultMapping Directive

- - - - - - - - -

Description:	Définit une URL par défaut pour les requêtes qui ne ciblent -aucun fichier
Syntaxe:	`DefaultMapping url-locale`
Défaut:	`Aucune - httpd renvoie un code d'erreur 404 (Not Found)`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	Indexes
Statut:	Base
Module:	mod_dir

Cette directive permet de définir un traitement pour toute URL - qui ne correspond à aucune ressource de votre système de fichiers, - et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404 - (Not Found). - Par exemple

- DefaultMapping default.php -

fait en sorte que les requêtes ne correspondant à aucun fichier - soient traitées par default.php, sans affecter les - requêtes pour des fichiers existants.

- -

DirectoryIndex Directive

@@ -209,6 +184,46 @@ d'Apache répertoire.

+ +

FallbackResource Directive

+ + + + + + + +

Description:	Définit une URL par défaut pour les requêtes qui ne ciblent +aucun fichier
Syntaxe:	`FallbackResource url-locale`
Défaut:	`Aucune - httpd renvoie un code d'erreur 404 (Not Found)`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	Indexes
Statut:	Base
Module:	mod_dir

Cette directive permet de définir un traitement pour toute URL + qui ne correspond à aucune ressource de votre système de fichiers, + et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404 + (Not Found). + Par exemple

+ FallbackResource non-404.php +

fait en sorte que les requêtes ne correspondant à aucun fichier + soient traitées par non-404.php, sans affecter les + requêtes pour des fichiers existants.

Il est souvent souhaitable qu'un seul fichier ou ressource traite + toutes les requêtes à destination d'un répertoire + particulier, sauf pour les requêtes qui correspondent à un fichier + ou script existant. On y fait souvent référence sous le terme + 'contrôleur frontal'.

Dans les versions plus anciennes de httpd, cet effet nécessitait + en général mod_rewrite, et l'utilisation des tests + conditionnels -f et -d pour vérifier + l'existence des fichiers et répertoires. Maintenant, une seule ligne + de configuration est nécessaire.

+ FallbackResource index.php +

Les fichiers existants comme des images, des fichiers css, etc... + seront traités normalement.

diff --git a/docs/manual/mod/mod_dir.xml.fr b/docs/manual/mod/mod_dir.xml.fr index 0a5e538acb..7e1d80d147 100644 --- a/docs/manual/mod/mod_dir.xml.fr +++ b/docs/manual/mod/mod_dir.xml.fr @@ -1,7 +1,7 @@ - + @@ -178,10 +178,10 @@ d'Apache -DefaultMapping +FallbackResource Définit une URL par défaut pour les requêtes qui ne ciblent aucun fichier -DefaultMapping url-locale +FallbackResource url-locale Aucune - httpd renvoie un code d'erreur 404 (Not Found) server configvirtual host directory.htaccess @@ -193,11 +193,26 @@ aucun fichier (Not Found). Par exemple

- DefaultMapping default.php + FallbackResource non-404.php

fait en sorte que les requêtes ne correspondant à aucun fichier - soient traitées par default.php, sans affecter les + soient traitées par non-404.php, sans affecter les requêtes pour des fichiers existants.

Dans les versions plus anciennes de httpd, cet effet nécessitait + en général mod_rewrite, et l'utilisation des tests + conditionnels -f et -d pour vérifier + l'existence des fichiers et répertoires. Maintenant, une seule ligne + de configuration est nécessaire.

+ + FallbackResource index.php + +

Les fichiers existants comme des images, des fichiers css, etc... + seront traités normalement.

diff --git a/docs/manual/mod/mod_disk_cache.html b/docs/manual/mod/mod_disk_cache.html index 614907d5ce..7d9c1d0a58 100644 --- a/docs/manual/mod/mod_disk_cache.html +++ b/docs/manual/mod/mod_disk_cache.html @@ -4,6 +4,10 @@ URI: mod_disk_cache.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_disk_cache.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_disk_cache.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_disk_cache.html.en b/docs/manual/mod/mod_disk_cache.html.en index 62f3916770..0b5d6e9010 100644 --- a/docs/manual/mod/mod_disk_cache.html.en +++ b/docs/manual/mod/mod_disk_cache.html.en @@ -22,6 +22,7 @@

Apache Module mod_disk_cache

Available Languages: en | + fr | ja | ko

@@ -184,6 +185,7 @@ stored

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_disk_cache.html.fr b/docs/manual/mod/mod_disk_cache.html.fr new file mode 100644 index 0000000000..4121363714 --- /dev/null +++ b/docs/manual/mod/mod_disk_cache.html.fr @@ -0,0 +1,205 @@ + + + +mod_disk_cache - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_disk_cache

Langues Disponibles: en | + fr | + ja | + ko

+ + + +

Description:	Gestionnaire de stockage du cache de contenu à base +d'URIs
Statut:	Extension
Identificateur de Module:	disk_cache_module
Fichier Source:	mod_disk_cache.c

Sommaire

+ +

mod_disk_cache implémente un gestionnaire de + stockage sur disque. Il s'utilise principalement avec + mod_cache.

+ +

Les contenus sont stockés dans le cache et extraits de ce dernier + en utilisant des clés à base d'URIs. Les contenus dont l'accès est + protégé ne sont pas mis en cache.

+ +

Le programme htcacheclean permet de maintenir + la taille du cache à un niveau maximum.

+ +

Note :

mod_cache doit être chargé pour que + mod_disk_cache puisse fonctionner.

Lorsque la plate-forme la supporte, et si elle est activée via la + directive EnableSendfile, + mod_disk_cache utilise la fonctionnalité sendfile + pour servir les fichiers à partir du cache. Cependant, + mod_disk_cache ignore la configuration de la + directive EnableSendfile dans + un contexte de répertoire ou de fichier .htaccess, car le module ne + dispose pas des définitions correspondantes lorsque la requête est + servie depuis le cache.

Directives

CacheDirLength
CacheDirLevels
CacheMaxFileSize
CacheMinFileSize
CacheRoot

+ +

CacheDirLength Directive

+ + + + + + + +

Description:	Le nombre de caractères des noms des +sous-répertoires
Syntaxe:	`CacheDirLength longueur`
Défaut:	`CacheDirLength 2`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_disk_cache

la directive CacheDirLength permet de + définir le nombre de caractères que comportera chaque nom de + sous-répertoire de la hiérarchie du cache. On peut l'utiliser en + conjonction avec CacheDirLevels pour + déterminer une structure approximative de la hiérarchie de + cache.

Une valeur haute pour CacheDirLength + combinée avec une valeur basse pour + CacheDirLevels générera une hiérarchie + relativement peu profonde, avec un grand nombre de sous-répertoires + à chaque niveau.

+ +

La valeur du produit CacheDirLevels * + CacheDirLength ne + doit pas dépasser 20.

+ + +

CacheDirLevels Directive

+ + + + + + + +

Description:	Le nombre de niveaux de sous-répertoires que comportera le +cache.
Syntaxe:	`CacheDirLevels niveaux`
Défaut:	`CacheDirLevels 2`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_disk_cache

La directive CacheDirLevels permet de + définir le nombre de niveaux de sous-répertoires que comportera le + cache. Les données du cache seront stokées au niveau correspondant + par rapport au répertoire CacheRoot.

Une valeur haute pour CacheDirLevels + combinée avec une valeur basse pour + CacheDirLength générera une arborescence + très développée, avec un petit nombre de sous-répertoires à chaque + niveau.

+ +

La valeur du produit CacheDirLevels * + CacheDirLength ne + doit pas dépasser 20.

+ + +

CacheMaxFileSize Directive

+ + + + + + + +

Description:	>La taille maximale (en octets) d'un document pour pouvoir +être stocké dans le cache
Syntaxe:	`CacheMaxFileSize octets`
Défaut:	`CacheMaxFileSize 1000000`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_disk_cache

La directive CacheMaxFileSize permet de + définir la taille maximale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.

+ +

+ CacheMaxFileSize 64000 +

+ +

CacheMinFileSize Directive

+ + + + + + + +

Description:	La taille minimale (en octets) d'un document pour pouvoir +être stocké dans le cache
Syntaxe:	`CacheMinFileSize octets`
Défaut:	`CacheMinFileSize 1`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_disk_cache

La directive CacheMinFileSize permet de + définir la taille minimale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.

+ +

+ CacheMinFileSize 64 +

+ +

CacheRoot Directive

+ + + + + + +

Description:	La racine du répertoire dans lequel les fichiers du cache +seront stockés
Syntaxe:	`CacheRoot répertoire`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_disk_cache

La directive CacheRoot permet de définir + le nom du répertoire sur disque qui contiendra les fichiers du + cache. Si le module mod_disk_cache a été chargé ou + compilé dans le serveur Apache, cette directive doit être + définie. L'absence de définition de la directive + CacheRoot provoquera une erreur de traitement + du fichier de configuration. Les directives CacheDirLevels et CacheDirLength permettent de + définir la structure des sous-répertoires du répertoire racine + spécifié.

+ +

+ CacheRoot c:/cacheroot +

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_disk_cache.xml.fr b/docs/manual/mod/mod_disk_cache.xml.fr new file mode 100644 index 0000000000..60bc46234b --- /dev/null +++ b/docs/manual/mod/mod_disk_cache.xml.fr @@ -0,0 +1,189 @@ + + + + + + + + + + + +mod_disk_cache +Gestionnaire de stockage du cache de contenu à base +d'URIs +Extension +mod_disk_cache.c +disk_cache_module + +

mod_disk_cache implémente un gestionnaire de + stockage sur disque. Il s'utilise principalement avec + mod_cache.

+ +

Les contenus sont stockés dans le cache et extraits de ce dernier + en utilisant des clés à base d'URIs. Les contenus dont l'accès est + protégé ne sont pas mis en cache.

+ +

Le programme htcacheclean permet de maintenir + la taille du cache à un niveau maximum.

+ + Note : +

mod_cache doit être chargé pour que + mod_disk_cache puisse fonctionner.

+ +

Lorsque la plate-forme la supporte, et si elle est activée via la + directive EnableSendfile, + mod_disk_cache utilise la fonctionnalité sendfile + pour servir les fichiers à partir du cache. Cependant, + mod_disk_cache ignore la configuration de la + directive EnableSendfile dans + un contexte de répertoire ou de fichier .htaccess, car le module ne + dispose pas des définitions correspondantes lorsque la requête est + servie depuis le cache.

+ + +CacheRoot +La racine du répertoire dans lequel les fichiers du cache +seront stockés +CacheRoot répertoire +server configvirtual host + + + +

La directive CacheRoot permet de définir + le nom du répertoire sur disque qui contiendra les fichiers du + cache. Si le module mod_disk_cache a été chargé ou + compilé dans le serveur Apache, cette directive doit être + définie. L'absence de définition de la directive + CacheRoot provoquera une erreur de traitement + du fichier de configuration. Les directives CacheDirLevels et CacheDirLength permettent de + définir la structure des sous-répertoires du répertoire racine + spécifié.

+ + + CacheRoot c:/cacheroot + + + + + +CacheDirLevels +Le nombre de niveaux de sous-répertoires que comportera le +cache. +CacheDirLevels niveaux +CacheDirLevels 2 +server configvirtual host + + + +

La directive CacheDirLevels permet de + définir le nombre de niveaux de sous-répertoires que comportera le + cache. Les données du cache seront stokées au niveau correspondant + par rapport au répertoire CacheRoot.

Une valeur haute pour CacheDirLevels + combinée avec une valeur basse pour + CacheDirLength générera une arborescence + très développée, avec un petit nombre de sous-répertoires à chaque + niveau.

+ + +

La valeur du produit CacheDirLevels * + CacheDirLength ne + doit pas dépasser 20.

+ + + + + + +CacheDirLength +Le nombre de caractères des noms des +sous-répertoires +CacheDirLength longueur +CacheDirLength 2 +server configvirtual host + + + +

la directive CacheDirLength permet de + définir le nombre de caractères que comportera chaque nom de + sous-répertoire de la hiérarchie du cache. On peut l'utiliser en + conjonction avec CacheDirLevels pour + déterminer une structure approximative de la hiérarchie de + cache.

Une valeur haute pour CacheDirLength + combinée avec une valeur basse pour + CacheDirLevels générera une hiérarchie + relativement peu profonde, avec un grand nombre de sous-répertoires + à chaque niveau.

+ + +

La valeur du produit CacheDirLevels * + CacheDirLength ne + doit pas dépasser 20.

+ + + + + + +CacheMinFileSize +La taille minimale (en octets) d'un document pour pouvoir +être stocké dans le cache +CacheMinFileSize octets +CacheMinFileSize 1 +server configvirtual host + + + +

La directive CacheMinFileSize permet de + définir la taille minimale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.

+ + + CacheMinFileSize 64 + + + + + +CacheMaxFileSize +>La taille maximale (en octets) d'un document pour pouvoir +être stocké dans le cache +CacheMaxFileSize octets +CacheMaxFileSize 1000000 +server configvirtual host + + + +

La directive CacheMaxFileSize permet de + définir la taille maximale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.

+ + + CacheMaxFileSize 64000 + + + + + diff --git a/docs/manual/mod/mod_disk_cache.xml.meta b/docs/manual/mod/mod_disk_cache.xml.meta index c05ae2f84d..f2adf7a421 100644 --- a/docs/manual/mod/mod_disk_cache.xml.meta +++ b/docs/manual/mod/mod_disk_cache.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_echo.html b/docs/manual/mod/mod_echo.html index fb021cc78d..c10e97b491 100644 --- a/docs/manual/mod/mod_echo.html +++ b/docs/manual/mod/mod_echo.html @@ -4,6 +4,10 @@ URI: mod_echo.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_echo.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_echo.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_echo.html.en b/docs/manual/mod/mod_echo.html.en index 2081f54c20..f1543892db 100644 --- a/docs/manual/mod/mod_echo.html.en +++ b/docs/manual/mod/mod_echo.html.en @@ -22,6 +22,7 @@

Apache Module mod_echo

Available Languages: en | + fr | ja | ko

@@ -66,6 +67,7 @@ later.

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_echo.html.fr b/docs/manual/mod/mod_echo.html.fr new file mode 100644 index 0000000000..db6fb4fbfd --- /dev/null +++ b/docs/manual/mod/mod_echo.html.fr @@ -0,0 +1,76 @@ + + + +mod_echo - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_echo

Langues Disponibles: en | + fr | + ja | + ko

+ + + + +

Description:	Un simple serveur d'écho pour illustrer les modules de +protocole
Statut:	Expérimental
Identificateur de Module:	echo_module
Fichier Source:	mod_echo.c
Compatibilité:	Disponible depuis la version 2.0 d'Apache

Sommaire

+ +

Ce module est un module de protocole exemple permettant d'en + illustrer le concept. Il fournit un simple serveur d'écho. Envoyez + lui une phrase par telnet, et il vous la renverra.

Directives

ProtocolEcho

+ +

ProtocolEcho Directive

+ + + + + + + + +

Description:	Active ou désactive le serveur d'écho
Syntaxe:	`ProtocolEcho On\|Off`
Défaut:	`ProtocolEcho Off`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Expérimental
Module:	mod_echo
Compatibilité:	ProtocolEcho est disponible depuis la version 2.0 +d'Apache.

La directive ProtocolEcho permet d'activer + ou de désactiver le serveur d'écho.

+ +

Exemple

+ ProtocolEcho On +

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_echo.xml.fr b/docs/manual/mod/mod_echo.xml.fr new file mode 100644 index 0000000000..3564f39e7d --- /dev/null +++ b/docs/manual/mod/mod_echo.xml.fr @@ -0,0 +1,63 @@ + + + + + + + + + + + +mod_echo +Un simple serveur d'écho pour illustrer les modules de +protocole +Experimental +mod_echo.c +echo_module +Disponible depuis la version 2.0 d'Apache + +

Ce module est un module de protocole exemple permettant d'en + illustrer le concept. Il fournit un simple serveur d'écho. Envoyez + lui une phrase par telnet, et il vous la renverra.

+ + + +ProtocolEcho +Active ou désactive le serveur d'écho +ProtocolEcho On|Off +ProtocolEcho Off +server config +virtual host +ProtocolEcho est disponible depuis la version 2.0 +d'Apache. + + +

La directive ProtocolEcho permet d'activer + ou de désactiver le serveur d'écho.

+ + Exemple + ProtocolEcho On + + + + + + diff --git a/docs/manual/mod/mod_echo.xml.meta b/docs/manual/mod/mod_echo.xml.meta index 4c51a4eb6f..760acb096f 100644 --- a/docs/manual/mod/mod_echo.xml.meta +++ b/docs/manual/mod/mod_echo.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_env.html b/docs/manual/mod/mod_env.html index df9103110e..98ef2d976a 100644 --- a/docs/manual/mod/mod_env.html +++ b/docs/manual/mod/mod_env.html @@ -4,6 +4,10 @@ URI: mod_env.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_env.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_env.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_env.html.en b/docs/manual/mod/mod_env.html.en index 59de5c4b76..0a744a34ec 100644 --- a/docs/manual/mod/mod_env.html.en +++ b/docs/manual/mod/mod_env.html.en @@ -22,6 +22,7 @@

Apache Module mod_env

Available Languages: en | + fr | ja | ko | tr

@@ -110,6 +111,7 @@ SSI pages

Available Languages: en | + fr | ja | ko | tr

diff --git a/docs/manual/mod/mod_env.html.fr b/docs/manual/mod/mod_env.html.fr new file mode 100644 index 0000000000..a4be31ecde --- /dev/null +++ b/docs/manual/mod/mod_env.html.fr @@ -0,0 +1,122 @@ + + + +mod_env - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_env

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ + + +

Description:	Modifie l'environnement transmis aux scripts CGI et aux +pages SSI
Statut:	Base
Identificateur de Module:	env_module
Fichier Source:	mod_env.c

Sommaire

+ +

Ce module permet de contrôler l'environnement transmis aux + scripts CGI et aux pages SSI. Les variables d'environnement peuvent + être transmises depuis le shell qui a lancé le processus + httpd. Elles peuvent également être définies ou + supprimées au cours du processus de configuration.

Directives

PassEnv
SetEnv
UnsetEnv

Voir aussi

Variables d'environnement

+ +

PassEnv Directive

+ + + + + + + +

Description:	Transmet des variables d'environnement depuis le +shell
Syntaxe:	`PassEnv var-env [var-env] +...`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_env

Spécifie une ou plusieurs variables d'environnement à transmettre + aux scripts CGI et aux pages SSI depuis l'environnement du shell qui + a lancé le processus httpd.

+ +

Exemple

+ PassEnv LD_LIBRARY_PATH +

+ +

SetEnv Directive

+ + + + + + + +

Description:	Définit des variables d'environnement
Syntaxe:	`SetEnv var-env valeur`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_env

Définit une variable d'environnement, cette dernière étant + ensuite transmise aux scripts CGI et aux pages SSI.

+ +

Exemple

+ SetEnv SPECIAL_PATH /foo/bin +

+ +

UnsetEnv Directive

+ + + + + + + +

Description:	Supprime des variables de l'environnement
Syntaxe:	`UnsetEnv var-env [var-env] +...`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_env

Supprime une ou plusieurs variables d'environnement parmi celles + qui sont transmises aux scripts CGI et aux pages SSI.

+ +

Exemple

+ UnsetEnv LD_LIBRARY_PATH +

+ +

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_env.xml.fr b/docs/manual/mod/mod_env.xml.fr new file mode 100644 index 0000000000..551dee8975 --- /dev/null +++ b/docs/manual/mod/mod_env.xml.fr @@ -0,0 +1,101 @@ + + + + + + + + + + + +mod_env +Modifie l'environnement transmis aux scripts CGI et aux +pages SSI +Base +mod_env.c +env_module +

Ce module permet de contrôler l'environnement transmis aux + scripts CGI et aux pages SSI. Les variables d'environnement peuvent + être transmises depuis le shell qui a lancé le processus + httpd. Elles peuvent également être définies ou + supprimées au cours du processus de configuration.

+Variables d'environnement + + +PassEnv +Transmet des variables d'environnement depuis le +shell +PassEnv var-env [var-env] +... +server configvirtual host +directory.htaccess +FileInfo + + +

Spécifie une ou plusieurs variables d'environnement à transmettre + aux scripts CGI et aux pages SSI depuis l'environnement du shell qui + a lancé le processus httpd.

+ + Exemple + PassEnv LD_LIBRARY_PATH + + + + + +SetEnv +Définit des variables d'environnement +SetEnv var-env valeur +server configvirtual host +directory.htaccess +FileInfo + + +

Définit une variable d'environnement, cette dernière étant + ensuite transmise aux scripts CGI et aux pages SSI.

+ + Exemple + SetEnv SPECIAL_PATH /foo/bin + + + + + +UnsetEnv +Supprime des variables de l'environnement +UnsetEnv var-env [var-env] +... +server configvirtual host +directory.htaccess +FileInfo + + +

Supprime une ou plusieurs variables d'environnement parmi celles + qui sont transmises aux scripts CGI et aux pages SSI.

+ + Exemple + UnsetEnv LD_LIBRARY_PATH + + + + + + diff --git a/docs/manual/mod/mod_env.xml.meta b/docs/manual/mod/mod_env.xml.meta index b5ee37525e..0b34bdab14 100644 --- a/docs/manual/mod/mod_env.xml.meta +++ b/docs/manual/mod/mod_env.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko tr diff --git a/docs/manual/mod/mod_ident.html b/docs/manual/mod/mod_ident.html index ed28d2acc8..b6f2cea8a1 100644 --- a/docs/manual/mod/mod_ident.html +++ b/docs/manual/mod/mod_ident.html @@ -4,6 +4,10 @@ URI: mod_ident.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_ident.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_ident.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_ident.html.en b/docs/manual/mod/mod_ident.html.en index 539c2814fc..a5a2ebec4f 100644 --- a/docs/manual/mod/mod_ident.html.en +++ b/docs/manual/mod/mod_ident.html.en @@ -22,6 +22,7 @@

Apache Module mod_ident

Available Languages: en | + fr | ja | ko

@@ -95,6 +96,7 @@ user

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_ident.html.fr b/docs/manual/mod/mod_ident.html.fr new file mode 100644 index 0000000000..7023e1a1af --- /dev/null +++ b/docs/manual/mod/mod_ident.html.fr @@ -0,0 +1,114 @@ + + + +mod_ident - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_ident

Langues Disponibles: en | + fr | + ja | + ko

+ + + + +

Description:	Recherche d'identité conformément à la RFC +1413
Statut:	Extension
Identificateur de Module:	ident_module
Fichier Source:	mod_ident.c
Compatibilité:	Disponible depuis la version 2.2 d'Apache

Sommaire

+ +

Ce module interroge un démon compatible RFC 1413 sur un + serveur distant afin de déterminer le propriétaire d'une + connexion.

Directives

IdentityCheck
IdentityCheckTimeout

Voir aussi

mod_log_config

+ +

IdentityCheck Directive

+ + + + + + + + +

Description:	Active la journalisation de l'identité RFC 1413 de +l'utilisateur distant
Syntaxe:	`IdentityCheck On\|Off`
Défaut:	`IdentityCheck Off`
Contexte:	configuration du serveur, serveur virtuel, répertoire
Statut:	Extension
Module:	mod_ident
Compatibilité:	Retiré du serveur de base depuis Apache +2.1

Cette directive permet d'activer la journalisation compatible RFC 1413 du nom de + l'utilisateur distant pour chaque connexion, si la machine du client + exécute identd ou un démon similaire. Cette information est + enregistrée dans le journal des accès en utilisant la chaîne de formatage + %...l.

+ +

+ Cette information ne doit pas faire l'objet d'une confiance + absolue, et elle ne doit être utilisée que dans le cadre d'un + traçage grossier. +

+ +

Notez que de sérieux problèmes de délais peuvent survenir lors + des accès à votre serveur, car chaque requête nécessite l'exécution + d'un de ces processus de recherche. Lorsque des pare-feu ou des + serveurs mandataires sont impliqués, chaque recherche est + susceptible d'échouer et ajouter un temps de latence conformément + à la directive IdentityCheckTimeout. En général, ces + recherches ne se révèlent donc pas très utiles sur des serveurs + publics accessibles depuis l'Internet.

+ +

IdentityCheckTimeout Directive

+ + + + + + + +

Description:	Détermine le délai d'attente pour les requêtes +ident
Syntaxe:	`IdentityCheckTimeout secondes`
Défaut:	`IdentityCheckTimeout 30`
Contexte:	configuration du serveur, serveur virtuel, répertoire
Statut:	Extension
Module:	mod_ident

Cette directive permet de spécifier le délai d'attente d'une + requête ident. Une valeur par défaut de 30 secondes est recommandée + par la RFC 1413, + principalement pour prévenir les problèmes qui pourraient être + induits par la charge du réseau. Vous pouvez cependant ajuster la + valeur de ce délai en fonction du débit de votre réseau local.

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_ident.xml.fr b/docs/manual/mod/mod_ident.xml.fr new file mode 100644 index 0000000000..1650c47892 --- /dev/null +++ b/docs/manual/mod/mod_ident.xml.fr @@ -0,0 +1,100 @@ + + + + + + + + + + + +mod_ident +Recherche d'identité conformément à la RFC +1413 +Extension +mod_ident.c +ident_module +Disponible depuis la version 2.2 d'Apache + +

Ce module interroge un démon compatible RFC 1413 sur un + serveur distant afin de déterminer le propriétaire d'une + connexion.

+mod_log_config + + +IdentityCheck +Active la journalisation de l'identité RFC 1413 de +l'utilisateur distant +IdentityCheck On|Off +IdentityCheck Off +server configvirtual host +directory +Retiré du serveur de base depuis Apache +2.1 + + +

+ + + Cette information ne doit pas faire l'objet d'une confiance + absolue, et elle ne doit être utilisée que dans le cadre d'un + traçage grossier. + + +

Notez que de sérieux problèmes de délais peuvent survenir lors + des accès à votre serveur, car chaque requête nécessite l'exécution + d'un de ces processus de recherche. Lorsque des pare-feu ou des + serveurs mandataires sont impliqués, chaque recherche est + susceptible d'échouer et ajouter un temps de latence conformément + à la directive IdentityCheckTimeout. En général, ces + recherches ne se révèlent donc pas très utiles sur des serveurs + publics accessibles depuis l'Internet.

+ + + + +IdentityCheckTimeout +Détermine le délai d'attente pour les requêtes +ident +IdentityCheckTimeout secondes +IdentityCheckTimeout 30 +server configvirtual host +directory + +

+ + + + + diff --git a/docs/manual/mod/mod_ident.xml.meta b/docs/manual/mod/mod_ident.xml.meta index 408ffdaa37..2d39cc0a11 100644 --- a/docs/manual/mod/mod_ident.xml.meta +++ b/docs/manual/mod/mod_ident.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_info.html b/docs/manual/mod/mod_info.html index 2b70dae6ea..23d714e208 100644 --- a/docs/manual/mod/mod_info.html +++ b/docs/manual/mod/mod_info.html @@ -4,6 +4,10 @@ URI: mod_info.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_info.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_info.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_info.html.en b/docs/manual/mod/mod_info.html.en index 3ad5775163..b07ff8135d 100644 --- a/docs/manual/mod/mod_info.html.en +++ b/docs/manual/mod/mod_info.html.en @@ -22,6 +22,7 @@

Apache Module mod_info

Available Languages: en | + fr | ja | ko

@@ -186,6 +187,7 @@ information displayed by the server-info handler

Available Languages: en | + fr | ja | ko

diff --git a/docs/manual/mod/mod_info.html.fr b/docs/manual/mod/mod_info.html.fr new file mode 100644 index 0000000000..d4d0893ade --- /dev/null +++ b/docs/manual/mod/mod_info.html.fr @@ -0,0 +1,202 @@ + + + +mod_info - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_info

Langues Disponibles: en | + fr | + ja | + ko

+ + + +

Description:	Affiche une présentation complète de la configuration du +serveur
Statut:	Extension
Identificateur de Module:	info_module
Fichier Source:	mod_info.c

Sommaire

+ +

Pour activer mod_info, ajoutez les lignes + suivantes à votre fichier httpd.conf.

+ +

+ <Location /infos-serveur> + + SetHandler server-info + + </Location> +

+ +

Il est recommandé d'utiliser mod_access à + l'intérieur de la section <Location> afin de restreindre l'accès aux + informations de configuration de votre serveur :

+ +

+ <Location /infos-serveur> + + SetHandler server-info + Order deny,allow + Deny from all + Allow from votre-entreprise.com + + </Location> +

+ +

Une fois cette configuration effectuée, les informations du + serveur sont disponibles à l'adresse + http://votre-serveur.com/infos-serveur.

Directives

AddModuleInfo

Sujets

Problèmes liés à la sécurité
Filtrage des informations affichées
Limitations connues

Problèmes liés à la sécurité

Une fois mod_info chargé dans le serveur, sa + fonctionnalité de gestionnaire est disponible dans tous les + fichiers de configuration, y compris les fichiers de configuration + des répertoires (par exemple .htaccess). Ceci peut + avoir des répercutions en matière de sécurité pour votre site.

+ +

En particulier, l'utilisation de ce module peut conduire à la + divulgation d'informations sensibles à partir des directives de + configuration d'autres modules Apache comme des chemins systèmes, + des couples nom d'utilisateur/mot de passe, des noms de bases de + données, etc... C'est pourquoi ce module ne doit être utilisé + que dans un environnement sous contrôle et toujours + avec les plus grandes précautions.

+ +

Il est recommandé d'utiliser mod_authz_host pour + restreindre l'accès aux informations de configuration de votre + serveur.

+ +

Contrôle d'accès

+ <Location /infos-serveur> + + SetHandler server-info + Order allow,deny + # Autorisation d'accès depuis le serveur lui-même + Allow from 127.0.0.1 + # Autorisation d'accès depuis une station de travail du réseau + # local + Allow from 192.168.1.17 + + </Location> +

Filtrage des informations affichées

Par défaut, les informations affichées comprennent une liste de + tous les modules activés, et pour chaque module, une description des + directives qu'il accepte, les branchements (hooks) qu'il + implémente, ainsi que les directives concernées dans la + configuration courante.

+ +

Il est possible d'afficher d'autres vues de la configuration en + ajoutant un argument à la requête infos-serveur. Par + exemple, http://votre-serveur.com/infos-serveur?config + affichera toutes les directives de configuration.

+ +

?<module-name>: Uniquement les informations relatives au module + spécifié
?config: Uniquement les directives de configuration, non triées + par module
?hooks: Uniquement la liste des branchements (hooks) + auxquels le module est attaché
?list: Une simple liste des modules activés
?server: Uniquement des informations de base sur le serveur

Limitations connues

mod_info tire ses informations de + la configuration interprétée, et non du fichier de configuration + original. La manière dont l'arbre de configuration interprété est + créé induit quelques limitations :

Les directives qui sont traitées immédiatement sans être + enregistrées dans l'arbre de configuration interprété ne sont pas + prises en compte. Celles-ci comprennent ServerRoot, LoadModule et LoadFile.
Les directives qui contrôlent le fichier de configuration + lui-même, comme Include, + <IfModule> et + <IfDefine> ne sont pas + prises en compte, mais les directives de configuration incluses le + sont.
Les commentaires ne sont pas pris en compte (Ce qui peut être + considéré comme une fonctionnalité).
Les directives de configuration des fichiers + .htaccess ne sont pas prises en compte (car elles ne + font pas partie de la configuration permanente du serveur).
Les directives de conteneur comme <Directory> sont affichées + normalement, mais mod_info est incapable de + déterminer le numéro de ligne de la balise fermante </Directory>.
Les directives générées par des modules tiers comme + mod_perl peuvent ne pas être + prises en compte.

AddModuleInfo Directive

+ + + + + + + +

Description:	Ajoute des données supplémentaires aux informations de +module affichées par le gestionnaire server-info
Syntaxe:	`AddModuleInfo nom-module chaîne`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_info
Compatibilité:	Disponible depuis la version 1.3 d'Apache

Cette directive permet d'afficher le contenu de chaîne + en tant qu'Information supplémentaire interprétée + en HTML pour le module nom-module. Exemple :

+ +

+ AddModuleInfo mod_deflate.c 'Voir <a \ + + href="http://www.apache.org/docs/trunk/mod/mod_deflate.html">\ + http://www.apache.org/docs/trunk/mod/mod_deflate.html</a>' + +

+ +

Langues Disponibles: en | + fr | + ja | + ko

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_info.xml.fr b/docs/manual/mod/mod_info.xml.fr new file mode 100644 index 0000000000..3d9a0d2169 --- /dev/null +++ b/docs/manual/mod/mod_info.xml.fr @@ -0,0 +1,188 @@ + + + + + + + + + + + +mod_info +Affiche une présentation complète de la configuration du +serveur +Extension +mod_info.c +info_module + +

Pour activer mod_info, ajoutez les lignes + suivantes à votre fichier httpd.conf.

+ + + <Location /infos-serveur>
+ + SetHandler server-info
+ + </Location> + + +

Il est recommandé d'utiliser mod_access à + l'intérieur de la section Location afin de restreindre l'accès aux + informations de configuration de votre serveur :

+ + + <Location /infos-serveur>
+ + SetHandler server-info
+ Order deny,allow
+ Deny from all
+ Allow from votre-entreprise.com
+ + </Location> + + +

Une fois cette configuration effectuée, les informations du + serveur sont disponibles à l'adresse + http://votre-serveur.com/infos-serveur.

+ +

Problèmes liés à la sécurité +

Une fois mod_info chargé dans le serveur, sa + fonctionnalité de gestionnaire est disponible dans tous les + fichiers de configuration, y compris les fichiers de configuration + des répertoires (par exemple .htaccess). Ceci peut + avoir des répercutions en matière de sécurité pour votre site.

+ +

Il est recommandé d'utiliser mod_authz_host pour + restreindre l'accès aux informations de configuration de votre + serveur.

+ + Contrôle d'accès + <Location /infos-serveur>
+ + SetHandler server-info
+ Order allow,deny
+ # Autorisation d'accès depuis le serveur lui-même
+ Allow from 127.0.0.1
+ # Autorisation d'accès depuis une station de travail du réseau + # local
+ Allow from 192.168.1.17
+ + </Location> + +

+ +

Filtrage des informations affichées +

+ +

?<module-name>: Uniquement les informations relatives au module + spécifié
?config: Uniquement les directives de configuration, non triées + par module
?hooks: Uniquement la liste des branchements (hooks) + auxquels le module est attaché
?list: Une simple liste des modules activés
?server: Uniquement des informations de base sur le serveur

+ +

Limitations connues +

mod_info tire ses informations de + la configuration interprétée, et non du fichier de configuration + original. La manière dont l'arbre de configuration interprété est + créé induit quelques limitations :

Les directives qui sont traitées immédiatement sans être + enregistrées dans l'arbre de configuration interprété ne sont pas + prises en compte. Celles-ci comprennent ServerRoot, LoadModule et LoadFile.
Les directives qui contrôlent le fichier de configuration + lui-même, comme Include, + <IfModule> et + <IfDefine> ne sont pas + prises en compte, mais les directives de configuration incluses le + sont.
Les commentaires ne sont pas pris en compte (Ce qui peut être + considéré comme une fonctionnalité).
Les directives de configuration des fichiers + .htaccess ne sont pas prises en compte (car elles ne + font pas partie de la configuration permanente du serveur).
Les directives de conteneur comme <Directory> sont affichées + normalement, mais mod_info est incapable de + déterminer le numéro de ligne de la balise fermante </Directory>.
Les directives générées par des modules tiers comme + mod_perl peuvent ne pas être + prises en compte.

+ + +AddModuleInfo +Ajoute des données supplémentaires aux informations de +module affichées par le gestionnaire server-info +AddModuleInfo nom-module chaîne +server configvirtual host + +Disponible depuis la version 1.3 d'Apache + + +

Cette directive permet d'afficher le contenu de chaîne + en tant qu'Information supplémentaire interprétée + en HTML pour le module nom-module. Exemple :

+ + + AddModuleInfo mod_deflate.c 'Voir <a \
+ + href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html">\
+ http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html</a>' + + + + + + diff --git a/docs/manual/mod/mod_info.xml.meta b/docs/manual/mod/mod_info.xml.meta index 1008060725..7e158f156a 100644 --- a/docs/manual/mod/mod_info.xml.meta +++ b/docs/manual/mod/mod_info.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko diff --git a/docs/manual/mod/mod_negotiation.html b/docs/manual/mod/mod_negotiation.html index dbedc3d00d..d6d7332ba8 100644 --- a/docs/manual/mod/mod_negotiation.html +++ b/docs/manual/mod/mod_negotiation.html @@ -4,6 +4,10 @@ URI: mod_negotiation.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_negotiation.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_negotiation.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_negotiation.html.en b/docs/manual/mod/mod_negotiation.html.en index 15f2bf9c85..61f8f48fb1 100644 --- a/docs/manual/mod/mod_negotiation.html.en +++ b/docs/manual/mod/mod_negotiation.html.en @@ -22,6 +22,7 @@

Apache Module mod_negotiation

Available Languages: en | + fr | ja

@@ -300,6 +301,7 @@ the client does not express a preference

Available Languages: en | + fr | ja

diff --git a/docs/manual/mod/mod_negotiation.html.fr b/docs/manual/mod/mod_negotiation.html.fr new file mode 100644 index 0000000000..4117db9165 --- /dev/null +++ b/docs/manual/mod/mod_negotiation.html.fr @@ -0,0 +1,325 @@ + + + +mod_negotiation - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_negotiation

Langues Disponibles: en | + fr | + ja

Description:	Provides for content negotiation

+ + +

Description:	Effectue la négociation de +contenu
Statut:	Base
Identificateur de Module:	negotiation_module
Fichier Source:	mod_negotiation.c

Sommaire

+ +

La négociation de contenu, ou plus précisément la sélection de + contenu, est la sélection parmi plusieurs documents disponibles, du + document qui "colle" au plus près des possibilités du client. Pour y + parvenir, deux méthodes sont employées.

+ +

Une table de correspondances de types (un fichier associé au + gestionnaire type-map) qui contient une liste + explicite des fichiers contenant les différentes variantes.
Une recherche multivues (Multiviews) (activée par l'Options Multiviews), où le + serveur effectue une recherche de correspondance de modèle de nom + de fichier implicite, et fait son choix parmi les résultats.

Directives

CacheNegotiatedDocs
ForceLanguagePriority
LanguagePriority

Sujets

Tables de correspondances de types
Multivues

Voir aussi

Tables de correspondances de types

Une table de correspondances de types possède un format similaire + à celui des en-têtes de messagerie RFC822. Elle contient des + descriptions de documents séparées par des lignes vides, toute ligne + commençant par un dièse ('#') étant considérée comme un + commentaire. Une description de document comporte plusieurs + enregistrements d'en-têtes ; chaque enregistrement peut être réparti + sur plusieurs lignes à condition que les lignes supplémentaires + commencent par un ou plusieurs espaces. Lors du traitement, les + espaces de début de ligne seront supprimés et les lignes + concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui + se termine toujours par un caractère "deux-points" ':', suivi d'une + valeur. Les espaces sont autorisés entre le nom d'en-tête et sa + valeur, ainsi qu'entre les différents éléments de la valeur. Les + en-têtes autorisés sont :

+ +

Content-Encoding:

Le codage du fichier. Apache ne reconnaît que les codages + définis par une directive AddEncoding. Sont normalement inclus + les codages x-compress pour les fichiers compressés + avec compress, et x-gzip pour les fichiers compressés + avec gzip. Le préfixe x- est ignoré lors des + comparaisons de codages.

Content-Language:

Le(s) langage(s) de la variante, sous la forme d'un symbole de + langage Internet standard (RFC 1766). Par + exemple, en correspond à l'anglais. Si la variante + contient plusieurs langages, ils sont séparés par des + virgules.

Content-Length:

La taille du fichier en octets. Si cet en-tête n'est pas + présent, c'est la taille réelle du fichier qui est utilisée.

Content-Type:

+ Le type MIME du document + avec des paramètres optionnels. Les paramètres sont séparés du + type de médium ainsi qu'entre eux par un point-virgule, et + possèdent la syntaxe nom=valeur. Les paramètres + courants sont : + +

level: un entier spécifiant la version du type de média. Pour + text/html, la valeur par défaut est 2, sinon + 0.
qs: un nombre en virgule flottante de 0.0 à 1.0, indiquant la + "qualité" relative de la variante courante par rapport aux + autres variantes disponibles, indépendamment des possibilités + du client. Par exemple, un fichier jpeg est en général une + source de qualité supérieure à un fichier ascii s'il est censé + représenter une image. Cependant, si la ressource représentée + est une image ascii, un fichier ascii possèdera une qualité + supérieure à un fichier jpeg. Toutes les valeurs de + qs sont donc spécifiques à une certaine + ressource.

+ +

Exemple

+ Content-Type: image/jpeg; qs=0.8 +

URI:

l'URI du fichier contenant la variante (du type de médium + donné, codé selon le codage de contenu donné). Cet URI est + considéré comme relatif au fichier de correspondances ; il doit + être situé sur le même serveur (!), et doit faire référence au + fichier auquel le client se verrait accorder l'accès s'il était + requis directement.

Body:

une nouveauté d'Apache 2.0 : le contenu réel de la ressource + peut être inclus dans la table de correspondances en utilisant + l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un + délimiteur pour le contenu du corps. Les lignes suivantes du + fichier de correspondances de types seront alors considérées comme + parties du corps de la ressource jusqu'à ce que le délimiteur soit + détecté. + +

Exemple:

+ Body:----xyz---- + <html> + <body> + <p>Contenu de la page.</p> + </body> + </html> + ----xyz---- +

Multivues

Une recherche Multivues est activée par l'Options Multiviews. Si le + serveur reçoit une requête pour /un/répertoire/foo, et + si /un/répertoire/foo n'existe pas, le serveur parcourt + le répertoire à la recherche de tous les fichiers de nom + foo.*, et simule véritablement une correspondance de + type qui nomme tous ces fichiers en leur assignant les mêmes type + de média et codage de contenu qu'ils auraient eus si le client avait + requis l'un d'entre eux avec son nom complet. Il choisit ensuite le + fichier qui correspond le mieux au profile du client, puis renvoie + le document.

+ +

La directive MultiviewsMatch définit si Apache doit + prendre en compte les fichiers qui ne comportent pas de métadonnées + de négociation de contenu lors du choix du fichier à servir.

CacheNegotiatedDocs Directive

+ + + + + + + + +

Description:	Permet la mise en cache au niveau des serveurs mandataires +des documents dont le contenu a été négocié
Syntaxe:	`CacheNegotiatedDocs On\|Off`
Défaut:	`CacheNegotiatedDocs Off`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_negotiation
Compatibilité:	La syntaxe a été modifiée dans la version +2.0.

Si elle est définie à "on", cette directive permet la mise en + cache au niveau des serveurs mandataires des documents dont le + contenu a été négocié. Le processus de mise en cache sera alors plus + efficace, mais des clients se trouvant derrière le mandataire + seront alors susceptibles de se voir servir des versions de + documents qui ne correspondent pas forcément à leurs attentes.

+ +

Cette directive ne s'applique qu'aux requêtes en provenance de + navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de + la mise en cache des documents au contenu négocié, et cette + directive n'a aucun effet sur les réponses aux requêtes + HTTP/1.1.

+ +

Avant la version 2.0, la directive + CacheNegotiatedDocs n'acceptait aucun + argument ; la seule présence de la directive suffisait à la définir + à "on".

+ +

ForceLanguagePriority Directive

+ + + + + + + + + +

Description:	Action à entreprendre si un document acceptable unique +n'est pas trouvé
Syntaxe:	`ForceLanguagePriority None\|Prefer\|Fallback [Prefer\|Fallback]`
Défaut:	`ForceLanguagePriority Prefer`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_negotiation
Compatibilité:	Disponible depuis la version 2.0.30

La directive ForceLanguagePriority utilise + le langage défini par la directive LanguagePriority pour terminer + la négociation lorsque le serveur n'est pas en mesure de trouver une + solution satisfaisante unique.

+ +

ForceLanguagePriority Prefer utilise la directive + LanguagePriority pour servir le résultat d'un choix + unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES), + lorsque que plusieurs choix équivalents sont disponibles. Par + exemple, avec les deux directives ci-dessous, si l'en-tête + Accept-Language de l'utilisateur assigne à + en et de une qualité de .500 + (les deux langages sont également acceptables), alors c'est la + première variante acceptable de langue en qui sera + servie.

+ +

+ LanguagePriority en fr de + ForceLanguagePriority Prefer +

+ +

ForceLanguagePriority Fallback utilise la directive + LanguagePriority + pour servir un résultat valide, au lieu de renvoyer un résultat HTTP + 406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si + l'en-tête Accept-Language de l'utilisateur ne mentionne + que les réponses de langage es, et si aucune variante + dans cette langue n'est trouvée, c'est la première variante de la + liste définie par la directive LanguagePriority qui sera servie.

+ +

+ LanguagePriority en fr de + ForceLanguagePriority Fallback +

+ +

Les deux options, Prefer et Fallback, + peuvent être spécifiées, de façon à ce que la variante servie soit + la première variante qui convient définie par la directive + LanguagePriority si + plusieurs variantes sont également acceptables, ou le premier + document disponible si aucune variante ne convient à la liste de + langages acceptables fournie par le client.

+ +

Voir aussi

AddLanguage

LanguagePriority Directive

+ + + + + + + +

Description:	L'ordre de priorité des variantes de langages pour les +cas où le client n'a pas formulé de préférences
Syntaxe:	`LanguagePriority langage-MIME [langage-MIME] +...`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Annuler:	FileInfo
Statut:	Base
Module:	mod_negotiation

La directive LanguagePriority permet de + définir, au cours du traitement d'une requête Multivues, l'ordre de + priorité des variantes de langages pour les cas + où le client n'a pas formulé de préférences. La liste énumère les + langages-MIME dans un ordre de préférences + décroissantes.

+ +

Exemple:

+ LanguagePriority en fr de +

+ +

Dans le cas d'une requête pour foo.html, si + foo.html.fr et foo.html.de existent, et si + le client n'a pas formulé de préférences, c'est le fichier + foo.html.fr qui sera renvoyé.

+ +

Notez que cette directive n'a d'effet que si le 'meilleur' + langage n'a pas pu être déterminé d'une autre manière ou si la + valeur de la directive ForceLanguagePriority est + différente de None. En général, c'est le client qui + détermine le langage préféré, non le serveur.

+ +

Voir aussi

AddLanguage

Langues Disponibles: en | + fr | + ja

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_negotiation.xml.fr b/docs/manual/mod/mod_negotiation.xml.fr new file mode 100644 index 0000000000..a4c1b89f61 --- /dev/null +++ b/docs/manual/mod/mod_negotiation.xml.fr @@ -0,0 +1,307 @@ + + + + + + + + + + + +mod_negotiation +Effectue la négociation de +contenu +Base +mod_negotiation.c +negotiation_module + +

+ +

Une table de correspondances de types (un fichier associé au + gestionnaire type-map) qui contient une liste + explicite des fichiers contenant les différentes variantes.
Une recherche multivues (Multiviews) (activée par l'Options Multiviews), où le + serveur effectue une recherche de correspondance de modèle de nom + de fichier implicite, et fait son choix parmi les résultats.

+Options +mod_mime +Négociation de +contenu +Variables d'environnement + +

Tables de correspondances de types +

+ +

Content-Encoding:

Le codage du fichier. Apache ne reconnaît que les codages + définis par une directive AddEncoding. Sont normalement inclus + les codages x-compress pour les fichiers compressés + avec compress, et x-gzip pour les fichiers compressés + avec gzip. Le préfixe x- est ignoré lors des + comparaisons de codages.

Content-Language:

Content-Length:

La taille du fichier en octets. Si cet en-tête n'est pas + présent, c'est la taille réelle du fichier qui est utilisée.

Content-Type:

level: un entier spécifiant la version du type de média. Pour + text/html, la valeur par défaut est 2, sinon + 0.
qs: un nombre en virgule flottante de 0.0 à 1.0, indiquant la + "qualité" relative de la variante courante par rapport aux + autres variantes disponibles, indépendamment des possibilités + du client. Par exemple, un fichier jpeg est en général une + source de qualité supérieure à un fichier ascii s'il est censé + représenter une image. Cependant, si la ressource représentée + est une image ascii, un fichier ascii possèdera une qualité + supérieure à un fichier jpeg. Toutes les valeurs de + qs sont donc spécifiques à une certaine + ressource.

+ + Exemple + Content-Type: image/jpeg; qs=0.8 + +

URI:

Body:

+ +

Multivues +

Une recherche Multivues est activée par l'Options Multiviews. Si le + serveur reçoit une requête pour /un/répertoire/foo, et + si /un/répertoire/foo n'existe pas, le serveur parcourt + le répertoire à la recherche de tous les fichiers de nom + foo.*, et simule véritablement une correspondance de + type qui nomme tous ces fichiers en leur assignant les mêmes type + de média et codage de contenu qu'ils auraient eus si le client avait + requis l'un d'entre eux avec son nom complet. Il choisit ensuite le + fichier qui correspond le mieux au profile du client, puis renvoie + le document.

+ +

La directive MultiviewsMatch définit si Apache doit + prendre en compte les fichiers qui ne comportent pas de métadonnées + de négociation de contenu lors du choix du fichier à servir.

+ + +CacheNegotiatedDocs +Permet la mise en cache au niveau des serveurs mandataires +des documents dont le contenu a été négocié +CacheNegotiatedDocs On|Off +CacheNegotiatedDocs Off +server configvirtual host + +La syntaxe a été modifiée dans la version +2.0. + + +

+ +

Avant la version 2.0, la directive + CacheNegotiatedDocs n'acceptait aucun + argument ; la seule présence de la directive suffisait à la définir + à "on".

+ + + + +ForceLanguagePriority +Action à entreprendre si un document acceptable unique +n'est pas trouvé +ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] +ForceLanguagePriority Prefer +server configvirtual host +directory.htaccess +FileInfo +Disponible depuis la version 2.0.30 + + +

La directive ForceLanguagePriority utilise + le langage défini par la directive LanguagePriority pour terminer + la négociation lorsque le serveur n'est pas en mesure de trouver une + solution satisfaisante unique.

+ +

+ + + LanguagePriority en fr de
+ ForceLanguagePriority Prefer + + +

ForceLanguagePriority Fallback utilise la directive + LanguagePriority + pour servir un résultat valide, au lieu de renvoyer un résultat HTTP + 406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si + l'en-tête Accept-Language de l'utilisateur ne mentionne + que les réponses de langage es, et si aucune variante + dans cette langue n'est trouvée, c'est la première variante de la + liste définie par la directive LanguagePriority qui sera servie.

+ + + LanguagePriority en fr de
+ ForceLanguagePriority Fallback + + +

Les deux options, Prefer et Fallback, + peuvent être spécifiées, de façon à ce que la variante servie soit + la première variante qui convient définie par la directive + LanguagePriority si + plusieurs variantes sont également acceptables, ou le premier + document disponible si aucune variante ne convient à la liste de + langages acceptables fournie par le client.

+ +AddLanguage + + + +LanguagePriority +L'ordre de priorité des variantes de langages pour les +cas où le client n'a pas formulé de préférences +LanguagePriority langage-MIME [langage-MIME] +... +server configvirtual host +directory.htaccess +FileInfo + + +

La directive LanguagePriority permet de + définir, au cours du traitement d'une requête Multivues, l'ordre de + priorité des variantes de langages pour les cas + où le client n'a pas formulé de préférences. La liste énumère les + langages-MIME dans un ordre de préférences + décroissantes.

+ + Exemple: + LanguagePriority en fr de + + +

Dans le cas d'une requête pour foo.html, si + foo.html.fr et foo.html.de existent, et si + le client n'a pas formulé de préférences, c'est le fichier + foo.html.fr qui sera renvoyé.

+ +

Notez que cette directive n'a d'effet que si le 'meilleur' + langage n'a pas pu être déterminé d'une autre manière ou si la + valeur de la directive ForceLanguagePriority est + différente de None. En général, c'est le client qui + détermine le langage préféré, non le serveur.

+ +AddLanguage + + + diff --git a/docs/manual/mod/mod_negotiation.xml.meta b/docs/manual/mod/mod_negotiation.xml.meta index 838e17f383..a6f22c10da 100644 --- a/docs/manual/mod/mod_negotiation.xml.meta +++ b/docs/manual/mod/mod_negotiation.xml.meta @@ -8,6 +8,7 @@ en + fr ja diff --git a/docs/manual/mod/mod_remoteip.html b/docs/manual/mod/mod_remoteip.html index 188a3c6e51..45439c7431 100644 --- a/docs/manual/mod/mod_remoteip.html +++ b/docs/manual/mod/mod_remoteip.html @@ -3,3 +3,7 @@ URI: mod_remoteip.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_remoteip.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_remoteip.html.en b/docs/manual/mod/mod_remoteip.html.en index 4263570135..c9c9d9f884 100644 --- a/docs/manual/mod/mod_remoteip.html.en +++ b/docs/manual/mod/mod_remoteip.html.en @@ -21,7 +21,8 @@

Apache Module mod_remoteip

Available Languages: en

Available Languages: en | + fr

Available Languages: en | + fr | ja | ko | tr

diff --git a/docs/manual/mod/mod_so.html.fr b/docs/manual/mod/mod_so.html.fr new file mode 100644 index 0000000000..b0ec3ba8fd --- /dev/null +++ b/docs/manual/mod/mod_so.html.fr @@ -0,0 +1,206 @@ + + + +mod_so - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_so

Langues Disponibles: en | + fr | + ja | + ko | + tr

Description:

Replaces the apparent client remote IP address and hostname for the request with the IP address list presented by a proxies or a load @@ -271,7 +272,8 @@ balancer via the request headers.

Available Languages: en

Available Languages: en | + fr

diff --git a/docs/manual/mod/mod_remoteip.html.fr b/docs/manual/mod/mod_remoteip.html.fr new file mode 100644 index 0000000000..7005b02541 --- /dev/null +++ b/docs/manual/mod/mod_remoteip.html.fr @@ -0,0 +1,322 @@ + + + +mod_remoteip - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_remoteip

Langues Disponibles: en | + fr

+ + + +

Description:	Remplace l'adresse IP et le nom d'hôte apparents du client +pour la requête par l'adresse IP présentée par un mandataire ou un +répartiteur de charge via les en-têtes de la requête. +
Statut:	Base
Identificateur de Module:	remoteip_module
Fichier Source:	mod_remoteip.c

Sommaire

+ +

Ce module permet de traiter l'hôte distant qui a initié la + requête en tant qu'hôte distant original du point de vue de httpd à + des fins d'autorisation et de connexion, même si cet hôte distant se + trouve derrière un répartiteur de charge, un serveur frontal, ou un + serveur mandataire.

+ +

Le module remplace les adresse IP et nom d'hôte apparents + distants (du client) pour la requête par l'adresse IP indiquée dans + l'en-tête de requête configuré via la directive + RemoteIPHeader.

+ +

Une fois remplacée comme indiqué, cette adresse IP apparente est + utilisée pour les fonctionnalités <Require host> et <Require ip> de + mod_authz_host ; elle est aussi affichée par + mod_status, et enregistrée via les directives + %a et %h du module + mod_log_config. Elle permet aussi d'identifier la + machine en essayant de lui attribuer une identité inetd via le + module mod_ident et en fonction de la configuration + de la directive IdentityCheck.

+ +

Il est essentiel de n'activer cette + fonctionnalité que pour les requêtes en provenance des serveurs + intermédiaires (mandataires, etc...) auxquels le serveur peut faire + confiance, car il est trivial pour le client distant d'usurper + l'identité d'un autre client.

Directives

RemoteIPHeader
RemoteIPInternalProxy
RemoteIPInternalProxyList
RemoteIPProxiesHeader
RemoteIPTrustedProxy
RemoteIPTrustedProxyList

Sujets

Traitement des adresses distantes

Voir aussi

Traitement des adresses distantes

+ +

Apache identifie le client par la valeur remote_ip de la + connexion, et de cette valeur découlent les valeurs remote_host et + remote_logname de la connexion. Ces champs jouent un rôle + dans l'authentification, l'autorisation et la connexion, ainsi que + dans d'autres traitements effectués par d'autres modules + chargeables.

+ +

mod_remoteip remplace la véritable remote_ip par la remote_ip + indiquée par exemple par un mandataire chaque fois que le serveur + effectue une évaluation du client, et réinitialise les valeurs de + remote_host et remote_logname afin de déclencher une nouvelle + requête dns ou ident sur l'adresse IP distante.

+ +

Lorsque la valeur de l'en-tête comporte plusieurs adresses IP + distantes séparées par des virgules, celles-ci sont traitées de la + droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP + distante courante n'est pas digne de confiance pour présenter + l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de + façon à ne contenir que cette liste d'adresses non confirmées, ou + bien, si toutes les adresses IP sont dignes de confiance, cet + en-tête est tout bonnement supprimé de la requête.

+ +

Lors du remplacement de l'adresse IP distante, le module stocke + la liste des hôtes intermédiaires dans un mémo + remoteip-proxy-ip-list, que l'on peut faire enregistrer par + mod_log_config en utilisant le symbole de format + %{remoteip-proxy-ip-list}n. Si l'administrateur doit + stocker ceci dans un en-tête additionnel, la même valeur peut aussi + être enregistrée sous la forme d'un en-tête en utilisant la + directive RemoteIPProxiesHeader.

+ +

Adresses IPv4 converties au format IPv6

+ Avec httpd, d'une manière générale, toute adresse IPv4 convertie au + format IPv6 est enregistrée sous sa forme IPv4.

+ +

Adresses internes (privées)

+ Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16, + 169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc + public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque + des mandataires internes (intranet) + RemoteIPInternalProxy sont enregistrés.

+ +

RemoteIPHeader Directive

+ + + + + + +

Description:	Définit le champ d'en-tête qui contiendra les adresses IP +du client
Syntaxe:	`RemoteIPHeader en-tête`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_remoteip

La directive RemoteIPHeader indique à + mod_remoteip de traiter la valeur de + l'en-tête spécifié comme l'adresse IP du client, ou comme + une liste d'adresses IP clients intermédiaires, en fonction de la + configuration des directives + RemoteIPInternalProxy et + RemoteIPTrustedProxy. Si ces deux dernières + directives ne sont pas utilisées, mod_remoteip + traitera tout hôte présentant une valeur d'IP + RemoteIPHeader comme hôte de confiance.

+ +

Exemple à usage interne (répartiteur de + charge)

+ RemoteIPHeader X-Client-IP +

+ +

Exemple dans le cas d'un mandataire

+ RemoteIPHeader X-Forwarded-For +

+ +

RemoteIPInternalProxy Directive

+ + + + + + +

Description:	Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader
Syntaxe:	`RemoteIPInternalProxy +ip-mandataire\|ip-mandataire/sous-réseau\|nom-hôte ...`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_remoteip

La directive RemoteIPInternalProxy permet + d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + RemoteIPTrustedProxy, toute adresse IP + présentée dans cet en-tête, y comprises les adresses intranet + privées, sont considérées comme dignes de confiance lorsqu'elles + sont indiquées par ces mandataires.

+ +

Exemple à usage interne (répartiteur de + charge)

+ RemoteIPHeader X-Client-IP + RemoteIPTrustedProxy 10.0.2.0/24 + RemoteIPTrustedProxy passerelle.domaine-local +

+ +

RemoteIPInternalProxyList Directive

+ + + + + + +

Description:	Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader
Syntaxe:	`RemoteIPInternalProxyList nom-fichier`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_remoteip

La directive RemoteIPInternalProxyList + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.

+ +

Le caractère '#' indique une ligne de commentaires, + sinon, toutes les lignes séparées par un caractère nouvelle + ligne ou + tous les éléments d'une ligne séparés par un espace sont traités de + la même façon qu'avec la directive + RemoteIPInternalProxy.

+ +

Exemple à usage interne (répartiteur de + charge)

+ RemoteIPHeader X-Client-IP + RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst +

+ +

contenu de conf/mandataires-de-confiance.lst

+ # Nos mandataires internes de confiance + 10.0.2.0/24 # Tout le monde dans le groupe de test + passerelle.domaine-local # Le frontal répartiteur de charge +

+ +

RemoteIPProxiesHeader Directive

+ + + + + + +

Description:	Déclare le champ d'en-tête qui contiendra toutes les +adresses IP intermédiaires
Syntaxe:	`RemoteIPProxiesHeader Nom_en-tête`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_remoteip

La directive RemoteIPProxiesHeader permet + de spécifier l'en-tête dans lequel mod_remoteip va + collecter une liste de toutes les adresses IP clients intermédiaires + auxquelles on pourra faire confiance pour résoudre la véritable + adresse IP distante. Notez que les adresses intermédiaires + RemoteIPTrustedProxy sont enregistrées dans + cet en-tête, alors que toute adresse intermédiaire + RemoteIPInternalProxy est omise.

+ +

Exemple

+ RemoteIPHeader X-Forwarded-For + RemoteIPProxiesHeader X-Forwarded-By +

+ +

RemoteIPTrustedProxy Directive

+ + + + + + +

Description:	Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader
Syntaxe:	`RemoteIPTrustedProxy +ip-mandataire\|ip-mandataire/sous-réseau\|nom-hôte ...`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_remoteip

La directive RemoteIPTrustedProxy permet + d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + RemoteIPInternalProxy, toutes les adresses IP + intranet ou privées indiquées par de tels mandataires, y compris les + blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8 + (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas + dignes de confiance en tant qu'adresses IP distantes, et se situent + à gauche dans le contenu de l'en-tête + RemoteIPHeader.

+ +

Exemple d'adresse de confiance (répartiteur de + charge

+ RemoteIPHeader X-Forwarded-For + RemoteIPTrustedProxy 10.0.2.16/28 + RemoteIPTrustedProxy proxy.example.com +

+ +

RemoteIPTrustedProxyList Directive

+ + + + + + +

Description:	Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader
Syntaxe:	`RemoteIPTrustedProxyList nom-fichier`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	mod_remoteip

La directive RemoteIPTrustedProxyList + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.

+ +

Le caractère '#' indique une ligne de commentaires, + sinon, toutes les lignes séparées par un caractère nouvelle ligne ou + tous les éléments d'une ligne séparés par un espace sont traités de + la même façon qu'avec la directive + RemoteIPTrustedProxy.

+ +

Exemple d'adresse de confiance (répartiteur de + charge

+ RemoteIPHeader X-Forwarded-For + RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst +

+ +

conf/mandataires-de-confiance.lst contents

+ # Mandataires externes identifiés + 192.0.2.16/28 #groupe wap phone de mandataires + proxy.isp.example.com #un FAI bien connu +

+ +

Langues Disponibles: en | + fr

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_remoteip.xml.fr b/docs/manual/mod/mod_remoteip.xml.fr new file mode 100644 index 0000000000..26f6bd34b7 --- /dev/null +++ b/docs/manual/mod/mod_remoteip.xml.fr @@ -0,0 +1,301 @@ + + + + + + + + + + + +mod_remoteip +Remplace l'adresse IP et le nom d'hôte apparents du client +pour la requête par l'adresse IP présentée par un mandataire ou un +répartiteur de charge via les en-têtes de la requête. + + +Base +mod_remoteip.c +remoteip_module + +

+ +

Le module remplace les adresse IP et nom d'hôte apparents + distants (du client) pour la requête par l'adresse IP indiquée dans + l'en-tête de requête configuré via la directive + RemoteIPHeader.

+ +

Une fois remplacée comme indiqué, cette adresse IP apparente est + utilisée pour les fonctionnalités Require host et Require ip de + mod_authz_host ; elle est aussi affichée par + mod_status, et enregistrée via les directives + %a et %h du module + mod_log_config. Elle permet aussi d'identifier la + machine en essayant de lui attribuer une identité inetd via le + module mod_ident et en fonction de la configuration + de la directive IdentityCheck.

+ + Il est essentiel de n'activer cette + fonctionnalité que pour les requêtes en provenance des serveurs + intermédiaires (mandataires, etc...) auxquels le serveur peut faire + confiance, car il est trivial pour le client distant d'usurper + l'identité d'un autre client. +

+ +mod_authz_host +mod_status +mod_log_config +mod_ident + +

Traitement des adresses distantes + +

+ +

Lors du remplacement de l'adresse IP distante, le module stocke + la liste des hôtes intermédiaires dans un mémo + remoteip-proxy-ip-list, que l'on peut faire enregistrer par + mod_log_config en utilisant le symbole de format + %{remoteip-proxy-ip-list}n. Si l'administrateur doit + stocker ceci dans un en-tête additionnel, la même valeur peut aussi + être enregistrée sous la forme d'un en-tête en utilisant la + directive RemoteIPProxiesHeader.

+ + Adresses IPv4 converties au format IPv6 + Avec httpd, d'une manière générale, toute adresse IPv4 convertie au + format IPv6 est enregistrée sous sa forme IPv4. + + Adresses internes (privées) + Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16, + 169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc + public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque + des mandataires internes (intranet) + RemoteIPInternalProxy sont enregistrés. + +

+ + +RemoteIPHeader +Définit le champ d'en-tête qui contiendra les adresses IP +du client +RemoteIPHeader en-tête +server configvirtual host + + +

La directive RemoteIPHeader indique à + mod_remoteip de traiter la valeur de + l'en-tête spécifié comme l'adresse IP du client, ou comme + une liste d'adresses IP clients intermédiaires, en fonction de la + configuration des directives + RemoteIPInternalProxy et + RemoteIPTrustedProxy. Si ces deux dernières + directives ne sont pas utilisées, mod_remoteip + traitera tout hôte présentant une valeur d'IP + RemoteIPHeader comme hôte de confiance.

+ + Exemple à usage interne (répartiteur de + charge) + RemoteIPHeader X-Client-IP + + + Exemple dans le cas d'un mandataire + RemoteIPHeader X-Forwarded-For + + + + + +RemoteIPInternalProxy +Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader +RemoteIPInternalProxy +ip-mandataire|ip-mandataire/sous-réseau|nom-hôte ... +server configvirtual host + + +

La directive RemoteIPInternalProxy permet + d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + RemoteIPTrustedProxy, toute adresse IP + présentée dans cet en-tête, y comprises les adresses intranet + privées, sont considérées comme dignes de confiance lorsqu'elles + sont indiquées par ces mandataires.

+ + Exemple à usage interne (répartiteur de + charge) + RemoteIPHeader X-Client-IP
+ RemoteIPTrustedProxy 10.0.2.0/24
+ RemoteIPTrustedProxy passerelle.domaine-local + + + + + +RemoteIPInternalProxyList +Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader +RemoteIPInternalProxyList nom-fichier +server configvirtual host + + +

La directive RemoteIPInternalProxyList + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.

+ +

+ + Exemple à usage interne (répartiteur de + charge) + RemoteIPHeader X-Client-IP
+ RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst + + + contenu de conf/mandataires-de-confiance.lst + # Nos mandataires internes de confiance
+ 10.0.2.0/24 # Tout le monde dans le groupe de test
+ passerelle.domaine-local # Le frontal répartiteur de charge + + + + + +RemoteIPProxiesHeader +Déclare le champ d'en-tête qui contiendra toutes les +adresses IP intermédiaires +RemoteIPProxiesHeader Nom_en-tête +server configvirtual host + + +

La directive RemoteIPProxiesHeader permet + de spécifier l'en-tête dans lequel mod_remoteip va + collecter une liste de toutes les adresses IP clients intermédiaires + auxquelles on pourra faire confiance pour résoudre la véritable + adresse IP distante. Notez que les adresses intermédiaires + RemoteIPTrustedProxy sont enregistrées dans + cet en-tête, alors que toute adresse intermédiaire + RemoteIPInternalProxy est omise.

+ + Exemple + RemoteIPHeader X-Forwarded-For
+ RemoteIPProxiesHeader X-Forwarded-By + + + + + +RemoteIPTrustedProxy +Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader +RemoteIPTrustedProxy +ip-mandataire|ip-mandataire/sous-réseau|nom-hôte ... +server configvirtual host + + +

La directive RemoteIPTrustedProxy permet + d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + RemoteIPInternalProxy, toutes les adresses IP + intranet ou privées indiquées par de tels mandataires, y compris les + blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8 + (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas + dignes de confiance en tant qu'adresses IP distantes, et se situent + à gauche dans le contenu de l'en-tête + RemoteIPHeader.

+ + Exemple d'adresse de confiance (répartiteur de + charge + RemoteIPHeader X-Forwarded-For
+ RemoteIPTrustedProxy 10.0.2.16/28
+ RemoteIPTrustedProxy proxy.example.com + + + + + +RemoteIPTrustedProxyList +Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader +RemoteIPTrustedProxyList nom-fichier +server configvirtual host + + +

La directive RemoteIPTrustedProxyList + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.

+ +

+ + Exemple d'adresse de confiance (répartiteur de + charge + RemoteIPHeader X-Forwarded-For
+ RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst + + + conf/mandataires-de-confiance.lst contents + # Mandataires externes identifiés
+ 192.0.2.16/28 #groupe wap phone de mandataires
+ proxy.isp.example.com #un FAI bien connu + + + + + + diff --git a/docs/manual/mod/mod_remoteip.xml.meta b/docs/manual/mod/mod_remoteip.xml.meta index 0bfcf1e3be..cf645d620d 100644 --- a/docs/manual/mod/mod_remoteip.xml.meta +++ b/docs/manual/mod/mod_remoteip.xml.meta @@ -8,5 +8,6 @@ en + fr diff --git a/docs/manual/mod/mod_so.html b/docs/manual/mod/mod_so.html index 451b67ee9b..17eec825b8 100644 --- a/docs/manual/mod/mod_so.html +++ b/docs/manual/mod/mod_so.html @@ -4,6 +4,10 @@ URI: mod_so.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_so.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_so.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_so.html.en b/docs/manual/mod/mod_so.html.en index 16107c544a..4bc9595159 100644 --- a/docs/manual/mod/mod_so.html.en +++ b/docs/manual/mod/mod_so.html.en @@ -22,6 +22,7 @@

Apache Module mod_so

Available Languages: en | + fr | ja | ko | tr

@@ -183,6 +184,7 @@ of active modules

+ + + +

Description:	Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur
Statut:	Extension
Identificateur de Module:	so_module
Fichier Source:	mod_so.c
Compatibilité:	Sous Windows, c'est un module de base (toujours +inclus)

Sommaire

+ + +

Sur les systèmes d'exploitation sélectionnés, ce module peut être + utilisé pour charger des modules dans Apache en cours d'exécution + grâce au mécanisme des Dynamic Shared Object ou Objets Partagés + Dynamiquement (DSO), et évite ainsi de devoir effectuer une + recompilation.

+ +

Sous Unix, le code chargé provient en général de fichiers objet + partagés possèdant en général l'extension .so, alors + que sous Windows, l'extension peut être soit .so, soit + .dll.

+ +

Avertissement

Les modules Apache 1.3 ne peuvent pas être utilisés directement + avec Apache 2.0 - ils doivent être modifiés pour pouvoir être + chargés dynamiquement ou compilés dans Apache 2.0.

Directives

LoadFile
LoadModule

Sujets

Création de modules chargeables pour +Windows

Création de modules chargeables pour +Windows

+ +

Note

Le format des noms de modules pour Windows a été modifié avec + Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du + style "mod_foo.so".

+ +

Bien que mod_so puisse encore charger des modules possèdant un + nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la + nouvelle convention de nommage ; si vous modifiez votre module + chargeable pour la version 2.0, veuillez aussi modifier son nom pour + respecter cette nouvelle convention.

+ +

Les API des modules Apache sous Unix et Windows sont identiques. + Alors que certains modules s'appuient sur certains + aspects de l'architecture Unix non présents dans Windows, et ne + fonctionneront donc pas sur cette dernière plate-forme, de nombreux + modules fonctionnent sous Windows avec peu ou pas de modification + par rapport à leur version Unix.

+ +

Lorsqu'un module fonctionne, il peut être ajouté au serveur de + deux manières. Sous Unix, il peut être compilé dans le serveur. + Comme Apache pour Windows ne dispose pas du programme + Configure propre à Apache pour Unix, le fichier source + du module doit être ajouté au fichier projet Apache de base, et ses + symboles ajoutés au fichier os\win32\modules.c.

+ +

La seconde méthode consiste à compiler le module en tant que DLL, + à savoir une bibliothèque partagée qui pourra être chargée dans le + serveur en cours d'exécution via la directive + LoadModule. Ces modules DLL + peuvent être distribués et exécutés sur toute installation d'Apache + pour Windows, sans avoir à recompiler le serveur.

+ +

Pour créer un module DLL, il est nécessaire d'apporter une légère + modification à son fichier source : l'enregistrement du module doit + être exporté depuis la DLL (qui sera elle-même créée plus tard ; + voir plus loin). Pour ce faire, ajoutez la macro + AP_MODULE_DECLARE_DATA (définie dans les fichiers + d'en-têtes d'Apache) à la définition de l'enregistrement de votre + module. Par exemple, si votre module est déclaré comme suit :

+ +

+ module foo_module; +

+ +

Remplacez cette ligne par :

+ module AP_MODULE_DECLARE_DATA foo_module; +

+ +

Notez que cette macro ne sera prise en compte que sous Windows, + si bien que le module poura être utilisé sans changement sous Unix, + si besoin est. Alternativement, si vous êtes familier avec les + fichiers .DEF, vous pouvez les utiliser pour exporter + l'enregistrement du module.

+ +

Maintenant, nous sommes prêts à créer une DLL contenant notre + module. Il va falloir pour cela la lier avec la bibliothèque + d'export libhttpd.lib qui a été créée au cours de la compilation de + la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi + nécessaire de modifier la configuration du compilateur pour + s'assurer que les fichiers d'en-têtes d'Apache seront correctement + localisés. Vous trouverez cette bibliothèque à la racine du + répertoire des modules de votre serveur. Il est souhaitable + d'utiliser un fichier de module .dsp existant dans l'arborescence + afin de s'assurer que l'environnement de compilation est + correctement configuré, mais vous pouvez aussi comparer les options + de compilation et d'édition de liens à votre fichier .dsp.

+ +

Ceci devrait créer une version DLL de votre module. Il vous + suffit maintenant de l'enregistrer dans le répertoire + modules à la racine de votre serveur, et d'utiliser la + directive LoadModule pour la charger.

+ +

LoadFile Directive

+ + + + + + +

Description:	Liaison du fichier objet ou de la bibliothèque +spécifié
Syntaxe:	`LoadFile nom-fichier [nom-fichier] ...`
Contexte:	configuration du serveur
Statut:	Extension
Module:	mod_so

+ +

La directive LoadFile permet de lier le fichier objet ou la + bibliothèque spécifié au serveur lors du démarrage ou du redémarrage + de ce dernier ; ceci permet d'ajouter tout code additionnel + nécessaire au fonctionnement d'un module. + nom-fichier est soit un chemin absolu, soit un chemin + relatif au répertoire défini par la directive ServerRoot.

+ +

Par exemple:

+ +

LoadFile libexec/libxmlparse.so

+ + +

LoadModule Directive

+ + + + + + +

Description:	Liaison avec le serveur du fichier objet ou de la +bibliothèque spécifié, et ajout de ce dernier à la liste des modules +actifs
Syntaxe:	`LoadModule module nom-fichier`
Contexte:	configuration du serveur
Statut:	Extension
Module:	mod_so

La directive LoadModule permet de lier le fichier objet ou la + bibliothèque nom-fichier avec le serveur, et d'ajouter la + structure de module nommée module à la liste des modules + actifs. module est le nom de la variable externe de type + module dans le fichier, et est référencé comme Identificateur de + module dans la documentation des modules. Exemple :

+ +

+ LoadModule status_module modules/mod_status.so +

+ +

charge le module spécifié depuis le sous-répertoire des modules + situé à la racine du serveur.

+ +

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_so.xml.fr b/docs/manual/mod/mod_so.xml.fr new file mode 100644 index 0000000000..1578b9bf01 --- /dev/null +++ b/docs/manual/mod/mod_so.xml.fr @@ -0,0 +1,190 @@ + + + + + + + + + + + +mod_so +Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur +Extension +mod_so.c +so_module +Sous Windows, c'est un module de base (toujours +inclus) + +

+ +

Sous Unix, le code chargé provient en général de fichiers objet + partagés possèdant en général l'extension .so, alors + que sous Windows, l'extension peut être soit .so, soit + .dll.

+ + Avertissement +

Les modules Apache 1.3 ne peuvent pas être utilisés directement + avec Apache 2.0 - ils doivent être modifiés pour pouvoir être + chargés dynamiquement ou compilés dans Apache 2.0.

+ +

Création de modules chargeables pour +Windows + + Note +

Le format des noms de modules pour Windows a été modifié avec + Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du + style "mod_foo.so".

+ +

+ + + module foo_module; + + +

Remplacez cette ligne par :

+ + module AP_MODULE_DECLARE_DATA foo_module; + + +

+ +

+ + +LoadFile +Liaison du fichier objet ou de la bibliothèque +spécifié +LoadFile nom-fichier [nom-fichier] ... + +server config + + + + +

+ +

Par exemple:

+ + LoadFile libexec/libxmlparse.so + + + + + +LoadModule +Liaison avec le serveur du fichier objet ou de la +bibliothèque spécifié, et ajout de ce dernier à la liste des modules +actifs +LoadModule module nom-fichier + +server config + + + +

+ + + LoadModule status_module modules/mod_status.so + + +

charge le module spécifié depuis le sous-répertoire des modules + situé à la racine du serveur.

+ + + + + diff --git a/docs/manual/mod/mod_so.xml.meta b/docs/manual/mod/mod_so.xml.meta index d31c4ebdf0..617e01ebee 100644 --- a/docs/manual/mod/mod_so.xml.meta +++ b/docs/manual/mod/mod_so.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko tr diff --git a/docs/manual/mod/mod_status.html b/docs/manual/mod/mod_status.html index 065e8e1228..22c6f0e3e9 100644 --- a/docs/manual/mod/mod_status.html +++ b/docs/manual/mod/mod_status.html @@ -4,6 +4,10 @@ URI: mod_status.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_status.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_status.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_status.html.en b/docs/manual/mod/mod_status.html.en index dfe08c31b3..51e86d173f 100644 --- a/docs/manual/mod/mod_status.html.en +++ b/docs/manual/mod/mod_status.html.en @@ -22,6 +22,7 @@

Apache Module mod_status

Available Languages: en | + fr | ja | ko | tr

@@ -192,6 +193,7 @@ of a request or the last 63, assuming the request itself is greater than

Available Languages: en | + fr | ja | ko | tr

diff --git a/docs/manual/mod/mod_status.html.fr b/docs/manual/mod/mod_status.html.fr new file mode 100644 index 0000000000..7ad1e33371 --- /dev/null +++ b/docs/manual/mod/mod_status.html.fr @@ -0,0 +1,208 @@ + + + +mod_status - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Modules

Module Apache mod_status

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ + + +

Description:	Fournit des informations sur les performances et l'activité +du serveur
Statut:	Base
Identificateur de Module:	status_module
Fichier Source:	mod_status.c

Sommaire

+ +

Le module Status permet à un administrateur de déterminer le + niveau de performances de son serveur. Les statistiques instantanées + du serveur sont présentées dans une page HTML sous une forme + aisément lisible. Si nécessaire, cette page peut être configurée + pour être automatiquement actualisée (sous réserve de + compatibilité du navigateur). Une autre page fournit l'état + instantané du serveur sous la forme d'une simple liste lisible par + une machine.

+ +

Les détails fournis sont :

+ +

Le nombre de processus servant les requêtes
Le nombre de processus inactifs
L'état de chaque processus, le nombre de requêtes qu'il a + traitées et le nombre total d'octets qu'il a servis (*)
Le nombre total d'accès effectués et d'octets servis (*)
Le moment où le serveur a été démarré/redémarré et le temps + écoulé depuis
Les valeurs moyennes du nombre de requêtes par seconde, du + nombre d'octets servis par seconde et du nombre d'octets par + requête (*)
Le pourcentage CPU instantané utilisé par chaque processus et + par Apache tout entier (*)
Les hôtes et requêtes actuellement en cours de traitement + (*)

+ +

Les lignes se terminant par "(*)" ne sont disponibles que si la + directive ExtendedStatus + est définie à On.

Directives

ExtendedStatus
SeeRequestTail

Sujets

Activation du rapport d'état
Actualisation automatique
Fichier d'état lisible par une machine

Activation du rapport d'état

+ + +

Pour n'activer les rapports d'état que pour les navigateurs + appartenent au domaine exemple.com, ajoutez ces lignes à votre + fichier de configuration httpd.conf :

+ <Location /etat-serveur> + SetHandler server-status + + Order Deny,Allow + Deny from all + Allow from .exemple.com + </Location> +

+ +

Il est alors possible d'obtenir les statistiques du serveur en + utilisant un navigateur web et en accédant à la page + http://votre.serveur/etat-serveur.

Actualisation automatique

+ + +

Vous pouvez faire en sorte que cette page d'état s'actualise + elle-même automatiquement si votre navigateur supporte "refresh". + Pour ce faire, accédez à la page + http://votre.serveur/etat-serveur?refresh=N, pour que + cette dernière soit actualisée toutes les N secondes.

+ +

Fichier d'état lisible par une machine

+ + +

La page http://votre.serveur/etat-serveur?auto + permet d'obtenir une version du fichier d'état lisible par une + machine. Ceci s'avère intéressant dans le cadre d'une exécution + automatique : voir le programme en Perl + log_server_statussitué dans le répertoire + /support de la distribution d'Apache.

+ +

+ Veuillez noter que si mod_status a été + compilé dans le serveur, son gestionnaire sera disponible dans + tous les fichiers de configuration, y compris les + fichiers de configuration de niveau répertoire (par + exemple .htaccess), ce qui peut avoir des + répercutions quant à la sécurité de votre site. +

+ +

ExtendedStatus Directive

+ + + + + + + +

Description:	Extrait des informations d'état étendues pour chaque +requête
Syntaxe:	`ExtendedStatus On\|Off`
Défaut:	`ExtendedStatus Off`
Contexte:	configuration du serveur
Statut:	Base
Module:	mod_status

Cette directive s'applique au serveur dans son ensemble, et ne + peut pas être activée/désactivée pour un serveur virtuel + particulier. Notez que l'extraction des informations d'état étendues + peut ralentir le serveur.

+ +

SeeRequestTail Directive

+ + + + + + + + +

Description:	Détermine si mod_status affiche les 63 premiers caractères +d'une requête ou les 63 derniers, en supposant que la requête +elle-même possède plus de 63 caractères.
Syntaxe:	`SeeRequestTail On\|Off`
Défaut:	`SeeRequestTail Off`
Contexte:	configuration du serveur
Statut:	Base
Module:	mod_status
Compatibilité:	Disponible depuis la version 2.2.7 +d'Apache.

Avec ExtendedStatus On, mod_status affiche la + véritable requête en cours de traitement. Pour des raisons + historiques, seuls 63 caractères de la requête sont réellement + stockés à des fins d'affichage. Cette directive permet de déterminer + si ce sont les 63 premiers caractères qui seront stockés (c'est le + comportement par défaut et celui des versions antérieures à 2.2.7), + ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que + si la taille de la requête est de 64 caractères ou plus.

+ +

Si Apache traite la requête GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1 + , l'affichage de la requête par mod_status se présentera comme suit : +

+ + + + + + + + + + +

Off (défaut)	GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu
On	apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1

+ + +

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ \ No newline at end of file diff --git a/docs/manual/mod/mod_status.xml.fr b/docs/manual/mod/mod_status.xml.fr new file mode 100644 index 0000000000..6432473fc7 --- /dev/null +++ b/docs/manual/mod/mod_status.xml.fr @@ -0,0 +1,189 @@ + + + + + + + + + + + +mod_status +Fournit des informations sur les performances et l'activité +du serveur +Base +mod_status.c +status_module + + +

+ +

Les détails fournis sont :

+ +

Le nombre de processus servant les requêtes
Le nombre de processus inactifs
L'état de chaque processus, le nombre de requêtes qu'il a + traitées et le nombre total d'octets qu'il a servis (*)
Le nombre total d'accès effectués et d'octets servis (*)
Le moment où le serveur a été démarré/redémarré et le temps + écoulé depuis
Les valeurs moyennes du nombre de requêtes par seconde, du + nombre d'octets servis par seconde et du nombre d'octets par + requête (*)
Le pourcentage CPU instantané utilisé par chaque processus et + par Apache tout entier (*)
Les hôtes et requêtes actuellement en cours de traitement + (*)

+ +

Les lignes se terminant par "(*)" ne sont disponibles que si la + directive ExtendedStatus + est définie à On.

+ +

+ Activation du rapport d'état + +

Pour n'activer les rapports d'état que pour les navigateurs + appartenent au domaine exemple.com, ajoutez ces lignes à votre + fichier de configuration httpd.conf :

+ + <Location /etat-serveur>
+ SetHandler server-status
+
+ Order Deny,Allow
+ Deny from all
+ Allow from .exemple.com
+ </Location> + + +

Il est alors possible d'obtenir les statistiques du serveur en + utilisant un navigateur web et en accédant à la page + http://votre.serveur/etat-serveur.

+ +

+ + Actualisation automatique +

+ +

+ + Fichier d'état lisible par une machine +

+ + + Veuillez noter que si mod_status a été + compilé dans le serveur, son gestionnaire sera disponible dans + tous les fichiers de configuration, y compris les + fichiers de configuration de niveau répertoire (par + exemple .htaccess), ce qui peut avoir des + répercutions quant à la sécurité de votre site. + + +

+ + + +ExtendedStatus +Extrait des informations d'état étendues pour chaque +requête +ExtendedStatus On|Off +ExtendedStatus Off +server config + + +

+ + + + + +SeeRequestTail +Détermine si mod_status affiche les 63 premiers caractères +d'une requête ou les 63 derniers, en supposant que la requête +elle-même possède plus de 63 caractères. +SeeRequestTail On|Off +SeeRequestTail Off +server config +Disponible depuis la version 2.2.7 +d'Apache. + + +

+ +

Si Apache traite la requête GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1 + , l'affichage de la requête par mod_status se présentera comme suit : +

+ + + + + + + + + + +

Off (défaut)	GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu
On	apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1

+ + + + + + + diff --git a/docs/manual/mod/mod_status.xml.meta b/docs/manual/mod/mod_status.xml.meta index 02f8e8faf9..1fbf83f309 100644 --- a/docs/manual/mod/mod_status.xml.meta +++ b/docs/manual/mod/mod_status.xml.meta @@ -8,6 +8,7 @@ en + fr ja ko tr