Ronin

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.

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 an Object Database using DataMapper.
Caches and mirrors Objects stored in Overlays using DataMapper.
Provides convenience methods for:
- Formatting data:
  - Binary
  - Text
  - HTTP
  - URIs
  - HTML
- 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 module for easily defining scanner methods for certain types of objects.
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.

List installed Overlays:
```
$ ronin list
```

Install an Overlay:

$ ronin install svn://example.com/path/to/overlay

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
```

YARD >= 0.2.3.5
Nokogiri >= 1.3.3
- libxml2
- libxslt1
DataMapper:
- extlib >= 0.9.13
- data_objects >= 0.10.0
- do_sqlite3 >= 0.10.0
  - libsqlite3
- dm-core >= 0.10.0
- dm-types >= 0.10.0
- dm-validations >= 0.10.0
dm-predefined >= 0.2.0
Chars >= 0.1.2
Parameters >= 0.1.8
Contextify >= 0.1.3
reverse-require >= 0.3.1
R'epertoire >= 0.2.3
thor >= 0.11.5

$ sudo gem install ronin

Ruby

Extend

Publish

Features

Synopsis

Requirements

Install

Development