
أعمال تخفيف log4j
يقوم دور Ansible هذا بنشر سكربت قائم على Python لتخفيف ثغرة Log4Shell (CVE-2021-44228) برمجيًا عبر إزالة صنف JndiLookup المصاب من ملفات JAR الخاصة بـ Log4j المتأثرة.
صُمم هذا الدور ليُشغَّل عبر Ansible، لكن يمكنك أيضًا تنفيذ السكربت يدويًا إن أردت.
اقرأ المزيد عن ثغرة Log4Shell هنا:
.jar و.war و.ear في أدلة التطبيقات المحددةJndiLookup.classJndiLookup.class باستخدام zipfile من Python--apply يفتح السكربت كل أرشيف
للقراءة فقط ويبلّغ عن تلك التي لا تزال تحمل JndiLookup.class؛ ولا يتم
نسخ أي شيء احتياطيًا أو إعادة كتابته. يمرر الدور --apply ما لم يكن
log4shell_apply: falsePyYAML، فقط لتشغيل يقرأ ملف تهيئة YAML (التطبيق المثبَّت).
يثبّته الدور من التوزيعة (python3-yaml،
py3-yaml أو python3-pyyaml)، وليس من PyPI أبدًا. لا يحتاج إدخال
الكشف سوى المكتبة القياسية: إذ تُمرَّر تهيئته بصيغة JSON عبر stdinلا حاجة إلى zip أو zipinfo: فالأرشيفات تُقرأ وتُعاد كتابتها باستخدام
zipfile من المكتبة القياسية، وهو أمر مهم على صور الحاويات الأساسية المصغّرة
حيث لا يكون أيٌّ منهما مثبَّتًا.
يُهيَّأ السكربت عبر ملف YAML، يُنشأ قالبُه تلقائيًا بواسطة الدور.
مثال config.yaml:
app_directories:
- /opt/apps
backup_directory: /opt/backups
log_file: /var/log/log4j_mitigation.log
app_directories: قائمة الأدلّة التي سيتم فحصها بحثًا عن ملفات JARbackup_directory: المكان الذي ستُخزَّن فيه النسخ الاحتياطية الأصلية لملفات JARlog_file: مسار ملف السجل لتتبّع العملياتأضف هذا الدور إلى ملف playbook الخاص بك:
- name: Mitigate Log4Shell CVE-2021-44228
hosts: all
become: true
roles:
- log4shell_mitigation
إذا كنت ترغب في تشغيل السكربت يدويًا، يمكنك القيام بذلك:
انسخ السكربت والمكتبة المشتركة بجانبه إلى الجهاز المستهدف:
files/log4shell_mitigator.py
files/samp_common.py
أنشئ ملف config.yaml الخاص بك في الدليل نفسه.
شغّله:
python3 log4shell_mitigator.py # dry run, config.yaml beside the script
python3 log4shell_mitigator.py --config /path/to/config.yaml
sudo python3 log4shell_mitigator.py --apply # back up and rewrite
scanned=N vulnerable=N patched=N already_stripped=N unreadable=N failed=N nested_needing_review=N dry_run=N إلى
stdout. يعدّ vulnerable الأرشيفات التي لا تزال تحمل JndiLookup.class؛
ويعدّ already_stripped أرشيفات log4j-core التي لا تحمله. إذا كانت
nested_needing_review أو unreadable غير صفرية، فإن تلك الأرشيفات لم
يُحكم عليها وتحتاج إلى معالجة يدوية؛ ويسمّي السجل كل واحد منها.0 لم يتبقَّ شيء يحمل الصنف، 2 لا يزال أرشيف يحمله أو تعذّر
الحكم عليه، 1 فشل نسخ احتياطي أو إعادة كتابة، 130
مقاطَع/var/log/log4j_mitigation.log) لمعرفة أي ملفات JAR تم ترقيعهاهذا المستودع هو SAMP: يستورده Microcelium Substrate من هذا العنوان URL نفسه، ويثبّته بواسطة commit، ويتحقق من توقيع وسم الإصدار، ويفحصه، ويحصل على موافقة بشرية عليه قبل تشغيله في أي مكان.
البيان (Manifest). يعلن samp.yaml عن CVEs، والأجهزة التي
ينطبق عليها، ونقاط الدخول للكشف والتطبيق، وما إذا كان كل منها يحتاج إلى root،
والخيارات مع قيمها الافتراضية، وكل مسار يكتبه التطبيق (touches)،
وكل برنامج يشغّله (commands) والوحدات التي قد يعيد تشغيلها. يقرأه المراجع
أولًا؛ ويتحقق الـ substrate من الكود مطابقةً له.
الكشف لا يكتب شيئًا. يقوم tasks/detect.yml بوضع السكربت و
samp_common.py في دليل مؤقت خاص، ويشغّله مع الإعدادات
بصيغة JSON على stdin والسجل على stdout، ثم يحذف الدليل. لا
يُثبَّت أي سكربت، ولا يُولَّد أي قالب إعدادات، ولا يُنشأ دليل نسخ احتياطي، ولا يُكتب
ملف سجل ولا تُثبَّت أي حزمة. يعمل أيضًا تحت ansible-playbook --check، لأنه يقرأ فقط.
التطبيق. tasks/main.yml مع log4shell_apply: true. الخيارات:
لا يُعاد تشغيل أو تحميل أي شيء ما لم ينصّ الخيار على ذلك، ولا يُتراجَع عن أي شيء أبدًا: فالتراجع يعيد الثغرة.
النتيجة. السطر الأخير للسكربت على stdout هو
SAMP-RESULT {"format":1,"verdict":…,"counters":{…},"backups":[…],…}،
بعد سطر الملخص البشري key=N. الحكم هو أحد: vulnerable،
no_fix، unknown، fixed (مع "workaround":true عندما يكون الساري هو حل بديل،
لا حزمة مُصلحة)، not_affected، أو failed.
رموز الخروج. 0 نظيف (fixed، not_affected)، 2 معرّض للثغرة أو
غير محسوم (vulnerable، no_fix، unknown: ليس نظيفًا أبدًا)، 1 فشل التشغيل
نفسه، 130 مقاطَع.
الكود المشترك. log4shell_mitigation/files/samp_common.py هو نسخة مطابقة بايتًا ببايت من
samp-common 1.0.3 (مقارنات إصدارات dpkg وrpm وapk،
وسطر النتيجة، وتحميل الإعدادات). قيمة sha256 الخاصة به في
samp.yaml، ويفشل tests/test_samp_pack.py إذا اختلفت النسخة. لا
تعدّله هنا أبدًا؛ أعد توريده باستخدام scripts/vendor.py الخاص بـ samp-common.
الإصدارات هي وسوم مشروحة موقّعة بـ SSH، samp/v<version> (هذا الإصدار:
samp/v1.0.3)، موقّعة بمفتاح مدعوم عتاديًا. يستورد الـ substrate
وسمًا موقّعًا، وليس فرعًا أبدًا.
MIT
نرحّب بطلبات السحب (PRs) والتحسينات -> يُرجى عمل fork وتقديم طلب دمج.
يُقدَّم هذا البرنامج ودور Ansible المرافق له "كما هو" ودون أي ضمانات من أي نوع، صريحة كانت أم ضمنية. أنت وحدك المسؤول عن تقييم واختبار مدى ملاءمة هذا الكود وسلامته وفعاليته قبل تطبيقه على أي بيئة. تخلي AxisOps Ltd (GB08681761) مسؤوليتها صراحةً عن أي أضرار أو فقدان بيانات أو انقطاع في الخدمة أو أي ضرر آخر ناتج عن استخدام هذا الكود أو إساءة استخدامه.
استخدمه على مسؤوليتك الخاصة. قم دائمًا بتدقيق الكود واختباره والتحقق من صحته في بيئة خاضعة للرقابة قبل نشره في بيئة الإنتاج.
فريق SysOps @ AxisOps