إطار عمل تشغيل آمن ومنخفض الكود للخداع، يستفيد من الذكاء الاصطناعي في المحاكاة الافتراضية للنظام.
 # Beelzebub **إطار خداع مفتوح المصدر.** انشر طُعومًا واقعية. راقب سلوك المهاجم. حوّل التفاعلات إلى أدلة أمنية. **[استكشف منصة Beelzebub](https://beelzebub.ai/products/beelzebub-cloud/)** · [التوثيق](https://docs.beelzebub.ai) · [البدء السريع](#get-started) [](https://github.com/beelzebub-labs/beelzebub/actions/workflows/main.yml) [](https://codecov.io/gh/beelzebub-labs/beelzebub) [](LICENSE) [](https://pkg.go.dev/github.com/beelzebub-labs/beelzebub/v3) [](https://github.com/avelino/awesome-go) يمنح Beelzebub فرق الأمن طريقة قابلة للتهيئة لدراسة النشاط الموجّه نحو خدمات الطُعم. حدّد البيئة التي يواجهها المهاجم، واختر كيفية استجابتها، والتقط التفاعل للتحقيق. شغّل الإطار بشكل مستقل أو اربطه بمنصة Beelzebub. ## لماذا Beelzebub - **انشر طُعومًا تناسب بيئتك.** حدّد الخدمات والمسارات وقواعد الاستجابة في YAML. استخدم المعالجات الثابتة لسلوك متوقع أو استجابات مدعومة بـ LLM لتفاعلات تكيفية. وسّع وقت التشغيل بإضافات Go موثوقة عندما تحتاج إلى سلوك مخصص. - **راقب ما يحدث بعد التواصل.** التقط الأدلة من تفاعلات الطُعم، بما في ذلك الأوامر وتفاصيل طلبات HTTP وسياق الجلسة، حسب البروتوكول. امنح المحللين سجلًا للنشاط الموجّه نحو الخدمة لدعم التحقيق. - **أدخل الأدلة إلى سير عملك.** افحص السجلات محليًا، أو انشر أحداثًا منظمة إلى RabbitMQ، أو فعّل الإبلاغ إلى منصة Beelzebub. فعّل مقاييس Prometheus عبر `core.prometheus.enabled: true` لمراقبة نشاط وقت التشغيل؛ افتراضيًا، يكون مستمع المقاييس معطّلًا ولا يربط أي منفذ. ## شاهده أثناء العمل شاهد طُعمًا مدعومًا بـ LLM يستجيب لمدخلات المهاجم. يوضّح العرض التوضيحي كيف يمكن للاستجابات المولّدة أن تحافظ على تفاعل يتجاوز مجموعة ثابتة من معالجات الأوامر.  ## كيف يعمل [](docs/public/readme/how-it-works.svg) حدّد الخدمات والقواعد في YAML، وتحقق من صحة التهيئة، ثم ابدأ وقت التشغيل. تُجمَّع إضافات Go الموثوقة في وقت التشغيل لتوسيع الخدمات والاستجابات. تتعامل كل خدمة مع التفاعلات الواردة وتصدر الأدلة عبر مخرجات الأحداث المهيأة. تتطلب استجابات LLM مزوّدًا مهيأً؛ يمكن للمعالجات الثابتة العمل دون مزوّد. يدعم الإطار **SSH وHTTP وTCP وTELNET وMCP**. تكشف طُعوم MCP أدوات طُعم تجعل الاستدعاءات المشبوهة قابلة للملاحظة أثناء اختبار الوكلاء الخاضع للتحكم. يمكنها تقديم أدلة على محاولات حقن الأوامر (prompt injection)؛ لكنها لا تضمن اكتشاف كل محاولة. تشمل خيارات النشر ملف Go ثنائي محلي، وDocker Compose، وKubernetes مع Helm. راجع [دليل البنية](https://docs.beelzebub.ai/concepts/architecture) لسلوك وقت التشغيل وحدود التوسيع. ## استكشف الطُعوم ابدأ بواحدة من **18 تهيئة نموذجية** في [configurations/services](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services). افتح ملف YAML لفحص قواعده وتكييفه مع بيئتك. | الفئة | أمثلة الطُعم | | --- | --- | | الوصول عن بُعد | [SSH](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/ssh-22.yaml) · [SSH (LLM)](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/ssh-2222.yaml) · [TELNET](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/telnet-23.yaml) · [RDP](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-3389-rdp.yaml) · [VNC](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-5900-vnc.yaml) | | الويب | [WordPress (LLM fallback)](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-80.yaml) · [HTTP 401](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-8080.yaml) · [HTTP methods](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-methods-8081.yaml) · [Apache directory maze](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/http-maze-8888.yaml) | | قواعد البيانات وذاكرات التخزين المؤقت | [MySQL](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-3306.yaml) · [PostgreSQL (LLM)](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-5432-postgresql-llm.yaml) · [SQL Server](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-1433-mssql.yaml) · [Redis](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-6379-redis.yaml) · [Memcached](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-11211-memcached.yaml) | | خدمات الشبكة | [SMB](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-445-smb.yaml) · [LDAP](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-389-ldap.yaml) | | إنترنت الأشياء | [MQTT](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/tcp-1883-mqtt.yaml) | | وكلاء الذكاء الاصطناعي | [MCP bait tools](https://github.com/beelzebub-labs/beelzebub/blob/main/configurations/services/mcp-8000.yaml) | تتراوح الأمثلة بين اللافتات والاستجابات المختارة والتبادلات التفاعلية. تتطلب أمثلة **LLM** مزوّدًا مُهيَّأً؛ ويستخدمها WordPress لمساره الشامل (catch-all). تحقّق من تعيينات المنافذ في نشرك عند تفعيل أمثلة إضافية. ## البدء تحتاج إلى **Git، وصدفة (shell)، وDocker Engine مع Compose v2**. استخدم **مضيف مختبر معزول** مع تفويض لجميع المستمعين المُهيَّأين: يبدأ المُثبِّت حزمة من الخدمات المثالية، بما في ذلك المنافذ ذات الامتيازات. على Linux يمكنه تفعيل **host networking**؛ ولا يوفّر Docker عزل الشبكة في ذلك الوضع. استخدم بيانات اعتماد اصطناعية وراجع [دليل أمان الإنتاج](https://docs.beelzebub.ai/operations/production-safety) قبل تعريض الخدمات للإنترنت. ```bash git clone https://github.com/beelzebub-labs/beelzebub.git cd beelzebub ./install.sh --docker ``` الإبلاغ عن المنصة اختياري. اترك رمز المنصة فارغًا عند المطالبة بالتشغيل بشكل مستقل. يتحقق وقت التشغيل من تكوينه قبل بدء المستمعين. اختبر الطعم HTTP الافتراضي وافحص سجلاته: ```bash curl -i http://localhost:8080/ docker compose logs -f beelzebub ``` توقّع **`401 Unauthorized`** من مثال HTTP المرفق على المنفذ 8080. هذا هو الاستجابة المُهيّأة للطُعم، ما يؤكد أن المستمع قابل للوصول. إذا تخطّى المُثبّت منفذًا مشغولًا، فحلّ التعارض قبل الاختبار. اضغط `Ctrl+C` لإيقاف متابعة السجلات. أوقف المختبر عند الانتهاء: ```bash docker compose down ``` لإعداد خدمة واحدة أو لطريقة نشر أخرى، اتبع [دليل التثبيت](https://docs.beelzebub.ai/getting-started/installation). ## منصة Beelzebub الإطار مفتوح المصدر هو الأساس: انشره وشغّله ووسّعه بشكل مستقل. **منصة Beelzebub** هي المنتج المُدار للفرق التي تحتاج إلى تنسيق الخداع عبر البيئات وربط الأدلة وقت التشغيل بسير عمل أمني أوسع. استكشف قدرات النشر والتحقيق وإعداد التقارير في المنصة، واطّلع على كيفية ملاءمتها لمتطلبات فريقك. **[استكشف منصة Beelzebub ←](https://beelzebub.ai/products/beelzebub-cloud/)** ## الموارد والمجتمع - **[التوثيق](https://docs.beelzebub.ai):** الإعداد والبروتوكولات والعمليات والتكاملات والوصفات. - **[تأليف الإضافات](https://docs.beelzebub.ai/plugins/authoring):** ابنِ امتدادات باستخدام Go SDK العام. تُنفَّذ الإضافات داخل العملية؛ راجع مصدرها وثبّت الإصدارات الموثوقة. - **[المساهمة](https://github.com/beelzebub-labs/beelzebub/blob/main/CONTRIBUTING.md):** ساهم بالشيفرة أو الأمثلة أو التوثيق وفق [مدونة قواعد السلوك](https://github.com/beelzebub-labs/beelzebub/blob/main/CODE_OF_CONDUCT.md). أبلغ عن الثغرات بشكل خاص عبر [SECURITY.md](https://github.com/beelzebub-labs/beelzebub/blob/main/SECURITY.md). للتطوير، استخدم إصدار Go المعلن في [go.mod](https://github.com/beelzebub-labs/beelzebub/blob/main/go.mod)، وGit، وMake. ابنِ باستخدام `make build`؛ وشغّل `make test.unit` و`go vet ./...` و`make validate-all` قبل تقديم تغييرات وقت التشغيل. يغطي [سير عمل التطوير](https://docs.beelzebub.ai/contributing/development) اختبارات التكامل واعتمادياتها على Docker. شكرًا لـ [JetBrains](https://jb.gg/OpenSourceSupport) على دعمها للتطوير بأدوات عبر برنامج دعم المصادر المفتوحة الخاص بها. مرخّص بموجب [رخصة GNU العامة العمومية الإصدار 3.0](https://github.com/beelzebub-labs/beelzebub/blob/main/LICENSE).
