Fork Page | History

Ronin Scanners

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

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

  • Provides a Rubyful interface to Nmap.
  • Allows for recording of Nmap scan results using ScanDB.
  • Provides a Rubyful interface to Nikto.

Requirements

Install

$ sudo gem install ronin-scanners

Synopsis

  • Start the Ronin console with Ronin Scanners preloaded: 
    $ ronin-scanners

Examples

  • Calling Nmap from Ruby:

    require 'ronin/scanners'
# => true

Scanners::Nmap.scan(:targets => 'www.google.com', :ports => [80,21,25], :service_scan => true)
# Starting Nmap 4.68 ( http://nmap.org ) at 2009-01-09 16:51 PST
# Interesting ports on mh-in-f99.google.com (209.85.173.99):
# PORT   STATE    SERVICE VERSION
# 21/tcp filtered ftp
# 25/tcp filtered smtp
# 80/tcp open     http    Google httpd 1.3 (GFE)
# Service Info: OS: Linux
#
# Service detection performed. Please report any incorrect results at http://nmap.org/submit/ .
# Nmap done: 1 IP address (1 host up) scanned in 11.627 seconds
# => nil

Development