pwn 0.5.184 → 0.5.186

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9503d9d61acf12e65e98a43f39a436e7b8ee536b366e8e41a30ab549a4b3cf68
-  data.tar.gz: 348b098b00fc505b4ad1e02ab90c29b1e30ecfcd6f45ee36ccf8a3907933b774
+  metadata.gz: 2ff25e4be2c1f9ef0475858c8d712b2fed42595a90c64f607172d6c53ef2d3ca
+  data.tar.gz: 320d9f7ababc3d72a10568f8ccf88dcc53408202fedd859e1d633f9f552d16d9
 SHA512:
-  metadata.gz: 7488056e30f9e6ca9b14501cad819da3e429ae9b403c663182350e662717822bb2f00e3480b571acac5fcacf5438b5e72b1dc0e6054b455c0b49c3fa68f3c647
-  data.tar.gz: 2b35e01ca7cd9839a6e49aae4addcc1073027d93d0ded6ad73eaaa80a221c1d25f6b0cbad393b81fcdddaf9cf35153a7db73cf13b9ff1f2d5f1ac7008034cb2b
+  metadata.gz: 3e09bf1806d28938bfd208a1188db648e2b2501d00d23292e4471351576d3538f63b576b16bea919d14dfddc6cb73f4a1d25192b196caf191656db13e78af832
+  data.tar.gz: be94d3161a65b1c9b5c04885a95971384c32d341c38feec4f414c18e96af1146ddd473c2301dfd9f51e671881f09c9695f4e81c8455f2ea0066ee44be6357a9a

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.186]: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.186]: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.186]: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

@@ -307,6 +307,8 @@ module PWN
             end
 
             browser_obj[:bidi] = driver.bidi
+
+            browser_obj[:browser].body.send_keys(:escape)
           end
         end
 
@@ -452,12 +454,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 +475,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 +486,19 @@ module PWN
 
         url = opts[:url]
 
+        firefox_types = %i[firefox headless_firefox]
         browser = browser_obj[:browser]
+        browser_type = browser_obj[:type]
+        devtools = browser_obj[:devtools]
         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)
+        # Open Console drawer if DevTools are open
+        browser.body.send_keys(:escape) if devtools
         browser.goto(url) unless url.nil?
 
         { title: browser.title, url: browser.url, state: :active }
@@ -498,7 +507,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 +528,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 +582,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 +598,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 +614,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 +629,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 +836,48 @@ 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(
-            browser_obj: 'required - browser_obj returned from #open method)'
+          tab = #{self}.new_tab(
+            browser_obj: 'required - browser_obj returned from #open method)',
+            url: 'optional - URL to navigate to after opening new tab (Defaults to nil)'
           )
 
-          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)'
+          )
+
+          #{self}.step_out(
             browser_obj: 'required - browser_obj returned from #open method)'
           )
 
-          browser_obj1 = #{self}.step_out(
+          #{self}.step_over(
             browser_obj: 'required - browser_obj returned from #open method)'
           )
 
-          browser_obj1 = #{self}.step_over(
+          #{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.186'
 end

metadata

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