Multidecoder
Multidecoder is a python library and command line tool for extracting indicators of compromise (IOCs) from a file. Multidecoder preserves the context of where and how an IOC is found to allow automated detection of patterns of obfuscation. Multidecoder is currently in alpha, and may change in ways that breaks backwards compatibility as developement continues.
Indicators of compromise extracted by Multidecoder:
- network IOCS: urls, domains, emails, ip addressses
- executable filenames
- embedded PowerShell
- embedded PE files
- a customizable set of keywords
Deobfuscations and decodings supported:
- base64 encoding
- hexadecimal encoding
- string concatenation
- powershell escape characters
Installing
Multidecoder can be installed from pypi using pip:
pip install -U multidecoder
Alternatly, it can also be installed from the repository:
pip install -U https://github.com/CybercentreCanada/Multidecoder/archive/main.zip
To test the latest development version, install from the dev branch:
pip install -U https://github.com/CybercenterCanada/Multidecoder/archive/dev.zip
Command Line
After being installed Multidecoder can be run on a file from the command-line
> multidecoder file
which will output a list of indicators found. Indicators are printed one per line, with a string representation of the context of the indicator followed by the indicator.
The raw json result can be output with the --json flag
> multidecoder --json file
if no filename is given multidecoder takes its standard input as the file to be scanned.
Python library
Multidecoder can be used as a python library through the Multidecoder class, which can scan data to give a dictionary tree similar to the command-line json output.
from multidecoder.multidecoder import Multidecoder
md = Multidecoder()
context_tree = md.scan(data)
1 maintainer
Release files for multidecoder 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| multidecoder-1.4.0.tar.gz | 90.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| multidecoder-1.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 197.1 kB
Release files / multidecoder-1.4.0.tar.gz
| Download URL | multidecoder-1.4.0.tar.gz |
|---|---|
| Size | 90.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bd74b6f3b8e3cccd514521e65f941db7cfb593ac5c4173d20d5ef6ea9b2c2e98
|
|
BLAKE2b-256 checksum How to use checksums |
43b6b9a1a1d23ecef09ed86e0338967bd2187bce255361a9d1377ff56914796a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.0 CPython/3.9.19
|
Release files / multidecoder-1.4.0-py3-none-any.whl
| Download URL | multidecoder-1.4.0-py3-none-any.whl |
|---|---|
| Size | 106.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3f6354f7bbe87ba76a53a4fa9ab9a563e8fca93148dad187dca985292ecec06a
|
|
BLAKE2b-256 checksum How to use checksums |
fbd7e1038cc8c9c4fe43791061e9d222e1ab04b3736d7435046f8078b21fdaf7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.0 CPython/3.9.19
|
