ruby-nmap

• ソース
• 課題
• ドキュメント

説明

探索ツールおよびセキュリティ / ポートスキャナであるnmapのためのRuby APIです。nmapの自動化とnmap XMLファイルの解析を可能にします。

機能

• nmapを自動化するためのRuby APIを提供します。
• nmap XMLスキャンファイルを列挙するためのパーサーを提供します。
• 完全なNmap XML DTDをサポートします。

例

RubyからNmapを実行する:

require 'nmap/command'

Nmap::Command.run do |nmap|
  nmap.connect_scan   = true
  nmap.service_scan   = true
  nmap.output_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

Rubyからsudo nmapを実行する:

require 'nmap/command'

Nmap::Command.sudo do |nmap|
  nmap.syn_scan       = true
  nmap.os_fingerprint = true
  nmap.service_scan   = true
  nmap.output_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

Nmap XMLスキャンファイルを解析する:

require 'nmap/xml'

Nmap::XML.open('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

XMLスキャンファイルからNSEスクリプト出力を表示する:

require 'nmap/xml'

Nmap::XML.open('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 |id,script|
        puts "    [#{id}]"

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

要件

• ruby >= 2.0.0
• nmap >= 5.00
• nokogiri ~> 1.3
• command_mapper ~> 0.3

インストール

• Debian / Ubuntu:

$ sudo apt install nmap

• Fedora / RedHat:

$ sudo dnf install nmap

• Homebrew:

$ brew install nmap

$ gem install ruby-nmap

ライセンス

ライセンス情報については{file:LICENSE.txt}を参照してください。