ronin-exploits 0.2.1 → 0.3.0

data/lib/ronin/exploits/version.rb

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,12 +17,11 @@
 # 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 Exploits
     # Ronin Exploits version
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

data/lib/ronin/exploits/web.rb

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,11 +17,10 @@
 # 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/exploits/remote'
-require 'ronin/sessions/http'
+require 'ronin/network/helpers/http'
 require 'ronin/extensions/uri/http'
 
 require 'uri'
@@ -31,8 +29,16 @@ module Ronin
   module Exploits
     class Web < Remote
 
-      include Sessions::HTTP
+      include Network::Helpers::HTTP
 
+      #
+      # Creates a new Ronin::Exploits::Web object using the given
+      # _block_.
+      #
+      #   ronin_web_exploit do
+      #     ...
+      #   end
+      #
       contextify :ronin_web_exploit
 
       # The targeted URL path
@@ -56,9 +62,12 @@ module Ronin
       parameter :url_prefix, :description => 'Optional URL path prefix'
 
       #
-      # Returns the targeted URL path based on the +url_prefix+ parameter
+      # Builds the targeted URL path based on the +url_prefix+ parameter,
       # as well as the +url_path+ and +url_query+ properties.
       #
+      # @return [String]
+      #   The targeted URL path.
+      #
       def targeted_url_path
         url = self.url_path.to_s
         url << "?#{self.url_query}" if self.url_query
@@ -71,10 +80,13 @@ module Ronin
       end
 
       #
-      # Returns the targeted URL based on the +http_host+, +http_port+
+      # Builds the targeted URL based on the +http_host+, +http_port+
       # and +url_prefix+ parameters as well as the +url_path+ and
       # +url_query+ properties.
       #
+      # @return [URI::Generic]
+      #   The built URI object.
+      #
       def targeted_url
         require_params :host
 

data/lib/ronin/generators/exploits.rb

@@ -0,0 +1,23 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/static'
+require 'ronin/generators/exploits/exploit'

data/lib/ronin/generators/exploits/exploit.rb

@@ -0,0 +1,70 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/static'
+require 'ronin/generators/generator'
+
+require 'ronin/author'
+
+module Ronin
+  module Generators
+    module Exploits
+      class Exploit < Generator
+
+        # Default name to give the exploit
+        DEFAULT_NAME = 'Exploit'
+
+        # Default description to give the exploit
+        DEFAULT_DESCRIPTION = %{This is an exploit.}
+
+        # Default status to give the exploit
+        DEFAULT_STATUS = :potential
+
+        # Default authors of the exploit
+        DEFAULT_AUTHORS = [Author::ANONYMOUSE]
+
+        # Default disclosure information to give the exploit
+        DEFAULT_DISCLOSURE = [:in_wild]
+
+        class_option :helpers, :type => :array, :default => []
+        class_option :name, :type => :string, :default => DEFAULT_NAME
+        class_option :description, :type => :string, :default => DEFAULT_DESCRIPTION
+        class_option :status, :type => :string, :default => DEFAULT_STATUS
+        class_option :disclosure, :type => :array, :default => DEFAULT_DISCLOSURE
+        class_option :authors, :type => :array, :default => DEFAULT_AUTHORS
+        class_option :controls, :type => :array, :default => []
+
+        argument :path, :type => :string, :require => true
+
+        #
+        # Generate a basic exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','exploit.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/exploits/ftp.rb

@@ -0,0 +1,42 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/remote_tcp'
+
+module Ronin
+  module Generators
+    module Exploits
+      class FTP < RemoteTCP
+
+        #
+        # Generate a FTP exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','ftp.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/exploits/http.rb

@@ -0,0 +1,42 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/remote_tcp'
+
+module Ronin
+  module Generators
+    module Exploits
+      class HTTP < RemoteTCP
+
+        #
+        # Generate a HTTP exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','http.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/exploits/local.rb

@@ -0,0 +1,42 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/exploit'
+
+module Ronin
+  module Generators
+    module Exploits
+      class Local < Exploit
+
+        #
+        # Generate a remote exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','local.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/exploits/remote.rb

@@ -0,0 +1,42 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/exploit'
+
+module Ronin
+  module Generators
+    module Exploits
+      class Remote < Exploit
+
+        #
+        # Generate a remote exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','remote.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/exploits/remote_tcp.rb

@@ -0,0 +1,44 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/remote'
+
+module Ronin
+  module Generators
+    module Exploits
+      class RemoteTCP < Remote
+
+        class_option :default_port, :type => :numeric
+
+        #
+        # Generate a remote TCP exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','remote_tcp.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/exploits/remote_udp.rb

@@ -0,0 +1,44 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/generators/exploits/remote'
+
+module Ronin
+  module Generators
+    module Exploits
+      class RemoteUDP < Remote
+
+        class_option :default_port, :type => :numeric
+
+        #
+        # Generate a basic exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','remote_udp.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end