Skip to content

Commit

Permalink
Updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
etz69 committed Apr 13, 2017
1 parent 39526d7 commit 643f00f
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 280 deletions.
51 changes: 48 additions & 3 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -110,10 +110,16 @@ IRHelper concepts
Prerequisites
==================

External prerequisites
There are some 3rd party tools which are required to run the different modules. One basic one is Volatilty. Volatility has to
be available in your path otherwise it will not be found from the modules and and you have to specify the full path. Currently
volatility 2.5 was used for the development of the current code.

Other tools are used such as:

* Exiftool
* Volatility
* ClamAV
* RegRipper



Install
Expand All @@ -124,7 +130,7 @@ Installation is quick and easy::
cd irhelper
virtualenv venv
source dev/bin/activate
pip install -r REQUIREMENTS.txt
pip install -r requirements.txt


Directory structure
Expand Down Expand Up @@ -262,9 +268,24 @@ You can also run each module on its own while testing::
Logging
-------

For logging purposes there are two methods used::

debug()
err()
print_header()

And the standard print!

Database
--------

New module development
------------------------

Edit cmd_processor.py and add your module as a method in the Modules() class.




Research
=========
Expand Down Expand Up @@ -297,6 +318,29 @@ https://malwareconfig.com/stats/
Step 4: Automated memory analysis
---------------------------------

Step 06: Packing/Entropy check
---------------------------------

**action:** Calculate the density (entropy) of specific filetypes (exe and dll)

**description:** Files with low entropy than normal (what is normal?) may be packed executables
which may lead you to potential malware on the system. The tool we select to carry out
the scan is DensityScout! We will also try standard entropy with python implementation (slower)
and slightly different than DensityScout and other approaches to detect packing
Most likely files with "entropy" less than 0.1 (DensityScout) we can bring to the attention of the analyst.
However in a default Windows installation we can see that there several legitimate files
below 0.1 . This technique is likely to produce false positives.Here we can use outliers

**references:**

* https://www.cert.at/downloads/software/densityscout_en.html
* https://github.com/bridgeythegeek/regentropy
* https://github.com/dchad/malware-detection


**feature:** Packing entropy information of extracted files



.. toctree::
:maxdepth: 2
Expand All @@ -313,6 +357,7 @@ Indices and tables
Module documentation
====================


.. automodule:: modules.cmd_processor
.. autoclass:: Modules
:members:
Expand Down
277 changes: 0 additions & 277 deletions vol_plugins/psinfo.py

This file was deleted.

0 comments on commit 643f00f

Please sign in to comment.