Git Product home page Git Product logo

appmemdumper's Introduction

PyPi DOI Python Versions Known Vulnerabilities License

Introduction

This tool automates the research of some artifacts for forensics purpose in memory dumps based upon Volatility for a series of common Windows applications. It is aimed to facilitate triage while addressing multiple forensics images.

It can also open multiple archive formats. In case of an archive, the tool will extract all its files to a temporary directory and then try to open each file as a memory dump (except files named README or README.md).

System Requirements

This framework was tested on an Ubuntu 18.04 with Python 2.7. It relies on Foremost and Volatility

$ sudo apt-get install foremost
$ git clone https://github.com/volatilityfoundation/volatility /tmp/vol-setup
$ cd /tmp/vol-setup && sudo python setup.py install

Setup

$ pip install appmemdumper

Behind a proxy ?

Do not forget to add option --proxy=http://[user]:[pwd]@[host]:[port] to your pip command.

Quick Start

  1. Help
$ app-mem-dumper --help
AppMemDumper 2.4.3
Author   : Alexandre D'Hondt
Copyright: © 2020 A. D'Hondt
License  : GNU Affero General Public License v3.0

This tool automates the research of some artifacts for forensics purpose in memory dumps based upon Volatility for a
series of common Windows applications.

It can also open multiple archive formats (it uses pyunpack). In case of an archive, the tool will extract all its files
to a temporary directory and then try to open each file as a memory dump.

usage: ./app-mem-dumper [-a APPS] [-s SYST] [-f] [-p PLUGINS]
                       [--profile PROFILE] [-d DUMP_DIR] [-t TEMP_DIR] [-u]
                       [-h] [--help] [-v]
                       dump

positional arguments:
 dump  memory dump file path


application/system dumpers:
 -a APPS  comma-separated list of integers designating applications to be parsed
           Currently supported: 

            [0] AdobeReader             [8] Notepad
            [1] Chrome                  [9] OpenOffice
            [2] Firefox                 [10] PDFLite
            [3] FoxitReader             [11] SumatraPDF
            [4] InternetExplorer        [12] Thunderbird
            [5] KeePass                 [13] TrueCrypt
            [6] MSPaint                 [14] Wordpad
            [7] MediaPlayerClassic    
           (default: all)
 -s SYST  comma-separated list of integers designating system items to be parsed
           Currently supported: 

            [0] Autoruns                [9] Malfind
            [1] Clipboard               [10] Mimikatz
            [2] CommandLines            [11] NetworkConnections
            [3] CriticalProcessesInfo   [12] ProcessesInfo
            [4] Devices                 [13] Registry
            [5] DumpInfo                [14] Timeline
            [6] FilesList               [15] UserActivities
            [7] Kernel                  [16] UserHashes
            [8] LsaSecrets            
           (default: none)

volatility options:
 -f, --force           force profile search, do not use cached profile (default: False)
 -p PLUGINS, --plugins-dir PLUGINS
                       path to custom plugins (default: None)
 --profile PROFILE     force Volatility profile (default: None)
                        NB: has the precedence on -f/--force

output options:
 -d DUMP_DIR, --dump-dir DUMP_DIR
                       dump directory (default: files)
 -t TEMP_DIR, --temp-dir TEMP_DIR
                       temporary directory for decompressed images (default: .temp)
 -u, --update          update previous dump directories (default: False)

extra arguments:
 -h             show usage message and exit
 --help         show this help message and exit
 -v, --verbose  verbose mode (default: False)

Usage examples:
 ./app-mem-dumper memory.dmp
 ./app-mem-dumper my-dumps.tar.gz
 ./app-mem-dumper dumps.zip -a none -s all
 ./app-mem-dumper dump.raw -a 1,2,4 -f
 ./app-mem-dumper dump.mem -a 0,3,10,11 -s 0
 ./app-mem-dumper dump.raw -v --profile Win7SP1x86
  1. Example of output
$ app-mem-dumper memory.dump -v -p plugins
[appmemdumper] XX:XX:XX [DEBUG] Attempting to decompress 'memory.dump'...
[appmemdumper] XX:XX:XX [DEBUG] Not an archive, continuing...
[appmemdumper] XX:XX:XX [DEBUG] Setting output directory to 'files/memory.dump'...
[appmemdumper] XX:XX:XX [INFO] Opening dump file 'memory.dump'...
[appmemdumper] XX:XX:XX [INFO] Getting profile...
[appmemdumper] XX:XX:XX [INFO] Getting processes...
[appmemdumper] XX:XX:XX [DEBUG] > Executing command 'pslist'...
[appmemdumper] XX:XX:XX [DEBUG] Found       : mspaint.exe
[appmemdumper] XX:XX:XX [DEBUG] Not handled : audiodg.exe, csrss.exe, dllhost.exe, [...]
[appmemdumper] XX:XX:XX [DEBUG] Profile: Win7SP0x86
[appmemdumper] XX:XX:XX [INFO] Processing dumper 'dumpinfo'...
[appmemdumper] XX:XX:XX [INFO] Processing dumper 'mspaint'...
[appmemdumper] XX:XX:XX [DEBUG] Dumping for PID XXXX
[appmemdumper] XX:XX:XX [DEBUG] > Calling command 'memdump'...
[appmemdumper] XX:XX:XX [DEBUG] >> volatility --plugins=/path/to/plugins --file=[...]
[appmemdumper] XX:XX:XX [INFO] > /path/to/files/memory.dump/mspaint-2640-memdump.data
[appmemdumper] XX:XX:XX [WARNING] 
The following applies to collected objects of:
- mspaint

Raw data (.data files) requires manual handling ;
Follow this procedure:
1. Open the collected resources with Gimp
2. Set the width and height to the expected screen resolution
3. Set another color palette than 'RVB'
Restart this procedure by setting other parameters for width|height|palette.

appmemdumper's People

Contributors

dhondta 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

Watchers

 avatar  avatar  avatar  avatar  avatar

appmemdumper's Issues

Missing dependancies ?

root@kali:~/volatility# app-mem-dumper --help
Traceback (most recent call last):
File "/usr/local/bin/app-mem-dumper", line 59, in
parser.add_argument("dump", type=file_exists, help="memory dump file path")
NameError: name 'file_exists' is not defined

Python error during usage

Hi @dhondta

I encounter issue below when using 04/29/2019 release with app-mem-dumper -v dump.dmp:

Traceback (most recent call last):
  File "/usr/local/bin/app-mem-dumper", line 4, in <module>
    __import__('pkg_resources').run_script('appmemdumper==2.3.2', 'app-mem-dumper')
  File "/usr/lib/python2.7/dist-packages/pkg_resources/__init__.py", line 666, in run_script
    self.require(requires)[0].run_script(script_name, ns)
  File "/usr/lib/python2.7/dist-packages/pkg_resources/__init__.py", line 1453, in run_script
    .format(**locals()),
pkg_resources.ResolutionError: Script 'scripts/app-mem-dumper' not found in metadata at '/usr/local/lib/python2.7/dist-packages/appmemdumper-2.3.2.dist-info'

I'm using volatility 2.6.1 on Linux kali 5.3.0-kali2-amd64.
Every requirement are installed.

Sincerely,
WikiJM

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.