Performing Bluetooth Security Assessment
Overview
This skill covers performing Bluetooth Low Energy (BLE) security assessments using the Python bleak library. BLE devices are ubiquitous in IoT, healthcare, fitness, and smart home applications, and many ship with weak or absent security controls. This assessment identifies unencrypted GATT characteristics, devices broadcasting sensitive data, known vulnerable device fingerprints, and improperly secured pairing configurations.
The agent uses bleak's asyncio API to discover nearby BLE devices, connect to target devices, enumerate all GATT services and characteristics, and analyze security properties of each characteristic. It flags characteristics that allow unauthenticated read/write access to sensitive data and identifies devices matching known vulnerable profiles.
When to Use
Trigger phrases:
"performing bluetooth security assessment"
"Assess Bluetooth Low Energy device security by scanning, enumerating GATT servic"
When conducting security assessments that involve performing bluetooth security assessment
When following incident response procedures for related security events
When performing scheduled security testing or auditing activities
When validating security controls through hands-on testing
Prerequisites
- Python 3.9 or later
- bleak library (
pip install bleak)
- Bluetooth adapter supporting BLE (Bluetooth 4.0+)
- Linux: BlueZ 5.43+ with D-Bus permissions
- Windows: Windows 10 version 1709+ with Bluetooth support
- macOS: macOS 10.15+ with CoreBluetooth
Steps
Scan for BLE devices: Use BleakScanner to discover all advertising BLE devices within range. Capture device name, address (MAC), RSSI signal strength, and advertised service UUIDs.
Identify target devices: Filter discovered devices by name pattern, address, or minimum signal strength. Flag devices broadcasting default or well-known vulnerable names.
Connect and enumerate GATT services: Use BleakClient to connect to the target device and iterate over all GATT services. For each service, record the UUID, description, and contained characteristics.
Analyze characteristic properties: For each characteristic, examine its properties (read, write, write-without-response, notify, indicate). Flag characteristics that expose read or write access without requiring authentication or encryption.
Check for known vulnerable UUIDs: Compare discovered service and characteristic UUIDs against a database of known vulnerable or sensitive services (Heart Rate, Blood Pressure, Device Information, Battery Level) that should require encryption.
Detect unencrypted data exposure: Attempt to read characteristics that should be protected. Successful unauthenticated reads of sensitive data indicate missing security controls.
Generate security report: Compile all findings into a structured JSON report with severity classifications and remediation recommendations.
Expected Output
{
"assessment_type": "ble_security_audit",
"target_device": {
"name": "SmartBand-XR",
"address": "AA:BB:CC:DD:EE:FF",
"rssi": -42
},
"services_found": 5,
"characteristics_found": 18,
"findings": [
{
"severity": "high",
"finding": "Heart Rate Measurement readable without encryption",
"uuid": "00002a37-0000-1000-8000-00805f9b34fb",
"properties": ["read", "notify"],
"remediation": "Enable encryption requirement on characteristic"
}
],
"risk_score": 7.5
}
When NOT to Use
- You don't have explicit written authorization to test
- Task is about defense/detection, not offense (use detection skills)
- You need to implement security controls (use implementing-* skills)
- Task requires compliance auditing (use auditing-* skills)
- You're investigating an incident (use incident response skills)
- Target is out of scope for your engagement
- Task is about vulnerability scanning only (use scanning tools)
Red Flags
- Performing actions without explicit written authorization from the asset owner
- Testing against production systems without a defined scope and rules of engagement
- Sharing sensitive findings or credentials in unencrypted communications
- Failing to properly scope and contain the assessment before starting
Process
- Reconnaissance — Gather target information, identify attack surface, enumerate services
- Analysis/Exploitation — Execute the technique, analyze results, document findings
- Reporting — Document IOCs, write findings, provide remediation recommendations
Verification
- All steps executed successfully against a test environment before production use
- Output documented with screenshots or logs demonstrating expected behavior
- Results validated against known-good baselines or reference implementations
- Documentation complete enough for another analyst to reproduce findings
Anti-Rationalization Table
| Rationalization |
Reality |
| "We are too small to be targeted" |
Automated attacks target everyone. Size does not matter. |
| "Security slows us down" |
A breach slows you down 100x more. Build security in from the start. |
| "We will fix it after launch" |
Vulnerabilities in production are exploited within hours. Fix before deploy. |
1---2name: performing-bluetooth-security-assessment3description: Use when assess Bluetooth Low Energy device security by scanning, enumerating GATT services, and detecting vulnerabilities. Use when working with performing bluetooth security assessment.4license: Apache-2.05---6789# Performing Bluetooth Security Assessment1011## Overview1213This skill covers performing Bluetooth Low Energy (BLE) security assessments using the Python bleak library. BLE devices are ubiquitous in IoT, healthcare, fitness, and smart home applications, and many ship with weak or absent security controls. This assessment identifies unencrypted GATT characteristics, devices broadcasting sensitive data, known vulnerable device fingerprints, and improperly secured pairing configurations.1415The agent uses bleak's asyncio API to discover nearby BLE devices, connect to target devices, enumerate all GATT services and characteristics, and analyze security properties of each characteristic. It flags characteristics that allow unauthenticated read/write access to sensitive data and identifies devices matching known vulnerable profiles.161718## When to Use19**Trigger phrases:**20- "performing bluetooth security assessment"21- "Assess Bluetooth Low Energy device security by scanning, enumerating GATT servic"222324- When conducting security assessments that involve performing bluetooth security assessment25- When following incident response procedures for related security events26- When performing scheduled security testing or auditing activities27- When validating security controls through hands-on testing2829## Prerequisites3031- Python 3.9 or later32- bleak library (`pip install bleak`)33- Bluetooth adapter supporting BLE (Bluetooth 4.0+)34- Linux: BlueZ 5.43+ with D-Bus permissions35- Windows: Windows 10 version 1709+ with Bluetooth support36- macOS: macOS 10.15+ with CoreBluetooth3738## Steps39401. **Scan for BLE devices**: Use BleakScanner to discover all advertising BLE devices within range. Capture device name, address (MAC), RSSI signal strength, and advertised service UUIDs.41422. **Identify target devices**: Filter discovered devices by name pattern, address, or minimum signal strength. Flag devices broadcasting default or well-known vulnerable names.43443. **Connect and enumerate GATT services**: Use BleakClient to connect to the target device and iterate over all GATT services. For each service, record the UUID, description, and contained characteristics.45464. **Analyze characteristic properties**: For each characteristic, examine its properties (read, write, write-without-response, notify, indicate). Flag characteristics that expose read or write access without requiring authentication or encryption.47485. **Check for known vulnerable UUIDs**: Compare discovered service and characteristic UUIDs against a database of known vulnerable or sensitive services (Heart Rate, Blood Pressure, Device Information, Battery Level) that should require encryption.49506. **Detect unencrypted data exposure**: Attempt to read characteristics that should be protected. Successful unauthenticated reads of sensitive data indicate missing security controls.51527. **Generate security report**: Compile all findings into a structured JSON report with severity classifications and remediation recommendations.5354## Expected Output5556```json57{58 "assessment_type": "ble_security_audit",59 "target_device": {60 "name": "SmartBand-XR",61 "address": "AA:BB:CC:DD:EE:FF",62 "rssi": -4263 },64 "services_found": 5,65 "characteristics_found": 18,66 "findings": [67 {68 "severity": "high",69 "finding": "Heart Rate Measurement readable without encryption",70 "uuid": "00002a37-0000-1000-8000-00805f9b34fb",71 "properties": ["read", "notify"],72 "remediation": "Enable encryption requirement on characteristic"73 }74 ],75 "risk_score": 7.576}77```78## When NOT to Use7980- You don't have explicit written authorization to test81- Task is about defense/detection, not offense (use detection skills)82- You need to implement security controls (use implementing-* skills)83- Task requires compliance auditing (use auditing-* skills)84- You're investigating an incident (use incident response skills)85- Target is out of scope for your engagement86- Task is about vulnerability scanning only (use scanning tools)878889## Red Flags9091- Performing actions without explicit written authorization from the asset owner92- Testing against production systems without a defined scope and rules of engagement93- Sharing sensitive findings or credentials in unencrypted communications94- Failing to properly scope and contain the assessment before starting9596## Process97981. **Reconnaissance** — Gather target information, identify attack surface, enumerate services991. **Analysis/Exploitation** — Execute the technique, analyze results, document findings1001. **Reporting** — Document IOCs, write findings, provide remediation recommendations101102## Verification103104- All steps executed successfully against a test environment before production use105- Output documented with screenshots or logs demonstrating expected behavior106- Results validated against known-good baselines or reference implementations107- Documentation complete enough for another analyst to reproduce findings108109## Anti-Rationalization Table110111| Rationalization | Reality |112|---|---|113| "We are too small to be targeted" | Automated attacks target everyone. Size does not matter. |114| "Security slows us down" | A breach slows you down 100x more. Build security in from the start. |115| "We will fix it after launch" | Vulnerabilities in production are exploited within hours. Fix before deploy. |