ronin-exploits 0.3.0 → 1.0.0.beta1

data/lib/ronin/payloads/helpers/rpc.rb

@@ -1,93 +0,0 @@
-#
-# 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/payloads/exceptions/not_implemented'
-
-module Ronin
-  module Payloads
-    module Helpers
-      module Rpc
-        #
-        # Calls a specific method with additional arguments.
-        #
-        # @param [Symbol, String] method
-        #   The method name to call.
-        #
-        # @param [Array] arguments
-        #   The arguments to use when calling the method.
-        #
-        # @return [Object]
-        #   The result of the method call.
-        #
-        # @since 0.3.0
-        #
-        def call_method(method,*arguments)
-          raise(NotImplemented,"the call method is unimplemented",caller)
-        end
-
-        #
-        # Evaluates code.
-        #
-        # @param [String] code
-        #   The code to evaluate.
-        #
-        # @return [Object]
-        #   The result of the code evaluation.
-        #
-        # @since 0.3.0
-        #
-        def eval(code)
-          call_method(:eval,code)
-        end
-
-        #
-        # Exits the process.
-        #
-        # @param [Integer] status
-        #   The status to exit with.
-        #
-        # @since 0.3.0
-        #
-        def exit(status=0)
-          call_method(:exit,status)
-        end
-
-        protected
-
-        #
-        # Provides transparent access to remote methods using the
-        # specified _name_ and given _arguments_.
-        #
-        # @since 0.3.0
-        #
-        def method_missing(name,*arguments,&block)
-          name = name.to_s
-
-          if (name[-1..-1] != '=' && block.nil?)
-            return call_method(name,*arguments)
-          end
-
-          return super(name,*arguments,&block)
-        end
-      end
-    end
-  end
-end

data/lib/ronin/payloads/helpers.rb

@@ -1,23 +0,0 @@
-#
-# 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/payloads/helpers/chained'
-require 'ronin/payloads/helpers/rpc'

data/lib/ronin/payloads/nops.rb

@@ -1,39 +0,0 @@
-#
-# 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/payloads/asm_payload'
-
-module Ronin
-  module Payloads
-    class Nops < ASMPayload
-
-      #
-      # Creates a new Ronin::Payloads::Nops object using the given _block_.
-      #
-      #   ronin_nops do
-      #     ...
-      #   end
-      #
-      contextify :ronin_nops
-
-    end
-  end
-end

data/lib/ronin/payloads/payload.rb

@@ -1,350 +0,0 @@
-#
-# 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/payloads/exceptions/unknown_helper'
-require 'ronin/payloads/payload_author'
-require 'ronin/payloads/control'
-require 'ronin/cacheable'
-require 'ronin/model/targets_arch'
-require 'ronin/model/targets_os'
-require 'ronin/model/has_name'
-require 'ronin/model/has_description'
-require 'ronin/model/has_version'
-require 'ronin/model/has_license'
-require 'ronin/controls/behaviors'
-require 'ronin/ui/output/helpers'
-require 'ronin/extensions/kernel'
-
-require 'parameters'
-
-module Ronin
-  module Payloads
-    class Payload
-
-      include Parameters
-      include Cacheable
-      include Model::HasName
-      include Model::HasDescription
-      include Model::HasVersion
-      include Model::HasLicense
-      include Model::TargetsArch
-      include Model::TargetsOS
-      include Controls::Behaviors
-      include UI::Output::Helpers
-
-      #
-      # Creates a new Ronin::Payloads::Payload object using the given
-      # _block_.
-      #
-      #   ronin_payload do
-      #     ...
-      #   end
-      #
-      contextify :ronin_payload
-
-      # Primary key of the payload
-      property :id, Serial
-
-      # Author(s) of the payload
-      has n, :authors, :model => 'Ronin::Payloads::PayloadAuthor'
-
-      # Controls the payload provides
-      has n, :controls, :model => 'Ronin::Payloads::Control'
-
-      # Validations
-      validates_present :name
-      validates_is_unique :version, :scope => [:name]
-
-      # The exploit to deploy with
-      attr_accessor :exploit
-
-      # The raw payload
-      attr_accessor :raw_payload
-
-      #
-      # Creates a new Payload object.
-      #
-      # @param [Array] attributes
-      #   Additional attributes to initialize the payload with.
-      #
-      # @yield []
-      #   If a block is given, it will be evaluated in the newly created
-      #   Payload object.
-      #
-      def initialize(attributes={},&block)
-        super(attributes)
-
-        initialize_params(attributes)
-
-        @built = false
-        @deployed = false
-
-        instance_eval(&block) if block
-      end
-
-      #
-      # Finds all payloads written by a specific author.
-      #
-      # @param [String] name
-      #   The name of the author.
-      #
-      # @return [Array<Payload>]
-      #   The payload written by the author.
-      #
-      def self.written_by(name)
-        all(self.authors.name.like => "%#{name}%")
-      end
-
-      #
-      # Finds all payloads written for a specific organization.
-      #
-      # @param [String] name
-      #   The name of the organization.
-      #
-      # @return [Array<Payload>]
-      #   The payloads written for the organization.
-      #
-      def self.written_for(name)
-        all(self.authors.organization.like => "%#{name}%")
-      end
-
-      #
-      # Adds a new author to the payload.
-      #
-      # @param [Hash] attributes
-      #   Additional attributes to create the PayloadAuthor object with.
-      #
-      # @yield [author]
-      #   If a block is given, it will be passed the newly created author
-      #   object.
-      #
-      # @yieldparam [PayloadAuthor] author
-      #   The author object tied to the payload.
-      #
-      # @example
-      #   author :name => 'Anonymous',
-      #          :email => 'anon@example.com',
-      #          :organization => 'Anonymous LLC'
-      #
-      def author(attributes={},&block)
-        self.authors << PayloadAuthor.new(attributes,&block)
-      end
-
-      #
-      # @return [Boolean]
-      #   Specifies whether the payload is built.
-      #
-      def built?
-        @built == true
-      end
-
-      #
-      # Builds the payload.
-      #
-      # @param [Hash] options
-      #   Additional options to build the payload with and use as
-      #   parameters.
-      #
-      # @yield [payload]
-      #   If a block is given, it will be yielded the result of the
-      #   payload building.
-      #
-      # @yieldparam [String] payload
-      #   The built payload.
-      #
-      # @return [String]
-      #   The built payload.
-      #
-      def build!(options={},&block)
-        self.params = options
-
-        print_debug "Payload parameters: #{self.params.inspect}"
-
-        @built = false
-        @raw_payload = ''
-
-        print_info "Building payload ..."
-
-        build()
-
-        print_info "Payload built!"
-
-        @built = true
-
-        if block
-          if block.arity == 1
-            block.call(self)
-          else
-            block.call()
-          end
-        end
-
-        return self
-      end
-
-      #
-      # Verifies the payload is properly configured and ready to be
-      # deployed.
-      #
-      def verify!
-        print_info "Verifying payload ..."
-
-        verify
-
-        print_info "Payload verified!"
-      end
-
-      #
-      # @return [Boolean]
-      #   Specifies whether the payload has previously been deployed.
-      #
-      def deployed?
-        @deployed == true
-      end
-
-      #
-      # Verifies the built payload and deploys the payload.
-      #
-      # @yield [payload]
-      #   If a block is given, it will be passed the deployed payload.
-      #
-      # @yieldparam [Payload] payload
-      #   The deployed payload.
-      #
-      def deploy!(&block)
-        # verify the payload
-        verify!
-
-        print_info "Deploying payload ..."
-        @deployed = false
-
-        deploy()
-
-        print_info "Payload deployed!"
-        @deployed = true
-        
-        if block
-          if block.arity == 1
-            block.call(self)
-          else
-            block.call()
-          end
-        end
-
-        return self
-      end
-
-      #
-      # Converts the payload to a String.
-      #
-      # @return [String]
-      #   The name and version of the payload.
-      #
-      def to_s
-        if (self.name && self.version)
-          "#{self.name} #{self.version}"
-        elsif self.name
-          self.name
-        elsif self.version
-          self.version
-        end
-      end
-
-      #
-      # Inspects the contents of the payload.
-      #
-      # @return [String]
-      #   The inspected payload.
-      #
-      def inspect
-        str = "#{self.class}: #{self}"
-        str << " #{self.params.inspect}" unless self.params.empty?
-
-        return "#<#{str}>"
-      end
-
-      protected
-
-      #
-      # Extends the payload with the helper module defined in
-      # Ronin::Payloads::Helpers that has the similar name.
-      #
-      # @param [Symbol, String] name
-      #   The snake-case name of the payload helper to load and extend the
-      #   payload with.
-      #
-      # @return [true]
-      #   The payload helper was successfully loaded.
-      #
-      # @raise [UnknownHelper]
-      #   No valid helper module could be found or loaded with the similar
-      #   name.
-      #
-      # @example
-      #   helper :shell
-      #
-      def helper(name)
-        name = name.to_s
-        module_name = name.to_const_string
-
-        begin
-          require_within File.join('ronin','payloads','helpers'), name
-        rescue Gem::LoadError => e
-          raise(e)
-        rescue ::LoadError
-          raise(UnknownHelper,"unknown helper #{name.dump}",caller)
-        end
-
-        unless Ronin::Payloads::Helpers.const_defined?(module_name)
-          raise(UnknownHelper,"unknown helper #{name.dump}",caller)
-        end
-
-        helper_module = Ronin::Payloads::Helpers.const_get(module_name)
-
-        unless helper_module.kind_of?(Module)
-          raise(UnknownHelper,"unknown helper #{name.dump}",caller)
-        end
-
-        extend helper_module
-        return true
-      end
-
-      #
-      # Default builder method.
-      #
-      def build
-      end
-
-      #
-      # Default payload verifier method.
-      #
-      def verify
-      end
-
-      #
-      # Default payload deployer method.
-      #
-      def deploy(&block)
-      end
-
-    end
-  end
-end

data/lib/ronin/payloads/payload_author.rb

@@ -1,33 +0,0 @@
-#
-# 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/author'
-
-module Ronin
-  module Payloads
-    class PayloadAuthor < Author
-
-      # The payload the author wrote
-      belongs_to :payload, :nullable => true
-
-    end
-  end
-end

data/lib/ronin/payloads/shellcode.rb

@@ -1,40 +0,0 @@
-#
-# 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/payloads/binary_payload'
-
-module Ronin
-  module Payloads
-    class Shellcode < ASMPayload
-
-      #
-      # Creates a new Ronin::Payloads::Shellcode object using the given
-      # _block_.
-      #
-      #   ronin_shellcode do
-      #     ...
-      #   end
-      #
-      contextify :ronin_shellcode
-
-    end
-  end
-end

data/lib/ronin/payloads/web_payload.rb

@@ -1,41 +0,0 @@
-#
-# 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/payloads/payload'
-require 'ronin/formatting/http'
-
-module Ronin
-  module Payloads
-    class WebPayload < Payload
-
-      #
-      # Creates a new Ronin::Payloads::WebPayload object using the given
-      # _block_.
-      #
-      #   ronin_web_payload do
-      #     ...
-      #   end
-      #
-      contextify :ronin_web_payload
-
-    end
-  end
-end

data/lib/ronin/payloads.rb

@@ -1,36 +0,0 @@
-#
-# 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/payloads/encoders'
-require 'ronin/payloads/payload'
-require 'ronin/payloads/binary_payload'
-require 'ronin/payloads/asm_payload'
-require 'ronin/payloads/nops'
-require 'ronin/payloads/shellcode'
-require 'ronin/database'
-
-require 'reverse_require'
-
-require_for 'ronin-exploits', 'ronin/exploits'
-
-module Ronin
-  Database.update!
-end