saint-graves/sica-fondt
1
0
Fork 0
mirror of https://github.com/SHOGGOTH-SECTOR/sica-fondt.git synced 2026-08-01 08:30:20 +00:00
Code Issues Packages Projects Releases Wiki Activity
sica-fondt/knowledge/cyber-skills/skills/performing-vlan-hopping-attack/references/api-reference.md
Claude 24f816b6a3
Consolidate 22 sibling repos into layered organism structure 
Place useful parts of the surrounding repos into sica-fondt by layer, per the
body model (Ada = membrane; brain/endocrine/capabilities/knowledge non-Ada):

- brain/        LLM reasoning + providers (dapr, hermes, MoMoA)
- capabilities/ REPRAG sidecars: hermes tools/skills, dapr tools, parallel
                dispatch, A51 channels, and the OSINT cluster
- knowledge/    LORAG corpus: 754 cyber-skills, agency personas, secure-coding,
                MITRE ATT&CK data
- reference/    defensive threat-reference (C3, shhbruh doc) + AdaYaml parser

License handling: AGPL sources (worldosint, advanced_evolution, mercury,
Reticulum) and GPL DeTTECT are SPEC-only clean-room/port descriptions — no
copyleft code copied. MIT/Apache/data parts copied as working trees.

Safety: shhbruh escape/persistence material and C3 covert-C2 kept as reference
only, not wired into the running organism. See CONSOLIDATION.md.

https://claude.ai/code/session_01UehUqEXXJJCsHoA4voCU5c
2026-06-10 06:53:01 +00:00

2.1 KiB
Raw Blame History

API Reference: VLAN Hopping Attack Agent

Overview

Tests VLAN segmentation effectiveness using scapy for DTP switch spoofing and 802.1Q double-tagging attacks in authorized penetration testing environments.

Dependencies

Package Version Purpose
scapy >= 2.5 Packet crafting for DTP and Dot1Q frames
subprocess stdlib Interface management and modprobe

Core Functions

listen_for_dtp(iface, timeout)

Sniffs for DTP frames on the interface to detect trunk negotiation capability.

  • Returns: dict with dtp_frames_received, dtp_active, details

listen_for_cdp_lldp(iface, timeout)

Captures CDP and LLDP discovery frames to identify the connected switch.

  • Returns: dict with frames and switch_discovered

send_dtp_desirable(iface, count)

Sends DTP desirable frames to negotiate a trunk link on an access port.

  • Protocol: DTP multicast to 01:00:0c:cc:cc:cc
  • Returns: dict with frames_sent, type

create_vlan_interface(iface, vlan_id, ip_addr)

Creates 802.1Q VLAN subinterface after successful trunk negotiation.

  • Requires: 8021q kernel module
  • Returns: dict with vlan_interface, vlan_id, ip

send_double_tagged(iface, outer_vlan, inner_vlan, target_ip)

Crafts and sends double-tagged 802.1Q frames for VLAN hopping.

  • Note: Unidirectional attack - no return traffic expected
  • Returns: dict with VLAN IDs and target

cleanup_vlan_interfaces(iface, vlan_ids)

Removes VLAN subinterfaces created during testing.

run_assessment(iface, target_vlans, target_ips)

Full assessment: DTP listening, switch spoofing, double tagging, cleanup.

Scapy Layers Used

Layer Purpose
Ether Ethernet frame construction
Dot1Q 802.1Q VLAN tagging (single and double)
LLC/SNAP DTP frame encapsulation
IP/ICMP Test payload for VLAN reachability

Requirements

  • Root/sudo privileges for raw packet operations
  • Monitor mode or promiscuous mode capable interface
  • Authorization for target network testing

Usage

sudo python agent.py eth0