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