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.
Ruby
Pull request Compare This branch is 840 commits ahead of evoltech:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
spec
static/ronin/platform
.gitignore
COPYING.txt
History.rdoc
Manifest.txt
README.rdoc
Rakefile

README.rdoc

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.

Ruby

Ronin's Ruby environment allows security researchers to leverage Ruby with ease. The Ruby environment contains a multitude of convenience methods for working with data in Ruby, a Ruby Object Database, a customized Ruby Console and an extendable command-line interface.

Extend

Ronin's more specialized features are provided by additional Ronin libraries, which users can choose to install. These libraries can allow one to write and run Exploits and Payloads, scan for PHP vulnerabilities, perform Google Dorks or run 3rd party scanners.

Publish

Ronin allows users to publish and share code, exploits, payloads or other data via Overlays. Overlays are directories of code and data that can be hosted on any SVN, Hg, Git or Rsync server. Ronin makes it easy to create, install or update Overlays.

FEATURES:

  • Supports installing/updating/uninstalling of Overlays.

    • Supports accessing Overlays from various media types:

      • Subversion (SVN)

      • Mercurial (Hg)

      • Git

      • Rsync

  • Allows for the loading of Extensions from one or more Overlays.

  • Provides Object Database using DataMapper.

  • Caches and mirrors Objects stored in Overlays using DataMapper.

  • Provides convenience methods for:

    • Formatting data:

      • Binary

      • Text

      • HTTP

      • URIs

    • Generating random text.

    • Networking:

      • TCP

      • UDP

      • SMTP / ESMTP

      • POP3

      • Imap

      • Telnet

      • HTTP / HTTPS

    • Enumerating IP ranges:

      • IPv4 / IPv6 addresses.

      • CIDR / globbed ranges.

    • (Un-)Hexdumping data.

    • Handling exceptions.

  • Provides a customized Ruby Console with:

    • 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 extendable command-line interface based on Thor.

SYNOPSIS:

  • Install an Overlay:

    $ ronin install svn://example.com/path/to/overlay
  • List installed Overlays:

    $ ronin list
  • Update all installed Overlays:

    $ ronin update
  • Update a specific Overlay:

    $ ronin update overlay-name
  • Uninstall an Overlay:

    $ ronin uninstall overlay-name
  • Start the Ronin console:

    $ ronin
  • View available commands:

    $ ronin help

REQUIREMENTS:

INSTALL:

$ sudo gem install ronin

RONIN 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 provids 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:

Ronin - A Ruby platform for exploit development and security research.

Copyright © 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)

This program 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 2 of the License, or (at your option) any later version.

This program 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 this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA