granicus.if.org Git - apache/blob - docs/manual/mod/mod_log_forensic.xml.tr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
   4 <!-- English Revision: 1174747:1421821 (outdated) -->
   5 <!-- =====================================================
   6  Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
   7    Reviewed by: Orhan Berent <berent belgeler.org>
   8 ========================================================== -->
   9
  10 <!--
  11  Licensed to the Apache Software Foundation (ASF) under one or more
  12  contributor license agreements.  See the NOTICE file distributed with
  13  this work for additional information regarding copyright ownership.
  14  The ASF licenses this file to You under the Apache License, Version 2.0
  15  (the "License"); you may not use this file except in compliance with
  16  the License.  You may obtain a copy of the License at
  17
  18      http://www.apache.org/licenses/LICENSE-2.0
  19
  20  Unless required by applicable law or agreed to in writing, software
  21  distributed under the License is distributed on an "AS IS" BASIS,
  22  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  23  See the License for the specific language governing permissions and
  24  limitations under the License.
  25 -->
  26
  27 <modulesynopsis metafile="mod_log_forensic.xml.meta">
  28
  29 <name>mod_log_forensic</name>
  30 <description>Sunucuya yapılan isteklerin adli günlük kayıtlarının tutulması</description>
  31 <status>Extension</status>
  32 <sourcefile>mod_log_forensic.c</sourcefile>
  33 <identifier>log_forensic_module</identifier>
  34 <compatibility>2.1 sürümünden beri <module>mod_unique_id</module> gerekmemektedir.</compatibility>
  35
  36 <summary>
  37     <p>Bu modül istemci isteklerinin adli günlük kayıtlarının tutulmasını
  38       sağlar. Günlük kaydı bir istek işlenmeden önce ve sonra olmak üzere iki
  39       kere yapılır, böylece günlükte her istek için iki girdi bulunur. Adli
  40       günlükleyici çok sıkı kurallara tabidir, yani:</p>
  41
  42     <ul>
  43     <li>Biçem sabittir. Günlük kayıt biçemi çalışma anında değiştirilemez.</li>
  44     <li>Veriyi yazamadığı takdirde çocuk süreç beklemeksizin çıkar ve
  45       (<directive module="mpm_common" >CoreDumpDirectory</directive>
  46       yapılandırmasına bağlı olarak) bir core dosyası dökümler.</li>
  47     </ul>
  48
  49     <p>Dağıtımın <code>support</code> dizininde bulunan
  50       <code>check_forensic</code> betiği adli günlük dosyalarının
  51       değerlendirilmesinde yardımcı olabilir.</p>
  52 </summary>
  53 <seealso><a href="../logs.html">Apache Günlük Dosyaları</a></seealso>
  54 <seealso><module>mod_log_config</module></seealso>
  55
  56 <section id="formats"><title>Adli Günlük Biçemi</title>
  57     <p>Her istek günlüğe iki defa kaydedilir. İlki, işlemin başlangıcında
  58       (yani, başlıklar alındıktan hemen sonra), ikincisi ise istek işlem
  59       gördükten sonra normal günlüklemenin yapıldığı sırada yapılır.</p>
  60
  61     <p>Her isteği betimlemek için eşsiz bir istek kimliği atanır. Bu adli
  62       kimliğin normal günlüğe de yazılması istenirse bu
  63       <code>%{forensic-id}n</code> biçem dizgesi ile yapılabilir.
  64       <module>mod_unique_id</module> kullanılıyorsa, onun ürettiği kimlik
  65       kullanılır.</p>
  66
  67     <p>İlk satır günlüğe, adli kimliği, istek satırını ve alınan tüm
  68       başlıkları boru karakterleri (<code>|</code>) ile ayrılmış olarak
  69       kaydeder. Aşağıda bir örneğe yer verilmiştir (hepsi bir satırdadır):</p>
  70
  71     <example>
  72         +yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif
  73         HTTP/1.1|Host:localhost%3a8080|User-Agent:Mozilla/5.0 (X11;
  74         U; Linux i686; en-US; rv%3a1.6) Gecko/20040216
  75         Firefox/0.8|Accept:image/png, <var>etc...</var>
  76     </example>
  77
  78     <p>Başlangıçtaki artı imi bu günlük satırının istekle ilgili ilk günlük
  79       kaydı olduğunu belirtir. İkinci satırda bunun yerini bir eksi imi
  80       alır:</p>
  81
  82     <example>
  83       -yQtJf8CoAB4AAFNXBIEAAAAA
  84     </example>
  85
  86     <p><code>check_forensic</code> betiği komut satırı argümanı olarak günlük
  87       dosyasının ismini alır. Bu <code>+</code>/<code>-</code> kimlik
  88       çiftlerine bakarak tamamlanmamış istekler varsa bunlar hakkında
  89       uyarır.</p>
  90 </section>
  91
  92 <section id="security"><title>Güvenlik Kaygıları</title>
  93     <p>Günlük dosyarının kaydedildiği dizine sunucuyu başlatan kullanıcı
  94       dışında diğer kullanıcılar tarafından yazılabiliyor olması halinde
  95       güvenliğinizden nasıl feragat etmiş olacağınız <a
  96       href="../misc/security_tips.html#serverroot">güvenlik ipuçları</a>
  97       belgesinde açıklanmıştır.</p>
  98 </section>
  99
 100 <directivesynopsis>
 101 <name>ForensicLog</name>
 102 <description>Adli günlük için dosya ismini belirler.</description>
 103 <syntax>ForensicLog <var>dosya-adı</var>|<var>borulu-süreç</var></syntax>
 104 <contextlist><context>server config</context><context>virtual host</context>
 105 </contextlist>
 106
 107 <usage>
 108     <p><directive>ForensicLog</directive> yönergesi adli inceleme için
 109       sunucuya yapılan istekleri günlüğe kaydetmekte kullanılır. Her günlük
 110       girdisine, normal <directive module="mod_log_config"
 111       >CustomLog</directive> yönergesinde kullanılarak istekle
 112       ilişkilendirilebilen eşsiz bir kimlik atanır.
 113       <module>mod_log_forensic</module> modülü, aktarım günlüğünün biçem
 114       dizgesinde <code>%{forensic-id}n</code> şeklinde kullanılmak üzere
 115       <code>forensic-id</code> adı verilen bir dizgecik oluşturur.</p>
 116
 117     <p>Günlüğün yazılacağı yeri belirleyen argüman şu iki değerden birini
 118       alabilir:</p>
 119
 120     <dl>
 121       <dt><var>dosya-adı</var></dt>
 122       <dd><directive module="core" >ServerRoot</directive> yönergesinin
 123         değerine göreli bir dosya ismi.</dd>
 124
 125       <dt><var>borulu-süreç</var></dt>
 126       <dd>"<code>|</code>" boru karakteri ile öncelenmiş olarak günlük
 127         bilgisini standart girdisinden kabul edecek sürecin ismi (veya komut
 128         satırı). Program adının <directive module="core"
 129         >ServerRoot</directive> yönergesinin değerine göre belirtildiği
 130         varsayılır.
 131
 132       <note type="warning"><title>Güvenlik:</title>
 133       <p>Bir borulu süreç kullanılmışsa, süreç <program>httpd</program>’yi
 134         başlatan kullanıcı tarafından başlatılacaktır. Sunucu root tarafından
 135         başlatılıyorsa bu root olacaktır; bu bakımdan günlük kaydını alacak
 136         programın güvenilir olması veya daha az yetkili bir kullanıcıya geçiş
 137         yapması önemlidir.</p>
 138       </note>
 139
 140       <note type="warning"><title>Bilginize</title>
 141         <p>Dosya yolunu belirtirken tersbölü çizgisi kullanılan Unix dışı
 142           platformlarda bile yapılandırma dosyasında bu amaçla normal bölü
 143           çizgilerini kullanmaya özen gösterilmelidir.</p>
 144       </note></dd>
 145     </dl>
 146 </usage>
 147 </directivesynopsis>
 148
 149 </modulesynopsis>