ronin 0.3.0 → 1.0.0.pre1

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

@@ -1,214 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 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'
-require 'ronin/network/http/proxy'
-require 'ronin/network/extensions/http'
-
-module Ronin
-  module Network
-    module HTTP
-      #
-      # @return [Proxy]
-      #   The Ronin HTTP proxy hash.
-      #
-      def HTTP.proxy
-        @@http_proxy ||= Proxy.new
-      end
-
-      #
-      # @return [String, nil]
-      #   The default Ronin HTTP User-Agent.
-      #
-      def HTTP.user_agent
-        @@http_user_agent ||= nil
-      end
-
-      #
-      # Sets the default Ronin HTTP User-Agent.
-      #
-      # @param [String] agent
-      #   The new User-Agent string to use.
-      #
-      def HTTP.user_agent=(agent)
-        @@http_user_agent = agent
-      end
-
-      #
-      # Expands the given HTTP _options_.
-      #
-      # @param [Hash] options
-      #   HTTP options.
-      #
-      # @option options [String, URI::HTTP, URI::HTTPS] :url
-      #   The URL to request.
-      #
-      # @option options [String] :host
-      #   The host to connect to.
-      #
-      # @option options [String] :port (::Net::HTTP.default_port)
-      #   The port to connect to.
-      #
-      # @option options [String] :user
-      #   The user to authenticate as.
-      #
-      # @option options [String] :password
-      #   The password to authenticate with.
-      #
-      # @option options [String] :path ('/')
-      #   The path to request.
-      #
-      # @option options [String, Hash] :proxy (Ronin::Network::HTTP.proxy)
-      #   The Proxy information.
-      #
-      # @return [Hash]
-      #   The expanded version of _options_.
-      #
-      def HTTP.expand_options(options={})
-        new_options = options.dup
-
-        if new_options[:url]
-          url = URI(new_options.delete(:url).to_s)
-
-          new_options[:host] = url.host
-          new_options[:port] = url.port
-
-          new_options[:user] = url.user if url.user
-          new_options[:password] = url.password if url.password
-
-          unless url.path.empty?
-            new_options[:path] = url.path
-          else
-            new_options[:path] = '/'
-          end
-
-          new_options[:path] << "?#{url.query}" if url.query
-        else
-          new_options[:port] ||= ::Net::HTTP.default_port
-          new_options[:path] ||= '/'
-        end
-
-        if (proxy = new_options[:proxy])
-          unless proxy.kind_of?(Hash)
-            new_options[:proxy] = Ronin::Network::HTTP::Proxy.parse(proxy)
-          end
-        else
-          new_options[:proxy] = Ronin::Network::HTTP.proxy
-        end
-
-        return new_options
-      end
-
-      #
-      # Converts underscored, dashed, lowercase and uppercase HTTP headers
-      # to standard camel-cased HTTP headers.
-      #
-      # @param [Hash{Symbol,String => String}] options
-      #   Ronin HTTP headers.
-      #
-      # @return [Hash]
-      #   The camel-cased 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(/[\s+_-]/).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.
-      #
-      # @param [Hash] options
-      #   The HTTP options for the request.
-      #
-      # @option options [Symbol, String] :method
-      #   The HTTP method to use for the request.
-      #
-      # @option options [String] :path ('/')
-      #   The path to request.
-      #
-      # @option options [String] :user
-      #   The user to authenticate as.
-      #
-      # @option options [String] :password
-      #   The password to authenticate with.
-      #
-      # @option options [Hash{Symbol,String => String}] :headers
-      #   Additional HTTP headers to use for the request.
-      #
-      # @return [HTTP::Request]
-      #   The new HTTP Request object.
-      #
-      # @raise [ArgumentError]
-      #   The +:method+ option must be specified.
-      #
-      # @raise [UnknownRequest]
-      #   The +:method+ option did not match a known Net::HTTP request
-      #   class.
-      #
-      # @see HTTP.expand_options
-      #
-      def HTTP.request(options={})
-        unless options[:method]
-          raise(ArgumentError,"the :method option must be specified",caller)
-        end
-
-        name = options[:method].to_s.capitalize
-
-        unless Net::HTTP.const_defined?(name)
-          raise(UnknownRequest,"unknown HTTP request type #{name.dump}",caller)
-        end
-
-        headers = HTTP.headers(options[:headers])
-        path = (options[:path] || '/').to_s
-
-        request = Net::HTTP.const_get(name).new(path,headers)
-
-        if (user = options.delete(:user))
-          user = user.to_s
-
-          if (password = options.delete(:password))
-            password = password.to_s
-          end
-
-          request.basic_auth(user,password)
-        end
-
-        return request
-      end
-    end
-  end
-end

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

@@ -1,308 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 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 Proxy < Hash
-
-        # The default port of proxies
-        DEFAULT_PORT = 8080
-
-        #
-        # Creates a new Proxy object that represents a proxy to connect to.
-        #
-        # @param [Hash] options
-        #   Additional options for the proxy.
-        #
-        # @option options [String] :host
-        #   The host-name of the proxy.
-        #
-        # @option options [Integer] :port (DEFAULT_PORT)
-        #   The port that the proxy is running on.
-        # @option options [String] :user
-        #   The user-name to authenticate as.
-        # @option options [String] :password
-        #   The password to authenticate with.
-        #
-        def initialize(options={})
-          super()
-
-          self[:host] = options[:host]
-          self[:port] = (options[:port] || DEFAULT_PORT)
-          self[:user] = options[:user]
-          self[:password] = options[:password]
-        end
-
-        #
-        # Parses a proxy URL.
-        #
-        # @param [String, URI::HTTP] proxy
-        #   The proxy URL in String form.
-        #
-        # @return [Proxy]
-        #   The parsed proxy information.
-        #
-        # @example
-        #   Proxy.parse('217.31.51.77:443')
-        #
-        # @example
-        #   Proxy.parse('joe:lol@127.0.0.1:8080')
-        #
-        # @example
-        #   Proxy.parse('http://201.26.192.61:8080')
-        #
-        def Proxy.parse(proxy)
-          proxy = proxy.to_s.gsub(/^http(s)?:\/*/,'')
-
-          if proxy.include?('@')
-            auth, proxy = proxy.split('@',2)
-            user, password = auth.split(':')
-          else
-            user = nil
-            password = nil
-          end
-
-          host, port = proxy.split(':',2)
-          port = port.to_i if port
-
-          return Proxy.new(
-            :host => host,
-            :port => port,
-            :user => user,
-            :password => password
-          )
-        end
-
-        #
-        # Tests the proxy.
-        #
-        # @return [Boolean]
-        #   Specifies if the proxy can proxy requests.
-        #
-        def valid?
-          begin
-            Net.http_get_body(
-              :url => 'http://www.example.com/',
-              :proxy => self
-            ).include?('Example Web Page')
-          rescue Timeout::Error, StandardError
-            return false
-          end
-        end
-
-        #
-        # Measures the lag of the proxy.
-        #
-        # @return [Float]
-        #   The extra number of seconds it takes the proxy to process the
-        #   request.
-        #
-        def lag
-          time = lambda { |proxy|
-            t1 = Time.now
-            Net.http_head(
-              :url => 'http://www.example.com/',
-              :proxy => proxy
-            )
-            t2 = Time.now
-
-            (t2 - t1)
-          }
-
-          begin
-            return (time.call(self) - time.call(nil))
-          rescue Timeout::Error, StandardError
-            return (1.0/0)
-          end
-        end
-
-        #
-        # Disables the Proxy object.
-        #
-        def disable!
-          self[:host] = nil
-          self[:port] = DEFAULT_PORT
-          self[:user] = nil
-          self[:password] = nil
-
-          return self
-        end
-
-        #
-        # Specifies whether the proxy object is usable.
-        #
-        # @return [Boolean]
-        #   Specifies whether the proxy object is usable by
-        #   Net::HTTP::Proxy.
-        #
-        def enabled?
-          !(self[:host].nil? || self[:port].nil?)
-        end
-
-        #
-        # @return [String, nil]
-        #   The host-name to connect when using the proxy.
-        #
-        def host
-          self[:host]
-        end
-
-        #
-        # Set the host-name of the proxy.
-        #
-        # @param [String] new_host
-        #   The new host-name to use.
-        #
-        # @return [String]
-        #   The new host-name to use.
-        #
-        def host=(new_host)
-          self[:host] = new_host.to_s
-        end
-
-        #
-        # @return [Integer]
-        #   The port to connect when using the proxy.
-        #
-        def port
-          self[:port]
-        end
-
-        #
-        # Set the port of the proxy.
-        #
-        # @param [Integer] new_port
-        #   The new port to use.
-        #
-        # @return [Integer]
-        #   The new port to use.
-        #
-        def port=(new_port)
-          self[:port] = new_port.to_i
-        end
-
-        #
-        # @return [String, nil]
-        #   The user-name to authenticate as, when using the proxy.
-        #
-        def user
-          self[:user]
-        end
-
-        #
-        # Set the user-name to authenticate as with the proxy.
-        #
-        # @param [String] new_user
-        #   The new user-name to use.
-        #
-        # @return [Integer]
-        #   The new user-name to use.
-        #
-        def user=(new_user)
-          self[:user] = new_user.to_s
-        end
-
-        #
-        # @return [String, nil]
-        #   The password to authenticate with, when using the proxy.
-        #
-        def password
-          self[:password]
-        end
-
-        #
-        # Set the password to authenticate with for the proxy.
-        #
-        # @param [String] new_user
-        #   The new user-name to use.
-        #
-        # @return [Integer]
-        #   The new user-name to use.
-        #
-        def password=(new_password)
-          self[:password] = new_password.to_s
-        end
-
-        #
-        # Builds a HTTP URI from the proxy information.
-        #
-        # @return [URI::HTTP, nil]
-        #   The HTTP URI representing the proxy. If the proxy is disabled,
-        #   then +nil+ will be returned.
-        #
-        def url
-          return nil unless enabled?
-
-          userinfo = if self[:user]
-                       if self[:password]
-                         "#{self[:user]}:#{self[:password]}"
-                       else
-                         self[:user]
-                       end
-                     end
-          
-          return URI::HTTP.build({
-            :userinfo => userinfo,
-            :host => self[:host],
-            :port => self[:port]
-          })
-        end
-
-        #
-        # Converts the proxy object to a String.
-        #
-        # @return [String]
-        #   The host-name of the proxy.
-        #
-        def to_s
-          self[:host].to_s
-        end
-
-        #
-        # Inspects the proxy object.
-        #
-        # @return [String]
-        #   The inspection of the proxy object.
-        #
-        def inspect
-          unless (self[:host] || self[:port])
-            str = 'disabled'
-          else
-            str = "#{self[:host]}:#{self[:port]}"
-
-            if self[:user]
-              auth_str = self[:user]
-
-              if self[:password]
-                auth_str = "#{auth_str}:#{self[:password]}"
-              end
-
-              str = "#{auth_str}@#{str}"
-            end
-          end
-
-          return "#<#{self.class}: #{str}>"
-        end
-
-      end
-    end
-  end
-end

data/lib/ronin/network/http.rb

@@ -1,23 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 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'
-require 'ronin/network/http/http'
-require 'ronin/network/extensions/http'

data/lib/ronin/network/smtp/email.rb

@@ -1,142 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 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 SMTP
-      class Email
-
-        # Sender of the email
-        attr_accessor :from
-
-        # Recipient of the email
-        attr_accessor :to
-
-        # Subject of the email
-        attr_accessor :subject
-
-        # Date of the email
-        attr_accessor :date
-
-        # Unique message-id string
-        attr_accessor :message_id
-
-        # Body of the email
-        attr_accessor :body
-
-        #
-        # Creates a new Email object.
-        #
-        # @param [Hash] options
-        #   Additional options.
-        #
-        # @option options [String] :from
-        #   The address the email is from.
-        #
-        # @option options [String] :to
-        #   The address that the email should be sent to.
-        #
-        # @option options [String] :subject
-        #   The subject of the email.
-        #
-        # @option options [String] :message_id
-        #   Message-ID of the email.
-        #
-        # @option options [String, Time] :date (Time.now)
-        #   The date the email was sent on.
-        #
-        # @option options [String, Array<String>] :body
-        #   The body of the email.
-        #
-        # @yield [email]
-        #   If a block is given, it will be passed the newly created email
-        #   object.
-        #
-        # @yieldparam [Email] email
-        #   The newly created email object.
-        #
-        def initialize(options={},&block)
-          @from = options[:from]
-          @to = options[:to]
-          @subject = options[:subject]
-          @date = options[:date] || Time.now
-          @message_id = options[:message_id]
-          @body = []
-
-          if options[:body].kind_of?(Array)
-            @body += options[:body]
-          else
-            @body << options[:body]
-          end
-
-          block.call(self) if block
-        end
-
-        #
-        # Formats the email into a SMTP message.
-        #
-        # @return [String]
-        #   Properly formatted SMTP message.
-        #
-        # @see http://www.ruby-doc.org/stdlib/libdoc/net/smtp/rdoc/classes/Net/SMTP.html
-        #
-        def to_s
-          address = lambda { |info|
-            if info.kind_of?(Array)
-              return "#{info[0]} <#{info[1]}>"
-            elsif info.kind_of?(Hash)
-              return "#{info[:name]} <#{info[:email]}>"
-            else
-              return info
-            end
-          }
-
-          message = []
-
-          if @from
-            message << "From: #{address.call(@from)}"
-          end
-
-          if @to
-            message << "To: #{address.call(@to)}"
-          end
-
-          if @subject
-            message << "Subject: #{@subject}"
-          end
-
-          if @date
-            message << "Date: #{@date}"
-          end
-
-          if @message_id
-            message << "Message-Id: <#{@message_id}>"
-          end
-
-          message << ''
-          message += @body
-
-          return message.join("\n")
-        end
-
-      end
-    end
-  end
-end