btrpa-scan

उन्नत रिज़ॉल्वेबल प्राइवेट एड्रेस (RPA) रिज़ॉल्यूशन के साथ एक ब्लूटूथ लो एनर्जी (BLE) स्कैनर। आस-पास के BLE डिवाइसों को खोजें, MAC एड्रेस द्वारा किसी विशेष डिवाइस को ट्रैक करें, या आइडेंटिटी रिज़ॉल्विंग की (IRK) का उपयोग करके प्राइवेसी-रैंडमाइज़्ड एड्रेस को रिज़ॉल्व करें।

लेखक: डेविड कैनेडी (@HackingDave) कंपनी: TrustedSec

विशेषताएँ

• सभी डिवाइस खोजें - सिग्नल स्ट्रेंथ, अनुमानित दूरी, निर्माता डेटा और सर्विस UUID के साथ रेंज में प्रसारण करने वाले सभी BLE डिवाइसों को स्कैन करें
• लक्षित खोज - MAC एड्रेस द्वारा किसी विशेष डिवाइस को खोजें और हर डिटेक्शन की निगरानी करें
• IRK रिज़ॉल्यूशन - प्राइवेसी के लिए रैंडमाइज़्ड एड्रेस का उपयोग करने वाले डिवाइसों की पहचान करने हेतु एक या अधिक आइडेंटिटी रिज़ॉल्विंग कीज़ के विरुद्ध रिज़ॉल्वेबल प्राइवेट एड्रेस को रिज़ॉल्व करें
• एकाधिक IRK - एक फ़ाइल से कई IRK लोड करें और एक ही स्कैन में कई डिवाइसों के एड्रेस रिज़ॉल्व करें
• RSSI फ़िल्टरिंग - न्यूनतम RSSI थ्रेशोल्ड के साथ कमज़ोर सिग्नलों को फ़िल्टर करें
• RSSI औसत - स्लाइडिंग विंडो औसत शोर-युक्त BLE RSSI रीडिंग को सुचारू करके अधिक स्थिर दूरी अनुमान देता है
• नाम फ़िल्टरिंग - केस-असंवेदनशील सबस्ट्रिंग मिलान के साथ नाम द्वारा डिवाइस फ़िल्टर करें
• सक्रिय स्कैनिंग - अतिरिक्त सर्विस UUID और डिवाइस नाम पाने के लिए SCAN_REQ भेजें, जो पैसिव स्कैनिंग से छूट जाते हैं
• पर्यावरण प्रीसेट - अधिक सटीक दूरी अनुमान के लिए इनडोर, आउटडोर और फ्री-स्पेस पाथ-लॉस मॉडल
• निकटता अलर्ट - जब डिवाइस किसी कॉन्फ़िगर करने योग्य दूरी के भीतर हो तो श्रव्य/दृश्य अलर्ट
• वेब GUI - एनिमेटेड स्वीप, दूरी विज़ुअलाइज़ेशन, GPS मानचित्र, पिन/अनपिन के साथ सिग्नल-स्ट्रेंथ डिवाइस सूची और होवर टूलटिप्स के साथ ब्राउज़र-आधारित रडार इंटरफ़ेस
• लाइव TUI - सिग्नल स्ट्रेंथ द्वारा क्रमबद्ध कर्सेस-आधारित लाइव-अपडेट होने वाली तालिका
• रीयल-टाइम CSV लॉग - प्रत्येक डिटेक्शन को होते ही CSV फ़ाइल में स्ट्रीम करें
• बैच निर्यात - स्कैन के अंत में परिणाम CSV, JSON या JSONL में निर्यात करें (stdout के लिए -o - समर्थित है)
• GPS स्थान स्टैम्पिंग - gpsd के माध्यम से प्रत्येक डिटेक्शन को GPS निर्देशांक के साथ टैग करें; प्रति-डिवाइस सर्वोत्तम स्थान ट्रैक करता है (सबसे मज़बूत RSSI = सबसे निकट निकटता)। डिफ़ॉल्ट रूप से चालू, gpsd अनुपलब्ध होने पर सामान्य रूप से कार्य करता रहता है
• मल्टी-अडैप्टर - एक साथ कई ब्लूटूथ अडैप्टर के साथ स्कैन करें (Linux)
• वर्बोज़/क्वाइट मोड - वर्बोज़ मोड अतिरिक्त विवरण दिखाता है (जैसे IRK मोड में गैर-मेल खाने वाले RPA); क्वाइट मोड प्रति-डिवाइस आउटपुट दबा कर केवल सारांश दिखाता है

आवश्यकताएँ

• Python 3.9+
• ब्लूटूथ हार्डवेयर
• OS समर्थन: macOS, Linux, Windows
• gpsd (वैकल्पिक) — GPS स्थान स्टैम्पिंग के लिए आवश्यक

gpsd स्थापित करना

GPS स्थान स्टैम्पिंग के लिए कनेक्टेड GPS रिसीवर के साथ चल रहे gpsd डेमन की आवश्यकता होती है। यदि gpsd नहीं चल रहा है, तो btrpa-scan GPS के बिना सामान्य रूप से कार्य करता रहता है।

प्लेटफ़ॉर्म	इंस्टॉल	स्टार्ट
macOS	brew install gpsd	gpsd -n /dev/tty.usbserial-*
Debian/Ubuntu	sudo apt install gpsd gpsd-clients	sudo systemctl start gpsd
Fedora/RHEL	sudo dnf install gpsd gpsd-clients	sudo systemctl start gpsd
Arch	sudo pacman -S gpsd	sudo systemctl start gpsd
Windows	WSL या MSYS2 के माध्यम से gpsd का उपयोग करें	ऊपर WSL निर्देश देखें

gpsd काम कर रहा है यह सत्यापित करने के लिए:

# जाँचें कि gpsd सुन रहा है
gpspipe -w -n 5
# या कर्सेस मॉनिटर का उपयोग करें
cgps

प्लेटफ़ॉर्म नोट्स

प्लेटफ़ॉर्म	नोट्स
macOS	CoreBluetooth का उपयोग करता है। IRK मोड UUID के बजाय वास्तविक ब्लूटूथ एड्रेस प्राप्त करने के लिए एक अप्रमाणित API का लाभ उठाता है। --active का कोई प्रभाव नहीं होता — CoreBluetooth हमेशा सक्रिय रूप से स्कैन करता है।
Linux	स्कैनिंग के लिए root या CAP_NET_ADMIN क्षमता की आवश्यकता हो सकती है।
Windows	नेटिव WinRT ब्लूटूथ API — वास्तविक MAC एड्रेस मूल रूप से उपलब्ध होते हैं। TUI के लिए pip install windows-curses आवश्यक है।

स्थापना

यह प्रोजेक्ट pyproject.toml (PEP 621) — आधुनिक Python पैकेजिंग मानक का उपयोग करता है। यह प्रोजेक्ट को पंजीकृत CLI कमांड के साथ एक इंस्टॉल करने योग्य पैकेज के रूप में परिभाषित करता है — .py फ़ाइलों को सीधे चलाने की आवश्यकता नहीं है।

त्वरित रन (बिना इंस्टॉल)

uvx btrpa-scan --all

GitHub से चलाएँ (बिना इंस्टॉल)

uvx --from git+https://github.com/hackingdave/btrpa-scan.git btrpa-scan --all

टूल के रूप में इंस्टॉल करें

uv tool install btrpa-scan

या सीधे GitHub से:

uv tool install git+https://github.com/hackingdave/btrpa-scan.git

pip के माध्यम से इंस्टॉल करें

pip install btrpa-scan

GUI समर्थन के लिए (Flask-आधारित रडार इंटरफ़ेस):

pip install btrpa-scan[gui]

स्रोत से

git clone https://github.com/hackingdave/btrpa-scan.git
cd btrpa-scan
pip install .

उपयोग

usage: btrpa-scan [-h] [-a] [--irk HEX] [--irk-file PATH] [-t TIMEOUT]
                     [--output {csv,json,jsonl}] [-o FILE] [--log FILE]
                     [-v | -q] [--min-rssi DBM] [--rssi-window N] [--active]
                     [--environment {free_space,indoor,outdoor}]
                     [--ref-rssi DBM] [--name-filter PATTERN]
                     [--alert-within METERS] [--tui] [--gui] [--gui-port PORT]
                     [--no-gps] [--adapters LIST] [mac]

BLE स्कैनर — सभी डिवाइस खोजें या किसी विशेष की खोज करें

positional arguments:
  mac                   खोजने के लिए लक्षित MAC एड्रेस (सभी स्कैन करने के लिए छोड़ दें)

optional arguments:
  -h, --help            यह सहायता संदेश दिखाएँ और बाहर निकलें
  -a, --all             सभी प्रसारण करने वाले डिवाइसों के लिए स्कैन करें
  --irk HEX             इस आइडेंटिटी रिज़ॉल्विंग की का उपयोग करके RPA रिज़ॉल्व करें (32 हेक्स वर्ण)
  --irk-file PATH       फ़ाइल से IRK पढ़ें (प्रति पंक्ति एक, हेक्स प्रारूप)
  -t, --timeout TIMEOUT स्कैन टाइमआउट सेकंड में (डिफ़ॉल्ट: 30, या --irk के लिए अनंत)
  --output {csv,json,jsonl}
                        स्कैन के अंत में लिखा जाने वाला बैच आउटपुट प्रारूप
  -o, --output-file FILE
                        आउटपुट फ़ाइल पथ (डिफ़ॉल्ट: btrpa-scan-results.<format>;
                        stdout के लिए - उपयोग करें)
  --log FILE            डिटेक्शन को रीयल टाइम में CSV फ़ाइल में स्ट्रीम करें
  -v, --verbose         वर्बोज़ मोड — अतिरिक्त विवरण दिखाएँ
  -q, --quiet           क्वाइट मोड — प्रति-डिवाइस आउटपुट दबाएँ, केवल सारांश दिखाएँ
  --min-rssi DBM        न्यूनतम RSSI थ्रेशोल्ड (जैसे -70) — कमज़ोर सिग्नलों को अनदेखा करें
  --rssi-window N       औसत के लिए RSSI स्लाइडिंग विंडो आकार (डिफ़ॉल्ट: 1 = कोई औसत नहीं)
  --active              सक्रिय स्कैनिंग का उपयोग करें (अतिरिक्त डेटा के लिए SCAN_REQ भेजता है)
  --environment {free_space,indoor,outdoor}
                        दूरी अनुमान पाथ-लॉस मॉडल (डिफ़ॉल्ट: free_space)
  --ref-rssi DBM        दूरी अनुमान के लिए 1 मीटर पर कैलिब्रेटेड RSSI
  --name-filter PATTERN नाम द्वारा डिवाइस फ़िल्टर करें (केस-असंवेदनशील सबस्ट्रिंग मिलान)
  --alert-within METERS निकटता अलर्ट जब डिवाइस इस दूरी के भीतर हो
  --tui                 स्क्रॉलिंग आउटपुट के बजाय लाइव-अपडेट होने वाली टर्मिनल तालिका
  --gui                 ब्राउज़र में वेब-आधारित रडार इंटरफ़ेस लॉन्च करें
  --gui-port PORT       GUI वेब सर्वर के लिए पोर्ट (डिफ़ॉल्ट: 5000)
  --no-gps              GPS स्थान स्टैम्पिंग अक्षम करें (GPS डिफ़ॉल्ट रूप से gpsd के माध्यम से चालू है)
  --adapters LIST       अल्पविराम-पृथक ब्लूटूथ अडैप्टर नाम (जैसे hci0,hci1)

मोड 1: सभी डिवाइस खोजें

सभी प्रसारण करने वाले BLE डिवाइसों के लिए स्कैन करें (डिफ़ॉल्ट 30-सेकंड टाइमआउट):

btrpa-scan --all

कस्टम टाइमआउट के साथ:

btrpa-scan --all -t 60

मोड 2: लक्षित खोज

MAC एड्रेस द्वारा किसी विशेष डिवाइस को खोजें:

btrpa-scan AA:BB:CC:DD:EE:FF

मोड 3: IRK रिज़ॉल्यूशन