httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lgen...@apache.org
Subject svn commit: r1686720 - in /httpd/httpd/trunk/docs/manual: ./ mod/
Date Sun, 21 Jun 2015 13:48:15 GMT
Author: lgentis
Date: Sun Jun 21 13:48:14 2015
New Revision: 1686720

URL: http://svn.apache.org/r1686720
Log:
XML update and conflict resolution with mod_log_forensic.html.fr

Added:
    httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.fr
Removed:
    httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.html.fr
Modified:
    httpd/httpd/trunk/docs/manual/mod/allmodules.xml.fr
    httpd/httpd/trunk/docs/manual/mod/index.html.fr
    httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.html
    httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.meta
    httpd/httpd/trunk/docs/manual/upgrading.html.fr
    httpd/httpd/trunk/docs/manual/upgrading.xml.fr
    httpd/httpd/trunk/docs/manual/upgrading.xml.meta

Modified: httpd/httpd/trunk/docs/manual/mod/allmodules.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/allmodules.xml.fr?rev=1686720&r1=1686719&r2=1686720&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/allmodules.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/allmodules.xml.fr Sun Jun 21 13:48:14 2015
@@ -69,7 +69,7 @@
   <modulefile>mod_ldap.xml.fr</modulefile>
   <modulefile>mod_log_config.xml</modulefile>
   <modulefile>mod_log_debug.xml</modulefile>
-  <modulefile>mod_log_forensic.xml.fr</modulefile>
+  <modulefile>mod_log_forensic.xml</modulefile>
   <modulefile>mod_logio.xml</modulefile>
   <modulefile>mod_lua.xml.fr</modulefile>
   <modulefile>mod_macro.xml.fr</modulefile>

Modified: httpd/httpd/trunk/docs/manual/mod/index.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/index.html.fr?rev=1686720&r1=1686719&r2=1686720&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/index.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/index.html.fr Sun Jun 21 13:48:14 2015
@@ -174,8 +174,7 @@ serveur</dd>
 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_debug.html">mod_log_debug</a></dt><dd>Additional
configurable debug logging</dd>
-<dt><a href="mod_log_forensic.html">mod_log_forensic</a></dt><dd>Journalisation
légale des requêtes envoyées au
-serveur</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_lua.html">mod_lua</a></dt><dd>Fournit des
points d'entrée Lua dans différentes parties du
 traitement des requêtes httpd</dd>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.html?rev=1686720&r1=1686719&r2=1686720&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.html Sun Jun 21 13:48:14 2015
@@ -4,10 +4,6 @@ URI: mod_log_forensic.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
-URI: mod_log_forensic.html.fr
-Content-Language: fr
-Content-type: text/html; charset=ISO-8859-1
-
 URI: mod_log_forensic.html.ja.utf8
 Content-Language: ja
 Content-type: text/html; charset=UTF-8

Added: httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.fr?rev=1686720&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.fr Sun Jun 21 13:48:14 2015
@@ -0,0 +1,171 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1673947 -->
+<!-- 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_log_forensic.xml.meta">
+
+<name>mod_log_forensic</name>
+<description>Journalisation l&eacute;gale des requ&ecirc;tes envoy&eacute;es
au
+serveur</description>
+<status>Extension</status>
+<sourcefile>mod_log_forensic.c</sourcefile>
+<identifier>log_forensic_module</identifier>
+
+<summary>
+    <p>Ce module permet la journalisation l&eacute;gale des requ&ecirc;tes
client. La
+    journalisation s'effectuant avant et apr&egrave;s le traitement de la
+    requ&ecirc;te, le journal l&eacute;gal contient deux lignes pour chaque requ&ecirc;te.
+    Le processus de journalisation l&eacute;gale est tr&egrave;s strict, &agrave;
savoir
+    :</p>
+
+    <ul>
+    <li>Le format est fig&eacute;. Vous ne pouvez pas modifier le format du
+    journal &agrave; l'ex&eacute;cution.</li>
+    <li>S'il ne peut pas enregistrer ses donn&eacute;es, le processus enfant se
+    termine aussit&ocirc;t, et peut &eacute;ventuellement enregistrer un vidage
+    m&eacute;moire (selon la d&eacute;finition de la directive <directive
+    module="mpm_common">CoreDumpDirectory</directive>).</li>
+    </ul>
+
+    <p>Pour interpr&eacute;ter les donn&eacute;es du journal l&eacute;gal,
vous pouvez vous
+    aider du script <code>check_forensic</code> qui se trouve dans le
+    r&eacute;pertoire support de la distribution.</p>
+    <note>Note de traduction : le terme "l&eacute;gal" utilis&eacute; dans
le pr&eacute;sent document ne sugg&egrave;re aucunement que
+    ce module apporte une valeur juridique aux journaux. Il est &agrave; comprendre dans
le contexte
+    similaire &agrave; ce que l'on trouve en analyse medico-l&eacute;gale. En d'autres
termes, la finalit&eacute; de ce module
+    est de simplifier les op&eacute;rations d'investigation autour du traitement des
requ&ecirc;tes par le serveur.</note>
+</summary>
+<seealso><a href="../logs.html">Les fichiers journaux
+d'Apache</a></seealso>
+<seealso><module>mod_log_config</module></seealso>
+
+<section id="formats"><title>Format du journal Forensic</title>
+    <p>Chaque requ&ecirc;te fait l'objet d'une double journalisation. La
+    requ&ecirc;te est journalis&eacute;e une premi&egrave;re fois avant son traitement
+    (c'est &agrave; dire apr&egrave;s la r&eacute;ception des en-t&ecirc;tes).
La deuxi&egrave;me entr&eacute;e
+    du journal est &eacute;crite <em>apr&egrave;s</em> le traitement
de la requ&ecirc;te, en
+    fait au moment de la journalisation habituelle.</p>
+
+    <p>Un identifiant unique est attribu&eacute; &agrave; chaque requ&ecirc;te
afin de
+    pouvoir l'identifier. Cette identifiant l&eacute;gal peut faire l'objet
+    d'un enregistrement dans le journal standard en utilisant l'&eacute;l&eacute;ment
+    de cha&icirc;ne de format <code>%{forensic-id}n</code>. Si vous utilisez
+    <module>mod_unique_id</module>, c'est l'identifiant qu'il g&eacute;n&egrave;re
qui
+    sera utilis&eacute;.</p>
+
+    <p>La premi&egrave;re partie de la journalisation de la requ&ecirc;te enregistre
+    l'identifiant l&eacute;gal, la ligne de la requ&ecirc;te et tous les en-t&ecirc;tes
+    re&ccedil;us s&eacute;par&eacute;s par des caract&egrave;res pipe (<code>|</code>).
Voici &agrave;
+    titre d'exemple &agrave; quoi pourrait ressembler une telle entr&eacute;e (tout
+    &eacute;tant rassembl&eacute; sur une seule ligne) :</p>
+
+    <example>
+        +yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif
+        HTTP/1.1|Host:localhost%3a8080|User-Agent:Mozilla/5.0 (X11;
+        U; Linux i686; en-US; rv%3a1.6) Gecko/20040216
+        Firefox/0.8|Accept:image/png, <var>etc...</var>
+    </example>
+
+    <p>Le caract&egrave;re plus ('+') de d&eacute;but indique qu'il s'agit
de la
+    premi&egrave;re entr&eacute;e de journal pour cette requ&ecirc;te. La seconde
entr&eacute;e ne
+    contiendra qu'un caract&egrave;re moins ('-') suivi de l'identifiant :</p>
+
+    <example>
+      -yQtJf8CoAB4AAFNXBIEAAAAA
+    </example>
+
+    <p>Le script <code>check_forensic</code> prend comme argument le nom
+    du fichier journal. Il recherche ces paires d'identifiants
+    <code>+</code>/<code>-</code> et affiche un message d'erreur
si la
+    journalisation d'une requ&ecirc;te n'est pas compl&egrave;te.</p>
+</section>
+
+<section id="security"><title>Consid&eacute;rations &agrave; propos de
+s&eacute;curit&eacute;</title>
+    <p>Voir le document <a
+    href="../misc/security_tips.html#serverroot">conseils en mati&egrave;re de
+    s&eacute;curit&eacute;</a> pour des d&eacute;tails sur les raisons
pour lesquelles votre
+    s&eacute;curit&eacute; pourrait &ecirc;tre compromise si le r&eacute;pertoire
dans lequel les
+    fichiers journaux sont stock&eacute;s sont inscriptibles par tout autre
+    utilisateur que celui qui d&eacute;marre le serveur.</p>
+    <p>Les fichiers journaux peuvent contenir des donn&eacute;es sensibles
+    comme le contenu des en-t&ecirc;tes <code>Authorization:</code> (qui
+    peuvent contenir des mots de passe) ; ils ne doivent donc &ecirc;tre
+    lisibles que par l'utilisateur qui d&eacute;marre le serveur.</p>
+</section>
+
+<directivesynopsis>
+<name>ForensicLog</name>
+<description>D&eacute;finit le nom de fichier du journal l&eacute;gal</description>
+<syntax>ForensicLog <var>nom-fichier</var>|<var>pipe</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+
+<usage>
+    <p>La directive <directive>ForensicLog</directive> permet de
+    contr&ocirc;ler la journalisation des requ&ecirc;tes &agrave; des fins d'analyse
+    l&eacute;gale. Chaque entr&eacute;e du journal se voit assigner un identifiant
+    unique qui peut &ecirc;tre associ&eacute; &agrave; la requ&ecirc;te en
utilisant la directive
+    <directive module="mod_log_config">CustomLog</directive> habituelle.
+    <module>mod_log_forensic</module> cr&eacute;e un &eacute;l&eacute;ment
nomm&eacute;
+    <code>forensic-id</code>, qui peut &ecirc;tre ajout&eacute; au journal
standard
+    en utilisant l'&eacute;l&eacute;ment de format <code>%{forensic-id}n</code>.</p>
+
+    <p>L'argument, qui permet de sp&eacute;cifier l'emplacement vers lequel le
+    journal l&eacute;gal sera &eacute;crit, peut contenir les deux types de valeurs
+    suivants :</p>
+
+    <dl>
+      <dt><var>nom-fichier</var></dt>
+      <dd>Un nom de fichier relatif au r&eacute;pertoire d&eacute;fini par
la
+      directive <directive module="core">ServerRoot</directive>.</dd>
+
+      <dt><var>pipe</var></dt>
+      <dd>Le caract&egrave;re pipe "<code>|</code>", suivi du chemin
vers un
+      programme qui recevra les informations de la journalisation sur
+      son entr&eacute;e standard. Le nom du programme peut &ecirc;tre relatif au
+      r&eacute;pertoire d&eacute;fini par la directive <directive
+      module="core">ServerRoot</directive>.
+
+      <note type="warning"><title>S&eacute;curit&eacute; :</title>
+      <p>Si les journaux sont redirig&eacute;s vers un programme, ce dernier
+      s'ex&eacute;cutera sous l'utilisateur qui a d&eacute;marr&eacute;
+      <program>httpd</program>. Ce sera l'utilisateur root si le serveur
+      a &eacute;t&eacute; d&eacute;marr&eacute; par root ; v&eacute;rifiez
que le programme est
+      s&eacute;curis&eacute; ou passe sous le contr&ocirc;le d'un utilisateur
poss&eacute;dant des
+      droits restreints.</p>
+      </note>
+
+      <note><title>Note</title>
+        <p>Lors de la sp&eacute;cification d'un chemin de fichier sur les
+	plate-formes non-Unix, il faut prendre soin de ne pas oublier
+	que seuls les slashes directs doivent &ecirc;tre utilis&eacute;s, m&ecirc;me
si la
+	plate-forme autorise l'emploi d'anti-slashes. D'une mani&egrave;re
+	g&eacute;n&eacute;rale, c'est une bonne id&eacute;e que de n'utiliser que des
slashes
+	directs dans les fichiers de configuration.</p>
+      </note></dd>
+    </dl>
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.meta?rev=1686720&r1=1686719&r2=1686720&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_log_forensic.xml.meta Sun Jun 21 13:48:14 2015
@@ -8,7 +8,6 @@
 
   <variants>
     <variant>en</variant>
-    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
     <variant outdated="yes">tr</variant>
   </variants>

Modified: httpd/httpd/trunk/docs/manual/upgrading.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/upgrading.html.fr?rev=1686720&r1=1686719&r2=1686720&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/upgrading.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/upgrading.html.fr Sun Jun 21 13:48:14 2015
@@ -26,8 +26,6 @@
 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en"
rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="./fr/upgrading.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>Afin d'assister les utilisateurs lors de leurs opérations de mise à
   jour, nous maintenons un document
@@ -92,7 +90,7 @@ fonctionnalités du serveur HTTP Apache
 
       <li>configure: par défaut, seul un jeu de modules de base est
       chargé. Les autres directives <code class="directive">LoadModule</code>
-      sont mises en commentaires.</li>
+      sont mises en commentaires dans le fichier de configuration.</li>
 
       <li>configure: le jeu de modules "most" est compilé par défaut</li>
 
@@ -142,7 +140,7 @@ nécessiter une mise à jour des fichier
       requête était assuré via les directives <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>,
<code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code>,
<code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code>,
et <code class="directive"><a href="./mod/mod_access_compat.html#satisfy">Satisfy</a></code>.</p>
 
       <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
-      contrôle d'autorisation, via le nouveau module
+      contrôle d'autorisation, par le nouveau module
       <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>.
Bien que le module
       <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code>
soit fourni à des fins de
       compatibilité avec les anciennes configurations, les anciennes
@@ -284,9 +282,10 @@ Allow from example.org</pre>
 
 	<li><code class="module"><a href="./mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>:
certaines applications web
 	ne fonctionneront plus correctement avec la nouvelle
-	configuration de <code>PATH_INFO</code> qui est différente de
-	celle de la version 2.2. La configuration précédente peut être
-	restaurée en définissant la variable
+	configuration de <code>PATH_INFO</code> qui est différente de
+	celle de la version 2.2. La configuration
+	précédente peut être
+	restaurée en définissant la variable
 	<code>proxy-scgi-pathinfo</code>.</li>
 
 	<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>:
le contrôle de révocation des
@@ -383,7 +382,7 @@ Allow from example.org</pre>
 
     <p>De nombreux modules tiers conçus pour la version 2.2
     fonctionneront sans changement avec le serveur HTTP Apache
-    version 2.4. Certains nécessiterons cependant des modifications ; se
+    version 2.4. Certains nécessiteront cependant des modifications ; se
     reporter à la vue d'ensemble <a href="developer/new_api_2_4.html">Mise à jour
de l'API</a>.</p>
   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"
/></a></div>
 <div class="section">

Modified: httpd/httpd/trunk/docs/manual/upgrading.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/upgrading.xml.fr?rev=1686720&r1=1686719&r2=1686720&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/upgrading.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/upgrading.xml.fr Sun Jun 21 13:48:14 2015
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1683198:1686712 (outdated) -->
+<!-- English Revision: 1686712 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -85,7 +85,7 @@ fonctionnalit&eacute;s du serveur HTTP A
 
       <li>configure: par d&eacute;faut, seul un jeu de modules de base est
       charg&eacute;. Les autres directives <directive>LoadModule</directive>
-      sont mises en commentaires.</li>
+      sont mises en commentaires dans le fichier de configuration.</li>
 
       <li>configure: le jeu de modules "most" est compil&eacute; par d&eacute;faut</li>
 
@@ -144,7 +144,7 @@ n&eacute;cessiter une mise &agrave; jour
       module="mod_access_compat">Satisfy</directive>.</p>
 
       <p>Dans la version 2.4, ce contr&ocirc;le d'acc&egrave;s est assur&eacute;,
comme tout
-      contr&ocirc;le d'autorisation, via le nouveau module
+      contr&ocirc;le d'autorisation, par le nouveau module
       <module>mod_authz_host</module>. Bien que le module
       <module>mod_access_compat</module> soit fourni &agrave; des fins de
       compatibilit&eacute; avec les anciennes configurations, les anciennes
@@ -323,9 +323,10 @@ Allow from example.org
 
 	<li><module>mod_proxy_scgi</module>: certaines applications web
 	ne fonctionneront plus correctement avec la nouvelle
-	configuration de <code>PATH_INFO</code> qui est différente de
-	celle de la version 2.2. La configuration précédente peut être
-	restaurée en définissant la variable
+	configuration de <code>PATH_INFO</code> qui est diff&eacute;rente de
+	celle de la version 2.2. La configuration
+	pr&eacute;c&eacute;dente peut &ecirc;tre
+	restaur&eacute;e en d&eacute;finissant la variable
 	<code>proxy-scgi-pathinfo</code>.</li>
 
 	<li><module>mod_ssl</module>: le contr&ocirc;le de r&eacute;vocation
des
@@ -429,7 +430,7 @@ Allow from example.org
 
     <p>De nombreux modules tiers con&ccedil;us pour la version 2.2
     fonctionneront sans changement avec le serveur HTTP Apache
-    version 2.4. Certains n&eacute;cessiterons cependant des modifications ; se
+    version 2.4. Certains n&eacute;cessiteront cependant des modifications ; se
     reporter &agrave; la vue d'ensemble <a
     href="developer/new_api_2_4.html">Mise &agrave; jour de l'API</a>.</p>
   </section>

Modified: httpd/httpd/trunk/docs/manual/upgrading.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/upgrading.xml.meta?rev=1686720&r1=1686719&r2=1686720&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/upgrading.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/upgrading.xml.meta Sun Jun 21 13:48:14 2015
@@ -8,6 +8,6 @@
 
   <variants>
     <variant>en</variant>
-    <variant outdated="yes">fr</variant>
+    <variant>fr</variant>
   </variants>
 </metafile>



Mime
View raw message