Vulcan

Overview

Vulcan is a Network Traffic simulation tool that can be used to generate text-based hexdumps of packets as well as native libpcap format packet captures.

Endpoints

/get-uptime

GET

Returns the Vulcan service's current uptime.

Returns: JSON

{
    "success": "uptime: 21 days, 0:32:59.665307"
}

/create-pcap

POST

Accepts: JSON as a list of packet objects.

Returns: .pcap file.

Error Returns: JSON

{
    "error": "Failed to assemble packet data: <error_data>"
}

Required Packet Object Fields

Session: Used for stream tracking

"session": {
    "id": "1"
}

Autofill: Indicates if Vulcan should fill in frame/packet gaps to make the network traffic valid (experimental)

"autofill": {
    "enabled": true
}

Frame Object: At least one transport from the optional frame objects is required to create the packet.

Frame Objects

Frames will accept any number of args that may be passed to the corresponding Scapy class.

Examples

ether: Ethernet frame

"ether": {
    "dst": "00:00:00:00:00:00",
    "src": "ff:ff:ff:ff:ff:ff",
    "type": "ipv4"
}

ip: IP frame

"ip": {
    "src": "10.10.10.10",
    "dst": "10.10.10.11",
    "ttl": "32",
    "version": "4"
}

tcp: TCP frame

"tcp": {
    "sport": "25565",
    "dport": "80",
    "seq": "0",
    "ack": "1",
    "flags": "PA",
    "window": "65535"
}

udp: UDP frame

"udp": {
    "sport": "25565",
    "dport": "80"
}

icmp: ICMP frame

"icmp": {
    "type": "8",
    "code": "1",
    "id": "1",
    "seq": "1"
}

dns: DNS frame

"dns": {
    "qname": "example.com",
    "qtype": "A",
    "rd": "1",
    "qr": "0",
    "answers": "179.23.99.1"
}

HTTP Request: HTTP Request frame

"http_request": {
    "headers": "Cache:nocache",
    "method": "GET",
    "path": "/",
    "version": "1.1"
}

HTTP Response: HTTP Response frame

"http_response": {
    "headers": "Cache:nocache",
    "code": "200",
    "reason": "OK",
    "version": "1.1"
}

raw: Payload frame

Hex payloads may be optionally delimited with spaces and optionally prefixed with '\x' or '0x'

"raw": {
    "payload": "example"
}

Full example:

[
  {
    "session": {
      "id": "1"
    },
    "autofill": {
      "enabled": false
    },
    "ether": {
      "type": "ipv4"
    },
    "ip": {
      "version": "4"
    },
    "tcp": {
      "sport": "12345",
      "dport": "80",
      "seq": "0",
      "ack": "0",
      "flags": "S",
      "window": "65535"
    }
  },
  {
    "session": {
      "id": "1"
    },
    "autofill": {
      "enabled": false
    },
    "ether": {
      "type": "ipv4"
    },
    "ip": {
      "version": "4"
    },
    "tcp": {
      "sport": "80",
      "dport": "12345",
      "seq": "0",
      "ack": "1",
      "flags": "SA",
      "window": "65535"
    }
  },
  {
    "session": {
      "id": ""
    },
    "autofill": {
      "enabled": false
    },
    "ether": {
      "type": "ipv4"
    },
    "ip": {
      "version": "4"
    },
    "tcp": {
      "sport": "12345",
      "dport": "80",
      "seq": "1",
      "ack": "1",
      "flags": "A",
      "window": "8192"
    }
  }
]