]> granicus.if.org Git - apache/commitdiff
A handful of new french doc translations.
authorVincent Deffontaines <gryzor@apache.org>
Sun, 1 Nov 2009 20:13:27 +0000 (20:13 +0000)
committerVincent Deffontaines <gryzor@apache.org>
Sun, 1 Nov 2009 20:13:27 +0000 (20:13 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@831756 13f79535-47bb-0310-9956-ffa450edef68

46 files changed:
docs/manual/mod/allmodules.xml.fr
docs/manual/mod/event.html
docs/manual/mod/event.html.en
docs/manual/mod/event.html.fr [new file with mode: 0644]
docs/manual/mod/event.xml.fr [new file with mode: 0644]
docs/manual/mod/event.xml.meta
docs/manual/mod/index.html
docs/manual/mod/index.html.en
docs/manual/mod/index.html.fr [new file with mode: 0644]
docs/manual/mod/index.xml.fr [new file with mode: 0644]
docs/manual/mod/index.xml.meta
docs/manual/mod/mod_access_compat.html
docs/manual/mod/mod_access_compat.html.en
docs/manual/mod/mod_access_compat.html.fr [new file with mode: 0644]
docs/manual/mod/mod_access_compat.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_access_compat.xml.meta
docs/manual/mod/mod_actions.html
docs/manual/mod/mod_actions.html.en
docs/manual/mod/mod_actions.html.fr [new file with mode: 0644]
docs/manual/mod/mod_actions.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_actions.xml.meta
docs/manual/mod/mod_asis.html
docs/manual/mod/mod_asis.html.en
docs/manual/mod/mod_asis.html.fr [new file with mode: 0644]
docs/manual/mod/mod_asis.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_asis.xml.meta
docs/manual/mod/mod_auth_digest.html
docs/manual/mod/mod_auth_digest.html.en
docs/manual/mod/mod_auth_digest.html.fr [new file with mode: 0644]
docs/manual/mod/mod_auth_digest.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_auth_digest.xml.meta
docs/manual/mod/mod_authn_core.html
docs/manual/mod/mod_authn_core.html.en
docs/manual/mod/mod_authn_core.html.fr [new file with mode: 0644]
docs/manual/mod/mod_authn_core.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_authn_core.xml.meta
docs/manual/mod/mod_headers.html
docs/manual/mod/mod_headers.html.en
docs/manual/mod/mod_headers.html.fr [new file with mode: 0644]
docs/manual/mod/mod_headers.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_headers.xml.meta
docs/manual/mod/mod_unique_id.html
docs/manual/mod/mod_unique_id.html.en
docs/manual/mod/mod_unique_id.html.fr [new file with mode: 0644]
docs/manual/mod/mod_unique_id.xml.fr [new file with mode: 0644]
docs/manual/mod/mod_unique_id.xml.meta

index acab276b6f86363f4216e714cfa40cf48426a962..68a08917ffb094850d94bd559835cc4997312c77 100644 (file)
@@ -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>
   <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>
index 082d1215fab85a6b56443ffb9e450606ac205380..1da582d8f6950f5217b783e25b8c4951ac6e252a 100644 (file)
@@ -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
index 7b09c7e046b97c78acc4b5080bc81e6d63c69578..5cd349a446a507555f3d96e3367222d40a7df978 100644 (file)
@@ -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">&nbsp;en&nbsp;</a></p>
+<p><span>Available Languages: </span><a href="../en/mod/event.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/event.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</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">&nbsp;en&nbsp;</a></p>
+<p><span>Available Languages: </span><a href="../en/mod/event.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/event.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</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 (file)
index 0000000..227cf52
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/event.html" title="Français">&nbsp;fr&nbsp;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/event.html" title="Français">&nbsp;fr&nbsp;</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 (file)
index 0000000..02ed340
--- /dev/null
@@ -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&ccedil;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&ccedil;u
+    pour permettre le traitement d'un nombre accru de requ&ecirc;tes
+    simultan&eacute;es en d&eacute;l&eacute;guant certaines t&acirc;ches &agrave; des threads de support,
+    lib&eacute;rant par l&agrave;-m&ecirc;me le thread principal et lui permettant de
+    traiter les nouvelles requ&ecirc;tes. Il s'inspire du MPM
+    <module>worker</module> qui impl&eacute;mente un serveur hybride
+    multi-processus/multi-threads. Les directives de configuration &agrave;
+    l'ex&eacute;cution sont identiques &agrave; 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&eacute;soudre le 'probl&egrave;me keep alive' de HTTP.
+    Lorsqu'un client a soumis une premi&egrave;re requ&ecirc;te, il peut garder la
+    connexion ouverte, et envoyer les requ&ecirc;tes suivantes en utilisant le
+    m&ecirc;me socket. Ceci permet de r&eacute;duire de mani&egrave;re significative la
+    surcharge due &agrave; la cr&eacute;ation de connexions TCP. Cependant, Apache
+    mobilise en principe &agrave; cet effet un processus/thread enfant en
+    attente des donn&eacute;es du client, ce qui am&egrave;ne son propre lot
+    d'inconv&eacute;nients. Pour r&eacute;soudre ce probl&egrave;me, <module>event</module>
+    utilise un thread d&eacute;di&eacute; qui g&egrave;re non seulement les sockets en
+    &eacute;coute, mais aussi tous les sockets en &eacute;tat Keep Alive.</p>
+
+    <p>Le MPM pr&eacute;suppose que l'impl&eacute;mentation <code>apr_pollset</code>
+    sous-jacente est raisonnablement s&ucirc;re du point de vue des threads.
+    Ceci permet au MPM d'&eacute;viter un verrouillage de haut niveau excessif,
+    ou de devoir activer le thread en &eacute;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&eacute;requis</title>
+    <p>Ce MPM d&eacute;pend des op&eacute;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 &agrave; APR
+    d'impl&eacute;menter les op&eacute;rations atomiques en utilisant des instructions
+    performantes indisponibles avec les processeurs plus
+    anciens.</p>
+
+    <p>Ce MPM ne fonctionne pas de mani&egrave;re optimale sur les
+    plates-formes plus anciennes qui ne g&egrave;rent pas correctement les
+    threads, mais ce probl&egrave;me est sans objet du fait du pr&eacute;requis
+    concernant EPoll ou KQueue.</p>
+
+    <ul>
+
+      <li>Pour utiliser ce MPM sous FreeBSD, la version 5.3 ou
+      sup&eacute;rieure de ce syst&egrave;me est recommand&eacute;e. Il est cependant
+      possible d'ex&eacute;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&eacute;rieure.</li>
+
+      <li>Pour Linux, un noyau 2.6 est recommand&eacute;. Il faut aussi
+      s'assurer que votre version de <code>glibc</code> a &eacute;t&eacute; compil&eacute;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>
index 8ce2575e0a0768b22cc41c0423636451312b70ee..80214bc52fc220bb7b17d5926d094368d400ac01 100644 (file)
@@ -8,5 +8,6 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
   </variants>
 </metafile>
index a7474c15b6aaf70b08dc0dde3b187b772fadc3a5..470a4782fa537d5b08c9cfda56aade3bc89daffe 100644 (file)
@@ -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
index 809a0482406c25f7593821aab1e32092aa269c02..3ee60627e58f82db765e9a0cb83b1712dda7e940 100644 (file)
@@ -21,6 +21,7 @@
 <p><span>Available Languages: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
 <a href="../en/mod/" title="English">&nbsp;en&nbsp;</a> |
 <a href="../es/mod/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="../fr/mod/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
@@ -214,6 +215,7 @@ hosting</dd>
 <p><span>Available Languages: </span><a href="../de/mod/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
 <a href="../en/mod/" title="English">&nbsp;en&nbsp;</a> |
 <a href="../es/mod/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="../fr/mod/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
diff --git a/docs/manual/mod/index.html.fr b/docs/manual/mod/index.html.fr
new file mode 100644 (file)
index 0000000..13732bf
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <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">&nbsp;de&nbsp;</a> |
+<a href="../en/mod/" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../es/mod/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="../fr/mod/" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</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">&nbsp;A&nbsp;</a> | <a href="#B">&nbsp;B&nbsp;</a> | <a href="#C">&nbsp;C&nbsp;</a> | <a href="#D">&nbsp;D&nbsp;</a> | <a href="#E">&nbsp;E&nbsp;</a> | <a href="#F">&nbsp;F&nbsp;</a> | <a href="#H">&nbsp;H&nbsp;</a> | <a href="#I">&nbsp;I&nbsp;</a> | <a href="#L">&nbsp;L&nbsp;</a> | <a href="#M">&nbsp;M&nbsp;</a> | <a href="#N">&nbsp;N&nbsp;</a> | <a href="#P">&nbsp;P&nbsp;</a> | <a href="#R">&nbsp;R&nbsp;</a> | <a href="#S">&nbsp;S&nbsp;</a> | <a href="#U">&nbsp;U&nbsp;</a> | <a href="#V">&nbsp;V&nbsp;</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">&nbsp;de&nbsp;</a> |
+<a href="../en/mod/" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../es/mod/" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="../fr/mod/" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../tr/mod/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</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 (file)
index 0000000..380602b
--- /dev/null
@@ -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&eacute;tique compl&egrave;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&eacute;f&eacute;rence rapide des directives</a>
+  </seealso>
+</moduleindex>
index 0a1cc90508a6522ca3a32782c5c2f38fb6335d49..ed63d9adc0421357bd8c9a291a7664afabcd9956 100644 (file)
@@ -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>
index 778b002afeacade8b7b3998de004fb22613c2c9a..d142e4db748a358ebdec3175bb7a597095bdadc3 100644 (file)
@@ -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
index a91adab23fa7c9666d32f6639422bbf68b269582..ff6612145fafbdb4e11f748a0d446633d417eb51 100644 (file)
@@ -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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_access_compat.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_access_compat.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</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 (file)
index 0000000..719d598
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_access_compat.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</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">&lt;Directory&gt;</a></code>,
+    <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code> et
+    <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</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">&lt;Limit&gt;</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 />
+      &lt;Directory /docroot&gt;<br />
+      <span class="indent">
+        Order Deny,Allow<br />
+        Deny from all<br />
+        Allow from env=laissez_moi_entrer<br />
+      </span>
+      &lt;/Directory&gt;
+    </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 &amp; 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>
+      &lt;Directory /www&gt;<br />
+      <span class="indent">
+        Order Allow,Deny<br />
+      </span>
+      &lt;/Directory&gt;
+    </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">&lt;Location&gt;</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">&lt;Directory&gt;</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">&lt;Limit&gt;</a></code> et <code class="directive"><a href="../mod/core.html#limitexcept">&lt;LimitExcept&gt;</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>
+      &lt;Directory /var/www/private&gt;<br />
+        Require valid-user<br />
+      &lt;/Directory&gt;<br />
+      <br />
+      &lt;Directory /var/www/private/public&gt;<br />
+        Allow from all<br />
+        Satisfy Any<br />
+      &lt;/Directory&gt;
+    </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">&lt;Limit&gt;</a></code> et <code class="directive"><a href="../mod/core.html#limitexcept">&lt;LimitExcept&gt;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_access_compat.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</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 (file)
index 0000000..aa0543d
--- /dev/null
@@ -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 &agrave; base de nom d'h&ocirc;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 &agrave; des fins de compatibilit&eacute;
+avec les pr&eacute;c&eacute;dentes versions d'Apache 2.x. Les directives fournies par
+ce module sont devenues obsol&egrave;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&ocirc;ler l'acc&egrave;s &agrave; certaines parties du serveur. On peut
+    contr&ocirc;ler cet acc&egrave;s en fonction du nom d'h&ocirc;te du client, de son
+    adresse IP ou d'autres caract&eacute;ristiques de la requ&ecirc;te, telles
+    qu'elles sont enregistr&eacute;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&eacute;cifier
+    quels clients sont ou ne sont pas autoris&eacute;s &agrave; acc&eacute;der au serveur,
+    alors que la directive <directive
+    module="mod_access_compat">Order</directive> d&eacute;finit le statut
+    d'acc&egrave;s par d&eacute;faut, et d&eacute;termine la mani&egrave;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&egrave;s &agrave; base de nom d'h&ocirc;te et
+    l'authentification &agrave; base de mot de passe peuvent &ecirc;tre impl&eacute;ment&eacute;es
+    simultan&eacute;ment. Dans ce cas, on utilise la directive <directive
+    module="mod_access_compat">Satisfy</directive> pour d&eacute;terminer la
+    mani&egrave;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&egrave;tes depuis
+      la refonte d'authz. Voir <module>mod_authz_host</module>.</p>
+    </note>
+
+    <p>En g&eacute;n&eacute;ral, les directives de restriction d'acc&egrave;s s'appliquent &agrave;
+    toutes les m&eacute;thodes d'acc&egrave;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&eacute;thodes, alors que les autres m&eacute;thodes ne se verront
+    impos&eacute;e aucune restriction, en regroupant les directives &agrave;
+    l'int&eacute;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&eacute;cifie quels h&ocirc;tes peuvent acc&eacute;der &agrave; une certaine zone du
+serveur</description>
+<syntax> Allow from all|<var>h&ocirc;te</var>|env=[!]<var>variable
+d'environnement</var>
+[<var>h&ocirc;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&eacute;finir quels
+    h&ocirc;tes ont le droit d'acc&eacute;der &agrave; une certaine partie du serveur. On
+    peut contr&ocirc;ler l'acc&egrave;s par nom d'h&ocirc;te, adresse IP, intervalle
+    d'adresses IP, ou toute autre caract&eacute;ristique de la requ&ecirc;te client
+    enregistr&eacute;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&eacute;rentes. Si <code>Allow from all</code> est sp&eacute;cifi&eacute;,
+    tout h&ocirc;te se voit accord&eacute; l'acc&egrave;s, en tenant compte des directives
+    <directive module="mod_access_compat">Deny</directive> et <directive
+    module="mod_access_compat">Order</directive> comme d&eacute;crit plus loin.
+    Pour ne permettre l'acc&egrave;s au serveur qu'&agrave; un h&ocirc;te ou un groupe
+    d'h&ocirc;tes particuliers, on peut sp&eacute;cifier un <em>nom d'h&ocirc;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&ocirc;tes dont les noms correspondent ou se terminent par la
+      cha&icirc;ne sp&eacute;cifi&eacute;e ont l'autorisation d'acc&egrave;s. Seules les
+      composantes enti&egrave;res du nom d'h&ocirc;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&eacute;finition de la directive <directive
+      module="core">HostnameLookups</directive>. Tout d'abord, une
+      recherche DNS inverse sur l'adresse IP est effectu&eacute;e pour
+      d&eacute;terminer le nom d'h&ocirc;te associ&eacute;, puis une recherche directe sur
+      le nom d'h&ocirc;te est effectu&eacute;e afin de s'assurer qu'il correspond
+      bien &agrave; l'adresse IP originale. L'acc&egrave;s ne sera accord&eacute; que si le
+      nom d'h&ocirc;te correspond et si les recherches DNS inverse et directe
+      concordent.</p></dd>
+
+      <dt>Une adresse IP compl&egrave;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&ocirc;te auquel on a accord&eacute; l'acc&egrave;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 &agrave; trois des premiers octets d'une adresse IP, afin de
+      restreindre l'acc&egrave;s &agrave; un sous-r&eacute;seau.</p></dd>
+
+      <dt>Une paire r&eacute;seau/masque de sous-r&eacute;seau</dt>
+
+      <dd>
+      <example><title>Exemple :</title>
+        Allow from 10.1.0.0/255.255.0.0
+      </example>
+      <p>Un r&eacute;seau a.b.c.d, et un masque de sous-r&eacute;seau w.x.y.z, pour
+      une d&eacute;finition plus pr&eacute;cise de la restriction d'acc&egrave;s impos&eacute;e &agrave; un
+      sous-r&eacute;seau.</p></dd>
+
+      <dt>Une sp&eacute;cification CIDR r&eacute;seau/nnn</dt>
+
+      <dd>
+      <example><title>Exemple :</title>
+        Allow from 10.1.0.0/16
+      </example>
+      <p>Identique au cas pr&eacute;c&eacute;dent, mis &agrave; part que le masque est
+      constitu&eacute; des nnn bits de poids fort.</p></dd>
+    </dl>
+
+    <p>Notez que les trois derniers exemples d&eacute;signent le m&ecirc;me ensemble
+    d'h&ocirc;tes.</p>
+
+    <p>On peut sp&eacute;cifier des adresses et sous-r&eacute;seaux IPv6 de la mani&egrave;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&egrave;me format d'argument de la directive
+    <directive>Allow</directive> permet de contr&ocirc;ler l'acc&egrave;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&eacute;cifi&eacute;, la
+    requ&ecirc;te est autoris&eacute;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&eacute;cifi&eacute;, la
+    requ&ecirc;te est autoris&eacute;e si la variable d'environnement <var>variable
+    d'environnement</var> n'existe pas. Le serveur permet de d&eacute;finir
+    avec souplesse des variables d'environnement en se basant sur les
+    caract&eacute;ristiques de la requ&ecirc;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&egrave;s en fonction de param&egrave;tres comme le <code>User-Agent</code>
+    (type de navigateur) des clients, le <code>Referer</code>, ou
+    d'autres champs d'en-t&ecirc;te de la requ&ecirc;te HTTP.</p>
+
+    <example><title>Exemple :</title>
+      SetEnvIf User-Agent ^KnockKnock/2\.0 laissez_moi_entrer<br />
+      &lt;Directory /docroot&gt;<br />
+      <indent>
+        Order Deny,Allow<br />
+        Deny from all<br />
+        Allow from env=laissez_moi_entrer<br />
+      </indent>
+      &lt;/Directory&gt;
+    </example>
+
+    <p>Dans cet exemple, les navigateurs dont la cha&icirc;ne user-agent
+    commence par <code>KnockKnock/2.0</code> se verront accorder
+    l'acc&egrave;s, alors que tous les autres seront rejet&eacute;s.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>Deny</name>
+<description>D&eacute;finit quels h&ocirc;tes ne sont pas autoris&eacute;s &agrave; acc&eacute;der au
+serveur</description>
+<syntax> Deny from all|<var>h&ocirc;te</var>|env=[!]<var>variable
+d'environnement</var>
+[<var>h&ocirc;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&egrave;s au serveur en
+    fonction du nom d'h&ocirc;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&eacute;finit le statut d'acc&egrave;s par d&eacute;faut et l'ordre dans lequel
+les directives <directive>Allow</directive> et
+<directive>Deny</directive> sont &eacute;valu&eacute;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&eacute;e aux
+    directives <directive module="mod_access_compat">Allow</directive>
+    et <directive module="mod_access_compat">Deny</directive>,
+    impl&eacute;mente un syst&egrave;me de contr&ocirc;le d'acc&egrave;s en trois passes. Au cours
+    de la premi&egrave;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&eacute;es, selon
+    la d&eacute;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&eacute; au cours de la seconde passe. La troisi&egrave;me passe s'applique &agrave;
+    toutes les requ&ecirc;tes qui ne sont concern&eacute;es par aucune des deux
+    premi&egrave;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&eacute;es, &agrave; la
+    diff&eacute;rence d'un pare-feu classique o&ugrave; seule la premi&egrave;re r&egrave;gle qui
+    correspond est utilis&eacute;e. La derni&egrave;re directive qui correspond
+    s'applique ( &agrave; la diff&eacute;rence l&agrave; 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&eacute;r&eacute;es comme
+    un groupe, toutes les lignes <directive
+    module="mod_access_compat">Deny</directive> comme un autre, et le
+    statut par d&eacute;faut a son existence propre.</p>
+
+    <p><em>Ordre</em> peut &ecirc;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 &eacute;valu&eacute;es ; au
+      moins une d'entre elles doit correspondre, sinon la requ&ecirc;te est
+      rejet&eacute;e. Ensuite, toutes les directives <directive
+      module="mod_access_compat">Deny</directive> sont &eacute;valu&eacute;es. Si au
+      moins l'une d'entre elles correspond, la requ&ecirc;te est rejet&eacute;e.
+      Enfin, toute requ&ecirc;te qui ne correspond &agrave; aucune directive
+      <directive module="mod_access_compat">Allow</directive> ou
+      <directive module="mod_access_compat">Deny</directive> est rejet&eacute;e
+      par d&eacute;faut.</dd>
+
+      <dt><code>Deny,Allow</code></dt>
+
+      <dd>Dans un premier temps, toutes les directives <directive
+      module="mod_access_compat">Deny</directive> sont &eacute;valu&eacute;es ; Si au
+      moins une d'entre elles correspond, la requ&ecirc;te est rejet&eacute;e,
+      <strong>&agrave; moins</strong> qu'elle corresponde aussi &agrave; une directive
+      <directive module="mod_access_compat">Allow</directive>. Toute
+      requ&ecirc;te qui ne correspond &agrave; aucune directive <directive
+      module="mod_access_compat">Allow</directive> ou <directive
+      module="mod_access_compat">Deny</directive> est autoris&eacute;e.</dd>
+
+      <dt><code>Mutual-failure</code></dt>
+
+      <dd>Cet argument a le m&ecirc;me effet que <code>Allow,Deny</code> et
+      est devenu de ce fait obsol&egrave;te.</dd>
+    </dl>
+
+    <p>Les mots-cl&eacute;s ne peuvent &ecirc;tre s&eacute;par&eacute;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&eacute;sultat Allow,Deny</th>
+        <th>R&eacute;sultat Deny,Allow</th>
+      </tr><tr>
+        <th>Correspond &agrave; Allow seulement</th>
+        <td>Requ&ecirc;te autoris&eacute;e</td>
+        <td>Requ&ecirc;te autoris&eacute;e</td>
+      </tr><tr>
+        <th>Correspond &agrave; Deny seulement</th>
+        <td>Requ&ecirc;te rejet&eacute;e</td>
+        <td>Requ&ecirc;te rejet&eacute;e</td>
+      </tr><tr>
+        <th>Aucune correspondance</th>
+        <td>Par d&eacute;faut la seconde directive : rejet</td>
+        <td>Par d&eacute;faut la seconde directive : autorisation</td>
+      </tr><tr>
+        <th>Correspond &agrave; Allow &amp; Deny</th>
+        <td>La derni&egrave;re correspondance l'emporte : rejet</td>
+        <td>La derni&egrave;re correspondance l'emporte : autorisation</td>
+      </tr>
+    </table>
+
+    <p>Dans cet exemple, tous les h&ocirc;tes du domaine apache.org ont
+    l'autorisation d'acc&egrave;s ; tous les autres voient leur acc&egrave;s
+    refus&eacute;.</p>
+
+    <example>
+      Order Deny,Allow<br />
+      Deny from all<br />
+      Allow from apache.org
+    </example>
+
+    <p>Dans l'exemple suivant, tous les h&ocirc;tes du domaine apache.org ont
+    l'autorisation d'acc&egrave;s, sauf ceux du sous-domaine foo.apache.org qui
+    voient leur acc&egrave;s refus&eacute;. Tous les h&ocirc;tes qui ne sont pas dans le
+    domaine apache.org sont rejet&eacute;s car le statut par d&eacute;faut est positionn&eacute;
+    sur <directive
+    module="mod_access_compat">Deny</directive>, et consiste donc en un
+    refus d'acc&egrave;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&eacute;c&eacute;dent, est
+    <code>Deny,Allow</code>, tout le monde a l'autorisation d'acc&egrave;s.
+    Ceci est d&ucirc; au fait que <code>Allow from apache.org</code> sera
+    &eacute;valu&eacute; en dernier, sans tenir compte de l'ordre r&eacute;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&ocirc;te qui
+    n'est pas dans le domaine <code>apache.org</code> aura aussi
+    l'autorisation d'acc&egrave;s car le statut par d&eacute;faut est positionn&eacute; sur
+    <directive
+    module="mod_access_compat">Allow</directive> et constitue donc une
+    autorisation d'acc&egrave;s.</p>
+
+    <p>La pr&eacute;sence d'une directive <directive>Order</directive> peut
+    affecter le contr&ocirc;le d'acc&egrave;s &agrave; une partie du serveur m&ecirc;me en
+    l'abscence de directives <directive
+    module="mod_access_compat">Allow</directive> et <directive
+    module="mod_access_compat">Deny</directive> associ&eacute;es, &agrave; cause de
+    son influence sur le statut par d&eacute;faut. Par exemple,</p>
+
+    <example>
+      &lt;Directory /www&gt;<br />
+      <indent>
+        Order Allow,Deny<br />
+      </indent>
+      &lt;/Directory&gt;
+    </example>
+
+    <p>va interdire tout acc&egrave;s au r&eacute;pertoire <code>/www</code> &agrave; cause
+    du statut d'acc&egrave;s par d&eacute;faut qui est d&eacute;fini &agrave; <directive
+    module="mod_access_compat">Deny</directive>.</p>
+
+    <p>La directive <directive>Order</directive> ne contr&ocirc;le l'ordre
+    dans lequel sont trait&eacute;es les directives d'acc&egrave;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&eacute;e dans une section
+    <directive module="core" type="section">Location</directive> sera
+    toujours &eacute;valu&eacute;e apr&egrave;s une directive <directive
+    module="mod_access_compat">Allow</directive> ou <directive
+    module="mod_access_compat">Deny</directive> situ&eacute;e dans une section
+    <directive module="core" type="section">Directory</directive> ou un
+    fichier <code>.htaccess</code>, sans tenir compte de la
+    d&eacute;finition de la directive <directive>Order</directive>. Pour plus
+    de d&eacute;tails &agrave; 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&ocirc;le d'acc&egrave;s en fonction de l'h&ocirc;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&eacute; par <directive module="core" type="section"
+>Limit</directive> et <directive module="core"
+type="section">LimitExcept</directive> &agrave; partir de la version
+2.0.51</compatibility>
+<usage>
+    <p>Politique d'acc&egrave;s dans le cas o&ugrave; on utilise &agrave; 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&egrave;s &agrave; une zone particuli&egrave;re du
+    serveur est restreinte par utilisateur/mot de passe et en fonction
+    de l'adresse IP de l'h&ocirc;te client. Dans ce cas, par
+    d&eacute;faut (<code>All</code>), le client doit satisfaire &agrave; 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&egrave;s s'il satisfait &agrave; la restriction
+    d'adresse ou fournit un couple utilisateur/mot de passe valide. On
+    peut utiliser cette derni&egrave;re d&eacute;finition pour restreindre l'acc&egrave;s &agrave;
+    une zone par mot de passe, mais accorder l'acc&egrave;s aux clients
+    poss&eacute;dant certaines adresses IP sans qu'ils aient &agrave; fournir de mot
+    de passe.</p>
+
+    <p>Par exemple, si vous souhaitez que les utilisateurs de votre
+    r&eacute;seau acc&egrave;dent &agrave; une zone de votre site web sans restriction, mais
+    que l'acc&egrave;s &agrave; cette zone n&eacute;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&eacute;quente de la directive
+    <directive>Satisfy</directive> est l'all&egrave;gement des restrictions
+    d'acc&egrave;s &agrave; un sous-r&eacute;pertoire par rapport aux restrictions d'acc&egrave;s au
+    r&eacute;pertoire parent :
+    </p>
+
+    <example>
+      &lt;Directory /var/www/private&gt;<br />
+        Require valid-user<br />
+      &lt;/Directory&gt;<br />
+      <br />
+      &lt;Directory /var/www/private/public&gt;<br />
+        Allow from all<br />
+        Satisfy Any<br />
+      &lt;/Directory&gt;
+    </example>
+
+    <p>Dans l'exemple ci-dessus, l'acc&egrave;s au r&eacute;pertoire
+    <code>/var/www/private</code> n&eacute;cessitera une authentification,
+    alors que l'acc&egrave;s au r&eacute;pertoire <code>/var/www/private/public</code>
+    sera accord&eacute; sans restriction.</p>
+
+
+    <p>Depuis la version 2.0.51, les directives
+    <directive>Satisfy</directive> peuvent &ecirc;tre restreintes &agrave; certaines
+    m&eacute;thodes particuli&egrave;res &agrave; 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>
index 2902018c3e88008f8b04b7ba8687a33247e67b85..29b25ab3e0df28f8bf8577482251d0429683b12b 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
   </variants>
 </metafile>
index 05ae104922fc2451c00b69f8e0e52bc1b37acf19..65b9912fa940e14f438413a2bebc2f632fbac56e 100644 (file)
@@ -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
index 807997d7eeb97d72ef82e30f2bfd90063fc11f50..815d9fb82f9ae76f78d2baa4d2a339fd88923b10 100644 (file)
@@ -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">&nbsp;de&nbsp;</a> |
 <a href="../en/mod/mod_actions.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_actions.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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">&nbsp;de&nbsp;</a> |
 <a href="../en/mod/mod_actions.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_actions.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..5f69388
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;de&nbsp;</a> |
+<a href="../en/mod/mod_actions.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_actions.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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>
+      &lt;Location /news&gt;<br />
+      <span class="indent">
+        SetHandler news-handler<br />
+        Action news-handler /cgi-bin/news.cgi virtual<br />
+      </span>
+      &lt;/Location&gt;
+    </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 &lt;ISINDEX&gt;<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">&nbsp;de&nbsp;</a> |
+<a href="../en/mod/mod_actions.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_actions.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_actions.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_actions.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..12a2f82
--- /dev/null
@@ -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&eacute;cution des scripts CGI en fonction du
+type de m&eacute;dia ou de la m&eacute;thode de requ&ecirc;te.</description>
+
+<status>Base</status>
+<sourcefile>mod_actions.c</sourcefile>
+<identifier>actions_module</identifier>
+
+<summary>
+    <p>Ce module poss&egrave;de deux directives. La directive <directive
+    module="mod_actions">Action</directive> vous permet de lancer
+    l'ex&eacute;cution de scripts CGI chaque fois qu'un fichier poss&eacute;dant un
+    certain <glossary ref="mime-type">type de contenu MIME</glossary>
+    fait l'objet d'une requ&ecirc;te. La directive <directive
+    module="mod_actions">Script</directive> vous permet de lancer
+    l'ex&eacute;cution de scripts CGI chaque fois que la requ&ecirc;te utilise une
+    m&eacute;thode particuli&egrave;re. Ceci facilite grandement l'ex&eacute;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 &eacute;t&eacute; 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&eacute;clench&eacute; par la
+    requ&ecirc;te. <var>script cgi</var> est un chemin URL vers une ressource
+    qui a &eacute;t&eacute; d&eacute;sign&eacute;e comme script CGI &agrave; l'aide des directives
+    <directive module="mod_alias">ScriptAlias</directive> ou <directive
+    module="mod_mime">AddHandler</directive>. <var>type d'action</var>
+    peut &ecirc;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&eacute;s en utilisant
+    les variables d'environnement CGI standards <code>PATH_INFO</code>
+    et <code>PATH_TRANSLATED</code>. Le gestionnaire utilis&eacute; pour cette
+    requ&ecirc;te particuli&egrave;re est transmis &agrave; l'aide de la variable
+    <code>REDIRECT_HANDLER</code>.</p>
+
+    <example><title>Exemples</title>
+      # Requ&ecirc;tes concernant des fichiers poss&eacute;dant un type de contenu
+      # MIME particulier :<br />
+      Action image/gif /cgi-bin/images.cgi<br />
+      <br />
+      # Fichiers poss&eacute;dant une extension particuli&egrave;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&ecirc;tes pour des fichiers poss&eacute;dant
+    le type de contenu MIME <code>image/gif</code> seront trait&eacute;es par
+    le script CGI <code>/cgi-bin/images.cgi</code>.</p>
+
+    <p>Dans le second exemple, les requ&ecirc;tes pour des fichiers poss&eacute;dant
+    l'extension <code>.xyz</code> seront trait&eacute;es par
+    le script CGI <code>/cgi-bin/programme.cgi</code>.</p>
+
+    <p>Le modificateur optionnel <code>virtual</code> permet de
+    d&eacute;sactiver la v&eacute;rification de l'existence du fichier demand&eacute;. Ceci
+    peut s'av&eacute;rer utile, par exemple, si vous voulez utiliser la
+    directive <directive>Action</directive> pour des localisations
+    virtuelles.</p>
+
+    <example><title>Exemple</title>
+      &lt;Location /news&gt;<br />
+      <indent>
+        SetHandler news-handler<br />
+        Action news-handler /cgi-bin/news.cgi virtual<br />
+      </indent>
+      &lt;/Location&gt;
+    </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&eacute;thode de requ&ecirc;te
+particuli&egrave;re.</description>
+<syntax>Script <var>m&eacute;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&eacute; en utilisant la m&eacute;thode
+    <var>m&eacute;thode</var>. <var>script cgi</var> est le chemin URL d'une
+    ressource qui a &eacute;t&eacute; d&eacute;sign&eacute;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&eacute; sont envoy&eacute;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&eacute;thode peuvent &ecirc;tre utilis&eacute;s. <strong>Les noms
+      de m&eacute;thode sont sensibles &agrave; la casse</strong>, si bien que
+      <code>Script PUT</code> et <code>Script put</code> ont des effets
+      totalement diff&eacute;rents.
+    </note>
+
+    <p>Notez que la commande <directive>Script</directive> ne d&eacute;finit
+    que des actions par d&eacute;faut. Si un script CGI est appel&eacute;, ou toute
+    autre ressource capable de g&eacute;rer la m&eacute;thode de la requ&ecirc;te en
+    interne, il agira en cons&eacute;quence. Notez aussi que
+    <directive>Script</directive> avec une m&eacute;thode <code>GET</code> ne
+    sera appel&eacute; que si la requ&ecirc;te poss&egrave;de des arguments (par exemple
+    foo.html?hi). Dans le cas contraire, la requ&ecirc;te sera trait&eacute;e
+    normalement.</p>
+
+    <example><title>Exemples</title>
+      # Pour une recherche du style &lt;ISINDEX&gt;<br />
+      Script GET /cgi-bin/search<br />
+      <br />
+      # Un gestionnaire CGI pour la m&eacute;thode PUT<br />
+      Script PUT /~bob/put.cgi<br />
+    </example>
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
index 8bb55d01fe465602264609947aeffcd1c1c2038a..591ef61bb9eb630363dc5e013e8b80ba0b8e6968 100644 (file)
@@ -9,6 +9,7 @@
   <variants>
     <variant>de</variant>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant>ja</variant>
     <variant outdated="yes">ko</variant>
   </variants>
index f2f687b0ca205b2ad35a3d4479e0e7d70c00a9d0..95bb91308ccb6340a0ffa08b1fb2c64b153914e8 100644 (file)
@@ -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
index 255dd4ac60c0ad75dbdc5c85a6efa18466361cea..1350baaede5a6830ed9ef14f21583e1458acc082 100644 (file)
@@ -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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_asis.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_asis.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..8cd3f89
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_asis.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 />
+      &lt;html&gt;<br />
+      &lt;head&gt;<br />
+      &lt;title&gt;Mauvaises excuses&lt;/title&gt;<br />
+      &lt;/head&gt;<br />
+      &lt;body&gt;<br />
+      &lt;h1&gt;La merveilleuse page de Fred a été déplacée vers<br />
+      &lt;a href="http://xyz.abc.com/foo/bar.html"&gt;le site de
+      Joe&lt;/a&gt;.<br />
+      &lt;/h1&gt;<br />
+      &lt;/body&gt;<br />
+      &lt;/html&gt;
+    </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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_asis.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_asis.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_asis.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..a216d56
--- /dev/null
@@ -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&ecirc;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 &agrave; Apache d'envoyer le document sans ajouter la plupart des
+    en-t&ecirc;tes HTTP habituels.</p>
+
+    <p>On peut l'utiliser pour envoyer tous types de donn&eacute;es en
+    provenance du serveur, y compris les redirections et autres r&eacute;ponses
+    HTTP sp&eacute;ciales, sans devoir faire appel &agrave; 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&eacute;dant l'extension
+    <code>.asis</code> sera envoy&eacute; par Apache au client pratiquement tel
+    quel. En particulier, les en-t&ecirc;tes HTTP seront d&eacute;duits du fichier
+    lui-m&ecirc;me selon les r&egrave;gles du module <module>mod_cgi</module>, si
+    bien qu'un fichier asis doit inclure des en-t&ecirc;tes valides, et
+    utiliser l'en-t&ecirc;te CGI Status: pour d&eacute;terminer le code de r&eacute;ponse
+    HTTP.</p>
+
+    <p>Voici un exemple de fichier dont le contenu est envoy&eacute; <em>tel
+    quel</em> pour informer un client qu'un fichier a &eacute;t&eacute; d&eacute;plac&eacute;.</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 />
+      &lt;html&gt;<br />
+      &lt;head&gt;<br />
+      &lt;title&gt;Mauvaises excuses&lt;/title&gt;<br />
+      &lt;/head&gt;<br />
+      &lt;body&gt;<br />
+      &lt;h1&gt;La merveilleuse page de Fred a &eacute;t&eacute; d&eacute;plac&eacute;e vers<br />
+      &lt;a href="http://xyz.abc.com/foo/bar.html"&gt;le site de
+      Joe&lt;/a&gt;.<br />
+      &lt;/h1&gt;<br />
+      &lt;/body&gt;<br />
+      &lt;/html&gt;
+    </example>
+
+    <note><title>Notes :</title>
+    <p>Le serveur ajoute syst&eacute;matiquement les en-t&ecirc;tes
+    <code>Date:</code> et <code>Server:</code> aux donn&eacute;es qu'il envoie
+    au client, si bien qu'ils n'ont pas besoin d'&ecirc;tre inclus dans le
+    fichier. Le serveur n'ajoute <em>pas</em> d'en-t&ecirc;te
+    <code>Last-Modified</code>, ce qu'il devrait probablement faire.</p>
+    </note>
+</section>
+
+</modulesynopsis>
index 638e62064d00606ec94dab73ae9eccc80de9ea5e..39214a9356a12d2c5d6f1b731a3fe3b5d48e388a 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant>ja</variant>
     <variant outdated="yes">ko</variant>
   </variants>
index eeb065dd7b738e8ac588b85ddaed47e732d72790..1836f36027a673d6305977b06f7e988216c2769f 100644 (file)
@@ -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
index 6494ba910e6a567c3f85e56183ecf9f13f6b25a3..ae383d70220535bf4b47701d846e2357c8384972 100644 (file)
@@ -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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_auth_digest.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_auth_digest.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..b3ad43c
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_auth_digest.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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>
+      &lt;Location /private/&gt;<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>
+      &lt;/Location&gt;
+    </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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_auth_digest.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/mod/mod_auth_digest.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..f9221dd
--- /dev/null
@@ -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&eacute;s
+MD5</description>
+<status>Extension</status>
+<sourcefile>mod_auth_digest.c</sourcefile>
+<identifier>auth_digest_module</identifier>
+
+<summary>
+    <p>Ce module impl&eacute;mente l'authentification HTTP bas&eacute;e sur les
+    condens&eacute;s MD5 (<a
+    href="http://www.faqs.org/rfcs/rfc2617.html">RFC2617</a>), et
+    fournit une alternative &agrave; <module>mod_auth_basic</module> plus
+    s&eacute;curis&eacute;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 &agrave; base de
+condens&eacute;s</title>
+
+    <p>Pour utiliser l'authentification &agrave; base de condens&eacute;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 &agrave; prot&eacute;ger.</p>
+
+    <p>On peut cr&eacute;er les fichiers utilisateur appropri&eacute;s (au format
+    texte) &agrave; l'aide de l'outil <program>htdigest</program>.</p>
+
+    <example><title>Exemple :</title>
+      &lt;Location /private/&gt;<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>
+      &lt;/Location&gt;
+    </example>
+
+    <note><title>Note</title>
+    <p>L'authentification &agrave; base de condens&eacute;s MD5 est plus s&eacute;curis&eacute;e que
+    l'authentification Basic, mais ne fonctionne qu'avec les navigateurs
+    qui la supportent. En septembre 2004, les principaux navigateurs
+    supportant l'authentification &agrave; base de condens&eacute;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 &eacute;choue lorsque
+    la requ&ecirc;te comporte une cha&icirc;ne d'arguments -- voir plus loin "<a
+    href="#msie">Travailler avec MS Internet Explorer</a>" pour
+    contourner ce probl&egrave;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 &agrave; base de condens&eacute;s MD5.
+    Comme l'authentification &agrave; base de condens&eacute;s MD5 est moins r&eacute;pandue
+    que l'authentification Basic, vous ne devez l'utiliser que dans des
+    environnements o&ugrave; 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&ugrave; APR supporte la m&eacute;moire partag&eacute;e.</p>
+    </note>
+</section>
+
+<section id="msie"><title>Travailler avec MS Internet Explorer</title>
+    <p>L'impl&eacute;mentation de l'authentification &agrave; base de condens&eacute; dans
+    les versions pr&eacute;c&eacute;dentes d'Internet Explorer pour Windows (5 et 6)
+    posait probl&egrave;me, car les requ&ecirc;tes de type <code>GET</code>
+    comportant une cha&icirc;ne d'arguments (query string) ne respectaient pas les RFC. Il y
+    a plusieurs mani&egrave;res de contourner ce probl&egrave;me.</p>
+
+    <p>
+    La premi&egrave;re m&eacute;thode consiste &agrave; utiliser des requ&ecirc;tes de type
+    <code>POST</code> plut&ocirc;t que <code>GET</code> pour transmettre les
+    donn&eacute;es &agrave; votre programme. Cette m&eacute;thode constitue l'approche la
+    plus simple dans le cas o&ugrave; votre application peut fonctionner avec
+    cette limitation.
+    </p>
+
+    <p>Depuis la version 2.0.51, Apache propose aussi de contourner le
+    probl&egrave;me &agrave; l'aide de la variable d'environnement
+    <code>AuthDigestEnableQueryStringHack</code>. Si
+    <code>AuthDigestEnableQueryStringHack</code> est d&eacute;finie pour la
+    requ&ecirc;te, Apache va prendre des mesures pour contourner la bogue MSIE
+    et en particulier va exclure la cha&icirc;ne d'arguments de la comparaison
+    des condens&eacute;s. L'utilisation de cette m&eacute;thode peut se traduire par
+    ceci :</p>
+
+    <example><title>Utilisation de l'authentification &agrave; base de condens&eacute;
+    avec MSIE :</title>
+    BrowserMatch "MSIE" AuthDigestEnableQueryStringHack=On
+    </example>
+
+    <p>Cette correction n'est pas n&eacute;cessaire avec MSIE 7, bien que son
+    activation ne pose pas de probl&egrave;me de compatibilit&eacute; ou de surcharge
+    significative.</p>
+
+    <p>Voir la directive <directive
+    module="mod_setenvif">BrowserMatch</directive> pour plus de d&eacute;tails
+    &agrave; propos de la d&eacute;finition conditionnelle des variables
+    d'environnement.</p>
+</section>
+
+
+<directivesynopsis>
+<name>AuthDigestProvider</name>
+<description>D&eacute;finit le(s) fournisseurs(s) d'authentification pour la
+zone du site web concern&eacute;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&eacute;finir quel fournisseur d'authentification sera utilis&eacute; pour
+    authentifier les utilisateurs pour la zone du site web concern&eacute;e.
+    Assurez-vous que le module impl&eacute;mentant le fournisseur
+    d'authentification choisi soit bien pr&eacute;sent dans le serveur. Le
+    fournisseur par d&eacute;faut <code>file</code> est impl&eacute;ment&eacute; 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&eacute;termine le niveau de protection fourni par
+l'authentification &agrave; base de condens&eacute;</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&eacute;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&ocirc;le
+    d'int&eacute;grit&eacute; (un condens&eacute; MD5 de l'entit&eacute; est aussi calcul&eacute; et
+    v&eacute;rifi&eacute;) ; avec <code>none</code>, le module va utiliser l'ancien
+    algorithme de condens&eacute;s RFC-2069 (qui n'effectue pas de contr&ocirc;le
+    d'int&eacute;grit&eacute;). On peut sp&eacute;cifier &agrave; 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 &ecirc;tre utilis&eacute; que
+    dans le cas o&ugrave; le navigateur ne serait pas &agrave; m&ecirc;me (pour une raison
+    ou pour une autre) de relever le d&eacute;fit qu'il recevrait si un autre
+    niveau de protection &eacute;tait d&eacute;fini.</p>
+
+    <note>
+      <code>auth-int</code> n'est pas encore impl&eacute;ment&eacute;.
+    </note>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AuthDigestNonceLifetime</name>
+<description>Dur&eacute;e de validit&eacute; du nombre &agrave; 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&ocirc;ler la dur&eacute;e de validit&eacute; du nombre &agrave; valeur unique
+    du serveur (nonce). Lorsque le client contacte le serveur en
+    utilisant un nonce dont la validit&eacute; a expir&eacute;, le serveur renvoie un
+    code d'erreur 401 avec <code>stale=true</code>. Si
+    <var>secondes</var> est sup&eacute;rieur &agrave; 0, il sp&eacute;cifie la dur&eacute;e de
+    validit&eacute; du nonce ; il est en g&eacute;n&eacute;ral d&eacute;conseill&eacute; d'affecter &agrave; cet
+    argument une valeur inf&eacute;rieure &agrave; 10 secondes. Si
+    <var>secondes</var> est inf&eacute;rieur &agrave; 0, le nonce n'expire jamais.
+    <!-- Pas encore impl&eacute;ment&eacute; : si <var>secondes</var> est &eacute;gal &agrave; 0, le
+    client ne doit utiliser le nonce qu'une seule fois. Notez que si les
+    nonces &agrave; usage unique assurent une s&eacute;curit&eacute; accrue contre les
+    attaques &agrave; base de rejeu, il ont aussi d'importantes implications en
+    mati&egrave;re de performances, car le navigateur ne peut plus alors
+    effectuer de requ&ecirc;tes en parall&eacute;le (pipelining) ou utiliser
+    plusieurs connexions pour une m&ecirc;me requ&ecirc;te. Comme il n'est pas ais&eacute;
+    pour les navigateurs de d&eacute;tecter l'utilisation de nonces &agrave; usage
+    unique, on peut aboutir &agrave; la situation o&ugrave; le navigateur va tenter
+    d'effectuer des requ&ecirc;tes en parall&egrave;le et recevoir des codes d'erreur
+    401 pour toutes les requ&ecirc;tes sauf la premi&egrave;re, ce qui aura pour
+    effet de lui faire renvoyer les requ&ecirc;tes. Notez aussi que la
+    protection contre les attaques &agrave; base de rejeu n'a de sens que dans
+    le cas de contenus g&eacute;n&eacute;r&eacute;s dynamiquement ou de requ&ecirc;tes de type
+    POST ; dans le cas des contenus statiques, l'attaquant poss&egrave;de d&eacute;j&agrave;
+    probablement la r&eacute;ponse compl&egrave;te, et les nonces &agrave; usage unique sont
+    ici sans objet.  -->
+    </p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AuthDigestNonceFormat</name>
+<description>D&eacute;termine la mani&egrave;re dont le nombre &agrave; valeur unique du
+serveur (nonce) est g&eacute;n&eacute;r&eacute;</description>
+<syntax>AuthDigestNonceFormat <var>format</var></syntax>
+<contextlist><context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>AuthConfig</override>
+
+<usage>
+    <note>Non encore impl&eacute;ment&eacute;.</note>
+    <!-- La directive AuthDigestNonceFormat permet de d&eacute;terminer la
+    mani&egrave;re dont le nombre &agrave; valeur unique du serveur (nonce) est
+    g&eacute;n&eacute;r&eacute;. -->
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AuthDigestNcCheck</name>
+<description>Active ou d&eacute;sactive la v&eacute;rification du nombre d'envois du
+nombre &agrave; 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&eacute;ment&eacute;.
+    </note>
+    <!--
+    <p>La directive AuthDigestNcCheck permet d'activer ou de d&eacute;sactiver
+    la v&eacute;rification du nombre d'envois du nombre &agrave; valeur unique (nonce)
+    par le serveur.</p>
+
+    <p>Bien que la d&eacute;finition de cette directive &agrave; On soit recommand&eacute;e
+    du point de vue de la s&eacute;curit&eacute;, elle a des cons&eacute;quences importantes sur
+    les performances du serveur.  Pour v&eacute;rifier le nombre d'envois du nonce,
+    *toutes* les requ&ecirc;tes (du moins toutes celles qui poss&egrave;dent un
+    en-t&ecirc;te d'autorisation, qu'elles requi&egrave;rent ou non une
+    authentification &agrave; base de condens&eacute;) doivent &ecirc;tre s&eacute;rialis&eacute;es au
+    travers d'une section critique. Si le serveur traite un grand nombre
+    de requ&ecirc;tes qui poss&egrave;dent un en-t&ecirc;te d'autorisation, l'impact sur
+    les performances pourra se montrer sensible.</p>
+     -->
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AuthDigestAlgorithm</name>
+<description>S&eacute;lectionne l'algorithme utilis&eacute; pour calculer les
+condens&eacute;s du d&eacute;fit et de sa r&eacute;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&eacute;lectionner l'algorithme utilis&eacute; pour calculer les condens&eacute;s du
+    d&eacute;fit et de sa r&eacute;ponse.</p>
+
+    <note>
+      <code>MD5-sess</code> n'est pas encore correctement impl&eacute;ment&eacute;.
+    </note>
+    <!--
+    <p>Pour pouvoir utiliser <code>MD5-sess</code>, vous devez tout
+    d'abord &eacute;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&ecirc;me espace de protection
+concernant l'authentification &agrave; base de condens&eacute;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&eacute;cifier un ou plusieurs URIs se trouvant dans le m&ecirc;me
+    espace de protection (c'est &agrave; dire utilisant le m&ecirc;me utilisateur/mot
+    de passe et se trouvant dans le m&ecirc;me domaine). Les URIs sp&eacute;cifi&eacute;s
+    sont des pr&eacute;fixes ; le client doit savoir que tous les URIs situ&eacute;s
+    sous ces pr&eacute;fixes seront prot&eacute;g&eacute;s par le m&ecirc;me utilisateur/mot de
+    passe. Les URIs peuvent &ecirc;tre soit des URIs absolus (c'est &agrave; dire
+    avec protocole, nom serveur, port, etc...), soit des URIs
+    relatifs.</p>
+
+    <p>Cette directive doit toujours &ecirc;tre pr&eacute;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&ecirc;te d'autorisation avec <em>chaque
+    requ&ecirc;te</em> &agrave; destination de ce serveur. Outre une augmentation de
+    la taille de la requ&ecirc;te, les performances vont s'en trouver
+    affect&eacute;es si la directive <directive
+    module="mod_auth_digest">AuthDigestNcCheck</directive> est d&eacute;finie &agrave;
+    On.</p>
+
+    <p>Les URIs sp&eacute;cifi&eacute;s peuvent aussi r&eacute;f&eacute;rencer diff&eacute;rents serveurs,
+    auquel cas les clients (qui sont &agrave; m&ecirc;me de le comprendre) vont
+    partager l'utilisateur/mot de passe entre plusieurs serveurs sans le
+    demander &agrave; l'utilisateur &agrave; chaque fois.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AuthDigestShmemSize</name>
+<description>La quantit&eacute; de m&eacute;moire partag&eacute;e &agrave; allouer afin de conserver
+les informations &agrave; 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&eacute;finir la quantit&eacute; de m&eacute;moire partag&eacute;e &agrave; allouer au d&eacute;marrage du
+    serveur afin de conserver les informations &agrave; propos des clients.
+    Notez que le segment de m&eacute;moire partag&eacute;e ne peut pas &ecirc;tre d&eacute;fini &agrave;
+    une taille inf&eacute;rieure &agrave; l'espace n&eacute;cessaire pour conserver les
+    informations &agrave; propos d'<em>un</em> client. Cette valeur d&eacute;pend de
+    votre syst&egrave;me. Si vous voulez en d&eacute;terminer la valeur exacte, vous
+    pouvez simplement d&eacute;finir <directive>AuthDigestShmemSize</directive>
+    &agrave; <code>0</code> et consulter le message d'erreur que renverra le
+    serveur lorsqu'on essaiera de le d&eacute;marrer.</p>
+
+    <p>L'argument <var>size</var> s'exprime par d&eacute;faut en octets, mais
+    vous pouvez suffixer le nombre par un <code>K</code> ou un
+    <code>M</code> pour sp&eacute;cifier respectivement des KiloOctets ou des
+    M&eacute;gaOctets. Par exemple, les directives qui suivent sont toutes
+    &eacute;quivalentes :</p>
+
+    <example>
+      AuthDigestShmemSize 1048576<br />
+      AuthDigestShmemSize 1024K<br />
+      AuthDigestShmemSize 1M
+    </example>
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
index 51470b2c1aab13ab67ae2f3d7f54826315133a18..259065bc8ed5b93ca73cabc08c6cb14a26a5086c 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
   </variants>
 </metafile>
index 190674382a55f7650a789c0e7935457e3b64d7da..08c846a709b41abfa58e8fa9decdd632f825f9a6 100644 (file)
@@ -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
index 755b9dc96a649a018c6ff267239e6ddc7b47b67b..1156a147f189b880ad4681fd4f279405a74de26b 100644 (file)
@@ -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">&nbsp;en&nbsp;</a></p>
+<p><span>Available Languages: </span><a href="../en/mod/mod_authn_core.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_authn_core.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</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">&nbsp;en&nbsp;</a></p>
+<p><span>Available Languages: </span><a href="../en/mod/mod_authn_core.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_authn_core.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</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 (file)
index 0000000..712f96b
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_authn_core.html" title="Français">&nbsp;fr&nbsp;</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">&lt;AuthnProviderAlias&gt;</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 />
+        &lt;AuthnProviderAlias file file1&gt;<br />
+        <span class="indent">
+            AuthUserFile /www/conf/passwords1<br />
+        </span>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        # On vérifie ensuite là<br />
+        &lt;AuthnProviderAlias file file2&gt;   <br />
+        <span class="indent">
+            AuthUserFile /www/conf/passwords2<br />
+        </span>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        &lt;Directory /var/web/pages/secure&gt;<br />
+        <span class="indent">
+            AuthBasicProvider file1 file2<br />
+            <br />
+            AuthType Basic<br />
+            AuthName "Zone protégée"<br />
+            Require valid-user<br />
+        </span>
+        &lt;/Directory&gt;<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>
+          &lt;AuthnProviderAlias ldap alias-ldap&gt;<br />
+          <span class="indent">
+             AuthLDAPBindDN cn=utilisateur,o=ctx<br />
+             AuthLDAPBindPassword mot-de-passe<br />
+             AuthLDAPURL ldap://serveur.ldap/o=ctx<br />
+          </span>
+          &lt;/AuthnProviderAlias&gt;<br /><br />
+          &lt;AuthnProviderAlias ldap autre-alias-ldap&gt;<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>
+          &lt;/AuthnProviderAlias&gt;<br /><br />
+
+          Alias /secure /webpages/secure<br />
+          &lt;Directory /webpages/secure&gt;<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>
+          &lt;/Directory&gt;<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">&lt;AuthnProviderAlias&gt;</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>&lt;AuthnProviderAlias <var>alias-fournisseur</var>&gt;
+... &lt;/AuthnProviderAlias&gt;</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>&lt;AuthnProviderAlias&gt;</code> et
+    <code>&lt;/AuthnProviderAlias&gt;</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>
+        &lt;Directory /www/docs&gt;
+        <span class="indent">
+            AuthType Basic<br />
+            AuthName Documents<br />
+            AuthBasicProvider file<br />
+            AuthUserFile /usr/local/apache/passwd/passwords<br />
+            Require valid-user
+        </span>
+        &lt;/Directory&gt;<br />
+        <br />
+        &lt;Directory /www/docs/public&gt;
+        <span class="indent">
+            AuthType None<br />
+            Require all granted
+        </span>
+        &lt;/Directory&gt;
+    </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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_authn_core.html" title="Français">&nbsp;fr&nbsp;</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 (file)
index 0000000..2580a3f
--- /dev/null
@@ -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&eacute;s d'authentification
+    permettant d'accorder ou de refuser l'acc&egrave;s &agrave; certaines zones du
+    site web. Les directives fournies par le module
+    <module>mod_authn_core</module> sont communes &agrave; tous les
+    fournisseurs d'authentification.</p>
+</summary>
+
+<section id="authnalias"><title>Cr&eacute;ation d'alias de fournisseurs
+d'authentification</title>
+
+    <p>Il est possible de cr&eacute;er des fournisseurs d'authentification
+    &eacute;tendus dans le fichier de configuration et de leur assigner un
+    alias. Le fournisseur ainsi nomm&eacute; peut alors &ecirc;tre r&eacute;f&eacute;renc&eacute; &agrave; 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&eacute; de
+    cr&eacute;er et attribuer un alias &agrave; un fournisseur &eacute;tendu, le m&ecirc;me
+    fournisseur d'authentification peut aussi &ecirc;tre r&eacute;f&eacute;renc&eacute; par
+    plusieurs sections relatives &agrave; une zone du site web.</p>
+
+    <section id="example"><title>Exemples</title>
+
+       <p>Cet exemple v&eacute;rifie les mots de passe dans deux fichiers
+       textes diff&eacute;rents.</p>
+
+       <example><title>V&eacute;rification dans plusieurs fichiers de mots de
+       passe au format texte</title>
+
+        # On v&eacute;rifie tout d'abord ici<br />
+        &lt;AuthnProviderAlias file file1&gt;<br />
+        <indent>
+            AuthUserFile /www/conf/passwords1<br />
+        </indent>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        # On v&eacute;rifie ensuite l&agrave;<br />
+        &lt;AuthnProviderAlias file file2&gt;   <br />
+        <indent>
+            AuthUserFile /www/conf/passwords2<br />
+        </indent>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        &lt;Directory /var/web/pages/secure&gt;<br />
+        <indent>
+            AuthBasicProvider file1 file2<br />
+            <br />
+            AuthType Basic<br />
+            AuthName "Zone prot&eacute;g&eacute;e"<br />
+            Require valid-user<br />
+        </indent>
+        &lt;/Directory&gt;<br />
+        </example>
+
+
+
+        <p>Dans l'exemple ci-dessous, deux fournisseurs
+       d'authentification ldap sont cr&eacute;&eacute;s &agrave; partir du fournisseur ldap
+       de base, et se voient attribuer un alias. L'authentification
+       d'une m&ecirc;me zone peut alors &ecirc;tre trait&eacute;e par plusieurs serveurs
+       ldap :</p>
+
+        <example><title>V&eacute;rification aupr&egrave;s de plusieurs serveurs
+       LDAP</title>
+          &lt;AuthnProviderAlias ldap alias-ldap&gt;<br />
+          <indent>
+             AuthLDAPBindDN cn=utilisateur,o=ctx<br />
+             AuthLDAPBindPassword mot-de-passe<br />
+             AuthLDAPURL ldap://serveur.ldap/o=ctx<br />
+          </indent>
+          &lt;/AuthnProviderAlias&gt;<br /><br />
+          &lt;AuthnProviderAlias ldap autre-alias-ldap&gt;<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>
+          &lt;/AuthnProviderAlias&gt;<br /><br />
+
+          Alias /secure /webpages/secure<br />
+          &lt;Directory /webpages/secure&gt;<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&eacute;g&eacute;e_par_LDAP<br />
+             Require valid-user<br />
+          </indent>
+          &lt;/Directory&gt;<br />
+        </example>
+    </section>
+
+</section>
+
+
+<directivesynopsis>
+<name>AuthName</name>
+<description>L'identifiant de l'autorisation &agrave; 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&eacute;finir l'identifiant d'autorisation
+    pour un r&eacute;pertoire. Cet identifiant est fourni au client de fa&ccedil;on &agrave;
+    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 &ecirc;tre entour&eacute; de guillemets. Pour
+    pouvoir fonctionner, la directive <directive>AuthName</directive>
+    doit &ecirc;tre utilis&eacute;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&icirc;ne fournie comme argument &agrave; <code>AuthName</code>
+    appara&icirc;tra dans la bo&icirc;te de dialogue d'authentification pour la
+    plupart des navigateurs.</p>
+</usage>
+<seealso><a
+    href="../howto/auth.html">Authentification, autorisation et contr&ocirc;le
+    d'acc&egrave;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&eacute;finir le type d'authentification
+    utilisateur pour un r&eacute;pertoire. Les types d'authentification
+    disponibles sont <code>None</code>, <code>Basic</code> (impl&eacute;ment&eacute;
+    par <module>mod_auth_basic</module>), <code>Digest</code>
+    (impl&eacute;ment&eacute; par <module>mod_auth_digest</module>), et
+    <code>Form</code> (impl&eacute;ment&eacute; 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&eacute;sactive
+    l'authentification. Lorsqu'une authentification est d&eacute;finie, elle
+    est en g&eacute;n&eacute;ral h&eacute;rit&eacute;e par chacune des <a
+    href="../sections.html#mergin">sections de configuration</a> qui
+    suivent, &agrave; moins qu'un autre type d'authentification ne soit
+    sp&eacute;cifi&eacute;. Si l'on ne souhaite pas mettre en oeuvre
+    d'authentification pour une sous-section d'une section authentifi&eacute;e,
+    on doit utiliser le type d'authentification <code>None</code> ; dans
+    l'exemple suivant, les clients peuvent acc&eacute;der au r&eacute;pertoire
+    <code>/www/docs/public</code> sans devoir s'authentifier :</p>
+
+    <example>
+        &lt;Directory /www/docs&gt;
+        <indent>
+            AuthType Basic<br />
+            AuthName Documents<br />
+            AuthBasicProvider file<br />
+            AuthUserFile /usr/local/apache/passwd/passwords<br />
+            Require valid-user
+        </indent>
+        &lt;/Directory&gt;<br />
+        <br />
+        &lt;Directory /www/docs/public&gt;
+        <indent>
+            AuthType None<br />
+            Require all granted
+        </indent>
+        &lt;/Directory&gt;
+    </example>
+
+    <note>Veuillez noter que, lorsque l'authentification n'est pas
+    activ&eacute;e, les clients qui se sont d&eacute;j&agrave; authentifi&eacute;s pour une autre
+    zone de l'arborescence du site continueront en g&eacute;n&eacute;ral &agrave; envoyer des
+    en-t&ecirc;te d'authentification HTTP ou des cookies avec chaque requ&ecirc;te,
+    sans se pr&eacute;occuper de savoir si le serveur n&eacute;cessite vraiment une
+    authentification pour chaque ressource.</note>
+</usage>
+
+<seealso><a href="../howto/auth.html">Authentification, autorisation et contr&ocirc;le
+    d'acc&egrave;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&eacute;cifi&eacute;</description>
+<syntax>&lt;AuthnProviderAlias <var>alias-fournisseur</var>&gt;
+... &lt;/AuthnProviderAlias&gt;</syntax>
+<contextlist><context>server config</context>
+</contextlist>
+
+<usage>
+    <p>Les balises <code>&lt;AuthnProviderAlias&gt;</code> et
+    <code>&lt;/AuthnProviderAlias&gt;</code> permettent de regrouper un
+    ensemble de directives d'authentification qui seront r&eacute;f&eacute;renc&eacute;es par
+    l'alias sp&eacute;cifi&eacute; &agrave; l'aide des directives <directive
+    module="mod_auth_basic">AuthBasicProvider</directive> ou <directive
+    module="mod_auth_digest">AuthDigestProvider</directive>.</p>
+
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
index 06cf00a8a13c03d67cf325b78353ddf3248784d1..c98385acfd0d0e80d3eede97cac789ff254896e1 100644 (file)
@@ -8,5 +8,6 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
   </variants>
 </metafile>
index 3deae9de73859b29cef735cdf3a59285e7cf94e4..f737b4dc8848f868c7600c75a9f9b6d4290d34f7 100644 (file)
@@ -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
index 836fec7f378c68caa93ba02a641d01d5ec920348..3ca4346a1d62a5f3675d8f87d705487b8d7b8e26 100644 (file)
@@ -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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_headers.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_headers.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..e83af5f
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_headers.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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>&lt;Directory&gt;</code> ou
+    <code>&lt;Location&gt;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_headers.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..9014d95
--- /dev/null
@@ -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&ecirc;tes de requ&ecirc;tes et de r&eacute;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&ocirc;ler et
+    modifier les en-t&ecirc;tes de requ&ecirc;tes et de r&eacute;ponses HTTP. Les en-t&ecirc;tes
+    peuvent &ecirc;tre fusionn&eacute;s, remplac&eacute;s ou supprim&eacute;s.</p>
+</summary>
+
+<section id="order"><title>Chronologie du traitement</title>
+
+    <p>Les directives fournies par <module>mod_headers</module> peuvent
+    s'ins&eacute;rer presque partout dans la configuration du serveur, et on
+    peut limiter leur port&eacute;e en les pla&ccedil;ant dans des <a
+    href="../sections.html">sections de configuration</a>.</p>
+
+    <p>La chronologie du traitement est importante et est affect&eacute;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&eacute;rent si leur ordre est invers&eacute;
+    :</p>
+
+    <example>
+      RequestHeader append MirrorID "mirror 12"<br />
+      RequestHeader unset MirrorID
+    </example>
+
+    <p>Dans cet ordre, l'en-t&ecirc;te <code>MirrorID</code> n'est pas d&eacute;fini.
+    Si l'ordre des directives &eacute;tait invers&eacute;, l'en-t&ecirc;te
+    <code>MirrorID</code> serait d&eacute;fini &agrave; "mirror 12".</p>
+</section>
+
+<section id="early"><title>Traitement pr&eacute;coce et traitement
+tardif</title>
+    <p><module>mod_headers</module> peut agir soir pr&eacute;cocement, soit
+    tardivement au niveau de la requ&ecirc;te. Le mode normal est le mode
+    tardif, lorsque les en-t&ecirc;tes de requ&ecirc;te sont d&eacute;finis, imm&eacute;diatement
+    avant l'ex&eacute;cution du g&eacute;n&eacute;rateur de contenu, et pour les en-t&ecirc;tes de
+    r&eacute;ponse, juste au moment o&ugrave; la r&eacute;ponse est envoy&eacute;e sur le r&eacute;seau.
+    Utilisez toujours le mode tardif sur un serveur en production.</p>
+
+    <p>Le mode pr&eacute;coce a &eacute;t&eacute; con&ccedil;u &agrave; des fins d'aide aux tests et au
+    d&eacute;bogage pour les d&eacute;veloppeurs. Les directives d&eacute;finies en utilisant
+    le mot-cl&eacute; <code>early</code> sont cens&eacute;es agir au tout d&eacute;but du
+    traitement de la requ&ecirc;te. Cela signifie que l'on peut les utiliser
+    pour simuler diff&eacute;rentes requ&ecirc;tes et d&eacute;finir des situations de test,
+    tout en gardant &agrave; l'esprit que les en-t&ecirc;tes peuvent &ecirc;tre modifi&eacute;s &agrave;
+    tout moment par d'autres modules avant que le r&eacute;ponse ne soit
+    g&eacute;n&eacute;r&eacute;e.</p>
+
+    <p>Comme les directives pr&eacute;coces sont trait&eacute;es avant que le
+    chemin de la requ&ecirc;te ne soit parcouru, les en-t&ecirc;tes
+    pr&eacute;coces ne peuvent &ecirc;tre d&eacute;finis que dans un contexte de serveur
+    principal ou de serveur virtuel. Les directives pr&eacute;coces ne peuvent
+    pas d&eacute;pendre d'un chemin de requ&ecirc;te, si bien qu'elles &eacute;choueront
+    dans des contextes tels que <code>&lt;Directory&gt;</code> ou
+    <code>&lt;Location&gt;</code>.</p>
+</section>
+
+<section id="examples"><title>Exemples</title>
+
+    <ol>
+      <li>
+        Copie tous les en-t&ecirc;tes de requ&ecirc;te qui commencent par "TS" vers
+       les en-t&ecirc;tes de la r&eacute;ponse :
+
+        <example>
+          Header echo ^TS
+        </example>
+      </li>
+
+      <li>
+        Ajoute &agrave; la r&eacute;ponse un en-t&ecirc;te, <code>mon-en-t&ecirc;te</code>, qui
+       contient un horodatage permettant de d&eacute;terminer le moment o&ugrave; la
+       requ&ecirc;te a &eacute;t&eacute; re&ccedil;ue, et le temps qui s'est &eacute;coul&eacute; jusqu'&agrave; ce que
+       la requ&ecirc;te ait commenc&eacute; &agrave; &ecirc;tre servie. Cet en-t&ecirc;te peut &ecirc;tre
+       utilis&eacute; par le client pour estimer la charge du serveur ou
+       isoler les goulets d'&eacute;tranglement entre le client et le
+       serveur.
+
+        <example>
+          Header set mon-en-t&ecirc;te "%D %t"
+        </example>
+
+        <p>le r&eacute;sultat est l'ajout &agrave; la r&eacute;ponse d'un en-t&ecirc;te du type :</p>
+
+        <example>
+          mon-en-t&ecirc;te: D=3775428 t=991424704447256
+        </example>
+      </li>
+
+      <li>
+        Dit Bonjour &agrave; Joe
+
+        <example>
+          Header set mon-en-t&ecirc;te "Bonjour Joe. Il a fallu %D microsecondes \<br />
+          &agrave; Apache pour servir cette requ&ecirc;te."
+        </example>
+
+        <p>le r&eacute;sultat est l'ajout &agrave; la r&eacute;ponse d'un en-t&ecirc;te du type :</p>
+
+        <example>
+          mon-en-t&ecirc;te: Bonjour Joe. Il a fallu D=3775428 microsecondes &agrave; Apache
+          pour servir cette requ&ecirc;te.
+        </example>
+      </li>
+
+      <li>
+        Ajoute l'en-t&ecirc;te <code>mon-en-t&ecirc;te</code> &agrave; la r&eacute;ponse si et
+       seulement si l'en-t&ecirc;te <code>mon-en-t&ecirc;te-requ&ecirc;te</code> est
+       pr&eacute;sent dans la requ&ecirc;te. Ceci peut s'av&eacute;rer utile pour g&eacute;n&eacute;rer
+       des en-t&ecirc;tes de r&eacute;ponse "&agrave; la t&ecirc;te du client". Notez que cet
+       exemple n&eacute;cessite les services du module
+       <module>mod_setenvif</module>.
+
+        <example>
+          SetEnvIf mon-en-t&ecirc;te-requ&ecirc;te mavaleur HAVE_MyRequestHeader<br />
+          Header set mon-en-t&ecirc;te "%D %t montexte" env=HAVE_MyRequestHeader
+        </example>
+
+        <p>Si l'en-t&ecirc;te <code>mon-en-t&ecirc;te-requ&ecirc;te: mavaleur</code> est
+       pr&eacute;sent dans la requ&ecirc;te HTTP, la r&eacute;ponse contiendra un en-t&ecirc;te
+       du type :</p>
+
+        <example>
+          mon-en-t&ecirc;te: D=3775428 t=991424704447256 montexte
+        </example>
+      </li>
+
+      <li>
+        Permet &agrave; DAV de fonctionner avec Apache sur SSL (voir la <a
+       href="http://svn.haxx.se/users/archive-2006-03/0549.shtml">description
+       du probl&egrave;me</a>) en rempla&ccedil;ant <var>https:</var> par
+       <var>http:</var> dans l'en-t&ecirc;te <var>Destination</var> :
+
+        <example>
+          RequestHeader edit Destination ^https: http: early
+        </example>
+      </li>
+
+      <li>
+        D&eacute;finit la valeur d'un m&ecirc;me en-t&ecirc;te sous de multiples conditions
+       non exclusives, mais ne duplique pas une valeur d&eacute;j&agrave; d&eacute;finie
+       dans l'en-t&ecirc;te qui en r&eacute;sulte. Si toutes les conditions
+       suivantes sont satisfaites pour une requ&ecirc;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&ecirc;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&eacute;ponse contiendra l'en-t&ecirc;te suivant :</p>
+
+        <example>
+          Cache-Control: no-cache, no-store
+        </example>
+
+        <p>Si <code>append</code> avait &eacute;t&eacute; utilis&eacute; &agrave; la place de
+       <code>merge</code>, la r&eacute;ponse aurait contenu l'en-t&ecirc;te suivant
+       :</p>
+
+        <example>
+          Cache-Control: no-cache, no-cache, no-store
+        </example>
+      </li>
+      <li>
+        D&eacute;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&ecirc;tes d'une requ&ecirc;te HTTP</description>
+<syntax>RequestHeader add|append|edit|merge|set|unset <var>en-t&ecirc;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&ecirc;tes de requ&ecirc;te HTTP. L'en-t&ecirc;te est modifi&eacute; juste
+    avant que le gestionnaire de contenu ne s'ex&eacute;cute, ce qui permet la
+    modification des en-t&ecirc;tes entrants. L'action effectu&eacute;e est
+    d&eacute;termin&eacute;e par le premier argument. Ce dernier accepte les valeurs
+    suivantes :</p>
+
+    <dl>
+
+    <dt><code>add</code></dt>
+    <dd>L'en-t&ecirc;te est ajout&eacute; au jeu d'en-t&ecirc;tes pr&eacute;existant, m&ecirc;me s'il
+    existe d&eacute;j&agrave;. Ceci peut conduire &agrave; la pr&eacute;sence de deux (ou plusieurs)
+    en-t&ecirc;tes poss&egrave;dant le m&ecirc;me nom et donc induire des cons&eacute;quences
+    impr&eacute;vues ; en g&eacute;n&eacute;ral, il est pr&eacute;f&eacute;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&ecirc;te est ajout&eacute;e &agrave; tout en-t&ecirc;te existant de m&ecirc;me
+    nom. Lorsqu'une nouvelle valeur est ainsi ajout&eacute;e, elle est s&eacute;par&eacute;e
+    de celles qui sont d&eacute;j&agrave; pr&eacute;sentes par une virgule. Il s'agit de la
+    m&eacute;thode HTTP standard permettant d'affecter plusieurs valeurs &agrave; un
+    en-t&ecirc;te.</dd>
+
+    <dt><code>edit</code></dt>
+    <dd>Si l'en-t&ecirc;te existe, sa valeur est modifi&eacute;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&icirc;ne de caract&egrave;res de
+    remplacement qui peut contenir des r&eacute;f&eacute;rences arri&egrave;res.</dd>
+
+    <dt><code>merge</code></dt>
+    <dd>La valeur d'en-t&ecirc;te est ajout&eacute;e &agrave; tout en-t&ecirc;te de m&ecirc;me nom, sauf
+    si elle appara&icirc;t d&eacute;j&agrave; dans la liste des valeurs pr&eacute;existantes de
+    l'en-t&ecirc;te s&eacute;par&eacute;es par des virgules. Lorsqu'une nouvelle valeur est
+    ainsi ajout&eacute;e, elle est s&eacute;par&eacute;e de celles qui sont d&eacute;j&agrave; pr&eacute;sentes
+    par une virgule. Il s'agit de la m&eacute;thode HTTP standard permettant
+    d'affecter plusieurs valeurs &agrave; un en-t&ecirc;te. Les valeurs sont
+    compar&eacute;es en tenant compte de la casse, et apr&egrave;s le traitement de
+    tous les sp&eacute;cificateurs de format. Une valeur entour&eacute;e de guillemets
+    est consid&eacute;r&eacute;e comme diff&eacute;rente de la m&ecirc;me valeur mais sans
+    guillemets.</dd>
+
+    <dt><code>set</code></dt>
+    <dd>L'en-t&ecirc;te est d&eacute;fini, rempla&ccedil;ant tout en-t&ecirc;te pr&eacute;existant avec
+    le m&ecirc;me nom.</dd>
+
+    <dt><code>unset</code></dt>
+    <dd>L'en-t&ecirc;te est supprim&eacute; s'il existe. Si plusieurs en-t&ecirc;tes
+    poss&egrave;dent le m&ecirc;me nom, ils seront tous supprim&eacute;s. L'argument
+    <var>value</var> ne doit pas appara&icirc;tre.</dd>
+    </dl>
+
+    <p>Cet argument est suivi d'un nom d'en-t&ecirc;te qui peut se terminer
+    par un caract&egrave;re ':', mais ce n'est pas obligatoire. La casse est
+    ignor&eacute;e. Avec <code>set</code>, <code>append</code>,
+    <code>merge</code> et <code>add</code>, une <var>valeur</var> est
+    fournie en troisi&egrave;me argument. Si une <var>valeur</var> contient des
+    espaces, elle doit &ecirc;tre entour&eacute;e de guillemets. Avec
+    <code>unset</code>, aucune <var>valeur</var> ne doit appara&icirc;tre.
+    <var>valeur</var> peut &ecirc;tre une cha&icirc;ne de caract&egrave;res, une cha&icirc;ne
+    contenant des sp&eacute;cificateurs de format, ou une combinaison des deux.
+    Les sp&eacute;cificateurs de format support&eacute;s sont les m&ecirc;mes que ceux de la
+    directive <directive module="mod_headers">Header</directive>, &agrave;
+    laquelle vous pouvez vous reporter pour plus de d&eacute;tails. Avec
+    <code>edit</code>, les deux arguments <var>valeur</var> et
+    <var>remplacement</var> sont obligatoires, et correspondent
+    respectivement &agrave; une <glossary ref="regex">expression
+    rationnelle</glossary> et &agrave; une cha&icirc;ne de remplacement.</p>
+
+    <p>La directive <directive>RequestHeader</directive> peut &ecirc;tre
+    suivie d'un argument suppl&eacute;mentaire, qui pourra prendre les valeurs
+    suivantes :</p>
+    <dl>
+    <dt><code>early</code></dt>
+    <dd>Sp&eacute;cifie <a href="#early">traitement pr&eacute;alable</a>.</dd>
+    <dt><code>env=[!]variable</code></dt>
+    <dd>La directive est appliqu&eacute;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&eacute;finie.</dd>
+    <dt><code>expr</code></dt>
+    <dd>Une cha&icirc;ne qui correspond &agrave; toute valeur ci-dessus est
+    interpr&eacute;t&eacute;e comme une expression. Les d&eacute;tails &agrave; propos de la syntaxe
+    des expressions et leur &eacute;valuation sont pour l'instant mieux
+    document&eacute;s dans la page de <module>mod_filter</module>.</dd>
+    </dl>
+
+    <p>Except&eacute; le cas du mode <a href="#early">pr&eacute;coce</a>, la directive
+    <directive>RequestHeader</directive> est trait&eacute;e juste avant la
+    prise en compte de la requ&ecirc;te par son gestionnaire, au cours de la
+    phase de v&eacute;rification. Ceci permet la modification des en-t&ecirc;tes
+    g&eacute;n&eacute;r&eacute;s par le navigateur, ou par les filtres en entr&eacute;e
+    d'Apache.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>Header</name>
+<description>Configure les en-t&ecirc;tes d'une r&eacute;ponse HTTP</description>
+<syntax>Header [<var>condition</var>] add|append|echo|edit|merge|set|unset
+<var>en-t&ecirc;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&ecirc;tes de r&eacute;ponse HTTP. L'en-t&ecirc;te est modifi&eacute; juste
+    apr&egrave;s que le gestionnaire de contenu et les filtres en sortie ne
+    s'ex&eacute;cutent, ce qui permet la modification des en-t&ecirc;tes
+    sortants.</p>
+
+    <p>Par d&eacute;faut, cette directive n'affecte que les r&eacute;ponses positives
+    (r&eacute;ponses dont le code de statut est dans la gamme
+    <code>2<var>xx</var></code>). Le param&egrave;tre optionnel
+    <var>condition</var> peut prendre pour valeur soit
+    <code>onsuccess</code> (valeur par d&eacute;faut), soit <code>always</code>
+    (tous les codes de statut, y compris les r&eacute;ponses positives).
+    D&eacute;finir cette valeur &agrave; <code>always</code> permet d'affecter des
+    en-t&ecirc;tes d&eacute;finis par certains modules internes, y compris dans le
+    cas d'une r&eacute;ponse positive, et s'av&egrave;re m&ecirc;me n&eacute;cessaire pour affecter
+    des en-t&ecirc;tes de r&eacute;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&eacute;termin&eacute;e par le
+    second argument. Il peut prendre une des valeurs suivantes :</p>
+
+    <dl>
+    <dt><code>add</code></dt>
+    <dd>L'en-t&ecirc;te est ajout&eacute; au jeu d'en-t&ecirc;tes pr&eacute;existant, m&ecirc;me s'il
+    existe d&eacute;j&agrave;. Ceci peut conduire &agrave; la pr&eacute;sence de deux (ou plusieurs)
+    en-t&ecirc;tes poss&egrave;dant le m&ecirc;me nom et donc induire des cons&eacute;quences
+    impr&eacute;vues ; en g&eacute;n&eacute;ral, il est pr&eacute;f&eacute;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&ecirc;te est ajout&eacute;e &agrave; tout en-t&ecirc;te existant de m&ecirc;me
+    nom. Lorsqu'une nouvelle valeur est ainsi ajout&eacute;e, elle est s&eacute;par&eacute;e
+    de celles qui sont d&eacute;j&agrave; pr&eacute;sentes par une virgule. Il s'agit de la
+    m&eacute;thode HTTP standard permettant d'affecter plusieurs valeurs &agrave; un
+    en-t&ecirc;te.</dd>
+
+    <dt><code>echo</code></dt>
+    <dd>Les en-t&ecirc;tes de la requ&ecirc;te poss&eacute;dant le nom sp&eacute;cifi&eacute; sont
+    recopi&eacute;s vers les en-t&ecirc;tes de la r&eacute;ponse. <var>en-t&ecirc;te</var> peut
+    &ecirc;tre une <glossary ref="regex">expression rationnelle</glossary>, et
+    <var>valeur</var> ne doit pas &ecirc;tre pr&eacute;sent.</dd>
+
+    <dt><code>edit</code></dt>
+    <dd>Si l'en-t&ecirc;te existe, sa valeur est modifi&eacute;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&icirc;ne de caract&egrave;res de
+    remplacement qui peut contenir des r&eacute;f&eacute;rences arri&egrave;res.</dd>
+
+    <dt><code>merge</code></dt>
+    <dd>La valeur d'en-t&ecirc;te est ajout&eacute;e &agrave; tout en-t&ecirc;te de m&ecirc;me nom, sauf
+    si elle appara&icirc;t d&eacute;j&agrave; dans la liste des valeurs pr&eacute;existantes de
+    l'en-t&ecirc;te s&eacute;par&eacute;es par des virgules. Lorsqu'une nouvelle valeur est
+    ainsi ajout&eacute;e, elle est s&eacute;par&eacute;e de celles qui sont d&eacute;j&agrave; pr&eacute;sentes
+    par une virgule. Il s'agit de la m&eacute;thode HTTP standard permettant
+    d'affecter plusieurs valeurs &agrave; un en-t&ecirc;te. Les valeurs sont
+    compar&eacute;es en tenant compte de la casse, et apr&egrave;s le traitement de
+    tous les sp&eacute;cificateurs de format. Une valeur entour&eacute;e de guillemets
+    est consid&eacute;r&eacute;e comme diff&eacute;rente de la m&ecirc;me valeur mais sans
+    guillemets.</dd>
+
+    <dt><code>set</code></dt>
+    <dd>L'en-t&ecirc;te est d&eacute;fini, rempla&ccedil;ant tout en-t&ecirc;te pr&eacute;existant avec
+    le m&ecirc;me nom. L'argument <var>valeur</var> peut &ecirc;tre une cha&icirc;ne de
+    formatage.</dd>
+
+    <dt><code>unset</code></dt>
+    <dd>L'en-t&ecirc;te est supprim&eacute; s'il existe. Si plusieurs en-t&ecirc;tes
+    poss&egrave;dent le m&ecirc;me nom, ils seront tous supprim&eacute;s. L'argument
+    <var>value</var> ne doit pas appara&icirc;tre.</dd>
+    </dl>
+
+    <p>Cet argument est suivi d'un nom d'<var>en-t&ecirc;te</var> qui peut se
+    terminer par un caract&egrave;re ':', mais ce n'est pas obligatoire. La
+    casse est ignor&eacute;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&ecirc;te</var> est sensible &agrave; la
+    casse pour <code>echo</code> et peut &ecirc;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&eacute;cifi&eacute;e comme
+    troisi&egrave;me argument. Si <var>valeur</var> contient des espaces, elle
+    doit &ecirc;tre entour&eacute;e de guillemets. <var>valeur</var> peut &ecirc;tre une
+    cha&icirc;ne de caract&egrave;res, une cha&icirc;ne contenant des sp&eacute;cificateurs de
+    format, ou une combinaison des deux. <var>valeur</var> supporte les
+    sp&eacute;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&egrave;re pourcentage</td></tr>
+
+    <tr><td><code>%t</code></td>
+        <td>Le moment de r&eacute;ception de la requ&ecirc;te en temps
+       universel coordonn&eacute; depuis le temps epoch (Jan. 1, 1970) et
+       exprim&eacute; en microsecondes. La valeur est pr&eacute;c&eacute;d&eacute;e de
+       <code>t=</code>.</td></tr>
+
+    <tr><td><code>%D</code></td>
+        <td>Le temps &eacute;coul&eacute; entre la r&eacute;ception de la requ&ecirc;te et l'envoi
+       des en-t&ecirc;tes sur le r&eacute;seau. Il s'agit de la dur&eacute;e de traitement
+       de la requ&ecirc;te. La valeur est pr&eacute;c&eacute;d&eacute;e de <code>D=</code>. La
+       valeur est exprim&eacute;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&eacute;.</td></tr>
+
+    </table>
+
+    <note><title>Note</title>
+      <p>Le sp&eacute;cificateur de format <code>%s</code> est disponible
+      depuis la version 2.1 d'Apache ; il peut &ecirc;tre utilis&eacute; &agrave; la place
+      de <code>%e</code> pour &eacute;viter de devoir sp&eacute;cifier
+      <code>SSLOptions +StdEnvVars</code>. Cependant, si
+      <code>SSLOptions +StdEnvVars</code> doit tout de m&ecirc;me &ecirc;tre
+      sp&eacute;cifi&eacute; pour une raison quelconque, <code>%e</code> sera plus
+      efficace que <code>%s</code>.</p>
+    </note>
+
+    <p><code>edit</code>n&eacute;cessite les deux arguments
+    <var>valeur</var>, qui est une <glossary ref="regex">expression
+    rationnelle</glossary>, et une cha&icirc;ne additionnelle
+    <var>remplacement</var>.</p>
+
+    <p>La directive <directive>Header</directive> peut &ecirc;tre suivie d'un
+    argument additionnel qui peut prendre les valeurs suivantes :</p>
+
+    <dl>
+    <dt><code>early</code></dt>
+    <dd>Sp&eacute;cifie <a href="#early">traitement pr&eacute;alable</a>.</dd>
+    <dt><code>env=[!]variable</code></dt>
+    <dd>La directive est appliqu&eacute;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&eacute;finie.</dd>
+    <dt><code>expr</code></dt>
+    <dd>Une cha&icirc;ne qui correspond &agrave; toute valeur ci-dessus est
+    interpr&eacute;t&eacute;e comme une expression. Les d&eacute;tails &agrave; propos de la syntaxe
+    des expressions et leur &eacute;valuation sont pour l'instant mieux
+    document&eacute;s dans la page de <module>mod_filter</module>.</dd>
+    </dl>
+
+    <p>Except&eacute; le cas du mode <a href="#early">pr&eacute;coce</a>, les
+    directives <directive>Header</directive> sont trait&eacute;es juste avant
+    l'envoi de la r&eacute;ponse sur le r&eacute;seau. Cela signifie qu'il est
+    possible de d&eacute;finir et/ou modifier la plupart des en-t&ecirc;tes, &agrave;
+    l'exception de ceux qui sont ajout&eacute;s par le filtre d'en-t&ecirc;te.</p>
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
+
index e98c462addb68e201d46b8913634b76098f43e8e..83beb8c0a89af34f2ff87aa797e0363a551d71e3 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
     <variant outdated="yes">ko</variant>
   </variants>
index b8be353acc7cef78ab8a307c72d03e67882137fd..11d0f0066ae292454d44b87a1b12dafe75e48ce8 100644 (file)
@@ -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
index 66f7cb2ee4dc8750b30fe9f910a0c551117ee8d9..79c8b4785fe9b41e4434d40dc1ca64bd9e654ee3 100644 (file)
@@ -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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_unique_id.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_unique_id.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..7290dac
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_unique_id.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/mod/mod_unique_id.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/mod/mod_unique_id.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/mod/mod_unique_id.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 (file)
index 0000000..e9859d5
--- /dev/null
@@ -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&ecirc;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&eacute; est garantie
+    parmi "toutes" les requ&ecirc;tes sous des conditions tr&egrave;s pr&eacute;cises.
+    L'identifiant unique le sera aussi parmi plusieurs machines
+    appartenant &agrave; un cluster correctement configur&eacute;. L'identifiant est
+    affect&eacute; &agrave; la variable d'environnement <code>UNIQUE_ID</code> pour
+    chaque requ&ecirc;te. Les identifiants uniques sont utiles pour diverses
+    raisons dont la nature se situe au del&agrave; de la port&eacute;e de ce
+    document.</p>
+</summary>
+
+<section id="theory">
+    <title>Th&eacute;orie</title>
+
+    <p>Tout d'abord un bref rappel de la mani&egrave;re dont le serveur Apache
+    fonctionne sous Unix (cette fonctionnalit&eacute; n'&eacute;tant actuellement pas
+    support&eacute;e sous Windows NT). Sous Unix, Apache cr&eacute;e plusieurs
+    processus enfants, ces derniers traitant les requ&ecirc;tes une par une.
+    Chaque processus enfant peut traiter plusieurs requ&ecirc;tes pendant sa
+    dur&eacute;e de vie. Dans le cadre de cette discussion, nous supposerons
+    que les diff&eacute;rents processus enfants ne s'&eacute;changent pas de donn&eacute;es
+    entre eux. Nous nous r&eacute;f&eacute;rerons aux processus enfants sous le nom de
+    <dfn>processus httpd</dfn>.</p>
+
+    <p>Votre site web est r&eacute;parti entre une ou plusieurs machines dont
+    vous &ecirc;tes l'administrateur, et que nous nommerons cluster de
+    serveurs. Chaque serveur peut ex&eacute;cuter plusieurs instances d'Apache.
+    L'ensemble de ces derni&egrave;res sera consid&eacute;r&eacute; comme "l'Univers", et
+    sous certaines hypoth&egrave;ses, nous montrerons qu'il est possible dans
+    cet univers, de g&eacute;n&eacute;rer des identifiants uniques pour chaque
+    requ&ecirc;te, sans pour autant n&eacute;cessiter une communication importante
+    entre les diff&eacute;rents serveurs du cluster.</p>
+
+    <p>Les machines de votre cluster doivent satisfaire ces conditions
+    (m&ecirc;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&eacute;s via NTP ou tout autre
+      protocole de synchronisation du temps en r&eacute;seau.</li>
+
+      <li>Les nom d'h&ocirc;tes des machines sont tous diff&eacute;rents, de fa&ccedil;on &agrave;
+      ce que le module puisse recevoir une adresse IP diff&eacute;rente pour
+      chaque machine du cluster en effectuant une recherche sur le nom
+      d'h&ocirc;te.</li>
+    </ul>
+
+    <p>Au vu des caract&eacute;ristiques actuelles du syst&egrave;me d'exploitation,
+    nous supposerons que les pids (identifiants processus) sont cod&eacute;s
+    sur 32 bits. Si le syst&egrave;me d'exploitation utilise plus de 32 bits
+    pour un pid, la correction est triviale mais doit &ecirc;tre effectu&eacute;e
+    dans le code.</p>
+
+    <p>Ces hypoth&egrave;ses pos&eacute;es, &agrave; un instant donn&eacute;, 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&eacute;n&eacute;rer des identifiants uniques pour chaque requ&ecirc;te, il suffit
+    d'effectuer une distinction en fonction du temps.</p>
+
+    <p>Pour d&eacute;terminer le temps, nous utiliserons un rep&egrave;re de temps
+    Unix (les secondes &eacute;coul&eacute;es depuis le 1er janvier 1970 UTC), et un
+    compteur 16 bits. La pr&eacute;cision du rep&egrave;re de temps n'&eacute;tant que d'une
+    seconde, le compteur va repr&eacute;senter 65536 valeurs par seconde. Le
+    quadruplet <em>(adresse IP, pid, rep&egrave;re de temps, compteur)</em> est
+    en mesure de distinguer 65536 requ&ecirc;tes par seconde par processus
+    httpd. Il peut cependant arriver que le m&ecirc;me pid soit r&eacute;utilis&eacute; au
+    cours du temps, et le compteur est l&agrave; pour pallier cet
+    inconv&eacute;nient.</p>
+
+    <p>Lorsqu'un processus enfant httpd est cr&eacute;&eacute;, le compteur est
+    initialis&eacute; avec (nombre de microsecondes actuel divis&eacute; par 10)
+    modulo 65536 (cette formule a &eacute;t&eacute; choisie pour &eacute;liminer certains
+    probl&egrave;me de variance avec les bits de poids faibles du compteur de
+    microsecondes sur certains syst&egrave;mes). Lorsqu'un identifiant unique
+    est g&eacute;n&eacute;r&eacute;, le rep&egrave;re de temps utilis&eacute; est le moment o&ugrave; la requ&ecirc;te
+    arrive sur le serveur web. Le compteur est incr&eacute;ment&eacute; &agrave; chaque
+    cr&eacute;ation d'identifiant (et peut repasser &agrave; 0 lorsqu'il a atteint sa
+    valeur maximale).</p>
+
+    <p>Le noyau g&eacute;n&egrave;re un pid pour chaque processus lors de sa cr&eacute;ation,
+    et le compteur de pid est r&eacute;initialis&eacute; &agrave; une certaine valeur
+    lorsqu'il a atteint sa valeur maximale (les pid sont cod&eacute;s sur 16
+    bits sous de nombreux Unixes, mais les syst&egrave;mes les plus r&eacute;cents les
+    ont &eacute;tendus &agrave; 32 bits). La m&ecirc;me valeur de pid pourra donc &ecirc;tre
+    r&eacute;utilis&eacute;e au cours du temps. Cependant, tant qu'elle n'est pas
+    r&eacute;utilis&eacute;e dans la m&ecirc;me seconde, elle ne remet pas en cause
+    l'unicit&eacute; de notre quadruplet. Nous supposerons donc que le syst&egrave;me
+    ne cr&eacute;era pas plus de 65536 processus en une seconde (ce nombre peut
+    &ecirc;tre de 32768 sous certains Unixes, mais m&ecirc;me dans ce cas, on est en
+    g&eacute;n&eacute;ral loin de cette situation).</p>
+
+    <p>Il est possible que le temps se r&eacute;p&egrave;te pour une raison
+    quelconque.
+    Supposons par exemple que l'horloge syst&egrave;me soit retard&eacute;e et repasse
+    par un temps pass&eacute; (ou bien, comme elle avan&ccedil;ait, elle a &eacute;t&eacute; remise
+    &agrave; l'heure, et elle repasse par un temps futur). Dans ce cas, il peut
+    &ecirc;tre facilement d&eacute;montr&eacute; que le couple pid/rep&egrave;re de temps peut &ecirc;tre
+    r&eacute;utilis&eacute;. Le choix de la formule d'initialisation du compteur a
+    &eacute;t&eacute; effectu&eacute; dans l'intention de pallier ce probl&egrave;me. Notez qu'un
+    nombre vraiment al&eacute;atoire serait souhaitable pour initialiser le
+    compteur, mais il n'existe pas de tel nombre directement lisible sur
+    la plupart des syst&egrave;mes (c'est &agrave; dire que vous ne pouvez pas
+    utiliser rand() car vous devez d&eacute;clencher le g&eacute;n&eacute;rateur avec une
+    valeur unique, et vous ne pouvez pas utiliser le temps &agrave; cet effet
+    car celui-ci , au moins &agrave; la seconde pr&egrave;s, s'est r&eacute;p&eacute;t&eacute;). Il ne
+    s'agit donc pas d'une d&eacute;fense parfaite.</p>
+
+    <p>M&ecirc;me si elle n'est pas parfaite, quel est le degr&eacute; d'efficacit&eacute;
+    de cette d&eacute;fense ? Supposons
+    qu'une de vos machines serve au plus 500 requ&ecirc;tes par seconde (ce
+    qui constitue une limite sup&eacute;rieure tr&egrave;s raisonnable au moment o&ugrave; ce
+    document est &eacute;crit, car les syst&egrave;mes ne se contentent en g&eacute;n&eacute;ral pas
+    de d&eacute;biter des fichiers statiques). Pour y parvenir, un certain nombre
+    de processus enfants sera n&eacute;cessaire, qui d&eacute;pendra du nombre de
+    clients simultan&eacute;s pr&eacute;sents. Mais soyons pessimiste et supposons
+    qu'un seul processus enfant soit capable de servir 500 requ&ecirc;tes par
+    secondes.
+    Il existe 1000 valeurs de d&eacute;marrage possibles du compteur pour
+    lesquelles deux s&eacute;quences de 500 requ&ecirc;tes puissent se recouvrir. Il
+    y a donc 1,5% de chance que le processus enfant r&eacute;p&egrave;te une valeur de
+    compteur si le temps se r&eacute;p&egrave;te (avec une r&eacute;solution d'une seconde),
+    et l'unicit&eacute; sera alors remise en cause. C'est cependant un exemple
+    tr&egrave;s pessimiste, et avec les valeurs du monde r&eacute;el, il y a bien
+    moins de chances que cela ne se produise. Si vous estimez que ceci a
+    tout de m&ecirc;me quelque chances de se produire sur votre syst&egrave;me, vous
+    pouvez migrer vers un compteur &agrave; 32 bits (en modifiant le code).</p>
+
+    <p>On pourrait supposer que ceci a plus de chance de se produire
+    lors du passage &agrave; l'heure d'hiver o&ugrave; l'horloge est "retard&eacute;e". Cela
+    ne constitue cependant pas un probl&egrave;me car les temps pris en compte
+    ici sont des temps UTC, qui vont "toujours" de l'avant. Notez que
+    les Unixes &agrave; base de processeur x86 peuvent n&eacute;cessiter une
+    configuration particuli&egrave;re pour que ceci soit vrai -- il doivent
+    &ecirc;tre configur&eacute;s pour assumer que l'horloge syst&egrave;me est en UTC et
+    compenser de mani&egrave;re appropri&eacute;e. Mais m&ecirc;me dans ce cas, si vous
+    utilisez NTP, votre temps UTC sera correct peu apr&egrave;s le
+    red&eacute;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&egrave;re de temps sur 32 bits et compteur 16 bits) en
+    utilisant l'alphabet <code>[A-Za-z0-9@-]</code> d'une mani&egrave;re
+    similaire &agrave; celle du codage MIME base64, et sa valeur se pr&eacute;sente
+    sous la forme d'une cha&icirc;ne de 19 caract&egrave;res. L'alphabet MIME base64
+    est en fait <code>[A-Za-z0-9+/]</code> ; cependant, les caract&egrave;res
+    <code>+</code> et <code>/</code> n&eacute;cessitent un codage particulier
+    dans les URLs, ce qui rend leur utilisation peu commode. Toutes les
+    valeurs sont cod&eacute;es dans l'ordre des octets d'une adresse r&eacute;seau de
+    fa&ccedil;on &agrave; ce
+    que le codage soit comparable entre des architectures o&ugrave; l'ordre des
+    octets est diff&eacute;rent. L'ordre r&eacute;el de codage est : rep&egrave;re de temps,
+    adresse IP, pid, compteur. Cet ordre de codage poss&egrave;de un but
+    pr&eacute;cis, mais il faut souligner que les applications n'ont aucun
+    int&eacute;r&ecirc;t &agrave; entrer dans les d&eacute;tails de ce codage. Les applications
+    doivent se contenter de traiter la variable <code>UNIQUE_ID</code>
+    comme un symbole opaque, qui peut &ecirc;tre compar&eacute; avec d'autres
+    <code>UNIQUE_ID</code>s en ne testant que leur &eacute;galit&eacute;.</p>
+
+    <p>L'ordre a &eacute;t&eacute; choisi de fa&ccedil;on &agrave; ce qu'il soit possible de
+    modifier le codage dans le futur sans avoir &agrave; se pr&eacute;occuper de
+    conflits &eacute;ventuels avec une base de donn&eacute;es de
+    <code>UNIQUE_ID</code>s existante. Les nouveaux codages doivent
+    conserver le rep&egrave;re de temps comme premier &eacute;l&eacute;ment, et pour le
+    reste, utiliser les m&ecirc;me alphabet et longueur en bits. Comme les
+    rep&egrave;res de temps constituent essentiellement un s&eacute;quence croissante,
+    il suffit que toutes les machines du cluster arr&ecirc;tent de servir et
+    de requ&eacute;rir dans la m&ecirc;me <em>seconde rep&egrave;re</em>, et n'utilisent
+    alors plus l'ancien format de codage. Ensuite, elles peuvent
+    reprendre le traitement des requ&ecirc;tes en utilisant les nouveaux
+    codages.</p>
+
+    <p>Nous pensons que ceci apporte une solution relativement portable
+    au probl&egrave;me. Elle peut &ecirc;tre &eacute;tendue aux syst&egrave;mes multithread&eacute;s comme
+    Windows NT, et peut &eacute;voluer en fonction des besoins futurs. Les
+    identifiants g&eacute;n&eacute;r&eacute;s poss&egrave;dent une dur&eacute;e de vie pratiquement infinie
+    car les identifiants futurs pourront &ecirc;tre allong&eacute;s selon les
+    besoins. Pratiquement aucune communication n'est requise entre les
+    machines du cluster (seule la synchronisation NTP est requise, ce
+    qui repr&eacute;sente une charge tr&egrave;s faible), et aucune communication
+    entre les processus httpd n'est n&eacute;cessaire (la communication est
+    implicite et incluse dans le pid assign&eacute; par le noyau). Dans des
+    situations tr&egrave;s sp&eacute;cifiques, l'identifiant peut &ecirc;tre raccourci, mais
+    dans ce cas, d'avantage d'informations doivent &ecirc;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>
index 15f8e9349f8611f367967a22ffcaa117ad6cb922..6586539bca7eb641fd2aa7daa30ff3af423f4360 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant>ja</variant>
     <variant outdated="yes">ko</variant>
   </variants>