ronin 0.0.9

data/lib/ronin/network/extensions/telnet/net.rb

@@ -0,0 +1,132 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/network/telnet'
+
+require 'net/telnet'
+require 'net/telnets'
+
+module Net
+  #
+  # Creates a new Telnet object with the specified _host_, given port
+  # and the given _options_. If a _block_ is given, it will be passed
+  # the newly created Telnet object.
+  #
+  # _options_ may contain the following keys:
+  # <tt>:port</tt>:: The port to connect to. Defaults to +DEFAULT_PORT+,
+  #                  if not given.
+  # <tt>:binmode</tt>:: Indicates that newline substitution shall not
+  #                     be performed.
+  # <tt>:output_log</tt>:: The name of the file to write connection
+  #                        status messages and all received traffic to.
+  # <tt>:dump_log</tt>:: Similar to the <tt>:output_log</tt> option,
+  #                      but connection output is also written in
+  #                      hexdump format.
+  # <tt>:prompt</tt>:: A regular expression matching the host's
+  #                    command-line prompt sequence, used to determine
+  #                    when a command has finished. Defaults to
+  #                    +DEFAULT_PROMPT+, if not given.
+  # <tt>:telnet</tt>:: Indicates that the connection shall behave as a
+  #                    telnet connection. Defaults to +true+.
+  # <tt>:plain</tt>:: Indicates that the connection shall behave as a
+  #                   normal TCP connection.
+  # <tt>:timeout</tt>:: The number of seconds to wait before timing out
+  #                     both the initial attempt to connect to host,
+  #                     and all attempts to read data from the host.
+  #                     Defaults to +DEFAULT_TIMEOUT+, if not given.
+  # <tt>:wait_time</tt>:: The amount of time to wait after seeing what
+  #                       looks like a prompt.
+  # <tt>:proxy</tt>:: A proxy object to used instead of opening a
+  #                   direct connection to the host. Must be either
+  #                   another telnet object or an IO object.
+  #                   Defaults to Telnet.proxy, if not given.
+  # <tt>:user</tt>:: The user to login with.
+  # <tt>:password</tt>:: The password to login with.
+  # <tt>:ssl</tt>:: A +Hash+ of SSL information to use for a SSLed
+  #                 Telnet session. This hash must contain the following
+  #                 keys.
+  #                 <tt>:certfile</tt>:: The SSL Certfile to use.
+  #                 <tt>:keyfile</tt>:: The SSL Key file to use.
+  #                 <tt>:cafile</tt>:: The SSL CAFile to use.
+  #                 <tt>:capath</tt>:: The SSL CAPath to use.
+  #
+  #   Telnet.connect('towel.blinkenlights.nl') # => Telnet
+  #
+  def Net.telnet_connect(host,options={},&block)
+    sess_opts = {}
+    sess_opts['Host'] = host
+    sess_opts['Port'] = (options[:port] || Ronin::Network::Telnet.default_port)
+    sess_opts['Binmode'] = options[:binmode]
+    sess_opts['Output_log'] = options[:output_log]
+    sess_opts['Dump_log'] = options[:dump_log]
+    sess_opts['Prompt'] = (options[:prompt] || Ronin::Network::Telnet.default_prompt)
+
+    if (options[:telnet] && !options[:plain])
+      sess_opts['Telnetmode'] = true
+    end
+
+    sess_opts['Timeout'] = (options[:timeout] || Ronin::Network::Telnet.default_timeout)
+    sess_opts['Waittime'] = options[:wait_time]
+    sess_opts['Proxy'] = (options[:proxy] || Ronin::Network::Telnet.proxy)
+
+    user = options[:user]
+    passwd = options[:passwd]
+
+    if options[:ssl]
+      sess_opts['CertFile'] = options[:ssl][:certfile]
+      sess_opts['KeyFile'] = options[:ssl][:keyfile]
+      sess_opts['CAFile'] = options[:ssl][:cafile]
+      sess_opts['CAPath'] = options[:ssl][:capath]
+      sess_opts['VerifyMode'] = (options[:ssl][:verify] || SSL::VERIFY_PEER)
+      sess_opts['VerifyCallback'] = options[:ssl][:verify_callback]
+      sess_opts['VerifyDepth'] = options[:ssl][:verify_depth]
+    end
+
+    sess = Net::Telnet.new(sess_opts)
+    sess.login(user,passwd) if user
+
+    block.call(sess) if block
+    return sess
+  end
+
+  #
+  # Creates a new Telnet object with the specified _host, given port
+  # and the given _options_. See telnet for a complete listing the
+  # _options_. If a _block_ is given, it will be passed the newly
+  # created Telnet object. After the telnet connection has been
+  # established, and the given _block_ has completed, the connection
+  # is then closed.
+  #
+  #   Net.telnet_session('towel.blinkenlights.nl') do |movie|
+  #     movie.each_line { |line| puts line }
+  #   end
+  #
+  def Net.telnet_session(host,options={},&block)
+    Net.telnet_connect(host,options) do |sess|
+      block.call(sess) if block
+      sess.close
+    end
+
+    return nil
+  end
+end

data/lib/ronin/network/extensions/udp.rb

@@ -0,0 +1,24 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/network/extensions/udp/net'

data/lib/ronin/network/extensions/udp/net.rb

@@ -0,0 +1,99 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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 'socket'
+
+module Net
+  #
+  # Creates a new UDPSocket object with the specified _rhost_, _rport_
+  # and the given _lhost_ and _lport_. If _block_ is given, it will be
+  # passed the newly created UDPSocket object.
+  #
+  #   Net.udp_connect('www.hackety.org',80) # => UDPSocket
+  #
+  #   Net.udp_connect('www.wired.com',80) do |sock|
+  #     puts sock.readlines
+  #   end
+  #
+  def Net.udp_connect(rhost,rport,lhost=nil,lport=nil,&block)
+    sock = UDPSocket.new(@rhost,@rport,@lhost,@lport)
+    block.call(sock) if block
+
+    return sock
+  end
+
+  #
+  # Creates a new UDPSocket object with the specified _rhost_ 
+  # _rport_, and the given _lhost_ and _lport_. The specified _block_
+  # will be passed the first line received from the UDPSocket object.
+  # The newly created UDPSocket object will be returned.
+  #
+  def Net.udp_connect_and_recv(rhost,rport,lhost=nil,lport=nil,&block)
+    Net.udp_connect(rhost,rport,lhost,lport) do |sock|
+      block.call(sock.read) if block
+    end
+  end
+
+  #
+  # Creates a new UDPSocket object with the specified _rhost_ 
+  # _rport_, and the given _lhost_ and _lport_. The specified _data_ will
+  # then be written to the newly created UDPSocket. If a _block_ is given
+  # it will be passed the UDPSocket object.
+  #
+  def Net.udp_connect_and_send(data,rhost,rport,lhost=nil,lport=nil,&block)
+    Net.udp_connect(rhost,rport,lhost,lport) do |sock|
+      sock.write(data)
+
+      block.call(sock) if block
+    end
+  end
+
+  #
+  # Creates a new UDPSocket object with the specified _rhost_, _rport_
+  # and the given _lhost_ and _lport_. If _block_ is given, it will be
+  # passed the newly created UDPSocket object. After the UDPSocket object
+  # has been passed to the given _block_ it will be closed.
+  #
+  def Net.udp_session(rhost,rport,lhost=nil,lport=nil,&block)
+    Net.udp_connect(rhost,rport,lhost,lport) do |sock|
+      block.call(sock) if block
+      sock.close
+    end
+
+    return nil
+  end
+
+  #
+  # Connects to the specified _rhost_ and _rport_ with the given _lhost_
+  # and _lport_, reads the banner then closes the connection, returning the
+  # received banner. If a _block_ is given it will be passed the banner.
+  #
+  def Net.udp_banner(rhost,rport,lhost=nil,lport=nil,&block)
+    Net.udp_session(rhost,rport,lhost,lport) do |sock|
+      banner = sock.readline
+    end
+
+    block.call(banner) if block
+    return banner
+  end
+end

data/lib/ronin/network/http.rb

@@ -0,0 +1,128 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/network/extensions/http'
+require 'ronin/network/http/exceptions/unknown_request'
+
+module Ronin
+  module Network
+    module HTTP
+      # Common HTTP proxy port
+      COMMON_PROXY_PORT = 8080
+
+      #
+      # Returns the default Ronin HTTP proxy port to use for HTTP proxies.
+      #
+      def HTTP.default_proxy_port
+        @@http_default_proxy_port ||= COMMON_PROXY_PORT
+      end
+
+      #
+      # Sets the default Ronin HTTP proxy port to the specified _port_.
+      #
+      def HTTP.default_proxy_port=(port)
+        @@http_default_proxy_port = port
+      end
+
+      #
+      # Returns the default Ronin HTTP proxy hash.
+      #
+      def HTTP.default_proxy
+        {:host => nil, :port => HTTP.default_proxy_port, :user => nil, :pass => nil}
+      end
+
+      #
+      # Returns the Ronin HTTP proxy hash.
+      #
+      def HTTP.proxy
+        @@http_proxy ||= default_proxy
+      end
+
+      #
+      # Resets the Ronin HTTP proxy setting.
+      #
+      def HTTP.disable_proxy
+        @@http_proxy = default_proxy
+      end
+
+      #
+      # Returns the default Ronin HTTP User-Agent.
+      #
+      def HTTP.user_agent
+        @@http_user_agent ||= nil
+      end
+
+      #
+      # Sets the default Ronin HTTP User-Agent to the specified _agent_.
+      #
+      def HTTP.user_agent=(agent)
+        @@http_user_agent = agent
+      end
+
+      #
+      # Returns Ronin HTTP headers created from the given _options_.
+      #
+      def HTTP.headers(options={})
+        headers = {}
+
+        if HTTP.user_agent
+          headers['User-Agent'] = HTTP.user_agent
+        end
+
+        if options
+          options.each do |name,value|
+            header_name = name.to_s.split('_').map { |word|
+              word.capitalize
+            }.join('-')
+
+            headers[header_name] = value.to_s
+          end
+        end
+
+        return headers
+      end
+
+      #
+      # Creates an HTTP request object with the specified _type_ and
+      # given _options_. If type does not represent the name of an Net:HTTP
+      # Request Class an UnknownRequest exception will be raised.
+      #
+      def HTTP.request(type,options={})
+        name = type.to_s.capitalize
+
+        unless Net::HTTP.const_defined?(name)
+          raise(UnknownRequest,"unknown HTTP request type #{name.dump}",caller)
+        end
+
+        headers = HTTP.headers(options[:headers])
+        request = Net::HTTP.const_get(name).new(options[:path].to_s,headers)
+
+        if options[:user]
+          request.basic_auth(options[:user].to_s,options[:password].to_s)
+        end
+
+        return request
+      end
+    end
+  end
+end

data/lib/ronin/network/http/exceptions.rb

@@ -0,0 +1,24 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/network/http/exceptions/unknown_request'

data/lib/ronin/network/http/exceptions/unknown_request.rb

@@ -0,0 +1,31 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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
+#++
+#
+
+module Ronin
+  module Network
+    module HTTP
+      class UnknownRequest < RuntimeError
+      end
+    end
+  end
+end

data/lib/ronin/network/imap.rb

@@ -0,0 +1,47 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/network/extensions/imap'
+
+module Ronin
+  module Network
+    module IMAP
+      # Default imap port
+      DEFAULT_PORT = 143
+
+      #
+      # Returns the default Ronin IMAP port.
+      #
+      def IMAP.default_port
+        @@imap_default_port ||= DEFAULT_PORT
+      end
+
+      #
+      # Sets the default Ronin IMAP port to the specified _port_.
+      #
+      def IMAP.default_port=(port)
+        @@imap_default_port = port
+      end
+    end
+  end
+end