
# جمع سجلات مستشعر DShield باستخدام ELK
هذا فرع (fork) وتحديث كبير على المنشور الأولي على موقع ISC Storm Center بواسطة Scott Jensen كبحث BACS والسكربتات المنشورة في Github.
https://github.com/fkadriver/Dshield-ELK
https://isc.sans.edu/diary/DShield+Sensor+Monitoring+with+a+Docker+ELK+Stack+Guest+Diary/30118
هذا مرجع جيد حول كيفية استخدام DShield-SIEM للتحليل: https://isc.sans.edu/diary/30962/
يوفر هذا نظرة عامة على كيفية تنفيذ جمع السجلات باستخدام مستشعر DShield.
https://github.com/bruneaug/DShield-SIEM/blob/main/Troubleshooting/DShield-SIEM-Flow.png
تم بناء هذا الـ docker خصيصًا لاستخدامه مع DShield Honeypot لجمع السجلات وتحليلها وجمع البيانات لتسهيل البحث لأغراض البحث. التثبيت المقترح هو تثبيت مستشعر DShield على Raspberry باستخدام نظام PI Raspbian OS أو نظام يعمل بنظام Ubuntu 24.04 LTS إما في شبكتك أو في السحابة التي تختارها.
ملاحظة: يجب تثبيت هذا على خادم منفصل وفقًا للتعليمات أدناه.
ملاحظة: لتحديث مكونات خادم ELK، اتبع هذه الخطوات:
https://github.com/bruneaug/DShield-SIEM/blob/main/README.md#download-github-update
قم بتثبيت docker بحساب المستخدم ($):
sudo apt-get install ca-certificates curl gnupg network-manager txt2html
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
Note: You may need to take the next line, remove the backlash () and put everythin in a single line in Notepad to run this echo.
echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update && sudo apt upgrade
sudo reboot (if update were applied)
sudo apt-get install -y jq docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin pip
sudo systemctl enable docker
sudo systemctl start docker.service
تأكد من أن خدمة docker قيد التشغيل
sudo systemctl status docker.service
أضف اسم خادم ELK التالي es01 kibana fleet-server heartbeat logstash filebeat filebeat01
إلى /etc/hosts بعد عنوان IP واسم الخادم:
sudo vi /etc/hosts
أضف هذا إلى /etc/hosts بعد عناوين IP الخاصة بخادم ELK
127.0.0.1 sensor es01 ...
192.168.25.80 sensor es01 ...
es01 kibana fleet-server heartbeat logstash filebeat filebeat01
حرّر ملف sysctl.conf:
sudo vi /etc/sysctl.conf
أضف ما يلي في أسفل الملف:
vm.max_map_count=262144
أضف حفظه. هذا لـ Elasticsearch عند استخدام Docker.
sudo iptables -nL

باستخدام حساب المستخدم ($)، نفّذ الأوامر التالية:
git clone https://github.com/bruneaug/DShield-SIEM.git
mkdir scripts
mv DShield-SIEM/AddOnScripts/*.sh scripts
chmod 754 scripts/*.sh
cd ~/DShield-SIEM
ملاحظة: قبل التثبيت، يمكنك تعديل ملف .env (استخدم ls -la لرؤيته) لإجراء أي تغييرات مرغوبة.
- كلمة المرور الافتراضية الحالية لـ elastic هي student
حدود الذاكرة في .env هي الحد الأقصى للذاكرة التي سيخصصها docker لكل حاوية من حاويات ELK.
القيمة الافتراضية هي 3GB لـ Elasticsearch ولكن يمكن توسيعها إذا كانت لديك الموارد
عدّل ملف .env وقم بتكوينه وفقًا لـ ELK Stack الخاص بك
vi .env
cd logstash/pipeline
حرّر heartbeat.yml لتغيير عنوان IP الخاص بالمستشعر (المسمى PI) إلى عنوان IP الخاص بمستشعرك. يتحقق Kibana heartbeat من حالة خدماتك ويحدد ما إذا كانت متاحة.
حدّث عنوان IP واسم المضيف هذا ليعكس مستشعرك.
ملاحظة: يمكنك نسخ وإضافة نفس الأسطر الخمسة إذا كان لديك أكثر من مستشعر ترغب في مراقبته
يمكن عرض ذلك من Observability -> Uptime Monitors

هذا السطر هو عنوان IP الخاص بالمستشعر. إذا لم يتلقَّ استجابة أثناء الاتصال بـ TCP 12222، فسيُعلّمه كمعطّل في الواجهة.
يبدأ خادم ELK هذا الإجراء للتحقق من الاستجابة من المستشعر.
حدّث هذا السطر: hosts: ["192.168.25.165"]
vi ~/DShield-SIEM/heartbeat/heartbeat.yml
سيقوم السكربت change_perms.sh بتهيئة بعض الملفات قبل بدء تثبيت مكونات docker.
سيقوم السكربت أيضًا بتحديث عنوان IP المستخدم في استعلام لوحة المعلومات إلى عنوان IP الخاص بمكدس ELK الخاص بك.
~/scripts/change_perms.sh
~/scripts/get_researchers.sh
الآن نفّذ docker compose لبناء تطبيقات خادم ELK.
سيؤدي هذا إلى بناء: Kibana وElasticsearch وelastic-agent وLogstash وتحميل محللات Cowrie وملفات التكوين ولوحة المعلومات.
sudo docker compose up -d
اكتمل التثبيت
sudo cp /var/lib/docker/volumes/dshield-elk_certs/_data/ca/ca.crt /usr/local/share/ca-certificates/dshield.crt
sudo update-ca-certificates
يقوم هذا بتحميل لوحات معلومات DShield SIEM وتوقيعات SIEM إلى Kibana.
~/scripts/dashboard-setup.sh