ronin 0.0.9

data/lib/ronin/sessions/session.rb

@@ -0,0 +1,52 @@
+#
+#--
+# Ronin - A ruby development 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/parameters'
+
+module Ronin
+  module Sessions
+    module Session
+      #
+      # Includes Parameters and runs the _block_ in the specified
+      # _base_class_.
+      #
+      def Session.setup_class(base_class,&block)
+        base_class.module_eval { include Parameters }
+        base_class.module_eval(&block)
+
+        return base_class
+      end
+
+      #
+      # Extends Parameters and runs the specified _block_ in the specified
+      # _obj_.
+      #
+      def Session.setup_object(obj,&block)
+        obj.extend(Parameters)
+        obj.instance_eval(&block)
+
+        return obj
+      end
+    end
+  end
+end

data/lib/ronin/sessions/smtp.rb

@@ -0,0 +1,76 @@
+#
+#--
+# Ronin - A ruby development 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/sessions/session'
+require 'ronin/network/smtp'
+
+module Ronin
+  module Sessions
+    module SMTP
+      include Session
+
+      SMTP_SESSION = proc do
+        parameter :smtp_host, :description => 'SMTP host'
+        parameter :smtp_port, :description => 'SMTP port'
+
+        parameter :smtp_login, :description => 'SMTP login'
+        parameter :smtp_user, :description => 'SMTP user'
+        parameter :smtp_password, :description => 'SMTP password'
+      end
+
+      def self.included(base)
+        Session.setup_class(base,&SMTP_SESSION)
+      end
+
+      def self.extended(obj)
+        Session.setup_object(obj,&SMTP_SESSION)
+      end
+
+      protected
+
+      def smtp_message(options={},&block)
+        Network::SMTP.message(options,&block)
+      end
+
+      def smtp_connect(options={},&block)
+        unless @smtp_host
+          raise(ParamNotFound,"Missing parameter #{describe_param(:smtp_host).dump}",caller)
+        end
+
+        options[:port] ||= @smtp_port
+        options[:login] ||= @smtp_login
+        options[:user] ||= @smtp_user
+        options[:password] ||= @smtp_password
+
+        return ::Net.smtp_connect(@smtp_host,options,&block)
+      end
+
+      def smtp_session(options={},&block)
+        smtp_connect(options) do |sess|
+          block.call(sess) if block
+          sess.close
+        end
+      end
+    end
+  end
+end

data/lib/ronin/sessions/tcp.rb

@@ -0,0 +1,111 @@
+#
+#--
+# Ronin - A ruby development 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/sessions/session'
+require 'ronin/network/tcp'
+
+module Ronin
+  module Sessions
+    module TCP
+      include Session
+
+      TCP_SESSION = proc do
+        parameter :lhost, :description => 'TCP local host'
+        parameter :lport, :description => 'TCP local port'
+
+        parameter :rhost, :description => 'TCP remote host'
+        parameter :rport, :description => 'TCP remote port'
+      end
+
+      def self.included(base)
+        Session.setup_class(base,&TCP_SESSION)
+      end
+
+      def self.extended(obj)
+        Session.setup_object(obj,&TCP_SESSION)
+      end
+
+      protected
+
+      def tcp_connect(&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
+        end
+
+        return ::Net.tcp_connect(@rhost,@rport,@lhost,@lport,&block)
+      end
+
+      def tcp_connect_and_recv(&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
+        end
+
+        return ::Net.tcp_connect_and_recv(@rhost,@rport,@lhost,@lport,&block)
+      end
+
+      def tcp_connect_and_send(data,&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
+        end
+
+        return ::Net.tcp_connect_and_send(data,@rhost,@rport,@lhost,@lport,&block)
+      end
+
+      def tcp_session(&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
+        end
+
+        return Net.tcp_session(@rhost,@rport,@lhost,@lport,&block)
+      end
+
+      def tcp_banner(&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
+        end
+
+        return ::Net.tcp_banner(@rhost,@rport,@lhost,@lport,&block)
+      end
+    end
+  end
+end

data/lib/ronin/sessions/telnet.rb

@@ -0,0 +1,76 @@
+#
+#--
+# Ronin - A ruby development 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/sessions/session'
+require 'ronin/network/telnet'
+
+module Ronin
+  module Sessions
+    module TELNET
+      include Session
+
+      TELNET_SESSION = proc do
+        parameter :telnet_host, :description => 'Telnet host'
+        parameter :telnet_port, :value => Network::Telnet.default_port, :description => 'Telnet port'
+
+        parameter :telnet_user, :description => 'Telnet user'
+        parameter :telnet_password, :description => 'Telnet password'
+
+        parameter :telnet_proxy, :description => 'Telnet proxy'
+        parameter :telnet_ssl, :description => 'Telnet SSL options'
+      end
+
+      def self.included(base)
+        Session.setup_class(base,&TELNET_SESSION)
+      end
+
+      def self.extended(obj)
+        Session.setup_object(obj,&TELNET_SESSION)
+      end
+
+      protected
+
+      def telnet_connect(options={},&block)
+        unless @telnet_host
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:telnet_host)}'",caller)
+        end
+
+        options[:port] ||= @telnet_port
+        options[:user] ||= @telnet_user
+        options[:password] ||= @telnet_password
+
+        options[:proxy] ||= @telnet_proxy
+        options[:ssl] ||= @telnet_ssl
+
+        return ::Net.telnet_connect(@telnet_host,options,&block)
+      end
+
+      def telnet_session(options={},&block)
+        return telnet_connect(options) do |sess|
+          block.call(sess) if block
+          sess.close
+        end
+      end
+    end
+  end
+end

data/lib/ronin/sessions/udp.rb

@@ -0,0 +1,99 @@
+#
+#--
+# Ronin - A ruby development 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/sessions/session'
+require 'ronin/network/udp'
+
+module Ronin
+  module Sessions
+    module UDP
+      include Parameters
+
+      UDP_SESSION = proc do
+        parameter :lhost, :description => 'local host'
+        parameter :lport, :description => 'local port'
+
+        parameter :rhost, :description => 'remote host'
+        parameter :rport, :description => 'remote port'
+      end
+
+      def self.included(base)
+        Session.setup_class(base,&UDP_SESSION)
+      end
+
+      def self.extended(obj)
+        Session.setup_object(obj,&UDP_SESSION)
+      end
+
+      protected
+
+      def udp_connect(&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing '#{describe_param(:rhost)}' parameter",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing '#{describe_param(:rport)}' parameter",caller)
+        end
+
+        return ::Net.udp_connect(@rhost,@rport,@lhost,@lport,&block)
+      end
+
+      def udp_connect_and_recv(&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing '#{describe_param(:rhost)}' parameter",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing '#{describe_param(:rport)}' parameter",caller)
+        end
+
+        return ::Net.udp_connect_and_recv(@rhost,@rport,@lhost,@lport,&block)
+      end
+
+      def udp_connect_and_send(data,&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing '#{describe_param(:rhost)}' parameter",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing '#{describe_param(:rport)}' parameter",caller)
+        end
+
+        return ::Net.udp_connect_and_send(data,@rhost,@rport,@lhost,@lport,&block)
+      end
+
+      def udp_session(&block)
+        unless @rhost
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
+        end
+
+        unless @rport
+          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
+        end
+
+        return ::Net.udp_session(@rhost,@rport,@lhost,@lport,&block)
+      end
+    end
+  end
+end

data/lib/ronin/sessions/web.rb

@@ -0,0 +1,83 @@
+#
+#--
+# Ronin - A ruby development 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/sessions/session'
+require 'ronin/web'
+
+module Ronin
+  module Sessions
+    module Web
+      include Session
+
+      WEB_SESSION = proc do
+        parameter :web_proxy, :value => Ronin::Web.proxy, :description => 'Web Proxy'
+        parameter :web_user_agent, :value => Ronin::Web.user_agent, :description => 'Web User-Agent'
+      end
+
+      def self.included(base)
+        Session.setup_class(base,&WEB_SESSION)
+      end
+
+      def self.extended(obj)
+        Session.setup_object(obj,&WEB_SESSION)
+      end
+
+      protected
+
+      def web_agent(options={},&block)
+        options[:proxy] ||= @web_proxy
+        options[:user_agent] ||= @web_user_agent
+
+        return Ronin::Web.agent(options,&block)
+      end
+
+      def web_get(uri,options={},&block)
+        page = web_agent(options).get(uri)
+
+        block.call(page) if block
+        return page
+      end
+
+      def web_get_body(uri,options={},&block)
+        body = web_agent(options).get(uri).body
+
+        block.call(body) if block
+        return body
+      end
+
+      def web_post(uri,options={},&block)
+        page = web_agent(options).post(uri)
+
+        block.call(page) if block
+        return page
+      end
+
+      def web_post_body(uri,options={},&block)
+        body = web_agent(options).post(uri).body
+
+        block.call(body) if block
+        return body
+      end
+    end
+  end
+end