البدء¶

المتطلبات الأساسية¶

المتطلب	التفاصيل
Docker	Docker Desktop أو Docker Engine + Compose v2
make	GNU Make (مثبّت مسبقًا على macOS)
الموارد	16 GB RAM كحد أدنى، يُوصى باستخدام SSD
سجلات CloudTrail	ملفات `.json` أو `.json.gz` مُصدَّرة من AWS
(اختياري) لقطات AWS Config	ملفات `.json` أو `.json.gz` لرسم بياني لموارد AWS
(اختياري) مفتاح OpenAI API	مطلوب لتوليد الاستعلامات بالذكاء الاصطناعي
(اختياري) MaxMind GeoLite2	ملفات `.mmdb` لإثراء GeoIP

البدء السريع¶

الخطوة 1. قم بتنزيل سجلات CloudTrail من S3.

aws s3 cp s3://<your-bucket-prefix> <local-output-dir>/ --recursive --include "*.json.gz"

الخطوة 2. انسخ المستودع وضع بياناتك في مكانها.

# Clone the repository
git clone https://github.com/Yamato-Security/senrigan.git
cd senrigan

# Place the downloaded CloudTrail logs here
cp -r <local-output-dir>/ docker/logs/

يتم اكتشاف المجلدين الاختياريين أدناه تلقائيًا. املأهما قبل الخطوة التالية — لا يوجد أمر إضافي لتشغيله.

المجلد	المحتوى	ما يضيفه
`docker/data/geoip/`	GeoLite2 `.mmdb`	يحوّل عناوين IP المصدر إلى الدولة والمدينة و ASN
`docker/data/config-snapshots/`	ملفات `.json` للقطات AWS Config	ينشئ رسم موارد AWS Config البياني

الخطوة 3. استورد السجلات وابدأ الخدمات.

make ingest
make up

الخطوة 4. 🪽 افتح متصفحك وابدأ التصيّد!🪽

http://localhost:8501 — الاستعلامات المدمجة ودردشة الذكاء الاصطناعي
http://localhost:8088 — لوحة المعلومات (admin / admin)
http://localhost:8502 — رسم بياني لموارد AWS Config

الأوامر اليومية¶

تشغيل make بدون وسائط يطبع هذه القائمة، وmake help-all يعرض جميع الأهداف.

الأمر	الوظيفة
`make ingest`	تحميل سجلات CloudTrail من `docker/logs/` إلى DuckDB
`make up`	بدء الواجهة ولوحة المعلومات ورسم الموارد البياني
`make down`	إيقاف كل شيء
`make logs`	متابعة سجلات الخدمات (`SERVICE=agent` لخدمة واحدة)
`make reset`	حذف قاعدة البيانات والبدء من جديد

وكيل الشركة / شهادة CA مخصصة¶

إذا كنت خلف وكيل شركة يفحص TLS، فراجع doc/DEVELOPMENT.md للحصول على تعليمات الإعداد.