
s800-vehicle-network-security-testing
Vehicle network security testing framework for automotive CAN bus and network protocol analysis
- Installs
- 724
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/reason-machines/security-skills --skill s800-vehicle-network-security-testing- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads s800-vehicle-network-security-testing automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
S800 Vehicle Network Security Testing Framework
Skill by ara.so — Security Skills collection.
Overview
S800 is a vehicle network security testing framework designed for automotive security researchers and penetration testers. It provides tools for analyzing, testing, and securing automotive networks including CAN bus, LIN, FlexRay, and other vehicle communication protocols. The framework enables security assessment of Electronic Control Units (ECUs), protocol fuzzing, traffic analysis, and vulnerability discovery in automotive systems.
Note: This is a testing framework. Only use on vehicles and systems you have explicit authorization to test. Unauthorized vehicle network testing may be illegal and dangerous.
Installation
Prerequisites
- Python 3.7 or higher
- SocketCAN kernel modules (Linux)
- CAN hardware interface (USB-to-CAN adapter, OBD-II dongle, etc.)
- Root/sudo access for network interface configuration
Basic Installation
# Clone the repository
git clone https://github.com/zhu-zhu666/S800-Vehicle-Network-Security-Testing-Framework.git
cd S800-Vehicle-Network-Security-Testing-Framework
# Install Python dependencies
pip install -r requirements.txt
# Install system dependencies (Ubuntu/Debian)
sudo apt-get update
sudo apt-get install can-utils python3-can
Hardware Setup
# Load SocketCAN kernel modules
sudo modprobe can
sudo modprobe can_raw
sudo modprobe vcan
# Setup virtual CAN interface (for testing without hardware)
sudo ip link add dev vcan0 type vcan
sudo ip link set up vcan0
# Setup physical CAN interface (example with slcan)
sudo slcand -o -c -s6 /dev/ttyUSB0 can0
sudo ip link set up can0
# Set CAN bitrate (common automotive: 500kbps)
sudo ip link set can0 type can bitrate 500000
Core Components
1. CAN Bus Analyzer
Capture and analyze CAN bus traffic:
from s800.can_analyzer import CANAnalyzer
from s800.utils import setup_interface
# Initialize analyzer
analyzer = CANAnalyzer(interface='can0')
# Start capturing traffic
analyzer.start_capture(duration=60) # Capture for 60 seconds
# Analyze captured frames
stats = analyzer.get_statistics()
print(f"Total frames: {stats['total_frames']}")
print(f"Unique IDs: {stats['unique_ids']}")
print(f"Average data rate: {stats['avg_rate']} frames/sec")
# Export captured data
analyzer.export_pcap('capture.pcap')
analyzer.export_csv('capture.csv')
2. Protocol Fuzzer
Fuzz CAN messages to discover vulnerabilities:
from s800.fuzzer import CANFuzzer
from s800.payloads import PayloadGenerator
# Initialize fuzzer
fuzzer = CANFuzzer(interface='can0')
# Define target CAN ID range
target_ids = range(0x100, 0x200)
# Generate mutation-based payloads
payload_gen = PayloadGenerator()
payloads = payload_gen.generate_mutations(
base_data=[0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07],
mutation_rate=0.3,
count=1000
)
# Run fuzzing campaign
fuzzer.fuzz(
can_ids=target_ids,
payloads=payloads,
delay=0.01, # 10ms between frames
monitor=True, # Monitor for anomalies
callback=lambda result: print(f"Sent: {result}")
)
3. ECU Identification
Identify and fingerprint ECUs on the network:
from s800.ecu_scanner import ECUScanner
from s800.diagnostics import UDSClient
# Scan for active ECUs
scanner = ECUScanner(interface='can0')
ecus = scanner.scan_range(0x700, 0x7FF)
print(f"Found {len(ecus)} ECUs:")
for ecu in ecus:
print(f" ID: 0x{ecu['id']:03X}, Type: {ecu['type']}")
# Query ECU information via UDS (ISO 14229)
uds = UDSClient(interface='can0', ecu_id=0x7E0)
# Read DID (Data Identifier)
vin = uds.read_data_by_id(0xF190) # VIN
print(f"VIN: {vin.decode()}")
# Read diagnostic trouble codes
dtcs = uds.read_dtc()
print(f"Diagnostic Trouble Codes: {dtcs}")
4. Replay Attack
Record and replay CAN traffic:
from s800.replay import CANReplay
import time
# Record session
recorder = CANReplay(interface='can0')
print("Recording traffic... Press Ctrl+C to stop")
try:
recorder.start_recording()
time.sleep(30) # Record for 30 seconds
except KeyboardInterrupt:
pass
recorder.stop_recording()
recorder.save_session('door_unlock_sequence.s800')
# Replay recorded session
replayer = CANReplay(interface='can0')
replayer.load_session('door_unlock_sequence.s800')
# Replay with original timing
replayer.replay(preserve_timing=True)
# Replay at faster speed
replayer.replay(speed_multiplier=2.0)
# Replay single frame repeatedly
replayer.replay_frame(index=15, count=100, interval=0.05)
5. Man-in-the-Middle
Intercept and modify CAN traffic:
from s800.mitm import CANBridge
from s800.filters import MessageFilter
# Create bridge between two CAN interfaces
bridge = CANBridge(interface_a='can0', interface_b='can1')
# Define filtering rules
def modify_speed(msg):
"""Modify speed data (example: reduce displayed speed)"""
if msg.arbitration_id == 0x320: # Speed message ID
# Modify byte 3-4 (speed value)
speed = int.from_bytes(msg.data[2:4], byteorder='big')
new_speed = int(speed * 0.8) # Reduce by 20%
msg.data[2:4] = new_speed.to_bytes(2, byteorder='big')
return msg
# Add filter
bridge.add_filter(modify_speed)
# Block specific messages
bridge.block_id(0x400) # Block messages with ID 0x400
# Start bridging
bridge.start()
Configuration
Configuration File (config.yaml)
interfaces:
primary: can0
secondary: can1
virtual: vcan0
capture:
buffer_size: 10000
auto_save: true
output_dir: ./captures/
fuzzer:
default_delay: 0.01
max_iterations: 10000
crash_detection: true
anomaly_threshold: 5.0
scanner:
timeout: 1.0
retry_count: 3
id_range:
start: 0x000
end: 0x7FF
uds:
default_timeout: 2.0
session_type: extended # default, extended, programming
security_access: false
logging:
level: INFO
file: s800.log
console: true
Load configuration:
from s800.config import Config
config = Config.load('config.yaml')
analyzer = CANAnalyzer(
interface=config.interfaces['primary'],
buffer_size=config.capture['buffer_size']
)
Advanced Usage
Custom Protocol Analysis
from s800.protocols import ProtocolDecoder
class CustomProtocolDecoder(ProtocolDecoder):
"""Decode proprietary protocol"""
def decode(self, msg):
if msg.arbitration_id == 0x300:
return {
'type': 'sensor_data',
'temperature': msg.data[0] - 40, # Offset by 40
'pressure': int.from_bytes(msg.data[1:3], 'big') / 10,
'status': msg.data[3]
}
return None
# Use custom decoder
analyzer = CANAnalyzer(interface='can0')
analyzer.add_decoder(CustomProtocolDecoder())
analyzer.start_capture()
Anomaly Detection
from s800.ml import AnomalyDetector
# Train baseline model
detector = AnomalyDetector()
detector.train_from_pcap('normal_traffic.pcap')
# Real-time anomaly detection
analyzer = CANAnalyzer(interface='can0')
def check_anomaly(msg):
if detector.is_anomaly(msg):
print(f"ANOMALY DETECTED: ID=0x{msg.arbitration_id:03X}")
print(f" Data: {msg.data.hex()}")
# Take action (log, alert, block, etc.)
analyzer.add_callback(check_anomaly)
analyzer.start_capture()
Automated Security Assessment
from s800.assessment import SecurityAssessment
# Run comprehensive security assessment
assessment = SecurityAssessment(interface='can0')
results = assessment.run_all_tests(
tests=[
'ecu_discovery',
'uds_services',
'authentication_bypass',
'replay_protection',
'fuzzing_resilience'
],
report_format='html'
)
assessment.save_report('security_report.html')
print(f"Assessment complete. Score: {results['security_score']}/100")
CLI Commands
Basic Commands
# Capture CAN traffic
python s800.py capture -i can0 -d 60 -o capture.pcap
# Scan for ECUs
python s800.py scan -i can0 --range 0x700-0x7FF
# Fuzz CAN IDs
python s800.py fuzz -i can0 --ids 0x100-0x200 --count 1000
# Replay traffic
python s800.py replay -i can0 -f capture.pcap --speed 1.0
# UDS diagnostics
python s800.py uds -i can0 --ecu 0x7E0 --read-vin
# Run security assessment
python s800.py assess -i can0 --output report.html
Advanced Commands
# MITM with filtering
python s800.py mitm -a can0 -b can1 --block 0x400 --modify speed_reducer.py
# Export analysis
python s800.py analyze -f capture.pcap --export csv --stats
# Differential analysis
python s800.py diff baseline.pcap test.pcap --threshold 0.05
Environment Variables
# Default CAN interface
export S800_INTERFACE=can0
# Configuration file path
export S800_CONFIG=/etc/s800/config.yaml
# Output directory
export S800_OUTPUT_DIR=/var/log/s800/
# Debug mode
export S800_DEBUG=1
# API endpoint (if using remote analysis)
export S800_API_URL=https://analysis.example.com
export S800_API_KEY=your_api_key_here
Common Patterns
Pattern 1: Pre-Test Baseline Capture
# Always capture baseline before testing
baseline = CANAnalyzer(interface='can0')
baseline.start_capture(duration=300) # 5 minutes
baseline.save('baseline.pcap')
# Run tests
# ...
# Compare with baseline
test_capture = CANAnalyzer(interface='can0')
test_capture.start_capture(duration=60)
diff = test_capture.compare_with('baseline.pcap')
print(f"New messages: {diff['new_ids']}")
Pattern 2: Safe Fuzzing
# Monitor system health during fuzzing
from s800.monitoring import SystemMonitor
monitor = SystemMonitor(interface='can0')
fuzzer = CANFuzzer(interface='can0')
monitor.add_safety_check('ecu_response', timeout=5.0)
monitor.add_safety_check('error_frames', threshold=10)
fuzzer.set_safety_monitor(monitor)
fuzzer.fuzz(can_ids=[0x100], payloads=payloads, emergency_stop=True)
Troubleshooting
CAN Interface Not Found
# Check interface status
ip link show can0
# Verify kernel modules
lsmod | grep can
# Check dmesg for errors
dmesg | grep can
Permission Denied
# Add user to dialout group (for USB devices)
sudo usermod -a -G dialout $USER
# Run with sudo (temporary)
sudo python s800.py capture -i can0
No Traffic Received
# Verify bitrate matches vehicle
sudo ip link set can0 type can bitrate 500000
# Check for bus-off state
candump can0 -e # Show error frames
# Test with cansend
cansend can0 123#DEADBEEF
High Bus Load
# Limit capture rate
analyzer = CANAnalyzer(interface='can0', filter_ids=[0x100, 0x200])
# Use hardware filtering if available
analyzer.set_hardware_filter(mask=0x700, match=0x300)
Safety and Legal Warnings
- Only test systems you own or have written authorization to test
- Never test on public roads or active vehicles
- Automotive systems control safety-critical functions
- Improper testing can cause vehicle damage or safety hazards
- Always have emergency stop procedures in place
- Consult legal counsel before testing automotive systems
Resources
- Repository: https://github.com/zhu-zhu666/S800-Vehicle-Network-Security-Testing-Framework
- CAN Bus Specification: ISO 11898
- UDS Protocol: ISO 14229
- Automotive Ethernet: IEEE 802.1
- SocketCAN Documentation: https://www.kernel.org/doc/html/latest/networking/can.html
FAQ
What does the s800-vehicle-network-security-testing skill do?
Vehicle network security testing framework for automotive CAN bus and network protocol analysis
How do I install s800-vehicle-network-security-testing?
Run npx skills add https://github.com/reason-machines/security-skills --skill s800-vehicle-network-security-testing in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/s800-vehicle-network-security-testing/ (personal) or .claude/skills/s800-vehicle-network-security-testing/ (project).
Which AI agents can use s800-vehicle-network-security-testing?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is s800-vehicle-network-security-testing safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains s800-vehicle-network-security-testing?
It is published by reason-machines in reason-machines/security-skills. It has 724 recorded installs.
More from reason-machines/security-skills
anthropic-cybersecurity-skills
reason-machines/security-skills
Use 754 structured cybersecurity skills mapped to MITRE ATT&CK, NIST CSF, ATLAS, D3FEND, and NIST AI RMF for AI-driven security operations
pentest-ai-agents
reason-machines/security-skills
Claude Code subagents for offensive security research, penetration testing planning, recon analysis, exploit research, detection engineering, and security reporting
pentest-agents-bug-bounty-framework
reason-machines/security-skills
Autonomous bug bounty agent framework with 50 agents, hunt loops, exploit chains, MCP servers for platform integration and writeup search
openosint-ai-osint-framework
reason-machines/security-skills
AI-powered OSINT agent with interactive REPL, MCP server, and CLI for email/username/domain/IP/phone investigation using 11 integrated tools
vibe-security-skill
reason-machines/security-skills
Agent skill that audits vibe-coded apps for common security vulnerabilities introduced by AI coding assistants
openclaw-security-hardening
reason-machines/security-skills
Deploy and manage security hardening for high-privilege autonomous AI agents (OpenClaw) using zero-trust architecture and automated defense matrices
Popular security skills
azure-compliance
microsoft/azure-skills
Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.
minimal-run-and-audit
lllllllama/rigorpilot-skills
Rigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation command and write standardized reprooutputs/ files, including patch notes when repository files changed. Do not use for training execution, initial repo intake, generic environment setup, paper lookup, target selection, hidden scientific-meaning changes, or end-to-end orchestration by itself.
seo-audit
coreyhaines31/marketingskills
When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.
firebase-security-rules-auditor
firebase/agent-skills
Audits Firebase (Firestore, Cloud Storage) security rules for vulnerabilities, privilege escalation, role bypasses, create vs update inconsistencies, resource exhaustion, type safety, size limits, and hasOnly ownership checks. Use when auditing/reviewing rules, running red-team rule assessments, or scoring against auditor checklists. Don't use for Firebase CLI (login, deploy), Auth, Crashlytics, Remote Config, or database queries.
audit
pbakaus/impeccable
Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.
competitors
coreyhaines31/marketingskills
When the user wants to create competitor comparison or alternative pages for SEO and buyer-facing use. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'competitor teardown,' 'audit our competitor pages,' 'are our comparison pages out of date,' or 'competitive asset audit.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For auditing existing claims (not researching competitors from scratch, which is competitor-profiling; not technical SEO on these pages, which is seo-audit), use the asset audit here. For internal battle cards and sales-specific competitor docs, see sales-enablement.