Rugosa

Rugosa is a static malware analysis library and tool developed using the disassembler-agnostic dragodis API. It incorporates a binary emulation framework along with utilities for regex and YARA searching, string extraction, and function discovery within disassembled code. These features enhance capabilities for comprehensive malware analysis and metadata extraction.

Rugosa utilizes an in-house developed emulation engine entirely written in Python to achieve full control of the execution context and offer high-level abstractions for emulated artifacts. It adopts a targeted approach employing branch path tracing to emulate portions of code without the need to fully emulate preceding code or modify the binary to accommodate such control flow.

Currently, x86 and ARM processors are supported.

Install

pip install rugosa

You will also need to setup a backend disassembler by following Dragodis's installation instructions.

Utilities

The following utilities are included with Rugosa:

• Emulation
• Extra Disssembly Interfaces
• Regex
• Strings
• YARA

Configuration

All options are configurable through a settings.toml file. This file can be modified to configure Rugosa.

Rugosa looks for a user defined configuration file at either ~/.config/rugosa/settings.toml or %LOCALAPPDATA%\dc3\rugosa\settings.toml to overwrite the default settings.

To view the current configuration run the following:

python -m rugosa.config list

To edit the configuration run the following to open the file in a text editor. (This will copy the default configuration into a user directory)

python -m rugosa.config edit

To create a new user configuration file without editing:

python -m rugosa.config create

We use Dynaconf which provides conveniences like setting configuration using environment variables prefixed with RUGOSA_.

For example, to change the computer name used during emulation:

export RUGOSA_MACHINE__COMPUTER_NAME=BOB_PC  # '__' to access nested field.

Interactive Shell

Rugosa includes an interactive shell created with cmd2 for emulating and traversing a given binary. For more information on how to use the tool, please see the documentation.

Emulator Plugin

Rugosa includes a IDA and Ghidra plugin which provides a GUI for using the emulation utility. For more information on how to install and use the plugin please see the documentation.