RinHit

RinHit - macOS पारिस्थितिकी तंत्र टोही ढांचा। नेटवर्क गतिविधि, क्रॉस-डिवाइस पहचान और भौतिक स्थान सहसंबंध की समयरेखा बनाने के लिए Apple पारिस्थितिकी तंत्र से आर्टिफैक्ट एकत्र करता है।

यह ओपन-सोर्स टोही मॉड्यूल है। क्लोज्ड-सोर्स Swift पेलोड (rinhit-agent) हमारे रेडटीम द्वारा आंतरिक रूप से उपयोग किया जाता है और यह इस रिपॉजिटरी का हिस्सा नहीं है।

विशेषताएँ

• वाई-फाई नेटवर्क टोही - com.apple.wifi.known-networks.plist (पुराना) पार्स करता है या networksetup (macOS 15+ Data Vault) का उपयोग करता है
• ब्लूटूथ डिवाइस - com.apple.Bluetooth.plist से युग्मित, कैश्ड और कनेक्टेड डिवाइस
• USB डिवाइस इतिहास - ioreg (IOKit) और system_profiler के माध्यम से कनेक्टेड USB डिवाइस
• सहसंबंध इंजन - क्रॉस-आर्टिफैक्ट विश्लेषण:
  • क्रॉस-डिवाइस पहचान (iPhone हॉटस्पॉट + AirPods)
  • यात्रा पैटर्न (होटल/अतिथि वाई-फाई का पता लगाना)
  • होम/ऑफिस फिंगरप्रिंट (ISP राउटर का पता लगाना)
  • टेम्पोरल सत्र क्लस्टरिंग
• ऑफ़लाइन BSSID जियोलोकेशन - Wigle CSV आयात के साथ SQLite कैश
• गंभीरता स्कोरिंग - क्लाउड सिंक = high, मोबाइल हॉटस्पॉट = medium, आदि।
• JSON आउटपुट - आगे के विश्लेषण के लिए संरचित रिपोर्टिंग

स्थापना

# Clone
git clone https://github.com/toxy4ny/rinhit.git
cd rinhit

# Build
go build -o rinhit ./cmd/rinhit

# Or install directly
go install ./cmd/rinhit

उपयोग

उपलब्ध कलेक्टरों की सूची दिखाएँ

./rinhit list

सभी कलेक्टर चलाएँ (वाई-फाई के लिए sudo आवश्यक है)

sudo ./rinhit scan -v

विशिष्ट कलेक्टर चलाएँ

sudo ./rinhit scan -c wifi,bluetooth -v

सहसंबंध इंजन के साथ चलाएँ

sudo ./rinhit scan --correlate -v

रिपोर्ट को फ़ाइल में सहेजें

sudo ./rinhit scan -o report.json

जियोलोकेशन डेटाबेस

# Wigle CSV डंप आयात करें
./rinhit geo import wigle-export.csv

# BSSID देखें
./rinhit geo lookup AA:BB:CC:DD:EE:FF

# कैश आँकड़े दिखाएँ
./rinhit geo stats

उदाहरण आउटपुट

{
  "generated_at": "2026-08-21T21:09:10Z",
  "hostname": "MacBook-Pro-test.local",
  "user": "root",
  "artifacts": [
    {
      "id": "wifi-ns-iPhone7",
      "collector": "wifi",
      "type": "wifi-network",
      "name": "iPhone7",
      "severity": "medium",
      "timestamp": "2026-08-21T14:09:10-07:00",
      "source": "networksetup",
      "data": {"ssid": "iPhone7", "source": "networksetup"},
      "tags": ["wifi", "network", "macos15-fallback", "mobile-hotspot", "cross-device"]
    }
  ],
  "summary": {
    "total_artifacts": 12,
    "by_severity": {"info": 11, "medium": 1},
    "by_collector": {"wifi": 12}
  },
  "data": {
    "correlations": [
      {
        "type": "mobile-hotspot",
        "confidence": 0.7,
        "description": "Mobile hotspot 'iPhone7' detected - indicates iPhone/iPad tethering usage",
        "artifact_ids": ["wifi-ns-iPhone7"],
        "tags": ["mobile-hotspot", "tethering", "cross-device"]
      }
    ]
  }
}

आर्किटेक्चर

rinhit/
├── cmd/rinhit/main.go          # CLI entrypoint
├── pkg/
│   ├── collector/              # Collector interface & registry
│   │   ├── wifi/               # Wi-Fi artifact collector
│   │   ├── bluetooth/          # Bluetooth device collector
│   │   └── usb/                # USB device collector
│   ├── model/                  # Artifact & Report structs
│   ├── parser/plist/           # Plist parsing with SIP fallback
│   ├── reporter/json/          # JSON reporter
│   ├── correlator/             # Cross-artifact correlation engine
│   └── geoloc/                 # Offline BSSID geolocation cache

विस्तार

नया कलेक्टर जोड़ने के लिए, Collector इंटरफ़ेस लागू करें:

type Collector interface {
    Name() string
    Description() string
    Collect(ctx context.Context) ([]model.Artifact, error)
    RequiresRoot() bool
}

इसे cmd/rinhit/main.go में buildRegistry() में पंजीकृत करें।

OPSEC नोट्स

• RinHit रीड-ओनली मोड में काम करता है - कोई सिस्टम संशोधन नहीं
• macOS 15+ पर, वाई-फाई plist Data Vault द्वारा सुरक्षित है - RinHit networksetup (living off the land) पर फॉलबैक करता है
• सार्वजनिक APIs के माध्यम से BSSID जियोलोकेशन ऑपरेटर का फिंगरप्रिंट ले सकता है - संवेदनशील अभियानों के लिए ऑफ़लाइन SQLite कैश का उपयोग करें
• जहाँ संभव हो न्यूनतम विशेषाधिकारों के साथ चलाएँ - केवल wifi कलेक्टर को sudo की आवश्यकता होती है

रोडमैप

• वाई-फाई नेटवर्क टोही (plist + networksetup फॉलबैक)
• ब्लूटूथ युग्मित/कैश्ड डिवाइस
• USB डिवाइस इतिहास (ioreg + system_profiler)
• सहसंबंध इंजन (क्रॉस-डिवाइस, यात्रा, टेम्पोरल)
• ऑफ़लाइन Wigle CSV आयात + BSSID लुकअप
• TCC डेटाबेस विश्लेषण
• क्वारंटाइन विस्तारित विशेषताएँ
• स्पॉटलाइट मेटाडेटा खोज
• यूनिफाइड लॉग्स टाइमलाइन
• SARIF आउटपुट प्रारूप
• मार्कडाउन मानव-पठनीय रिपोर्ट

लाइसेंस

MIT - देखें LICENSE।

"जिस तरह घुन फल में छेद करता है, अंडे देता है, और अपने निशान छुपाने के लिए तने को काट देता है, उसी तरह RinHit Apple पारिस्थितिकी तंत्र में छेद करता है, स्थिरता स्थापित करता है, और भीतर से सुरक्षा सीमाओं को क्षरण करता है।"