granicus.if.org Git - apache/blob - docs/manual/mod/mod_log_forensic.html.fr.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
   4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_log_forensic - Serveur HTTP Apache Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  21 <p class="apache">Serveur HTTP Apache Version 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <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.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Module Apache mod_log_forensic</h1>
  28 <div class="toplang">
  29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_forensic.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_log_forensic.html" title="Français">&nbsp;fr&nbsp;</a> |
  31 <a href="../ja/mod/mod_log_forensic.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  32 <a href="../tr/mod/mod_log_forensic.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  33 </div>
  34 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Journalisation légale des requêtes envoyées au
  35 serveur</td></tr>
  36 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  37 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>log_forensic_module</td></tr>
  38 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_log_forensic.c</td></tr></table>
  39 <h3>Sommaire</h3>
  40
  41     <p>Ce module permet la journalisation légale des requêtes client.</p>
  42
  43     <p>La création du fichier journal correspondant s'effectue via la
  44     directive <code class="directive">ForensicLog</code> comme suit :</p>
  45
  46     <pre class="prettyprint lang-config">ForensicLog logs/forensic_log</pre>
  47
  48
  49     <p>La journalisation s'effectuant avant et après le traitement de la
  50     requête, le journal légal contient deux lignes pour chaque requête.
  51     Le processus de journalisation légale est très strict, à savoir
  52     :</p>
  53
  54     <ul>
  55     <li>Le format est figé. Vous ne pouvez pas modifier le format du
  56     journal à l'exécution.</li>
  57     <li>S'il ne peut pas enregistrer ses données, le processus enfant se
  58     termine aussitôt, et peut éventuellement enregistrer un vidage
  59     mémoire (selon la définition de la directive <code class="directive"><a href="../mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code>).</li>
  60     </ul>
  61
  62     <p>Pour interpréter les données du journal
  63     légal afin d'identifier les requêtes dont le traitement n'a
  64     pas été mené à bien, vous pouvez vous
  65     aider du script <code>check_forensic</code> qui se trouve dans le
  66     répertoire support de la distribution.</p>
  67
  68     <div class="example"><p><code>
  69     check-forensic forensic_log
  70     </code></p></div>
  71
  72     <div class="note">Note de traduction : le terme "légal" utilisé dans le présent document ne suggère aucunement que
  73     ce module apporte une valeur juridique aux journaux. Il est à comprendre dans le contexte
  74     similaire à ce que l'on trouve en analyse medico-légale. En d'autres termes, la finalité de ce module
  75     est de simplifier les opérations d'investigation autour du traitement des requêtes par le serveur.</div>
  76 </div>
  77 <div id="quickview"><h3>Sujets</h3>
  78 <ul id="topics">
  79 <li><img alt="" src="../images/down.gif" /> <a href="#formats">Format du journal Forensic</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de
  81 sécurité</a></li>
  82 </ul><h3 class="directives">Directives</h3>
  83 <ul id="toc">
  84 <li><img alt="" src="../images/down.gif" /> <a href="#forensiclog">ForensicLog</a></li>
  85 </ul>
  86 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_log_forensic">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_log_forensic">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
  87 <ul class="seealso">
  88 <li><a href="../logs.html">Les fichiers journaux
  89 d'Apache</a></li>
  90 <li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li>
  91 <li><a href="#comments_section">Commentaires</a></li></ul></div>
  92 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  93 <div class="section">
  94 <h2><a name="formats" id="formats">Format du journal Forensic</a><a title="Lien permanent" href="#formats" class="permalink">&para;</a></h2>
  95     <p>Chaque requête fait l'objet d'une double journalisation. La
  96     requête est journalisée une première fois avant son traitement
  97     (c'est à dire après la réception des en-têtes). La deuxième entrée
  98     du journal est écrite <em>après</em> le traitement de la requête, en
  99     fait au moment de la journalisation habituelle.</p>
 100
 101     <p>Un identifiant unique est attribué à chaque requête afin de
 102     pouvoir l'identifier. Cette identifiant légal peut faire l'objet
 103     d'un enregistrement dans le journal standard en utilisant l'élément
 104     de chaîne de format <code>%{forensic-id}n</code>. Si vous utilisez
 105     <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code>, c'est l'identifiant qu'il génère qui
 106     sera utilisé.</p>
 107
 108     <p>La première partie de la journalisation de la requête enregistre
 109     l'identifiant légal, la ligne de la requête et tous les en-têtes
 110     reçus séparés par des caractères pipe (<code>|</code>). Voici à
 111     titre d'exemple à quoi pourrait ressembler une telle entrée (tout
 112     étant rassemblé sur une seule ligne) :</p>
 113
 114     <div class="example"><p><code>
 115         +yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif
 116         HTTP/1.1|Host:localhost%3a8080|User-Agent:Mozilla/5.0 (X11;
 117         U; Linux i686; en-US; rv%3a1.6) Gecko/20040216
 118         Firefox/0.8|Accept:image/png, <var>etc...</var>
 119     </code></p></div>
 120
 121     <p>Le caractère plus ('+') de début indique qu'il s'agit de la
 122     première entrée de journal pour cette requête. La seconde entrée ne
 123     contiendra qu'un caractère moins ('-') suivi de l'identifiant :</p>
 124
 125     <div class="example"><p><code>
 126       -yQtJf8CoAB4AAFNXBIEAAAAA
 127     </code></p></div>
 128
 129     <p>Le script <code>check_forensic</code> prend comme argument le nom
 130     du fichier journal. Il recherche ces paires d'identifiants
 131     <code>+</code>/<code>-</code> et affiche un message d'erreur si la
 132     journalisation d'une requête n'est pas complète.</p>
 133 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 134 <div class="section">
 135 <h2><a name="security" id="security">Considérations à propos de
 136 sécurité</a><a title="Lien permanent" href="#security" class="permalink">&para;</a></h2>
 137     <p>Voir le document <a href="../misc/security_tips.html#serverroot">conseils en matière de
 138     sécurité</a> pour des détails sur les raisons pour lesquelles votre
 139     sécurité pourrait être compromise si le répertoire dans lequel les
 140     fichiers journaux sont stockés sont inscriptibles par tout autre
 141     utilisateur que celui qui démarre le serveur.</p>
 142     <p>Les fichiers journaux peuvent contenir des données sensibles
 143     comme le contenu des en-têtes <code>Authorization:</code> (qui
 144     peuvent contenir des mots de passe) ; ils ne doivent donc être
 145     lisibles que par l'utilisateur qui démarre le serveur.</p>
 146 </div>
 147 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 148 <div class="directive-section"><h2><a name="forensiclog" id="forensiclog">Directive</a> <a name="ForensicLog" id="ForensicLog">ForensicLog</a><a title="Lien permanent" href="#forensiclog" class="permalink">&para;</a></h2>
 149 <table class="directive">
 150 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom de fichier du journal légal</td></tr>
 151 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForensicLog <var>nom-fichier</var>|<var>pipe</var></code></td></tr>
 152 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 153 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 154 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_forensic</td></tr>
 155 </table>
 156     <p>La directive <code class="directive">ForensicLog</code> permet de
 157     contrôler la journalisation des requêtes à des fins d'analyse
 158     légale. Chaque entrée du journal se voit assigner un identifiant
 159     unique qui peut être associé à la requête en utilisant la directive
 160     <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> habituelle.
 161     <code class="module"><a href="../mod/mod_log_forensic.html">mod_log_forensic</a></code> crée un élément nommé
 162     <code>forensic-id</code>, qui peut être ajouté au journal standard
 163     en utilisant l'élément de format <code>%{forensic-id}n</code>.</p>
 164
 165     <p>L'argument, qui permet de spécifier l'emplacement vers lequel le
 166     journal légal sera écrit, peut contenir les deux types de valeurs
 167     suivants :</p>
 168
 169     <dl>
 170       <dt><var>nom-fichier</var></dt>
 171       <dd>Un nom de fichier relatif au répertoire défini par la
 172       directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd>
 173
 174       <dt><var>pipe</var></dt>
 175       <dd>Le caractère pipe "<code>|</code>", suivi du chemin vers un
 176       programme qui recevra les informations de la journalisation sur
 177       son entrée standard. Le nom du programme peut être relatif au
 178       répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.
 179
 180       <div class="warning"><h3>Sécurité :</h3>
 181       <p>Si les journaux sont redirigés vers un programme, ce dernier
 182       s'exécutera sous l'utilisateur qui a démarré
 183       <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Ce sera l'utilisateur root si le serveur
 184       a été démarré par root ; vérifiez que le programme est
 185       sécurisé ou passe sous le contrôle d'un utilisateur possédant des
 186       droits restreints.</p>
 187       </div>
 188
 189       <div class="note"><h3>Note</h3>
 190         <p>Lors de la spécification d'un chemin de fichier sur les
 191         plate-formes non-Unix, il faut prendre soin de ne pas oublier
 192         que seuls les slashes directs doivent être utilisés, même si la
 193         plate-forme autorise l'emploi d'anti-slashes. D'une manière
 194         générale, c'est une bonne idée que de n'utiliser que des slashes
 195         directs dans les fichiers de configuration.</p>
 196       </div></dd>
 197     </dl>
 198
 199 </div>
 200 </div>
 201 <div class="bottomlang">
 202 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_forensic.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 203 <a href="../fr/mod/mod_log_forensic.html" title="Français">&nbsp;fr&nbsp;</a> |
 204 <a href="../ja/mod/mod_log_forensic.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 205 <a href="../tr/mod/mod_log_forensic.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 206 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 207 <script type="text/javascript"><!--//--><![CDATA[//><!--
 208 var comments_shortname = 'httpd';
 209 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_log_forensic.html';
 210 (function(w, d) {
 211     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 212         d.write('<div id="comments_thread"><\/div>');
 213         var s = d.createElement('script');
 214         s.type = 'text/javascript';
 215         s.async = true;
 216         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 217         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 218     }
 219     else {
 220         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 221     }
 222 })(window, document);
 223 //--><!]]></script></div><div id="footer">
 224 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 225 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 226 if (typeof(prettyPrint) !== 'undefined') {
 227     prettyPrint();
 228 }
 229 //--><!]]></script>
 230 </body></html>