Skip to content

Sideloading detection & monitor sideloader countermeasure #2551

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Apr 14, 2025

Conversation

kevoreilly
Copy link
Owner

No description provided.

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.

Hello @kevoreilly, 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!

Summary of Changes

This pull request introduces a mechanism to detect and counter DLL sideloading attacks. It adds functionality to identify potentially malicious DLLs within a directory by comparing them against known system DLLs. If sideloading is detected, the pull request implements a countermeasure by copying necessary DLLs (capemon.dll and version.dll) and a configuration file into the application's directory, effectively sideloading the monitoring DLLs instead of the potentially malicious ones. The changes primarily affect the analyzer/windows/lib/api/process.py file, with additions to the lib/common/constants.py file to define sideloading DLL names.

Highlights

  • DLL Sideloading Detection: Implements a function detect_dll_sideloading to identify potential DLL sideloading attacks by comparing DLLs in a directory against known system DLLs.
  • Sideloading Countermeasure: If sideloading is detected, the pull request copies capemon.dll, version.dll, and a configuration file into the application's directory to counter the attack.
  • New Constants: Adds constants for the names of the 32-bit and 64-bit sideloader DLLs (SIDELOADER32_NAME and SIDELOADER64_NAME) in lib/common/constants.py.

Changelog

Click here to see the changelog
  • analyzer/windows/lib/api/process.py
    • Added create_unicode_buffer and windll imports from ctypes.
    • Added SIDELOADER32_NAME and SIDELOADER64_NAME to the list of imported constants from lib.common.defines.
    • Added CSIDL constants for system directories.
    • Initialized self.path to None in the __init__ method.
    • Added get_folder_path method to retrieve system folder paths using SHGetFolderPathW.
    • Added detect_dll_sideloading method to detect potential DLL sideloading attacks.
    • Assigned the path variable to self.path in the execute method.
    • Modified the inject method to implement the sideloading countermeasure if DLL sideloading is detected.
    • Removed the ": %s" from the log message in the ttd_stop method.
    • Copied the capemon.dll, version.dll, and config.ini files to the application directory if sideloading is detected.
  • analyzer/windows/lib/common/constants.py
    • Added constants SIDELOADER32_NAME and SIDELOADER64_NAME to define the names of the sideloader DLLs.
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 in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

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 issue 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 is currently in preview and 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 to provide feedback.

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.


A DLL,
a wolf in system's clothing,
fooled no more now.

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 DLL sideloading detection and a countermeasure to copy necessary DLLs to the application's directory. The changes look good overall, but there are a few areas that could be improved for clarity and robustness.

Summary of Findings

  • Error Handling in detect_dll_sideloading: The detect_dll_sideloading function catches all exceptions. It would be better to catch specific exceptions to avoid masking unexpected errors.
  • Redundant os.path.join calls: In the inject function, os.path.join is called multiple times with the same directory. This can be simplified.
  • Missing Error Handling for File Copy Operations: The copy function in inject does not have error handling. If the copy fails, the analysis might proceed with missing DLLs.

Merge Readiness

The pull request introduces important functionality for detecting and mitigating DLL sideloading. However, the identified issues, particularly the broad exception handling and lack of error checking during file copy operations, should be addressed before merging to ensure the stability and reliability of the analysis. I am unable to approve this pull request, and others should review and approve this code before merging.

@kevoreilly kevoreilly merged commit 2d7e004 into master Apr 14, 2025
5 of 6 checks passed
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.

1 participant