Ronin is a Ruby platform for exploit development and security research. Ronin allows for the rapid development and distribution of code, exploits or payloads over many common Source-Code-Management (SCM) systems.
Hack with Ruby
Ronin combines the flexibility of Ruby with countless convenience methods and libraries, to make Ruby usable for Offensive Security or Research work.
Organize Your Data
Ronin comes with a Database designed for Security data and accessible from Ruby using DataMapper. With Ronin, storing or querying IP addresses, Hosts, Ports, URLs, Passwords is as simple as a single line of Ruby.
Ronin allows sharing code with the community, or just your friends, via Ronin Repositories. Ronin Repositories are like lazier versions of RubyGems, that can be hosted with SubVersion, Mercurial or Git.
- Supports installing/updating/uninstalling of Repositories.
- Provides a Database using DataMapper with:
- Caches exploits, payloads, scanners, etc stored within Repositories into the Database.
- Convenience methods provided by ronin-support.
- Provides a customized Ruby Console with:
- Syntax highlighting.
- Pretty-Printing (
print_debugoutput helper methods with color-output.
- Provides an extensible command-line interface based on Thor.
Start the Ronin console:
Run a Ruby script in Ronin:
$ ronin exec script.rb
View available commands:
$ ronin help
Install a Repository:
$ ronin repos --install svn://example.com/path/to/repo
List installed Repositories:
$ ronin repos
Update all installed Repositories:
$ ronin repos --update
Update a specific Repositories:
$ ronin repos --update repo-name
Uninstall a specific Repositories:
$ ronin repos --uninstall repo-name
List available Databases:
$ ronin database
Add a new Database:
$ ronin database --add team --uri mysql://user:[email protected]/db
Remove a Database:
$ ronin database --remove team
- Ruby >= 1.8.7
- dm-is-predefined ~> 0.4
- uri-query_params ~> 0.5, >= 0.5.2
- open_namespace ~> 0.3
- data_paths ~> 0.3
- object_loader ~> 1.0
- env ~> 0.2
- pullr ~> 0.1, >= 0.1.2
- ripl ~> 0.3
- ripl-multi_line ~> 0.2
- ripl-auto_indent ~> 0.1
- ripl-short_errors ~> 0.1
- ripl-color_result ~> 0.3
- thor ~> 0.14.3
- ronin-support ~> 0.3
$ gem install ronin
Ronin Gen is a Ruby library for Ronin that provides various generators.
Ronin Web is a Ruby library for Ronin that provides support for web scraping and spidering functionality.
Ronin Exploits is a Ruby library for Ronin that provides exploitation and payload crafting functionality.
Ronin Scanners is a Ruby library for Ronin that provides Ruby interfaces to various third-party security scanners.
Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
This file is part of Ronin.
Ronin is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Ronin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Ronin. If not, see http://www.gnu.org/licenses/.