Skip to content

Add DecompressEXE signature for memory analysis#523

Open
kevross33 wants to merge 2 commits intoCAPESandbox:masterfrom
kevross33:patch-87
Open

Add DecompressEXE signature for memory analysis#523
kevross33 wants to merge 2 commits intoCAPESandbox:masterfrom
kevross33:patch-87

Conversation

@kevross33
Copy link
Contributor

@kevross33 kevross33 commented Feb 5, 2026

This module defines a signature for detecting decompression of executables in memory, which may indicate the use of packers or manual loaders.

Pikabot:
image

This module defines a signature for detecting decompression of executables in memory, which may indicate the use of packers or manual loaders.
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @kevross33, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the malware analysis capabilities by introducing a new signature designed to identify executables that decompress themselves in memory. This is a crucial step in detecting packed or manually loaded malware, providing deeper insight into their runtime behavior and improving the overall efficacy of threat detection.

Highlights

  • New Cuckoo Signature: A new Cuckoo Sandbox signature, DecompressEXE, has been added to detect in-memory decompression of executables.
  • Detection Logic: The signature specifically monitors for calls to the RtlDecompressBuffer API and checks if the resulting uncompressed buffer begins with the 'MZ' magic bytes, indicating a Portable Executable (PE) file.
  • Malware Analysis Focus: This detection aims to identify the use of packers or manual loaders, which are common techniques used by malicious software to evade detection and obfuscate their true nature.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • modules/signatures/windows/packer_decompress_buffer.py
    • Added a new file defining the DecompressEXE signature.
    • Implemented logic to detect RtlDecompressBuffer API calls.
    • Included a check for the 'MZ' header in the uncompressed buffer to confirm it's an executable.
    • Configured signature metadata including severity, confidence, categories (packer), authors, minimum Cuckoo version, and relevant MITRE ATT&CK (TTPs) and Malware Behavior Catalog (MBCs) identifiers.
Activity
  • No human activity has occurred on this pull request yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new Cuckoo signature to detect in-memory decompression of executables by monitoring RtlDecompressBuffer API calls. The overall logic is sound, but I've identified a critical issue that could lead to a crash, as well as several opportunities for simplification and adherence to the framework's patterns. Additionally, some of the MITRE ATT&CK and MBC references appear to be invalid.

Comment on lines +28 to +29
ttps = ["T1027", "T1027.002", "T1620"]
mbcs = ["B0002", "F0001", "OB0006"]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The ttps and mbcs lists contain references that are not defined in the corresponding data files (data/mitre/TTPs.json and data/mbc.json).

  • T1620 is not present in TTPs.json.
  • F0001 and OB0006 are not present in mbc.json. The mbc.json file uses a B prefix for behaviors (e.g., B0002). OB0006 might be a typo for B0006 or one of its sub-behaviors.

Using invalid references can lead to errors or incomplete information in the analysis reports. Please verify these references and update them to valid ones.

Comment on lines 33 to 47
def __init__(self, *args, **kwargs):
Signature.__init__(self, *args, **kwargs)
self.ret = False

def on_call(self, call, process):
if not call["status"]:
return None
if call["api"] == "RtlDecompressBuffer":
buf = self.get_argument(call, "UncompressedBuffer")
if buf.startswith("MZ"):
self.ret = True
self.mark_call()

def on_complete(self):
return self.ret
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The self.ret flag is redundant. The Signature base class already provides a mechanism for tracking matched calls via self.mark_call() and self.has_marks(). Using the base class functionality simplifies the code and removes unnecessary state management.

I recommend the following refactoring:

  1. Remove the __init__ method entirely.
  2. In on_call, remove the line self.ret = True. The self.mark_call() is sufficient.
  3. In on_complete, change the implementation to return self.has_marks().

This will make the signature cleaner and more aligned with the framework's intended patterns.

def on_call(self, call, process):
if not call["status"]:
return None
if call["api"] == "RtlDecompressBuffer":
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This check for call["api"] is redundant because you've already specified filter_apinames. The on_call handler will only be triggered for RtlDecompressBuffer. You can remove this if statement and un-indent the nested code block.

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants