Skip to content

A Rubyful interface to the Nmap exploration tool and security / port scanner.

License

Notifications You must be signed in to change notification settings

cbrunsdon/ruby-nmap

 
 

Repository files navigation

ruby-nmap

Description

A Ruby interface to Nmap, the exploration tool and security / port scanner.

Features

  • Provides a Ruby interface for running Nmap.
  • Provides a Parser for enumerating Nmap XML scan files.

Examples

Run Nmap from Ruby:

require 'nmap/program'

Nmap::Program.scan do |nmap|
  nmap.sudo = true

  nmap.syn_scan = true
  nmap.service_scan = true
  nmap.os_fingerprint = true
  nmap.xml = 'scan.xml'
  nmap.verbose = true

  nmap.ports = [20,21,22,23,25,80,110,443,512,522,8080,1080]
  nmap.targets = '192.168.1.*'
end

Parse Nmap XML scan files:

require 'nmap/xml'

Nmap::XML.new('scan.xml') do |xml|
  xml.each_host do |host|
    puts "[#{host.ip}]"

    host.each_port do |port|
      puts "  #{port.number}/#{port.protocol}\t#{port.state}\t#{port.service}"
    end
  end
end

Print NSE script output from an XML scan file:

require 'nmap/xml'

Nmap::XML.new('nse.xml') do |xml|
  xml.each_host do |host|
    puts "[#{host.ip}]"

    host.scripts.each do |name,output|
      output.each_line { |line| puts "  #{line}" }
    end

    host.each_port do |port|
      puts "  [#{port.number}/#{port.protocol}]"

      port.scripts.each do |name,output|
        puts "    [#{name}]"

        output.each_line { |line| puts "      #{line}" }
      end
    end
  end
end

Requirements

Install

$ sudo gem install ruby-nmap

License

See {file:LICENSE.txt} for license information.

About

A Rubyful interface to the Nmap exploration tool and security / port scanner.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%