Description

Ronin is a Ruby platform designed for information security and data exploration tasks. Ronin allows for the rapid development and distribution of code over many of the common Source-Code-Management (SCM) systems.

Free

All source code within Ronin is licensed under the GPL-2, therefore no user will ever have to pay for Ronin or updates to Ronin. Not only is the source code free, the Ronin project will not sell enterprise grade security snake-oil solutions, give private training classes or later turn Ronin into commercial software.

Modular

Ronin was not designed as one monolithic framework but instead as a collection of libraries which can be individually installed. This allows users to pick and choose what functionality they want in Ronin.

Decentralized

Ronin does not have a central repository of exploits and payloads which all developers contribute to. Instead Ronin has Overlays, repositories of code that can be hosted on any SVN/Hg/Git/Rsync server. Users can then use Ronin to quickly install or update Overlays. This allows developers and users to form their own communities, independent of the main developers of Ronin.

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 persistent storage using DataMapper.
  • Provides convenience methods for:
    • Formatting data:
      • Binary
      • Text
      • HTTP
      • URIs
      • HTML
    • Networking:
      • TCP
      • UDP
      • SMTP
      • POP
      • Imap
      • Telnet
      • HTTP / HTTPS
  • Provides an IRB styled console with:
    • Tab-completion enabled.
    • Auto-indentation enabled.
    • Pretty-Print loaded.

Requirements

Install

$ sudo gem install ronin

Synopsis

  • List installed Overlays:
    $ ronin list
  • Install an Overlay:
    $ ronin install svn://example.com/var/svn/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

Development