dstruct 0.0.1

data/lib/rex/post/meterpreter/ui/console/command_dispatcher/espia.rb

@@ -0,0 +1,109 @@
+# -*- coding: binary -*-
+require 'rex/post/meterpreter'
+
+module Rex
+module Post
+module Meterpreter
+module Ui
+
+###
+#
+# Espia - Capture audio, video, screenshots from the remote system
+#
+###
+class Console::CommandDispatcher::Espia
+
+  Klass = Console::CommandDispatcher::Espia
+
+  include Console::CommandDispatcher
+
+  #
+  # Initializes an instance of the espia command interaction.
+  #
+  def initialize(shell)
+    super
+  end
+
+  #
+  # List of supported commands.
+  #
+  def commands
+    {
+  #		"dev_image"  => "Attempt to grab a frame from webcam",
+  #		"dev_audio"  => "Attempt to record microphone audio",
+      "screengrab" => "Attempt to grab screen shot from process's active desktop"
+    }
+  end
+
+  def cmd_dev_image()
+    client.espia.espia_video_get_dev_image()
+    print_line("[*] Done.")
+
+    return true
+  end
+
+  def cmd_dev_audio(*args)
+    maxrec = 60
+
+    if (args.length < 1)
+      print_line("Usage: dev_audio <rec_secs>\n")
+      print_line("Record mic audio\n")
+      return true
+    end
+
+    secs = args[0].to_i
+    if secs  > 0 and secs <= maxrec
+      milsecs = secs*1000
+      print_line("[*] Recording #{milsecs} miliseconds.\n")
+      client.espia.espia_audio_get_dev_audio(milsecs)
+      print_line("[*] Done.")
+    else
+      print_line("[-] Error: Recording time 0 to 60 secs \n")
+    end
+
+    return true
+  end
+
+  #
+  # Grab a screenshot of the current interactive desktop.
+  #
+  def cmd_screengrab( *args )
+    if( args[0] and args[0] == "-h" )
+      print_line("Usage: screengrab <path.jpeg> [view in browser: true|false]\n")
+      print_line("Grab a screenshot of the current interactive desktop.\n")
+      return true
+    end
+
+    show = true
+    show = false if (args[1] and args[1] =~ /^(f|n|0)/i)
+
+    path = args[0] || Rex::Text.rand_text_alpha(8) + ".jpeg"
+
+    data = client.espia.espia_image_get_dev_screen
+
+    if( data )
+      ::File.open( path, 'wb' ) do |fd|
+        fd.write( data )
+      end
+      path = ::File.expand_path( path )
+      print_line( "Screenshot saved to: #{path}" )
+      Rex::Compat.open_file( path ) if show
+    end
+
+    return true
+  end
+
+  #
+  # Name for this dispatcher
+  #
+  def name
+    "Espia"
+  end
+
+end
+
+end
+end
+end
+end
+

data/lib/rex/post/meterpreter/ui/console/command_dispatcher/extapi.rb

@@ -0,0 +1,65 @@
+# -*- coding: binary -*-
+require 'rex/post/meterpreter'
+
+module Rex
+module Post
+module Meterpreter
+module Ui
+
+###
+#
+# Extended API user interface.
+#
+###
+class Console::CommandDispatcher::Extapi
+
+  require 'rex/post/meterpreter/ui/console/command_dispatcher/extapi/window'
+  require 'rex/post/meterpreter/ui/console/command_dispatcher/extapi/service'
+  require 'rex/post/meterpreter/ui/console/command_dispatcher/extapi/clipboard'
+  require 'rex/post/meterpreter/ui/console/command_dispatcher/extapi/adsi'
+  require 'rex/post/meterpreter/ui/console/command_dispatcher/extapi/wmi'
+
+  Klass = Console::CommandDispatcher::Extapi
+
+  Dispatchers =
+    [
+      Klass::Window,
+      Klass::Service,
+      Klass::Clipboard,
+      Klass::Adsi,
+      Klass::Wmi
+    ]
+
+  include Console::CommandDispatcher
+
+  #
+  # Initializes an instance of the extended API command interaction.
+  #
+  def initialize(shell)
+    super
+
+    Dispatchers.each { |d| shell.enstack_dispatcher(d) }
+  end
+
+  #
+  #
+  # List of supported commands.
+  #
+  def commands
+    {
+    }
+  end
+
+  #
+  # Name for this dispatcher
+  #
+  def name
+    "Extended API Extension"
+  end
+
+end
+
+end
+end
+end
+end

data/lib/rex/post/meterpreter/ui/console/command_dispatcher/extapi/adsi.rb

@@ -0,0 +1,198 @@
+# -*- coding: binary -*-
+require 'rex/post/meterpreter'
+
+module Rex
+module Post
+module Meterpreter
+module Ui
+
+###
+#
+# Extended API ADSI management user interface.
+#
+###
+class Console::CommandDispatcher::Extapi::Adsi
+
+  Klass = Console::CommandDispatcher::Extapi::Adsi
+
+  include Console::CommandDispatcher
+
+  # Zero indicates "no limit"
+  DEFAULT_MAX_RESULTS = 0
+  DEFAULT_PAGE_SIZE   = 0
+
+  #
+  # List of supported commands.
+  #
+  def commands
+    {
+      "adsi_user_enum"     => "Enumerate all users on the specified domain.",
+      "adsi_computer_enum" => "Enumerate all computers on the specified domain.",
+      "adsi_domain_query"  => "Enumerate all objects on the specified domain that match a filter."
+    }
+  end
+
+  #
+  # Name for this dispatcher
+  #
+  def name
+    "Extapi: ADSI Management"
+  end
+
+  #
+  # Options for the adsi_user_enum command.
+  #
+  @@adsi_user_enum_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ],
+    "-m" => [ true, "Maximum results to return." ],
+    "-p" => [ true, "Result set page size." ]
+  )
+
+  def adsi_user_enum_usage
+    print(
+      "\nUsage: adsi_user_enum <domain> [-h] [-m maxresults] [-p pagesize]\n\n" +
+      "Enumerate the users on the target domain.\n\n" +
+      "Enumeration returns information such as the user name, SAM account name, locked\n" +
+      "status, desc, and comment.\n" +
+      @@adsi_user_enum_opts.usage)
+  end
+
+  #
+  # Enumerate domain users.
+  #
+  def cmd_adsi_user_enum(*args)
+    args.unshift("-h") if args.length == 0
+    if args.include?("-h")
+      adsi_user_enum_usage
+      return true
+    end
+
+    domain = args.shift
+    filter = "(objectClass=user)"
+    fields = [
+      "samaccountname",
+      "name",
+      "distinguishedname",
+      "description",
+      "comment"
+      ]
+    args = [domain, filter] + fields + args
+    return cmd_adsi_domain_query(*args)
+  end
+
+  #
+  # Options for the adsi_computer_enum command.
+  #
+  @@adsi_computer_enum_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ],
+    "-m" => [ true, "Maximum results to return." ],
+    "-p" => [ true, "Result set page size." ]
+  )
+
+  def adsi_computer_enum_usage
+    print(
+      "\nUsage: adsi_computer_enum <domain> [-h] [-m maxresults] [-p pagesize]\n\n" +
+      "Enumerate the computers on the target domain.\n\n" +
+      "Enumeration returns information such as the computer name, desc, and comment.\n" +
+      @@adsi_computer_enum_opts.usage)
+  end
+
+  #
+  # Enumerate domain computers.
+  #
+  def cmd_adsi_computer_enum(*args)
+    args.unshift("-h") if args.length == 0
+    if args.include?("-h")
+      adsi_computer_enum_usage
+      return true
+    end
+
+    domain = args.shift
+    filter = "(objectClass=computer)"
+    fields = [
+      "name",
+      "distinguishedname",
+      "description",
+      "comment"
+      ]
+    args = [domain, filter] + fields + args
+    return cmd_adsi_domain_query(*args)
+  end
+
+  #
+  # Options for the adsi_domain_query command.
+  #
+  @@adsi_domain_query_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ],
+    "-m" => [ true, "Maximum results to return." ],
+    "-p" => [ true, "Result set page size." ]
+  )
+
+  def adsi_domain_query_usage
+    print(
+      "\nUsage: adsi_domain_query <domain> <filter> <field 1> [field 2 [field ..]] [-h] [-m maxresults] [-p pagesize]\n\n" +
+      "Enumerate the objects on the target domain.\n\n" +
+      "Enumeration returns the set of fields that are specified.\n" +
+      @@adsi_domain_query_opts.usage)
+  end
+
+  #
+  # Enumerate domain objects.
+  #
+  def cmd_adsi_domain_query(*args)
+    page_size = DEFAULT_PAGE_SIZE
+    max_results = DEFAULT_MAX_RESULTS
+
+    args.unshift("-h") if args.length < 3
+
+    @@adsi_domain_query_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-p"
+        page_size = val.to_i
+      when "-m"
+        max_results = val.to_i
+      when "-h"
+        adsi_domain_query_usage
+        return true
+      end
+    }
+
+    # Assume that the flags are passed in at the end. Safe?
+    switch_index = args.index { |a| a.start_with?("-") }
+    if switch_index
+      args = args.first(switch_index)
+    end
+
+    domain = args.shift
+    filter = args.shift
+
+    objects = client.extapi.adsi.domain_query(domain, filter, max_results, page_size, args)
+
+    table = Rex::Ui::Text::Table.new(
+      'Header'    => "#{domain} Objects",
+      'Indent'    => 0,
+      'SortIndex' => 0,
+      'Columns'   => objects[:fields]
+    )
+
+    objects[:results].each do |c|
+      table << c
+    end
+
+    print_line
+    print_line(table.to_s)
+
+    print_line("Total objects: #{objects[:results].length}")
+
+    print_line
+
+    return true
+  end
+
+end
+
+end
+end
+end
+end
+

data/lib/rex/post/meterpreter/ui/console/command_dispatcher/extapi/clipboard.rb

@@ -0,0 +1,444 @@
+# -*- coding: binary -*-
+require 'rex/post/meterpreter'
+
+module Rex
+module Post
+module Meterpreter
+module Ui
+###
+#
+# Extended API window management user interface.
+#
+###
+class Console::CommandDispatcher::Extapi::Clipboard
+
+  Klass = Console::CommandDispatcher::Extapi::Clipboard
+
+  include Console::CommandDispatcher
+
+  #
+  # List of supported commands.
+  #
+  def commands
+    {
+      "clipboard_get_data"       => "Read the target's current clipboard (text, files, images)",
+      "clipboard_set_text"       => "Write text to the target's clipboard",
+      "clipboard_monitor_start"  => "Start the clipboard monitor",
+      "clipboard_monitor_pause"  => "Pause the active clipboard monitor",
+      "clipboard_monitor_resume" => "Resume the paused clipboard monitor",
+      "clipboard_monitor_dump"   => "Dump all captured clipboard content",
+      "clipboard_monitor_purge"  => "Delete all captured cilpboard content without dumping it",
+      "clipboard_monitor_stop"   => "Stop the clipboard monitor"
+    }
+  end
+
+  #
+  # Name for this dispatcher
+  #
+  def name
+    "Extapi: Clipboard Management"
+  end
+
+  #
+  # Options for the clipboard_get_data command.
+  #
+  @@get_data_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ],
+    "-d" => [ true, "Download non-text content to the specified folder (default: current dir)", nil ]
+  )
+
+  def print_clipboard_get_data_usage
+    print(
+      "\nUsage: clipboard_get_data [-h] [-d]\n\n" +
+      "Attempts to read the data from the target's clipboard. If the data is in a\n" +
+      "supported format, it is read and returned to the user.\n" +
+      @@get_data_opts.usage + "\n")
+  end
+
+  #
+  # Get the data from the target's clipboard
+  #
+  def cmd_clipboard_get_data(*args)
+    download_content = false
+    download_path = nil
+    @@get_data_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-d"
+        download_content = true
+        download_path = val
+      when "-h"
+        print_clipboard_get_data_usage
+        return true
+      end
+    }
+
+    dump = client.extapi.clipboard.get_data(download_content)
+
+    if dump.length == 0
+      print_error( "The current Clipboard data format is not supported." )
+      return false
+    end
+
+    parse_dump(dump, download_content, download_content, download_path)
+    return true
+  end
+
+  #
+  # Options for the clipboard_set_text command.
+  #
+  @@set_text_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ]
+  )
+
+  def print_clipboard_set_text_usage
+    print(
+      "\nUsage: clipboard_set_text [-h] <text>\n\n" +
+      "Set the target's clipboard to the given text value.\n\n")
+  end
+
+  #
+  # Set the clipboard data to the given text.
+  #
+  def cmd_clipboard_set_text(*args)
+    args.unshift "-h" if args.length == 0
+
+    @@set_text_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-h"
+        print_clipboard_set_text_usage
+        return true
+      end
+    }
+
+  return client.extapi.clipboard.set_text(args.join(" "))
+  end
+
+  #
+  # Options for the clipboard_monitor_start command.
+  #
+  @@monitor_start_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ],
+    "-i" => [ true, "Capture image content when monitoring (default: true)" ]
+  )
+
+  #
+  # Help for the clipboard_monitor_start command.
+  #
+  def print_clipboard_monitor_start_usage
+    print(
+      "\nUsage: clipboard_monitor_start [-i true|false] [-h]\n\n" +
+      "Starts a background clipboard monitoring thread. The thread watches\n" +
+      "the clipboard on the target, under the context of the current desktop, and when\n" +
+      "changes are detected the contents of the clipboard are captured. Contents can be\n" +
+      "dumped periodically. Image content can be captured as well (and will be by default)\n" +
+      "however this can consume quite a bit of memory.\n\n" +
+      @@monitor_start_opts.usage + "\n")
+  end
+
+  #
+  # Start the clipboard monitor.
+  #
+  def cmd_clipboard_monitor_start(*args)
+    capture_images = true
+
+    @@monitor_start_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-i"
+        # default this to true
+        capture_images = val.downcase != 'false'
+      when "-h"
+        print_clipboard_monitor_start_usage
+        return true
+      end
+    }
+
+    client.extapi.clipboard.monitor_start({
+      # random class and window name so that it isn't easy
+      # to track via a script
+      :wincls  => Rex::Text.rand_text_alpha(8),
+      :cap_img => capture_images
+    })
+
+    print_good("Clipboard monitor started")
+  end
+
+  #
+  # Options for the clipboard_monitor_purge command.
+  #
+  @@monitor_purge_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ]
+  )
+
+  #
+  # Help for the clipboard_monitor_purge command.
+  #
+  def print_clipboard_monitor_purge_usage
+    print("\nUsage: clipboard_monitor_purge [-h]\n\n" +
+      "Purge the captured contents from the monitor. This does not stop\n" +
+      "the monitor from running, it just removes captured content.\n\n" +
+      @@monitor_purge_opts.usage + "\n")
+  end
+
+  #
+  # Purge the clipboard monitor captured contents
+  #
+  def cmd_clipboard_monitor_purge(*args)
+    @@monitor_purge_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-h"
+        print_clipboard_monitor_purge_usage
+        return true
+      end
+    }
+    client.extapi.clipboard.monitor_purge
+    print_good("Captured clipboard contents purged successfully")
+  end
+
+  #
+  # Options for the clipboard_monitor_pause command.
+  #
+  @@monitor_pause_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ]
+  )
+
+  #
+  # Help for the clipboard_monitor_pause command.
+  #
+  def print_clipboard_monitor_pause_usage
+    print("\nUsage: clipboard_monitor_pause [-h]\n\n" +
+      "Pause the currently running clipboard monitor thread.\n\n" +
+      @@monitor_pause_opts.usage + "\n")
+  end
+
+  #
+  # Pause the clipboard monitor captured contents
+  #
+  def cmd_clipboard_monitor_pause(*args)
+    @@monitor_pause_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-h"
+        print_clipboard_monitor_pause_usage
+        return true
+      end
+    }
+    client.extapi.clipboard.monitor_pause
+    print_good("Clipboard monitor paused successfully")
+  end
+
+  #
+  # Options for the clipboard_monitor_resumse command.
+  #
+  @@monitor_resume_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ]
+  )
+
+  #
+  # Help for the clipboard_monitor_resume command.
+  #
+  def print_clipboard_monitor_resume_usage
+    print("\nUsage: clipboard_monitor_resume [-h]\n\n" +
+      "Resume the currently paused clipboard monitor thread.\n\n" +
+      @@monitor_resume_opts.usage + "\n")
+  end
+
+  #
+  # resume the clipboard monitor captured contents
+  #
+  def cmd_clipboard_monitor_resume(*args)
+    @@monitor_resume_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-h"
+        print_clipboard_monitor_resume_usage
+        return true
+      end
+    }
+    client.extapi.clipboard.monitor_resume
+    print_good("Clipboard monitor resumed successfully")
+  end
+
+  #
+  # Options for the clipboard_monitor_dump command.
+  #
+  @@monitor_dump_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ],
+    "-i" => [ true,  "Indicate if captured image data should be downloaded (default: true)" ],
+    "-f" => [ true,  "Indicate if captured file data should be downloaded (default: true)" ],
+    "-p" => [ true,  "Purge the contents of the monitor once dumped (default: true)" ],
+    "-d" => [ true,  "Download non-text content to the specified folder (default: current dir)" ]
+  )
+
+  #
+  # Help for the clipboard_monitor_dump command.
+  #
+  def print_clipboard_monitor_dump_usage
+    print(
+      "\nUsage: clipboard_monitor_dump [-d true|false] [-d downloaddir] [-h]\n\n" +
+      "Dump the capture clipboard contents to the local machine..\n\n" +
+      @@monitor_dump_opts.usage + "\n")
+  end
+
+  #
+  # Dump the clipboard monitor contents to the local machine.
+  #
+  def cmd_clipboard_monitor_dump(*args)
+    purge = true
+    download_images = true
+    download_files = true
+    download_path = nil
+
+    @@monitor_dump_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-d"
+        download_path = val
+      when "-i"
+        download_images = val.downcase != 'false'
+      when "-f"
+        download_files = val.downcase != 'false'
+      when "-p"
+        purge = val.downcase != 'false'
+      when "-h"
+        print_clipboard_monitor_dump_usage
+        return true
+      end
+    }
+
+    dump = client.extapi.clipboard.monitor_dump({
+      :include_images => download_images,
+      :purge          => purge
+    })
+
+    parse_dump(dump, download_images, download_files, download_path)
+
+    print_good("Clipboard monitor dumped")
+  end
+
+  #
+  # Options for the clipboard_monitor_stop command.
+  #
+  @@monitor_stop_opts = Rex::Parser::Arguments.new(
+    "-h" => [ false, "Help banner" ],
+    "-x" => [ true,  "Indicate if captured clipboard data should be dumped (default: true)" ],
+    "-i" => [ true,  "Indicate if captured image data should be downloaded (default: true)" ],
+    "-f" => [ true,  "Indicate if captured file data should be downloaded (default: true)" ],
+    "-d" => [ true,  "Download non-text content to the specified folder (default: current dir)" ]
+  )
+
+  #
+  # Help for the clipboard_monitor_stop command.
+  #
+  def print_clipboard_monitor_stop_usage
+    print(
+      "\nUsage: clipboard_monitor_stop [-d true|false] [-x true|false] [-d downloaddir] [-h]\n\n" +
+      "Stops a clipboard monitor thread and returns the captured data to the local machine.\n\n" +
+      @@monitor_stop_opts.usage + "\n")
+  end
+
+  #
+  # Stop the clipboard monitor.
+  #
+  def cmd_clipboard_monitor_stop(*args)
+    dump_data = true
+    download_images = true
+    download_files = true
+    download_path = nil
+
+    @@monitor_stop_opts.parse(args) { |opt, idx, val|
+      case opt
+      when "-d"
+        download_path = val
+      when "-x"
+        dump_data = val.downcase != 'false'
+      when "-i"
+        download_images = val.downcase != 'false'
+      when "-f"
+        download_files = val.downcase != 'false'
+      when "-h"
+        print_clipboard_monitor_stop_usage
+        return true
+      end
+    }
+
+    dump = client.extapi.clipboard.monitor_stop({
+      :dump           => dump_data,
+      :include_images => download_images
+    })
+
+    parse_dump(dump, download_images, download_files, download_path) if dump_data
+
+    print_good("Clipboard monitor stopped")
+  end
+
+private
+
+  def download_file( dest_folder, source )
+    stat = client.fs.file.stat( source )
+    base = ::Rex::Post::Meterpreter::Extensions::Stdapi::Fs::File.basename( source )
+    dest = File.join( dest_folder, base )
+
+    if stat.directory?
+      client.fs.dir.download( dest, source, true, true ) { |step, src, dst|
+        print_line( "#{step.ljust(11)} : #{src} -> #{dst}" )
+        client.framework.events.on_session_download( client, src, dest ) if msf_loaded?
+      }
+    elsif stat.file?
+      client.fs.file.download( dest, source ) { |step, src, dst|
+        print_line( "#{step.ljust(11)} : #{src} -> #{dst}" )
+        client.framework.events.on_session_download( client, src, dest ) if msf_loaded?
+      }
+    end
+  end
+
+  def parse_dump(dump, get_images, get_files, download_path)
+    loot_dir = download_path || "."
+    if (get_images || get_files) && !::File.directory?( loot_dir )
+      ::FileUtils.mkdir_p( loot_dir )
+    end
+
+    dump.each do |ts, elements|
+      elements.each do |type, v|
+        title = "#{type} captured at #{ts}"
+        under = "=" * title.length
+        print_line(title)
+        print_line(under)
+
+        case type
+        when 'Text'
+          print_line(v)
+
+        when 'Files'
+          total = 0
+          v.each do |f|
+            print_line("Remote Path : #{f[:name]}")
+            print_line("File size   : #{f[:size]} bytes")
+            if get_files
+              download_file( loot_dir, f[:name] )
+            end
+            print_line
+            total += f[:size]
+          end
+
+        when 'Image'
+          print_line("Dimensions : #{v[:width]} x #{v[:height]}")
+          if get_images and !v[:data].nil?
+            file = "#{ts.gsub(/\D+/, '')}-#{Rex::Text.rand_text_alpha(8)}.jpg"
+            path = File.join(loot_dir, file)
+            path = ::File.expand_path(path)
+            ::File.open(path, 'wb') do |x|
+              x.write v[:data]
+            end
+            print_line("Downloaded : #{path}")
+          end
+        end
+        print_line(under)
+        print_line
+      end
+    end
+  end
+
+end
+
+end
+end
+end
+end
+