.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "FW1_LEA2DLF.IN 1" .TH FW1_LEA2DLF.IN 1 2025-09-28 "Lire 2.1.1" "LogReport's Lire Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" fw1_lea2dlf \- تبدیل لاگ‌های Check Point FireWall\-1 NG به قالب DLF فایروال .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBfw1_lea2dlf\fR \fIfile\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBfw1_lea2dlf\fR لاگ‌های Check Point FireWall\-1 NG را به قالب DLF فایروال تبدیل می‌کند. ورودی این مبدل، خروجی ابزار fw1\-loggrabber است که یک کلاینت ساده برای LEA (رابط خروجی لاگ یا Log Export Api) محسوب می‌شود. .SH "دستورالعمل‌های فعال‌سازی (ACTIVATION INSTRUCTIONS)" .IX Header "ACTIVATION INSTRUCTIONS" این مبدل DLF به صورت پیش‌فرض در Lire فعال نیست. این ابزار به ماژول پرل Date::Manip و ابزار fw1\-loggrabber نیاز دارد. ماژول Date::Manip را می‌توان از CPAN نصب کرد. ابزار fw1\-loggrabber نیز از نشانی در دسترس است. .PP اگر هر دوی این مؤلفه‌ها نصب شده باشند، می‌توانید با خارج کردن خط مربوط به آن از حالت توضیح (uncomment) در فایل \&\f(CW@sysconfdir\fR@/@PACKAGE@/address.cf مبدل DLF با نام fw1_lea را فعال کنید. .SH "نکات دیگر (OTHER NOTES)" .IX Header "OTHER NOTES" هشدار! در صورتی که هشدارهای فراوانی مبنی بر ایراد در نویسه‌های UTF\-8 دریافت می‌کنید که ظاهری شبیه به زیر دارند: .PP .Vb 4 \& all all UNSET fw1_lea2dlf warning Malformed UTF\-8 character \& (unexpected non\-continuation byte 0x7a, immediately after \& start byte 0xe3) at /usr/lib/perl5/vendor_perl/5.8.0/Date/Manip.pm \& line 5931. .Ve .PP و محلی‌سازی (locale) سیستم شما بر روی UTF\-8 تنظیم شده است، یک راهکار موقت وجود دارد: متغیرهای محیطی LANG و LC_CTYPE را به جای مثلاً en_US.UTF\-8 بر روی en_US تنظیم کنید. می‌توانید این کار را به طور موقت در هنگام فراخوانی مبدل انجام دهید: .PP .Vb 1 \& LANG=en_US LC_CTYPE=en_US ./fw12dlf < /your/log/file .Ve .SH "ابزار fw1\-loggrabber (FW1\-LOGGRABBER)" .IX Header "fw1-loggrabber" ابزار fw1\-loggrabber با استفاده از کیت توسعه نرم‌افزار (SDK) مربوط به OPSEC ساخته شده است. چارچوب OPSEC (سرنام Open Platform for Security، ) یک چارچوب امنیتی باز و چندفروشنده‌ای است. .PP در ادامه نکاتی دربارهٔ fw1\-loggrabber نقل شده است: .PP .Vb 2 \& ******************************************************** \& FW1\-LOGGRABBER \& \& Author: Torsten Fellhauer \& current Version: 1.0 \& ******************************************************** \& \& 1) Prerequisites \& 2) How to Build \& 3) How to Use \& 4) Change History \& \& ******************************************************** \& \& 1) Prerequisites \& \& a) for running FW1\-LOGGRABBER \& \& FW1\-LOGGRABBER is statically linked and can therefore be \& run on the following systems: \& * Linux (Tested distributions are Red Hat, SuSE and De\- \& bian with Kernel Versions 2.2.x and 2.4.x) \& * Solaris SPARC (Tested versions are Solaris 8 and 9) \& * Windows NT/2000/XP (currently no W32 of FW1\-LOGGRABBER \& is available yet and therefore not yet tested) \& \& b) for building FW1\-LOGGRABBER \& \& FW1\-LOGGRABBER uses API\-functions from Checkpoints\*(Aq \& OPSEC SDK. In order to be able to build applications \& which are using this SDK, a very special build environ\- \& ment has to be used. Currently building FW1\-LOGGRABBER is \& supported only for Solaris SPARC platform and the Linux \& platform. \& * Linux \& \- Red Hat 6.2 \& \- gcc 2.95.1 \& \- Checkpoint OPSEC SDK NG\-FP3 for Linux 2.2 \& * Solaris SPARC \& \- Solaris 8 \& \- gcc 2.95.2 \& \- Checkpoint OPSEC SDK NG\-FP3 for Solaris SPARC \& * Windows \& \- EDITME \& \& 3) How to Use \& \& a) Configure FW1 to enable LEA\-Protocol \& \& In order to be able to use this tool with a Checkpoint \& FW\-1 installation, the following tasks have to be done: \& \& * modify $FWDIR/conf/fwopsec.conf and define the port \& for unauthenticated lea connections. \& # lea_server auth_port 18184 \& lea_server port 50001 \& * bounce FW1 (cpstop / cpstart) to activate changes \& * add rule to policy to enable connections on port \& 50001 to the FW\-1 Management\-Server \& \& \& b) Usage of FW1\-LOGGRABBER \& \& FW1\-LOGGRABBER is statically linked and therefore not \& dependent of OPSEC libraries. The binary can be run on \& any Linux or Solaris SPARC system. \& \& Command\-Line Options: \& \-s IP\-Address of FW1\-Management\-Server \& \-p unauthenticated LEA\-Port of FW1\-Server \& \-f exact name of FW1\-Logfile or pattern to \& be matched on FW1\-Logfiles. \& \-\-resolve Resolve IP\-Addresses to Names \& \-\-noresolve Do not resolve IP\-Addresses to Names \& \-\-showfiles Only show available FW1\-Logfiles and exit. \& \-\-debug Enable debug\-mode of FW1\-LOGGRABBER \& \& Examples: \& o fw1\-loggrabber \-s 192.168.2.254 \-p 50001 \-\-showfiles \& \& Show all logfiles that are available on the FW1\-Manage\- \& ment\-Server with the IP\-Address 192.168.2.254. The LEA\- \& Port the Management\-Server is listening for unauthenti\- \& cated connections is 50001. \& \& o fw1\-loggrabber \-s 192.168.2.254 \-p 50001 \& \& Show all logentries of the default FW1\-Logfile (fw.log) \& on the FW1\-Management\-Server with the IP\-Address \& 192.168.2.254 and the LEA\-Port 50001. \& \& o fw1\-loggrabber \-s 192.168.2.254 \-p 50001 \-f 2003\-03\-27_213652.log \& \& Show all logentries of the specified logfile. If the Log\- \& file doesn\*(Aqt exist on the specified FW1\-Management\-Server, \& no entries are returned. \& \& o fw1\-loggrabber \-s 192.168.2.254 \-p 50001 \-f 2003\-03 \& \& Show all logentries of all logfiles on the FW1\-Management\- \& Server, that contain the pattern "2003\-03", i.e. all Log\- \& Files from March 2003 \& \& o fw1\-loggrabber \-s 192.168.2.254 \-p 50001 \-f fw.adtlog \& \& Show all logentries of audit logfile on FW1\-Management\-Server \& \& 4) Change History \& \& * 1.0 \- Initial Version (2003/03/30) \& o get all available FW1\-Logfiles \& o get data of one or more FW1\-Logfiles \& \& 5) Features to be implemented \& \& * Implementation of authenticated connections \& * Win32 build .Ve .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" برای پردازش لاگی که توسط FW\-1 تولید شده است: .PP .Vb 1 \& $ fw1\-loggrabber \-s 192.168.2.254 \-p 50001 \-f fw.log | fw12dlf .Ve .PP دستور fw1_lea2dlf به ندرت به تنهایی استفاده می‌شود و بیشتر توسط lr_log2report فراخوانی می‌گردد: .PP .Vb 2 \& $ fw1\-loggrabber \-s 192.168.2.254 \-p 50001 \-f fw.log | \e \& lr_log2report fw1_lea .Ve .SH "گزارش باگ‌ها و کارهای باقی‌مانده (BUGS / TO DO)" .IX Header "BUGS / TO DO" این مبدل به کتابخانهٔ Date::Manip در پرل وابسته است. بهتر بود برای این منظور از ماژول دیگری استفاده می‌شد که در سایر بخش‌های کد Lire نیز بیشتر کاربرد دارد. .PP وضعیت و مجوز انتشار ابزار fw1\-loggrabber نامشخص است. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" متأسفانه Check Point مستندات به راحتی در دسترسی ارائه نمی‌دهد: نشانی با گذرواژه محافظت می‌شود. پاره‌ای نکات دربارهٔ محصول FireWall\-1 در نشانی موجود است. .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Torsten Fellhauer .SH "نسخه (VERSION)" .IX Header "VERSION" \&\f(CW$Id:\fR fw1_lea2dlf.in,v 1.9 2006/07/23 13:16:35 vanbaal Exp $ .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2003 Torsten Fellhauer .PP این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نسخهٔ ۲ مجوز و چه (به دلخواه خودتان) هر نسخهٔ متأخرتری بازتوزیع کرده یا تغییر دهید. .PP این برنامه به این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «تناسب برای یک هدف مشخص». برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید. .PP شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت، نشانی را بررسی کنید.