Giter VIP home page Giter VIP logo

pcapfex's Introduction

pcapfex

'Packet CAPture Forensic Evidence eXtractor' is a tool that finds and extracts files from packet capture files.

It was developed by Viktor Winkelmann as part of a bachelor thesis.

The power of pcapfex lies in it's ease of use. You only provide it a pcap-file and are rewarded a structured export of all files found in it. pcacpfex allows data extraction even if non-standard protocols were used. It's easy to understand plugin-system offers python developers a quick way to add more file-types, encodings or even complex protocols.

Requirements

pcapfex was developed and tested for Linux environments only. Due to missing optimizations and tests, there is no guarantee for it to work under Windows (though it should work).

pcapfex depends on Python 2.7 and the dpkt package. You can install it via

sudo pip install dpkt

To achieve better performance using a multithreaded search for file objects, you should install the regex package.

sudo pip install regex

However, this step is only optional.

Usage

To analyze a pcap-file samplefile.pcap just use

pcapfex.py samplefile.pcap

For more detailed usage information see

pcapfex.py -h

Please make sure to use the -nv flag, if the machine that captured the traffic was sending data as well. This will circumvent wrong checksums stored in the pcap-file caused by TCP-Checksum-Offloading.

License

pcapfex is published under the Apache 2.0 license.

pcapfex's People

Contributors

awantoch avatar vikwin avatar whackyhack avatar yotamho avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

pcapfex's Issues

How to migrate to Python3

I just use 2to3 to convert all py file to python3 version,it can runs, but has many encoding problem. So I replace all StringIO to BytesIO. But it doesn't work either

Handle incomplete captures

Sometimes a capture file contains incomplete packets. pcapfex would fail when dpkt raises NeedData.

  File "./pcapfex/pcapfex.py", line 36, in <module>
    dispatcher.run()
  File "./pcapfex/core/Dispatcher.py", line 34, in run
    streambuilder = StreamBuilder(self.pcapfile, **self.kwargs)
  File "./pcapfex/core/Streams/StreamBuilder.py", line 36, in __init__
    self.__parsePcapfile(pcapfile)
  File "./pcapfex/core/Streams/StreamBuilder.py", line 85, in __parsePcapfile
    eth = dpkt.ethernet.Ethernet(rawpacket)
  File "/Library/Python/2.7/site-packages/dpkt/ethernet.py", line 79, in __init__
    dpkt.Packet.__init__(self, *args, **kwargs)
  File "/Library/Python/2.7/site-packages/dpkt/dpkt.py", line 92, in __init__
    raise NeedData
dpkt.dpkt.NeedData

I submitted a PR #5 to address this.

Virus detected in file orig_file.exe

When I downloaded the code, my anti-virus program detected a virus in the file orig_file.exe which is in the folder pcapfex-master\tests\scenarios\4.6.

The antivirus report was:
Event: Risk Found!
Security risk detected: Trojan.ADH.SMH
File: pcapfex\pcapfex-master\tests\scenarios\4.6\orig_file.exe
Location: pcapfex\pcapfex-master\tests\scenarios\4.6

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.