Ronin Scanners

Build Status

Description

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.

Features

Synopsis

Start the Ronin console with Ronin Scanners preloaded:

$ ronin-scanners

Examples

Calling Nmap from Ruby:

require 'ronin/scanners/nmap'

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
# => [#<Ronin::IPAddress: 216.52.208.185>]

Importing Nmap scan results into the Database:

ips = Scanners::Nmap.import(targets: 'www.google.com', ports: [80,21,25], service_scan: true)
# => [#<Ronin::IPAddress: 216.52.208.185>]
ips[0].host_names
# => [#<Ronin::HostName: www.google.com>, #<Ronin::HostName: pd-in-f103.1e100.net>]
ips[0].ports
# => [#<Ronin::Port: 80/tcp>]

Requirements

Install

Stable

$ gem install ronin-scanners

Edge

$ git clone git://github.com/ronin-ruby/ronin-scanners.git
$ cd ronin-scanners/
$ bundle install
$ ./bin/ronin-scan-nmap --help

License

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

Copyright (c) 2008-2013 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