pwn 0.4.602 → 0.4.604

data/lib/pwn/plugins/spider.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'anemone'
+
+module PWN
+  module Plugins
+    # This plugin supports Pastebin actions.
+    module Spider
+      # Supported Method Parameters::
+      # PWN::Plugins::Spider.crawl(
+      #   target_fqdn: 'required - target fqdn to spider',
+      #   results_path: 'required - path to save spider results',
+      #   proxy: 'optional - proxy to spider through e.g. http://127.0.0.1:8080'
+      # )
+
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      public_class_method def self.crawl(opts = {})
+        # TODO: Add AuthN Support
+        # FYI: Anemone very well may have a memory leak.
+        # Despite saving results to file, Anemone causes
+        # memory exhaustion on large sites
+        target_fqdn = opts[:target_fqdn].to_s.scrub.strip.chomp
+        results_path = opts[:results_path].to_s.scrub.strip.chomp
+
+        proxy = opts[:proxy].to_s.scrub.strip.chomp unless opts[:proxy].nil?
+
+        # Colors!
+        green = "\e[32m"
+        yellow = "\e[33m"
+        end_of_color = "\e[0m"
+
+        puts "#{green}Spidering Target FQDN: #{target_fqdn}#{end_of_color}"
+        File.open(results_path, 'w') do |f|
+          if proxy
+            proxy_uri = URI.parse(proxy)
+            proxy_hash = { proxy_host: proxy_uri.host, proxy_port: proxy_uri.port }
+            Anemone.crawl(target_fqdn, proxy_hash) do |anemone|
+              anemone.on_every_page do |page|
+                puts "#{yellow}Discovered: #{page.url}#{end_of_color}"
+                f.puts(page.url)
+              end
+            end
+          else
+            Anemone.crawl(target_fqdn) do |anemone|
+              anemone.on_every_page do |page|
+                puts "#{green}Discovered: #{page.url}#{end_of_color}"
+                f.puts(page.url)
+              end
+            end
+          end
+        end
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <request.pentest@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <request.pentest@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts %{USAGE:
+          #{self}.crawl(
+            target_fqdn: 'required - target fqdn to spider',
+            results_path: 'required - path to save spider results',
+            proxy: 'optional - proxy to spider through e.g. http://127.0.0.1:8080'
+          )
+
+          #{self}.authors
+        }
+      end
+    end
+  end
+end

data/lib/pwn/plugins/ssn.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module PWN
+  module Plugins
+    # This plugin provides useful social security number capabilities
+    module SSN
+      # Supported Method Parameters::
+      # PWN::Plugins::SSN.generate(
+      #   count: 'required - number of SSN numbers to generate'
+      # )
+
+      public_class_method def self.generate(opts = {})
+        count = opts[:count].to_i
+
+        # Based upon new SSN Randomization:
+        # https://www.ssa.gov/employer/randomization.html
+        ssn_result_arr = []
+        (1..count).each do
+          this_area = format('%0.3d', Random.rand(1..999))
+          this_group = format('%0.2d', Random.rand(1..99))
+          this_serial = format('%0.4d', Random.rand(1..9999))
+          this_ssn = "#{this_area}-#{this_group}-#{this_serial}"
+          ssn_result_arr.push(this_ssn)
+        end
+
+        ssn_result_arr
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <request.pentest@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <request.pentest@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          #{self}.generate(
+            count: 'required - number of SSN numbers to generate'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/plugins/thread_pool.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module PWN
+  module Plugins
+    # This plugin makes the creation of a thread pool much simpler.
+    module ThreadPool
+      # Supported Method Parameters::
+      # PWN::Plugins::ThreadPool.fill(
+      #   enumerable_array: 'required array for proper thread pool assignment',
+      #   max_threads: 'optional number of threads in the thread pool (defaults to 9)',
+      #   seconds_between_thread_exec: 'optional - time to sleep between thread execution (defaults to 0)'
+      #   &block
+      # )
+      #
+      # Example:
+      # arr = [1, 2, 3, 4, 5, 6, 7, 8, 9]
+      # mutex = Mutex.new
+      # PWN::Plugins::ThreadPool.fill(enumerable_array: arr, max_threads: 9) do |integer|
+      #   mutex.synchronize do
+      #     puts integer
+      #   end
+      # end
+
+      public_class_method def self.fill(opts = {})
+        enumerable_array = opts[:enumerable_array]
+        max_threads = opts[:max_threads].to_i
+        max_threads = 9 if max_threads.zero?
+        # seconds_between_thread_exec = opts[:seconds_between_thread_exec].to_i
+
+        puts "Initiating Thread Pool of #{max_threads} Worker Threads...."
+        queue = SizedQueue.new(max_threads)
+        threads = Array.new(max_threads) do
+          Thread.new do
+            until (this_thread = queue.pop) == :POOL_EXHAUSTED
+              yield this_thread
+            end
+          end
+        end
+
+        enumerable_array.uniq.sort.each do |this_thread|
+          queue << this_thread
+        end
+
+        max_threads.times do
+          queue << :POOL_EXHAUSTED
+        end
+
+        # threads.each do |thread|
+        #   sleep seconds_between_thread_exec if seconds_between_thread_exec.positive?
+        #   thread.join
+        # end
+        threads.each(&:join)
+      rescue Interrupt
+        puts "\nGoodbye."
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <request.pentest@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <request.pentest@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          #{self}.fill(
+            enumerable_array. => 'required array for proper thread pool assignment',
+            max_threads: 'optional number of threads in the thread pool (defaults to 9)',
+            &block
+          )
+
+          Example:
+          arr = [1, 2, 3, 4, 5, 6, 7, 8, 9]
+          #{self}.fill(enumerable_array: arr, max_threads: 9) do |integer|
+            puts integer
+          end
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/plugins/transparent_browser.rb

@@ -0,0 +1,423 @@
+# frozen_string_literal: true
+
+require 'watir'
+require 'selenium/webdriver'
+require 'selenium/devtools'
+require 'rest-client'
+require 'socksify'
+require 'openssl'
+require 'em/pure_ruby'
+require 'faye/websocket'
+
+module PWN
+  module Plugins
+    # This plugin rocks. Chrome, Firefox, PhantomJS, IE, REST Client,
+    # all from the comfort of one plugin.  Proxy support (e.g. Burp
+    # Suite Professional) is completely available for all browsers
+    # except for limited functionality within IE (IE has interesting
+    # protections in place to prevent this).  This plugin also supports
+    # taking screenshots :)
+    module TransparentBrowser
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # browser_obj1 = PWN::Plugins::TransparentBrowser.open(
+      #   browser_type: :firefox|:chrome|:headless|:rest|:websocket,
+      #   proxy: 'optional - scheme://proxy_host:port',
+      #   with_tor: 'optional - boolean (defaults to false)'
+      #   with_devtools: 'optional - boolean (defaults to false)'
+      # )
+
+      public_class_method def self.open(opts = {})
+        this_browser = nil
+        browser_type = opts[:browser_type]
+        proxy = opts[:proxy].to_s unless opts[:proxy].nil?
+        opts[:with_tor] ? (with_tor = true) : (with_tor = false)
+        opts[:with_devtools] ? (with_devtools = true) : (with_devtools = false)
+
+        # Let's crank up the default timeout from 30 seconds to 15 min for slow sites
+        Watir.default_timeout = 900
+
+        case browser_type
+        when :firefox
+          this_profile = Selenium::WebDriver::Firefox::Profile.new
+
+          # Increase Web Assembly Verbosity
+          this_profile['javascript.options.wasm_verbose'] = true
+
+          # Downloads reside in ~/Downloads
+          this_profile['browser.download.folderList'] = 1
+          this_profile['browser.helperApps.neverAsk.saveToDisk'] = 'application/pdf'
+
+          # disable Firefox's built-in PDF viewer
+          this_profile['pdfjs.disabled'] = true
+
+          # disable Adobe Acrobat PDF preview plugin
+          this_profile['plugin.scan.plid.all'] = false
+          this_profile['plugin.scan.Acrobat'] = '99.0'
+
+          # ensure localhost proxy capabilities are enabled
+          this_profile['network.proxy.no_proxies_on'] = ''
+
+          # allow scripts to run a bit longer
+          # this_profile['dom.max_chrome_script_run_time'] = 180
+          # this_profile['dom.max_script_run_time'] = 180
+
+          # disable browser cache
+          this_profile['browser.cache.disk.enable'] = false
+          this_profile['browser.cache.disk_cache_ssl.enable'] = false
+          this_profile['browser.cache.memory.enable'] = false
+          this_profile['browser.cache.offline.enable'] = false
+          this_profile['devtools.cache.disabled'] = true
+          this_profile['dom.caches.enabled'] = false
+
+          # caps = Selenium::WebDriver::Remote::Capabilities.firefox
+          # caps[:acceptInsecureCerts] = true
+
+          if proxy
+            this_profile['network.proxy.type'] = 1
+            this_profile['network.proxy.allow_hijacking_localhost'] = true
+            if with_tor
+              this_profile['network.proxy.socks_version'] = 5
+              this_profile['network.proxy.socks'] = URI(proxy).host
+              this_profile['network.proxy.socks_port'] = URI(proxy).port
+            else
+              this_profile['network.proxy.ftp'] = URI(proxy).host
+              this_profile['network.proxy.ftp_port'] = URI(proxy).port
+              this_profile['network.proxy.http'] = URI(proxy).host
+              this_profile['network.proxy.http_port'] = URI(proxy).port
+              this_profile['network.proxy.ssl'] = URI(proxy).host
+              this_profile['network.proxy.ssl_port'] = URI(proxy).port
+            end
+          end
+
+          args = []
+
+          args.push('--devtools') if with_devtools
+          options = Selenium::WebDriver::Firefox::Options.new(args: args, accept_insecure_certs: true)
+          options.profile = this_profile
+          driver = Selenium::WebDriver.for(:firefox, capabilities: options)
+          this_browser = Watir::Browser.new(driver)
+
+        when :chrome
+          this_profile = Selenium::WebDriver::Chrome::Profile.new
+          this_profile['download.prompt_for_download'] = false
+          this_profile['download.default_directory'] = '~/Downloads'
+
+          switches = []
+          switches.push('--start-maximized')
+          switches.push('--disable-notifications')
+
+          if proxy
+            switches.push("--host-resolver-rules='MAP * 0.0.0.0 , EXCLUDE #{URI(proxy).host}'") if with_tor
+            switches.push("--proxy-server=#{proxy}")
+          end
+
+          if with_devtools
+            switches.push('--auto-open-devtools-for-tabs')
+            switches.push('--disable-hang-monitor')
+          end
+
+          options = Selenium::WebDriver::Chrome::Options.new(
+            args: switches,
+            accept_insecure_certs: true
+          )
+
+          options.profile = this_profile
+          driver = Selenium::WebDriver.for(:chrome, capabilities: options)
+          this_browser = Watir::Browser.new(driver)
+
+        when :headless, :headless_firefox
+          this_profile = Selenium::WebDriver::Firefox::Profile.new
+
+          # Increase Web Assembly Verbosity
+          this_profile['javascript.options.wasm_verbose'] = true
+
+          # Downloads reside in ~/Downloads
+          this_profile['browser.download.folderList'] = 1
+          this_profile['browser.helperApps.neverAsk.saveToDisk'] = 'application/pdf'
+
+          # disable Firefox's built-in PDF viewer
+          this_profile['pdfjs.disabled'] = true
+
+          # disable Adobe Acrobat PDF preview plugin
+          this_profile['plugin.scan.plid.all'] = false
+          this_profile['plugin.scan.Acrobat'] = '99.0'
+
+          # ensure localhost proxy capabilities are enabled
+          this_profile['network.proxy.no_proxies_on'] = ''
+
+          # allow scripts to run a bit longer
+          # this_profile['dom.max_chrome_script_run_time'] = 180
+          # this_profile['dom.max_script_run_time'] = 180
+
+          # disable browser cache
+          this_profile['browser.cache.disk.enable'] = false
+          this_profile['browser.cache.disk_cache_ssl.enable'] = false
+          this_profile['browser.cache.memory.enable'] = false
+          this_profile['browser.cache.offline.enable'] = false
+          this_profile['devtools.cache.disabled'] = true
+          this_profile['dom.caches.enabled'] = false
+
+          # caps = Selenium::WebDriver::Remote::Capabilities.firefox
+          # caps[:acceptInsecureCerts] = true
+
+          if proxy
+            this_profile['network.proxy.type'] = 1
+            this_profile['network.proxy.allow_hijacking_localhost'] = true
+            if with_tor
+              this_profile['network.proxy.socks_version'] = 5
+              this_profile['network.proxy.socks'] = URI(proxy).host
+              this_profile['network.proxy.socks_port'] = URI(proxy).port
+            else
+              this_profile['network.proxy.ftp'] = URI(proxy).host
+              this_profile['network.proxy.ftp_port'] = URI(proxy).port
+              this_profile['network.proxy.http'] = URI(proxy).host
+              this_profile['network.proxy.http_port'] = URI(proxy).port
+              this_profile['network.proxy.ssl'] = URI(proxy).host
+              this_profile['network.proxy.ssl_port'] = URI(proxy).port
+            end
+          end
+
+          options = Selenium::WebDriver::Firefox::Options.new(args: ['-headless'], accept_insecure_certs: true)
+          options.profile = this_profile
+          driver = Selenium::WebDriver.for(:firefox, capabilities: options)
+          this_browser = Watir::Browser.new(driver)
+
+        when :headless_chrome
+          this_profile = Selenium::WebDriver::Chrome::Profile.new
+          this_profile['download.prompt_for_download'] = false
+          this_profile['download.default_directory'] = '~/Downloads'
+
+          switches = []
+          switches.push('--headless')
+          switches.push('--start-maximized')
+          switches.push('--disable-notifications')
+
+          if proxy
+            switches.push("--host-resolver-rules='MAP * 0.0.0.0 , EXCLUDE #{URI(proxy).host}'") if with_tor
+            switches.push("--proxy-server=#{proxy}")
+          end
+
+          options = Selenium::WebDriver::Chrome::Options.new(
+            args: switches,
+            accept_insecure_certs: true
+          )
+
+          options.profile = this_profile
+          driver = Selenium::WebDriver.for(:chrome, capabilities: options)
+          this_browser = Watir::Browser.new(driver)
+
+        when :rest
+          this_browser = RestClient
+          if proxy
+            if with_tor
+              TCPSocket.socks_server = URI(proxy).host
+              TCPSocket.socks_port = URI(proxy).port
+            else
+              this_browser.proxy = proxy
+            end
+          end
+
+        when :websocket
+          if proxy
+            if with_tor
+              TCPSocket.socks_server = URI(proxy).host
+              TCPSocket.socks_port = URI(proxy).port
+            end
+            proxy_opts = { origin: proxy }
+            tls_opts = { verify_peer: false }
+            this_browser = Faye::WebSocket::Client.new(
+              '',
+              [],
+              {
+                tls: tls_opts,
+                proxy: proxy_opts
+              }
+            )
+          else
+            this_browser = Faye::WebSocket::Client.new('')
+          end
+        else
+          puts 'Error: browser_type only supports :firefox, :chrome, :headless, :rest, or :websocket'
+          return nil
+        end
+
+        this_browser
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # browser_obj = PWN::Plugins::TransparentBrowser.linkout(
+      #   browser_obj: browser_obj1
+      # )
+
+      public_class_method def self.linkout(opts = {})
+        this_browser_obj = opts[:browser_obj]
+
+        this_browser_obj.links.each do |link|
+          @@logger.info("#{link.text} => #{link.href}\n\n\n") unless link.text == ''
+        end
+
+        this_browser_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::TransparentBrowser.type_as_human(
+      #   string: 'required - string to type as human',
+      #   rand_sleep_float: 'optional - float timing in between keypress (defaults to 0.09)'
+      # )
+
+      public_class_method def self.type_as_human(opts = {})
+        string = opts[:string].to_s
+
+        rand_sleep_float = if opts[:rand_sleep_float]
+                             opts[:rand_sleep_float].to_f
+                           else
+                             0.09
+                           end
+
+        string.each_char do |char|
+          yield char
+          sleep Random.rand(rand_sleep_float)
+        end
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # browser_obj1 = PWN::Plugins::TransparentBrowser.close(
+      #   browser_obj: 'required - browser_obj returned from #open method)'
+      # )
+
+      public_class_method def self.close(opts = {})
+        this_browser_obj = opts[:browser_obj]
+
+        unless this_browser_obj.to_s.include?('RestClient')
+          # Close the browser unless this_browser_obj.nil? (thus the &)
+          this_browser_obj&.close
+        end
+        nil
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <request.pentest@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <request.pentest@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          browser_obj1 = #{self}.open(
+            browser_type: :firefox|:chrome|:headless_chrome|:headless_firefox|:rest|:websocket,
+            proxy: 'optional scheme://proxy_host:port',
+            with_tor: 'optional boolean (defaults to false)',
+            with_devtools: 'optional - boolean (defaults to false)'
+          )
+          puts browser_obj1.public_methods
+
+          ********************************************************
+          * DevTools Interaction Only works w/ Chrome
+          * All DevTools Commands can be found here:
+          * https://chromedevtools.github.io/devtools-protocol/
+          * Examples
+          devtools = browser_obj1.driver.devtools
+          puts devtools.public_methods
+          puts devtools.instance_variables
+          puts devtools.instance_variable_get('@messages')
+
+          * Tracing
+          devtools.send_cmd('Tracing.start')
+          devtools.send_cmd('Tracing.requestMemoryDump')
+          devtools.send_cmd('Tracing.end')
+          puts devtools.instance_variable_get('@messages')
+
+          * Network
+          devtools.send_cmd('Network.enable')
+          last_ws_resp = devtools.instance_variable_get('@messages').last if devtools.instance_variable_get('@messages').last['method'] == 'Network.webSocketFrameReceived'
+          puts last_ws_resp
+          devtools.send_cmd('Network.disable')
+
+          * Debugging DOM and Sending JavaScript to Console
+          devtools.send_cmd('Runtime.enable')
+          devtools.send_cmd('Console.enable')
+          devtools.send_cmd('DOM.enable')
+          devtools.send_cmd('Page.enable')
+          devtools.send_cmd('Log.enable')
+          devtools.send_cmd('Debugger.enable')
+          devtools.send_cmd('Debugger.pause')
+          step = 1
+          next_step = 60
+          loop do
+            devtools.send_cmd('Console.clearMessages')
+            devtools.send_cmd('Log.clear')
+            console_events = []
+            b.driver.on_log_event(:console) { |event| console_events.push(event) }
+
+            devtools.send_cmd('Debugger.stepInto')
+            puts \"Step: \#{step}\"
+
+            this_document = devtools.send_cmd('DOM.getDocument')
+            puts \"This #document:\\n\#{this_document}\\n\\n\\n\"
+
+            console_cmd = {
+              expression: 'for(var pop_var in window) { if (window.hasOwnProperty(pop_var) && window[pop_var] != null) console.log(pop_var + \" = \" + window[pop_var]); }'
+            }
+            puts devtools.send_cmd('Runtime.evaluate', **console_cmd)
+
+            print '-' * 180
+            print \"\\n\"
+            console_events.each do |event|
+              puts event.args
+            end
+            puts \"Console Response Length: \#{console_events.length}\"
+            console_events_digest = OpenSSL::Digest::SHA256.hexdigest(
+              console_events.inspect
+            )
+            puts \"Console Events Array SHA256 Digest: \#{console_events_digest}\"
+            print '-' * 180
+            puts \"\\n\\n\\n\"
+
+            print \"Next Step in \"
+            next_step.downto(1) {|n| print \"\#{n} \"; sleep 1 }
+            puts 'READY!'
+            step += 1
+          end
+
+          devtools.send_cmd('Debugger.disable')
+          devtools.send_cmd('Log.disable')
+          devtools.send_cmd('Page.disable')
+          devtools.send_cmd('DOM.disable')
+          devtools.send_cmd('Console.disable')
+          devtools.send_cmd('Runtime.disable')
+          * End of DevTools Examples
+          ********************************************************
+
+          browser_obj1 = #{self}.linkout(
+            browser_obj: 'required - browser_obj returned from #open method)'
+          )
+
+          #{self}.type_as_human(
+            string: 'required - string to type as human',
+            rand_sleep_float: 'optional - float timing in between keypress (defaults to 0.09)'
+          ) {|char| browser_obj1.text_field(name: \"search\").send_keys(char) }
+
+          browser_obj1 = #{self}.close(
+            browser_obj: 'required - browser_obj returned from #open method)'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end