Malformity is a Maltego project based upon the Canari Framework. Using this framework greatly simplifies the process of installing local transforms in Maltego.

The project directory structure is as follows:

• src/Malformity directory is where all your stuff goes in terms of auxiliary modules that you may need for your modules
• src/Malformity/transforms directory is where all your transform modules should be placed.
• src/Malformity/transforms/common directory is where you can put some common code for your transforms like result parsing, entities, etc.
• src/Malformity/transforms/common/entities.py is where you define your custom entities.
• maltego/ is where you can store your Maltego entity exports.

If you're going to add a new transform in the transforms directory, remember to update the __all__ variable in src/Malformity/transforms/__init__.py. Otherwise, canari install-package won't attempt to install the transform. Alternatively, canari create-transform <transform name> can be used within the src/Malformity/transforms directory to generate a transform module and have it automatically added to the __init__.py file.

Malformity has been tested on Mac OSX. Transforms are written in Python version 2.7.

In order to make full use of Malformity, the setup script will download additional modules.

If for some reason these fail, requirements are:

• Canari 0.9
• Mechanize 0.2.5
• BeautifulSoup 3.2.1
• requests 1.2.0

$ sudo python setup.py install

After completing setup, the command below can be used to install Malformity in Maltego.

$ canari install-package Malformity

Special thanks is due to the following people:

• Nadeem Douba - For creating the Canari framework and offering great support
• ohdae - For allowing us to include his entity set in Malformity

@digital4rensics - www.digital4rensics.com - [email protected]