Skip to content

Latest commit

 

History

History
76 lines (43 loc) · 1.98 KB

README.rst

File metadata and controls

76 lines (43 loc) · 1.98 KB

bits_parser

Extract BITS jobs from QMGR queue and store them as CSV records.

This topic has been presented during a talk at the French conference CORI&IN 2018

Installation

If you want to run the latest version of bits_parser you can install it from PyPI by running the following command:

pip install bits_parser

To install it from the sources:

python setup.py install

Usage

QMGR queues are usually .dat files located in the folder %%ALLUSERSPROFILE%%\Microsoft\Network\Downloader on a Windows system.

Once those files have been located (e.g. qmgr0.dat and qmgr1.dat) you can run bits_parser by issuing the following command:

bits_parser qmgr0.dat

bits_parser also supports full-disk analysis but the process is longer and the results are dirtier (some data from adjacent data clusters can leak in the result). This mode is enable with the switch `-i`:

bits_parser -i image.bin

The disk mode works by looking for expected bit sequences (markers) and collecting surrounding data. The amount of surrounding data (the radiance) is settable and defaulted to 2048 kB:

bits_parser -i --radiance=4096 image.bin

Increasing the radiance could help to retrieve more data but the default value is normally enough.

When the processing is finished, the result is csv-formatted and then displayed on the standard output. The output can be written to a file with `-o`:

bits_parser -o jobs.csv qmgr0.dat

Use --help to display all options options of bits_parser.

Finding your naughty BITS [DFRWS USA 2015, Matthew Geiger]

BITSInject [DEFCON 2017, Dor Azouri]