.\" -*- 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 "PIX2DLF.IN 1" .TH PIX2DLF.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)" pix2dlf \- تبدیل لاگ‌های PIX به قالب DLF فایروال .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBpix2dlf\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این اسکریپت لاگ‌هایی از نوع syslog را از یک فایروال Cisco PIX در stdin انتظار دارد. پیام‌هایی با سطح اهمیت informational (۶) و بالاتر باید ثبت شوند. این پیام‌ها به‌عنوان نمونه به این صورت هستند: .PP .Vb 11 \& Jan 15 12:58:37 pix1 %PIX\-4\-106543: Deny tcp src outside:1.2.3.4/1234 dst \& inside:2.3.4.5/80 by access\-group "foo" \& Jan 16 10:37:09 pix1 %PIX\-4\-106543: Deny udp src outside:3.4.5.6/137 dst \& inside:4.5.6.7/137 by access\-group "foo" \& Jan 17 08:43:46 pix1 %PIX\-4\-106543: Deny icmp src outside:5.6.7.8 dst \& inside:6.7.8.9 (type 8, code 0) by access\-group "foo" \& Jan 24 00:07:39 pix1 %PIX\-6\-302000: Teardown TCP connection 178359 faddr \& 7.8.9.10/102 gaddr 8.9.10.11/21652 laddr 9.10.11.12/4107 duration \& 0:00:01 bytes 755 (TCP FINs) \& Jan 24 00:07:45 pix1 %PIX\-6\-302000: Teardown UDP connection for faddr \& 10.11.12.13/711 gaddr 11.12.13.14/1259 laddr 12.13.14.15/1259 .Ve .PP به این صورت: .PP .Vb 1 \& syslog_time_stamp log_host %PIX\-Level\-Message_number: Message_text .Ve .PP همچنین ببینید: http://www.cisco.com/univercd/cc/td/doc/product/iaabu/pix/pix_62/syslog/pixemint.htm#xtocid11 .PP این اسکریپت رکوردهای DLF را در قالب DLF فایروال Lire روی STDOUT خروجی می‌دهد. .PP در حال حاضر، تنها پیام‌های: .PP .Vb 10 \& %PIX\-2\-106001 \& %PIX\-2\-106002 \& %PIX\-2\-106006 \& %PIX\-2\-106007 \& %PIX\-3\-106010 \& %PIX\-3\-106014 \& %PIX\-6\-106015 \& %PIX\-1\-106021 \& %PIX\-4\-106023 \& %PIX\-6\-302002 \& %PIX\-6\-302006 \& %PIX\-6\-302014 \& %PIX\-6\-302016 .Ve .PP استفاده می‌شوند. توجه داشته باشید که سطح اهمیت ۱ معادل \`alert\*(Aq و ۶ معادل \`informational\*(Aq است. (۰ معادل \`emergency\*(Aq و ۷ معادل \`debugging\*(Aq است.) .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" برای پردازش لاگی که توسط یک Cisco PIX تولید شده است: .PP .Vb 1 \& $ pix2dlf < pix.log .Ve .PP دستور pix2dlf به‌ندرت به‌تنهایی استفاده می‌شود، بلکه به احتمال زیاد توسط lr_log2report فراخوانی می‌گردد: .PP .Vb 1 \& $ lr_log2report pix < /var/log/pix.log .Ve .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUGS" این اسکریپت هنوز با طیف گسترده‌ای از فایل‌های لاگ آزمایش نشده است و بنابراین هنوز به بلوغ کافی نرسیده است. .PP مطالعهٔ مستندات Cisco برای بررسی تغییرات احتمالی در قالب فایل لاگ، به‌عنوان مثال میان نگارش‌های 4.0 و 6.2 فایروال PIX، هنوز انجام \fIنشده\fR است. .PP احتمالاً ما از هیچ‌یک از محصولات PIX به‌طور کاملاً جامع پشتیبانی نمی‌کنیم. ما مستندات مربوط به فایل‌های لاگ نگارش‌های 4.3، 4.4، 5.0، 5.1، 5.2، 5.3، 6.0، 6.1 و 6.2 فایروال PIX را یافته‌ایم، اما هنوز همهٔ جزئیات و رفتارهای خاص ذکرشده در این اسناد را پیاده‌سازی نکرده‌ایم. این اسکریپت تلاش می‌کند از PIX 6.2 در بیشتر موارد معمول پشتیبانی کند. .PP هنگام دستکاری و توسعهٔ این اسکریپت، به یاد داشته باشید که نحو (syntax) لاگ‌ها در طول توسعهٔ PIX تغییر کرده است. افزون بر این، توجه داشته باشید که برخی از وضعیت‌های ابتدایی (state) در لاگ‌های PIX نشان داده می‌شوند. این وضعیت‌ها هنوز در این اسکریپت استفاده نمی‌شوند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \(lqCisco PIX Firewall System Log Messages\(rq .PP http://www.cisco.com/univercd/cc/td/doc/product/iaabu/pix/pix_62/syslog/pixemsgs.htm .SH "نسخه (VERSION)" .IX Header "VERSION" \&\f(CW$Id:\fR pix2dlf.in,v 1.26 2009/03/15 08:10:55 vanbaal Exp $ .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر (C) ۲۰۰۲ بنیاد Stichting LogReport Foundation .PP این فایل بخشی از Lire است. .PP نرم‌افزار Lire یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نگارش ۲ پروانه و چه (به انتخاب خودتان) هر نگارش بالاتر دیگری، بازنشر دهید و/یا تغییر دهید. .PP این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «پروانه عمومی همگانی گنو» مراجعه کنید. .PP شما باید همراه با این برنامه نسخه‌ای از پروانه عمومی همگانی گنو را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت، به http://www.gnu.org/copyleft/gpl.html مراجعه کنید. .SH "تشکر و قدردانی (THANKS)" .IX Header "THANKS" از Roberto dal Zilio و Ketil Adolfsen، برای تهیهٔ لاگ‌های PIX جهت اشکال‌زدایی. از Anthony (acquant) برای رفع باگ‌ها. .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" نگارش اولیه توسط Wessel Dankers بر پایهٔ اسکریپت cisco_acl2dlf متعلق به Lire نوشته شده است. تغییرات بعدی فراوانی توسط Joost van Baal انجام گرفته است.