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** (Model Context Protocol) के माध्यम से उपयोग करें \
> अधिक जानकारी के लिए [Cyberbro MCP](https://github.com/stanfrbd/mcp-cyberbro) देखें।

# डेमो

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

# विशेषताएँ

* **आसान इनपुट**: कच्चे लॉग या IoCs पेस्ट करें-स्वचालित पार्सिंग और निष्कर्षण।
* **बहु-सेवा जाँच**: कई थ्रेट इंटेल सेवाओं में IPs, hashes, domains, URLs, और Chrome extension IDs के लिए प्रतिष्ठा लुकअप।
* **व्यापक रिपोर्ट**: उन्नत खोज, फ़िल्टरिंग, और CSV/Excel में निर्यात।
* **तेज़ प्रसंस्करण**: गति के लिए मल्टीथ्रेडेड।
* **स्वचालित पिवोटिंग**: reverse DNS और RDAP / Whois के माध्यम से संबंधित domains, URLs, और IPs खोजें।
* **सटीक डोमेन और दुरुपयोग जानकारी**: RDAP / Whois और दुरुपयोग संपर्क लुकअप।
* **एकीकरण**: Microsoft Defender for Endpoint, CrowdStrike, OpenCTI, Grep.App, Hudson Rock, और बहुत कुछ।
* **प्रॉक्सी और स्टोरेज**: प्रॉक्सी समर्थन और परिणाम SQLite में संग्रहीत।
* **इतिहास और ग्राफ़**: विश्लेषण इतिहास और प्रायोगिक ग्राफ़ दृश्य।
* **कैश**: तेज़ दोहराए गए लुकअप के लिए कैशिंग (मल्टी-इंजन स्तर पर सक्षम, प्रत्येक इंजन पर नहीं)।

# Cyberbro को क्या अद्वितीय बनाता है

* **शुरुआती-अनुकूल**: सभी कौशल स्तरों के लिए सुलभ।
* **Chrome Extension ID लुकअप**: IDs से extension नाम और CTI डेटा प्राप्त करें।
* **हल्का तैनाती**: सरल सेटअप और उपयोग।
* **उन्नत TLD निष्कर्षण**: बेहतर लुकअप के लिए सटीक रूट डोमेन पहचान।
* **व्यावहारिक डेटा संग्रह**: अनदेखे IoCs को खोजने के लिए GitHub और Google का उपयोग करता है।
* **CTI रिपोर्ट एकीकरण**: IoC.One से IoC-संबंधित रिपोर्ट प्राप्त करता है।
* **EDR एकीकरण**: आपके स्वयं के सुरक्षा उपकरणों (MDE, CrowdStrike) के विरुद्ध observables की जाँच करता है।

# शुरू करना - 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 keys नहीं हैं? कोई बात नहीं, बस `.env.sample` को `.env` में कॉपी करें और वैकल्पिक मान खाली छोड़ दें। यदि प्रॉक्सी का उपयोग किया जाता है तो सावधान रहें। \
> आप **सभी मुफ्त इंजनों** का उपयोग कर पाएंगे!

* `.env` फ़ाइल में मान भरें (यदि आवश्यक हो तो प्रॉक्सी सहित)।

> [!WARNING]
> `.env` में संवेदनशील रहस्य होते हैं और इसे कभी भी कमिट नहीं किया जाना चाहिए।
> उत्पादन/टीम तैनाती के लिए, SOPS, Vault, या समकक्ष secret manager वर्कफ़्लो का उपयोग करें।

```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` पृष्ठ का समर्थन नहीं करता। Cf. [चर्चा 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 # बैकग्राउंड में चलाने के लिए -d का उपयोग करें और इमेज को फिर से बनाने के लिए --build का उपयोग करें
```

* http://127.0.0.1:5000 पर जाएँ और आनंद लें।

> इमेज बनाने से पहले `.env` को संपादित करना न भूलें।

सभी Docker तैनाती विकल्पों को प्राप्त करने के लिए दस्तावेज़ों में [तैनाती के लिए उन्नत विकल्प](https://docs.cyberbro.net/quick-start/Advanced-options-for-deployment) देखें।

## पुराना तरीका

* रिपॉजिटरी क्लोन करें और आवश्यकताएँ इंस्टॉल करें।

निर्भरताएँ इंस्टॉल करने से पहले आप एक [`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 `/api/` पर उपलब्ध है और इसे GUI या कमांड-लाइन के माध्यम से एक्सेस किया जा सकता है।

**वर्तमान में 3 endpoints हैं:**

* `/api/analyze` - एक टेक्स्ट का विश्लेषण करें और विश्लेषण ID (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/) - Repackaged Open Source Threat Intelligence
* [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/) जिन्होंने बेहतर secret management और परीक्षण जोड़े। उन्होंने बहुत कुछ रिफैक्टर किया और कोडबेस में कई सुधार किए, जिसमें 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) issue #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 endpoint के कॉन्फ़िग की अनुमति देने के लिए। यह आने वाले 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) पाया जा सकता है।