Skip to content

Latest commit

 

History

History
41 lines (25 loc) · 3.3 KB

README.md

File metadata and controls

41 lines (25 loc) · 3.3 KB

GitHub release Chat Support

FindYara

Use this IDA python plugin to scan your binary with yara rules. All the yara rule matches will be listed with their offset so you can quickly jump to them!

🍻 All credit for this plugin and the code goes to David Berard (@p0ly) 🍻

This plugin is copied from David's excellent findcrypt-yara plugin. This plugin just extends his to use any yara rule.

Using FindYara

The plugin can be launched from the menu using Edit->Plugins->FindYara or using the hot-key combination Ctrl-Alt-Y. When launched the FindYara will open a file selection dialogue that allows you to select your Yara rules file. Once the rule file has been selected FindYara will scan the loaded binary for rule matches.

All rule matches are displayed in a selection box that allows you to double click the matches and jump to their location in the binary.

Rules Not Matching Binary

FindYara scans the loaded PE sections in IDA, this means that yara rules that include matches on the PE header will not match in IDA. IDA does not load the PE header as a scannable section. Also, if you have not selected Load resources when loading your binary in IDA then the resources section will be unavailable for scanning.

This can lead to frustrating situations where a yara rule will match outside of IDA but not when using FindYara. If you encounter this try editing the yara rule to remove the matches on the PE header and resources sections.

Installing FindYara

Before using the plugin you must install the python Yara module in your IDA environment. The simplest way to do this is to use pip from a shell outside of IDA.
pip install yara-python.

Do not install the yara module by mistake. The yara python module will mess with your yara-python module so it must be uninstalled if it was installed by mistake.

Once you have the yara module installed simply copy the latest release of findyara.py into your IDA plugins directory and you are ready to start Yara scanning!

❗Compatibility Issues

FindYara has been developed for use with the IDA 7+ and Python 3 it is not backwards compatible.

FindYara requires a the python Yara module with version 4+ installed. Earlier versions of Yara are not compatible with the plugin and may cause issues due to breaking changes in the Yara match format.

Acknowledgments

A huge thank you to David Berard (@p0ly) - Follow him on GitHub here! This is mostly his code and he gets all the credit for the original plugin framework.

Also, hat tip to Alex Hanel @nullandnull - Follow him on GitHub here. Alex helped me sort through how the IDC methods are being used. His IDA Python book is a fantastic reference!!