ronin-support 0.2.0 → 0.3.0

data/lib/ronin/formatting/sql.rb

@@ -0,0 +1,20 @@
+#
+# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This file is part of Ronin Support.
+#
+# Ronin Support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin Support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require 'ronin/formatting/extensions/sql'

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

@@ -18,3 +18,4 @@
 #
 
 require 'ronin/network/extensions/http/net'
+require 'ronin/network/extensions/http/uri/http'

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

@@ -90,7 +90,7 @@ module Net
 
     if options[:ssl]
       sess.use_ssl = true
-      sess.verify_mode = Ronin::Network::SSL.verify(options[:ssl][:verify])
+      sess.verify_mode = Ronin::Network::SSL::VERIFY[options[:ssl][:verify]]
     end
 
     sess.start()
@@ -253,7 +253,7 @@ module Net
   #   The method to use for the request.
   #
   # @return [Boolean]
-  #   Specifies wether the response had an HTTP OK status code or not.
+  #   Specifies whether the response had an HTTP OK status code or not.
   #
   # @see http_status
   #

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

@@ -0,0 +1,226 @@
+#
+# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This file is part of Ronin Support.
+#
+# Ronin Support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin Support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require 'ronin/network/extensions/http/net'
+
+require 'uri/http'
+
+module URI
+  class HTTP < Generic
+
+    #
+    # @see Net.http_request
+    #
+    # @since 0.3.0
+    #
+    def request(options={},&block)
+      Net.http_request(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_status
+    #
+    # @since 0.3.0
+    #
+    def status(options={})
+      Net.http_status(options.merge(:url => self))
+    end
+
+    #
+    # @see Net.http_ok?
+    #
+    # @since 0.3.0
+    #
+    def ok?(options={})
+      Net.http_ok?(options.merge(:url => self))
+    end
+
+    #
+    # @see Net.http_server
+    #
+    # @since 0.3.0
+    #
+    def server(options={})
+      Net.http_server(options.merge(:url => self))
+    end
+
+    #
+    # @see Net.http_powered_by
+    #
+    # @since 0.3.0
+    #
+    def powered_by(options={})
+      Net.http_powered_by(options.merge(:url => self))
+    end
+
+    #
+    # @see Net.http_copy
+    #
+    # @since 0.3.0
+    #
+    def copy(options={},&block)
+      Net.http_copy(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_delete
+    #
+    # @since 0.3.0
+    #
+    def delete(options={},&block)
+      Net.http_delete(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_get
+    #
+    # @since 0.3.0
+    #
+    def get(options={},&block)
+      Net.http_get(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_get_headers
+    #
+    # @since 0.3.0
+    #
+    def get_headers(options={},&block)
+      Net.http_get_headers(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_get_body
+    #
+    # @since 0.3.0
+    #
+    def get_body(options={},&block)
+      Net.http_get_body(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_head
+    #
+    # @since 0.3.0
+    #
+    def head(options={},&block)
+      Net.http_head(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_lock
+    #
+    # @since 0.3.0
+    #
+    def lock(options={},&block)
+      Net.http_lock(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_mkcol
+    #
+    # @since 0.3.0
+    #
+    def mkcol(options={},&block)
+      Net.http_mkcol(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_move
+    #
+    # @since 0.3.0
+    #
+    def move(options={},&block)
+      Net.http_move(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_options
+    #
+    # @since 0.3.0
+    #
+    def options(options={},&block)
+      Net.http_options(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_post
+    #
+    # @since 0.3.0
+    #
+    def post(options={},&block)
+      Net.http_post(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_post_headers
+    #
+    # @since 0.3.0
+    #
+    def post_headers(options={},&block)
+      Net.http_post_headers(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_post_body
+    #
+    # @since 0.3.0
+    #
+    def post_body(options={},&block)
+      Net.http_post_body(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_prop_find
+    #
+    # @since 0.3.0
+    #
+    def prop_find(options={},&block)
+      Net.http_prop_find(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_prop_match
+    #
+    # @since 0.3.0
+    #
+    def prop_match(options={},&block)
+      Net.http_prop_match(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_trace
+    #
+    # @since 0.3.0
+    #
+    def trace(options={},&block)
+      Net.http_trace(options.merge(:url => self),&block)
+    end
+
+    #
+    # @see Net.http_unlock
+    #
+    # @since 0.3.0
+    #
+    def unlock(options={},&block)
+      Net.http_unlock(options.merge(:url => self),&block)
+    end
+
+  end
+end

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

@@ -71,7 +71,7 @@ module Net
     if options[:ssl]
       ssl = true
       ssl_certs = options[:ssl][:certs]
-      ssl_verify = Ronin::Network::SSL.verify(options[:ssl][:verify])
+      ssl_verify = Ronin::Network::SSL::VERIFY[options[:ssl][:verify]]
     else
       ssl = false
       ssl_verify = false

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

@@ -46,6 +46,12 @@ module Net
   #
   # @option options [Symbol] :verify
   #   Specifies whether to verify the SSL certificate.
+  #   May be one of the following:
+  #
+  #   * `:none`
+  #   * `:peer`
+  #   * `:client_once`
+  #   * `:fail_if_no_peer_cert`
   #
   # @option options [String] :cert
   #   The path to the SSL certificate.
@@ -74,7 +80,7 @@ module Net
     socket = Net.tcp_connect(host,port,local_host,local_port)
 
     ssl_context = OpenSSL::SSL::SSLContext.new()
-    ssl_context.verify_mode = Ronin::Network::SSL.verify(options[:verify])
+    ssl_context.verify_mode = Ronin::Network::SSL::VERIFY[options[:verify]]
 
     if options[:cert]
       cert_file = File.new(options[:cert])

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

@@ -93,7 +93,7 @@ module Ronin
           host, port = proxy.split(':',2)
           port = port.to_i if port
 
-          return self.new(
+          return new(
             :host => host,
             :port => port,
             :user => user,
@@ -121,18 +121,18 @@ module Ronin
           when Proxy
             proxy
           when URI::HTTP
-            self.new(
+            new(
               :host => proxy.host,
               :port => proxy.port,
               :user => proxy.user,
               :password => proxy.password
             )
           when Hash
-            self.new(proxy)
+            new(proxy)
           when String
-            self.parse(proxy)
+            parse(proxy)
           when nil
-            self.new
+            new
           else
             raise(ArgumentError,"argument must be either a #{self}, URI::HTTP, Hash or String")
           end
@@ -250,7 +250,7 @@ module Ronin
         # @api public
         #
         def enabled?
-          !(self.host.nil?)
+          !(host.nil?)
         end
 
         #
@@ -265,18 +265,18 @@ module Ronin
         def url
           return nil unless enabled?
 
-          userinfo = if self.user
-                       if self.password
-                         "#{self.user}:#{self.password}"
+          userinfo = if user
+                       if password
+                         "#{user}:#{password}"
                        else
-                         self.user
+                         user
                        end
                      end
           
           return URI::HTTP.build(
             :userinfo => userinfo,
-            :host => self.host,
-            :port => self.port
+            :host => host,
+            :port => port
           )
         end
 
@@ -289,7 +289,7 @@ module Ronin
         # @api public
         #
         def to_s
-          self.host.to_s
+          host.to_s
         end
 
         #
@@ -301,21 +301,20 @@ module Ronin
         # @api public
         #
         def inspect
-          unless self.host
+          unless host
             str = 'disabled'
           else
             str = ''
             
-            str << self.host.to_s
-            str << ":#{self.port}" if self.port
+            str << host.to_s
+            str << ":#{port}" if port
 
-            if self.user
+            if user
               auth_str = ''
+              auth_str << user.to_s
 
-              auth_str << self.user.to_s
-
-              if self.password
-                auth_str << ":#{self.password}"
+              if password
+                auth_str << ":#{password}"
               end
 
               str = "#{auth_str}@#{str}"

data/lib/ronin/network/mixins.rb

@@ -0,0 +1,27 @@
+#
+# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This file is part of Ronin Support.
+#
+# Ronin Support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin Support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require 'ronin/network/mixins/tcp'
+require 'ronin/network/mixins/udp'
+require 'ronin/network/mixins/smtp'
+require 'ronin/network/mixins/esmtp'
+require 'ronin/network/mixins/pop3'
+require 'ronin/network/mixins/imap'
+require 'ronin/network/mixins/telnet'
+require 'ronin/network/mixins/web'

data/lib/ronin/network/mixins/esmtp.rb

@@ -0,0 +1,165 @@
+#
+# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This file is part of Ronin Support.
+#
+# Ronin Support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin Support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require 'ronin/network/esmtp'
+require 'ronin/ui/output/helpers'
+require 'ronin/mixin'
+
+require 'parameters'
+
+module Ronin
+  module Network
+    module Mixins
+      #
+      # Adds ESMTP convenience methods and connection parameters to a class.
+      #
+      # Defines the following parameters:
+      #
+      # * `host` (`String`) - ESMTP host.
+      # * `port` (`Integer`) - ESMTP port.
+      # * `esmtp_login` (`String`) - ESMTP authentication method to use.
+      # * `esmtp_user` (`String`) - ESMTP user to login as.
+      # * `esmtp_password` (`String`) - ESMTP password to login with.
+      #
+      module ESMTP
+        include Mixin
+
+        mixin UI::Output::Helpers, Parameters
+
+        mixin do
+          # ESMTP host
+          parameter :host, :type => String,
+                           :description => 'ESMTP host'
+
+          # ESMTP port
+          parameter :port, :type => Integer,
+                           :description => 'ESMTP port'
+
+          # ESMTP authentication method to use
+          parameter :esmtp_login, :type => String,
+                                  :description => 'ESMTP authentication method to use'
+
+          # ESMTP user to login as
+          parameter :esmtp_user, :type => String,
+                                 :description => 'ESMTP user to login as'
+
+          # ESMTP password to login with
+          parameter :esmtp_password, :type => String,
+                                     :description => 'ESMTP password to login with'
+        end
+
+        protected
+
+        #
+        # @see Ronin::Network::SMTP.message.
+        #
+        # @api public
+        #
+        def esmtp_message(options={},&block)
+          Network::SMTP.message(options,&block)
+        end
+
+        #
+        # Creates a connection to the ESMTP server. The `host`, `port`,
+        # `esmtp_login`, `esmtp_user` and `esmtp_password` parameters
+        # will also be used to connect to the ESMTP server.
+        #
+        # @param [Hash] options
+        #   Additional options.
+        #
+        # @option options [Integer] :port (Ronin::Network::SMTP.default_port)
+        #  The port to connect to.
+        #
+        # @option options [String] :helo
+        #   The HELO domain.
+        #
+        # @option options [Symbol] :auth
+        #   The type of authentication to use.
+        #   Can be either `:login`, `:plain`, or `:cram_md5`.
+        #
+        # @option options [String] :user
+        #   The user-name to authenticate with.
+        #
+        # @option options [String] :password
+        #   The password to authenticate with.
+        #
+        # @yield [session]
+        #   If a block is given, it will be passed an ESMTP enabled
+        #   session object.
+        #
+        # @yieldparam [Net::SMTP] session
+        #   The ESMTP session.
+        #
+        # @return [Net::SMTP]
+        #   The ESMTP enabled session.
+        #
+        # @api public
+        #
+        def esmtp_connect(options={},&block)
+          options[:port] ||= self.port
+          options[:login] ||= self.esmtp_login
+          options[:user] ||= self.esmtp_user
+          options[:password] ||= self.esmtp_password
+
+          if self.port
+            print_info "Connecting to #{self.host}:#{self.port} ..."
+          else
+            print_info "Connecting to #{self.host} ..."
+          end
+
+          return ::Net.esmtp_connect(self.host,options,&block)
+        end
+
+        #
+        # Starts a session with the ESMTP server. The `host`, `port`,
+        # `esmtp_login`, `esmtp_user` and `esmtp_password` parameters
+        # will also be used to connect to the ESMTP server.
+        #
+        # @param [Hash] options
+        #   Additional options.
+        #
+        # @yield [session]
+        #   If a block is given, it will be passed an ESMTP enabled
+        #   session object. After the block has returned, the session
+        #   will be closed.
+        #
+        # @yieldparam [Net::SMTP] session
+        #   The ESMTP session.
+        #
+        # @see esmtp_connect
+        #
+        # @api public
+        #
+        def esmtp_session(options={})
+          esmtp_connect(options) do |sess|
+            yield sess if block_given?
+
+            sess.close
+
+            if self.port
+              print_info "Disconnecting from #{self.host}:#{self.port}"
+            else
+              print_info "Disconnecting from #{self.host}"
+            end
+          end
+        end
+      end
+    end
+  end
+end