نام (NAME)

ipv6loganon - ابزار ناشناس‌سازی فایل‌های لاگ سرور HTTP

خلاصه دستور (SYNOPSIS)

cat /var/log/httpd/access_log | ipv6loganon [گزینه‌ها]

توضیحات (DESCRIPTION)

این برنامه آدرس‌های IPv4/IPv6 را در فایل‌های گزارش (لاگ) سرور HTTP ناشناس‌سازی می‌کند.

داده‌ها را از ورودی استاندارد (stdin) دریافت کرده و پس از پردازش به خروجی استاندارد (stdout) می‌فرستد.

بسته به روش ناشناس‌سازی، بخش‌های آدرس (پیشوند/شناسه رابط) به این صورت پردازش می‌شوند:

۱. به‌سادگی با ماسک‌های داده‌شده صفر (zeroized) می‌شوند.

۲. تنها با صفر کردن بیت‌های مورد نیاز (تا حدی وابسته به ماسک‌های مشخص‌شده) ناشناس‌سازی (anonymized) می‌شوند.

۳. با تلاش برای حفظ مشخصات آدرس‌های IPv4 و IPv6 ناشناس‌سازی می‌شوند (keep-type-asn-cc).

هنگام صفر کردن تنها بیت‌های مورد نیاز (حالت ۲)، حالت‌های زیر وجود دارد:

IID:

Prefix:

آدرس‌های IPv6 شامل آدرس IPv4 کلاینت، با ماسک IPv4 داده‌شده ناشناس‌سازی می‌شوند.

هنگام ناشناس‌سازی با حفظ مشخصات (حالت ۳)، فیلدهای مربوطه عبارتند از: نوع (type) آدرس، شماره سیستم خودمختار (ASN) و کد کشور (CC).

این روش نیازمند تفکیک و نگاشت IPv4/IPv6 به کد کشور و ASN است که توسط پایگاه‌های داده خارجی ارائه می‌شود.

مزیت بزرگ: نتیجه ipv6logstats(8) باید با نتیجه داده‌های خام یکسان باشد.

آدرس‌های IPv4 ناشناس‌سازی‌شده از محدوده آزمایشی 240.0.0.0/8 هستند.

آدرس‌های IPv6 ناشناس‌سازی‌شده از پیشوند a909::/16 (که در حال حاضر هایجک شده است) استفاده می‌کنند.

شناسه رابط (IID) در IPv6 ناشناس‌سازی‌شده با a9x9 آغاز می‌شود (x = نیبل‌های ناشناس‌سازی‌شده SLA).

گزینه‌ها (OPTIONS)

گزینه‌های عمومی:

[-d|--debug DEBUGVALUE]

مقدار اشکال‌زدایی (به‌صورت بیتی)؛ همچنین می‌تواند از طریق متغیر محیطی IPV6CALC_DEBUG تنظیم شود.

[-v|--version [-v [-v]]]

اطلاعات نسخه (۲ سطح جزئیات اختیاری)

[-v|--version -h]

توضیح نشانه‌های ویژگی (feature tokens)

[-V|--verbose]

نمایش با جزئیات بیشتر

[-h|--help|-?]

نمایش این راهنمای آنلاین

گزینه‌های پایگاه‌داده خارجی (بسته به پشتیبانی کامپایل‌شده در برنامه):

[--db-ip2location-disable]

پشتیبانی از IP2Location غیرفعال شود

[--db-ip2location-dir DIRECTORY]

دایرکتوری پایگاه‌داده IP2Location (پیش‌فرض: /usr/share/IP2Location)

[--db-ip2location2-disable]

پشتیبانی از IP2Location(MMDB) غیرفعال شود

[--db-ip2location2-dir DIRECTORY]

دایرکتوری پایگاه‌داده IP2Location(MMDB) (پیش‌فرض: /usr/share/IP2Location)

[--db-geoip2-disable]

پشتیبانی از GeoIP(MMDB) غیرفعال شود

[--db-geoip2-dir DIRECTORY]

دایرکتوری پایگاه‌داده GeoIP(MMDB) (پیش‌فرض: /usr/share/GeoIP)

[--db-dbip2-disable]

پشتیبانی از db-ip.com(MMDB) غیرفعال شود

[--db-dbip2-dir DIRECTORY]

دایرکتوری پایگاه‌داده db-ip.com(MMDB) (پیش‌فرض: /usr/share/DBIP)

گزینه‌های ورودی/خروجی:

[-w|--write]

نوشتن خروجی در فایل به جای stdout

[-a|--append]

افزودن خروجی به انتهای فایل به جای stdout

[-f|--flush]

تخلیه بافر خروجی پس از هر خط

[-V|--verbose]

نمایش با جزئیات کامل

گزینه‌های کارایی:

[-n|--nocache]

غیرفعال کردن حافظه پنهان (کش)

[-c|--cachelimit VALUE]

تنظیم حد مجاز حافظه پنهان. پیش‌فرض: 20، حداکثر: 200.

گزینه‌های پردازش:

میان‌برهای پیش‌تنظیمات ناشناس‌سازی:

روش‌های پشتیبانی‌شده [--anonymize-method METHOD]:

anonymize

ناشناس‌سازی مطمئن، حفظ بیشترین اطلاعات نوع تا حد ممکن

zeroize

صفر کردن ساده طبق ماسک‌های داده‌شده، که احتمالاً اطلاعات نوع را از دست می‌دهد

keep-type-asn-cc

ناشناس‌سازی مطمئن ویژه، حفظ نوع و شماره سیستم خودمختار (ASN) و کد کشور (CC).

پیش‌تنظیمات موجود (نام‌های میان‌بر) [--anonymize-preset PRESET-NAME]:

anonymize-standard (as):

mask-ipv6= 56 mask-ipv4=24 mask-eui64=40 mask-mac=24 mask-autoadjust=yes method=anonymize

anonymize-careful (ac):

mask-ipv6= 48 mask-ipv4=20 mask-eui64=24 mask-mac=24 mask-autoadjust=yes method=anonymize

anonymize-paranoid (ap):

mask-ipv6= 40 mask-ipv4=16 mask-eui64= 0 mask-mac=24 mask-autoadjust=no method=anonymize

zeroize-standard (zs):

mask-ipv6= 56 mask-ipv4=24 mask-eui64=40 mask-mac=24 mask-autoadjust=yes method=zeroize

zeroize-careful (zc):

mask-ipv6= 48 mask-ipv4=20 mask-eui64=24 mask-mac=24 mask-autoadjust=yes method=zeroize

zeroize-paranoid (zp):

mask-ipv6= 40 mask-ipv4=16 mask-eui64= 0 mask-mac=24 mask-autoadjust=no method=zeroize

keep-type-asn-cc (kp):

mask-ipv6= 56 mask-ipv4=24 mask-eui64=40 mask-mac=24 mask-autoadjust=yes method=keep-type-asn-cc

کنترل سفارشی:

--mask-ipv4 BITS

ماسک کردن آدرس IPv4 [بازه ۳۲-۰] (حتی اگر درون آدرس IPv6 رخ دهد)

--mask-ipv6 BITS

ماسک کردن پیشوند IPv6 [بازه ۶۴-۰] (فقط بر انواع آدرس مرتبط اعمال می‌شود)

--mask-eui64 BITS

ماسک کردن آدرس EUI-64 یا شناسه رابط IPv6 [بازه ۶۴-۰]

--mask-mac BITS

ماسک کردن آدرس MAC [بازه ۴۸-۰]

--mask-autoadjust yes|no

تنظیم خودکار ماسک برای حفظ اطلاعات نوع/سازنده صرف‌نظر از ماسک کمتری که مشخص شده است

مثال‌ها (EXAMPLES)

خطوط اصلی (ورودی استاندارد / stdin):

207.46.98.53 - - [01/Jan/2007:00:01:15 +0100] "GET /Linux+IPv6-HOWTO/x1112.html HTTP/1.0" 200 6162 "-" "msnbot/1.0 (+http://search.msn.com/msnbot.htm)" 253 6334

2002:52b6:6b01:1:216:17ff:fe01:2345 - - [10/Jan/2007:15:04:28 +0100] "GET /favicon.ico HTTP/1.1" 200 4710 "http://www.bieringer.de/linux/IPv6" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.0.9) Gecko/20061219 Fedora/1.5.0.9-1.fc6 Firefox/1.5.0.9 pango-text" 413 5005

خطوط تغییریافته (خروجی استاندارد / stdout):

207.46.98.0 - - [01/Jan/2007:00:01:15 +0100] "GET /Linux+IPv6-HOWTO/x1112.html HTTP/1.0" 200 6162 "-" "msnbot/1.0 (+http://search.msn.com/msnbot.htm)" 253 6334

2002:52b6:6b00:0:216:17ff:fe00:0 - - [10/Jan/2007:15:04:28 +0100] "GET /favicon.ico HTTP/1.1" 200 4710 "http://www.bieringer.de/linux/IPv6" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.0.9) Gecko/20061219 Fedora/1.5.0.9-1.fc6 Firefox/1.5.0.9 pango-text" 413 5005

روش ناشناس‌سازی: keep-type-asn-cc

echo "1.2.3.4" | ./ipv6loganon --anonymize-preset keep-type-asn-cc 246.24.59.65

echo "2001:a60:1400:1201:221:70ff:fe01:2345" | ./ipv6loganon --anonymize-preset keep-type-asn-cc a909:16fa:9092:23ff:a909:4291:4022:1708

همچنین ببینید (SEE ALSO)

ipv6calc(8), ipv6logstat(8)

گزارش اشکالات (REPORTING BUGS)

گزارش باگ‌ها از طریق گیت‌هاب: https://github.com/pbiering/ipv6calc/issues

صفحه اصلی: http://www.deepspace6.net/projects/ipv6calc.html

مجوز (LICENSE)

GPLv2

نویسندگان (AUTHORS)

Peter Bieringer <pb@bieringer.de>