MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads s800-vehicle-network-security-testing automatically when relevant.

  3. 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

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

View all →

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

AI & Agents1.7K installs

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

Security1.4K installs

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

Backend & APIs1.2K installs

vibe-security-skill

reason-machines/security-skills

Agent skill that audits vibe-coded apps for common security vulnerabilities introduced by AI coding assistants

Security1.1K installs

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

Security1.1K installs

Popular security skills

View category →

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.

OfficialSecurity567K installs

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.

Security477.4K installs

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.

Security238.7K installs

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.

OfficialSecurity139.1K installs

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.

Security81.9K installs

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.

Security79.3K installs