ronin-scanners 0.1.4 → 1.0.0.pre1

data/lib/ronin/ui/cli/commands/scan/dork.rb

@@ -0,0 +1,39 @@
+#
+# Ronin Scanners - A Ruby library for Ronin that provides Ruby interfaces to
+# various third-party security scanners.
+#
+# Copyright (c) 2008-2012 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
+#
+
+require 'ronin/ui/cli/scanner_command'
+require 'ronin/scanners/dork'
+
+module Ronin
+  module UI
+    module CLI
+      module Commands
+        module Scan
+          class Dork < ScannerCommand
+
+            summary 'Performs Google Dorks'
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/ui/cli/commands/scan/nmap.rb

@@ -0,0 +1,105 @@
+#
+# Ronin Scanners - A Ruby library for Ronin that provides Ruby interfaces to
+# various third-party security scanners.
+#
+# Copyright (c) 2008-2012 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
+#
+
+require 'ronin/ui/cli/scanner_command'
+require 'ronin/scanners/nmap'
+
+module Ronin
+  module UI
+    module CLI
+      module Commands
+        module Scan
+          class Nmap < ScannerCommand
+
+            summary 'Automates nmap scans and imports them into the Database'
+
+            #
+            # Runs the {Ronin::Scanners::Nmap} scanner.
+            #
+            # @since 1.0.0
+            #
+            def execute
+              print_info 'Saving scanned hosts and ports ...' if import?
+
+              scan
+
+              print_info 'All scanned hosts and ports saved.' if import?
+            end
+
+            protected
+
+            #
+            # Prints a scanned host result.
+            #
+            # @param [Nmap::Host] host
+            #   A scanned host.
+            #
+            # @since 1.0.0
+            #
+            def print_result(host)
+              puts
+
+              print_hash({
+                :started => host.start_time,
+                :ended => host.end_time,
+                :status => "#{host.status.state} (#{host.status.reason})"
+              }, :title => host)
+
+              indent do
+                if options.verbose?
+                  print_array host.each_address, :title => 'Addresses'
+                  print_array host.each_hostname, :title => 'Hostname'
+                end
+
+                puts "[ Port ]\t[ State ]\t[ Service/Version ]\n"
+
+                host.each_port do |port|
+                  puts "  #{port}/#{port.protocol}\t  #{port.state}\t  #{port.service}"
+                end
+                puts
+              end
+            end
+
+            #
+            # Prints a saved host.
+            #
+            # @param [IPAddress] host
+            #   A saved host.
+            #
+            # @since 1.0.0
+            #
+            def print_resource(host)
+              print_info "Saving #{host}:"
+              print_info 'Addresses:'
+
+              print_array host.addresses.select(&:new?),
+                          :title => 'Addresses'
+
+              print_array host.ports.select(&:new?),
+                          :title => 'Ports'
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/ui/cli/commands/scan/proxies.rb

@@ -0,0 +1,82 @@
+#
+# Ronin Scanners - A Ruby library for Ronin that provides Ruby interfaces to
+# various third-party security scanners.
+#
+# Copyright (c) 2008-2012 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
+#
+
+require 'ronin/ui/cli/scanner_command'
+require 'ronin/scanners/proxies'
+
+module Ronin
+  module UI
+    module CLI
+      module Commands
+        module Scan
+          class Proxies < ScannerCommand
+
+            summary 'Scans for proxies and saves them into the Database'
+
+            #
+            # Runs the nmap scanner.
+            #
+            # @since 1.0.0
+            #
+            def execute
+              print_info 'Saving scanned proxies ...' if import?
+
+              scan
+
+              print_info 'All scanned proxies saved.' if import?
+            end
+
+            protected
+
+            #
+            # Prints a scanned proxy.
+            #
+            # @param [Proxy] proxy
+            #   A scanned proxy.
+            #
+            # @since 1.0.0
+            #
+            def print_result(proxy)
+              print_hash({
+                :type => proxy.type,
+                :anonymous => proxy.anonymous?,
+                :latency => proxy.latency
+              }, :title => proxy.ip_address)
+            end
+
+            #
+            # Prints a saved proxy.
+            #
+            # @param [Proxy] proxy
+            #   A saved proxy.
+            #
+            # @since 1.0.0
+            #
+            def print_resource(proxy)
+              print_result(proxy)
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/ui/cli/commands/scan/spider.rb

@@ -0,0 +1,71 @@
+#
+# Ronin Scanners - A Ruby library for Ronin that provides Ruby interfaces to
+# various third-party security scanners.
+#
+# Copyright (c) 2008-2012 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
+#
+
+require 'ronin/ui/cli/scanner_command'
+require 'ronin/scanners/spider'
+
+module Ronin
+  module UI
+    module CLI
+      module Commands
+        module Scan
+          class Spider < ScannerCommand
+
+            summary 'Spiders a website and saves URLs into the Database'
+
+            #
+            # Spider one or more websites.
+            #
+            # @since 1.0.0
+            #
+            def execute
+              print_info 'Saving spidered URLs ...' if import?
+
+              scan
+
+              print_info 'All spidered URLs saved.' if import?
+            end
+
+            protected
+
+            #
+            # Prints a spidered page.
+            #
+            # @param [Spidr::Page] page
+            #   A spidered page.
+            #
+            # @since 1.0.0
+            #
+            def print_result(page)
+              print_info page.url
+
+              if verbose?
+                print_hash page.headers
+                puts page.body
+              end
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/ui/cli/commands/scanner.rb

@@ -0,0 +1,43 @@
+#
+# Ronin Scanners - A Ruby library for Ronin that provides Ruby interfaces to
+# various third-party security scanners.
+#
+# Copyright (c) 2008-2012 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
+#
+
+require 'ronin/ui/cli/script_command'
+require 'ronin/scanners/scanner'
+
+module Ronin
+  module UI
+    module CLI
+      module Commands
+        class Scanner < ScriptCommand
+
+          summary 'Loads and runs a scanner'
+
+          script_class Ronin::Scanners::Scanner
+
+          # scanner options
+          option :first, :type => Integer, :flag => '-N'
+          option :import, :type => true, :flag => '-I'
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/ui/cli/scanner_command.rb

@@ -0,0 +1,118 @@
+#
+# Ronin Scanners - A Ruby library for Ronin that provides Ruby interfaces to
+# various third-party security scanners.
+#
+# Copyright (c) 2008-2012 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
+#
+
+require 'ronin/ui/cli/class_command'
+require 'ronin/scanners'
+require 'ronin/database'
+
+module Ronin
+  module UI
+    module CLI
+      class ScannerCommand < ClassCommand
+
+        class_namespace Scanners
+
+        option :database, :type => String, :flag => '-D'
+        option :first, :type => Integer, :flag => '-N'
+        option :import, :type => true, :flag => '-I'
+
+        alias scanner object
+
+        #
+        # Invokes the scanner.
+        #
+        # @see #scan!
+        #
+        # @api semipublic
+        #
+        def execute
+          scan
+        end
+
+        protected
+
+        #
+        # Sets up the scanner command.
+        #
+        # @api semipublic 
+        #
+        def setup(*arguments)
+          if database?
+            Database.repositories[:default] = @database
+          end
+
+          Database.setup
+
+          super(*arguments)
+        end
+
+        #
+        # Performs a scan using the `@scanner` instance variable.
+        #
+        # @since 1.0.0
+        #
+        def scan
+          enum, printer = if import?
+                            [scanner.import, method(:print_resource)]
+                          else
+                            [scanner.each, method(:print_result)]
+                          end
+
+          first_n = (@first || Float::INFINITY)
+          count   = 0
+
+          enum.each do |result|
+            count += 1
+
+            printer.call(result)
+
+            break if count >= first_n
+          end
+        end
+
+        #
+        # Displays a result from the scanner.
+        #
+        # @param [Object] result
+        #   A result yielded from the scanner.
+        #
+        # @since 1.0.0
+        #
+        def print_result(result)
+          puts result
+        end
+
+        #
+        # Displays a resource from the scanner.
+        #
+        # @param [Model] resource
+        #   A resource yielded from the scanner.
+        #
+        # @since 1.0.0
+        #
+        def print_resource(resource)
+          puts resource
+        end
+
+      end
+    end
+  end
+end