Skip to content

A set of utilities allowing the user to automate collection of packet captures on a remote system which supports SSH and tcpdump (basically most Unix/Linux systems)

License

Notifications You must be signed in to change notification settings

Arcopix/remoteShark

Repository files navigation

remoteShark

A set of utilities allowing the user to capture traffic in real-time from remote system which supports SSH and tcpdump (basically most Unix/Linux systems) into local Wireshark.

Versions

  • Python - Full implementation of the utility in Python 3 with multi OS support.
  • Window - Initial/proof of concept version implemented in a simple BAT file.
    • Version is obsolete
  • Linux - Initial/proof of concept version implemented in a simple BASH file
    • Version is obsolete.

HOWTO

Listing interfaces

Listing interfaces on remote system 10.20.30.40:

remoteShark.py 10.20.30.40 --list-interfaces

Live packet captures

Capture any traffic on remote system 10.20.30.40:

remoteShark.py 10.20.30.40

Capture any traffic coming from host 10.10.10.10 on remote system 10.20.30.40:

remoteShark.py 10.20.30.40 -f "host 10.10.10.10"

Capture HTTP traffic (port 80) on interface eth0 on remote system 10.20.30.40:

remoteShark.py 10.20.30.40 -f "port 80" -i eth0

Capture SIP traffic (port 5060 or 5061) for 100 packets on any interface on remote system 10.20.30.40:

remoteShark.py 10.20.30.40 -f "port 5060 or 5061" -c 100

Capture SMTP traffic (port 25) for 5 minutes (300 seconds) on eth0.44 interface on remote system 10.20.30.40:

remoteShark.py 10.20.30.40 -f "port 25" -t 300 -i eth0.44

Processing remote PCAP files

Load file /tmp/capture.pcap from the remote system into Wireshark

remoteShark.py 10.20.30.40:/tmp/capture.pcap

Load file /tmp/capture.pcap and filter HTTP traffic from it:

remoteShark.py 10.20.30.40:/tmp/capture.pcap -f "port 80"

Load the first 100 packets from file /tmp/capture.pcap:

remoteShark.py 10.20.30.40:/tmp/capture.pcap -c 100

Load from file /tmp/capture.pcap for 5 seconds:

remoteShark.py 10.20.30.40:/tmp/capture.pcap -t 5

Note: this means that the system will be loading it for 5 seconds, and not the first 5 seconds of the remote packet capture

TODO

Current TODO/DONE list is available in TODO

CHANGELOG

The CHANGELOG is available here

About

A set of utilities allowing the user to automate collection of packet captures on a remote system which supports SSH and tcpdump (basically most Unix/Linux systems)

Resources

License

Stars

Watchers

Forks