{ "info": { "author": "Philippe Lagadec", "author_email": "", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Information Technology", "Intended Audience :: Science/Research", "Intended Audience :: System Administrators", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Topic :: Security" ], "description": "Balbuzard\n=========\n\n[Balbuzard](http://www.decalage.info/python/balbuzard) is a package of malware analysis tools in python to **extract patterns of interest from suspicious files** (IP addresses, domain names, known file headers, interesting strings, etc). \n\nIt can also **crack malware obfuscation** such as XOR, ROL, etc by bruteforcing and checking for those patterns.\n\nQuick links: [Download](http://bitbucket.org/decalage/balbuzard/downloads) - [Install](https://bitbucket.org/decalage/balbuzard/wiki/Installation) - [Documentation](https://bitbucket.org/decalage/balbuzard/wiki) - [Contact](http://www.decalage.info/contact) - [Report issues](https://bitbucket.org/decalage/balbuzard/issues?status=new&status=open) - [Updates on Twitter](https://twitter.com/decalage2)\n\n## Balbuzard tools:\n\n- [balbuzard](https://bitbucket.org/decalage/balbuzard/wiki/balbuzard/) is a tool to extract patterns of interest from malicious files, such as IP addresses, URLs, embedded files and typical malware strings. It is easily extensible with new patterns, regular expressions and Yara rules.\n- [bbcrack](https://bitbucket.org/decalage/balbuzard/wiki/bbcrack/) uses a new algorithm based on patterns of interest to bruteforce typical malware [obfuscation](https://bitbucket.org/decalage/balbuzard/wiki/Transforms) such as XOR, ROL, ADD and various combinations, in order to guess which algorithms/keys have been used. \n- [bbharvest](https://bitbucket.org/decalage/balbuzard/wiki/bbharvest/) extracts all patterns of interest found when applying typical malware [obfuscation transforms](https://bitbucket.org/decalage/balbuzard/wiki/Transforms) such as XOR, ROL, ADD and various combinations, trying all possible keys. It is especially useful when several keys or several transforms are used in a single file.\n- [bbtrans](https://bitbucket.org/decalage/balbuzard/wiki/bbtrans/) can apply any of the [transforms](https://bitbucket.org/decalage/balbuzard/wiki/Transforms) from bbcrack (XOR, ROL, ADD and various combinations) to a file.\n\n## When to use these tools:\n\n- If you need to analyze a new malicious file, you can first try [balbuzard](https://bitbucket.org/decalage/balbuzard/wiki/balbuzard/) to extract strings/patterns of interest and detect embedded files in cleartext.\n- Then if you think the malicious file might use an [obfuscation algorithm](https://bitbucket.org/decalage/balbuzard/wiki/Transforms) such as XOR to hide interesting data (e.g. an embedded executable file), try [bbcrack](https://bitbucket.org/decalage/balbuzard/wiki/bbcrack/) to find the algorithm and the key(s).\n- Alternatively, if bbcrack is not successful, or if you think the file may use several [algorithms](https://bitbucket.org/decalage/balbuzard/wiki/Transforms) and/or keys, try [bbharvest](https://bitbucket.org/decalage/balbuzard/wiki/bbharvest/). bbharvest is especially targeted at single strings obfuscated within an executable or malicious file.\n\n\n## 5 minutes demo\n\nSee the [Demo](https://bitbucket.org/decalage/balbuzard/wiki/Demo/) page to see examples and test the tools by yourself in a few minutes using the provided samples.\n\n## Help wanted: \n\n- if you have malware samples or malicious documents with known obfuscation algorithms such as XOR, please [contact me](http://www.decalage.info/contact). That will help me a lot to improve bbcrack and bbharvest.\n- if you know other strings, patterns, file headers useful for malware analysis that Balbuzard should support, or other [obfuscation algorithms](https://bitbucket.org/decalage/balbuzard/wiki/Transforms), please [contact me](http://www.decalage.info/contact).\n\n\nSee for more info and other tools.\n\n----------------------------------------------------------------------------------\n\n# News\n\nFollow all updates and news on Twitter: \n\n- **2014-05-22: Balbuzard v0.19 included in [REMnux v5](http://blog.zeltser.com/post/86508269224/remnux-v5-release-for-malware-analysts)**, pre-installed and ready to use.\n- 2014-03-23 v0.19: bugfix when Yara is not installed, improved [documentation](https://bitbucket.org/decalage/balbuzard/wiki).\n- 2014-02-26 v0.18: Initial release of Balbuzard tools\n- 2013-03-15: added harvest mode (bbharvest)\n- 2011-05-06: added bruteforce functions (bbcrack)\n- 2008-06-06: first public release as [reScan](http://decalage.info/rescan) for [SSTIC08](http://decalage.info/sstic08)\n- 2007-07-11: first versions of reScan\n- see changelog in source code for more info.\n\n\n# Download\n\nThe archive is available on [the project page on Bitbucket](https://bitbucket.org/decalage/balbuzard/downloads).\n\n\n# Installation\n\nSee the [installation instructions](https://bitbucket.org/decalage/balbuzard/wiki/Installation).\n\n\n# How to contribute / report bugs / ask for help:\n\nThese are open-source tools developed on my spare time. Any contribution such as code improvements, ideas, bug reports, additional patterns or transforms would be highly appreciated. You may contact me using [this online form](http://www.decalage.info/contact), by e-mail (decalage at laposte.net) or use the [issue page on Bitbucket](https://bitbucket.org/decalage/balbuzard/issues?status=new&status=open) to report bugs/ideas, or clone the project then send me pull requests to suggest changes.\n\n\nLicense\n=======\n\nThis license applies to the whole Balbuzard package including balbuzard, bbcrack, bbharvest and bbtrans, apart from the thirdparty and plugins folders which contain third-party files published with their own license.\n\nThe Balbuzard package is copyright (c) 2007-2014, Philippe Lagadec (http://www.decalage.info)\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n * Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.", "description_content_type": "", "docs_url": null, "download_url": "https://bitbucket.org/decalage/balbuzard/downloads", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://www.decalage.info/python/balbuzard", "keywords": "", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "balbuzard", "package_url": "https://pypi.org/project/balbuzard/", "platform": "", "project_url": "https://pypi.org/project/balbuzard/", "project_urls": { "Download": "https://bitbucket.org/decalage/balbuzard/downloads", "Homepage": "http://www.decalage.info/python/balbuzard" }, "release_url": "https://pypi.org/project/balbuzard/0.20/", "requires_dist": null, "requires_python": "", "summary": "Malware analysis tools to extract patterns of interest from files and crack obfuscation such as XOR", "version": "0.20" }, "last_serial": 5407648, "releases": { "0.18": [ { "comment_text": "", "digests": { "md5": "e6a66cb6dd5c61449c0fcb98d6280670", "sha256": "0640c2e2183614944ee2219abb2194cbfc8e56248822e95d31bd3a767e18527d" }, "downloads": -1, "filename": "balbuzard-0.18.zip", "has_sig": false, "md5_digest": "e6a66cb6dd5c61449c0fcb98d6280670", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1749956, "upload_time": "2014-03-04T21:33:31", "url": "https://files.pythonhosted.org/packages/01/58/bd578c45b65195d898ed2d9d1e0f5efeccaf81a0694f0c0de6b1fe02fd73/balbuzard-0.18.zip" } ], "0.19": [ { "comment_text": "", "digests": { "md5": "956a34edbb6fe62725ed9ba9a6e13365", "sha256": "c4ef877e7bf141cbaba7e33b070fbf1646c4879ae5f4056de4ff2ae7dd5e7b11" }, "downloads": -1, "filename": "balbuzard-0.19.zip", "has_sig": false, "md5_digest": "956a34edbb6fe62725ed9ba9a6e13365", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1749886, "upload_time": "2014-03-23T20:55:11", "url": "https://files.pythonhosted.org/packages/ad/41/4b543d97a346fbba0ed2c46016aa722f88fa5b8135dda62dfaceec082cbd/balbuzard-0.19.zip" } ], "0.20": [ { "comment_text": "", "digests": { "md5": "b4e2259bf7ad97f99c0e82a55157733b", "sha256": "8c3229e0787221a8e18a674cc38e5033c9ad4ba3d01932eec0d15074f8c3cfa8" }, "downloads": -1, "filename": "balbuzard-0.20.tar.gz", "has_sig": false, "md5_digest": "b4e2259bf7ad97f99c0e82a55157733b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1694207, "upload_time": "2019-06-16T21:41:18", "url": "https://files.pythonhosted.org/packages/91/ed/463c10244aca6516f0a7c1354044b3ff379c5747ff7607760f6a541d71df/balbuzard-0.20.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "b4e2259bf7ad97f99c0e82a55157733b", "sha256": "8c3229e0787221a8e18a674cc38e5033c9ad4ba3d01932eec0d15074f8c3cfa8" }, "downloads": -1, "filename": "balbuzard-0.20.tar.gz", "has_sig": false, "md5_digest": "b4e2259bf7ad97f99c0e82a55157733b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1694207, "upload_time": "2019-06-16T21:41:18", "url": "https://files.pythonhosted.org/packages/91/ed/463c10244aca6516f0a7c1354044b3ff379c5747ff7607760f6a541d71df/balbuzard-0.20.tar.gz" } ] }