diff options
| author | Vincent Deffontaines <gryzor@apache.org> | 2009-11-01 20:13:27 +0000 |
|---|---|---|
| committer | Vincent Deffontaines <gryzor@apache.org> | 2009-11-01 20:13:27 +0000 |
| commit | a2ec53c54ec90c1b9004c559c32cf26562f69ceb (patch) | |
| tree | 8f119d6258ccce48f6a178dc42df534fd1e10cc0 /docs | |
| parent | 2eb4d470d406e22d207fa057c959acd004d18ece (diff) | |
| download | httpd-a2ec53c54ec90c1b9004c559c32cf26562f69ceb.tar.gz | |
A handful of new french doc translations.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@831756 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs')
46 files changed, 4907 insertions, 12 deletions
diff --git a/docs/manual/mod/allmodules.xml.fr b/docs/manual/mod/allmodules.xml.fr index acab276b6f..68a08917ff 100644 --- a/docs/manual/mod/allmodules.xml.fr +++ b/docs/manual/mod/allmodules.xml.fr @@ -3,15 +3,15 @@ <modulefilelist> <modulefile>core.xml.fr</modulefile> - <modulefile>mod_access_compat.xml</modulefile> - <modulefile>mod_actions.xml</modulefile> + <modulefile>mod_access_compat.xml.fr</modulefile> + <modulefile>mod_actions.xml.fr</modulefile> <modulefile>mod_alias.xml.fr</modulefile> - <modulefile>mod_asis.xml</modulefile> + <modulefile>mod_asis.xml.fr</modulefile> <modulefile>mod_auth_basic.xml.fr</modulefile> - <modulefile>mod_auth_digest.xml</modulefile> + <modulefile>mod_auth_digest.xml.fr</modulefile> <modulefile>mod_auth_form.xml</modulefile> <modulefile>mod_authn_anon.xml</modulefile> - <modulefile>mod_authn_core.xml</modulefile> + <modulefile>mod_authn_core.xml.fr</modulefile> <modulefile>mod_authn_dbd.xml</modulefile> <modulefile>mod_authn_dbm.xml</modulefile> <modulefile>mod_authn_file.xml.fr</modulefile> @@ -45,7 +45,7 @@ <modulefile>mod_ext_filter.xml</modulefile> <modulefile>mod_file_cache.xml</modulefile> <modulefile>mod_filter.xml</modulefile> - <modulefile>mod_headers.xml</modulefile> + <modulefile>mod_headers.xml.fr</modulefile> <modulefile>mod_heartbeat.xml</modulefile> <modulefile>mod_heartmonitor.xml</modulefile> <modulefile>mod_ident.xml.fr</modulefile> @@ -93,14 +93,14 @@ <modulefile>mod_status.xml.fr</modulefile> <modulefile>mod_substitute.xml</modulefile> <modulefile>mod_suexec.xml</modulefile> - <modulefile>mod_unique_id.xml</modulefile> + <modulefile>mod_unique_id.xml.fr</modulefile> <modulefile>mod_unixd.xml</modulefile> <modulefile>mod_userdir.xml</modulefile> <modulefile>mod_usertrack.xml</modulefile> <modulefile>mod_version.xml</modulefile> <modulefile>mod_vhost_alias.xml</modulefile> <modulefile>mpm_common.xml</modulefile> - <modulefile>event.xml</modulefile> + <modulefile>event.xml.fr</modulefile> <modulefile>mpm_netware.xml</modulefile> <modulefile>mpmt_os2.xml</modulefile> <modulefile>prefork.xml</modulefile> diff --git a/docs/manual/mod/event.html b/docs/manual/mod/event.html index 082d1215fa..1da582d8f6 100644 --- a/docs/manual/mod/event.html +++ b/docs/manual/mod/event.html @@ -3,3 +3,7 @@ URI: event.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: event.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/event.html.en b/docs/manual/mod/event.html.en index 7b09c7e046..5cd349a446 100644 --- a/docs/manual/mod/event.html.en +++ b/docs/manual/mod/event.html.en @@ -21,7 +21,8 @@ <div id="page-content"> <div id="preamble"><h1>Apache MPM event</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/mod/event.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/event.html" title="English"> en </a> | +<a href="../fr/mod/event.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>A variant of the <code class="module"><a href="../mod/worker.html">worker</a></code> MPM with the goal of consuming threads only for connections with active processing</td></tr> @@ -128,7 +129,8 @@ of consuming threads only for connections with active processing</td></tr> </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/mod/event.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/event.html" title="English"> en </a> | +<a href="../fr/mod/event.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/mod/event.html.fr b/docs/manual/mod/event.html.fr new file mode 100644 index 0000000000..227cf528ef --- /dev/null +++ b/docs/manual/mod/event.html.fr @@ -0,0 +1,145 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>event - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Apache MPM event</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/event.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/event.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Une variante du MPM <code class="module"><a href="../mod/worker.html">worker</a></code> conçue pour ne +mobiliser des threads que pour les connexions en cours de traitement</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>MPM</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>mpm_event_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>event.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Le module multi-processus (MPM) <code class="module"><a href="../mod/event.html">event</a></code> est conçu + pour permettre le traitement d'un nombre accru de requêtes + simultanées en déléguant certaines tâches à des threads de support, + libérant par là-même le thread principal et lui permettant de + traiter les nouvelles requêtes. Il s'inspire du MPM + <code class="module"><a href="../mod/worker.html">worker</a></code> qui implémente un serveur hybride + multi-processus/multi-threads. Les directives de configuration à + l'exécution sont identiques à celles du MPM + <code class="module"><a href="../mod/worker.html">worker</a></code>.</p> + + <p>Pour utiliser le MPM <code class="module"><a href="../mod/event.html">event</a></code>, ajoutez + <code>--with-mpm=event</code> aux arguments du script + <code class="program"><a href="../programs/configure.html">configure</a></code> lorsque vous compilez le programme + <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p> + +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#acceptmutex">AcceptMutex</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#enableexceptionhook">EnableExceptionHook</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#group">Group</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listen">Listen</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listenbacklog">ListenBacklog</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#lockfile">LockFile</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxclients">MaxClients</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxmemfree">MaxMemFree</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#pidfile">PidFile</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#serverlimit">ServerLimit</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#startservers">StartServers</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadlimit">ThreadLimit</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadstacksize">ThreadStackSize</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#user">User</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#how-it-works">Comment tout cela fonctionne</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#requirements">Prérequis</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><a href="worker.html">Le MPM worker</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="how-it-works" id="how-it-works">Comment tout cela fonctionne</a></h2> + <p>Ce MPM essaie de résoudre le 'problème keep alive' de HTTP. + Lorsqu'un client a soumis une première requête, il peut garder la + connexion ouverte, et envoyer les requêtes suivantes en utilisant le + même socket. Ceci permet de réduire de manière significative la + surcharge due à la création de connexions TCP. Cependant, Apache + mobilise en principe à cet effet un processus/thread enfant en + attente des données du client, ce qui amène son propre lot + d'inconvénients. Pour résoudre ce problème, <code class="module"><a href="../mod/event.html">event</a></code> + utilise un thread dédié qui gère non seulement les sockets en + écoute, mais aussi tous les sockets en état Keep Alive.</p> + + <p>Le MPM présuppose que l'implémentation <code>apr_pollset</code> + sous-jacente est raisonnablement sûre du point de vue des threads. + Ceci permet au MPM d'éviter un verrouillage de haut niveau excessif, + ou de devoir activer le thread en écoute afin de lui envoyer un + socket keep alive. Tout ceci n'est actuellement compatible qu'avec + KQueue et EPoll.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="requirements" id="requirements">Prérequis</a></h2> + <p>Ce MPM dépend des opérations atomiques compare-and-swap + d'<a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> pour la synchronisation des threads. Si + vous compilez pour une plate-forme x86 et n'avez pas besoin du + support 386, ou si vous compilez pour une plate-forme SPARC et + n'avez pas besoin du support pre-UltraSPARC, ajoutez + <code>--enable-nonportable-atomics=yes</code> aux arguments du + script <code class="program"><a href="../programs/configure.html">configure</a></code>. Ceci permettra à APR + d'implémenter les opérations atomiques en utilisant des instructions + performantes indisponibles avec les processeurs plus + anciens.</p> + + <p>Ce MPM ne fonctionne pas de manière optimale sur les + plates-formes plus anciennes qui ne gèrent pas correctement les + threads, mais ce problème est sans objet du fait du prérequis + concernant EPoll ou KQueue.</p> + + <ul> + + <li>Pour utiliser ce MPM sous FreeBSD, la version 5.3 ou + supérieure de ce système est recommandée. Il est cependant + possible d'exécuter ce MPM sous FreeBSD 5.2.1 si vous utilisez + <code>libkse</code> (voir <code>man libmap.conf</code>).</li> + + <li>Pour NetBSD, il est recommander d'utiliser la version 2.0 ou + supérieure.</li> + + <li>Pour Linux, un noyau 2.6 est recommandé. Il faut aussi + s'assurer que votre version de <code>glibc</code> a été compilée + avec le support pour EPoll.</li> + + </ul> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/event.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/event.html" title="Français"> fr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/event.xml.fr b/docs/manual/mod/event.xml.fr new file mode 100644 index 0000000000..02ed340429 --- /dev/null +++ b/docs/manual/mod/event.xml.fr @@ -0,0 +1,150 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 759115 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="event.xml.meta"> +<name>event</name> +<description>Une variante du MPM <module>worker</module> conçue pour ne +mobiliser des threads que pour les connexions en cours de traitement</description> +<status>MPM</status> +<sourcefile>event.c</sourcefile> +<identifier>mpm_event_module</identifier> + +<summary> + <p>Le module multi-processus (MPM) <module>event</module> est conçu + pour permettre le traitement d'un nombre accru de requêtes + simultanées en déléguant certaines tâches à des threads de support, + libérant par là-même le thread principal et lui permettant de + traiter les nouvelles requêtes. Il s'inspire du MPM + <module>worker</module> qui implémente un serveur hybride + multi-processus/multi-threads. Les directives de configuration à + l'exécution sont identiques à celles du MPM + <module>worker</module>.</p> + + <p>Pour utiliser le MPM <module>event</module>, ajoutez + <code>--with-mpm=event</code> aux arguments du script + <program>configure</program> lorsque vous compilez le programme + <program>httpd</program>.</p> + +</summary> + +<seealso><a href="worker.html">Le MPM worker</a></seealso> + +<section id="how-it-works"><title>Comment tout cela fonctionne</title> + <p>Ce MPM essaie de résoudre le 'problème keep alive' de HTTP. + Lorsqu'un client a soumis une première requête, il peut garder la + connexion ouverte, et envoyer les requêtes suivantes en utilisant le + même socket. Ceci permet de réduire de manière significative la + surcharge due à la création de connexions TCP. Cependant, Apache + mobilise en principe à cet effet un processus/thread enfant en + attente des données du client, ce qui amène son propre lot + d'inconvénients. Pour résoudre ce problème, <module>event</module> + utilise un thread dédié qui gère non seulement les sockets en + écoute, mais aussi tous les sockets en état Keep Alive.</p> + + <p>Le MPM présuppose que l'implémentation <code>apr_pollset</code> + sous-jacente est raisonnablement sûre du point de vue des threads. + Ceci permet au MPM d'éviter un verrouillage de haut niveau excessif, + ou de devoir activer le thread en écoute afin de lui envoyer un + socket keep alive. Tout ceci n'est actuellement compatible qu'avec + KQueue et EPoll.</p> + +</section> +<section id="requirements"><title>Prérequis</title> + <p>Ce MPM dépend des opérations atomiques compare-and-swap + d'<glossary>APR</glossary> pour la synchronisation des threads. Si + vous compilez pour une plate-forme x86 et n'avez pas besoin du + support 386, ou si vous compilez pour une plate-forme SPARC et + n'avez pas besoin du support pre-UltraSPARC, ajoutez + <code>--enable-nonportable-atomics=yes</code> aux arguments du + script <program>configure</program>. Ceci permettra à APR + d'implémenter les opérations atomiques en utilisant des instructions + performantes indisponibles avec les processeurs plus + anciens.</p> + + <p>Ce MPM ne fonctionne pas de manière optimale sur les + plates-formes plus anciennes qui ne gèrent pas correctement les + threads, mais ce problème est sans objet du fait du prérequis + concernant EPoll ou KQueue.</p> + + <ul> + + <li>Pour utiliser ce MPM sous FreeBSD, la version 5.3 ou + supérieure de ce système est recommandée. Il est cependant + possible d'exécuter ce MPM sous FreeBSD 5.2.1 si vous utilisez + <code>libkse</code> (voir <code>man libmap.conf</code>).</li> + + <li>Pour NetBSD, il est recommander d'utiliser la version 2.0 ou + supérieure.</li> + + <li>Pour Linux, un noyau 2.6 est recommandé. Il faut aussi + s'assurer que votre version de <code>glibc</code> a été compilée + avec le support pour EPoll.</li> + + </ul> +</section> + +<directivesynopsis location="mpm_common"><name>AcceptMutex</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>Group</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>Listen</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ListenBacklog</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>SendBufferSize</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>LockFile</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MaxClients</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MaxMemFree</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MaxSpareThreads</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MinSpareThreads</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>PidFile</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ScoreBoardFile</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ServerLimit</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>StartServers</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ThreadLimit</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ThreadsPerChild</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ThreadStackSize</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>User</name> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/event.xml.meta b/docs/manual/mod/event.xml.meta index 8ce2575e0a..80214bc52f 100644 --- a/docs/manual/mod/event.xml.meta +++ b/docs/manual/mod/event.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/index.html b/docs/manual/mod/index.html index a7474c15b6..470a4782fa 100644 --- a/docs/manual/mod/index.html +++ b/docs/manual/mod/index.html @@ -12,6 +12,10 @@ URI: index.html.es Content-Language: es Content-type: text/html; charset=ISO-8859-1 +URI: index.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: index.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/index.html.en b/docs/manual/mod/index.html.en index 809a048240..3ee60627e5 100644 --- a/docs/manual/mod/index.html.en +++ b/docs/manual/mod/index.html.en @@ -21,6 +21,7 @@ <p><span>Available Languages: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/" title="English"> en </a> | <a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> @@ -214,6 +215,7 @@ hosting</dd> <p><span>Available Languages: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/" title="English"> en </a> | <a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> diff --git a/docs/manual/mod/index.html.fr b/docs/manual/mod/index.html.fr new file mode 100644 index 0000000000..13732bf893 --- /dev/null +++ b/docs/manual/mod/index.html.fr @@ -0,0 +1,232 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Index des modules - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="module-index"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Index des modules</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch"> de </a> | +<a href="../en/mod/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/" title="Français"> fr </a> | +<a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div> + + <p> + Ci-dessous se trouve la liste de tous les modules qui font partie de + la distribution Apache. Voir aussi la liste alphabétique complète + de <a href="directives.html">toutes les directives Apache</a>. + </p> + </div> +<div id="quickview"><ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#core">Fonctionalités de Base et Modules Multi-Processus (MPM)</a></li><li><img alt="" src="../images/down.gif" /> <a href="#other">Autres Modules</a></li></ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><a href="../mpm.html">Modules multi-processus (MPMs)</a> + </li> +<li><a href="quickreference.html">Document de référence rapide des directives</a> + </li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"><h2><a id="core" name="core">Fonctionalités de Base et Modules Multi-Processus (MPM)</a></h2> +<dl> +<dt><a href="core.html">core</a></dt><dd>Fonctionnalités de base du serveur HTTP Apache toujours +disponibles</dd> +<dt><a href="mpm_common.html">mpm_common</a></dt><dd class="separate">A collection of directives that are implemented by +more than one multi-processing module (MPM)</dd> +<dt><a href="event.html">event</a></dt><dd>Une variante du MPM <code class="module"><a href="../mod/worker.html">worker</a></code> conçue pour ne +mobiliser des threads que pour les connexions en cours de traitement</dd> +<dt><a href="mpm_netware.html">mpm_netware</a></dt><dd>Multi-Processing Module implementing an exclusively threaded web + server optimized for Novell NetWare</dd> +<dt><a href="mpmt_os2.html">mpmt_os2</a></dt><dd>Hybrid multi-process, multi-threaded MPM for OS/2</dd> +<dt><a href="prefork.html">prefork</a></dt><dd>Implements a non-threaded, pre-forking web server</dd> +<dt><a href="mpm_winnt.html">mpm_winnt</a></dt><dd>This Multi-Processing Module is optimized for Windows +NT.</dd> +<dt><a href="worker.html">worker</a></dt><dd>Multi-Processing Module implementing a hybrid + multi-threaded multi-process web server</dd> +</dl></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"><h2><a id="other" name="other">Autres Modules</a></h2> +<p class="letters"><a href="#A"> A </a> | <a href="#B"> B </a> | <a href="#C"> C </a> | <a href="#D"> D </a> | <a href="#E"> E </a> | <a href="#F"> F </a> | <a href="#H"> H </a> | <a href="#I"> I </a> | <a href="#L"> L </a> | <a href="#M"> M </a> | <a href="#N"> N </a> | <a href="#P"> P </a> | <a href="#R"> R </a> | <a href="#S"> S </a> | <a href="#U"> U </a> | <a href="#V"> V </a></p> +<dl><dt><a href="mod_access_compat.html" id="A" name="A">mod_access_compat</a></dt><dd>Autorisations de groupe à base de nom d'hôte (nom ou +adresse IP)</dd> +<dt><a href="mod_actions.html">mod_actions</a></dt><dd>Ce module permet l'exécution des scripts CGI en fonction du +type de média ou de la méthode de requête.</dd> +<dt><a href="mod_alias.html">mod_alias</a></dt><dd>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</dd> +<dt><a href="mod_asis.html">mod_asis</a></dt><dd>Envoie des fichiers contenant leurs propres en-têtes +HTTP</dd> +<dt><a href="mod_auth_basic.html">mod_auth_basic</a></dt><dd>Authentification de base</dd> +<dt><a href="mod_auth_digest.html">mod_auth_digest</a></dt><dd>Authentification utilisateur utilisant les condensés +MD5</dd> +<dt><a href="mod_auth_form.html">mod_auth_form</a></dt><dd>Form authentication</dd> +<dt><a href="mod_authn_anon.html">mod_authn_anon</a></dt><dd>Allows "anonymous" user access to authenticated + areas</dd> +<dt><a href="mod_authn_core.html">mod_authn_core</a></dt><dd>Le noyau de l'authentification</dd> +<dt><a href="mod_authn_dbd.html">mod_authn_dbd</a></dt><dd>User authentication using an SQL database</dd> +<dt><a href="mod_authn_dbm.html">mod_authn_dbm</a></dt><dd>User authentication using DBM files</dd> +<dt><a href="mod_authn_file.html">mod_authn_file</a></dt><dd>Authentification utilisateur à l'aide de fichiers +texte</dd> +<dt><a href="mod_authnz_ldap.html">mod_authnz_ldap</a></dt><dd>Permet d'utiliser un annuaire LDAP pour l'authentification +HTTP de base.</dd> +<dt><a href="mod_authz_core.html">mod_authz_core</a></dt><dd>Core Authorization</dd> +<dt><a href="mod_authz_dbd.html">mod_authz_dbd</a></dt><dd>Group Authorization and Login using SQL</dd> +<dt><a href="mod_authz_dbm.html">mod_authz_dbm</a></dt><dd>Group authorization using DBM files</dd> +<dt><a href="mod_authz_groupfile.html">mod_authz_groupfile</a></dt><dd>Group authorization using plaintext files</dd> +<dt><a href="mod_authz_host.html">mod_authz_host</a></dt><dd>Autorisations de groupe basées sur l'hôte (nom ou adresse +IP)</dd> +<dt><a href="mod_authz_owner.html">mod_authz_owner</a></dt><dd>Autorisation basée sur l'appartenance des +fichiers</dd> +<dt><a href="mod_authz_user.html">mod_authz_user</a></dt><dd>Autorisation basée sur l'utilisateur</dd> +<dt><a href="mod_autoindex.html">mod_autoindex</a></dt><dd>Génère automatiquement des index de répertoires d'une +manière similaire à la commande Unix <code>ls</code>, ou à la commande +shell Win32 <code>dir</code></dd> +<dt><a href="mod_buffer.html" id="B" name="B">mod_buffer</a></dt><dd>Support de la mise en tampon des requêtes</dd> +<dt><a href="mod_cache.html" id="C" name="C">mod_cache</a></dt><dd>Mise en cache de contenu référencé par un +URI.</dd> +<dt><a href="mod_cern_meta.html">mod_cern_meta</a></dt><dd>CERN httpd metafile semantics</dd> +<dt><a href="mod_cgi.html">mod_cgi</a></dt><dd>Execution of CGI scripts</dd> +<dt><a href="mod_cgid.html">mod_cgid</a></dt><dd>Execution of CGI scripts using an + external CGI daemon</dd> +<dt><a href="mod_charset_lite.html">mod_charset_lite</a></dt><dd>Specify character set translation or recoding</dd> +<dt><a href="mod_dav.html" id="D" name="D">mod_dav</a></dt><dd>Distributed Authoring and Versioning +(<a href="http://www.webdav.org/">WebDAV</a>) functionality</dd> +<dt><a href="mod_dav_fs.html">mod_dav_fs</a></dt><dd>filesystem provider for <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></dd> +<dt><a href="mod_dav_lock.html">mod_dav_lock</a></dt><dd>generic locking module for <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></dd> +<dt><a href="mod_dbd.html">mod_dbd</a></dt><dd>Manages SQL database connections</dd> +<dt><a href="mod_deflate.html">mod_deflate</a></dt><dd>Comprime le contenu avant de le servir au +client</dd> +<dt><a href="mod_dir.html">mod_dir</a></dt><dd>Permet la redirection des adresses se terminant par un +répertoire sans slash de fin et la mise à disposition des fichiers index +de répertoire</dd> +<dt><a href="mod_disk_cache.html">mod_disk_cache</a></dt><dd>Gestionnaire de stockage du cache de contenu à base +d'URIs</dd> +<dt><a href="mod_dumpio.html">mod_dumpio</a></dt><dd>Dumps all I/O to error log as desired.</dd> +<dt><a href="mod_echo.html" id="E" name="E">mod_echo</a></dt><dd>Un simple serveur d'écho pour illustrer les modules de +protocole</dd> +<dt><a href="mod_env.html">mod_env</a></dt><dd>Modifie l'environnement transmis aux scripts CGI et aux +pages SSI</dd> +<dt><a href="mod_example.html">mod_example</a></dt><dd>Illustrates the Apache module API</dd> +<dt><a href="mod_expires.html">mod_expires</a></dt><dd>Génération des en-têtes HTTP <code>Expires</code> et +<code>Cache-Control</code> en fonction de critères spécifiés par +l'utilisateur</dd> +<dt><a href="mod_ext_filter.html">mod_ext_filter</a></dt><dd>Pass the response body through an external program before +delivery to the client</dd> +<dt><a href="mod_file_cache.html" id="F" name="F">mod_file_cache</a></dt><dd>Caches a static list of files in memory</dd> +<dt><a href="mod_filter.html">mod_filter</a></dt><dd>Context-sensitive smart filter configuration module</dd> +<dt><a href="mod_headers.html" id="H" name="H">mod_headers</a></dt><dd>Personnalisation des en-têtes de requêtes et de réponses +HTTP</dd> +<dt><a href="mod_heartbeat.html">mod_heartbeat</a></dt><dd /> +<dt><a href="mod_heartmonitor.html">mod_heartmonitor</a></dt><dd /> +<dt><a href="mod_ident.html" id="I" name="I">mod_ident</a></dt><dd>Recherche d'identité conformément à la RFC +1413</dd> +<dt><a href="mod_imagemap.html">mod_imagemap</a></dt><dd>Server-side imagemap processing</dd> +<dt><a href="mod_include.html">mod_include</a></dt><dd>Server-parsed html documents (Server Side Includes)</dd> +<dt><a href="mod_info.html">mod_info</a></dt><dd>Affiche une présentation complète de la configuration du +serveur</dd> +<dt><a href="mod_isapi.html">mod_isapi</a></dt><dd>ISAPI Extensions within Apache for Windows</dd> +<dt><a href="mod_lbmethod_bybusyness.html" id="L" name="L">mod_lbmethod_bybusyness</a></dt><dd>Pending Request Counting load balancer scheduler algorithm for <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dd> +<dt><a href="mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></dt><dd>Request Counting load balancer scheduler algorithm for <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dd> +<dt><a href="mod_lbmethod_bytraffic.html">mod_lbmethod_bytraffic</a></dt><dd>Weighted Traffic Counting load balancer scheduler algorithm for <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dd> +<dt><a href="mod_lbmethod_heartbeat.html">mod_lbmethod_heartbeat</a></dt><dd> This document is still under development.</dd> +<dt><a href="mod_ldap.html">mod_ldap</a></dt><dd>Conservation des connexions LDAP et services de mise en +cache du résultat à destination des autres modules LDAP</dd> +<dt><a href="mod_log_config.html">mod_log_config</a></dt><dd>Logging of the requests made to the server</dd> +<dt><a href="mod_log_forensic.html">mod_log_forensic</a></dt><dd>Forensic Logging of the requests made to the server</dd> +<dt><a href="mod_logio.html">mod_logio</a></dt><dd>Logging of input and output bytes per request</dd> +<dt><a href="mod_mime.html" id="M" name="M">mod_mime</a></dt><dd>Associates the requested filename's extensions + with the file's behavior (handlers and filters) + and content (mime-type, language, character set and + encoding)</dd> +<dt><a href="mod_mime_magic.html">mod_mime_magic</a></dt><dd>Determines the MIME type of a file + by looking at a few bytes of its contents</dd> +<dt><a href="mod_negotiation.html" id="N" name="N">mod_negotiation</a></dt><dd>Effectue la <a href="../content-negotiation.html">négociation de +contenu</a></dd> +<dt><a href="mod_nw_ssl.html">mod_nw_ssl</a></dt><dd>Enable SSL encryption for NetWare</dd> +<dt><a href="mod_privileges.html" id="P" name="P">mod_privileges</a></dt><dd>Support for Solaris privileges and for running virtual hosts +under different user IDs.</dd> +<dt><a href="mod_proxy.html">mod_proxy</a></dt><dd>Serveur mandataire/passerelle HTTP/1.1</dd> +<dt><a href="mod_proxy_ajp.html">mod_proxy_ajp</a></dt><dd>AJP support module for +<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> +<dt><a href="mod_proxy_balancer.html">mod_proxy_balancer</a></dt><dd><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> extension for load balancing </dd> +<dt><a href="mod_proxy_connect.html">mod_proxy_connect</a></dt><dd><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> extension for +<code>CONNECT</code> request handling</dd> +<dt><a href="mod_proxy_fcgi.html">mod_proxy_fcgi</a></dt><dd>FastCGI support module for +<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> +<dt><a href="mod_proxy_fdpass.html">mod_proxy_fdpass</a></dt><dd>fdpass external process support module for +<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> +<dt><a href="mod_proxy_ftp.html">mod_proxy_ftp</a></dt><dd>FTP support module for +<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> +<dt><a href="mod_proxy_http.html">mod_proxy_http</a></dt><dd>Module fournissant le support HTTP à +<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> +<dt><a href="mod_proxy_scgi.html">mod_proxy_scgi</a></dt><dd>SCGI gateway module for <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd> +<dt><a href="mod_remoteip.html" id="R" name="R">mod_remoteip</a></dt><dd>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. +</dd> +<dt><a href="mod_reqtimeout.html">mod_reqtimeout</a></dt><dd>Set timeout and minimum data rate for receiving requests +</dd> +<dt><a href="mod_request.html">mod_request</a></dt><dd>Filters to handle and make available HTTP request bodies</dd> +<dt><a href="mod_rewrite.html">mod_rewrite</a></dt><dd>Ce module fournit un moteur de réécriture à base de +règles permettant de réécrire les URLs des requêtes +à la volée</dd> +<dt><a href="mod_sed.html" id="S" name="S">mod_sed</a></dt><dd>Filtre les contenus en entrée (requêtes) et en sortie +(réponses) en utilisant la syntaxe de <code>sed</code></dd> +<dt><a href="mod_session.html">mod_session</a></dt><dd>Session support</dd> +<dt><a href="mod_session_cookie.html">mod_session_cookie</a></dt><dd>Cookie based session support</dd> +<dt><a href="mod_session_crypto.html">mod_session_crypto</a></dt><dd>Session encryption support</dd> +<dt><a href="mod_session_dbd.html">mod_session_dbd</a></dt><dd>DBD/SQL based session support</dd> +<dt><a href="mod_setenvif.html">mod_setenvif</a></dt><dd>Permet de définir des variables d'environnement en fonction +de caractéristiques de la requête</dd> +<dt><a href="mod_slotmem_plain.html">mod_slotmem_plain</a></dt><dd>Slot-based shared memory provider.</dd> +<dt><a href="mod_slotmem_shm.html">mod_slotmem_shm</a></dt><dd>Slot-based shared memory provider.</dd> +<dt><a href="mod_so.html">mod_so</a></dt><dd>Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur</dd> +<dt><a href="mod_speling.html">mod_speling</a></dt><dd>Attempts to correct mistaken URLs that +users might have entered by ignoring capitalization and by +allowing up to one misspelling</dd> +<dt><a href="mod_ssl.html">mod_ssl</a></dt><dd>Strong cryptography using the Secure Sockets +Layer (SSL) and Transport Layer Security (TLS) protocols</dd> +<dt><a href="mod_status.html">mod_status</a></dt><dd>Fournit des informations sur les performances et l'activité +du serveur</dd> +<dt><a href="mod_substitute.html">mod_substitute</a></dt><dd>Perform search and replace operations on response bodies</dd> +<dt><a href="mod_suexec.html">mod_suexec</a></dt><dd>Allows CGI scripts to run as a specified user +and Group</dd> +<dt><a href="mod_unique_id.html" id="U" name="U">mod_unique_id</a></dt><dd>Fournit une variable d'environnement contenant un +identifiant unique pour chaque requête</dd> +<dt><a href="mod_unixd.html">mod_unixd</a></dt><dd>Basic (required) security for Unix-family platforms.</dd> +<dt><a href="mod_userdir.html">mod_userdir</a></dt><dd>User-specific directories</dd> +<dt><a href="mod_usertrack.html">mod_usertrack</a></dt><dd> +<em>Clickstream</em> logging of user activity on a site +</dd> +<dt><a href="mod_version.html" id="V" name="V">mod_version</a></dt><dd>Version dependent configuration</dd> +<dt><a href="mod_vhost_alias.html">mod_vhost_alias</a></dt><dd>Provides for dynamically configured mass virtual +hosting</dd> +</dl></div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch"> de </a> | +<a href="../en/mod/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../es/mod/" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/" title="Français"> fr </a> | +<a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/index.xml.fr b/docs/manual/mod/index.xml.fr new file mode 100644 index 0000000000..380602bf76 --- /dev/null +++ b/docs/manual/mod/index.xml.fr @@ -0,0 +1,38 @@ +<?xml version="1.0"?> +<!DOCTYPE moduleindex SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- LastChangedRevision English document : 420990 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<moduleindex metafile="index.xml.meta"> + <title>Index des modules</title> + <summary> + <p> + Ci-dessous se trouve la liste de tous les modules qui font partie de + la distribution Apache. Voir aussi la liste alphabétique complète + de <a href="directives.html">toutes les directives Apache</a>. + </p> + </summary> + <seealso><a href="../mpm.html">Modules multi-processus (MPMs)</a> + </seealso> + <seealso><a href="quickreference.html">Document de référence rapide des directives</a> + </seealso> +</moduleindex> diff --git a/docs/manual/mod/index.xml.meta b/docs/manual/mod/index.xml.meta index 0a1cc90508..ed63d9adc0 100644 --- a/docs/manual/mod/index.xml.meta +++ b/docs/manual/mod/index.xml.meta @@ -10,6 +10,7 @@ <variant>de</variant> <variant>en</variant> <variant>es</variant> + <variant>fr</variant> <variant>ja</variant> <variant>ko</variant> <variant>tr</variant> diff --git a/docs/manual/mod/mod_access_compat.html b/docs/manual/mod/mod_access_compat.html index 778b002afe..d142e4db74 100644 --- a/docs/manual/mod/mod_access_compat.html +++ b/docs/manual/mod/mod_access_compat.html @@ -4,6 +4,10 @@ URI: mod_access_compat.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_access_compat.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_access_compat.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_access_compat.html.en b/docs/manual/mod/mod_access_compat.html.en index a91adab23f..ff6612145f 100644 --- a/docs/manual/mod/mod_access_compat.html.en +++ b/docs/manual/mod/mod_access_compat.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_access_compat</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_access_compat.html" title="English"> en </a> | +<a href="../fr/mod/mod_access_compat.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Group authorizations based on host (name or IP @@ -446,6 +447,7 @@ later</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_access_compat.html" title="English"> en </a> | +<a href="../fr/mod/mod_access_compat.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> diff --git a/docs/manual/mod/mod_access_compat.html.fr b/docs/manual/mod/mod_access_compat.html.fr new file mode 100644 index 0000000000..719d598b5c --- /dev/null +++ b/docs/manual/mod/mod_access_compat.html.fr @@ -0,0 +1,482 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_access_compat - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_access_compat</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_access_compat.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_access_compat.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe à base de nom d'hôte (nom ou +adresse IP)</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>access_compat_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_access_compat.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans Apache 2.3 à des fins de compatibilité +avec les précédentes versions d'Apache 2.x. Les directives fournies par +ce module sont devenues obsolètes depuis la refonte d'authz. Voir +<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></td></tr></table> +<h3>Sommaire</h3> + + <p>Les directives fournies par le module + <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> s'utilisent dans les sections + <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, + <code class="directive"><a href="../mod/core.html#files"><Files></a></code> et + <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, ainsi + que dans les fichiers <code><a href="core.html#accessfilename">.htaccess</a></code> et permettent + de contrôler l'accès à certaines parties du serveur. On peut + contrôler cet accès en fonction du nom d'hôte du client, de son + adresse IP ou d'autres caractéristiques de la requête, telles + qu'elles sont enregistrées dans les <a href="../env.html">variables + d'environnement</a>. Les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> permettent de spécifier + quels clients sont ou ne sont pas autorisés à accéder au serveur, + alors que la directive <code class="directive"><a href="#order">Order</a></code> définit le statut + d'accès par défaut, et détermine la manière dont les directives + <code class="directive"><a href="#allow">Allow</a></code> et + <code class="directive"><a href="#deny">Deny</a></code> interagissent + entre elles.</p> + + <p>Les restrictions d'accès à base de nom d'hôte et + l'authentification à base de mot de passe peuvent être implémentées + simultanément. Dans ce cas, on utilise la directive <code class="directive"><a href="#satisfy">Satisfy</a></code> pour déterminer la + manière dont ces deux modes de restrictions interagissent.</p> + + <div class="warning"><h3>Note</h3> + <p>Les directives fournies par le module + <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> sont devenues obsolètes depuis + la refonte d'authz. Voir <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.</p> + </div> + + <p>En général, les directives de restriction d'accès s'appliquent à + toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, + <code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite + dans la plupart des cas. Il est cependant possible de restreindre + certaines méthodes, alors que les autres méthodes ne se verront + imposée aucune restriction, en regroupant les directives à + l'intérieur d'une section <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code>.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#allow">Allow</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#deny">Deny</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#order">Order</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#satisfy">Satisfy</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li> +<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li> +<li><code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code></li> +</ul></div> + +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Allow" id="Allow">Allow</a> <a name="allow" id="allow">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie quels hôtes peuvent accéder à une certaine zone du +serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Allow from all|<var>hôte</var>|env=[!]<var>variable +d'environnement</var> +[<var>hôte</var>|env=[!]<var>variable d'environnement</var>] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Limit</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr> +</table> + <p>La directive <code class="directive">Allow</code> permet de définir quels + hôtes ont le droit d'accéder à une certaine partie du serveur. On + peut contrôler l'accès par nom d'hôte, adresse IP, intervalle + d'adresses IP, ou toute autre caractéristique de la requête client + enregistrée dans les variables d'environnement.</p> + + <p>Le premier argument de cette directive est toujours + <code>from</code>. Les arguments suivants peuvent prendre trois + formes différentes. Si <code>Allow from all</code> est spécifié, + tout hôte se voit accordé l'accès, en tenant compte des directives + <code class="directive"><a href="#deny">Deny</a></code> et <code class="directive"><a href="#order">Order</a></code> comme décrit plus loin. + Pour ne permettre l'accès au serveur qu'à un hôte ou un groupe + d'hôtes particuliers, on peut spécifier un <em>nom d'hôte</em> sous + une des formes suivantes :</p> + + <dl> + <dt>Un nom de domaine (partiel)</dt> + + <dd> + <div class="example"><h3>Exemple :</h3><p><code> + Allow from apache.org<br /> + Allow from .net example.edu + </code></p></div> + <p>Les hôtes dont les noms correspondent ou se terminent par la + chaîne spécifiée ont l'autorisation d'accès. Seules les + composantes entières du nom d'hôte doivent correspondre ; ainsi, + dans l'exemple ci-dessus, <code>foo.apache.org</code> + correspondra, mais <code>fooapache.org</code> ne conviendra pas. + 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 <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code>. Tout d'abord, une + recherche DNS inverse sur l'adresse IP est effectuée pour + déterminer le nom d'hôte associé, puis une recherche directe sur + le nom d'hôte est effectuée afin de s'assurer 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 + concordent.</p></dd> + + <dt>Une adresse IP complète</dt> + + <dd> + <div class="example"><h3>Exemple :</h3><p><code> + Allow from 10.1.2.3<br /> + Allow from 192.168.1.104 192.168.1.205 + </code></p></div> + <p>L'adresse IP d'un hôte auquel on a accordé l'accès</p></dd> + + <dt>Une adresse IP partielle</dt> + + <dd> + <div class="example"><h3>Exemple :</h3><p><code> + Allow from 10.1<br /> + Allow from 10 172.20 192.168.2 + </code></p></div> + <p>De un à trois des premiers octets d'une adresse IP, afin de + restreindre l'accès à un sous-réseau.</p></dd> + + <dt>Une paire réseau/masque de sous-réseau</dt> + + <dd> + <div class="example"><h3>Exemple :</h3><p><code> + Allow from 10.1.0.0/255.255.0.0 + </code></p></div> + <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z, pour + une définition plus précise de la restriction d'accès imposée à un + sous-réseau.</p></dd> + + <dt>Une spécification CIDR réseau/nnn</dt> + + <dd> + <div class="example"><h3>Exemple :</h3><p><code> + Allow from 10.1.0.0/16 + </code></p></div> + <p>Identique au cas précédent, mis à part que le masque est + constitué des nnn bits de poids fort.</p></dd> + </dl> + + <p>Notez que les trois derniers exemples désignent le même ensemble + d'hôtes.</p> + + <p>On peut spécifier des adresses et sous-réseaux IPv6 de la manière + suivante :</p> + + <div class="example"><p><code> + Allow from 2001:db8::a00:20ff:fea7:ccea<br /> + Allow from 2001:db8::a00:20ff:fea7:ccea/10 + </code></p></div> + + <p>Le troisième format d'argument de la directive + <code class="directive">Allow</code> permet de contrôler l'accès au serveur + en fonction de l'existence d'une <a href="../env.html">variable d'environnement</a>. Lorsque <code>Allow + from env=<var>variable d'environnement</var></code> est spécifié, la + requête est autorisée si la variable d'environnement <var>variable + d'environnement</var> existe. En revanche, lorsque <code>Allow from + env=!<var>env-variable</var></code> est spécifié, la + requête est autorisée si la variable d'environnement <var>variable + d'environnement</var> n'existe pas. Le serveur permet de définir + avec souplesse des variables d'environnement en se basant sur les + caractéristiques de la requête client et en utilisant les directives + fournies par le module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. Ainsi, on peut + utiliser la directive <code class="directive">Allow</code> pour permettre + l'accès en fonction de paramètres comme le <code>User-Agent</code> + (type de navigateur) des clients, le <code>Referer</code>, ou + d'autres champs d'en-tête de la requête HTTP.</p> + + <div class="example"><h3>Exemple :</h3><p><code> + SetEnvIf User-Agent ^KnockKnock/2\.0 laissez_moi_entrer<br /> + <Directory /docroot><br /> + <span class="indent"> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from env=laissez_moi_entrer<br /> + </span> + </Directory> + </code></p></div> + + <p>Dans cet exemple, les navigateurs dont la chaîne user-agent + commence par <code>KnockKnock/2.0</code> se verront accorder + l'accès, alors que tous les autres seront rejetés.</p> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Deny" id="Deny">Deny</a> <a name="deny" id="deny">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit quels hôtes ne sont pas autorisés à accéder au +serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Deny from all|<var>hôte</var>|env=[!]<var>variable +d'environnement</var> +[<var>hôte</var>|env=[!]<var>variable d'environnement</var>] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Limit</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr> +</table> + <p>Cette directive permet de restreindre l'accès au serveur en + fonction du nom d'hôte, de l'adresse IP ou de variables + d'environnement. Les arguments de la directive + <code class="directive">Deny</code> sont identiques aux arguments de la + directive <code class="directive"><a href="#allow">Allow</a></code>.</p> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Order" id="Order">Order</a> <a name="order" id="order">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le statut d'accès par défaut et l'ordre dans lequel +les directives <code class="directive">Allow</code> et +<code class="directive">Deny</code> sont évaluées.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Order <var>ordre</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Order Deny,Allow</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Limit</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr> +</table> + + <p>La directive <code class="directive">Order</code>, associée aux + directives <code class="directive"><a href="#allow">Allow</a></code> + et <code class="directive"><a href="#deny">Deny</a></code>, + implémente un système de contrôle d'accès en trois passes. Au cours + de la première passe, ce sont soit toutes les directives <code class="directive"><a href="#allow">Allow</a></code>, soit toutes les + directives <code class="directive"><a href="#deny">Deny</a></code> qui sont traitées, selon + la définition de la directive <code class="directive"><a href="#order">Order</a></code>. Le reste des + directives (<code class="directive"><a href="#deny">Deny</a></code> + ou <code class="directive"><a href="#allow">Allow</a></code>) est + traité au cours de la seconde passe. La troisième passe s'applique à + toutes les requêtes qui ne sont concernées par aucune des deux + premières passes.</p> + + <p>Notez que toutes les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> sont traitées, à la + différence d'un pare-feu classique où seule la première règle qui + correspond est utilisée. La dernière directive qui correspond + s'applique ( à la différence là encore d'un pare-feu classique). De + plus, l'ordre dans lequel les lignes apparaissent dans le fichier de + configuration n'a pas d'incidence -- toutes les lignes <code class="directive"><a href="#allow">Allow</a></code> sont considérées comme + un groupe, toutes les lignes <code class="directive"><a href="#deny">Deny</a></code> comme un autre, et le + statut par défaut a son existence propre.</p> + + <p><em>Ordre</em> peut être :</p> + + <dl> + <dt><code>Allow,Deny</code></dt> + + <dd>Dans un premier temps, toutes les directives <code class="directive"><a href="#allow">Allow</a></code> sont évaluées ; au + moins une d'entre elles doit correspondre, sinon la requête est + rejetée. Ensuite, toutes les directives <code class="directive"><a href="#deny">Deny</a></code> sont évaluées. Si au + moins l'une d'entre elles correspond, la requête est rejetée. + Enfin, toute requête qui ne correspond à aucune directive + <code class="directive"><a href="#allow">Allow</a></code> ou + <code class="directive"><a href="#deny">Deny</a></code> est rejetée + par défaut.</dd> + + <dt><code>Deny,Allow</code></dt> + + <dd>Dans un premier temps, toutes les directives <code class="directive"><a href="#deny">Deny</a></code> sont évaluées ; Si au + moins une d'entre elles correspond, la requête est rejetée, + <strong>à moins</strong> qu'elle corresponde aussi à une directive + <code class="directive"><a href="#allow">Allow</a></code>. Toute + requête qui ne correspond à aucune directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> est autorisée.</dd> + + <dt><code>Mutual-failure</code></dt> + + <dd>Cet argument a le même effet que <code>Allow,Deny</code> et + est devenu de ce fait obsolète.</dd> + </dl> + + <p>Les mots-clés ne peuvent être séparés que par des virgules ; + <em>aucun espace</em> ne doit s'intercaler entre eux.</p> + + <table class="bordered"> + <tr> + <th>Match</th> + <th>Résultat Allow,Deny</th> + <th>Résultat Deny,Allow</th> + </tr><tr> + <th>Correspond à Allow seulement</th> + <td>Requête autorisée</td> + <td>Requête autorisée</td> + </tr><tr> + <th>Correspond à Deny seulement</th> + <td>Requête rejetée</td> + <td>Requête rejetée</td> + </tr><tr> + <th>Aucune correspondance</th> + <td>Par défaut la seconde directive : rejet</td> + <td>Par défaut la seconde directive : autorisation</td> + </tr><tr> + <th>Correspond à Allow & Deny</th> + <td>La dernière correspondance l'emporte : rejet</td> + <td>La dernière correspondance l'emporte : autorisation</td> + </tr> + </table> + + <p>Dans cet exemple, tous les hôtes du domaine apache.org ont + l'autorisation d'accès ; tous les autres voient leur accès + refusé.</p> + + <div class="example"><p><code> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from apache.org + </code></p></div> + + <p>Dans l'exemple suivant, tous les hôtes du domaine apache.org ont + l'autorisation d'accès, sauf ceux du sous-domaine foo.apache.org qui + voient leur accès refusé. Tous les hôtes qui ne sont pas dans le + domaine apache.org sont rejetés car le statut par défaut est positionné + sur <code class="directive"><a href="#deny">Deny</a></code>, et consiste donc en un + refus d'accès.</p> + + <div class="example"><p><code> + Order Allow,Deny<br /> + Allow from apache.org<br /> + Deny from foo.apache.org + </code></p></div> + + <p>Par contre, si la valeur de la directive + <code class="directive">Order</code>, dans l'exemple précédent, est + <code>Deny,Allow</code>, tout le monde a l'autorisation d'accès. + Ceci est dû au fait que <code>Allow from apache.org</code> sera + évalué en dernier, sans tenir compte de l'ordre réel dans lequel les + directives apparaissent dans le fichier de configuration, et va + l'emporter sur <code>Deny from foo.apache.org</code>. Tout hôte qui + n'est pas dans le domaine <code>apache.org</code> aura aussi + l'autorisation d'accès car le statut par défaut est positionné sur + <code class="directive"><a href="#allow">Allow</a></code> et constitue donc une + autorisation d'accès.</p> + + <p>La présence d'une directive <code class="directive">Order</code> peut + affecter le contrôle d'accès à une partie du serveur même en + l'abscence de directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> associées, à cause de + son influence sur le statut par défaut. Par exemple,</p> + + <div class="example"><p><code> + <Directory /www><br /> + <span class="indent"> + Order Allow,Deny<br /> + </span> + </Directory> + </code></p></div> + + <p>va interdire tout accès au répertoire <code>/www</code> à cause + du statut d'accès par défaut qui est défini à <code class="directive"><a href="#deny">Deny</a></code>.</p> + + <p>La directive <code class="directive">Order</code> ne contrôle l'ordre + dans lequel sont traitées les directives d'accès qu'au cours de + chaque phase du traitement de la configuration du serveur. Ceci + implique, par exemple, qu'une directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> située dans une section + <code class="directive"><a href="../mod/core.html#location"><Location></a></code> sera + toujours évaluée après une directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> située dans une section + <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou un + fichier <code>.htaccess</code>, sans tenir compte de la + définition de la directive <code class="directive">Order</code>. Pour plus + de détails à propos de la fusion des sections de configuration, voir + le document <a href="../sections.html">Comment fonctionnent les sections Directory, + Location et Files</a>.</p> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a> <a name="satisfy" id="satisfy">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interaction entre le contrôle d'accès en fonction de l'hôte +et l'authentification utilisateur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Satisfy Any|All</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Satisfy All</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_access_compat</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Affecté par <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> et <code class="directive"><a href="../mod/core.html#limitexcept"><LimitExcept></a></code> à partir de la version +2.0.51</td></tr> +</table> + <p>Politique d'accès dans le cas où on utilise à la fois <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>. L'argument est soit + <code>All</code>, soit <code>Any</code>. L'utilisation de cette + directive n'a de sens que si l'accès à une zone particulière du + serveur est restreinte par utilisateur/mot de passe et en fonction + de l'adresse IP de l'hôte client. Dans ce cas, par + défaut (<code>All</code>), le client doit satisfaire à la + restriction d'adresse, <em>et</em> fournir un couple + utilisateur/mot de passe valide. Avec l'argument <code>Any</code>, + le client se verra accorder l'accès s'il satisfait à la restriction + d'adresse ou fournit un couple utilisateur/mot de passe valide. On + peut utiliser cette dernière définition pour restreindre l'accès à + une zone par mot de passe, mais accorder l'accès aux clients + possédant certaines adresses IP sans qu'ils aient à fournir de mot + de passe.</p> + + <p>Par exemple, si vous souhaitez que les utilisateurs de votre + réseau accèdent à une zone de votre site web sans restriction, mais + que l'accès à cette zone nécessite un mot de passe pour les autres + utilisateurs, vous pouvez utiliser une configuration du style :</p> + + <div class="example"><p><code> + Require valid-user<br /> + Allow from 192.168.1<br /> + Satisfy Any + </code></p></div> + + <p> + Une autre utilisation fréquente de la directive + <code class="directive">Satisfy</code> est l'allègement des restrictions + d'accès à un sous-répertoire par rapport aux restrictions d'accès au + répertoire parent : + </p> + + <div class="example"><p><code> + <Directory /var/www/private><br /> + Require valid-user<br /> + </Directory><br /> + <br /> + <Directory /var/www/private/public><br /> + Allow from all<br /> + Satisfy Any<br /> + </Directory> + </code></p></div> + + <p>Dans l'exemple ci-dessus, l'accès au répertoire + <code>/var/www/private</code> nécessitera une authentification, + alors que l'accès au répertoire <code>/var/www/private/public</code> + sera accordé sans restriction.</p> + + + <p>Depuis la version 2.0.51, les directives + <code class="directive">Satisfy</code> peuvent être restreintes à certaines + méthodes particulières à l'aide des sections <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> et <code class="directive"><a href="../mod/core.html#limitexcept"><LimitExcept></a></code>.</p> + +<h3>Voir aussi</h3> +<ul> +<li><code class="directive"><a href="#allow">Allow</a></code></li> +<li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li> +</ul> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_access_compat.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_access_compat.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_access_compat.xml.fr b/docs/manual/mod/mod_access_compat.xml.fr new file mode 100644 index 0000000000..aa0543dce1 --- /dev/null +++ b/docs/manual/mod/mod_access_compat.xml.fr @@ -0,0 +1,499 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 825898 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_access_compat.xml.meta"> + +<name>mod_access_compat</name> +<description>Autorisations de groupe à base de nom d'hôte (nom ou +adresse IP)</description> +<status>Extension</status> +<sourcefile>mod_access_compat.c</sourcefile> +<identifier>access_compat_module</identifier> +<compatibility>Disponible dans Apache 2.3 à des fins de compatibilité +avec les précédentes versions d'Apache 2.x. Les directives fournies par +ce module sont devenues obsolètes depuis la refonte d'authz. Voir +<module>mod_authz_host</module></compatibility> + +<summary> + <p>Les directives fournies par le module + <module>mod_access_compat</module> s'utilisent dans les sections + <directive module="core" type="section">Directory</directive>, + <directive module="core" type="section">Files</directive> et + <directive module="core" type="section">Location</directive>, ainsi + que dans les fichiers <code><a + href="core.html#accessfilename">.htaccess</a></code> et permettent + de contrôler l'accès à certaines parties du serveur. On peut + contrôler cet accès en fonction du nom d'hôte du client, de son + adresse IP ou d'autres caractéristiques de la requête, telles + qu'elles sont enregistrées dans les <a href="../env.html">variables + d'environnement</a>. Les directives <directive + module="mod_access_compat">Allow</directive> et <directive + module="mod_access_compat">Deny</directive> permettent de spécifier + quels clients sont ou ne sont pas autorisés à accéder au serveur, + alors que la directive <directive + module="mod_access_compat">Order</directive> définit le statut + d'accès par défaut, et détermine la manière dont les directives + <directive module="mod_access_compat">Allow</directive> et + <directive module="mod_access_compat">Deny</directive> interagissent + entre elles.</p> + + <p>Les restrictions d'accès à base de nom d'hôte et + l'authentification à base de mot de passe peuvent être implémentées + simultanément. Dans ce cas, on utilise la directive <directive + module="mod_access_compat">Satisfy</directive> pour déterminer la + manière dont ces deux modes de restrictions interagissent.</p> + + <note type="warning"><title>Note</title> + <p>Les directives fournies par le module + <module>mod_access_compat</module> sont devenues obsolètes depuis + la refonte d'authz. Voir <module>mod_authz_host</module>.</p> + </note> + + <p>En général, les directives de restriction d'accès s'appliquent à + toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, + <code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite + dans la plupart des cas. Il est cependant possible de restreindre + certaines méthodes, alors que les autres méthodes ne se verront + imposée aucune restriction, en regroupant les directives à + l'intérieur d'une section <directive module="core" + type="section">Limit</directive>.</p> +</summary> + +<seealso><directive module="mod_authz_core">Require</directive></seealso> +<seealso><module>mod_authz_host</module></seealso> +<seealso><module>mod_authz_core</module></seealso> + +<directivesynopsis> +<name>Allow</name> +<description>Spécifie quels hôtes peuvent accéder à une certaine zone du +serveur</description> +<syntax> Allow from all|<var>hôte</var>|env=[!]<var>variable +d'environnement</var> +[<var>hôte</var>|env=[!]<var>variable d'environnement</var>] ...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>Limit</override> + +<usage> + <p>La directive <directive>Allow</directive> permet de définir quels + hôtes ont le droit d'accéder à une certaine partie du serveur. On + peut contrôler l'accès par nom d'hôte, adresse IP, intervalle + d'adresses IP, ou toute autre caractéristique de la requête client + enregistrée dans les variables d'environnement.</p> + + <p>Le premier argument de cette directive est toujours + <code>from</code>. Les arguments suivants peuvent prendre trois + formes différentes. Si <code>Allow from all</code> est spécifié, + tout hôte se voit accordé l'accès, en tenant compte des directives + <directive module="mod_access_compat">Deny</directive> et <directive + module="mod_access_compat">Order</directive> comme décrit plus loin. + Pour ne permettre l'accès au serveur qu'à un hôte ou un groupe + d'hôtes particuliers, on peut spécifier un <em>nom d'hôte</em> sous + une des formes suivantes :</p> + + <dl> + <dt>Un nom de domaine (partiel)</dt> + + <dd> + <example><title>Exemple :</title> + Allow from apache.org<br /> + Allow from .net example.edu + </example> + <p>Les hôtes dont les noms correspondent ou se terminent par la + chaîne spécifiée ont l'autorisation d'accès. Seules les + composantes entières du nom d'hôte doivent correspondre ; ainsi, + dans l'exemple ci-dessus, <code>foo.apache.org</code> + correspondra, mais <code>fooapache.org</code> ne conviendra pas. + 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 <directive + module="core">HostnameLookups</directive>. Tout d'abord, une + recherche DNS inverse sur l'adresse IP est effectuée pour + déterminer le nom d'hôte associé, puis une recherche directe sur + le nom d'hôte est effectuée afin de s'assurer 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 + concordent.</p></dd> + + <dt>Une adresse IP complète</dt> + + <dd> + <example><title>Exemple :</title> + Allow from 10.1.2.3<br /> + Allow from 192.168.1.104 192.168.1.205 + </example> + <p>L'adresse IP d'un hôte auquel on a accordé l'accès</p></dd> + + <dt>Une adresse IP partielle</dt> + + <dd> + <example><title>Exemple :</title> + Allow from 10.1<br /> + Allow from 10 172.20 192.168.2 + </example> + <p>De un à trois des premiers octets d'une adresse IP, afin de + restreindre l'accès à un sous-réseau.</p></dd> + + <dt>Une paire réseau/masque de sous-réseau</dt> + + <dd> + <example><title>Exemple :</title> + Allow from 10.1.0.0/255.255.0.0 + </example> + <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z, pour + une définition plus précise de la restriction d'accès imposée à un + sous-réseau.</p></dd> + + <dt>Une spécification CIDR réseau/nnn</dt> + + <dd> + <example><title>Exemple :</title> + Allow from 10.1.0.0/16 + </example> + <p>Identique au cas précédent, mis à part que le masque est + constitué des nnn bits de poids fort.</p></dd> + </dl> + + <p>Notez que les trois derniers exemples désignent le même ensemble + d'hôtes.</p> + + <p>On peut spécifier des adresses et sous-réseaux IPv6 de la manière + suivante :</p> + + <example> + Allow from 2001:db8::a00:20ff:fea7:ccea<br /> + Allow from 2001:db8::a00:20ff:fea7:ccea/10 + </example> + + <p>Le troisième format d'argument de la directive + <directive>Allow</directive> permet de contrôler l'accès au serveur + en fonction de l'existence d'une <a + href="../env.html">variable d'environnement</a>. Lorsque <code>Allow + from env=<var>variable d'environnement</var></code> est spécifié, la + requête est autorisée si la variable d'environnement <var>variable + d'environnement</var> existe. En revanche, lorsque <code>Allow from + env=!<var>env-variable</var></code> est spécifié, la + requête est autorisée si la variable d'environnement <var>variable + d'environnement</var> n'existe pas. Le serveur permet de définir + avec souplesse des variables d'environnement en se basant sur les + caractéristiques de la requête client et en utilisant les directives + fournies par le module <module>mod_setenvif</module>. Ainsi, on peut + utiliser la directive <directive>Allow</directive> pour permettre + l'accès en fonction de paramètres comme le <code>User-Agent</code> + (type de navigateur) des clients, le <code>Referer</code>, ou + d'autres champs d'en-tête de la requête HTTP.</p> + + <example><title>Exemple :</title> + SetEnvIf User-Agent ^KnockKnock/2\.0 laissez_moi_entrer<br /> + <Directory /docroot><br /> + <indent> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from env=laissez_moi_entrer<br /> + </indent> + </Directory> + </example> + + <p>Dans cet exemple, les navigateurs dont la chaîne user-agent + commence par <code>KnockKnock/2.0</code> se verront accorder + l'accès, alors que tous les autres seront rejetés.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Deny</name> +<description>Définit quels hôtes ne sont pas autorisés à accéder au +serveur</description> +<syntax> Deny from all|<var>hôte</var>|env=[!]<var>variable +d'environnement</var> +[<var>hôte</var>|env=[!]<var>variable d'environnement</var>] ...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>Limit</override> + +<usage> + <p>Cette directive permet de restreindre l'accès au serveur en + fonction du nom d'hôte, de l'adresse IP ou de variables + d'environnement. Les arguments de la directive + <directive>Deny</directive> sont identiques aux arguments de la + directive <directive + module="mod_access_compat">Allow</directive>.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Order</name> +<description>Définit le statut d'accès par défaut et l'ordre dans lequel +les directives <directive>Allow</directive> et +<directive>Deny</directive> sont évaluées.</description> +<syntax> Order <var>ordre</var></syntax> +<default>Order Deny,Allow</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>Limit</override> + +<usage> + + <p>La directive <directive>Order</directive>, associée aux + directives <directive module="mod_access_compat">Allow</directive> + et <directive module="mod_access_compat">Deny</directive>, + implémente un système de contrôle d'accès en trois passes. Au cours + de la première passe, ce sont soit toutes les directives <directive + module="mod_access_compat">Allow</directive>, soit toutes les + directives <directive + module="mod_access_compat">Deny</directive> qui sont traitées, selon + la définition de la directive <directive + module="mod_access_compat">Order</directive>. Le reste des + directives (<directive module="mod_access_compat">Deny</directive> + ou <directive module="mod_access_compat">Allow</directive>) est + traité au cours de la seconde passe. La troisième passe s'applique à + toutes les requêtes qui ne sont concernées par aucune des deux + premières passes.</p> + + <p>Notez que toutes les directives <directive + module="mod_access_compat">Allow</directive> et <directive + module="mod_access_compat">Deny</directive> sont traitées, à la + différence d'un pare-feu classique où seule la première règle qui + correspond est utilisée. La dernière directive qui correspond + s'applique ( à la différence là encore d'un pare-feu classique). De + plus, l'ordre dans lequel les lignes apparaissent dans le fichier de + configuration n'a pas d'incidence -- toutes les lignes <directive + module="mod_access_compat">Allow</directive> sont considérées comme + un groupe, toutes les lignes <directive + module="mod_access_compat">Deny</directive> comme un autre, et le + statut par défaut a son existence propre.</p> + + <p><em>Ordre</em> peut être :</p> + + <dl> + <dt><code>Allow,Deny</code></dt> + + <dd>Dans un premier temps, toutes les directives <directive + module="mod_access_compat">Allow</directive> sont évaluées ; au + moins une d'entre elles doit correspondre, sinon la requête est + rejetée. Ensuite, toutes les directives <directive + module="mod_access_compat">Deny</directive> sont évaluées. Si au + moins l'une d'entre elles correspond, la requête est rejetée. + Enfin, toute requête qui ne correspond à aucune directive + <directive module="mod_access_compat">Allow</directive> ou + <directive module="mod_access_compat">Deny</directive> est rejetée + par défaut.</dd> + + <dt><code>Deny,Allow</code></dt> + + <dd>Dans un premier temps, toutes les directives <directive + module="mod_access_compat">Deny</directive> sont évaluées ; Si au + moins une d'entre elles correspond, la requête est rejetée, + <strong>à moins</strong> qu'elle corresponde aussi à une directive + <directive module="mod_access_compat">Allow</directive>. Toute + requête qui ne correspond à aucune directive <directive + module="mod_access_compat">Allow</directive> ou <directive + module="mod_access_compat">Deny</directive> est autorisée.</dd> + + <dt><code>Mutual-failure</code></dt> + + <dd>Cet argument a le même effet que <code>Allow,Deny</code> et + est devenu de ce fait obsolète.</dd> + </dl> + + <p>Les mots-clés ne peuvent être séparés que par des virgules ; + <em>aucun espace</em> ne doit s'intercaler entre eux.</p> + + <table border="1"> + <tr> + <th>Match</th> + <th>Résultat Allow,Deny</th> + <th>Résultat Deny,Allow</th> + </tr><tr> + <th>Correspond à Allow seulement</th> + <td>Requête autorisée</td> + <td>Requête autorisée</td> + </tr><tr> + <th>Correspond à Deny seulement</th> + <td>Requête rejetée</td> + <td>Requête rejetée</td> + </tr><tr> + <th>Aucune correspondance</th> + <td>Par défaut la seconde directive : rejet</td> + <td>Par défaut la seconde directive : autorisation</td> + </tr><tr> + <th>Correspond à Allow & Deny</th> + <td>La dernière correspondance l'emporte : rejet</td> + <td>La dernière correspondance l'emporte : autorisation</td> + </tr> + </table> + + <p>Dans cet exemple, tous les hôtes du domaine apache.org ont + l'autorisation d'accès ; tous les autres voient leur accès + refusé.</p> + + <example> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from apache.org + </example> + + <p>Dans l'exemple suivant, tous les hôtes du domaine apache.org ont + l'autorisation d'accès, sauf ceux du sous-domaine foo.apache.org qui + voient leur accès refusé. Tous les hôtes qui ne sont pas dans le + domaine apache.org sont rejetés car le statut par défaut est positionné + sur <directive + module="mod_access_compat">Deny</directive>, et consiste donc en un + refus d'accès.</p> + + <example> + Order Allow,Deny<br /> + Allow from apache.org<br /> + Deny from foo.apache.org + </example> + + <p>Par contre, si la valeur de la directive + <directive>Order</directive>, dans l'exemple précédent, est + <code>Deny,Allow</code>, tout le monde a l'autorisation d'accès. + Ceci est dû au fait que <code>Allow from apache.org</code> sera + évalué en dernier, sans tenir compte de l'ordre réel dans lequel les + directives apparaissent dans le fichier de configuration, et va + l'emporter sur <code>Deny from foo.apache.org</code>. Tout hôte qui + n'est pas dans le domaine <code>apache.org</code> aura aussi + l'autorisation d'accès car le statut par défaut est positionné sur + <directive + module="mod_access_compat">Allow</directive> et constitue donc une + autorisation d'accès.</p> + + <p>La présence d'une directive <directive>Order</directive> peut + affecter le contrôle d'accès à une partie du serveur même en + l'abscence de directives <directive + module="mod_access_compat">Allow</directive> et <directive + module="mod_access_compat">Deny</directive> associées, à cause de + son influence sur le statut par défaut. Par exemple,</p> + + <example> + <Directory /www><br /> + <indent> + Order Allow,Deny<br /> + </indent> + </Directory> + </example> + + <p>va interdire tout accès au répertoire <code>/www</code> à cause + du statut d'accès par défaut qui est défini à <directive + module="mod_access_compat">Deny</directive>.</p> + + <p>La directive <directive>Order</directive> ne contrôle l'ordre + dans lequel sont traitées les directives d'accès qu'au cours de + chaque phase du traitement de la configuration du serveur. Ceci + implique, par exemple, qu'une directive <directive + module="mod_access_compat">Allow</directive> ou <directive + module="mod_access_compat">Deny</directive> située dans une section + <directive module="core" type="section">Location</directive> sera + toujours évaluée après une directive <directive + module="mod_access_compat">Allow</directive> ou <directive + module="mod_access_compat">Deny</directive> située dans une section + <directive module="core" type="section">Directory</directive> ou un + fichier <code>.htaccess</code>, sans tenir compte de la + définition de la directive <directive>Order</directive>. Pour plus + de détails à propos de la fusion des sections de configuration, voir + le document <a + href="../sections.html">Comment fonctionnent les sections Directory, + Location et Files</a>.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Satisfy</name> +<description>Interaction entre le contrôle d'accès en fonction de l'hôte +et l'authentification utilisateur</description> +<syntax>Satisfy Any|All</syntax> +<default>Satisfy All</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> +<compatibility>Affecté par <directive module="core" type="section" +>Limit</directive> et <directive module="core" +type="section">LimitExcept</directive> à partir de la version +2.0.51</compatibility> +<usage> + <p>Politique d'accès dans le cas où on utilise à la fois <directive + module="mod_access_compat">Allow</directive> et <directive + module="mod_authz_core">Require</directive>. L'argument est soit + <code>All</code>, soit <code>Any</code>. L'utilisation de cette + directive n'a de sens que si l'accès à une zone particulière du + serveur est restreinte par utilisateur/mot de passe et en fonction + de l'adresse IP de l'hôte client. Dans ce cas, par + défaut (<code>All</code>), le client doit satisfaire à la + restriction d'adresse, <em>et</em> fournir un couple + utilisateur/mot de passe valide. Avec l'argument <code>Any</code>, + le client se verra accorder l'accès s'il satisfait à la restriction + d'adresse ou fournit un couple utilisateur/mot de passe valide. On + peut utiliser cette dernière définition pour restreindre l'accès à + une zone par mot de passe, mais accorder l'accès aux clients + possédant certaines adresses IP sans qu'ils aient à fournir de mot + de passe.</p> + + <p>Par exemple, si vous souhaitez que les utilisateurs de votre + réseau accèdent à une zone de votre site web sans restriction, mais + que l'accès à cette zone nécessite un mot de passe pour les autres + utilisateurs, vous pouvez utiliser une configuration du style :</p> + + <example> + Require valid-user<br /> + Allow from 192.168.1<br /> + Satisfy Any + </example> + + <p> + Une autre utilisation fréquente de la directive + <directive>Satisfy</directive> est l'allègement des restrictions + d'accès à un sous-répertoire par rapport aux restrictions d'accès au + répertoire parent : + </p> + + <example> + <Directory /var/www/private><br /> + Require valid-user<br /> + </Directory><br /> + <br /> + <Directory /var/www/private/public><br /> + Allow from all<br /> + Satisfy Any<br /> + </Directory> + </example> + + <p>Dans l'exemple ci-dessus, l'accès au répertoire + <code>/var/www/private</code> nécessitera une authentification, + alors que l'accès au répertoire <code>/var/www/private/public</code> + sera accordé sans restriction.</p> + + + <p>Depuis la version 2.0.51, les directives + <directive>Satisfy</directive> peuvent être restreintes à certaines + méthodes particulières à l'aide des sections <directive + module="core" type="section">Limit</directive> et <directive + module="core" type="section">LimitExcept</directive>.</p> +</usage> + <seealso><directive module="mod_access_compat">Allow</directive></seealso> + <seealso><directive module="mod_authz_core">Require</directive></seealso> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_access_compat.xml.meta b/docs/manual/mod/mod_access_compat.xml.meta index 2902018c3e..29b25ab3e0 100644 --- a/docs/manual/mod/mod_access_compat.xml.meta +++ b/docs/manual/mod/mod_access_compat.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_actions.html b/docs/manual/mod/mod_actions.html index 05ae104922..65b9912fa9 100644 --- a/docs/manual/mod/mod_actions.html +++ b/docs/manual/mod/mod_actions.html @@ -8,6 +8,10 @@ URI: mod_actions.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_actions.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_actions.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_actions.html.en b/docs/manual/mod/mod_actions.html.en index 807997d7ee..815d9fb82f 100644 --- a/docs/manual/mod/mod_actions.html.en +++ b/docs/manual/mod/mod_actions.html.en @@ -23,6 +23,7 @@ <div class="toplang"> <p><span>Available Languages: </span><a href="../de/mod/mod_actions.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/mod_actions.html" title="English"> en </a> | +<a href="../fr/mod/mod_actions.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -156,6 +157,7 @@ method.</td></tr> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../de/mod/mod_actions.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | <a href="../en/mod/mod_actions.html" title="English"> en </a> | +<a href="../fr/mod/mod_actions.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_actions.html.fr b/docs/manual/mod/mod_actions.html.fr new file mode 100644 index 0000000000..5f6938867c --- /dev/null +++ b/docs/manual/mod/mod_actions.html.fr @@ -0,0 +1,176 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_actions - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_actions</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../de/mod/mod_actions.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | +<a href="../en/mod/mod_actions.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_actions.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module permet l'exécution des scripts CGI en fonction du +type de média ou de la méthode de requête.</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>actions_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_actions.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module possède deux directives. La directive <code class="directive"><a href="#action">Action</a></code> vous permet de lancer + l'exécution de scripts CGI chaque fois qu'un fichier possédant un + certain <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type de contenu MIME</a> + fait l'objet d'une requête. La directive <code class="directive"><a href="#script">Script</a></code> vous permet de lancer + l'exécution de scripts CGI chaque fois que la requête utilise une + méthode particulière. Ceci facilite grandement l'exécution de + scripts qui traitent des fichiers.</p> </div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#action">Action</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#script">Script</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li> +<li><a href="../howto/cgi.html">Contenu dynamique avec CGI</a></li> +<li><a href="../handler.html">Utilisation des gestionnaires +d'Apache</a></li> +</ul></div> + +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Action" id="Action">Action</a> <a name="action" id="action">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active un script CGI pour un gestionnaire ou un type de +contenu particulier</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Action <var>type d'action</var> <var>script cgi</var> +[virtual]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_actions</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Le modificateur <code>virtual</code> et le passage de +gestionnaire ont été introduits dans Apache 2.1</td></tr> +</table> + <p>Cette directive ajoute une action qui va activer <var>script + cgi</var> lorsque <var>type d'action</var> est déclenché par la + requête. <var>script cgi</var> est un chemin URL vers une ressource + qui a été désignée comme script CGI à l'aide des directives + <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>. <var>type d'action</var> + peut être soit un <a href="../handler.html">gestionnaire</a>, soit + un <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type de contenu MIME</a>. L'URL + et le chemin du document correspondant sont envoyés en utilisant + les variables d'environnement CGI standards <code>PATH_INFO</code> + et <code>PATH_TRANSLATED</code>. Le gestionnaire utilisé pour cette + requête particulière est transmis à l'aide de la variable + <code>REDIRECT_HANDLER</code>.</p> + + <div class="example"><h3>Exemples</h3><p><code> + # Requêtes concernant des fichiers possédant un type de contenu + # MIME particulier :<br /> + Action image/gif /cgi-bin/images.cgi<br /> + <br /> + # Fichiers possédant une extension particulière<br /> + AddHandler mon-type-de-fichier .xyz<br /> + Action mon-type-de-fichier /cgi-bin/programme.cgi<br /> + </code></p></div> + + <p>Dans le premier exemple, les requêtes pour des fichiers possédant + le type de contenu MIME <code>image/gif</code> seront traitées par + le script CGI <code>/cgi-bin/images.cgi</code>.</p> + + <p>Dans le second exemple, les requêtes pour des fichiers possédant + l'extension <code>.xyz</code> seront traitées par + le script CGI <code>/cgi-bin/programme.cgi</code>.</p> + + <p>Le modificateur optionnel <code>virtual</code> permet de + désactiver la vérification de l'existence du fichier demandé. Ceci + peut s'avérer utile, par exemple, si vous voulez utiliser la + directive <code class="directive">Action</code> pour des localisations + virtuelles.</p> + + <div class="example"><h3>Exemple</h3><p><code> + <Location /news><br /> + <span class="indent"> + SetHandler news-handler<br /> + Action news-handler /cgi-bin/news.cgi virtual<br /> + </span> + </Location> + </code></p></div> + +<h3>Voir aussi</h3> +<ul> +<li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li> +</ul> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Script" id="Script">Script</a> <a name="script" id="script">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active un script CGI dans le cas d'une méthode de requête +particulière.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Script <var>méthode</var> <var>script cgi</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_actions</td></tr> +</table> + <p>Cette directive ajoute une action qui va activer <var>script + cgi</var> lorsqu'un fichier est demandé en utilisant la méthode + <var>méthode</var>. <var>script cgi</var> est le chemin URL d'une + ressource qui a été désignée comme script CGI en utilisant les + directives <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>. L'URL et le chemin du + document demandé sont envoyés en utilisant les variables + d'environnement CGI standards <code>PATH_INFO</code> et + <code>PATH_TRANSLATED</code>.</p> + + <div class="note"> + Tous les noms de méthode peuvent être utilisés. <strong>Les noms + de méthode sont sensibles à la casse</strong>, si bien que + <code>Script PUT</code> et <code>Script put</code> ont des effets + totalement différents. + </div> + + <p>Notez que la commande <code class="directive">Script</code> ne définit + que des actions par défaut. Si un script CGI est appelé, ou toute + autre ressource capable de gérer la méthode de la requête en + interne, il agira en conséquence. Notez aussi que + <code class="directive">Script</code> avec une méthode <code>GET</code> ne + sera appelé que si la requête possède des arguments (par exemple + foo.html?hi). Dans le cas contraire, la requête sera traitée + normalement.</p> + + <div class="example"><h3>Exemples</h3><p><code> + # Pour une recherche du style <ISINDEX><br /> + Script GET /cgi-bin/search<br /> + <br /> + # Un gestionnaire CGI pour la méthode PUT<br /> + Script PUT /~bob/put.cgi<br /> + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../de/mod/mod_actions.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | +<a href="../en/mod/mod_actions.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_actions.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_actions.xml.fr b/docs/manual/mod/mod_actions.xml.fr new file mode 100644 index 0000000000..12a2f825bf --- /dev/null +++ b/docs/manual/mod/mod_actions.xml.fr @@ -0,0 +1,164 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 420990 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_actions.xml.meta"> + +<name>mod_actions</name> + +<description>Ce module permet l'exécution des scripts CGI en fonction du +type de média ou de la méthode de requête.</description> + +<status>Base</status> +<sourcefile>mod_actions.c</sourcefile> +<identifier>actions_module</identifier> + +<summary> + <p>Ce module possède deux directives. La directive <directive + module="mod_actions">Action</directive> vous permet de lancer + l'exécution de scripts CGI chaque fois qu'un fichier possédant un + certain <glossary ref="mime-type">type de contenu MIME</glossary> + fait l'objet d'une requête. La directive <directive + module="mod_actions">Script</directive> vous permet de lancer + l'exécution de scripts CGI chaque fois que la requête utilise une + méthode particulière. Ceci facilite grandement l'exécution de + scripts qui traitent des fichiers.</p> </summary> + +<seealso><module>mod_cgi</module></seealso> +<seealso><a href="../howto/cgi.html">Contenu dynamique avec CGI</a></seealso> +<seealso><a href="../handler.html">Utilisation des gestionnaires +d'Apache</a></seealso> + +<directivesynopsis> +<name>Action</name> +<description>Active un script CGI pour un gestionnaire ou un type de +contenu particulier</description> +<syntax>Action <var>type d'action</var> <var>script cgi</var> +[virtual]</syntax> +<contextlist> +<context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context> +</contextlist> +<override>FileInfo</override> +<compatibility>Le modificateur <code>virtual</code> et le passage de +gestionnaire ont été introduits dans Apache 2.1</compatibility> + +<usage> + <p>Cette directive ajoute une action qui va activer <var>script + cgi</var> lorsque <var>type d'action</var> est déclenché par la + requête. <var>script cgi</var> est un chemin URL vers une ressource + qui a été désignée comme script CGI à l'aide des directives + <directive module="mod_alias">ScriptAlias</directive> ou <directive + module="mod_mime">AddHandler</directive>. <var>type d'action</var> + peut être soit un <a href="../handler.html">gestionnaire</a>, soit + un <glossary ref="mime-type">type de contenu MIME</glossary>. L'URL + et le chemin du document correspondant sont envoyés en utilisant + les variables d'environnement CGI standards <code>PATH_INFO</code> + et <code>PATH_TRANSLATED</code>. Le gestionnaire utilisé pour cette + requête particulière est transmis à l'aide de la variable + <code>REDIRECT_HANDLER</code>.</p> + + <example><title>Exemples</title> + # Requêtes concernant des fichiers possédant un type de contenu + # MIME particulier :<br /> + Action image/gif /cgi-bin/images.cgi<br /> + <br /> + # Fichiers possédant une extension particulière<br /> + AddHandler mon-type-de-fichier .xyz<br /> + Action mon-type-de-fichier /cgi-bin/programme.cgi<br /> + </example> + + <p>Dans le premier exemple, les requêtes pour des fichiers possédant + le type de contenu MIME <code>image/gif</code> seront traitées par + le script CGI <code>/cgi-bin/images.cgi</code>.</p> + + <p>Dans le second exemple, les requêtes pour des fichiers possédant + l'extension <code>.xyz</code> seront traitées par + le script CGI <code>/cgi-bin/programme.cgi</code>.</p> + + <p>Le modificateur optionnel <code>virtual</code> permet de + désactiver la vérification de l'existence du fichier demandé. Ceci + peut s'avérer utile, par exemple, si vous voulez utiliser la + directive <directive>Action</directive> pour des localisations + virtuelles.</p> + + <example><title>Exemple</title> + <Location /news><br /> + <indent> + SetHandler news-handler<br /> + Action news-handler /cgi-bin/news.cgi virtual<br /> + </indent> + </Location> + </example> +</usage> + +<seealso><directive module="mod_mime">AddHandler</directive></seealso> +</directivesynopsis> + +<directivesynopsis> +<name>Script</name> +<description>Active un script CGI dans le cas d'une méthode de requête +particulière.</description> +<syntax>Script <var>méthode</var> <var>script cgi</var></syntax> +<contextlist> +<context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> +<usage> + <p>Cette directive ajoute une action qui va activer <var>script + cgi</var> lorsqu'un fichier est demandé en utilisant la méthode + <var>méthode</var>. <var>script cgi</var> est le chemin URL d'une + ressource qui a été désignée comme script CGI en utilisant les + directives <directive + module="mod_alias">ScriptAlias</directive> ou <directive + module="mod_mime">AddHandler</directive>. L'URL et le chemin du + document demandé sont envoyés en utilisant les variables + d'environnement CGI standards <code>PATH_INFO</code> et + <code>PATH_TRANSLATED</code>.</p> + + <note> + Tous les noms de méthode peuvent être utilisés. <strong>Les noms + de méthode sont sensibles à la casse</strong>, si bien que + <code>Script PUT</code> et <code>Script put</code> ont des effets + totalement différents. + </note> + + <p>Notez que la commande <directive>Script</directive> ne définit + que des actions par défaut. Si un script CGI est appelé, ou toute + autre ressource capable de gérer la méthode de la requête en + interne, il agira en conséquence. Notez aussi que + <directive>Script</directive> avec une méthode <code>GET</code> ne + sera appelé que si la requête possède des arguments (par exemple + foo.html?hi). Dans le cas contraire, la requête sera traitée + normalement.</p> + + <example><title>Exemples</title> + # Pour une recherche du style <ISINDEX><br /> + Script GET /cgi-bin/search<br /> + <br /> + # Un gestionnaire CGI pour la méthode PUT<br /> + Script PUT /~bob/put.cgi<br /> + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_actions.xml.meta b/docs/manual/mod/mod_actions.xml.meta index 8bb55d01fe..591ef61bb9 100644 --- a/docs/manual/mod/mod_actions.xml.meta +++ b/docs/manual/mod/mod_actions.xml.meta @@ -9,6 +9,7 @@ <variants> <variant>de</variant> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_asis.html b/docs/manual/mod/mod_asis.html index f2f687b0ca..95bb91308c 100644 --- a/docs/manual/mod/mod_asis.html +++ b/docs/manual/mod/mod_asis.html @@ -4,6 +4,10 @@ URI: mod_asis.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_asis.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_asis.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_asis.html.en b/docs/manual/mod/mod_asis.html.en index 255dd4ac60..1350baaede 100644 --- a/docs/manual/mod/mod_asis.html.en +++ b/docs/manual/mod/mod_asis.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_asis</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_asis.html" title="English"> en </a> | +<a href="../fr/mod/mod_asis.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -104,6 +105,7 @@ HTTP headers</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_asis.html" title="English"> en </a> | +<a href="../fr/mod/mod_asis.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_asis.html.fr b/docs/manual/mod/mod_asis.html.fr new file mode 100644 index 0000000000..8cd3f8901a --- /dev/null +++ b/docs/manual/mod/mod_asis.html.fr @@ -0,0 +1,115 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_asis - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_asis</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_asis.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_asis.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Envoie des fichiers contenant leurs propres en-têtes +HTTP</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>asis_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_asis.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module fournit le gestionnaire <code>send-as-is</code> qui + permet à Apache d'envoyer le document sans ajouter la plupart des + en-têtes HTTP habituels.</p> + + <p>On peut l'utiliser pour envoyer tous types de données en + provenance du serveur, y compris les redirections et autres réponses + HTTP spéciales, sans devoir faire appel à un script CGI ou nph.</p> + + <p>Pour des raisons historiques, ce module traitera aussi tout + fichier dont le type MIME est <code>httpd/send-as-is</code>.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<p>Ce module ne fournit aucune directive.</p> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#usage">Mode d'emploi</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code></li> +<li><code class="module"><a href="../mod/mod_cern_meta.html">mod_cern_meta</a></code></li> +<li><a href="../handler.html">Utilisation des gestionnaires +d'Apache</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="usage" id="usage">Mode d'emploi</a></h2> + + <p>Dans le fichier de configuration, associez les fichiers asis au + gestionnaire <code>send-as-is</code> comme ceci :</p> + + <div class="example"><p><code>AddHandler send-as-is asis</code></p></div> + + <p>Le contenu de tout fichier possédant l'extension + <code>.asis</code> sera envoyé par Apache au client pratiquement tel + quel. En particulier, les en-têtes HTTP seront déduits du fichier + lui-même selon les règles du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, si + bien qu'un fichier asis doit inclure des en-têtes valides, et + utiliser l'en-tête CGI Status: pour déterminer le code de réponse + HTTP.</p> + + <p>Voici un exemple de fichier dont le contenu est envoyé <em>tel + quel</em> pour informer un client qu'un fichier a été déplacé.</p> + + + <div class="example"><p><code> + Status: 301 Ou se trouve cette URL maintenant<br /> + Location: http://xyz.abc.com/foo/bar.html<br /> + Content-type: text/html<br /> + <br /> + <html><br /> + <head><br /> + <title>Mauvaises excuses</title><br /> + </head><br /> + <body><br /> + <h1>La merveilleuse page de Fred a été déplacée vers<br /> + <a href="http://xyz.abc.com/foo/bar.html">le site de + Joe</a>.<br /> + </h1><br /> + </body><br /> + </html> + </code></p></div> + + <div class="note"><h3>Notes :</h3> + <p>Le serveur ajoute systématiquement les en-têtes + <code>Date:</code> et <code>Server:</code> aux données qu'il envoie + au client, si bien qu'ils n'ont pas besoin d'être inclus dans le + fichier. Le serveur n'ajoute <em>pas</em> d'en-tête + <code>Last-Modified</code>, ce qu'il devrait probablement faire.</p> + </div> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_asis.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_asis.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_asis.xml.fr b/docs/manual/mod/mod_asis.xml.fr new file mode 100644 index 0000000000..a216d562e9 --- /dev/null +++ b/docs/manual/mod/mod_asis.xml.fr @@ -0,0 +1,98 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 420990 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_asis.xml.meta"> + +<name>mod_asis</name> +<description>Envoie des fichiers contenant leurs propres en-têtes +HTTP</description> +<status>Base</status> +<sourcefile>mod_asis.c</sourcefile> +<identifier>asis_module</identifier> + +<summary> + <p>Ce module fournit le gestionnaire <code>send-as-is</code> qui + permet à Apache d'envoyer le document sans ajouter la plupart des + en-têtes HTTP habituels.</p> + + <p>On peut l'utiliser pour envoyer tous types de données en + provenance du serveur, y compris les redirections et autres réponses + HTTP spéciales, sans devoir faire appel à un script CGI ou nph.</p> + + <p>Pour des raisons historiques, ce module traitera aussi tout + fichier dont le type MIME est <code>httpd/send-as-is</code>.</p> +</summary> + +<seealso><module>mod_headers</module></seealso> +<seealso><module>mod_cern_meta</module></seealso> +<seealso><a href="../handler.html">Utilisation des gestionnaires +d'Apache</a></seealso> + +<section id="usage"><title>Mode d'emploi</title> + + <p>Dans le fichier de configuration, associez les fichiers asis au + gestionnaire <code>send-as-is</code> comme ceci :</p> + + <example>AddHandler send-as-is asis</example> + + <p>Le contenu de tout fichier possédant l'extension + <code>.asis</code> sera envoyé par Apache au client pratiquement tel + quel. En particulier, les en-têtes HTTP seront déduits du fichier + lui-même selon les règles du module <module>mod_cgi</module>, si + bien qu'un fichier asis doit inclure des en-têtes valides, et + utiliser l'en-tête CGI Status: pour déterminer le code de réponse + HTTP.</p> + + <p>Voici un exemple de fichier dont le contenu est envoyé <em>tel + quel</em> pour informer un client qu'un fichier a été déplacé.</p> + + + <example> + Status: 301 Ou se trouve cette URL maintenant<br /> + Location: http://xyz.abc.com/foo/bar.html<br /> + Content-type: text/html<br /> + <br /> + <html><br /> + <head><br /> + <title>Mauvaises excuses</title><br /> + </head><br /> + <body><br /> + <h1>La merveilleuse page de Fred a été déplacée vers<br /> + <a href="http://xyz.abc.com/foo/bar.html">le site de + Joe</a>.<br /> + </h1><br /> + </body><br /> + </html> + </example> + + <note><title>Notes :</title> + <p>Le serveur ajoute systématiquement les en-têtes + <code>Date:</code> et <code>Server:</code> aux données qu'il envoie + au client, si bien qu'ils n'ont pas besoin d'être inclus dans le + fichier. Le serveur n'ajoute <em>pas</em> d'en-tête + <code>Last-Modified</code>, ce qu'il devrait probablement faire.</p> + </note> +</section> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_asis.xml.meta b/docs/manual/mod/mod_asis.xml.meta index 638e62064d..39214a9356 100644 --- a/docs/manual/mod/mod_asis.xml.meta +++ b/docs/manual/mod/mod_asis.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_auth_digest.html b/docs/manual/mod/mod_auth_digest.html index eeb065dd7b..1836f36027 100644 --- a/docs/manual/mod/mod_auth_digest.html +++ b/docs/manual/mod/mod_auth_digest.html @@ -4,6 +4,10 @@ URI: mod_auth_digest.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_auth_digest.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_auth_digest.html.ko.euc-kr Content-Language: ko Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/mod/mod_auth_digest.html.en b/docs/manual/mod/mod_auth_digest.html.en index 6494ba910e..ae383d7022 100644 --- a/docs/manual/mod/mod_auth_digest.html.en +++ b/docs/manual/mod/mod_auth_digest.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_auth_digest</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_auth_digest.html" title="English"> en </a> | +<a href="../fr/mod/mod_auth_digest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>User authentication using MD5 @@ -328,6 +329,7 @@ of clients</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_auth_digest.html" title="English"> en </a> | +<a href="../fr/mod/mod_auth_digest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> diff --git a/docs/manual/mod/mod_auth_digest.html.fr b/docs/manual/mod/mod_auth_digest.html.fr new file mode 100644 index 0000000000..b3ad43c02e --- /dev/null +++ b/docs/manual/mod/mod_auth_digest.html.fr @@ -0,0 +1,363 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_auth_digest - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_auth_digest</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_digest.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_auth_digest.html" title="Français"> fr </a> | +<a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification utilisateur utilisant les condensés +MD5</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_digest_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_digest.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module implémente l'authentification HTTP basée sur les + condensés MD5 (<a href="http://www.faqs.org/rfcs/rfc2617.html">RFC2617</a>), et + fournit une alternative à <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> plus + sécurisée.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestalgorithm">AuthDigestAlgorithm</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestdomain">AuthDigestDomain</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestnccheck">AuthDigestNcCheck</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestnonceformat">AuthDigestNonceFormat</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestnoncelifetime">AuthDigestNonceLifetime</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestprovider">AuthDigestProvider</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestqop">AuthDigestQop</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authdigestshmemsize">AuthDigestShmemSize</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#using">Utilisation de l'authentification à base de +condensés</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#msie">Travailler avec MS Internet Explorer</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li> +<li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li> +<li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li> +<li><code class="directive"><a href="../mod/mod_authz_core.html#match">Match</a></code></li> +<li><a href="../howto/auth.html">Mode d'emploi de +l'authentification</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="using" id="using">Utilisation de l'authentification à base de +condensés</a></h2> + + <p>Pour utiliser l'authentification à base de condensés MD5, vous + devez simplement remplacer <code>AuthType Basic</code> et <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> respectivement + par <code>AuthType Digest</code> et <code class="directive"><a href="#authdigestprovider">AuthDigestProvider</a></code> lorsque vous + configurez l'authentification, puis ajouter une directive <code class="directive"><a href="#authdigestdomain">AuthDigestDomain</a></code> contenant au + moins la(les) URI(s) racine(s) de la zone à protéger.</p> + + <p>On peut créer les fichiers utilisateur appropriés (au format + texte) à l'aide de l'outil <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>.</p> + + <div class="example"><h3>Exemple :</h3><p><code> + <Location /private/><br /> + <span class="indent"> + AuthType Digest<br /> + AuthName "private area"<br /> + AuthDigestDomain /private/ http://mirror.my.dom/private2/<br /> + <br /> + AuthDigestProvider file<br /> + AuthUserFile /web/auth/.digest_pw<br /> + Require valid-user<br /> + </span> + </Location> + </code></p></div> + + <div class="note"><h3>Note</h3> + <p>L'authentification à base de condensés MD5 est plus sécurisée que + l'authentification Basic, mais ne fonctionne qu'avec les navigateurs + qui la supportent. En septembre 2004, les principaux navigateurs + supportant l'authentification à base de condensés MD5 incluaient <a href="http://www.w3.org/Amaya/">Amaya</a>, <a href="http://konqueror.kde.org/">Konqueror</a>, <a href="http://www.microsoft.com/windows/ie/">MS Internet Explorer</a> + pour Mac OS X et Windows (bien que la version Windows échoue lorsque + la requête comporte une chaîne d'arguments -- voir plus loin "<a href="#msie">Travailler avec MS Internet Explorer</a>" pour + contourner ce problème), <a href="http://www.mozilla.org">Mozilla</a>, <a href="http://channels.netscape.com/ns/browsers/download.jsp"> + Netscape</a> 7, <a href="http://www.opera.com/">Opera</a>, et <a href="http://www.apple.com/safari/">Safari</a>. <a href="http://lynx.isc.org/">lynx</a> ne supporte + <strong>pas</strong> l'authentification à base de condensés MD5. + Comme l'authentification à base de condensés MD5 est moins répandue + que l'authentification Basic, vous ne devez l'utiliser que dans des + environnements où tous les utilisateurs disposeront d'un navigateur + la supportant.</p> + <p><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> ne fonctionne correctement que + sur les plates-formes où APR supporte la mémoire partagée.</p> + </div> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="msie" id="msie">Travailler avec MS Internet Explorer</a></h2> + <p>L'implémentation de l'authentification à base de condensé dans + les versions précédentes d'Internet Explorer pour Windows (5 et 6) + posait problème, car les requêtes de type <code>GET</code> + comportant une chaîne d'arguments (query string) ne respectaient pas les RFC. Il y + a plusieurs manières de contourner ce problème.</p> + + <p> + La première méthode consiste à utiliser des requêtes de type + <code>POST</code> plutôt que <code>GET</code> pour transmettre les + données à votre programme. Cette méthode constitue l'approche la + plus simple dans le cas où votre application peut fonctionner avec + cette limitation. + </p> + + <p>Depuis la version 2.0.51, Apache propose aussi de contourner le + problème à l'aide de la variable d'environnement + <code>AuthDigestEnableQueryStringHack</code>. Si + <code>AuthDigestEnableQueryStringHack</code> est définie pour la + requête, Apache va prendre des mesures pour contourner la bogue MSIE + et en particulier va exclure la chaîne d'arguments de la comparaison + des condensés. L'utilisation de cette méthode peut se traduire par + ceci :</p> + + <div class="example"><h3>Utilisation de l'authentification à base de condensé + avec MSIE :</h3><p><code> + BrowserMatch "MSIE" AuthDigestEnableQueryStringHack=On + </code></p></div> + + <p>Cette correction n'est pas nécessaire avec MSIE 7, bien que son + activation ne pose pas de problème de compatibilité ou de surcharge + significative.</p> + + <p>Voir la directive <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code> pour plus de détails + à propos de la définition conditionnelle des variables + d'environnement.</p> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestAlgorithm" id="AuthDigestAlgorithm">AuthDigestAlgorithm</a> <a name="authdigestalgorithm" id="authdigestalgorithm">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sélectionne l'algorithme utilisé pour calculer les +condensés du défit et de sa réponse</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestAlgorithm MD5|MD5-sess</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestAlgorithm MD5</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <p>La directive <code class="directive">AuthDigestAlgorithm</code> permet de + sélectionner l'algorithme utilisé pour calculer les condensés du + défit et de sa réponse.</p> + + <div class="note"> + <code>MD5-sess</code> n'est pas encore correctement implémenté. + </div> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestDomain" id="AuthDigestDomain">AuthDigestDomain</a> <a name="authdigestdomain" id="authdigestdomain">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les URIs qui se trouvent dans le même espace de protection +concernant l'authentification à base de condensés</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestDomain <var>URI</var> [<var>URI</var>] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <p>La directive <code class="directive">AuthDigestDomain</code> vous permet + de spécifier un ou plusieurs URIs se trouvant dans le même + espace de protection (c'est à dire utilisant le même utilisateur/mot + de passe et se trouvant dans le même domaine). Les URIs spécifiés + sont des préfixes ; le client doit savoir que tous les URIs situés + sous ces préfixes seront protégés par le même utilisateur/mot de + passe. Les URIs peuvent être soit des URIs absolus (c'est à dire + avec protocole, nom serveur, port, etc...), soit des URIs + relatifs.</p> + + <p>Cette directive doit toujours être présente et contenir au moins + le(s) URI(s) racine(s) pour cet espace. Dans le cas contraire, le + client va envoyer un en-tête d'autorisation avec <em>chaque + requête</em> à destination de ce serveur. Outre une augmentation de + la taille de la requête, les performances vont s'en trouver + affectées si la directive <code class="directive"><a href="#authdigestnccheck">AuthDigestNcCheck</a></code> est définie à + On.</p> + + <p>Les URIs spécifiés peuvent aussi référencer différents serveurs, + auquel cas les clients (qui sont à même de le comprendre) vont + partager l'utilisateur/mot de passe entre plusieurs serveurs sans le + demander à l'utilisateur à chaque fois.</p> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestNcCheck" id="AuthDigestNcCheck">AuthDigestNcCheck</a> <a name="authdigestnccheck" id="authdigestnccheck">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive la vérification du nombre d'envois du +nombre à valeur unique (nonce) par le serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestNcCheck On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestNcCheck Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <div class="note"> + Non encore implémenté. + </div> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestNonceFormat" id="AuthDigestNonceFormat">AuthDigestNonceFormat</a> <a name="authdigestnonceformat" id="authdigestnonceformat">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine la manière dont le nombre à valeur unique du +serveur (nonce) est généré</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestNonceFormat <var>format</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <div class="note">Non encore implémenté.</div> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestNonceLifetime" id="AuthDigestNonceLifetime">AuthDigestNonceLifetime</a> <a name="authdigestnoncelifetime" id="authdigestnoncelifetime">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée de validité du nombre à valeur unique du +serveur (nonce)</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestNonceLifetime <var>secondes</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestNonceLifetime 300</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <p>La directive <code class="directive">AuthDigestNonceLifetime</code> + permet de contrôler la durée de validité du nombre à valeur unique + du serveur (nonce). Lorsque le client contacte le serveur en + utilisant un nonce dont la validité a expiré, le serveur renvoie un + code d'erreur 401 avec <code>stale=true</code>. Si + <var>secondes</var> est supérieur à 0, il spécifie la durée de + validité du nonce ; il est en général déconseillé d'affecter à cet + argument une valeur inférieure à 10 secondes. Si + <var>secondes</var> est inférieur à 0, le nonce n'expire jamais. + + </p> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestProvider" id="AuthDigestProvider">AuthDigestProvider</a> <a name="authdigestprovider" id="authdigestprovider">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(s) fournisseurs(s) d'authentification pour la +zone du site web concernée</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestProvider <var>nom fournisseur</var> +[<var>nom fournisseur</var>] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestProvider file</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <p>La directive <code class="directive">AuthDigestProvider</code> permet de + définir quel fournisseur d'authentification sera utilisé pour + authentifier les utilisateurs pour la zone du site web concernée. + Assurez-vous que le module implémentant le fournisseur + d'authentification choisi soit bien présent dans le serveur. Le + fournisseur par défaut <code>file</code> est implémenté par le + module <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>.</p> + + <p>Voir <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>, + <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, et <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> + pour la liste des fournisseurs disponibles.</p> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestQop" id="AuthDigestQop">AuthDigestQop</a> <a name="authdigestqop" id="authdigestqop">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le niveau de protection fourni par +l'authentification à base de condensé</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestQop none|auth|auth-int [auth|auth-int]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestQop auth</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <p>La directive <code class="directive">AuthDigestQop</code> permet de + définir le <dfn>niveau de protection</dfn> fourni. <code>auth</code> + ne fournit que l'authentification (nom utilisateur/mot de passe) ; + <code>auth-int</code> fournit l'authentification plus un contrôle + d'intégrité (un condensé MD5 de l'entité est aussi calculé et + vérifié) ; avec <code>none</code>, le module va utiliser l'ancien + algorithme de condensés RFC-2069 (qui n'effectue pas de contrôle + d'intégrité). On peut spécifier à la fois <code>auth</code> et + <code>auth-int</code>, auquel cas c'est le navigateur qui va choisir + lequel des deux utiliser. <code>none</code> ne doit être utilisé que + dans le cas où le navigateur ne serait pas à même (pour une raison + ou pour une autre) de relever le défit qu'il recevrait si un autre + niveau de protection était défini.</p> + + <div class="note"> + <code>auth-int</code> n'est pas encore implémenté. + </div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthDigestShmemSize" id="AuthDigestShmemSize">AuthDigestShmemSize</a> <a name="authdigestshmemsize" id="authdigestshmemsize">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité de mémoire partagée à allouer afin de conserver +les informations à propos des clients</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthDigestShmemSize <var>taille</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthDigestShmemSize 1000</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_digest</td></tr> +</table> + <p>La directive <code class="directive">AuthDigestShmemSize</code> permet de + définir la quantité de mémoire partagée à allouer au démarrage du + serveur afin de conserver les informations à propos des clients. + Notez que le segment de mémoire partagée ne peut pas être défini à + une taille inférieure à l'espace nécessaire pour conserver les + informations à propos d'<em>un</em> client. Cette valeur dépend de + votre système. Si vous voulez en déterminer la valeur exacte, vous + pouvez simplement définir <code class="directive">AuthDigestShmemSize</code> + à <code>0</code> et consulter le message d'erreur que renverra le + serveur lorsqu'on essaiera de le démarrer.</p> + + <p>L'argument <var>size</var> s'exprime par défaut en octets, mais + vous pouvez suffixer le nombre par un <code>K</code> ou un + <code>M</code> pour spécifier respectivement des KiloOctets ou des + MégaOctets. Par exemple, les directives qui suivent sont toutes + équivalentes :</p> + + <div class="example"><p><code> + AuthDigestShmemSize 1048576<br /> + AuthDigestShmemSize 1024K<br /> + AuthDigestShmemSize 1M + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_digest.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_auth_digest.html" title="Français"> fr </a> | +<a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_auth_digest.xml.fr b/docs/manual/mod/mod_auth_digest.xml.fr new file mode 100644 index 0000000000..f9221dda90 --- /dev/null +++ b/docs/manual/mod/mod_auth_digest.xml.fr @@ -0,0 +1,386 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 813396 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_auth_digest.xml.meta"> + +<name>mod_auth_digest</name> +<description>Authentification utilisateur utilisant les condensés +MD5</description> +<status>Extension</status> +<sourcefile>mod_auth_digest.c</sourcefile> +<identifier>auth_digest_module</identifier> + +<summary> + <p>Ce module implémente l'authentification HTTP basée sur les + condensés MD5 (<a + href="http://www.faqs.org/rfcs/rfc2617.html">RFC2617</a>), et + fournit une alternative à <module>mod_auth_basic</module> plus + sécurisée.</p> +</summary> + +<seealso><directive module="mod_authn_core">AuthName</directive></seealso> +<seealso><directive module="mod_authn_core">AuthType</directive></seealso> +<seealso><directive module="mod_authz_core">Require</directive></seealso> +<seealso><directive module="mod_authz_core">Match</directive></seealso> +<seealso><a href="../howto/auth.html">Mode d'emploi de +l'authentification</a></seealso> + +<section id="using"><title>Utilisation de l'authentification à base de +condensés</title> + + <p>Pour utiliser l'authentification à base de condensés MD5, vous + devez simplement remplacer <code>AuthType Basic</code> et <directive + module="mod_auth_basic">AuthBasicProvider</directive> respectivement + par <code>AuthType Digest</code> et <directive + module="mod_auth_digest">AuthDigestProvider</directive> lorsque vous + configurez l'authentification, puis ajouter une directive <directive + module="mod_auth_digest">AuthDigestDomain</directive> contenant au + moins la(les) URI(s) racine(s) de la zone à protéger.</p> + + <p>On peut créer les fichiers utilisateur appropriés (au format + texte) à l'aide de l'outil <program>htdigest</program>.</p> + + <example><title>Exemple :</title> + <Location /private/><br /> + <indent> + AuthType Digest<br /> + AuthName "private area"<br /> + AuthDigestDomain /private/ http://mirror.my.dom/private2/<br /> + <br /> + AuthDigestProvider file<br /> + AuthUserFile /web/auth/.digest_pw<br /> + Require valid-user<br /> + </indent> + </Location> + </example> + + <note><title>Note</title> + <p>L'authentification à base de condensés MD5 est plus sécurisée que + l'authentification Basic, mais ne fonctionne qu'avec les navigateurs + qui la supportent. En septembre 2004, les principaux navigateurs + supportant l'authentification à base de condensés MD5 incluaient <a + href="http://www.w3.org/Amaya/">Amaya</a>, <a + href="http://konqueror.kde.org/">Konqueror</a>, <a + href="http://www.microsoft.com/windows/ie/">MS Internet Explorer</a> + pour Mac OS X et Windows (bien que la version Windows échoue lorsque + la requête comporte une chaîne d'arguments -- voir plus loin "<a + href="#msie">Travailler avec MS Internet Explorer</a>" pour + contourner ce problème), <a + href="http://www.mozilla.org">Mozilla</a>, <a + href="http://channels.netscape.com/ns/browsers/download.jsp"> + Netscape</a> 7, <a href="http://www.opera.com/">Opera</a>, et <a + href="http://www.apple.com/safari/">Safari</a>. <a + href="http://lynx.isc.org/">lynx</a> ne supporte + <strong>pas</strong> l'authentification à base de condensés MD5. + Comme l'authentification à base de condensés MD5 est moins répandue + que l'authentification Basic, vous ne devez l'utiliser que dans des + environnements où tous les utilisateurs disposeront d'un navigateur + la supportant.</p> + <p><module>mod_auth_digest</module> ne fonctionne correctement que + sur les plates-formes où APR supporte la mémoire partagée.</p> + </note> +</section> + +<section id="msie"><title>Travailler avec MS Internet Explorer</title> + <p>L'implémentation de l'authentification à base de condensé dans + les versions précédentes d'Internet Explorer pour Windows (5 et 6) + posait problème, car les requêtes de type <code>GET</code> + comportant une chaîne d'arguments (query string) ne respectaient pas les RFC. Il y + a plusieurs manières de contourner ce problème.</p> + + <p> + La première méthode consiste à utiliser des requêtes de type + <code>POST</code> plutôt que <code>GET</code> pour transmettre les + données à votre programme. Cette méthode constitue l'approche la + plus simple dans le cas où votre application peut fonctionner avec + cette limitation. + </p> + + <p>Depuis la version 2.0.51, Apache propose aussi de contourner le + problème à l'aide de la variable d'environnement + <code>AuthDigestEnableQueryStringHack</code>. Si + <code>AuthDigestEnableQueryStringHack</code> est définie pour la + requête, Apache va prendre des mesures pour contourner la bogue MSIE + et en particulier va exclure la chaîne d'arguments de la comparaison + des condensés. L'utilisation de cette méthode peut se traduire par + ceci :</p> + + <example><title>Utilisation de l'authentification à base de condensé + avec MSIE :</title> + BrowserMatch "MSIE" AuthDigestEnableQueryStringHack=On + </example> + + <p>Cette correction n'est pas nécessaire avec MSIE 7, bien que son + activation ne pose pas de problème de compatibilité ou de surcharge + significative.</p> + + <p>Voir la directive <directive + module="mod_setenvif">BrowserMatch</directive> pour plus de détails + à propos de la définition conditionnelle des variables + d'environnement.</p> +</section> + + +<directivesynopsis> +<name>AuthDigestProvider</name> +<description>Définit le(s) fournisseurs(s) d'authentification pour la +zone du site web concernée</description> +<syntax>AuthDigestProvider <var>nom fournisseur</var> +[<var>nom fournisseur</var>] ...</syntax> +<default>AuthDigestProvider file</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>La directive <directive>AuthDigestProvider</directive> permet de + définir quel fournisseur d'authentification sera utilisé pour + authentifier les utilisateurs pour la zone du site web concernée. + Assurez-vous que le module implémentant le fournisseur + d'authentification choisi soit bien présent dans le serveur. Le + fournisseur par défaut <code>file</code> est implémenté par le + module <module>mod_authn_file</module>.</p> + + <p>Voir <module>mod_authn_dbm</module>, + <module>mod_authn_file</module>, et <module>mod_authn_dbd</module> + pour la liste des fournisseurs disponibles.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestQop</name> +<description>Détermine le niveau de protection fourni par +l'authentification à base de condensé</description> +<syntax>AuthDigestQop none|auth|auth-int [auth|auth-int]</syntax> +<default>AuthDigestQop auth</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>La directive <directive>AuthDigestQop</directive> permet de + définir le <dfn>niveau de protection</dfn> fourni. <code>auth</code> + ne fournit que l'authentification (nom utilisateur/mot de passe) ; + <code>auth-int</code> fournit l'authentification plus un contrôle + d'intégrité (un condensé MD5 de l'entité est aussi calculé et + vérifié) ; avec <code>none</code>, le module va utiliser l'ancien + algorithme de condensés RFC-2069 (qui n'effectue pas de contrôle + d'intégrité). On peut spécifier à la fois <code>auth</code> et + <code>auth-int</code>, auquel cas c'est le navigateur qui va choisir + lequel des deux utiliser. <code>none</code> ne doit être utilisé que + dans le cas où le navigateur ne serait pas à même (pour une raison + ou pour une autre) de relever le défit qu'il recevrait si un autre + niveau de protection était défini.</p> + + <note> + <code>auth-int</code> n'est pas encore implémenté. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestNonceLifetime</name> +<description>Durée de validité du nombre à valeur unique du +serveur (nonce)</description> +<syntax>AuthDigestNonceLifetime <var>secondes</var></syntax> +<default>AuthDigestNonceLifetime 300</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>La directive <directive>AuthDigestNonceLifetime</directive> + permet de contrôler la durée de validité du nombre à valeur unique + du serveur (nonce). Lorsque le client contacte le serveur en + utilisant un nonce dont la validité a expiré, le serveur renvoie un + code d'erreur 401 avec <code>stale=true</code>. Si + <var>secondes</var> est supérieur à 0, il spécifie la durée de + validité du nonce ; il est en général déconseillé d'affecter à cet + argument une valeur inférieure à 10 secondes. Si + <var>secondes</var> est inférieur à 0, le nonce n'expire jamais. + <!-- Pas encore implémenté : si <var>secondes</var> est égal à 0, le + client ne doit utiliser le nonce qu'une seule fois. Notez que si les + nonces à usage unique assurent une sécurité accrue contre les + attaques à base de rejeu, il ont aussi d'importantes implications en + matière de performances, car le navigateur ne peut plus alors + effectuer de requêtes en paralléle (pipelining) ou utiliser + plusieurs connexions pour une même requête. Comme il n'est pas aisé + pour les navigateurs de détecter l'utilisation de nonces à usage + unique, on peut aboutir à la situation où le navigateur va tenter + d'effectuer des requêtes en parallèle et recevoir des codes d'erreur + 401 pour toutes les requêtes sauf la première, ce qui aura pour + effet de lui faire renvoyer les requêtes. Notez aussi que la + protection contre les attaques à base de rejeu n'a de sens que dans + le cas de contenus générés dynamiquement ou de requêtes de type + POST ; dans le cas des contenus statiques, l'attaquant possède déjà + probablement la réponse complète, et les nonces à usage unique sont + ici sans objet. --> + </p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestNonceFormat</name> +<description>Détermine la manière dont le nombre à valeur unique du +serveur (nonce) est généré</description> +<syntax>AuthDigestNonceFormat <var>format</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <note>Non encore implémenté.</note> + <!-- La directive AuthDigestNonceFormat permet de déterminer la + manière dont le nombre à valeur unique du serveur (nonce) est + généré. --> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestNcCheck</name> +<description>Active ou désactive la vérification du nombre d'envois du +nombre à valeur unique (nonce) par le serveur</description> +<syntax>AuthDigestNcCheck On|Off</syntax> +<default>AuthDigestNcCheck Off</default> +<contextlist><context>server config</context></contextlist> + +<usage> + <note> + Non encore implémenté. + </note> + <!-- + <p>La directive AuthDigestNcCheck permet d'activer ou de désactiver + la vérification du nombre d'envois du nombre à valeur unique (nonce) + par le serveur.</p> + + <p>Bien que la définition de cette directive à On soit recommandée + du point de vue de la sécurité, elle a des conséquences importantes sur + les performances du serveur. Pour vérifier le nombre d'envois du nonce, + *toutes* les requêtes (du moins toutes celles qui possèdent un + en-tête d'autorisation, qu'elles requièrent ou non une + authentification à base de condensé) doivent être sérialisées au + travers d'une section critique. Si le serveur traite un grand nombre + de requêtes qui possèdent un en-tête d'autorisation, l'impact sur + les performances pourra se montrer sensible.</p> + --> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestAlgorithm</name> +<description>Sélectionne l'algorithme utilisé pour calculer les +condensés du défit et de sa réponse</description> +<syntax>AuthDigestAlgorithm MD5|MD5-sess</syntax> +<default>AuthDigestAlgorithm MD5</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>La directive <directive>AuthDigestAlgorithm</directive> permet de + sélectionner l'algorithme utilisé pour calculer les condensés du + défit et de sa réponse.</p> + + <note> + <code>MD5-sess</code> n'est pas encore correctement implémenté. + </note> + <!-- + <p>Pour pouvoir utiliser <code>MD5-sess</code>, vous devez tout + d'abord éditer le code de la fonction <code>get_userpw_hash()</code> + dans <code>mod_auth_digest.c</code>.</p> + --> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestDomain</name> +<description>Les URIs qui se trouvent dans le même espace de protection +concernant l'authentification à base de condensés</description> +<syntax>AuthDigestDomain <var>URI</var> [<var>URI</var>] ...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>La directive <directive>AuthDigestDomain</directive> vous permet + de spécifier un ou plusieurs URIs se trouvant dans le même + espace de protection (c'est à dire utilisant le même utilisateur/mot + de passe et se trouvant dans le même domaine). Les URIs spécifiés + sont des préfixes ; le client doit savoir que tous les URIs situés + sous ces préfixes seront protégés par le même utilisateur/mot de + passe. Les URIs peuvent être soit des URIs absolus (c'est à dire + avec protocole, nom serveur, port, etc...), soit des URIs + relatifs.</p> + + <p>Cette directive doit toujours être présente et contenir au moins + le(s) URI(s) racine(s) pour cet espace. Dans le cas contraire, le + client va envoyer un en-tête d'autorisation avec <em>chaque + requête</em> à destination de ce serveur. Outre une augmentation de + la taille de la requête, les performances vont s'en trouver + affectées si la directive <directive + module="mod_auth_digest">AuthDigestNcCheck</directive> est définie à + On.</p> + + <p>Les URIs spécifiés peuvent aussi référencer différents serveurs, + auquel cas les clients (qui sont à même de le comprendre) vont + partager l'utilisateur/mot de passe entre plusieurs serveurs sans le + demander à l'utilisateur à chaque fois.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestShmemSize</name> +<description>La quantité de mémoire partagée à allouer afin de conserver +les informations à propos des clients</description> +<syntax>AuthDigestShmemSize <var>taille</var></syntax> +<default>AuthDigestShmemSize 1000</default> +<contextlist><context>server config</context></contextlist> + +<usage> + <p>La directive <directive>AuthDigestShmemSize</directive> permet de + définir la quantité de mémoire partagée à allouer au démarrage du + serveur afin de conserver les informations à propos des clients. + Notez que le segment de mémoire partagée ne peut pas être défini à + une taille inférieure à l'espace nécessaire pour conserver les + informations à propos d'<em>un</em> client. Cette valeur dépend de + votre système. Si vous voulez en déterminer la valeur exacte, vous + pouvez simplement définir <directive>AuthDigestShmemSize</directive> + à <code>0</code> et consulter le message d'erreur que renverra le + serveur lorsqu'on essaiera de le démarrer.</p> + + <p>L'argument <var>size</var> s'exprime par défaut en octets, mais + vous pouvez suffixer le nombre par un <code>K</code> ou un + <code>M</code> pour spécifier respectivement des KiloOctets ou des + MégaOctets. Par exemple, les directives qui suivent sont toutes + équivalentes :</p> + + <example> + AuthDigestShmemSize 1048576<br /> + AuthDigestShmemSize 1024K<br /> + AuthDigestShmemSize 1M + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_auth_digest.xml.meta b/docs/manual/mod/mod_auth_digest.xml.meta index 51470b2c1a..259065bc8e 100644 --- a/docs/manual/mod/mod_auth_digest.xml.meta +++ b/docs/manual/mod/mod_auth_digest.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ko</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_authn_core.html b/docs/manual/mod/mod_authn_core.html index 190674382a..08c846a709 100644 --- a/docs/manual/mod/mod_authn_core.html +++ b/docs/manual/mod/mod_authn_core.html @@ -3,3 +3,7 @@ URI: mod_authn_core.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_authn_core.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_authn_core.html.en b/docs/manual/mod/mod_authn_core.html.en index 755b9dc96a..1156a147f1 100644 --- a/docs/manual/mod/mod_authn_core.html.en +++ b/docs/manual/mod/mod_authn_core.html.en @@ -21,7 +21,8 @@ <div id="page-content"> <div id="preamble"><h1>Apache Module mod_authn_core</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_authn_core.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_authn_core.html" title="English"> en </a> | +<a href="../fr/mod/mod_authn_core.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Core Authentication</td></tr> <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr> @@ -251,7 +252,8 @@ the specified alias</td></tr> </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_authn_core.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_authn_core.html" title="English"> en </a> | +<a href="../fr/mod/mod_authn_core.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/mod/mod_authn_core.html.fr b/docs/manual/mod/mod_authn_core.html.fr new file mode 100644 index 0000000000..712f96bd4e --- /dev/null +++ b/docs/manual/mod/mod_authn_core.html.fr @@ -0,0 +1,269 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_authn_core - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_authn_core</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_core.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authn_core.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Le noyau de l'authentification</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_core_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_core.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module fournit le coeur des fonctionnalités d'authentification + permettant d'accorder ou de refuser l'accès à certaines zones du + site web. Les directives fournies par le module + <code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> sont communes à tous les + fournisseurs d'authentification.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#authname">AuthName</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authnprovideralias"><AuthnProviderAlias></a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authtype">AuthType</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#authnalias">Création d'alias de fournisseurs +d'authentification</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="authnalias" id="authnalias">Création d'alias de fournisseurs +d'authentification</a></h2> + + <p>Il est possible de créer des fournisseurs d'authentification + étendus dans le fichier de configuration et de leur assigner un + alias. Le fournisseur ainsi nommé peut alors être référencé à l'aide + des directives <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> ou <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> tout comme + un fournisseur d'authentification de base. Outre la possibilité de + créer et attribuer un alias à un fournisseur étendu, le même + fournisseur d'authentification peut aussi être référencé par + plusieurs sections relatives à une zone du site web.</p> + + <h3><a name="example" id="example">Exemples</a></h3> + + <p>Cet exemple vérifie les mots de passe dans deux fichiers + textes différents.</p> + + <div class="example"><h3>Vérification dans plusieurs fichiers de mots de + passe au format texte</h3><p><code> + + # On vérifie tout d'abord ici<br /> + <AuthnProviderAlias file file1><br /> + <span class="indent"> + AuthUserFile /www/conf/passwords1<br /> + </span> + </AuthnProviderAlias><br /> + <br /> + # On vérifie ensuite là<br /> + <AuthnProviderAlias file file2> <br /> + <span class="indent"> + AuthUserFile /www/conf/passwords2<br /> + </span> + </AuthnProviderAlias><br /> + <br /> + <Directory /var/web/pages/secure><br /> + <span class="indent"> + AuthBasicProvider file1 file2<br /> + <br /> + AuthType Basic<br /> + AuthName "Zone protégée"<br /> + Require valid-user<br /> + </span> + </Directory><br /> + </code></p></div> + + + + <p>Dans l'exemple ci-dessous, deux fournisseurs + d'authentification ldap sont créés à partir du fournisseur ldap + de base, et se voient attribuer un alias. L'authentification + d'une même zone peut alors être traitée par plusieurs serveurs + ldap :</p> + + <div class="example"><h3>Vérification auprès de plusieurs serveurs + LDAP</h3><p><code> + <AuthnProviderAlias ldap alias-ldap><br /> + <span class="indent"> + AuthLDAPBindDN cn=utilisateur,o=ctx<br /> + AuthLDAPBindPassword mot-de-passe<br /> + AuthLDAPURL ldap://serveur.ldap/o=ctx<br /> + </span> + </AuthnProviderAlias><br /><br /> + <AuthnProviderAlias ldap autre-alias-ldap><br /> + <span class="indent"> + AuthLDAPBindDN cn=autre-utilisateur,o=dev<br /> + AuthLDAPBindPassword autre-mot-de-passe<br /> + AuthLDAPURL ldap://autre.serveur.ldap/o=dev?cn<br /> + </span> + </AuthnProviderAlias><br /><br /> + + Alias /secure /webpages/secure<br /> + <Directory /webpages/secure><br /> + <span class="indent"> + Order deny,allow<br /> + Allow from all<br /><br /> + + AuthBasicProvider autre-alias-ldap alias-ldap <br /><br /> + + AuthType Basic<br />Exemple + AuthName Zone_protégée_par_LDAP<br /> + Require valid-user<br /> + </span> + </Directory><br /> + </code></p></div> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthName" id="AuthName">AuthName</a> <a name="authname" id="authname">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'identifiant de l'autorisation à utiliser avec +l'authentification HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthName <var>domaine d'autorisation</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_core</td></tr> +</table> + <p>Cette directive permet de définir l'identifiant d'autorisation + pour un répertoire. Cet identifiant est fourni au client de façon à + ce qu'il sache quels nom d'utilisateur et mot de passe envoyer. + <code class="directive">AuthName</code> accepte un seul argument ; s'il + contient des espaces, il doit être entouré de guillemets. Pour + pouvoir fonctionner, la directive <code class="directive">AuthName</code> + doit être utilisée en combinaison avec les directives <code class="directive"><a href="#authtype">AuthType</a></code> et <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, ainsi que des + directives comme <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> et <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>.</p> + + <p>Par exemple :</p> + + <div class="example"><p><code> + AuthName "Top Secret" + </code></p></div> + + <p>La chaîne fournie comme argument à <code>AuthName</code> + apparaîtra dans la boîte de dialogue d'authentification pour la + plupart des navigateurs.</p> + +<h3>Voir aussi</h3> +<ul> +<li><a href="../howto/auth.html">Authentification, autorisation et contrôle + d'accès</a></li> +<li><code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code></li> +</ul> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthnProviderAlias" id="AuthnProviderAlias"><AuthnProviderAlias></a> <a name="authnprovideralias" id="authnprovideralias">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble de directives qui constituent une +extension d'un fournisseur d'authentification de base et lui attribue +l'alias spécifié</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><AuthnProviderAlias <var>alias-fournisseur</var>> +... </AuthnProviderAlias></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_core</td></tr> +</table> + <p>Les balises <code><AuthnProviderAlias></code> et + <code></AuthnProviderAlias></code> permettent de regrouper un + ensemble de directives d'authentification qui seront référencées par + l'alias spécifié à l'aide des directives <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> ou <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>.</p> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthType" id="AuthType">AuthType</a> <a name="authtype" id="authtype">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type d'authentification utilisateur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthType None|Basic|Digest|Form</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_core</td></tr> +</table> + <p>Cette directive permet de définir le type d'authentification + utilisateur pour un répertoire. Les types d'authentification + disponibles sont <code>None</code>, <code>Basic</code> (implémenté + par <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>), <code>Digest</code> + (implémenté par <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>), et + <code>Form</code> (implémenté par + <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>).</p> + + <p>Pour mettre en oeuvre l'authentification, vous devez aussi + utiliser les directives <code class="directive"><a href="#authname">AuthName</a></code> et <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>. De plus, le serveur + doit pouvoir disposer d'un module fournisseur d'authentification + comme <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et d'un module d'autorisation + comme <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>.</p> + + <p>Le type d'authentification <code>None</code> désactive + l'authentification. Lorsqu'une authentification est définie, elle + est en général héritée par chacune des <a href="../sections.html#mergin">sections de configuration</a> qui + suivent, à moins qu'un autre type d'authentification ne soit + spécifié. Si l'on ne souhaite pas mettre en oeuvre + d'authentification pour une sous-section d'une section authentifiée, + on doit utiliser le type d'authentification <code>None</code> ; dans + l'exemple suivant, les clients peuvent accéder au répertoire + <code>/www/docs/public</code> sans devoir s'authentifier :</p> + + <div class="example"><p><code> + <Directory /www/docs> + <span class="indent"> + AuthType Basic<br /> + AuthName Documents<br /> + AuthBasicProvider file<br /> + AuthUserFile /usr/local/apache/passwd/passwords<br /> + Require valid-user + </span> + </Directory><br /> + <br /> + <Directory /www/docs/public> + <span class="indent"> + AuthType None<br /> + Require all granted + </span> + </Directory> + </code></p></div> + + <div class="note">Veuillez noter que, lorsque l'authentification n'est pas + activée, les clients qui se sont déjà authentifiés pour une autre + zone de l'arborescence du site continueront en général à envoyer des + en-tête d'authentification HTTP ou des cookies avec chaque requête, + sans se préoccuper de savoir si le serveur nécessite vraiment une + authentification pour chaque ressource.</div> + +<h3>Voir aussi</h3> +<ul> +<li><a href="../howto/auth.html">Authentification, autorisation et contrôle + d'accès</a></li> +</ul> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_core.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authn_core.html" title="Français"> fr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_authn_core.xml.fr b/docs/manual/mod/mod_authn_core.xml.fr new file mode 100644 index 0000000000..2580a3fc75 --- /dev/null +++ b/docs/manual/mod/mod_authn_core.xml.fr @@ -0,0 +1,260 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 737588 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authn_core.xml.meta"> + +<name>mod_authn_core</name> +<description>Le noyau de l'authentification</description> +<status>Base</status> +<sourcefile>mod_authn_core.c</sourcefile> +<identifier>authn_core_module</identifier> +<compatibility>Disponible depuis la version 2.3 d'Apache</compatibility> + +<summary> + <p>Ce module fournit le coeur des fonctionnalités d'authentification + permettant d'accorder ou de refuser l'accès à certaines zones du + site web. Les directives fournies par le module + <module>mod_authn_core</module> sont communes à tous les + fournisseurs d'authentification.</p> +</summary> + +<section id="authnalias"><title>Création d'alias de fournisseurs +d'authentification</title> + + <p>Il est possible de créer des fournisseurs d'authentification + étendus dans le fichier de configuration et de leur assigner un + alias. Le fournisseur ainsi nommé peut alors être référencé à l'aide + des directives <directive + module="mod_auth_basic">AuthBasicProvider</directive> ou <directive + module="mod_auth_digest">AuthDigestProvider</directive> tout comme + un fournisseur d'authentification de base. Outre la possibilité de + créer et attribuer un alias à un fournisseur étendu, le même + fournisseur d'authentification peut aussi être référencé par + plusieurs sections relatives à une zone du site web.</p> + + <section id="example"><title>Exemples</title> + + <p>Cet exemple vérifie les mots de passe dans deux fichiers + textes différents.</p> + + <example><title>Vérification dans plusieurs fichiers de mots de + passe au format texte</title> + + # On vérifie tout d'abord ici<br /> + <AuthnProviderAlias file file1><br /> + <indent> + AuthUserFile /www/conf/passwords1<br /> + </indent> + </AuthnProviderAlias><br /> + <br /> + # On vérifie ensuite là<br /> + <AuthnProviderAlias file file2> <br /> + <indent> + AuthUserFile /www/conf/passwords2<br /> + </indent> + </AuthnProviderAlias><br /> + <br /> + <Directory /var/web/pages/secure><br /> + <indent> + AuthBasicProvider file1 file2<br /> + <br /> + AuthType Basic<br /> + AuthName "Zone protégée"<br /> + Require valid-user<br /> + </indent> + </Directory><br /> + </example> + + + + <p>Dans l'exemple ci-dessous, deux fournisseurs + d'authentification ldap sont créés à partir du fournisseur ldap + de base, et se voient attribuer un alias. L'authentification + d'une même zone peut alors être traitée par plusieurs serveurs + ldap :</p> + + <example><title>Vérification auprès de plusieurs serveurs + LDAP</title> + <AuthnProviderAlias ldap alias-ldap><br /> + <indent> + AuthLDAPBindDN cn=utilisateur,o=ctx<br /> + AuthLDAPBindPassword mot-de-passe<br /> + AuthLDAPURL ldap://serveur.ldap/o=ctx<br /> + </indent> + </AuthnProviderAlias><br /><br /> + <AuthnProviderAlias ldap autre-alias-ldap><br /> + <indent> + AuthLDAPBindDN cn=autre-utilisateur,o=dev<br /> + AuthLDAPBindPassword autre-mot-de-passe<br /> + AuthLDAPURL ldap://autre.serveur.ldap/o=dev?cn<br /> + </indent> + </AuthnProviderAlias><br /><br /> + + Alias /secure /webpages/secure<br /> + <Directory /webpages/secure><br /> + <indent> + Order deny,allow<br /> + Allow from all<br /><br /> + + AuthBasicProvider autre-alias-ldap alias-ldap <br /><br /> + + AuthType Basic<br />Exemple + AuthName Zone_protégée_par_LDAP<br /> + Require valid-user<br /> + </indent> + </Directory><br /> + </example> + </section> + +</section> + + +<directivesynopsis> +<name>AuthName</name> +<description>L'identifiant de l'autorisation à utiliser avec +l'authentification HTTP</description> +<syntax>AuthName <var>domaine d'autorisation</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Cette directive permet de définir l'identifiant d'autorisation + pour un répertoire. Cet identifiant est fourni au client de façon à + ce qu'il sache quels nom d'utilisateur et mot de passe envoyer. + <directive>AuthName</directive> accepte un seul argument ; s'il + contient des espaces, il doit être entouré de guillemets. Pour + pouvoir fonctionner, la directive <directive>AuthName</directive> + doit être utilisée en combinaison avec les directives <directive + module="mod_authn_core">AuthType</directive> et <directive + module="mod_authz_core">Require</directive>, ainsi que des + directives comme <directive + module="mod_authn_file">AuthUserFile</directive> et <directive + module="mod_authz_groupfile">AuthGroupFile</directive>.</p> + + <p>Par exemple :</p> + + <example> + AuthName "Top Secret" + </example> + + <p>La chaîne fournie comme argument à <code>AuthName</code> + apparaîtra dans la boîte de dialogue d'authentification pour la + plupart des navigateurs.</p> +</usage> +<seealso><a + href="../howto/auth.html">Authentification, autorisation et contrôle + d'accès</a></seealso> +<seealso><module>mod_authz_core</module></seealso> +</directivesynopsis> + +<directivesynopsis> +<name>AuthType</name> +<description>Type d'authentification utilisateur</description> +<syntax>AuthType None|Basic|Digest|Form</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Cette directive permet de définir le type d'authentification + utilisateur pour un répertoire. Les types d'authentification + disponibles sont <code>None</code>, <code>Basic</code> (implémenté + par <module>mod_auth_basic</module>), <code>Digest</code> + (implémenté par <module>mod_auth_digest</module>), et + <code>Form</code> (implémenté par + <module>mod_auth_form</module>).</p> + + <p>Pour mettre en oeuvre l'authentification, vous devez aussi + utiliser les directives <directive + module="mod_authn_core">AuthName</directive> et <directive + module="mod_authz_core">Require</directive>. De plus, le serveur + doit pouvoir disposer d'un module fournisseur d'authentification + comme <module>mod_authn_file</module> et d'un module d'autorisation + comme <module>mod_authz_user</module>.</p> + + <p>Le type d'authentification <code>None</code> désactive + l'authentification. Lorsqu'une authentification est définie, elle + est en général héritée par chacune des <a + href="../sections.html#mergin">sections de configuration</a> qui + suivent, à moins qu'un autre type d'authentification ne soit + spécifié. Si l'on ne souhaite pas mettre en oeuvre + d'authentification pour une sous-section d'une section authentifiée, + on doit utiliser le type d'authentification <code>None</code> ; dans + l'exemple suivant, les clients peuvent accéder au répertoire + <code>/www/docs/public</code> sans devoir s'authentifier :</p> + + <example> + <Directory /www/docs> + <indent> + AuthType Basic<br /> + AuthName Documents<br /> + AuthBasicProvider file<br /> + AuthUserFile /usr/local/apache/passwd/passwords<br /> + Require valid-user + </indent> + </Directory><br /> + <br /> + <Directory /www/docs/public> + <indent> + AuthType None<br /> + Require all granted + </indent> + </Directory> + </example> + + <note>Veuillez noter que, lorsque l'authentification n'est pas + activée, les clients qui se sont déjà authentifiés pour une autre + zone de l'arborescence du site continueront en général à envoyer des + en-tête d'authentification HTTP ou des cookies avec chaque requête, + sans se préoccuper de savoir si le serveur nécessite vraiment une + authentification pour chaque ressource.</note> +</usage> + +<seealso><a href="../howto/auth.html">Authentification, autorisation et contrôle + d'accès</a></seealso> +</directivesynopsis> + +<directivesynopsis type="section"> +<name>AuthnProviderAlias</name> +<description>Regroupe un ensemble de directives qui constituent une +extension d'un fournisseur d'authentification de base et lui attribue +l'alias spécifié</description> +<syntax><AuthnProviderAlias <var>alias-fournisseur</var>> +... </AuthnProviderAlias></syntax> +<contextlist><context>server config</context> +</contextlist> + +<usage> + <p>Les balises <code><AuthnProviderAlias></code> et + <code></AuthnProviderAlias></code> permettent de regrouper un + ensemble de directives d'authentification qui seront référencées par + l'alias spécifié à l'aide des directives <directive + module="mod_auth_basic">AuthBasicProvider</directive> ou <directive + module="mod_auth_digest">AuthDigestProvider</directive>.</p> + +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authn_core.xml.meta b/docs/manual/mod/mod_authn_core.xml.meta index 06cf00a8a1..c98385acfd 100644 --- a/docs/manual/mod/mod_authn_core.xml.meta +++ b/docs/manual/mod/mod_authn_core.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_headers.html b/docs/manual/mod/mod_headers.html index 3deae9de73..f737b4dc88 100644 --- a/docs/manual/mod/mod_headers.html +++ b/docs/manual/mod/mod_headers.html @@ -4,6 +4,10 @@ URI: mod_headers.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_headers.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_headers.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_headers.html.en b/docs/manual/mod/mod_headers.html.en index 836fec7f37..3ca4346a1d 100644 --- a/docs/manual/mod/mod_headers.html.en +++ b/docs/manual/mod/mod_headers.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_headers</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_headers.html" title="English"> en </a> | +<a href="../fr/mod/mod_headers.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -443,6 +444,7 @@ headers</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_headers.html" title="English"> en </a> | +<a href="../fr/mod/mod_headers.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_headers.html.fr b/docs/manual/mod/mod_headers.html.fr new file mode 100644 index 0000000000..e83af5f714 --- /dev/null +++ b/docs/manual/mod/mod_headers.html.fr @@ -0,0 +1,499 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_headers - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_headers</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_headers.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_headers.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Personnalisation des en-têtes de requêtes et de réponses +HTTP</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>headers_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_headers.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module fournit des directives permettant de contrôler et + modifier les en-têtes de requêtes et de réponses HTTP. Les en-têtes + peuvent être fusionnés, remplacés ou supprimés.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#header">Header</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#requestheader">RequestHeader</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#order">Chronologie du traitement</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#early">Traitement précoce et traitement +tardif</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="order" id="order">Chronologie du traitement</a></h2> + + <p>Les directives fournies par <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> peuvent + s'insérer presque partout dans la configuration du serveur, et on + peut limiter leur portée en les plaçant dans des <a href="../sections.html">sections de configuration</a>.</p> + + <p>La chronologie du traitement est importante et est affectée par + l'ordre d'apparition des directives dans le fichier de configuration + et par leur placement dans les <a href="../sections.html#mergin">sections de configuration</a>. Ainsi, + ces deux directives ont un effet différent si leur ordre est inversé + :</p> + + <div class="example"><p><code> + RequestHeader append MirrorID "mirror 12"<br /> + RequestHeader unset MirrorID + </code></p></div> + + <p>Dans cet ordre, l'en-tête <code>MirrorID</code> n'est pas défini. + Si l'ordre des directives était inversé, l'en-tête + <code>MirrorID</code> serait défini à "mirror 12".</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="early" id="early">Traitement précoce et traitement +tardif</a></h2> + <p><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> peut agir soir précocement, soit + tardivement au niveau de la requête. Le mode normal est le mode + tardif, lorsque les en-têtes de requête sont définis, immédiatement + avant l'exécution du générateur de contenu, et pour les en-têtes de + réponse, juste au moment où la réponse est envoyée sur le réseau. + Utilisez toujours le mode tardif sur un serveur en production.</p> + + <p>Le mode précoce a été conçu à des fins d'aide aux tests et au + débogage pour les développeurs. Les directives définies en utilisant + le mot-clé <code>early</code> sont censées agir au tout début du + traitement de la requête. Cela signifie que l'on peut les utiliser + pour simuler différentes requêtes et définir des situations de test, + tout en gardant à l'esprit que les en-têtes peuvent être modifiés à + tout moment par d'autres modules avant que le réponse ne soit + générée.</p> + + <p>Comme les directives précoces sont traitées avant que le + chemin de la requête ne soit parcouru, les en-têtes + précoces ne peuvent être définis que dans un contexte de serveur + principal ou de serveur virtuel. Les directives précoces ne peuvent + pas dépendre d'un chemin de requête, si bien qu'elles échoueront + dans des contextes tels que <code><Directory></code> ou + <code><Location></code>.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="examples" id="examples">Exemples</a></h2> + + <ol> + <li> + Copie tous les en-têtes de requête qui commencent par "TS" vers + les en-têtes de la réponse : + + <div class="example"><p><code> + Header echo ^TS + </code></p></div> + </li> + + <li> + Ajoute à la réponse un en-tête, <code>mon-en-tête</code>, qui + contient un horodatage permettant de déterminer le moment où la + requête a été reçue, et le temps qui s'est écoulé jusqu'à ce que + la requête ait commencé à être servie. Cet en-tête peut être + utilisé par le client pour estimer la charge du serveur ou + isoler les goulets d'étranglement entre le client et le + serveur. + + <div class="example"><p><code> + Header set mon-en-tête "%D %t" + </code></p></div> + + <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> + + <div class="example"><p><code> + mon-en-tête: D=3775428 t=991424704447256 + </code></p></div> + </li> + + <li> + Dit Bonjour à Joe + + <div class="example"><p><code> + Header set mon-en-tête "Bonjour Joe. Il a fallu %D microsecondes \<br /> + à Apache pour servir cette requête." + </code></p></div> + + <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> + + <div class="example"><p><code> + mon-en-tête: Bonjour Joe. Il a fallu D=3775428 microsecondes à Apache + pour servir cette requête. + </code></p></div> + </li> + + <li> + Ajoute l'en-tête <code>mon-en-tête</code> à la réponse si et + seulement si l'en-tête <code>mon-en-tête-requête</code> est + présent dans la requête. Ceci peut s'avérer utile pour générer + des en-têtes de réponse "à la tête du client". Notez que cet + exemple nécessite les services du module + <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. + + <div class="example"><p><code> + SetEnvIf mon-en-tête-requête mavaleur HAVE_MyRequestHeader<br /> + Header set mon-en-tête "%D %t montexte" env=HAVE_MyRequestHeader + </code></p></div> + + <p>Si l'en-tête <code>mon-en-tête-requête: mavaleur</code> est + présent dans la requête HTTP, la réponse contiendra un en-tête + du type :</p> + + <div class="example"><p><code> + mon-en-tête: D=3775428 t=991424704447256 montexte + </code></p></div> + </li> + + <li> + Permet à DAV de fonctionner avec Apache sur SSL (voir la <a href="http://svn.haxx.se/users/archive-2006-03/0549.shtml">description + du problème</a>) en remplaçant <var>https:</var> par + <var>http:</var> dans l'en-tête <var>Destination</var> : + + <div class="example"><p><code> + RequestHeader edit Destination ^https: http: early + </code></p></div> + </li> + + <li> + Définit la valeur d'un même en-tête sous de multiples conditions + non exclusives, mais ne duplique pas une valeur déjà définie + dans l'en-tête qui en résulte. Si toutes les conditions + suivantes sont satisfaites pour une requête (en d'autres termes, + si les trois variables d'environnement <code>CGI</code>, + <code>NO_CACHE</code> et <code>NO_STORE</code> existent pour la + requête) : + + <div class="example"><p><code> + Header merge Cache-Control no-cache env=CGI<br /> + Header merge Cache-Control no-cache env=NO_CACHE<br /> + Header merge Cache-Control no-store env=NO_STORE + </code></p></div> + + <p>alors, la réponse contiendra l'en-tête suivant :</p> + + <div class="example"><p><code> + Cache-Control: no-cache, no-store + </code></p></div> + + <p>Si <code>append</code> avait été utilisé à la place de + <code>merge</code>, la réponse aurait contenu l'en-tête suivant + :</p> + + <div class="example"><p><code> + Cache-Control: no-cache, no-cache, no-store + </code></p></div> + </li> + <li> + Définit un cookie de test si et seulement si le client n'envoie + pas de cookie + <div class="example"><p><code> + Header set Set-Cookie testcookie !$req{Cookie} + </code></p></div> + </li> + </ol> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Header" id="Header">Header</a> <a name="header" id="header">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure les en-têtes d'une réponse HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Header [<var>condition</var>] add|append|echo|edit|merge|set|unset +<var>en-tête</var> [<var>valeur</var>] [early|env=[!]<var>variable</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_headers</td></tr> +</table> + <p>Cette directive permet de remplacer, fusionner, ou + supprimer des en-têtes de réponse HTTP. L'en-tête est modifié juste + après que le gestionnaire de contenu et les filtres en sortie ne + s'exécutent, ce qui permet la modification des en-têtes + sortants.</p> + + <p>Par défaut, cette directive n'affecte que les réponses positives + (réponses dont le code de statut est dans la gamme + <code>2<var>xx</var></code>). Le paramètre optionnel + <var>condition</var> peut prendre pour valeur soit + <code>onsuccess</code> (valeur par défaut), soit <code>always</code> + (tous les codes de statut, y compris les réponses positives). + Définir cette valeur à <code>always</code> permet d'affecter des + en-têtes définis par certains modules internes, y compris dans le + cas d'une réponse positive, et s'avère même nécessaire pour affecter + des en-têtes de réponses dont le code de statut n'est pas dans la + gamme <code>2<var>xx</var></code> comme les redirections ou les + erreurs client.</p> + + <p>L'action que cette directive provoque est déterminée par le + second argument. Il peut prendre une des valeurs suivantes :</p> + + <dl> + <dt><code>add</code></dt> + <dd>L'en-tête est ajouté au jeu d'en-têtes préexistant, même s'il + existe déjà. Ceci peut conduire à la présence de deux (ou plusieurs) + en-têtes possèdant le même nom et donc induire des conséquences + imprévues ; en général, il est préférable d'utiliser + <code>set</code>, <code>append</code> ou <code>merge</code>.</dd> + + <dt><code>append</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête existant de même + nom. Lorsqu'une nouvelle valeur est ainsi ajoutée, elle est séparée + de celles qui sont déjà présentes par une virgule. Il s'agit de la + méthode HTTP standard permettant d'affecter plusieurs valeurs à un + en-tête.</dd> + + <dt><code>echo</code></dt> + <dd>Les en-têtes de la requête possédant le nom spécifié sont + recopiés vers les en-têtes de la réponse. <var>en-tête</var> peut + être une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et + <var>valeur</var> ne doit pas être présent.</dd> + + <dt><code>edit</code></dt> + <dd>Si l'en-tête existe, sa valeur est modifiée en fonction d'une + <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> de type + recherche/remplacement. L'argument <var>valeur</var> est une + <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et + l'argument <var>remplacement</var> une chaîne de caractères de + remplacement qui peut contenir des références arrières.</dd> + + <dt><code>merge</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête de même nom, sauf + si elle apparaît déjà dans la liste des valeurs préexistantes de + l'en-tête séparées par des virgules. Lorsqu'une nouvelle valeur est + ainsi ajoutée, elle est séparée de celles qui sont déjà présentes + par une virgule. Il s'agit de la méthode HTTP standard permettant + d'affecter plusieurs valeurs à un en-tête. Les valeurs sont + comparées en tenant compte de la casse, et après le traitement de + tous les spécificateurs de format. Une valeur entourée de guillemets + est considérée comme différente de la même valeur mais sans + guillemets.</dd> + + <dt><code>set</code></dt> + <dd>L'en-tête est défini, remplaçant tout en-tête préexistant avec + le même nom. L'argument <var>valeur</var> peut être une chaîne de + formatage.</dd> + + <dt><code>unset</code></dt> + <dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes + possèdent le même nom, ils seront tous supprimés. L'argument + <var>value</var> ne doit pas apparaître.</dd> + </dl> + + <p>Cet argument est suivi d'un nom d'<var>en-tête</var> qui peut se + terminer par un caractère ':', mais ce n'est pas obligatoire. La + casse est ignorée avec <code>set</code>, <code>append</code>, + <code>merge</code>, <code>add</code>, <code>unset</code> et + <code>edit</code>. Le nom d'<var>en-tête</var> est sensible à la + casse pour <code>echo</code> et peut être une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</p> + + <p>Avec <code>set</code>, <code>append</code>, <code>merge</code> et + <code>add</code>, une <var>valeur</var> est spécifiée comme + troisième argument. Si <var>valeur</var> contient des espaces, elle + doit être entourée de guillemets. <var>valeur</var> peut être une + chaîne de caractères, une chaîne contenant des spécificateurs de + format, ou une combinaison des deux. <var>valeur</var> supporte les + spécificateurs de format suivants :</p> + + <table class="bordered"><tr class="header"><th>Format</th><th>Description</th></tr> +<tr><td><code>%%</code></td> + <td>Le caractère pourcentage</td></tr> +<tr class="odd"><td><code>%t</code></td> + <td>Le moment de réception de la requête en temps + universel coordonné depuis le temps epoch (Jan. 1, 1970) et + exprimé en microsecondes. La valeur est précédée de + <code>t=</code>.</td></tr> +<tr><td><code>%D</code></td> + <td>Le temps écoulé entre la réception de la requête et l'envoi + des en-têtes sur le réseau. Il s'agit de la durée de traitement + de la requête. La valeur est précédée de <code>D=</code>. La + valeur est exprimée en microsecondes.</td></tr> +<tr class="odd"><td><code>%{NOM_VARIABLE}e</code></td> + <td>Le contenu de la <a href="../env.html">variable + d'environnement</a> <code>NOM_VARIABLE</code>.</td></tr> +<tr><td><code>%{NOM_VARIABLE}s</code></td> + <td>Le contenu de la <a href="../env.html">variable + d'environnement SSL</a> <code>NOM_VARIABLE</code>, si + <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> est activé.</td></tr> +</table> + + <div class="note"><h3>Note</h3> + <p>Le spécificateur de format <code>%s</code> est disponible + depuis la version 2.1 d'Apache ; il peut être utilisé à la place + de <code>%e</code> pour éviter de devoir spécifier + <code>SSLOptions +StdEnvVars</code>. Cependant, si + <code>SSLOptions +StdEnvVars</code> doit tout de même être + spécifié pour une raison quelconque, <code>%e</code> sera plus + efficace que <code>%s</code>.</p> + </div> + + <p><code>edit</code>nécessite les deux arguments + <var>valeur</var>, qui est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression + rationnelle</a>, et une chaîne additionnelle + <var>remplacement</var>.</p> + + <p>La directive <code class="directive">Header</code> peut être suivie d'un + argument additionnel qui peut prendre les valeurs suivantes :</p> + + <dl> + <dt><code>early</code></dt> + <dd>Spécifie <a href="#early">traitement préalable</a>.</dd> + <dt><code>env=[!]variable</code></dt> + <dd>La directive est appliquée si et seulement si la <a href="../env.html">variable d'environnement</a> + <code>variable</code> existe. Un <code>!</code> devant + <code>variable</code> inverse le test, et la directive ne + s'appliquera alors que si <code>variable</code> n'est pas définie.</dd> + <dt><code>expr</code></dt> + <dd>Une chaîne qui correspond à toute valeur ci-dessus est + interprétée comme une expression. Les détails à propos de la syntaxe + des expressions et leur évaluation sont pour l'instant mieux + documentés dans la page de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>.</dd> + </dl> + + <p>Excepté le cas du mode <a href="#early">précoce</a>, les + directives <code class="directive">Header</code> sont traitées juste avant + l'envoi de la réponse sur le réseau. Cela signifie qu'il est + possible de définir et/ou modifier la plupart des en-têtes, à + l'exception de ceux qui sont ajoutés par le filtre d'en-tête.</p> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="RequestHeader" id="RequestHeader">RequestHeader</a> <a name="requestheader" id="requestheader">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure les en-têtes d'une requête HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RequestHeader add|append|edit|merge|set|unset <var>en-tête</var> +[<var>valeur</var>] [<var>remplacement</var>] [early|env=[!]<var>variable</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_headers</td></tr> +</table> + <p>Cette directive permet de remplacer, fusionner, modifier ou + supprimer des en-têtes de requête HTTP. L'en-tête est modifié juste + avant que le gestionnaire de contenu ne s'exécute, ce qui permet la + modification des en-têtes entrants. L'action effectuée est + déterminée par le premier argument. Ce dernier accepte les valeurs + suivantes :</p> + + <dl> + + <dt><code>add</code></dt> + <dd>L'en-tête est ajouté au jeu d'en-têtes préexistant, même s'il + existe déjà. Ceci peut conduire à la présence de deux (ou plusieurs) + en-têtes possèdant le même nom et donc induire des conséquences + imprévues ; en général, il est préférable d'utiliser + <code>set</code>, <code>append</code> ou <code>merge</code>.</dd> + + <dt><code>append</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête existant de même + nom. Lorsqu'une nouvelle valeur est ainsi ajoutée, elle est séparée + de celles qui sont déjà présentes par une virgule. Il s'agit de la + méthode HTTP standard permettant d'affecter plusieurs valeurs à un + en-tête.</dd> + + <dt><code>edit</code></dt> + <dd>Si l'en-tête existe, sa valeur est modifiée en fonction d'une + <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> de type + recherche/remplacement. L'argument <var>valeur</var> est une + <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et + l'argument <var>remplacement</var> une chaîne de caractères de + remplacement qui peut contenir des références arrières.</dd> + + <dt><code>merge</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête de même nom, sauf + si elle apparaît déjà dans la liste des valeurs préexistantes de + l'en-tête séparées par des virgules. Lorsqu'une nouvelle valeur est + ainsi ajoutée, elle est séparée de celles qui sont déjà présentes + par une virgule. Il s'agit de la méthode HTTP standard permettant + d'affecter plusieurs valeurs à un en-tête. Les valeurs sont + comparées en tenant compte de la casse, et après le traitement de + tous les spécificateurs de format. Une valeur entourée de guillemets + est considérée comme différente de la même valeur mais sans + guillemets.</dd> + + <dt><code>set</code></dt> + <dd>L'en-tête est défini, remplaçant tout en-tête préexistant avec + le même nom.</dd> + + <dt><code>unset</code></dt> + <dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes + possèdent le même nom, ils seront tous supprimés. L'argument + <var>value</var> ne doit pas apparaître.</dd> + </dl> + + <p>Cet argument est suivi d'un nom d'en-tête qui peut se terminer + par un caractère ':', mais ce n'est pas obligatoire. La casse est + ignorée. Avec <code>set</code>, <code>append</code>, + <code>merge</code> et <code>add</code>, une <var>valeur</var> est + fournie en troisième argument. Si une <var>valeur</var> contient des + espaces, elle doit être entourée de guillemets. Avec + <code>unset</code>, aucune <var>valeur</var> ne doit apparaître. + <var>valeur</var> peut être une chaîne de caractères, une chaîne + contenant des spécificateurs de format, ou une combinaison des deux. + Les spécificateurs de format supportés sont les mêmes que ceux de la + directive <code class="directive"><a href="#header">Header</a></code>, à + laquelle vous pouvez vous reporter pour plus de détails. Avec + <code>edit</code>, les deux arguments <var>valeur</var> et + <var>remplacement</var> sont obligatoires, et correspondent + respectivement à une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression + rationnelle</a> et à une chaîne de remplacement.</p> + + <p>La directive <code class="directive">RequestHeader</code> peut être + suivie d'un argument supplémentaire, qui pourra prendre les valeurs + suivantes :</p> + <dl> + <dt><code>early</code></dt> + <dd>Spécifie <a href="#early">traitement préalable</a>.</dd> + <dt><code>env=[!]variable</code></dt> + <dd>La directive est appliquée si et seulement si la <a href="../env.html">variable d'environnement</a> + <code>variable</code> existe. Un <code>!</code> devant + <code>variable</code> inverse le test, et la directive ne + s'appliquera alors que si <code>variable</code> n'est pas définie.</dd> + <dt><code>expr</code></dt> + <dd>Une chaîne qui correspond à toute valeur ci-dessus est + interprétée comme une expression. Les détails à propos de la syntaxe + des expressions et leur évaluation sont pour l'instant mieux + documentés dans la page de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>.</dd> + </dl> + + <p>Excepté le cas du mode <a href="#early">précoce</a>, la directive + <code class="directive">RequestHeader</code> est traitée juste avant la + prise en compte de la requête par son gestionnaire, au cours de la + phase de vérification. Ceci permet la modification des en-têtes + générés par le navigateur, ou par les filtres en entrée + d'Apache.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_headers.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_headers.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_headers.xml.fr b/docs/manual/mod/mod_headers.xml.fr new file mode 100644 index 0000000000..9014d95f82 --- /dev/null +++ b/docs/manual/mod/mod_headers.xml.fr @@ -0,0 +1,491 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 826164 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_headers.xml.meta"> + +<name>mod_headers</name> +<description>Personnalisation des en-têtes de requêtes et de réponses +HTTP</description> +<status>Extension</status> +<sourcefile>mod_headers.c</sourcefile> +<identifier>headers_module</identifier> + +<summary> + <p>Ce module fournit des directives permettant de contrôler et + modifier les en-têtes de requêtes et de réponses HTTP. Les en-têtes + peuvent être fusionnés, remplacés ou supprimés.</p> +</summary> + +<section id="order"><title>Chronologie du traitement</title> + + <p>Les directives fournies par <module>mod_headers</module> peuvent + s'insérer presque partout dans la configuration du serveur, et on + peut limiter leur portée en les plaçant dans des <a + href="../sections.html">sections de configuration</a>.</p> + + <p>La chronologie du traitement est importante et est affectée par + l'ordre d'apparition des directives dans le fichier de configuration + et par leur placement dans les <a + href="../sections.html#mergin">sections de configuration</a>. Ainsi, + ces deux directives ont un effet différent si leur ordre est inversé + :</p> + + <example> + RequestHeader append MirrorID "mirror 12"<br /> + RequestHeader unset MirrorID + </example> + + <p>Dans cet ordre, l'en-tête <code>MirrorID</code> n'est pas défini. + Si l'ordre des directives était inversé, l'en-tête + <code>MirrorID</code> serait défini à "mirror 12".</p> +</section> + +<section id="early"><title>Traitement précoce et traitement +tardif</title> + <p><module>mod_headers</module> peut agir soir précocement, soit + tardivement au niveau de la requête. Le mode normal est le mode + tardif, lorsque les en-têtes de requête sont définis, immédiatement + avant l'exécution du générateur de contenu, et pour les en-têtes de + réponse, juste au moment où la réponse est envoyée sur le réseau. + Utilisez toujours le mode tardif sur un serveur en production.</p> + + <p>Le mode précoce a été conçu à des fins d'aide aux tests et au + débogage pour les développeurs. Les directives définies en utilisant + le mot-clé <code>early</code> sont censées agir au tout début du + traitement de la requête. Cela signifie que l'on peut les utiliser + pour simuler différentes requêtes et définir des situations de test, + tout en gardant à l'esprit que les en-têtes peuvent être modifiés à + tout moment par d'autres modules avant que le réponse ne soit + générée.</p> + + <p>Comme les directives précoces sont traitées avant que le + chemin de la requête ne soit parcouru, les en-têtes + précoces ne peuvent être définis que dans un contexte de serveur + principal ou de serveur virtuel. Les directives précoces ne peuvent + pas dépendre d'un chemin de requête, si bien qu'elles échoueront + dans des contextes tels que <code><Directory></code> ou + <code><Location></code>.</p> +</section> + +<section id="examples"><title>Exemples</title> + + <ol> + <li> + Copie tous les en-têtes de requête qui commencent par "TS" vers + les en-têtes de la réponse : + + <example> + Header echo ^TS + </example> + </li> + + <li> + Ajoute à la réponse un en-tête, <code>mon-en-tête</code>, qui + contient un horodatage permettant de déterminer le moment où la + requête a été reçue, et le temps qui s'est écoulé jusqu'à ce que + la requête ait commencé à être servie. Cet en-tête peut être + utilisé par le client pour estimer la charge du serveur ou + isoler les goulets d'étranglement entre le client et le + serveur. + + <example> + Header set mon-en-tête "%D %t" + </example> + + <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> + + <example> + mon-en-tête: D=3775428 t=991424704447256 + </example> + </li> + + <li> + Dit Bonjour à Joe + + <example> + Header set mon-en-tête "Bonjour Joe. Il a fallu %D microsecondes \<br /> + à Apache pour servir cette requête." + </example> + + <p>le résultat est l'ajout à la réponse d'un en-tête du type :</p> + + <example> + mon-en-tête: Bonjour Joe. Il a fallu D=3775428 microsecondes à Apache + pour servir cette requête. + </example> + </li> + + <li> + Ajoute l'en-tête <code>mon-en-tête</code> à la réponse si et + seulement si l'en-tête <code>mon-en-tête-requête</code> est + présent dans la requête. Ceci peut s'avérer utile pour générer + des en-têtes de réponse "à la tête du client". Notez que cet + exemple nécessite les services du module + <module>mod_setenvif</module>. + + <example> + SetEnvIf mon-en-tête-requête mavaleur HAVE_MyRequestHeader<br /> + Header set mon-en-tête "%D %t montexte" env=HAVE_MyRequestHeader + </example> + + <p>Si l'en-tête <code>mon-en-tête-requête: mavaleur</code> est + présent dans la requête HTTP, la réponse contiendra un en-tête + du type :</p> + + <example> + mon-en-tête: D=3775428 t=991424704447256 montexte + </example> + </li> + + <li> + Permet à DAV de fonctionner avec Apache sur SSL (voir la <a + href="http://svn.haxx.se/users/archive-2006-03/0549.shtml">description + du problème</a>) en remplaçant <var>https:</var> par + <var>http:</var> dans l'en-tête <var>Destination</var> : + + <example> + RequestHeader edit Destination ^https: http: early + </example> + </li> + + <li> + Définit la valeur d'un même en-tête sous de multiples conditions + non exclusives, mais ne duplique pas une valeur déjà définie + dans l'en-tête qui en résulte. Si toutes les conditions + suivantes sont satisfaites pour une requête (en d'autres termes, + si les trois variables d'environnement <code>CGI</code>, + <code>NO_CACHE</code> et <code>NO_STORE</code> existent pour la + requête) : + + <example> + Header merge Cache-Control no-cache env=CGI<br /> + Header merge Cache-Control no-cache env=NO_CACHE<br /> + Header merge Cache-Control no-store env=NO_STORE + </example> + + <p>alors, la réponse contiendra l'en-tête suivant :</p> + + <example> + Cache-Control: no-cache, no-store + </example> + + <p>Si <code>append</code> avait été utilisé à la place de + <code>merge</code>, la réponse aurait contenu l'en-tête suivant + :</p> + + <example> + Cache-Control: no-cache, no-cache, no-store + </example> + </li> + <li> + Définit un cookie de test si et seulement si le client n'envoie + pas de cookie + <example> + Header set Set-Cookie testcookie !$req{Cookie} + </example> + </li> + </ol> +</section> + +<directivesynopsis> +<name>RequestHeader</name> +<description>Configure les en-têtes d'une requête HTTP</description> +<syntax>RequestHeader add|append|edit|merge|set|unset <var>en-tête</var> +[<var>valeur</var>] [<var>remplacement</var>] [early|env=[!]<var>variable</var>]</syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Cette directive permet de remplacer, fusionner, modifier ou + supprimer des en-têtes de requête HTTP. L'en-tête est modifié juste + avant que le gestionnaire de contenu ne s'exécute, ce qui permet la + modification des en-têtes entrants. L'action effectuée est + déterminée par le premier argument. Ce dernier accepte les valeurs + suivantes :</p> + + <dl> + + <dt><code>add</code></dt> + <dd>L'en-tête est ajouté au jeu d'en-têtes préexistant, même s'il + existe déjà. Ceci peut conduire à la présence de deux (ou plusieurs) + en-têtes possèdant le même nom et donc induire des conséquences + imprévues ; en général, il est préférable d'utiliser + <code>set</code>, <code>append</code> ou <code>merge</code>.</dd> + + <dt><code>append</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête existant de même + nom. Lorsqu'une nouvelle valeur est ainsi ajoutée, elle est séparée + de celles qui sont déjà présentes par une virgule. Il s'agit de la + méthode HTTP standard permettant d'affecter plusieurs valeurs à un + en-tête.</dd> + + <dt><code>edit</code></dt> + <dd>Si l'en-tête existe, sa valeur est modifiée en fonction d'une + <glossary ref="regex">expression rationnelle</glossary> de type + recherche/remplacement. L'argument <var>valeur</var> est une + <glossary ref="regex">expression rationnelle</glossary>, et + l'argument <var>remplacement</var> une chaîne de caractères de + remplacement qui peut contenir des références arrières.</dd> + + <dt><code>merge</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête de même nom, sauf + si elle apparaît déjà dans la liste des valeurs préexistantes de + l'en-tête séparées par des virgules. Lorsqu'une nouvelle valeur est + ainsi ajoutée, elle est séparée de celles qui sont déjà présentes + par une virgule. Il s'agit de la méthode HTTP standard permettant + d'affecter plusieurs valeurs à un en-tête. Les valeurs sont + comparées en tenant compte de la casse, et après le traitement de + tous les spécificateurs de format. Une valeur entourée de guillemets + est considérée comme différente de la même valeur mais sans + guillemets.</dd> + + <dt><code>set</code></dt> + <dd>L'en-tête est défini, remplaçant tout en-tête préexistant avec + le même nom.</dd> + + <dt><code>unset</code></dt> + <dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes + possèdent le même nom, ils seront tous supprimés. L'argument + <var>value</var> ne doit pas apparaître.</dd> + </dl> + + <p>Cet argument est suivi d'un nom d'en-tête qui peut se terminer + par un caractère ':', mais ce n'est pas obligatoire. La casse est + ignorée. Avec <code>set</code>, <code>append</code>, + <code>merge</code> et <code>add</code>, une <var>valeur</var> est + fournie en troisième argument. Si une <var>valeur</var> contient des + espaces, elle doit être entourée de guillemets. Avec + <code>unset</code>, aucune <var>valeur</var> ne doit apparaître. + <var>valeur</var> peut être une chaîne de caractères, une chaîne + contenant des spécificateurs de format, ou une combinaison des deux. + Les spécificateurs de format supportés sont les mêmes que ceux de la + directive <directive module="mod_headers">Header</directive>, à + laquelle vous pouvez vous reporter pour plus de détails. Avec + <code>edit</code>, les deux arguments <var>valeur</var> et + <var>remplacement</var> sont obligatoires, et correspondent + respectivement à une <glossary ref="regex">expression + rationnelle</glossary> et à une chaîne de remplacement.</p> + + <p>La directive <directive>RequestHeader</directive> peut être + suivie d'un argument supplémentaire, qui pourra prendre les valeurs + suivantes :</p> + <dl> + <dt><code>early</code></dt> + <dd>Spécifie <a href="#early">traitement préalable</a>.</dd> + <dt><code>env=[!]variable</code></dt> + <dd>La directive est appliquée si et seulement si la <a + href="../env.html">variable d'environnement</a> + <code>variable</code> existe. Un <code>!</code> devant + <code>variable</code> inverse le test, et la directive ne + s'appliquera alors que si <code>variable</code> n'est pas définie.</dd> + <dt><code>expr</code></dt> + <dd>Une chaîne qui correspond à toute valeur ci-dessus est + interprétée comme une expression. Les détails à propos de la syntaxe + des expressions et leur évaluation sont pour l'instant mieux + documentés dans la page de <module>mod_filter</module>.</dd> + </dl> + + <p>Excepté le cas du mode <a href="#early">précoce</a>, la directive + <directive>RequestHeader</directive> est traitée juste avant la + prise en compte de la requête par son gestionnaire, au cours de la + phase de vérification. Ceci permet la modification des en-têtes + générés par le navigateur, ou par les filtres en entrée + d'Apache.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Header</name> +<description>Configure les en-têtes d'une réponse HTTP</description> +<syntax>Header [<var>condition</var>] add|append|echo|edit|merge|set|unset +<var>en-tête</var> [<var>valeur</var>] [early|env=[!]<var>variable</var>]</syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Cette directive permet de remplacer, fusionner, ou + supprimer des en-têtes de réponse HTTP. L'en-tête est modifié juste + après que le gestionnaire de contenu et les filtres en sortie ne + s'exécutent, ce qui permet la modification des en-têtes + sortants.</p> + + <p>Par défaut, cette directive n'affecte que les réponses positives + (réponses dont le code de statut est dans la gamme + <code>2<var>xx</var></code>). Le paramètre optionnel + <var>condition</var> peut prendre pour valeur soit + <code>onsuccess</code> (valeur par défaut), soit <code>always</code> + (tous les codes de statut, y compris les réponses positives). + Définir cette valeur à <code>always</code> permet d'affecter des + en-têtes définis par certains modules internes, y compris dans le + cas d'une réponse positive, et s'avère même nécessaire pour affecter + des en-têtes de réponses dont le code de statut n'est pas dans la + gamme <code>2<var>xx</var></code> comme les redirections ou les + erreurs client.</p> + + <p>L'action que cette directive provoque est déterminée par le + second argument. Il peut prendre une des valeurs suivantes :</p> + + <dl> + <dt><code>add</code></dt> + <dd>L'en-tête est ajouté au jeu d'en-têtes préexistant, même s'il + existe déjà. Ceci peut conduire à la présence de deux (ou plusieurs) + en-têtes possèdant le même nom et donc induire des conséquences + imprévues ; en général, il est préférable d'utiliser + <code>set</code>, <code>append</code> ou <code>merge</code>.</dd> + + <dt><code>append</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête existant de même + nom. Lorsqu'une nouvelle valeur est ainsi ajoutée, elle est séparée + de celles qui sont déjà présentes par une virgule. Il s'agit de la + méthode HTTP standard permettant d'affecter plusieurs valeurs à un + en-tête.</dd> + + <dt><code>echo</code></dt> + <dd>Les en-têtes de la requête possédant le nom spécifié sont + recopiés vers les en-têtes de la réponse. <var>en-tête</var> peut + être une <glossary ref="regex">expression rationnelle</glossary>, et + <var>valeur</var> ne doit pas être présent.</dd> + + <dt><code>edit</code></dt> + <dd>Si l'en-tête existe, sa valeur est modifiée en fonction d'une + <glossary ref="regex">expression rationnelle</glossary> de type + recherche/remplacement. L'argument <var>valeur</var> est une + <glossary ref="regex">expression rationnelle</glossary>, et + l'argument <var>remplacement</var> une chaîne de caractères de + remplacement qui peut contenir des références arrières.</dd> + + <dt><code>merge</code></dt> + <dd>La valeur d'en-tête est ajoutée à tout en-tête de même nom, sauf + si elle apparaît déjà dans la liste des valeurs préexistantes de + l'en-tête séparées par des virgules. Lorsqu'une nouvelle valeur est + ainsi ajoutée, elle est séparée de celles qui sont déjà présentes + par une virgule. Il s'agit de la méthode HTTP standard permettant + d'affecter plusieurs valeurs à un en-tête. Les valeurs sont + comparées en tenant compte de la casse, et après le traitement de + tous les spécificateurs de format. Une valeur entourée de guillemets + est considérée comme différente de la même valeur mais sans + guillemets.</dd> + + <dt><code>set</code></dt> + <dd>L'en-tête est défini, remplaçant tout en-tête préexistant avec + le même nom. L'argument <var>valeur</var> peut être une chaîne de + formatage.</dd> + + <dt><code>unset</code></dt> + <dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes + possèdent le même nom, ils seront tous supprimés. L'argument + <var>value</var> ne doit pas apparaître.</dd> + </dl> + + <p>Cet argument est suivi d'un nom d'<var>en-tête</var> qui peut se + terminer par un caractère ':', mais ce n'est pas obligatoire. La + casse est ignorée avec <code>set</code>, <code>append</code>, + <code>merge</code>, <code>add</code>, <code>unset</code> et + <code>edit</code>. Le nom d'<var>en-tête</var> est sensible à la + casse pour <code>echo</code> et peut être une <glossary + ref="regex">expression rationnelle</glossary>.</p> + + <p>Avec <code>set</code>, <code>append</code>, <code>merge</code> et + <code>add</code>, une <var>valeur</var> est spécifiée comme + troisième argument. Si <var>valeur</var> contient des espaces, elle + doit être entourée de guillemets. <var>valeur</var> peut être une + chaîne de caractères, une chaîne contenant des spécificateurs de + format, ou une combinaison des deux. <var>valeur</var> supporte les + spécificateurs de format suivants :</p> + + <table border="1" style="zebra"> + <columnspec><column width=".25"/><column width=".75"/></columnspec> + <tr><th>Format</th><th>Description</th></tr> + <tr><td><code>%%</code></td> + <td>Le caractère pourcentage</td></tr> + + <tr><td><code>%t</code></td> + <td>Le moment de réception de la requête en temps + universel coordonné depuis le temps epoch (Jan. 1, 1970) et + exprimé en microsecondes. La valeur est précédée de + <code>t=</code>.</td></tr> + + <tr><td><code>%D</code></td> + <td>Le temps écoulé entre la réception de la requête et l'envoi + des en-têtes sur le réseau. Il s'agit de la durée de traitement + de la requête. La valeur est précédée de <code>D=</code>. La + valeur est exprimée en microsecondes.</td></tr> + + <tr><td><code>%{NOM_VARIABLE}e</code></td> + <td>Le contenu de la <a href="../env.html">variable + d'environnement</a> <code>NOM_VARIABLE</code>.</td></tr> + + <tr><td><code>%{NOM_VARIABLE}s</code></td> + <td>Le contenu de la <a href="../env.html">variable + d'environnement SSL</a> <code>NOM_VARIABLE</code>, si + <module>mod_ssl</module> est activé.</td></tr> + + </table> + + <note><title>Note</title> + <p>Le spécificateur de format <code>%s</code> est disponible + depuis la version 2.1 d'Apache ; il peut être utilisé à la place + de <code>%e</code> pour éviter de devoir spécifier + <code>SSLOptions +StdEnvVars</code>. Cependant, si + <code>SSLOptions +StdEnvVars</code> doit tout de même être + spécifié pour une raison quelconque, <code>%e</code> sera plus + efficace que <code>%s</code>.</p> + </note> + + <p><code>edit</code>nécessite les deux arguments + <var>valeur</var>, qui est une <glossary ref="regex">expression + rationnelle</glossary>, et une chaîne additionnelle + <var>remplacement</var>.</p> + + <p>La directive <directive>Header</directive> peut être suivie d'un + argument additionnel qui peut prendre les valeurs suivantes :</p> + + <dl> + <dt><code>early</code></dt> + <dd>Spécifie <a href="#early">traitement préalable</a>.</dd> + <dt><code>env=[!]variable</code></dt> + <dd>La directive est appliquée si et seulement si la <a + href="../env.html">variable d'environnement</a> + <code>variable</code> existe. Un <code>!</code> devant + <code>variable</code> inverse le test, et la directive ne + s'appliquera alors que si <code>variable</code> n'est pas définie.</dd> + <dt><code>expr</code></dt> + <dd>Une chaîne qui correspond à toute valeur ci-dessus est + interprétée comme une expression. Les détails à propos de la syntaxe + des expressions et leur évaluation sont pour l'instant mieux + documentés dans la page de <module>mod_filter</module>.</dd> + </dl> + + <p>Excepté le cas du mode <a href="#early">précoce</a>, les + directives <directive>Header</directive> sont traitées juste avant + l'envoi de la réponse sur le réseau. Cela signifie qu'il est + possible de définir et/ou modifier la plupart des en-têtes, à + l'exception de ceux qui sont ajoutés par le filtre d'en-tête.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_headers.xml.meta b/docs/manual/mod/mod_headers.xml.meta index e98c462add..83beb8c0a8 100644 --- a/docs/manual/mod/mod_headers.xml.meta +++ b/docs/manual/mod/mod_headers.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_unique_id.html b/docs/manual/mod/mod_unique_id.html index b8be353acc..11d0f0066a 100644 --- a/docs/manual/mod/mod_unique_id.html +++ b/docs/manual/mod/mod_unique_id.html @@ -4,6 +4,10 @@ URI: mod_unique_id.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_unique_id.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_unique_id.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_unique_id.html.en b/docs/manual/mod/mod_unique_id.html.en index 66f7cb2ee4..79c8b4785f 100644 --- a/docs/manual/mod/mod_unique_id.html.en +++ b/docs/manual/mod/mod_unique_id.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_unique_id</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_unique_id.html" title="English"> en </a> | +<a href="../fr/mod/mod_unique_id.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -208,6 +209,7 @@ identifier for each request</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_unique_id.html" title="English"> en </a> | +<a href="../fr/mod/mod_unique_id.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_unique_id.html.fr b/docs/manual/mod/mod_unique_id.html.fr new file mode 100644 index 0000000000..7290dac339 --- /dev/null +++ b/docs/manual/mod/mod_unique_id.html.fr @@ -0,0 +1,240 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_unique_id - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_unique_id</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_unique_id.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_unique_id.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit une variable d'environnement contenant un +identifiant unique pour chaque requête</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>unique_id_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_unique_id.c</td></tr></table> +<h3>Sommaire</h3> + + + <p>Ce module fournit un identifiant dont l'unicité est garantie + parmi "toutes" les requêtes sous des conditions très précises. + L'identifiant unique le sera aussi parmi plusieurs machines + appartenant à un cluster correctement configuré. L'identifiant est + affecté à la variable d'environnement <code>UNIQUE_ID</code> pour + chaque requête. Les identifiants uniques sont utiles pour diverses + raisons dont la nature se situe au delà de la portée de ce + document.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<p>Ce module ne fournit aucune directive.</p> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#theory">Théorie</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="theory" id="theory">Théorie</a></h2> + + + <p>Tout d'abord un bref rappel de la manière dont le serveur Apache + fonctionne sous Unix (cette fonctionnalité n'étant actuellement pas + supportée sous Windows NT). Sous Unix, Apache crée plusieurs + processus enfants, ces derniers traitant les requêtes une par une. + Chaque processus enfant peut traiter plusieurs requêtes pendant sa + durée de vie. Dans le cadre de cette discussion, nous supposerons + que les différents processus enfants ne s'échangent pas de données + entre eux. Nous nous référerons aux processus enfants sous le nom de + <dfn>processus httpd</dfn>.</p> + + <p>Votre site web est réparti entre une ou plusieurs machines dont + vous êtes l'administrateur, et que nous nommerons cluster de + serveurs. Chaque serveur peut exécuter plusieurs instances d'Apache. + L'ensemble de ces dernières sera considéré comme "l'Univers", et + sous certaines hypothèses, nous montrerons qu'il est possible dans + cet univers, de générer des identifiants uniques pour chaque + requête, sans pour autant nécessiter une communication importante + entre les différents serveurs du cluster.</p> + + <p>Les machines de votre cluster doivent satisfaire ces conditions + (même si le cluster ne comporte qu'une machine, vous devez + synchroniser son horloge avec NTP) :</p> + + <ul> + <li>Les temps des machines sont synchronisés via NTP ou tout autre + protocole de synchronisation du temps en réseau.</li> + + <li>Les nom d'hôtes des machines sont tous différents, de façon à + ce que le module puisse recevoir une adresse IP différente pour + chaque machine du cluster en effectuant une recherche sur le nom + d'hôte.</li> + </ul> + + <p>Au vu des caractéristiques actuelles du système d'exploitation, + nous supposerons que les pids (identifiants processus) sont codés + sur 32 bits. Si le système d'exploitation utilise plus de 32 bits + pour un pid, la correction est triviale mais doit être effectuée + dans le code.</p> + + <p>Ces hypothèses posées, à un instant donné, nous pouvons + distinguer tout processus httpd sur toute machine du cluster de tous + les autres processus httpd. Pour ce faire, il suffit d'utiliser + l'adresse IP de la machine et le pid du processus httpd. Ainsi, afin + de générer des identifiants uniques pour chaque requête, il suffit + d'effectuer une distinction en fonction du temps.</p> + + <p>Pour déterminer le temps, nous utiliserons un repère de temps + Unix (les secondes écoulées depuis le 1er janvier 1970 UTC), et un + compteur 16 bits. La précision du repère de temps n'étant que d'une + seconde, le compteur va représenter 65536 valeurs par seconde. Le + quadruplet <em>(adresse IP, pid, repère de temps, compteur)</em> est + en mesure de distinguer 65536 requêtes par seconde par processus + httpd. Il peut cependant arriver que le même pid soit réutilisé au + cours du temps, et le compteur est là pour pallier cet + inconvénient.</p> + + <p>Lorsqu'un processus enfant httpd est créé, le compteur est + initialisé avec (nombre de microsecondes actuel divisé par 10) + modulo 65536 (cette formule a été choisie pour éliminer certains + problème de variance avec les bits de poids faibles du compteur de + microsecondes sur certains systèmes). Lorsqu'un identifiant unique + est généré, le repère de temps utilisé est le moment où la requête + arrive sur le serveur web. Le compteur est incrémenté à chaque + création d'identifiant (et peut repasser à 0 lorsqu'il a atteint sa + valeur maximale).</p> + + <p>Le noyau génère un pid pour chaque processus lors de sa création, + et le compteur de pid est réinitialisé à une certaine valeur + lorsqu'il a atteint sa valeur maximale (les pid sont codés sur 16 + bits sous de nombreux Unixes, mais les systèmes les plus récents les + ont étendus à 32 bits). La même valeur de pid pourra donc être + réutilisée au cours du temps. Cependant, tant qu'elle n'est pas + réutilisée dans la même seconde, elle ne remet pas en cause + l'unicité de notre quadruplet. Nous supposerons donc que le système + ne créera pas plus de 65536 processus en une seconde (ce nombre peut + être de 32768 sous certains Unixes, mais même dans ce cas, on est en + général loin de cette situation).</p> + + <p>Il est possible que le temps se répète pour une raison + quelconque. + Supposons par exemple que l'horloge système soit retardée et repasse + par un temps passé (ou bien, comme elle avançait, elle a été remise + à l'heure, et elle repasse par un temps futur). Dans ce cas, il peut + être facilement démontré que le couple pid/repère de temps peut être + réutilisé. Le choix de la formule d'initialisation du compteur a + été effectué dans l'intention de pallier ce problème. Notez qu'un + nombre vraiment aléatoire serait souhaitable pour initialiser le + compteur, mais il n'existe pas de tel nombre directement lisible sur + la plupart des systèmes (c'est à dire que vous ne pouvez pas + utiliser rand() car vous devez déclencher le générateur avec une + valeur unique, et vous ne pouvez pas utiliser le temps à cet effet + car celui-ci , au moins à la seconde près, s'est répété). Il ne + s'agit donc pas d'une défense parfaite.</p> + + <p>Même si elle n'est pas parfaite, quel est le degré d'efficacité + de cette défense ? Supposons + qu'une de vos machines serve au plus 500 requêtes par seconde (ce + qui constitue une limite supérieure très raisonnable au moment où ce + document est écrit, car les systèmes ne se contentent en général pas + de débiter des fichiers statiques). Pour y parvenir, un certain nombre + de processus enfants sera nécessaire, qui dépendra du nombre de + clients simultanés présents. Mais soyons pessimiste et supposons + qu'un seul processus enfant soit capable de servir 500 requêtes par + secondes. + Il existe 1000 valeurs de démarrage possibles du compteur pour + lesquelles deux séquences de 500 requêtes puissent se recouvrir. Il + y a donc 1,5% de chance que le processus enfant répète une valeur de + compteur si le temps se répète (avec une résolution d'une seconde), + et l'unicité sera alors remise en cause. C'est cependant un exemple + très pessimiste, et avec les valeurs du monde réel, il y a bien + moins de chances que cela ne se produise. Si vous estimez que ceci a + tout de même quelque chances de se produire sur votre système, vous + pouvez migrer vers un compteur à 32 bits (en modifiant le code).</p> + + <p>On pourrait supposer que ceci a plus de chance de se produire + lors du passage à l'heure d'hiver où l'horloge est "retardée". Cela + ne constitue cependant pas un problème car les temps pris en compte + ici sont des temps UTC, qui vont "toujours" de l'avant. Notez que + les Unixes à base de processeur x86 peuvent nécessiter une + configuration particulière pour que ceci soit vrai -- il doivent + être configurés pour assumer que l'horloge système est en UTC et + compenser de manière appropriée. Mais même dans ce cas, si vous + utilisez NTP, votre temps UTC sera correct peu après le + redémarrage.</p> + + <p>La variable d'environnement <code>UNIQUE_ID</code> est construite + par codage du quadruplet de 112 bits (adresse IP sur 32 bits, pid + sur 32 bits, repère de temps sur 32 bits et compteur 16 bits) en + utilisant l'alphabet <code>[A-Za-z0-9@-]</code> d'une manière + similaire à celle du codage MIME base64, et sa valeur se présente + sous la forme d'une chaîne de 19 caractères. L'alphabet MIME base64 + est en fait <code>[A-Za-z0-9+/]</code> ; cependant, les caractères + <code>+</code> et <code>/</code> nécessitent un codage particulier + dans les URLs, ce qui rend leur utilisation peu commode. Toutes les + valeurs sont codées dans l'ordre des octets d'une adresse réseau de + façon à ce + que le codage soit comparable entre des architectures où l'ordre des + octets est différent. L'ordre réel de codage est : repère de temps, + adresse IP, pid, compteur. Cet ordre de codage possède un but + précis, mais il faut souligner que les applications n'ont aucun + intérêt à entrer dans les détails de ce codage. Les applications + doivent se contenter de traiter la variable <code>UNIQUE_ID</code> + comme un symbole opaque, qui peut être comparé avec d'autres + <code>UNIQUE_ID</code>s en ne testant que leur égalité.</p> + + <p>L'ordre a été choisi de façon à ce qu'il soit possible de + modifier le codage dans le futur sans avoir à se préoccuper de + conflits éventuels avec une base de données de + <code>UNIQUE_ID</code>s existante. Les nouveaux codages doivent + conserver le repère de temps comme premier élément, et pour le + reste, utiliser les même alphabet et longueur en bits. Comme les + repères de temps constituent essentiellement un séquence croissante, + il suffit que toutes les machines du cluster arrêtent de servir et + de requérir dans la même <em>seconde repère</em>, et n'utilisent + alors plus l'ancien format de codage. Ensuite, elles peuvent + reprendre le traitement des requêtes en utilisant les nouveaux + codages.</p> + + <p>Nous pensons que ceci apporte une solution relativement portable + au problème. Elle peut être étendue aux systèmes multithreadés comme + Windows NT, et peut évoluer en fonction des besoins futurs. Les + identifiants générés possèdent une durée de vie pratiquement infinie + car les identifiants futurs pourront être allongés selon les + besoins. Pratiquement aucune communication n'est requise entre les + machines du cluster (seule la synchronisation NTP est requise, ce + qui représente une charge très faible), et aucune communication + entre les processus httpd n'est nécessaire (la communication est + implicite et incluse dans le pid assigné par le noyau). Dans des + situations très spécifiques, l'identifiant peut être raccourci, mais + dans ce cas, d'avantage d'informations doivent être admises (par + exemple, les 32 bits de l'adresse IP sont excessifs pour la plupart + des sites, mais il n'existe pas de valeur de remplacement portable + plus courte).</p> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_unique_id.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_unique_id.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_unique_id.xml.fr b/docs/manual/mod/mod_unique_id.xml.fr new file mode 100644 index 0000000000..e9859d5f0f --- /dev/null +++ b/docs/manual/mod/mod_unique_id.xml.fr @@ -0,0 +1,225 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 420990 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_unique_id.xml.meta"> + +<name>mod_unique_id</name> +<description>Fournit une variable d'environnement contenant un +identifiant unique pour chaque requête</description> +<status>Extension</status> +<sourcefile>mod_unique_id.c</sourcefile> +<identifier>unique_id_module</identifier> + +<summary> + + <p>Ce module fournit un identifiant dont l'unicité est garantie + parmi "toutes" les requêtes sous des conditions très précises. + L'identifiant unique le sera aussi parmi plusieurs machines + appartenant à un cluster correctement configuré. L'identifiant est + affecté à la variable d'environnement <code>UNIQUE_ID</code> pour + chaque requête. Les identifiants uniques sont utiles pour diverses + raisons dont la nature se situe au delà de la portée de ce + document.</p> +</summary> + +<section id="theory"> + <title>Théorie</title> + + <p>Tout d'abord un bref rappel de la manière dont le serveur Apache + fonctionne sous Unix (cette fonctionnalité n'étant actuellement pas + supportée sous Windows NT). Sous Unix, Apache crée plusieurs + processus enfants, ces derniers traitant les requêtes une par une. + Chaque processus enfant peut traiter plusieurs requêtes pendant sa + durée de vie. Dans le cadre de cette discussion, nous supposerons + que les différents processus enfants ne s'échangent pas de données + entre eux. Nous nous référerons aux processus enfants sous le nom de + <dfn>processus httpd</dfn>.</p> + + <p>Votre site web est réparti entre une ou plusieurs machines dont + vous êtes l'administrateur, et que nous nommerons cluster de + serveurs. Chaque serveur peut exécuter plusieurs instances d'Apache. + L'ensemble de ces dernières sera considéré comme "l'Univers", et + sous certaines hypothèses, nous montrerons qu'il est possible dans + cet univers, de générer des identifiants uniques pour chaque + requête, sans pour autant nécessiter une communication importante + entre les différents serveurs du cluster.</p> + + <p>Les machines de votre cluster doivent satisfaire ces conditions + (même si le cluster ne comporte qu'une machine, vous devez + synchroniser son horloge avec NTP) :</p> + + <ul> + <li>Les temps des machines sont synchronisés via NTP ou tout autre + protocole de synchronisation du temps en réseau.</li> + + <li>Les nom d'hôtes des machines sont tous différents, de façon à + ce que le module puisse recevoir une adresse IP différente pour + chaque machine du cluster en effectuant une recherche sur le nom + d'hôte.</li> + </ul> + + <p>Au vu des caractéristiques actuelles du système d'exploitation, + nous supposerons que les pids (identifiants processus) sont codés + sur 32 bits. Si le système d'exploitation utilise plus de 32 bits + pour un pid, la correction est triviale mais doit être effectuée + dans le code.</p> + + <p>Ces hypothèses posées, à un instant donné, nous pouvons + distinguer tout processus httpd sur toute machine du cluster de tous + les autres processus httpd. Pour ce faire, il suffit d'utiliser + l'adresse IP de la machine et le pid du processus httpd. Ainsi, afin + de générer des identifiants uniques pour chaque requête, il suffit + d'effectuer une distinction en fonction du temps.</p> + + <p>Pour déterminer le temps, nous utiliserons un repère de temps + Unix (les secondes écoulées depuis le 1er janvier 1970 UTC), et un + compteur 16 bits. La précision du repère de temps n'étant que d'une + seconde, le compteur va représenter 65536 valeurs par seconde. Le + quadruplet <em>(adresse IP, pid, repère de temps, compteur)</em> est + en mesure de distinguer 65536 requêtes par seconde par processus + httpd. Il peut cependant arriver que le même pid soit réutilisé au + cours du temps, et le compteur est là pour pallier cet + inconvénient.</p> + + <p>Lorsqu'un processus enfant httpd est créé, le compteur est + initialisé avec (nombre de microsecondes actuel divisé par 10) + modulo 65536 (cette formule a été choisie pour éliminer certains + problème de variance avec les bits de poids faibles du compteur de + microsecondes sur certains systèmes). Lorsqu'un identifiant unique + est généré, le repère de temps utilisé est le moment où la requête + arrive sur le serveur web. Le compteur est incrémenté à chaque + création d'identifiant (et peut repasser à 0 lorsqu'il a atteint sa + valeur maximale).</p> + + <p>Le noyau génère un pid pour chaque processus lors de sa création, + et le compteur de pid est réinitialisé à une certaine valeur + lorsqu'il a atteint sa valeur maximale (les pid sont codés sur 16 + bits sous de nombreux Unixes, mais les systèmes les plus récents les + ont étendus à 32 bits). La même valeur de pid pourra donc être + réutilisée au cours du temps. Cependant, tant qu'elle n'est pas + réutilisée dans la même seconde, elle ne remet pas en cause + l'unicité de notre quadruplet. Nous supposerons donc que le système + ne créera pas plus de 65536 processus en une seconde (ce nombre peut + être de 32768 sous certains Unixes, mais même dans ce cas, on est en + général loin de cette situation).</p> + + <p>Il est possible que le temps se répète pour une raison + quelconque. + Supposons par exemple que l'horloge système soit retardée et repasse + par un temps passé (ou bien, comme elle avançait, elle a été remise + à l'heure, et elle repasse par un temps futur). Dans ce cas, il peut + être facilement démontré que le couple pid/repère de temps peut être + réutilisé. Le choix de la formule d'initialisation du compteur a + été effectué dans l'intention de pallier ce problème. Notez qu'un + nombre vraiment aléatoire serait souhaitable pour initialiser le + compteur, mais il n'existe pas de tel nombre directement lisible sur + la plupart des systèmes (c'est à dire que vous ne pouvez pas + utiliser rand() car vous devez déclencher le générateur avec une + valeur unique, et vous ne pouvez pas utiliser le temps à cet effet + car celui-ci , au moins à la seconde près, s'est répété). Il ne + s'agit donc pas d'une défense parfaite.</p> + + <p>Même si elle n'est pas parfaite, quel est le degré d'efficacité + de cette défense ? Supposons + qu'une de vos machines serve au plus 500 requêtes par seconde (ce + qui constitue une limite supérieure très raisonnable au moment où ce + document est écrit, car les systèmes ne se contentent en général pas + de débiter des fichiers statiques). Pour y parvenir, un certain nombre + de processus enfants sera nécessaire, qui dépendra du nombre de + clients simultanés présents. Mais soyons pessimiste et supposons + qu'un seul processus enfant soit capable de servir 500 requêtes par + secondes. + Il existe 1000 valeurs de démarrage possibles du compteur pour + lesquelles deux séquences de 500 requêtes puissent se recouvrir. Il + y a donc 1,5% de chance que le processus enfant répète une valeur de + compteur si le temps se répète (avec une résolution d'une seconde), + et l'unicité sera alors remise en cause. C'est cependant un exemple + très pessimiste, et avec les valeurs du monde réel, il y a bien + moins de chances que cela ne se produise. Si vous estimez que ceci a + tout de même quelque chances de se produire sur votre système, vous + pouvez migrer vers un compteur à 32 bits (en modifiant le code).</p> + + <p>On pourrait supposer que ceci a plus de chance de se produire + lors du passage à l'heure d'hiver où l'horloge est "retardée". Cela + ne constitue cependant pas un problème car les temps pris en compte + ici sont des temps UTC, qui vont "toujours" de l'avant. Notez que + les Unixes à base de processeur x86 peuvent nécessiter une + configuration particulière pour que ceci soit vrai -- il doivent + être configurés pour assumer que l'horloge système est en UTC et + compenser de manière appropriée. Mais même dans ce cas, si vous + utilisez NTP, votre temps UTC sera correct peu après le + redémarrage.</p> + + <p>La variable d'environnement <code>UNIQUE_ID</code> est construite + par codage du quadruplet de 112 bits (adresse IP sur 32 bits, pid + sur 32 bits, repère de temps sur 32 bits et compteur 16 bits) en + utilisant l'alphabet <code>[A-Za-z0-9@-]</code> d'une manière + similaire à celle du codage MIME base64, et sa valeur se présente + sous la forme d'une chaîne de 19 caractères. L'alphabet MIME base64 + est en fait <code>[A-Za-z0-9+/]</code> ; cependant, les caractères + <code>+</code> et <code>/</code> nécessitent un codage particulier + dans les URLs, ce qui rend leur utilisation peu commode. Toutes les + valeurs sont codées dans l'ordre des octets d'une adresse réseau de + façon à ce + que le codage soit comparable entre des architectures où l'ordre des + octets est différent. L'ordre réel de codage est : repère de temps, + adresse IP, pid, compteur. Cet ordre de codage possède un but + précis, mais il faut souligner que les applications n'ont aucun + intérêt à entrer dans les détails de ce codage. Les applications + doivent se contenter de traiter la variable <code>UNIQUE_ID</code> + comme un symbole opaque, qui peut être comparé avec d'autres + <code>UNIQUE_ID</code>s en ne testant que leur égalité.</p> + + <p>L'ordre a été choisi de façon à ce qu'il soit possible de + modifier le codage dans le futur sans avoir à se préoccuper de + conflits éventuels avec une base de données de + <code>UNIQUE_ID</code>s existante. Les nouveaux codages doivent + conserver le repère de temps comme premier élément, et pour le + reste, utiliser les même alphabet et longueur en bits. Comme les + repères de temps constituent essentiellement un séquence croissante, + il suffit que toutes les machines du cluster arrêtent de servir et + de requérir dans la même <em>seconde repère</em>, et n'utilisent + alors plus l'ancien format de codage. Ensuite, elles peuvent + reprendre le traitement des requêtes en utilisant les nouveaux + codages.</p> + + <p>Nous pensons que ceci apporte une solution relativement portable + au problème. Elle peut être étendue aux systèmes multithreadés comme + Windows NT, et peut évoluer en fonction des besoins futurs. Les + identifiants générés possèdent une durée de vie pratiquement infinie + car les identifiants futurs pourront être allongés selon les + besoins. Pratiquement aucune communication n'est requise entre les + machines du cluster (seule la synchronisation NTP est requise, ce + qui représente une charge très faible), et aucune communication + entre les processus httpd n'est nécessaire (la communication est + implicite et incluse dans le pid assigné par le noyau). Dans des + situations très spécifiques, l'identifiant peut être raccourci, mais + dans ce cas, d'avantage d'informations doivent être admises (par + exemple, les 32 bits de l'adresse IP sont excessifs pour la plupart + des sites, mais il n'existe pas de valeur de remplacement portable + plus courte).</p> +</section> + + +</modulesynopsis> diff --git a/docs/manual/mod/mod_unique_id.xml.meta b/docs/manual/mod/mod_unique_id.xml.meta index 15f8e9349f..6586539bca 100644 --- a/docs/manual/mod/mod_unique_id.xml.meta +++ b/docs/manual/mod/mod_unique_id.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> </variants> |