ronin 0.0.9

data/lib/ronin/network/extensions/imap.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/imap/net'

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

@@ -0,0 +1,92 @@
+#
+#--
+# 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/imap'
+
+require 'net/imap'
+
+module Net
+  #
+  # Connects to the IMAP server on the specified _host_ with the given
+  # _options_. If a _block_ is given, it will be passed the newly created
+  # Net::Imap object.
+  #
+  # _options_ may contain the following keys:
+  # <tt>:port</tt>:: The port the IMAP server is running on. Defaults to
+  #                  IMAP.default_port.
+  # <tt>:certs</tt>:: The path to the file containing CA certs of the server.
+  # <tt>:auth</tt>:: The type of authentication to perform when connecting
+  #                  to the server. May be either :login, or :cram_md5.
+  # <tt>:user</tt>:: The user to authenticate as when connecting to the
+  #                  server.
+  # <tt>:password</tt>:: The password to authenticate with when connecting
+  #                      to the server.
+  # <tt>:ssl</tt>:: Indicates wether or not to use SSL when connecting to
+  #                 the server.
+  #
+  def Net.imap_connect(host,options={},&block)
+    port = (options[:port] || Ronin::Net::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 = options[:ssl][:verify]
+    else
+      ssl = false
+      ssl_verify = false
+    end
+
+    sess = Net::IMAP.new(host,port,ssl,ssl_certs,ssl_verify)
+
+    if user
+      if auth==:cram_md5
+        sess.authenticate('CRAM-MD5',user,passwd)
+      else
+        sess.authenticate('LOGIN',user,passwd)
+      end
+    end
+
+    block.call(sess) if block
+    return sess
+  end
+
+  #
+  # Starts an IMAP session with the IMAP server running on the specified
+  # _host_ with the given _options_. If a _block_ is given, it will be
+  # called before the session is closed.
+  #
+  def Net.imap_session(host,options={},&block)
+    Net.imap_connect(host,options) do |sess|
+      block.call(sess) if block
+      sess.logout if options[:user]
+      sess.close
+      sess.disconnect
+    end
+
+    return nil
+  end
+end

data/lib/ronin/network/extensions/pop3.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/pop3/net'

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

@@ -0,0 +1,65 @@
+#
+#--
+# 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/pop3'
+
+require 'net/pop'
+
+module Net
+  #
+  # Connects to the POP3 server on the specified _host_ using the given
+  # _options_. If a _block_ is given, it will be passed the newly created
+  # <tt>Net::POP3</tt> object.
+  #
+  # _options_ may contain the following keys:
+  # <tt>:port</tt>:: The port the POP3 server is running on. Defaults to
+  #                  <tt>Ronin::Network::POP3.default_port</tt>.
+  # <tt>:user</tt>:: The user to authenticate with when connecting to the
+  #                  POP3 server.
+  # <tt>:password</tt>:: The password to authenticate with when connecting
+  #                      to the POP3 server.
+  #
+  def Net.pop3_connect(host,options={},&block)
+    port = (options[:port] || Ronin::Network::POP3.default_port)
+    user = options[:user]
+    password = options[:password]
+
+    sess Net::POP3.start(host,port,user,password)
+    block.call(sess) if block
+    return sess
+  end
+
+  #
+  # Starts a session with the POP3 server on the specified _host_ using the
+  # given _options_. If a _block_ is given, it will be passed the newly
+  # created <tt>Net::POP3</tt> object before the connection is closed.
+  #
+  def Net.pop3_session(host,options={},&block)
+    Net.pop3_connect(host,options) do |sess|
+      block.call(sess) if block
+      sess.finish
+    end
+
+    return nil
+  end
+end

data/lib/ronin/network/extensions/smtp.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/smtp/net'

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

@@ -0,0 +1,80 @@
+#
+#--
+# 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/smtp/email'
+
+require 'net/smtp'
+
+module Net
+  #
+  # See <tt>Ronin::Network::SMTP.message</tt>.
+  #
+  def Net.smtp_message(options={},&block)
+    Ronin::Network::SMTP.message(options,&block)
+  end
+
+  #
+  # Connects to the SMTP server on the specified _host_ with the given
+  # _options_. If a _block_ is given it will be passed the newly created
+  # <tt>Net::SMTP</tt> object.
+  #
+  # _options_ may contain the following keys:
+  # <tt>:port</tt>:: The port to connect to, defaults to
+  #                  <tt>Ronin::Network::SMTP.default_port</tt>.
+  # <tt>:helo</tt>:: The HELO domain.
+  # <tt>:auth</tt>:: The type of authentication to use. Can be
+  #                  either <tt>:login</tt>, <tt>:plain</tt> or
+  #                  <tt>:cram_md5</tt>.
+  # <tt>:user</tt>:: The user name to authenticate with.
+  # <tt>:password</tt>:: The password to authenticate with.
+  #
+  def Net.smtp_connect(host,options={},&block)
+    port = (options[:port] || Ronin::Network::SMTP.default_port)
+
+    helo = options[:helo]
+
+    auth = options[:auth]
+    user = options[:user]
+    password = options[:password]
+
+    sess = Net::SMTP.start(host,port,helo,user,password,auth)
+
+    block.call(sess) if block
+    return sess
+  end
+
+  #
+  # Connects to the SMTP server on the specified _host_ with the given
+  # _options_. If a _block_ is given it will be passed the newly created
+  # <tt>Net::SMTP</tt> object. After the <tt>Net::SMTP</tt> object has been
+  # passed to the _block_ it will be closed.
+  #
+  def Net.smtp_session(host,options={},&block)
+    Net.smtp_connect(host,options) do |sess|
+      block.call(sess) if block
+      sess.finish
+    end
+
+    return nil
+  end
+end

data/lib/ronin/network/extensions/tcp.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/tcp/net'

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

@@ -0,0 +1,94 @@
+#
+#--
+# 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 TCPSocket object with the specified _rhost_, _rport_
+  # and the given _lhost_ and _lport_. If _block_ is given, it will be
+  # passed the newly created TCPSocket object.
+  #
+  #   Net.tcp_connect('www.hackety.org',80) # => TCPSocket
+  #
+  #   Net.tcp_connect('www.wired.com',80) do |sock|
+  #     sock.write("GET /\n\n")
+  #     puts sock.readlines
+  #     sock.close
+  #   end
+  #
+  def Net.tcp_connect(rhost,rport,lhost=nil,lport=nil,&block)
+    sock = TCPSocket.new(rhost,rport,lhost,lport)
+    block.call(sock) if block
+
+    return sock
+  end
+
+  #
+  # Creates a new TCPSocket object with the specified _rhost_ 
+  # _rport_, and the given _lhost_ and _lport_. The specified _data_ will
+  # then be written to the newly created TCPSocket. If a _block_ is given
+  # it will be passed the TCPSocket object.
+  #
+  def Net.tcp_connect_and_send(data,rhost,rport,lhost=nil,lport=nil,&block)
+    Net.tcp_connect(rhost,rport,lhost,lport) do |sock|
+      sock.write(data)
+
+      block.call(sock) if block
+    end
+  end
+
+  #
+  # Creates a new TCPSocket object with the specified _rhost_, _rport_
+  # and the given _lhost_ and _lport_. If _block_ is given, it will be
+  # passed the newly created TCPSocket object. After the TCPSocket object
+  # has been passed to the given _block_ it will be closed.
+  #
+  def Net.tcp_session(rhost,rport,lhost=nil,lport=nil,&block)
+    Net.tcp_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.
+  #
+  #   Net.tcp_banner('pop.gmail.com',25)
+  #   # => "220 mx.google.com ESMTP c20sm3096959rvf.1"
+  #
+  def Net.tcp_banner(rhost,rport,lhost=nil,lport=nil,&block)
+    banner = nil
+
+    Net.tcp_session(rhost,rport,lhost,lport) do |sock|
+      banner = sock.readline.strip
+    end
+
+    block.call(banner) if block
+    return banner
+  end
+end

data/lib/ronin/network/extensions/telnet.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/telnet/net'