/usr/share/doc/lire/user-manual/ch03s05.html is in lire-doc 2:2.1.1-2.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Sending Anonymized Log Files To A Responder</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Lire User's Manual"><link rel="up" href="ch03.html" title="Chapter 3. Running Lire"><link rel="prev" href="ch03s04.html" title="Merging Reports"><link rel="next" href="ch03s06.html" title="Running Lire In A Server Cluster"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Sending Anonymized Log Files To A Responder</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s04.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Running <span class="application">Lire</span></th><td width="20%" align="right"> <a accesskey="n" href="ch03s06.html">Next</a></td></tr></table><hr></div><div class="section" title="Sending Anonymized Log Files To A Responder"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect:sending-anonymized-log"></a>Sending Anonymized Log Files To A Responder</h2></div></div></div><p>For more privacy, you can anonymize your log somewhat
before sending it to a responder. <span class="application">Lire</span> includes a command
called <span class="command"><strong>lr_anonymize</strong></span> which will transform
everything that looks like an IP address, an email or a
domain name into an anonymized form
(<code class="systemitem">10.0.0.1</code>,
<code class="systemitem">2.0.0.10.in-addr.arpa</code>,
<code class="systemitem">11.example.com</code>,
<code class="email"><<a class="email" href="mailto:john.doe@2.example.com">john.doe@2.example.com</a>></code>, etc.) The mapping
between the real value and its anonymized form is saved in a disk
database so that you can reverse the process when you
receive the report from the responder.
</p><p>The procedure is quite simple, you just have to filter
your log file through <span class="command"><strong>lr_anonymize</strong></span> and
make sure that the subject of your email starts with
<code class="constant">anon</code>.
</p><div class="example"><a name="id382090"></a><p class="title"><b>Example 3.5. Sending An Anonymized Postfix Log File To A Responder</b></p><div class="example-contents"><p>To send an anonymized postfix log file to the
Stichting LogReport Foundation responder, you would use a command like:
</p><pre class="screen">
<code class="prompt">$ </code> grep ' postfix/' /var/log/mail.log | \
lr_run lr_anonymize /tmp/anon | \
mail -s "anon Daily Report" log@postfix.logreport.org
</pre><p>The <code class="filename">/tmp/anon</code> is the database
that is used to save the mapping between the real and
anonymized values.
</p></div></div><br class="example-break"><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><span class="command"><strong>lr_anonymize</strong></span> will overwrite the
content of that database, so if you reuse the database,
make sure that you don't have two concurrent requests to a
responder because you will lose the first mappings!
</p></div><div class="section" title="Processing The Responder's Results"><div class="titlepage"><div><div><h3 class="title"><a name="id382134"></a>Processing The Responder's Results</h3></div></div></div><p>The responder will generate a report in an XML format
specific to <span class="application">Lire</span>. To obtain a "normal" report from this,
you first deanonymize it, then run the appropriate converter
on the deanonymized report. You use the
<span class="command"><strong>lr_xml2report</strong></span> command to convert a XML
report to one of the available output formats.
</p><p>You can list the output-formats available on your
system by running <strong class="userinput"><code>lr_xml2report --help
output-formats</code></strong>.
</p><div class="example"><a name="id382165"></a><p class="title"><b>Example 3.6. Deanonymizing and Generating A HTML Report</b></p><div class="example-contents"><p>To generate a HTML report from the XML report you
received from the responder, you would use the following command:
</p><pre class="screen">
<code class="prompt">$ </code> lr_run lr_deanonymize /tmp/anon < /tmp/anon-report.xml > /tmp/report.xml
<code class="prompt">$ </code> lr_xml2report --output html /tmp/report.xml /tmp/report.html
</pre></div></div><br class="example-break"></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Merging Reports </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Running <span class="application">Lire</span> In A Server Cluster</td></tr></table></div></body></html>
|