مشروع واجهة برمجة تطبيقات مدير الجدار الناري

التثبيت

اتبع هذه الخطوات لإعداد وتشغيل مشروع واجهة برمجة التطبيقات:

1. استنساخ المستودع

git clone https://github.com/adriyansyah-mf/CentralizedFirewall
cd CentralizedFirewall

2. تحرير ملف .env

قم بتحديث متغيرات البيئة في .env وفقًا لتكوينك.

nano .env

3. تشغيل واجهة برمجة التطبيقات باستخدام Docker Compose

docker compose up -d

سيؤدي هذا إلى تشغيل واجهة برمجة التطبيقات في الوضع المنفصل.

4. التحقق من تشغيل واجهة برمجة التطبيقات

تحقق من أن الحاويات قيد التشغيل:

docker ps

أوامر إضافية

إيقاف واجهة برمجة التطبيقات

docker compose down

إعادة تشغيل واجهة برمجة التطبيقات

docker compose restart

أخبرني إذا كنت بحاجة إلى أي تعديلات! 🚀

كيفية الإعداد لأول مرة والاتصال بعميل الجدار الناري

1. قم بتثبيت وكيل الجدار الناري على خادم العقدة الخاص بك
2. قم بتشغيل الوكيل باستخدام الأمر التالي

sudo dpkg -i firewall-client_deb.deb

3. قم بإنشاء مجموعة جديدة على مدير الجدار الناري
4. قم بإنشاء مفتاح API جديد على مدير الجدار الناري
5. قم بتحرير ملف التكوين على خادم العقدة

nano /usr/local/bin/config.ini

6. أضف التكوين التالي

[settings]
api_url = API-URL
api_key = API-KEY
hostname = Node Hostname (make it unique and same as the hostname on the SIEM) 

7. قم بإعادة تشغيل وكيل الجدار الناري

systemctl daemon-reload
systemctl start firewall-agent

8. تحقق من حالة وكيل الجدار الناري

systemctl status firewall-agent

9. سترى العقدة المتصلة على مدير الجدار الناري

بيانات الاعتماد الافتراضية

Username: admin
Password: admin

يمكنك تغيير بيانات الاعتماد الافتراضية من صفحة الإعدادات

كيفية التكامل مع نظام SIEM

1. قم بتثبيت نظام SIEM على خادمك
2. قم بتكوين نظام SIEM لإرسال السجل إلى مدير الجدار الناري (يمكنك القيام بذلك عبر تكوين SOAR أو SIEM) يجب أن يكون الطلب POST بالتنسيق التالي
3. يجب أن يكون تنسيق السجل كما يلي

curl -X 'POST' \
  'http://api-server:8000/general/add-ip?ip=123.1.1.99&hostname=test&apikey=apikey&comment=log' \
  -H 'accept: application/json' \
  -d ''

يمكنك رؤية وثائق Swagger على الرابط التالي

http://api-server:8000/docs

تفاصيل تكوين ملف .env

DB=changeme
JWT_SECRET=changeme
PASSWORD_SALT=changme
PASSWORD_TOKEN_KEY=changme
OPENCTI_URL=changme
OPENCTI_TOKEN=changme

ادعم هذا المشروع 💖

إذا وجدت هذا المشروع مفيدًا، فكر في دعمي من خلال GitHub Sponsors: