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.
Pull request Compare This branch is 464 commits behind ronin-ruby:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
spec
.document
.gemtest
.gitignore
.rspec
.yardopts
COPYING.txt
ChangeLog.md
Gemfile
README.md
Rakefile
gemspec.yml
ronin.gemspec

README.md

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.
  • 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 enabled.
    • Auto-indentation enabled.
    • Pretty-Print loaded.
    • 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 an 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

Install

$ gem install ronin

Additional Libraries

Ronin ASM

Ronin ASM is a Ruby library for Ronin that provides dynamic Assembly (ASM) generation of programs or shellcode.

Ronin Dorks

Ronin Dorks is a Ruby library for Ronin that provides support for various Google (tm) Dorks functionality.

Ronin Exploits

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

Ronin Gen

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

Ronin SQL

Ronin SQL is a Ruby library for Ronin that provides support for SQL related security tasks, such as scanning for and exploiting SQL injections.

Ronin PHP

Ronin PHP is a Ruby library for Ronin that provides support for PHP related security tasks, such as finding and exploiting Local File Inclusion (LFI) and Remote File Inclusion (RFI).

Ronin Web

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

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