Ronin

• Website
• Source
• Issues
• Documentation
• Mailing List
• irc.freenode.net #ronin

Description

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.

Share Code

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.

Features

• Supports installing/updating/uninstalling of Repositories.
  • Supports installing Repositories from various media types:
  • Subversion (SVN)
  • Mercurial (Hg)
  • Git
  • Rsync
• Provides a Database using DataMapper with:
  • Ronin::Author
  • Ronin::License
  • Ronin::Arch
  • Ronin::OS
  • Ronin::Software
  • Ronin::Vendor
  • Ronin::Address
  • Ronin::MACAddress
  • Ronin::IPAddress
  • Ronin::HostName
  • Ronin::Port
  • Ronin::TCPPort
  • Ronin::UDPPort
  • Ronin::Service
  • Ronin::OpenPort
  • Ronin::OSGuess
  • Ronin::UserName
  • Ronin::URL
  • Ronin::EmailAddress
  • Ronin::Credential
  • Ronin::ServiceCredential
  • Ronin::WebCredential
  • Ronin::Organization
  • Ronin::Campaign
  • Ronin::Target
• 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.
  • Tab-completion.
  • Auto-indentation.
  • Pretty-Printing (pp).
  • print_info, print_error, print_warning and print_debug output helper methods with color-output.
• Provides an extensible command-line interface based on Thor.

Synopsis

Start the Ronin console:

$ ronin

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:pass@vpn.example.com/db

Remove a Database:

$ ronin database --remove team

Requirements

• Ruby >= 1.8.7
• DataMapper:
  • dm-sqlite-adapter ~> 1.2
  • libsqlite3
  • dm-core ~> 1.2
  • dm-types ~> 1.2
  • dm-migrations ~> 1.2
  • dm-validations ~> 1.2
  • dm-aggregates ~> 1.2
  • dm-timestamps ~> 1.2
• 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

Install

$ gem install ronin

Additional Libraries

Ronin Gen

Ronin Gen is a Ruby library for Ronin that provides various generators.

Ronin Web

Ronin Web is a Ruby library for Ronin that provides support for web scraping and spidering functionality.

Ronin Exploits

Ronin Exploits is a Ruby library for Ronin that provides exploitation and payload crafting functionality.

Ronin Scanners

Ronin Scanners is a Ruby library for Ronin that provides Ruby interfaces to various third-party security scanners.

License

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/.