pwn 0.5.184 → 0.5.185

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9503d9d61acf12e65e98a43f39a436e7b8ee536b366e8e41a30ab549a4b3cf68
-  data.tar.gz: 348b098b00fc505b4ad1e02ab90c29b1e30ecfcd6f45ee36ccf8a3907933b774
+  metadata.gz: dbfe23aedfd50bf00cce67e7eff4b1d29d8dc3cf6e4bcfcad8c83c71ee4e5362
+  data.tar.gz: 397c808f4509652f528c9ca350efe0ae62339556eec55cb2790351b041ceaec6
 SHA512:
-  metadata.gz: 7488056e30f9e6ca9b14501cad819da3e429ae9b403c663182350e662717822bb2f00e3480b571acac5fcacf5438b5e72b1dc0e6054b455c0b49c3fa68f3c647
-  data.tar.gz: 2b35e01ca7cd9839a6e49aae4addcc1073027d93d0ded6ad73eaaa80a221c1d25f6b0cbad393b81fcdddaf9cf35153a7db73cf13b9ff1f2d5f1ac7008034cb2b
+  metadata.gz: f45f0ece9a3b81bf0866d1d9edd544a079bfb9dc823be5b6d9e9b5f57de8a1a4c70166a550bd808bfe17ac4c6bb27e0369641f0f162f5f74a9cb450a38dddc70
+  data.tar.gz: b55dad06ecdbd6a8c2ae7cd911dc81a61b6f92f2f36c8f6d4f583d9da7ea7c768bdb497d6368c7a6bf18faae3bf745c7632a137f7f94fe435f05978dbbfd2282

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.184]:001 >>> PWN.help
+pwn[v0.5.185]: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.3.3@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.184]:001 >>> PWN.help
+pwn[v0.5.185]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.3.3@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.184]:001 >>> PWN.help
+pwn[v0.5.185]:001 >>> PWN.help
 ```
 
 PWN periodically upgrades to the latest version of Ruby which is reflected in `/opt/pwn/.ruby-version`.  The easiest way to upgrade to the latest version of Ruby from a previous PWN installation is to run the following script:

data/lib/pwn/plugins/transparent_browser.rb

@@ -452,12 +452,12 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # browser_obj1 = PWN::Plugins::TransparentBrowser.switch_tab(
+      # tab = PWN::Plugins::TransparentBrowser.jmp_tab(
       #   browser_obj: 'required - browser_obj returned from #open method)',
       #   keyword: 'required - keyword in title or url used to switch tabs'
       # )
 
-      public_class_method def self.switch_tab(opts = {})
+      public_class_method def self.jmp_tab(opts = {})
         browser_obj = opts[:browser_obj]
         verify_devtools_browser(browser_obj: browser_obj)
 
@@ -473,7 +473,7 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # browser_obj1 = PWN::Plugins::TransparentBrowser.new_tab(
+      # tab = PWN::Plugins::TransparentBrowser.new_tab(
       #   browser_obj: 'required - browser_obj returned from #open method)',
       #   url: 'optional - URL to navigate to after opening new tab (Defaults to nil)'
       # )
@@ -484,12 +484,16 @@ module PWN
 
         url = opts[:url]
 
+        firefox_types = %i[firefox headless_firefox]
         browser = browser_obj[:browser]
+        browser_type = browser_obj[:type]
         browser.execute_script('window.open()')
-        switch_tab(browser_obj: browser_obj, keyword: 'about:blank')
+        jmp_tab(browser_obj: browser_obj, keyword: 'about:blank')
         browser.goto('about:about') if url.nil?
         rand_tab = SecureRandom.hex(8)
         browser.execute_script("document.title = '#{rand_tab}'")
+        # Open the DevTools for Firefox, Chrome opens them automatically
+        browser.body.send_keys(:f12) if firefox_types.include?(browser_type)
         browser.goto(url) unless url.nil?
 
         { title: browser.title, url: browser.url, state: :active }
@@ -498,7 +502,7 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # browser_obj1 = PWN::Plugins::TransparentBrowser.close_tab(
+      # tab = PWN::Plugins::TransparentBrowser.close_tab(
       #   browser_obj: 'required - browser_obj returned from #open method)'
       #   keyword: 'required - keyword in title or url used to close tabs'
       # )
@@ -519,7 +523,7 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # browser_obj1 = PWN::Plugins::TransparentBrowser.debugger(
+      # PWN::Plugins::TransparentBrowser.debugger(
       #   browser_obj: 'required - browser_obj returned from #open method)',
       #   action: 'optional - action to take :pause|:resume (Defaults to :pause)',
       #   url: 'optional - URL to navigate to after pausing debugger (Defaults to nil)'
@@ -573,7 +577,7 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # browser_obj1 = PWN::Plugins::TransparentBrowser.step_into(
+      # PWN::Plugins::TransparentBrowser.step_into(
       #   browser_obj: 'required - browser_obj returned from #open method)'
       # )
 
@@ -589,7 +593,7 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # browser_obj1 = PWN::Plugins::TransparentBrowser.step_out(
+      # PWN::Plugins::TransparentBrowser.step_out(
       #   browser_obj: 'required - browser_obj returned from #open method)'
       # )
 
@@ -605,7 +609,7 @@ module PWN
       end
 
       # Supported Method Parameters::
-      # browser_obj1 = PWN::Plugins::TransparentBrowser.step_over(
+      # PWN::Plugins::TransparentBrowser.step_over(
       #   browser_obj: 'required - browser_obj returned from #open method)'
       # )
 
@@ -620,6 +624,65 @@ module PWN
         raise e
       end
 
+      # Supported Method Parameters::
+      # PWN::Plugins::TransparentBrowser.toggle_devtools(
+      #   browser_obj: 'required - browser_obj returned from #open method)'
+      # )
+
+      public_class_method def self.toggle_devtools(opts = {})
+        browser_obj = opts[:browser_obj]
+        verify_devtools_browser(browser_obj: browser_obj)
+
+        browser = browser_obj[:browser]
+        browser.body.send_keys(:f12)
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::TransparentBrowser.jmp_devtools_panel(
+      #   browser_obj: 'required - browser_obj returned from #open method)',
+      #   panel: 'optional - panel to switch to :elements|:inspector|:console|:debugger|:sources|:network
+      # )
+
+      public_class_method def self.jmp_devtools_panel(opts = {})
+        browser_obj = opts[:browser_obj]
+        verify_devtools_browser(browser_obj: browser_obj)
+
+        panel = opts[:panel] ||= :elements
+        browser = browser_obj[:browser]
+        browser_type = browser_obj[:type]
+        firefox_types = %i[firefox headless_firefox]
+        chrome_types = %i[chrome headless_chrome]
+
+        case PWN::Plugins::DetectOS.type
+        when :linux, :openbsd, :windows
+          hotkey = %i[control shift]
+        when :macos
+          hotkey = %i[command option]
+        end
+
+        case panel
+        when :elements, :inspector
+          hotkey.push('c') if firefox_types.include?(browser_type)
+        when :console
+          hotkey.push('j') if chrome_types.include?(browser_type)
+          hotkey.push('k') if firefox_types.include?(browser_type)
+        when :debugger, :sources
+          hotkey.push('z') if firefox_types.include?(browser_type)
+        when :network
+          hotkey.push('e') if firefox_types.include?(browser_type)
+        else
+          raise 'ERROR: panel parameter must be :elements|:inspector|:console|:debugger|:sources|:network'
+        end
+
+        # Have to call twice for Chrome, otherwise devtools stays closed
+        browser.body.send_keys(hotkey)
+        browser.body.send_keys(hotkey) if chrome_types.include?(browser_type)
+      rescue StandardError => e
+        raise e
+      end
+
       # Supported Method Parameters::
       # browser_obj1 = PWN::Plugins::TransparentBrowser.close(
       #   browser_obj: 'required - browser_obj returned from #open method)'
@@ -768,38 +831,47 @@ module PWN
             browser_obj: 'required - browser_obj returned from #open method)'
           )
 
-          browser_obj1 = #{self}.switch_tab(
+          tab = #{self}.jmp_tab(
             browser_obj: 'required - browser_obj returned from #open method)',
             keyword: 'required - keyword in title or url used to switch tabs'
           )
 
-          browser_obj1 = #{self}.new_tab(
+          tab = #{self}.new_tab(
             browser_obj: 'required - browser_obj returned from #open method)'
           )
 
-          browser_obj1 = #{self}.close_tab(
+          tab = #{self}.close_tab(
             browser_obj: 'required - browser_obj returned from #open method)',
             keyword: 'required - keyword in title or url used to close tabs'
           )
 
-          browser_obj1 = #{self}.debugger(
+          #{self}.debugger(
             browser_obj: 'required - browser_obj returned from #open method)',
             action: 'optional - action to take :pause|:resume (Defaults to :pause)',
             url: 'optional - URL to navigate to after pausing debugger (Defaults to nil)'
           )
 
-          browser_obj1 = #{self}.step_into(
+          #{self}.step_into(
             browser_obj: 'required - browser_obj returned from #open method)'
           )
 
-          browser_obj1 = #{self}.step_out(
+          #{self}.step_out(
             browser_obj: 'required - browser_obj returned from #open method)'
           )
 
-          browser_obj1 = #{self}.step_over(
+          #{self}.step_over(
             browser_obj: 'required - browser_obj returned from #open method)'
           )
 
+          #{self}.toggle_devtools(
+            browser_obj: 'required - browser_obj returned from #open method)'
+          )
+
+          #{self}.jmp_devtools_panel(
+            browser_obj: 'required - browser_obj returned from #open method)',
+            panel: 'optional - panel to switch to :elements|:inspector|:console|:debugger|:sources|:network'
+          )
+
           browser_obj1 = #{self}.close(
             browser_obj: 'required - browser_obj returned from #open method)'
           )

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.184'
+  VERSION = '0.5.185'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.184
+  version: 0.5.185
 platform: ruby
 authors:
 - 0day Inc.