cyberbro

<h1 align="center">Cyberbro</h1>

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/10725/4970c639439a60187e1ba39523b24c3343a5b6946445d8225e23c4060e002ff0.png" width="90" /><br />
<b><i>تطبيق بسيط يستخرج مؤشرات الاختراق (IoCs) الخاصة بك من مدخلات عشوائية ويتحقق من سمعتها باستخدام خدمات متعددة.</i></b>
<br />
<b>🌐 <a href="https://demo.cyberbro.net/">demo.cyberbro.net</a></b><br />

</p>

---

<p align="center">
  <a href="https://github.com/stanfrbd/cyberbro/stargazers">
    <img src="https://img.shields.io/github/stars/stanfrbd/cyberbro?style=social" alt="GitHub stars">
  </a>
  <a href="https://x.com/cyberbro_cti">
    <img src="https://img.shields.io/twitter/follow/cyberbro_cti?style=social" alt="Follow on X/Twitter">
  </a>
  <a href="https://infosec.exchange/@cyberbro">
    <img src="https://img.shields.io/badge/Follow_@cyberbro-23-blue?logo=mastodon" alt="Mastodon">
  </a>
  <a href="https://github.com/stanfrbd/cyberbro/issues">
    <img src="https://img.shields.io/github/issues/stanfrbd/cyberbro" alt="GitHub issues">
  </a>
  <a href="https://github.com/stanfrbd/cyberbro/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/stanfrbd/cyberbro" alt="License">
  </a>
  <a href="https://github.com/stanfrbd/cyberbro/actions/workflows/jobs.yml">
    <img src="https://github.com/stanfrbd/cyberbro/actions/workflows/jobs.yml/badge.svg" alt="build and test badge">
  </a>
  <a href="https://github.com/stanfrbd/cyberbro/actions/workflows/pre-commit-validation.yml">
    <img src="https://github.com/stanfrbd/cyberbro/actions/workflows/pre-commit-validation.yml/badge.svg" alt="pre-commit validation badge">
  </a>
  <a href="https://www.python.org/">
    <img src="https://img.shields.io/badge/Python-3.13-blue?logo=python" alt="Python">
  </a>
</p>

---

# نبذة

مستوحى من [Cybergordon](https://cybergordon.com/) و[IntelOwl](https://github.com/intelowlproject/IntelOwl).

يهدف هذا المشروع إلى توفير طريقة بسيطة وفعّالة للتحقق من سمعة العناصر القابلة للملاحظة (observables) الخاصة بك باستخدام خدمات متعددة،
دون الحاجة إلى نشر حل **معقّد**. اقرأ الوثائق على https://docs.cyberbro.net/

> [!TIP]
> لإنشاء تقارير مخصّصة، استخدم Cyberbro مع **LLM** المفضّل لديك (Claude، OpenAI gpt-5...) عبر **MCP** (بروتوكول سياق النموذج) \
> راجع [Cyberbro MCP](https://github.com/stanfrbd/mcp-cyberbro) لمزيد من المعلومات.

# العرض التوضيحي

![graph_demo](https://assets.kitploit.com/production/public/readmes/10725/42293ee1b50ba63b53c12c77a24c60627781cced6b5756b304f7e8482ca361c1.gif)

# الميزات

* **إدخال سهل**: الصق السجلات الخام أو مؤشرات الاختراق — تحليل واستخراج تلقائي.
* **فحوصات متعددة الخدمات**: البحث عن سمعة عناوين IP والتجزئات (hashes) والنطاقات وعناوين URL ومعرّفات إضافات Chrome عبر العديد من خدمات استخبارات التهديدات.
* **تقارير شاملة**: بحث متقدّم وتصفية وتصدير إلى CSV/Excel.
* **معالجة سريعة**: متعدد الخيوط (multithreaded) لتحقيق السرعة.
* **محورية تلقائية (Automated Pivoting)**: اكتشاف النطاقات وعناوين URL وعناوين IP ذات الصلة عبر reverse DNS وRDAP / Whois.
* **معلومات دقيقة عن النطاقات والإساءة**: عمليات بحث RDAP / Whois وجهات اتصال الإساءة.
* **تكاملات**: Microsoft Defender for Endpoint، CrowdStrike، OpenCTI، Grep.App، Hudson Rock، والمزيد.
* **الوكيل والتخزين**: دعم الوكيل (Proxy) وتخزين النتائج في SQLite.
* **السجل والرسوم البيانية**: سجل التحليلات وعرض رسومي تجريبي.
* **التخزين المؤقت (Cache)**: تخزين مؤقت لعمليات البحث المتكررة بشكل أسرع (مُفعّل على مستوى المحركات المتعددة، وليس كل محرك).

# ما الذي يجعل Cyberbro فريدًا

* **مناسب للمبتدئين**: متاح لجميع مستويات المهارة.
* **البحث عن معرّفات إضافات Chrome**: الحصول على أسماء الإضافات وبيانات CTI من المعرّفات.
* **نشر خفيف الوزن**: إعداد واستخدام بسيط.
* **استخراج متقدّم للنطاقات العلوية (TLD)**: اكتشاف دقيق للنطاق الجذر لعمليات بحث أفضل.
* **جمع بيانات عملي**: يستخدم GitHub وGoogle للعثور على مؤشرات اختراق مُغفلة.
* **تكامل تقارير CTI**: يجلب التقارير المتعلقة بمؤشرات الاختراق من IoC.One.
* **تكامل EDR**: يتحقق من العناصر القابلة للملاحظة مقابل أدواتك الأمنية الخاصة (MDE، CrowdStrike).

# البدء السريع - TL;DR

> [!TIP]
> إذا كنت تفضّل الطريقة الأسهل، فأنت بحاجة إلى Docker. \
> نفّذ `git clone` ؛ انسخ `.env.sample` إلى `.env` ؛ ثم `docker compose up` ثم انتقل إلى `localhost:5000`. نعم، هذا كل شيء!

# البدء

* للبدء، استنسخ المستودع

```bash
git clone https://github.com/stanfrbd/cyberbro
cd cyberbro
```

## تعديل ملف الإعدادات (إلزامي)

```
cp .env.sample .env
```

> [!NOTE]
> لا تملك مفاتيح API؟ لا مشكلة، فقط انسخ `.env.sample` إلى `.env` واترك القيم الاختيارية فارغة. كن حذرًا إذا كنت تستخدم وكيلًا (proxy). \
> ستتمكن من استخدام **جميع المحركات المجانية!**

* املأ القيم (بما في ذلك الوكيل إذا لزم الأمر) في ملف `.env`.

> [!WARNING]
> يحتوي `.env` على أسرار حساسة ويجب عدم إيداعه في المستودع أبدًا.
> لعمليات النشر الإنتاجية/الجماعية، استخدم SOPS أو Vault أو أي مدير أسرار مكافئ.

```bash
ABUSEIPDB=token_here
ALIENVAULT=token_here
CRIMINALIP_API_KEY=token_here
CROWDSTRIKE_CLIENT_ID=client_id_here
CROWDSTRIKE_CLIENT_SECRET=client_secret_here
DFIR_IRIS_API_KEY=token_here
DFIR_IRIS_URL=https://dfir-iris.local
DFIR_IRIS_SEARCH_NOTES=false
GOOGLE_CSE_CX=cx_here
GOOGLE_CSE_KEY=key_here
GOOGLE_CSE_URL=https://www.googleapis.com/customsearch/v1
GOOGLE_SAFE_BROWSING=token_here
HISTER_TOKEN=token_here
HISTER_BASE_URL=https://hister.example.com
IPAPI=token_here
IPINFO=token_here
MDE_CLIENT_ID=client_id_here
MDE_CLIENT_SECRET=client_secret_here
MDE_TENANT_ID=tenant_here
MISP_API_KEY=token_here
MISP_URL=https://misp.local
MISP_FEEDBACK_SERVER_URL=https://misp-feedback.local
MISP_FEEDBACK_TOKEN=token_here
OPENCTI_API_KEY=token_here
OPENCTI_URL=https://demo.opencti.io
PROXY_URL=
RANSOMWARE_LIVE_API_KEY=token_here
RL_ANALYZE_API_KEY=token_here
RL_ANALYZE_URL=https://spectra_analyse_url_here
ROSTI_API_KEY=token_here
SHODAN=token_here
SPUR_US=token_here
THREATFOX=token_here
VIRUSTOTAL=token_here
WEBSCOUT=token_here
```

> [!IMPORTANT]
> بدءًا من الإصدار `v0.13.0`، لم يعد Cyberbro يدعم `secrets.json` وصفحة `/config`. راجع [المناقشة 165](https://github.com/stanfrbd/cyberbro/discussions/165).\
> إذا كان لديك ملف `secrets.json` قديم، فحوّله إلى `.env` باستخدام:
> `python3 scripts/secrets_json_to_env.py`

راجع [الخيارات المتقدّمة للنشر](https://docs.cyberbro.net/quick-start/Advanced-options-for-deployment) في الوثائق.

# تشغيل التطبيق

## الطريقة السهلة والبسيطة - استخدام docker

> [!WARNING]
> تأكد من تثبيت إضافة `compose` كـ `docker compose` وليس `docker-compose`.
> في Docker، يرتبط التطبيق بـ `0.0.0.0` داخل الحاوية حتى لو كان ملف `.env` المحلي لديك يضبط `FLASK_HOST=127.0.0.1`.

```bash
docker compose up # use -d to run in background and use --build to rebuild the image
```

* انتقل إلى http://127.0.0.1:5000 واستمتع.

> لا تنسَ تعديل `.env` قبل بناء الصورة.

راجع [الخيارات المتقدّمة للنشر](https://docs.cyberbro.net/quick-start/Advanced-options-for-deployment) في الوثائق للحصول على جميع خيارات نشر Docker.

## الطريقة القديمة

* استنسخ المستودع وثبّت المتطلبات.

قد ترغب في إنشاء [`venv`](https://docs.python.org/3/library/venv.html) قبل تثبيت التبعيات.

```bash
pip install -r requirements.txt
```

* شغّل التطبيق باستخدام `gunicorn` (الوضع النظيف).

```bash
gunicorn -c prod/gunicorn.conf.py app:app
```

* شغّل التطبيق في وضع التطوير.

```bash
python3 app.py
```

# لقطات الشاشة

<details>
<summary>عرض جميع لقطات الشاشة</summary>

<img width="1897" height="909" alt="image" src="https://assets.kitploit.com/production/public/readmes/10725/b3a07f1e163ae260b2a5f908a70d571a145f702ad50b524725ce4b3562f7c367.png" />

<img width="1883" height="907" alt="image" src="https://assets.kitploit.com/production/public/readmes/10725/3d3404a7e55b688b497db428ecb7fa01b6a23ec8879e2c2c751c68a92545a334.png" />

<img width="1887" height="906" alt="image" src="https://assets.kitploit.com/production/public/readmes/10725/cd57a214ae604ed83ca50d119b49391afc0a66c03b3ed93feecfbb59578f5984.png" />

</details>

<img width="1788" height="1536" alt="image" src="https://assets.kitploit.com/production/public/readmes/10725/2e6051fe1ad7fadde5ff9074dbb4d96528dd2c8ab8262ea10e1fe49fee031153.png" />

<img width="1873" height="900" alt="image" src="https://assets.kitploit.com/production/public/readmes/10725/5201b888fdaa97465f141379e9f5caedb0bdd847b1e31a08b3e236df8b663ed6.png" />

> [!CAUTION]
> إذا كنت تنوي استخدام هذا في **بيئة إنتاجية**، فاستخدم **Reverse Proxy** + **WAF** مُهيّأين جيدًا لمنع **المشكلات الأمنية**.

# إضافة متصفح Cyberbro

<p>
<a href="https://addons.mozilla.org/addon/cyberbro-analyzer/"><img src="https://assets.kitploit.com/production/public/readmes/10725/7e7e7002c8f357304f16d1d06ff840c40e92c66f6ed072b18da36329502c7a13.png" alt="Get Cyberbro Analyzer for Firefox"></a>
<a href="https://chromewebstore.google.com/detail/cyberbro-analyzer/nfcfigpaollodajabegcdobhmgaclbbm"><img src="https://assets.kitploit.com/production/public/readmes/10725/28dd6378e71c68b4f21b54ad99bb1225f978b8f2bacfa3c46444f988c09ace1c.png" alt="Get Cyberbro Analyzer for Chromium"></a>
<a href="https://microsoftedge.microsoft.com/addons/detail/cyberbro-analyzer/lbponbmcggcepflackehgpbceehagiam"><img src="https://assets.kitploit.com/production/public/readmes/10725/0a301e6c3048478ead36dfbccdba2e5263de7fbeb3de9d22a9f159f64f378273.png" alt="Get Cyberbro Analyzer for Microsoft Edge"></a>
</p>

# واجهة Cyberbro API

* الواجهة البرمجية متاحة على `/api/` ويمكن الوصول إليها عبر واجهة المستخدم الرسومية أو سطر الأوامر.

**يوجد حاليًا 3 نقاط نهاية (endpoints):**

* `/api/analyze` - تحليل نص وإرجاع معرّف التحليل (JSON).
* `/api/is_analysis_complete/<analysis_id>` - التحقق مما إذا كان التحليل مكتملًا (JSON).
* `/api/results/<analysis_id>` - استرجاع نتائج تحليل سابق (JSON).

```bash
curl -X POST "http://localhost:5000/api/analyze" -H "Content-Type: application/json" -d '{"text": "cyberbro.net", "engines": ["reverse_dns", "rdap_whois"]}'
```

```json
{
  "analysis_id": "e88de647-b153-4904-91e5-8f5c79174854",
  "link": "/results/e88de647-b153-4904-91e5-8f5c79174854"
}
```

```bash
curl "http://localhost:5000/api/is_analysis_complete/e88de647-b153-4904-91e5-8f5c79174854"
```

```json
{
  "complete": true
}
```

```bash
curl "http://localhost:5000/api/results/e88de647-b153-4904-91e5-8f5c79174854"
```

```json
[
  {
    "observable": "cyberbro.net",
    "rdap_whois": {
      "abuse_contact": "[email protected]",
      "creation_date": "2024-12-20",
      "data_source": "rdap",
      "emails": [
        "[email protected]"
      ],
      "expiration_date": "2026-12-20",
      "link": "https://rdap.verisign.com/net/v1/domain/CYBERBRO.NET",
      "name_servers": [
        "anderson.ns.cloudflare.com",
        "lisa.ns.cloudflare.com"
      ],
      "organization": null,
      "registrant": null,
      "registrant_country": null,
      "registrant_email": null,
      "registrar": "Cloudflare, Inc.",
      "update_date": "2025-11-20"
    },
    "reverse_dns": {
      "reverse_dns": [
        "172.67.197.226",
        "104.21.42.7"
      ]
    },
    "reversed_success": true,
    "type": "FQDN"
  }
]
```

> [!NOTE]
> تعرض [صفحة الوثائق المخصّصة](https://docs.cyberbro.net/quick-start/API-usage-and-engine-names) جميع أسماء المحركات القابلة للاستخدام.

# API والخدمات الخارجية

* [AbuseIPDB](https://docs.abuseipdb.com/)
* [Abusix](https://abusix.com/)
* [Alienvault](https://otx.alienvault.com/)
* [CriminalIP](https://www.criminalip.io/)
* [CrowdStrike](https://www.crowdstrike.com/)
* [crt.sh](https://crt.sh/)
* [DFIR Iris](https://www.dfir-iris.org/)
* [Github](https://github.com/)
* [Google Safe Browsing](https://developers.google.com/safe-browsing)
* [Google](https://google.com/)
* [Google DNS](https://dns.google/)
* [Grep.App](https://grep.app/)
* [Hister](https://hister.org/)
* [Hudson Rock](https://hudsonrock.com/)
* [ICANN](https://lookup.icann.org/)
* [IPapi](https://ipapi.is/)
* [IPinfo](https://ipinfo.io/developers)
* [IPquery](https://ipquery.gitbook.io/ipquery-docs)
* [Ioc.One](https://ioc.one/)
* [Microsoft Defender for Endpoint](https://docs.microsoft.com/en-us/windows/security/threat-protection/microsoft-defender-atp/microsoft-defender-for-endpoint-api)
* [Microsoft Entra ID (OpenID Configuration)](https://login.microsoftonline.com/)
* [MISP](https://www.misp-project.org/)
* [MISP Feedback](https://github.com/MISP/misp-feedback/)
* [OpenCTI](https://www.opencti.io/)
* [OpenRDAP](https://www.openrdap.org/)
* [Phishtank](https://www.phishtank.com/)
* [Ransomware.Live](https://ransomware.live/)
* [ReversingLabs Spectra Analyze](https://www.reversinglabs.com/products/spectra-analyze)
* [Rösti](https://rosti.bin.re/) - استخبارات تهديدات مفتوحة المصدر معاد تجميعها
* [ScanMalware](https://scanmalware.com/)
* [Shodan](https://developer.shodan.io/)
* [Spur.us](https://spur.us/)
* [ThreatFox](https://threatfox.abuse.ch/api/)
* [URLscan](https://urlscan.io/)
* [VirusTotal](https://developers.virustotal.com/v3.0/reference)
* [WebScout](https://webscout.io/)

> [!NOTE]
> هل لديك أي أسئلة؟ راجع https://docs.cyberbro.net أو افتح [issue](https://github.com/stanfrbd/cyberbro/issues/new) \
> للإعدادات المتقدّمة (ضبط `supervisord.conf` قبل النشر، اختيار المحركات المرئية، تغيير بادئة `/api/`...)، راجع [صفحة الوثائق المخصّصة](https://docs.cyberbro.net/quick-start/Advanced-options-for-deployment).

# شكر خاص

شكر جزيل لجميع المساهمين الرائعين الذين قدّموا طلبات سحب (pull requests) وساعدوا في تحسين هذا المشروع:

* [Florian PILLOT](https://github.com/Harukunnn) الذي أعاد صياغة المحركات (إعادة هيكلة وتحسينات).
* [Axel](https://github.com/botlabsDev) الذي يطوّر [Ioc.One](https://ioc.one/) وأضاف User-Agent مخصّصًا يسمح بكشط Ioc[.]One.
* [Jon Mark Allen](https://github.com/ubahmapk/) الذي أضاف إدارة أفضل للأسرار واختبارات. أعاد هيكلة الكثير وقدّم تحسينات عديدة لقاعدة الكود، بما في ذلك CriminalIP.
* [cirosec GmbH - Felix Friedberger](https://github.com/cirosec) لإضافة محرك crt.sh.
* [Stig Dahl](https://github.com/sdaaish) لتحسين محرك crt.sh، وإضافة بحث DFIR IRIS وإصلاح مشكلات Bandit، وتصحيح محرك MISP، وإضافة محرك MISP Feedback.
* [0xffr](https://github.com/0xffr) لإصلاح المشكلة #98 - محرك Grep.app معطّل والتعليق بشكل صحيح في محرك CriminalIP.
* [Maxime Berthault - Maxou56800](https://github.com/Maxou56800) لتطوير Cyberbro CLI.
* [Jonas Lejon](https://github.com/jonaslejon) لإضافة محرك ScanMalware.
* [egeoguz04](https://github.com/egeoguz04) للسماح بإعداد نقطة نهاية Google CSE. سيكون هذا مفيدًا لتغييرات Google القادمة.

مساهماتكم محل تقدير كبير!

# الترخيص

```
MIT License

Copyright (c) 2024-2026 stanfrbd

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
```

# الشعار

الشعار المستخدم في هذا المشروع مجاني للاستخدام الشخصي والتجاري ويمكن العثور عليه [هنا](https://www.veryicon.com/icons/object/material_design_icons/web-39.html).