pwn 0.4.666 → 0.4.668

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 668626b1a3332cf0b09f04a683d7b79462724328afd3535a3d47652b120aca93
-  data.tar.gz: 921a004b8a3bcf11031589da46b45b3e347f3cd6a7fe33854adaf3f61f2cf9ef
+  metadata.gz: 81bb385ebabab222a3d4da59c7eda736aaac086600e3c9710d6680428e05c023
+  data.tar.gz: 3227d1e76969e9b89ed2b5ce7090f8f2407288f89aa157b2af33dd4138855e38
 SHA512:
-  metadata.gz: 9e1b117de7f4eceaf24145de0f8923394fb225356a7b79bd6024548476ba3770aa829c9cb65830a5eda93f280b79acbb6ecaf75178262ec9b6c2790ea34f37c0
-  data.tar.gz: 03de28428d438c9394ca0254ca7f5093e5c8e6b23d4f217edb8fdc88edaa33dc0e7be5d643c2282e6d13f2a95e834e1809cb10d6530ae68658ed0b0cf285b692
+  metadata.gz: 262b94064b575f5200f500c4ea41e42bde4050d82f95ce8675ea3166c2ee4370126bcdb7222b3e261496e283dd04d85b80b040d939587817a8606f6e3be15559
+  data.tar.gz: c2cfd0bc37664e45aca472b1f4682962ad675262fc39363e6830caf05ffaf2e34b27795efdf7b7395cd383e6edd5bcb9a19518162aa7a5de87337335dce83043

data/Gemfile

@@ -72,7 +72,7 @@ gem 'ruby-nmap', '1.0.1'
 gem 'ruby-saml', '1.15.0'
 gem 'rvm', '1.11.3.9'
 gem 'savon', '2.14.0'
-gem 'selenium-devtools', '0.112.0'
+gem 'selenium-devtools', '0.113.0'
 gem 'serialport', '1.3.2'
 gem 'sinatra', '3.0.6'
 gem 'slack-ruby-client', '2.1.0'

data/README.md

@@ -37,7 +37,7 @@ $ rvm use ruby-3.2.2@pwn
 $ rvm list gemsets
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.4.666]:001 >>> PWN.help
+pwn[v0.4.668]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.2.2@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.4.666]:001 >>> PWN.help
+pwn[v0.4.668]:001 >>> PWN.help
 ```
 
 

data/bin/pwn

@@ -297,6 +297,5 @@ begin
     prompt: prompt
   )
 rescue StandardError => e
-  puts 1111 if Pry.config.chat_gpt
   raise e
 end

data/bin/pwn_diff_csv_files_w_column_exclude

@@ -43,15 +43,33 @@ if opts.empty?
 end
 
 def csv_diff(opts = {})
-  larger_csv = opts[:larger_csv]
-  smaller_csv = opts[:smaller_csv]
+  c1_path = opts[:c1_path]
+  c2_path = opts[:c2_path]
   diff_path = opts[:diff_path]
-  include_csv_headers = opts[:include_csv_headers]
-  column_names_to_exclude = opts[:column_names_to_exclude]
+  no_headers = opts[:no_headers]
+  column_names_to_exclude = opts[:column_names_to_exclude].to_s.split(',')
 
-  # TODO: Exclude the column values for diff consideration
-  # while including the columns in the diff...figure out what
-  # to do with the columns' values.
+  csv1 = CSV.read(c1_path)
+  csv2 = CSV.read(c2_path)
+
+  if csv1.length >= csv2.length
+    larger_csv = csv1
+    larger_csv_orig = CSV.read(c1_path)
+
+    smaller_csv = csv2
+    smaller_csv_orig = CSV.read(c2_path)
+  end
+
+  if csv2.length >= csv1.length
+    larger_csv = csv2
+    larger_csv_orig = CSV.read(c2_path)
+
+    smaller_csv = csv1
+    smaller_csv_orig = CSV.read(c1_path)
+  end
+
+  # Exclude the column values for diff to ensure the same rows
+  # with for example different timestamps aren't included.
   columns_index_arr = []
   column_names_to_exclude&.each do |column_name|
     column_index = smaller_csv.first.find_index(column_name)
@@ -72,44 +90,46 @@ def csv_diff(opts = {})
     end
   end
 
-  csv_headers = larger_csv.first.join(',')
+  # Write diff with redacted columns (to find differences we care about)
   File.open(diff_path, 'w') do |f|
-    f.puts csv_headers if include_csv_headers
     larger_csv.each do |line_arr|
       line = line_arr.join(',')
       f.puts line unless smaller_csv.include?(line_arr)
     end
   end
+  diff_csv = CSV.read(diff_path)
+
+  # Write diff again with all columns.
+  csv_headers_orig = larger_csv_orig.first.join(',')
+  File.open(diff_path, 'w') do |f|
+    if no_headers
+      larger_csv_orig.each do |line_arr|
+        line = line_arr.join(',')
+        f.puts line if diff_csv.include?(line_arr)
+      end
+    else
+      f.puts csv_headers_orig
+      larger_csv_orig(1..-1).each do |line_arr|
+        line = line_arr.join(',')
+        f.puts line if diff_csv.include?(line_arr)
+      end
+    end
+  end
 end
 
 c1_path = opts[:c1_path]
-csv1 = CSV.read(c1_path)
-
 c2_path = opts[:c2_path]
-csv2 = CSV.read(c2_path)
-
 diff_path = opts[:diff_path]
+column_names_to_exclude = opts[:column_names_to_exclude]
 
-column_names_to_exclude = opts[:column_names_to_exclude].to_s.split(',')
-
-include_csv_headers = false if opts[:no_headers]
-include_csv_headers ||= true
+no_headers = true if opts[:no_headers]
+no_headers ||= false
 
 # Compare which two is larger
-if csv1.length >= csv2.length
-  csv_diff(
-    larger_csv: csv1,
-    smaller_csv: csv2,
-    diff_path: diff_path,
-    include_csv_headers: include_csv_headers,
-    column_names_to_exclude: column_names_to_exclude
-  )
-else
-  csv_diff(
-    larger_csv: csv2,
-    smaller_csv: csv1,
-    diff_path: diff_path,
-    include_csv_headers: include_csv_headers,
-    column_names_to_exclude: column_names_to_exclude
-  )
-end
+csv_diff(
+  c1_path: c1_path,
+  c2_path: c2_path,
+  diff_path: diff_path,
+  no_headers: no_headers,
+  column_names_to_exclude: column_names_to_exclude
+)

data/bin/pwn_domain_reversewhois

@@ -20,13 +20,9 @@ OptionParser.new do |options|
     opts[:output_results] = o
   end
 
-  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy>') do |p|
+  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy || :tor>') do |p|
     opts[:proxy] = p
   end
-
-  options.on('-T', '--[no-]with-tor', '<Optional - Proxy w/ TOR (Defaults to false)>') do |w|
-    opts[:with_tor] = w
-  end
 end.parse!
 
 if opts.empty?
@@ -37,13 +33,13 @@ end
 registrant_filter = opts[:registrant_filter].to_s.strip.chomp.scrub
 output_results = opts[:output_results].to_s.strip.chomp.scrub
 proxy = opts[:proxy].to_s.scrub.strip.chomp unless opts[:proxy].nil?
-with_tor = opts[:with_tor]
 
 begin
-  if proxy != '' && with_tor
-    browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: :headless, proxy: proxy, with_tor: true)
-  elsif proxy != '' && with_tor.nil?
-    browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: :headless, proxy: proxy)
+  if proxy
+    browser_obj = PWN::Plugins::TransparentBrowser.open(
+      browser_type: :headless,
+      proxy: proxy
+    )
   else
     browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: :headless)
   end

data/bin/pwn_nessus_cloud_vulnscan

@@ -77,12 +77,10 @@ begin
     )
 
     scan_status = scan_status_resp[:status]
-    # break if scan_status != 'initializing' && scan_status != 'pending' && scan_status != 'running' && scan_status != 'publishing'
+
     break if scan_status == 'completed'
   end
 
-  # raise "Scan status reached an unexpected condition: #{scan_status}.  Re-verify the scan config for, '#{scan_name}' and try again." unless scan_status == 'completed'
-
   puts 'scan complete.'
 
   print "Exporting results to #{path_to_export}..."

data/bin/pwn_pastebin_sample_filter

@@ -14,13 +14,9 @@ OptionParser.new do |options|
     opts[:regex] = r
   end
 
-  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy>') do |p|
+  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy || :tor>') do |p|
     opts[:proxy] = p
   end
-
-  options.on('-T', '--[no-]with-tor', '<Optional - Proxy w/ TOR (Defaults to false)>') do |w|
-    opts[:with_tor] = w
-  end
 end.parse!
 
 if opts.empty?
@@ -29,13 +25,11 @@ if opts.empty?
 end
 
 proxy = opts[:proxy]
-with_tor = opts[:with_tor]
 regex = opts[:regex]
 
 browser_obj = PWN::WWW::Pastebin.open(
   browser_type: :headless,
-  proxy: proxy,
-  with_tor: with_tor
+  proxy: proxy
 )
 
 begin

data/bin/pwn_web_cache_deception

@@ -38,13 +38,9 @@ OptionParser.new do |options|
     opts[:mfa] = f
   end
 
-  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy>') do |p|
+  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy || :tor>') do |p|
     opts[:proxy] = p
   end
-
-  options.on('-T', '--[no-]with-tor', '<Optional - Proxy w/ TOR (Defaults to false)>') do |w|
-    opts[:with_tor] = w
-  end
 end.parse!
 
 if opts.empty?
@@ -88,7 +84,6 @@ else
 end
 
 proxy = opts[:proxy].to_s.scrub.strip.chomp unless opts[:proxy].nil?
-with_tor = opts[:with_tor]
 
 begin
   def get_web_cache_deception(opts = {})
@@ -157,18 +152,10 @@ begin
 
     puts "#{@green}Leveraging PWN::WWW::#{pwn_www_mod_str} to Obtain a Post AuhN State...#{@end_of_color}"
     if proxy
-      if with_tor
-        browser_obj = pwn_www_mod.open(
-          browser_type: :chrome,
-          proxy: proxy,
-          with_tor: true
-        )
-      else
-        browser_obj = pwn_www_mod.open(
-          browser_type: :chrome,
-          proxy: proxy
-        )
-      end
+      browser_obj = pwn_www_mod.open(
+        browser_type: :chrome,
+        proxy: proxy
+      )
     else
       browser_obj = pwn_www_mod.open(browser_type: :chrome)
     end
@@ -181,18 +168,10 @@ begin
     )
     puts "#{@green}complete.#{@end_of_color}\n\n\n"
   elsif pwn_www_mod_str == '' && proxy
-    if with_tor
-      browser_obj = PWN::Plugins::TransparentBrowser.open(
-        browser_type: :chrome,
-        proxy: proxy,
-        with_tor: true
-      )
-    else
-      browser_obj = PWN::Plugins::TransparentBrowser.open(
-        browser_type: :chrome,
-        proxy: proxy
-      )
-    end
+    browser_obj = PWN::Plugins::TransparentBrowser.open(
+      browser_type: :chrome,
+      proxy: proxy
+    )
   else
     browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: :chrome)
   end

data/bin/pwn_www_checkip

@@ -10,28 +10,24 @@ OptionParser.new do |options|
     #{$PROGRAM_NAME} [opts]
   "
 
-  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy>') do |p|
+  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy || :tor>') do |p|
     opts[:proxy] = p
   end
 
-  options.on('-T', '--[no-]with-tor', '<Optional - Proxy w/ TOR (Defaults to false)>') do |w|
-    opts[:with_tor] = w
-  end
-
   options.on('-i', '--[no-]ipinfo', '<Optional - Return Details about Public IP Returned from CheckIP>') do |i|
     opts[:ipinfo] = i
   end
 end.parse!
 
 proxy = opts[:proxy].to_s.scrub.strip.chomp unless opts[:proxy].nil?
-with_tor = opts[:with_tor]
 ipinfo = opts[:ipinfo]
 
 begin
-  if proxy != '' && with_tor
-    browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: :rest, proxy: proxy, with_tor: true)::Request
-  elsif proxy != '' && with_tor.nil?
-    browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: :rest, proxy: proxy)::Request
+  if proxy
+    browser_obj = PWN::Plugins::TransparentBrowser.open(
+      browser_type: :rest,
+      proxy: proxy
+    )::Request
   else
     browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: :rest)::Request
   end

data/bin/pwn_xss_dom_vectors

@@ -26,14 +26,10 @@ OptionParser.new do |options|
     opts[:browser_type] = b
   end
 
-  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy>') do |p|
+  options.on('-pPROXY', '--proxy=PROXY', '<Optional - HTTP or Socks Proxy || :tor>') do |p|
     opts[:proxy] = p
   end
 
-  options.on('-T', '--[no-]with-tor', '<Optional - Proxy w/ TOR (Defaults to false)>') do |w|
-    opts[:with_tor] = w
-  end
-
   options.on('-S', '--[no-]spider-fqdn', '<Optional - Spider Target FQDN>') do |s|
     opts[:spider] = s
   end
@@ -56,7 +52,6 @@ else
 end
 
 proxy = opts[:proxy].to_s.scrub.strip.chomp unless opts[:proxy].nil?
-with_tor = opts[:with_tor]
 
 if opts[:spider]
   spider = true
@@ -109,18 +104,10 @@ begin
   end
 
   if proxy
-    if with_tor
-      browser_obj = PWN::Plugins::TransparentBrowser.open(
-        browser_type: browser_type,
-        proxy: proxy,
-        with_tor: true
-      )
-    else
-      browser_obj = PWN::Plugins::TransparentBrowser.open(
-        browser_type: browser_type,
-        proxy: proxy
-      )
-    end
+    browser_obj = PWN::Plugins::TransparentBrowser.open(
+      browser_type: browser_type,
+      proxy: proxy
+    )
   else
     browser_obj = PWN::Plugins::TransparentBrowser.open(browser_type: browser_type)
   end

data/lib/pwn/plugins/nessus_cloud.rb

@@ -80,9 +80,10 @@ module PWN
 
         response
       rescue RestClient::ExceptionWithResponse => e
-        puts "#{base_nessus_cloud_api_uri}/#{rest_call}"
-        puts params
-        puts http_body
+        puts "URI: #{base_nessus_cloud_api_uri}/#{rest_call}"
+        puts "Params: #{params.inspect}"
+        puts "HTTP POST Body: #{http_body}"
+
         raise e
       rescue StandardError, SystemExit, Interrupt => e
         raise e

data/lib/pwn/plugins/owasp_zap.rb

@@ -71,7 +71,7 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # PWN::Plugins::OwaspZap.start(
+      # zap_obj = PWN::Plugins::OwaspZap.start(
       #   api_key: 'required - api key for API authorization',
       #   zap_bin_path: 'optional - path to zap.sh file'
       #   headless: 'optional - run zap headless if set to true',
@@ -467,17 +467,12 @@ module PWN
 
       # Supported Method Parameters::
       # PWN::Plugins::OwaspZap.stop(
-      #   :zap_obj => 'required - zap_obj returned from #open method'
+      #   :zap_obj => 'required - zap_obj returned from #start method'
       # )
 
       public_class_method def self.stop(opts = {})
         zap_obj = opts[:zap_obj]
-        unless zap_obj.nil?
-          pid = zap_obj[:pid]
-          # File.unlink(zap_obj[:stdout_log]) if File.exist?(zap_obj[:stdout_log])
-
-          Process.kill('TERM', pid)
-        end
+        Process.kill('TERM', zab_obj[:pid]) unless zap_obj.nil?
       rescue StandardError => e
         raise e
       end
@@ -538,7 +533,7 @@ module PWN
           )
 
           #{self}.stop(
-            zap_obj: 'required - zap_obj returned from #open method'
+            zap_obj: 'required - zap_obj returned from #start method'
           )
 
           #{self}.authors

data/lib/pwn/plugins/tor.rb

@@ -0,0 +1,221 @@
+# frozen_string_literal: true
+
+require 'pty'
+
+module PWN
+  module Plugins
+    # This plugin processes images into readable text
+    module Tor
+      # Supported Method Parameters::
+      # tor_ctrl_cmd(
+      #   tor_obj: 'required - tor_obj returned from #start method'
+      #   cmd: 'required - Tor control command to execute',
+      #   response_timeout: 'optional - float in seconds to timeout (default: 3.0)'
+      # )
+
+      private_class_method def self.tor_control_cmd(opts = {})
+        tor_obj = opts[:tor_obj]
+        cmd = opts[:cmd]
+        response_timeout = opts[:response_timeout]
+        response_timeout ||= 3.0
+
+        ctrl_ip = tor_obj[:ip]
+        ctrl_port = tor_obj[:ctrl_port]
+        cookie_authn = tor_obj[:cookie_authn]
+
+        sock_obj = PWN::Plugins::Sock.connect(
+          target: ctrl_ip,
+          port: ctrl_port
+        )
+
+        cmd_hist_arr = []
+        cmd_hash = { cmd: "AUTHENTICATE #{cookie_authn}\r\n" }
+        sock_obj.write(cmd_hash[:cmd])
+        does_respond = sock_obj.wait_readable(response_timeout)
+        if does_respond
+          response = sock_obj.readline.chomp
+          cmd_hash[:resp] = response
+          cmd_hist_arr.push(cmd_hash)
+          if response == '250 OK'
+            cmd_hash = { cmd: "#{cmd}\r\n" }
+            sock_obj.write(cmd_hash[:cmd])
+            does_respond = sock_obj.wait_readable(response_timeout)
+            if does_respond
+              response = sock_obj.readline.chomp
+              cmd_hash[:resp] = response
+              cmd_hist_arr.push(cmd_hash)
+              if response == '250 OK'
+                cmd_hash = { cmd: "QUIT\r\n" }
+                sock_obj.write(cmd_hash[:cmd])
+                does_respond = sock_obj.wait_readable(response_timeout)
+                if does_respond
+                  response = sock_obj.readline.chomp
+                else
+                  response = '900 NO CMD RESPONSE'
+                end
+              end
+            else
+              response = '900 NO CMD RESPONSE'
+            end
+            cmd_hash[:resp] = response
+            cmd_hist_arr.push(cmd_hash)
+          end
+        else
+          response = '700 NO AUTHENTICATE RESPONSE'
+          cmd_hash[:resp] = response
+          cmd_hist_arr.push(cmd_hash)
+        end
+        sock_obj = PWN::Plugins::Sock.disconnect(sock_obj: sock_obj)
+
+        cmd_hist_arr
+      rescue StandardError => e
+        stop(tor_obj: tor_obj)
+      end
+
+      # Supported Method Parameters::
+      # tor_obj = PWN::Plugins::Tor.start(
+      #   ip: 'optional - IP address to listen (default: 127.0.0.1)',
+      #   port: 'optional - socks port to listen (default: 1024-65535)',
+      #   ctrl_port: 'optional - tor control port to listen (default: 1024-65535)',
+      #   data_dir: 'optional - directory to keep tor session data (default: /tmp/tor_pwn-TIMESTAMP)'
+      # )
+
+      public_class_method def self.start(opts = {})
+        ip = opts[:ip]
+        ip ||= '127.0.0.1'
+        port = opts[:port].to_i
+        port = PWN::Plugins::Sock.get_random_unused_port if port.zero?
+        ctrl_port = opts[:ctrl_port].to_i
+        if ctrl_port.zero?
+          loop do
+            ctrl_port = PWN::Plugins::Sock.get_random_unused_port
+            break if ctrl_port != port
+          end
+        end
+        timestamp = Time.now.strftime('%Y-%m-%d_%H-%M-%S.%N%z')
+        data_dir = opts[:data_dir]
+        data_dir ||= "/tmp/tor_pwn-#{timestamp}"
+        FileUtils.mkdir_p(data_dir)
+
+        socks_proxy = "#{ip}:#{port}"
+        pid_file = "#{data_dir}/tor.pid"
+        cookie_authn_file = "#{data_dir}/control_auth_cookie"
+        session_log_path = "#{data_dir}/stdout-session.log"
+        session_log = File.new(session_log_path, 'w')
+        session_log.sync = true
+        session_log.fsync
+
+        fork_pid = Process.fork do
+          pty = PTY.spawn(
+            'tor',
+            'DataDirectory',
+            data_dir,
+            'SocksPort',
+            socks_proxy,
+            'ControlPort',
+            ctrl_port.to_s,
+            'CookieAuthentication',
+            '1'
+          ) do |stdout, _stdin, pid|
+            File.write(pid_file, pid)
+            stdout.each do |line|
+              session_log.puts line
+            end
+          end
+        rescue StandardError => e
+          puts 'Tor exiting with errors...'
+          FileUtils.rm_rf(data_dir)
+          raise e
+        end
+        Process.detach(fork_pid)
+
+        loop do
+          pid_ready = File.exist?(pid_file)
+          cookie_authn_ready = File.exist?(cookie_authn_file)
+          sleep 0.1
+          break if pid_ready && cookie_authn_ready
+        end
+
+        cookie_authn = `hexdump -e '32/1 "%02x"' #{cookie_authn_file}`
+        tor_obj = {
+          parent_pid: fork_pid,
+          child_pid: File.read(pid_file).to_i,
+          ip: ip,
+          port: port,
+          ctrl_port: ctrl_port,
+          data_dir: data_dir,
+          cookie_authn: cookie_authn
+        }
+      rescue StandardError, SystemExit => e
+        stop(tor_obj) unless tor_obj.nil?
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::Tor.switch_exit_node(
+      #   tor_obj: 'required - tor_obj returned from #start method',
+      #   response_timeout: 'optional - float in seconds to timeout (default: 3.0)'
+      # )
+
+      public_class_method def self.switch_exit_node(opts = {})
+        tor_obj = opts[:tor_obj]
+        response_timeout = opts[:response_timeout]
+        tor_control_cmd(
+          tor_obj: tor_obj,
+          cmd: 'SIGNAL NEWNYM',
+          response_timeout: response_timeout
+        )
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::Tor.stop(
+      #   tor_obj: 'required - tor_obj returned from #start method'
+      # )
+
+      public_class_method def self.stop(opts = {})
+        tor_obj = opts[:tor_obj]
+        unless tor_obj.nil?
+          FileUtils.rm_rf(tor_obj[:data_dir])
+          Process.kill('TERM', tor_obj[:child_pid])
+          Process.kill('TERM', tor_obj[:parent_pid])
+        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:
+          tor_obj = #{self}.start(
+            ip: 'optional - IP address to listen (default: 127.0.0.1)',
+            port: 'optional - socks port to listen (default: 9050)',
+            ctrl_port: 'optional - tor control port to listen (default: 9051)',
+            data_dir: 'optional - directory to keep tor session data (default: /tmp/tor_pwn-TIMESTAMP)'
+          )
+
+          #{self}.switch_exit_node(
+            tor_obj: 'required - tor_obj returned from #start method',
+            response_timeout: 'optional - float in seconds to timeout (default: 3.0)'
+          )
+
+          #{self}.stop(
+            tor_obj: 'required - tor_obj returned from #start method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end