ronin-support 0.1.0.pre1

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

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/imap/net'

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

@@ -0,0 +1,124 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/imap'
+require 'ronin/network/ssl'
+
+require 'net/imap'
+
+module Net
+  #
+  # Creates a connection to the IMAP server.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @param [Hash] options
+  #   Additional options.
+  #
+  # @option options [Integer] :port (IMAP.default_port)
+  #   The port the IMAP server is running on.
+  #
+  # @option options [String] :certs
+  #   The path to the file containing CA certs of the server.
+  #
+  # @option options [Symbol] :auth
+  #   The type of authentication to perform when connecting to the server.
+  #   May be either `:login` or `:cram_md5`.
+  #
+  # @option options [String] :user
+  #   The user to authenticate as when connecting to the server.
+  #
+  # @option options [String] :password
+  #   The password to authenticate with when connecting to the server.
+  #
+  # @yield [session]
+  #   If a block is given, it will be passed the newly created IMAP
+  #   session.
+  #
+  # @yieldparam [Net::IMAP] session
+  #   The newly created IMAP session object.
+  #
+  # @return [Net::IMAP]
+  #   The newly created IMAP session object.
+  #
+  def Net.imap_connect(host,options={})
+    host = host.to_s
+    port = (options[:port] || Ronin::Network::IMAP.default_port)
+    certs = options[:certs]
+    auth = options[:auth]
+    user = options[:user]
+    passwd = options[:password]
+
+    if options[:ssl]
+      ssl = true
+      ssl_certs = options[:ssl][:certs]
+      ssl_verify = Ronin::Network::SSL.verify(options[:ssl][:verify])
+    else
+      ssl = false
+      ssl_verify = false
+    end
+
+    session = Net::IMAP.new(host,port,ssl,ssl_certs,ssl_verify)
+
+    if user
+      if auth == :cram_md5
+        session.authenticate('CRAM-MD5',user,passwd)
+      else
+        session.authenticate('LOGIN',user,passwd)
+      end
+    end
+
+    yield session if block_given?
+    return session
+  end
+
+  #
+  # Starts an IMAP session with the IMAP server.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @param [Hash] options
+  #   Additional options.
+  #
+  # @yield [session]
+  #   If a block is given, it will be passed the newly created IMAP
+  #   session. After the block has returned, the session will be closed.
+  #
+  # @yieldparam [Net::IMAP] session
+  #   The newly created IMAP session object.
+  #
+  # @return [nil]
+  #
+  # @see Net.imap_connect
+  #
+  def Net.imap_session(host,options={})
+    session = Net.imap_connect(host,options)
+
+    yield session if block_given?
+
+    session.logout if options[:user]
+    session.close
+    session.disconnect
+    return nil
+  end
+end

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

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/pop3/net'

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

@@ -0,0 +1,92 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/pop3'
+
+require 'net/pop'
+
+module Net
+  #
+  # Creates a connection to the POP3 server.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @param [Hash] options
+  #   Additional options.
+  #
+  # @option options [Integer] :port (Ronin::Network::POP3.default_port)
+  #   The port the POP3 server is running on.
+  #
+  # @option options [String] :user
+  #   The user to authenticate with when connecting to the POP3 server.
+  #
+  # @option options [String] :password
+  #   The password to authenticate with when connecting to the POP3 server.
+  #
+  # @yield [session]
+  #   If a block is given, it will be passed the newly created POP3 session.
+  #
+  # @yieldparam [Net::POP3] session
+  #   The newly created POP3 session.
+  #
+  # @return [Net::POP3]
+  #   The newly created POP3 session.
+  #
+  def Net.pop3_connect(host,options={})
+    host = host.to_s
+    port = (options[:port] || Ronin::Network::POP3.default_port)
+    user = options[:user]
+    password = options[:password]
+
+    session = Net::POP3.start(host,port,user,password)
+
+    yield session if block_given?
+    return session
+  end
+
+  #
+  # Starts a session with the POP3 server.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @param [Hash] options
+  #   Additional options.
+  #
+  # @yield [session]
+  #   If a block is given, it will be passed the newly created POP3 session.
+  #   After the block has returned, the session will be closed.
+  #
+  # @yieldparam [Net::POP3] session
+  #   The newly created POP3 session.
+  #
+  # @return [nil]
+  #
+  def Net.pop3_session(host,options={})
+    session = Net.pop3_connect(host,options)
+
+    yield session if block_given?
+
+    session.finish
+    return nil
+  end
+end

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

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/smtp/net'

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

@@ -0,0 +1,110 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/smtp/email'
+
+require 'net/smtp'
+
+module Net
+  #
+  # @see Ronin::Network::SMTP.message
+  #
+  def Net.smtp_message(options={},&block)
+    Ronin::Network::SMTP.message(options,&block)
+  end
+
+  #
+  # Creates a connection to the SMTP server.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @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 SMTP session object.
+  #
+  # @yieldparam [Net::SMTP] session
+  #   The SMTP session.
+  #
+  # @return [Net::SMTP]
+  #   The SMTP session.
+  #
+  def Net.smtp_connect(host,options={})
+    host = host.to_s
+    port = (options[:port] || Ronin::Network::SMTP.default_port)
+
+    helo = options[:helo]
+
+    auth = options[:auth]
+    user = options[:user]
+    password = options[:password]
+
+    session = Net::SMTP.start(host,port,helo,user,password,auth)
+
+    yield session if block_given?
+    return session
+  end
+
+  #
+  # Starts a session with the SMTP server.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @param [Hash] options
+  #   Additional options.
+  #
+  # @yield [session]
+  #   If a block is given, it will be passed an SMTP session object.
+  #   After the block has returned, the session will be closed.
+  #
+  # @yieldparam [Net::SMTP] session
+  #   The SMTP session.
+  #
+  # @see Net.smtp_connect
+  #
+  def Net.smtp_session(host,options={})
+    session = Net.smtp_connect(host,options)
+
+    yield session if block_given?
+
+    session.finish
+    return nil
+  end
+end

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

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/ssl/net'

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

@@ -0,0 +1,147 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library 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 2.1 of the License, or (at your option) any later version.
+#
+# This library 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 this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/tcp/net'
+require 'ronin/network/ssl'
+
+begin
+  require 'openssl'
+rescue ::LoadError
+end
+
+module Net
+  #
+  # Establishes a SSL connection.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @param [Integer] port
+  #   The port to connect to.
+  #
+  # @param [Hash] options
+  #   Additional options.
+  #
+  # @option options [String] :local_host
+  #   The local host to bind to.
+  #
+  # @option options [Integer] :local_port
+  #   The local port to bind to.
+  #
+  # @option options [Symbol] :verify
+  #   Specifies whether to verify the SSL certificate.
+  #
+  # @option options [String] :cert
+  #   The path to the SSL certificate.
+  #
+  # @option options [String] :key
+  #   The path to the SSL key.
+  #
+  # @yield [ssl_socket]
+  #   The given block will be passed the new SSL Socket.
+  #
+  # @yieldparam [OpenSSL::SSL::SSLSocket] ssl_socket
+  #   The new SSL Socket.
+  #
+  # @return [OpenSSL::SSL::SSLSocket]
+  #   the new SSL Socket.
+  #
+  # @example
+  #   socket = Net.ssl_connect('twitter.com',443)
+  #
+  def Net.ssl_connect(host,port,options={})
+    local_host = options[:local_host]
+    local_port = options[:local_port]
+
+    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])
+
+    if options[:cert]
+      cert_file = File.new(options[:cert])
+      ssl_context.cert = OpenSSL::X509::Certificate.new(cert_file)
+    end
+
+    if options[:key]
+      key_file = File.new(options[:key])
+      ssl_context.key = OpenSSL::PKey::RSA.new(key_file)
+    end
+
+    ssl_socket = OpenSSL::SSL::SSLSocket.new(socket,ssl_context)
+    ssl_socket.sync_close = true
+    ssl_socket.connect
+
+    yield ssl_socket if block_given?
+    return ssl_socket
+  end
+
+  #
+  # Creates a new temporary SSL connection.
+  #
+  # @param [String] host
+  #   The host to connect to.
+  #
+  # @param [Integer] port
+  #   The port to connect to.
+  #
+  # @param [Hash] options
+  #   Additional options.
+  #
+  # @option options [String] :local_host
+  #   The local host to bind to.
+  #
+  # @option options [Integer] :local_port
+  #   The local port to bind to.
+  #
+  # @option options [Symbol] :verify
+  #   Specifies whether to verify the SSL certificate.
+  #
+  # @option options [String] :cert
+  #   The path to the SSL certificate.
+  #
+  # @option options [String] :key
+  #   The path to the SSL key.
+  #
+  # @yield [ssl_socket]
+  #   The given block will be passed the temporary SSL Socket.
+  #
+  # @yieldparam [OpenSSL::SSL::SSLSocket] ssl_socket
+  #   The temporary SSL Socket.
+  #
+  # @return [nil]
+  #
+  # @example
+  #   Net.ssl_session('twitter.com',443) do |sock|
+  #     sock.write("GET /\n\n")
+  #
+  #     sock.each_line { |line| puts line }
+  #   end
+  #
+  def Net.ssl_session(host,port)
+    ssl_socket = Net.ssl_connect(host,port)
+
+    yield ssl_socket if block_given?
+
+    ssl_socket.close
+    return nil
+  end
+end