बैंडजैक्स

साइबर खतरा रक्षा विश्व मॉडलिंग प्रणाली

अवलोकन

Bandjacks एक व्यापक साइबर खतरा खुफिया (CTI) प्रणाली है जो:

• खतरा रिपोर्टों से MITRE ATT&CK तकनीकों को 12-40 सेकंड में निकालता है
• खतरा अभिकर्ताओं, तकनीकों और बचावों का ज्ञान ग्राफ बनाता है
• पूर्ण उद्गम ट्रैकिंग के साथ STIX 2.1 अनुरूप बंडल उत्पन्न करता है
• रक्षात्मक सिफारिशों के लिए D3FEND ऑन्टोलॉजी को एकीकृत करता है
• वेक्टर खोज और ग्राफ विश्लेषण क्षमताएं प्रदान करता है
• तकनीक पैटर्न की पहचान करने के लिए सह-घटना विश्लेषण की गणना करता है
• LLM प्रतिक्रिया कैशिंग के साथ पिछले संस्करणों की तुलना में 94% तेज़ निष्कर्षण की सुविधा है
• रिपोर्ट समीक्षा और विश्लेषण विज़ुअलाइज़ेशन के लिए एक Next.js फ्रंटएंड शामिल है

📚 दस्तावेज़ीकरण

मार्गदर्शिका	विवरण
त्वरित प्रारंभ	5 मिनट में चालू करें
पूर्ण सेटअप	पूर्ण वातावरण सेटअप
CLI उपयोग	कमांड-लाइन इंटरफ़ेस मार्गदर्शिका
API संदर्भ	REST API दस्तावेज़ीकरण
सह-घटना विश्लेषण	विश्लेषण दस्तावेज़ीकरण
AttackFlow जनरेशन	प्रवाह जनरेशन मार्गदर्शिका
समीक्षा प्रणाली	मानव-इन-द-लूप समीक्षा

आर्किटेक्चर मुख्य विशेषताएं

TechniqueCache

• स्टार्टअप पर लोड किए गए सभी MITRE ATT&CK तकनीकों का इन-मेमोरी कैश
• तत्काल नाम समाधान के लिए external_id (जैसे, T1557) द्वारा O(1) लुकअप
• पूर्ण मेटाडेटा (नाम, विवरण, रणनीति, प्लेटफ़ॉर्म) के साथ 1376 तकनीकें कैश की गईं
• सुसंगत नामकरण सुनिश्चित करता है कि समीक्षा UI हमेशा मानव-पठनीय तकनीक नाम दिखाता है

ActorCache

• सभी घुसपैठ सेट और खतरा अभिकर्ताओं का इन-मेमोरी कैश
• अभिकर्ता नाम समाधान और खोज के लिए तेज़ लुकअप
• उपनाम मिलान और अस्पष्ट खोज का समर्थन करता है

त्वरित प्रारंभ

आवश्यक शर्तें

• Python 3.11+
• Neo4j 5.x (ग्राफ डेटाबेस)
• OpenSearch 2.x (वेक्टर स्टोर)
• Redis (वैकल्पिक, कैशिंग के लिए)
• Node.js 18+ (फ्रंटएंड के लिए)
• LLM एक्सेस: क्लाउड API कुंजियाँ (Gemini या OpenAI) या एक स्थानीय OpenAI-संगत सर्वर

स्थापना```bash

Clone the repository

git clone https://github.com/yourusername/bandjacks.git cd bandjacks

Install Python dependencies with uv (recommended)

uv sync

Or with pip

pip install -e .

Install frontend dependencies

cd ui && npm install && cd ..

### पर्यावरण सेटअप

**महत्वपूर्ण:** एप्लिकेशन शुरू करने से पहले आपको पर्यावरण चर कॉन्फ़िगर करना होगा। एप्लिकेशन को `NEO4J_PASSWORD` सेट करना आवश्यक है।

प्रोजेक्ट रूट में एक `.env` फ़ाइल बनाएं:```bash
# Copy the sample file
cp infra/env.sample .env

# Edit .env and set your actual passwords
nano .env

आवश्यक कॉन्फ़िगरेशन .env में:```bash

Neo4j Configuration (REQUIRED)

NEO4J_URI=bolt://localhost:7687 NEO4J_USER=neo4j NEO4J_PASSWORD=your-actual-neo4j-password # MUST BE SET - no default provided

OpenSearch Configuration

OPENSEARCH_URL=http://localhost:9200 OPENSEARCH_USER=admin OPENSEARCH_PASSWORD=your-opensearch-password # Optional if security is disabled

LLM Configuration — pick ONE of the options below:

Option A: Local OpenAI-compatible API (vLLM, llama.cpp, Ollama, LocalAI, LM Studio, etc.)

LOCAL_LLM_API_BASE=http://192.168.1.100:8080/v1 # Base URL of your local server LOCAL_LLM_MODEL=mistral-nemo # Model name as the server reports it LOCAL_LLM_API_KEY=no-key # Most local servers accept any value

Option B: Cloud LLM providers

PRIMARY_LLM=gemini GOOGLE_API_KEY=your-gemini-api-key

Optional: OpenAI as fallback (or primary if PRIMARY_LLM=openai)

OPENAI_API_KEY=your-openai-api-key

ATT&CK Configuration

ATTACK_INDEX_URL=https://raw.githubusercontent.com/mitre-attack/attack-stix-data/master/index.json ATTACK_COLLECTION=enterprise-attack ATTACK_VERSION=latest

Redis (optional, for caching)

REDIS_URL=redis://localhost:6379

**नोट:** यदि `NEO4J_PASSWORD` सेट नहीं है तो एप्लिकेशन प्रारंभ होने में विफल रहेगा। विवरण के लिए [Environment Variables Fix](https://github.com/blevene/bandjacks/blob/main/ENV_VARIABLES_FIX.md) देखें।

### सेवाएं प्रारंभ करना```bash
# Start the FastAPI backend server
uv run uvicorn bandjacks.services.api.main:app --reload --port 8000

# In another terminal, start the Next.js frontend
cd ui && npm run dev

# Access the applications
open http://localhost:8000/docs    # API documentation
open http://localhost:3000         # Frontend UI

कमांड-लाइन इंटरफ़ेस (CLI)

Bandjacks में खतरा खुफिया संचालन के लिए एक व्यापक CLI शामिल है:```bash

Show all available commands

uv run python -m bandjacks.cli.main --help

> **नोट:** CLI को पर्यावरण चर (NEO4J_PASSWORD, आदि) सेट करने की आवश्यकता होती है। प्रोजेक्ट रूट से चलाएँ जहाँ `.env` स्थित है।

### क्वेरी कमांड्स```bash
# Search for threat intelligence
uv run python -m bandjacks.cli.main query search "ransomware encryption techniques" --top-k 10

# Explore graph relationships
uv run python -m bandjacks.cli.main query graph "attack-pattern--abc123" --depth 2

समीक्षा कतार प्रबंधन```bash

Show review queue

uv run python -m bandjacks.cli.main review queue --status pending --limit 20

Approve a candidate

uv run python -m bandjacks.cli.main review approve "candidate-123" --reviewer analyst-1

Reject with reason

uv run python -m bandjacks.cli.main review reject "candidate-456" --reviewer analyst-1 --reason "False positive"

### दस्तावेज़ निष्कर्षण```bash
# Extract CTI from a document
uv run python -m bandjacks.cli.main extract document ./report.pdf --confidence-threshold 80 --show-evidence

विश्लेषण आदेश

नोट: विश्लेषण आदेशों को परिणाम वापस करने के लिए Neo4j में AttackEpisode डेटा की आवश्यकता होती है।```bash

Show top co-occurring technique pairs

uv run python -m bandjacks.cli.main analytics top-cooccurrence --limit 25 --min-episode-size 2

Compute conditional co-occurrence P(B|A) for a technique

uv run python -m bandjacks.cli.main analytics conditional "attack-pattern--abc123" --limit 25

Analyze a specific threat actor

uv run python -m bandjacks.cli.main analytics actor "intrusion-set--xyz789" --metric npmi

Extract technique bundles

uv run python -m bandjacks.cli.main analytics bundles --min-support 3 --min-size 3 --max-size 5 --format json --output bundles.json

Global co-occurrence metrics

uv run python -m bandjacks.cli.main analytics global --min-support 2 --limit 50 --format csv --output pairs.csv

### कार्यप्रवाह कमांड्स```bash
# Process a directory of reports with analytics
uv run python -m bandjacks.cli.main workflow process-reports ./reports/ --workers 3 --analyze --export-dir ./results/

# Bulk export all analytics data
uv run python -m bandjacks.cli.main workflow bulk-export --export-dir ./analytics_export/

प्रशासक आदेश```bash

Check system health

uv run python -m bandjacks.cli.main admin health

View cache statistics

uv run python -m bandjacks.cli.main admin cache-stats

Clear cache

uv run python -m bandjacks.cli.main admin cache-clear --pattern "search:*"

Optimize database

uv run python -m bandjacks.cli.main admin optimize

## फ्रंटएंड UI

Next.js फ्रंटएंड सिस्टम के साथ काम करने के लिए एक आधुनिक इंटरफ़ेस प्रदान करता है।

### रिपोर्ट प्रबंधन (`/reports`)
- **रिपोर्ट सूची**: सभी इन्जेस्ट की गई रिपोर्टों को स्थिति और तकनीक गणना के साथ देखें
- **नई रिपोर्ट** (`/reports/new`): PDF/TXT फ़ाइलें अपलोड करें या रिपोर्ट सामग्री पेस्ट करें
- **रिपोर्ट विवरण** (`/reports/[id]`): निकाली गई तकनीकों, संस्थाओं और साक्ष्यों को देखें
- **समीक्षा इंटरफ़ेस** (`/reports/[id]/review`): मानव-इन-द-लूप समीक्षा वर्कफ़्लो

### सह-घटना विश्लेषण (`/analytics/cooccurrence`)