Ever wanted to turn your AV console into an Incident Response & Threat Hunting machine? Rastrea2r (pronounced "rastreador" - hunter- in Spanish) is a multi-platform open source tool that allows incident responders and SOC analysts to triage suspect systems and hunt for Indicators of Compromise (IOCs) across thousands of endpoints in minutes. To parse and collect artifacts of interest from remote systems (including memory dumps), rastrea2r can execute sysinternal, system commands and other 3rd party tools across multiples endpoints, saving the output to a centralized share for automated or manual analysis. By using a client/server RESTful API, rastrea2r can also hunt for IOCs on disk and memory across multiple systems using YARA rules. As a command line tool, rastrea2r can be easily integrated within McAfee ePO, as well as other AV consoles and orchestration tools, allowing incident responders and SOC analysts to collect forensic evidence and hunt for IOCs without the need for an additional agent, with 'gusto' and style!
Dependencies
- Python 2.7.x
- git
- bottle
- requests
- yara-python
Quickstart
- Clone the project to your local directory (or download the zip file of the project)
$git clone https://github.com/rastrea2r/rastrea2r.git
$cd rastrea2r- All the dependencies necessary for the tool to run can be installed within a virtual environment via the provided makefile.
$make help
help - display this makefile's help information
venv - create a virtual environment for development
clean - clean all files using .gitignore rules
scrub - clean all files, even untracked files
test - run tests
test-verbose - run tests [verbosely]
check-coverage - perform test coverage checks
check-style - perform pep8 check
fix-style - perform check with autopep8 fixes
docs - generate project documentation
check-docs - quick check docs consistency
serve-docs - serve project html documentation
dist - create a wheel distribution package
dist-test - test a wheel distribution package
dist-upload - upload a wheel distribution package- Create a virtual environment with all dependencies
$make venv
//Upon successful creation of the virtualenvironment, enter the virtualenvironment as instructed, for ex:
$source /Users/ssbhat/.venvs/rastrea2r/bin/activate- Start the rastrea2r server by going to $PROJECT_HOME/src/rastrea2r/server folder
$cd src/rastrea2r/server/
$python rastrea2r_server_v0.3.py
Bottle v0.12.13 server starting up (using WSGIRefServer())...
Listening on http://0.0.0.0:8080/- Now execute the client program, depending on which platform you are trying to scan choose the target python script appropriately. Currently Windows, Linux and Mac platforms are supported.
$python rastrea2r_osx_v0.3.py -h
usage: rastrea2r_osx_v0.3.py [-h] [-v] {yara-disk,yara-mem,triage} ...
Rastrea2r RESTful remote Yara/Triage tool for Incident Responders
positional arguments: {yara-disk,yara-mem,triage}
modes of operation
yara-disk Yara scan for file/directory objects on disk
yara-mem Yara scan for running processes in memory
triage Collect triage information from endpoint
optional arguments:
-h, --help show this help message and exit
-v, --version show program's version number and exit
Further more, the available options under each command can be viewed by executing the help option. i,e
$python rastrea2r_osx_v0.3.py yara-disk -h
usage: rastrea2r_osx_v0.3.py yara-disk [-h] [-s] path server rule
positional arguments:
path File or directory path to scan
server rastrea2r REST server
rule Yara rule on REST server
optional arguments:
-h, --help show this help message and exit
-s, --silent Suppresses standard output- For ex, on a Mac or Unix system you would do:
$cd src/rastrea2r/osx/
$python rastrea2r_osx_v0.3.py yara-disk /opt http://127.0.0.1:8080/ test.yarExecuting rastrea2r on Windows
- Apart from the libraries specified in requirements.txt, we need to install the following libraries
- PSutil for win64: https://github.com/giampaolo/psutil
- WMI for win32: https://pypi.python.org/pypi/WMI/
- Requests: pip install requests
- Compiling rastrea2r
- Make sure you have all the dependencies installed for the binary you are going to build on your Windows box. Then install:
- Pywin32: http://sourceforge.net/projects/pywin32/files/ ** Windows only
- Pyinstaller: https://github.com/pyinstaller/pyinstaller/wiki
Currently Supported functionality
- yara-disk: Yara scan for file/directory objects on disk
- yara-mem: Yara scan for running processes in memory
- memdump: Acquires a memory dump from the endpoint ** Windows only
- triage: Collects triage information from the endpoint ** Windows only
Notes
For memdump and triage modules, SMB shares must be set up in this specific way:
- Binaries (sysinternals, batch files and others) must be located in a shared folder called TOOLS (read only)
\path-to-share-foldertools
- Output is sent to a shared folder called DATA (write only)
\path-to-share-folderdata
- For yara-mem and yara-disk scans, the yara rules must be in the same directory where the server is executed from.
- The RESTful API server stores data received in a file called results.txt in the same directory.
Contributing to rastrea2r project
The Developer Documentation provides complete information on how to contribute to rastrea2r project
Demo videos on Youtube
- Video 1: Incident Response / Triage with rastrea2r on the command line - https://youtu.be/uFIZxqWeSyQ
- Video 2: Remote Yara scans with rastrea2r on the command line - https://youtu.be/cnY1yEslirw
- Video 3: Using rastrea2r with McAfee ePO - Client Tasks & Execution - https://youtu.be/jB17uLtu45Y
Presentations
- rastrea2r at BlackHat Arsenal 2016 (check PDF for documentation on usage and examples) https://www.blackhat.com/us-16/arsenal.html#rastrea2r
- https://github.com/aboutsecurity/Talks-and-Presentations/blob/master/Ismael_Valenzuela-Hunting_for_IOCs_rastrea2r-BH_Arsenal_2016.pdf
- Recording of talk on rastrea2r at the SANS Threat Hunting Summit 2016
- https://www.youtube.com/watch?v=0PvBsL6KKfA&feature=youtu.be&a
Credits & References
- To Robert Gresham Jr. (@rwgresham) and Ryan O'Connor (@_remixed) for their contributions to the Triage module. Thanks folks!
- To Ricardo Dias for the idea of using a REST server and his great paper on how to use Python and Yara with McAfee ePO: http://www.sans.org/reading-room/whitepapers/forensics/intelligence-driven-incident-response-yara-35542
Related posts
- Hacking Tools Windows
- Game Hacking
- Black Hat Hacker Tools
- Hacker Tools Free
- Hak5 Tools
- Hacking Tools Usb
- Free Pentest Tools For Windows
- Hacking Tools Online
- Hack Tools Github
- Hacking Tools Download
- Best Hacking Tools 2020
- Wifi Hacker Tools For Windows
- Bluetooth Hacking Tools Kali
- Hacking Tools For Mac
- Best Hacking Tools 2020
- How To Make Hacking Tools
- Beginner Hacker Tools
- Kik Hack Tools
- Android Hack Tools Github
- Hack Tools For Games
- Termux Hacking Tools 2019
- Hacker Tools Mac
- Hack Tools For Mac
- Pentest Box Tools Download
- Ethical Hacker Tools
- Hacker Tools Free
- Pentest Tools Url Fuzzer
- Pentest Tools Github
- Easy Hack Tools
- Hacker Tools Free Download
- Hacker Security Tools
- Pentest Tools Free
- Hacking Tools Download
- Nsa Hacker Tools
- Pentest Tools For Windows
- Best Hacking Tools 2019
- Hacker Hardware Tools
- Pentest Tools Find Subdomains
- Pentest Tools Kali Linux
- Pentest Tools Tcp Port Scanner
- Hacks And Tools
- Hacker Tools 2019
- Hack Website Online Tool
- Hacker Tools Software
- Pentest Tools Nmap
- Hacker Tools For Pc
- Pentest Tools For Mac
- Pentest Tools Kali Linux
- Wifi Hacker Tools For Windows
- Bluetooth Hacking Tools Kali
- Pentest Tools Open Source
- New Hacker Tools
- Hack Tools Mac
- Pentest Tools Alternative
- Hacker Tools 2019
- Pentest Tools Online
- Hack Tools For Windows
- Pentest Tools Download
- Pentest Tools Find Subdomains
- Hacker Security Tools
- Physical Pentest Tools
- Pentest Tools Kali Linux
- Pentest Tools Url Fuzzer
- Hacking Tools Usb
- Hacker Tools Mac
- Install Pentest Tools Ubuntu
- Pentest Tools Port Scanner
- Hack Tools 2019
- Pentest Tools List
- World No 1 Hacker Software
- Pentest Recon Tools
- Hacking Tools Windows 10
- Hacker Tools List
- Hacker Tools Software
- Hack Tool Apk
- Pentest Tools Framework
- Hacking Tools And Software
- Tools 4 Hack
- Hacker Tools Mac
- Computer Hacker
- Best Pentesting Tools 2018
- Nsa Hacker Tools
- Hacking Tools Online
- Hacking Tools Name
- Pentest Tools Online
- Hacking App
- Pentest Tools Bluekeep
- Kik Hack Tools
- Pentest Tools Url Fuzzer
- Pentest Tools Open Source
- Hack Tools Github
- Computer Hacker
- What Are Hacking Tools
- Hackrf Tools
- How To Make Hacking Tools
- Hack Tools Mac
- Growth Hacker Tools
- Hacking Tools Hardware
- Hacking Tools Windows 10
- Pentest Reporting Tools
- Hacker Tools For Pc
- Hacker
- Hacking Tools 2020
- Game Hacking
- Tools 4 Hack
- Pentest Tools Download
- Pentest Tools Alternative
- Pentest Tools Port Scanner
- Black Hat Hacker Tools
- Best Hacking Tools 2020
- Hacking Tools Windows
- Pentest Tools For Ubuntu
- Hacking Tools 2020
- Nsa Hack Tools
- Hacking Tools For Windows
- How To Install Pentest Tools In Ubuntu
- Usb Pentest Tools
- Hacking Tools Name
- Hacker Tools For Pc
- Pentest Tools Review
- Pentest Automation Tools
- Android Hack Tools Github
- Pentest Recon Tools
- Hacker Tool Kit
- Pentest Tools Tcp Port Scanner
- Hacker Tools Hardware
- Install Pentest Tools Ubuntu
- Hacking Tools Usb
- Pentest Tools Review
- Hacking Tools Hardware
- Hacker Tools Windows
- Hacking Tools 2019
- Hacking Tools Windows 10
- Hacker Tools 2019
- Pentest Automation Tools
- Github Hacking Tools
- Hacking Tools Mac
- Hacker Tools Hardware
- Pentest Tools Review
- Tools For Hacker
- Hacker Tools Apk Download
- Hacker Tools Apk Download
- Hacking Tools Windows 10
- Hacker Tools Apk
- Hack And Tools
- Hack Tools 2019
- How To Install Pentest Tools In Ubuntu
- Pentest Tools Review
- Hack Tools Pc
- Pentest Tools Kali Linux
- Pentest Tools Find Subdomains
- Hackrf Tools
- Free Pentest Tools For Windows
- Hacking Tools 2020
- Hacking Tools For Windows Free Download
- Hacks And Tools
- Hacking Tools Mac
- Tools 4 Hack
- Hacking Tools For Games
- Ethical Hacker Tools
- Hack Tools
- Hack Tools Mac
- Beginner Hacker Tools



No comments:
Post a Comment