From: Stefan Fritsch <sf@apache.org>
Date: Thu, 14 Jun 2012 20:22:41 +0000 (+0000)
Subject: Expand the SRP reference documentation
X-Git-Tag: 2.5.0-alpha~6738
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=36dc44a89f57299a0e5199fc1ba14dfe5beb8761;p=thirdparty%2Fapache%2Fhttpd.git

Expand the SRP reference documentation


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1350386 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/configuring.html.fr b/docs/manual/configuring.html.fr
index 70886eb3e84..b8e7f3f4524 100644
--- a/docs/manual/configuring.html.fr
+++ b/docs/manual/configuring.html.fr
@@ -120,7 +120,10 @@ le Serveur HTTP Apache.</p>
     <p>Vous pouvez utiliser la définition <code>-DDUMP_CONFIG</code> de
     <code class="module"><a href="./mod/mod_info.html">mod_info</a></code> pour afficher la configuration avec tous
     les fichiers inclus et les variables d'environnement évaluées, tous
-    les commentaires et les sections <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> et <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> non actives ayant été supprimés.</p>
+    les commentaires et les sections <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> et <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> non actives ayant
+    été supprimés. Cependant, la sortie ne reflète
+    pas les fusions ou écrasements pouvant intervenir en cas de
+    définitions multiples de directives.</p>
   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="modules" id="modules">Modules</a></h2>
diff --git a/docs/manual/configuring.xml.fr b/docs/manual/configuring.xml.fr
index 272a68d40bf..93c9b66cb6e 100644
--- a/docs/manual/configuring.xml.fr
+++ b/docs/manual/configuring.xml.fr
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision : 1243935 -->
+<!-- English Revision: 1243935:1343935 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/manual/mod/core.html.fr b/docs/manual/mod/core.html.fr
index 5ffe051edd6..e1a7e426cdc 100644
--- a/docs/manual/mod/core.html.fr
+++ b/docs/manual/mod/core.html.fr
@@ -4053,6 +4053,11 @@ serveurs virtuels 
     priorité particulière si le nom contient des caractères génériques
     (que ce soit pour ServerName ou ServerAlias).</p>
 
+    <p>Tous les noms spécifiés au sein d'une section
+    <code class="directive">VirtualHost</code> sont traités comme un
+    <code class="directive">ServerAlias</code> (sans caractères génériques).</p>
+
+
 <h3>Voir aussi</h3>
 <ul>
 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
diff --git a/docs/manual/mod/mod_authz_host.html.fr b/docs/manual/mod/mod_authz_host.html.fr
index 507301d7986..94849ec8c79 100644
--- a/docs/manual/mod/mod_authz_host.html.fr
+++ b/docs/manual/mod/mod_authz_host.html.fr
@@ -27,8 +27,6 @@
 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_host.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="../fr/mod/mod_authz_host.html" title="Français">&nbsp;fr&nbsp;</a></p>
 </div>
-<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
-            anglaise pour les changements récents.</div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe basées sur l'hôte (nom ou adresse
 IP)</td></tr>
 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
@@ -193,6 +191,18 @@ Require host .net example.edu
 
 
 
+
+<h3><a name="proxy" id="proxy">Note concernant la sécurité</a></h3>
+
+    <p>Si le contenu de votre serveur est mandaté, vous devez garder à
+    l'esprit que l'adresse client correspondra à l'adresse de votre
+    serveur mandataire et non à l'adresse du client, et l'utilisation de
+    la directive <code>Require</code> dans ce contexte ne provoquera pas
+    forcément l'effet désiré. Voir <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> pour
+    une solution possible à ce problème.</p>
+    
+
+
 </div>
 </div>
 <div class="bottomlang">
diff --git a/docs/manual/mod/mod_authz_host.xml.meta b/docs/manual/mod/mod_authz_host.xml.meta
index c67d019aa9f..2df68a979b0 100644
--- a/docs/manual/mod/mod_authz_host.xml.meta
+++ b/docs/manual/mod/mod_authz_host.xml.meta
@@ -8,6 +8,6 @@
 
   <variants>
     <variant>en</variant>
-    <variant outdated="yes">fr</variant>
+    <variant>fr</variant>
   </variants>
 </metafile>
diff --git a/docs/manual/mod/mod_info.html.fr b/docs/manual/mod/mod_info.html.fr
index c9cf46bb45b..961caca9b5a 100644
--- a/docs/manual/mod/mod_info.html.fr
+++ b/docs/manual/mod/mod_info.html.fr
@@ -29,8 +29,6 @@
 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 </div>
-<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
-            anglaise pour les changements récents.</div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Affiche une présentation complète de la configuration du
 serveur</td></tr>
 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
@@ -141,10 +139,18 @@ serveur</td></tr>
 <div class="section">
 <h2><a name="startup" id="startup">Affichage de la configuration au démarrage</a></h2>
     <p>Si la directive de configuration define
-    <code>-DDUMP_CONFIG</code> est définie, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> va
+    <code>-DDUMP_CONFIG</code> est utilisée, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> va
     envoyer la configuration préinterprétée vers <code>stdout</code> au
-    cours du démarrage du serveur. Ceci est pratiquement équivalent au
-    paramètre de requête <code>?config</code>.</p>
+    cours du démarrage du serveur. "Préinterprétée" signifie que
+    les directives telles que <code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> et <code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> sont évaluées et les variables
+    d'environnement remplacées par leurs valeurs. Cela ne représente
+    cependant pas la configuration définitive. En particulier, les
+    fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
+    représentés.</p>
+
+    <p>Le résultat est équivalent à celui de la requête
+    <code>?config</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="limitations" id="limitations">Limitations connues</a></h2>
diff --git a/docs/manual/mod/mod_info.xml.meta b/docs/manual/mod/mod_info.xml.meta
index 9f670b9a113..9e62f457273 100644
--- a/docs/manual/mod/mod_info.xml.meta
+++ b/docs/manual/mod/mod_info.xml.meta
@@ -8,7 +8,7 @@
 
   <variants>
     <variant>en</variant>
-    <variant outdated="yes">fr</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
     <variant outdated="yes">ko</variant>
   </variants>
diff --git a/docs/manual/mod/mod_lua.html.fr b/docs/manual/mod/mod_lua.html.fr
index 2aee9c61c3d..2f1164fd333 100644
--- a/docs/manual/mod/mod_lua.html.fr
+++ b/docs/manual/mod/mod_lua.html.fr
@@ -27,8 +27,6 @@
 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_lua.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="../fr/mod/mod_lua.html" title="Français">&nbsp;fr&nbsp;</a></p>
 </div>
-<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
-            anglaise pour les changements récents.</div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit des points d'entrée Lua dans différentes parties du
 traitement des requêtes httpd</td></tr>
 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
@@ -147,13 +145,9 @@ function handle(r)
     if r.method == 'GET' then
         for k, v in pairs( r:parseargs() ) do
             r:puts( string.format("%s: %s\n", k, v) )
-        end
-    elseif r.method == 'POST' then
-        for k, v in pairs( r:parsebody() ) do
-            r:puts( string.format("%s: %s\n", k, v) )
-        end
+        end	
     else
-        r:puts("unknown HTTP method " .. r.method)
+        r:puts("Unsupported HTTP method " .. r.method)
     end
 end
 </pre>
@@ -391,12 +385,8 @@ end
 
 
         <pre class="prettyprint lang-lua">
-        r:parseargs() -- returns a lua table containing the request's query string arguments
-        </pre>
-
-
-        <pre class="prettyprint lang-lua">
-        r:parsebody() -- parse the request body as a POST and return  a lua table
+        r:parseargs() -- renvoie une table lua contenant la chaîne
+	d'arguments de la requête
         </pre>
 
 
diff --git a/docs/manual/mod/mod_lua.xml.meta b/docs/manual/mod/mod_lua.xml.meta
index 8fc1a0efdf3..b55c7710e95 100644
--- a/docs/manual/mod/mod_lua.xml.meta
+++ b/docs/manual/mod/mod_lua.xml.meta
@@ -8,6 +8,6 @@
 
   <variants>
     <variant>en</variant>
-    <variant outdated="yes">fr</variant>
+    <variant>fr</variant>
   </variants>
 </metafile>
diff --git a/docs/manual/mod/mod_ssl.html.en b/docs/manual/mod/mod_ssl.html.en
index a9067d4aec3..5114892bd87 100644
--- a/docs/manual/mod/mod_ssl.html.en
+++ b/docs/manual/mod/mod_ssl.html.en
@@ -2092,6 +2092,8 @@ be protected with file permissions similar to those used for
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in httpd 2.5.0 and later, if using OpenSSL 1.0.1 or
+later</td></tr>
 </table>
 <p>
 This directive sets the seed used to fake SRP user parameters for unknown
@@ -2112,6 +2114,8 @@ SSLSRPUnknownUserSeed "secret"
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ssl</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in httpd 2.5.0 and later, if using OpenSSL 1.0.1 or
+later</td></tr>
 </table>
 <p>
 This directive enables TLS-SRP and sets the path to the OpenSSL SRP (Secure
@@ -2120,6 +2124,15 @@ and group parameters.</p>
 <div class="example"><h3>Example</h3><p><code>
 SSLSRPVerifierFile "/path/to/file.srpv"
 </code></p></div>
+<p>
+The verifier file can be created with the <code>openssl</code> command line
+utility:</p>
+<div class="example"><h3>Creating the SRP verifier file</h3><p><code>
+openssl srp -srpvfile passwd.srpv -userinfo "some info" -add username
+</code></p></div>
+<p> The value given with the optional <code>-userinfo</code> parameter is
+avalable in the <code>SSL_SRP_USERINFO</code> request environment variable.</p>
+
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
diff --git a/docs/manual/mod/mod_ssl.xml b/docs/manual/mod/mod_ssl.xml
index 0b8403a7d1d..36145f1ac5b 100644
--- a/docs/manual/mod/mod_ssl.xml
+++ b/docs/manual/mod/mod_ssl.xml
@@ -1190,6 +1190,8 @@ SSLVerifyDepth 10
 <syntax>SSLSRPVerifierFile <em>file-path</em></syntax>
 <contextlist><context>server config</context>
 <context>virtual host</context></contextlist>
+<compatibility>Available in httpd 2.5.0 and later, if using OpenSSL 1.0.1 or
+later</compatibility>
 
 <usage>
 <p>
@@ -1199,6 +1201,15 @@ and group parameters.</p>
 <example><title>Example</title>
 SSLSRPVerifierFile "/path/to/file.srpv"
 </example>
+<p>
+The verifier file can be created with the <code>openssl</code> command line
+utility:</p>
+<example><title>Creating the SRP verifier file</title>
+openssl srp -srpvfile passwd.srpv -userinfo "some info" -add username
+</example>
+<p> The value given with the optional <code>-userinfo</code> parameter is
+avalable in the <code>SSL_SRP_USERINFO</code> request environment variable.</p>
+
 </usage>
 </directivesynopsis>
 
@@ -1208,6 +1219,8 @@ SSLSRPVerifierFile "/path/to/file.srpv"
 <syntax>SSLSRPUnknownUserSeed <em>secret-string</em></syntax>
 <contextlist><context>server config</context>
 <context>virtual host</context></contextlist>
+<compatibility>Available in httpd 2.5.0 and later, if using OpenSSL 1.0.1 or
+later</compatibility>
 
 <usage>
 <p>
diff --git a/docs/manual/rewrite/flags.html.fr b/docs/manual/rewrite/flags.html.fr
index 199d943155e..d2b9ab821c1 100644
--- a/docs/manual/rewrite/flags.html.fr
+++ b/docs/manual/rewrite/flags.html.fr
@@ -24,8 +24,6 @@
 <p><span>Langues Disponibles: </span><a href="../en/rewrite/flags.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="../fr/rewrite/flags.html" title="Français">&nbsp;fr&nbsp;</a></p>
 </div>
-<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
-            anglaise pour les changements récents.</div>
 
 <p>Ce document décrit les drapeaux disponibles dans la directive
 <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, en fournissant
@@ -651,10 +649,8 @@ navigateur. Si une URL pleinement qualifi
 <p><em>Tout</em> code de statut de réponse HTTP valide peut être
 spécifié, en utilisant la syntaxe [R=305], le code de statut 302 étant
 utilisé par défaut si aucun code n'est spécifié. Le code de statut
-spécifié n'est pas nécessairement un code de statut de redirection (3xx).
-</p>
-
-<p>Si le code de statut est en dehors de la plage des codes de
+spécifié n'est pas nécessairement un code de statut
+de redirection (3xx). Cependant, si le code de statut est en dehors de la plage des codes de
 redirection (300-399), la chaîne de substitution est entièrement
 supprimée, et la réécriture s'arrête comme si le drapeau <code>L</code>
 était utilisé.</p>
diff --git a/docs/manual/rewrite/flags.xml.meta b/docs/manual/rewrite/flags.xml.meta
index e4f3ee6f495..912229af035 100644
--- a/docs/manual/rewrite/flags.xml.meta
+++ b/docs/manual/rewrite/flags.xml.meta
@@ -8,6 +8,6 @@
 
   <variants>
     <variant>en</variant>
-    <variant outdated="yes">fr</variant>
+    <variant>fr</variant>
   </variants>
 </metafile>
diff --git a/docs/manual/ssl/ssl_faq.html.fr b/docs/manual/ssl/ssl_faq.html.fr
index 03ee02d3f6e..6565d257b76 100644
--- a/docs/manual/ssl/ssl_faq.html.fr
+++ b/docs/manual/ssl/ssl_faq.html.fr
@@ -24,8 +24,6 @@
 <p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_faq.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="../fr/ssl/ssl_faq.html" title="Français">&nbsp;fr&nbsp;</a></p>
 </div>
-<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
-            anglaise pour les changements récents.</div>
 
 <blockquote>
 <p>Le sage n'apporte pas de bonnes réponses, il pose les bonnes questions</p>
@@ -790,6 +788,28 @@ SetEnvIf User-Agent "MSIE [2-5]" \
 
 
 
+<h3><a name="srp" id="srp">Comment activer TLS-SRP ?</a></h3>
+    <p>TLS-SRP (Echange de clés avec mot de passe distant sécurisé,
+    défini dans la RFC 5054) peut compléter ou même remplacer les
+    certificats au cours de l'authentification d'une connexion SSL. Pour
+    utiliser TLS-SRP, affectez Ã&nbsp; la directive <code class="directive"><a href="../mod/mod_ssl.html#sslsrpverifierfile">SSLSRPVerifierFile</a></code> un fichier de
+    vérification OpenSSL SRP. Pour créer ce fichier de vérification,
+    utilisez l'outil <code>openssl</code> :</p>
+    <div class="example"><p><code>
+    openssl srp -srpvfile passwd.srpv -add username
+    </code></p></div>
+    <p>Une fois ce fichier créé, spécifiez-le dans la configuration SSL
+    du serveur :</p>
+    <div class="example"><p><code>
+    SSLSRPVerifierFile /path/to/passwd.srpv
+    </code></p></div>
+    <p>Pour forcer les clients Ã&nbsp; utiliser des algorithmes de chiffrement
+    non basés sur les certificats, utilisez la directive suivante :</p>
+    <div class="example"><p><code>
+    SSLCipherSuite "!DSS:!aRSA:SRP"
+    </code></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="support" id="support">Support de mod_ssl</a></h2>
diff --git a/docs/manual/ssl/ssl_faq.xml.meta b/docs/manual/ssl/ssl_faq.xml.meta
index a5d5a97804f..61db8269666 100644
--- a/docs/manual/ssl/ssl_faq.xml.meta
+++ b/docs/manual/ssl/ssl_faq.xml.meta
@@ -8,6 +8,6 @@
 
   <variants>
     <variant>en</variant>
-    <variant outdated="yes">fr</variant>
+    <variant>fr</variant>
   </variants>
 </metafile>
diff --git a/docs/manual/vhosts/details.html.fr b/docs/manual/vhosts/details.html.fr
index 8a2c658d81c..8cc485779d0 100644
--- a/docs/manual/vhosts/details.html.fr
+++ b/docs/manual/vhosts/details.html.fr
@@ -26,8 +26,6 @@
 <a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="../tr/vhosts/details.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 </div>
-<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
-            anglaise pour les changements récents.</div>
 
 
     <p>Ce document vise à expliquer dans le détail comment le serveur
@@ -116,6 +114,11 @@ dynamiquement</a></li></ul><ul class="seealso"><li><a href="#comments_section">C
     correspondant. Il sera aussi utilisé pour toutes les connexions SSL
     si le serveur ne supporte pas l'<a class="glossarylink" href="../glossary.html#servernameindication" title="voir glossaire">Indication du nom du serveur</a>.</p>
 
+    <p>Tous les noms spécifiés au sein d'une section
+    <code>VirtualHost</code> sont traités comme un
+    <code>ServerAlias</code> (sans caractères génériques), mais ne sont
+    écrasés par aucune directive <code>ServerAlias</code>.</p>
+
     <p>Pour chaque serveur virtuel, diverses valeurs sont initialisées
     par défaut. En particulier&nbsp;:</p>
 
diff --git a/docs/manual/vhosts/details.xml.meta b/docs/manual/vhosts/details.xml.meta
index 9ec06df893b..5cd5c305f72 100644
--- a/docs/manual/vhosts/details.xml.meta
+++ b/docs/manual/vhosts/details.xml.meta
@@ -8,7 +8,7 @@
 
   <variants>
     <variant>en</variant>
-    <variant outdated="yes">fr</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ko</variant>
     <variant outdated="yes">tr</variant>
   </variants>