151 lines
3.4 KiB
Ruby
151 lines
3.4 KiB
Ruby
module Msf
|
|
module Simple
|
|
|
|
###
|
|
#
|
|
# A simplified post-exploitation module wrapper.
|
|
#
|
|
###
|
|
module Post
|
|
|
|
include Module
|
|
|
|
#
|
|
# Wraps the post-exploitation module running process in a simple single
|
|
# method. The options hash can have the following values passed in it:
|
|
#
|
|
# OptionStr
|
|
#
|
|
# A string of comma separated option values that should be imported into
|
|
# the datastore.
|
|
#
|
|
# Options
|
|
#
|
|
# A hash of values to be imported directly into the datastore.
|
|
#
|
|
# LocalInput
|
|
#
|
|
# The local input handle that data can be read in from.
|
|
#
|
|
# LocalOutput
|
|
#
|
|
# The local output through which data can be displayed.
|
|
#
|
|
# RunAsJob
|
|
#
|
|
# Whether or not the module should be run in the context of a background
|
|
# job.
|
|
#
|
|
def self.run_simple(omod, opts = {}, &block)
|
|
|
|
# Clone the module to prevent changes to the original instance
|
|
mod = omod.replicant
|
|
Msf::Simple::Framework.simplify_module( mod, false )
|
|
yield(mod) if block_given?
|
|
|
|
# Import options from the OptionStr or Option hash.
|
|
mod._import_extra_options(opts)
|
|
|
|
# Verify the options
|
|
mod.options.validate(mod.datastore)
|
|
|
|
# Initialize user interaction
|
|
if ! opts['Quiet']
|
|
mod.init_ui(opts['LocalInput'] || mod.user_input, opts['LocalOutput'] || mod.user_output)
|
|
else
|
|
mod.init_ui(nil, nil)
|
|
end
|
|
|
|
#
|
|
# Disable this until we can test background stuff a little better
|
|
#
|
|
if(mod.passive? or opts['RunAsJob'])
|
|
ctx = [ mod.replicant ]
|
|
mod.job_id = mod.framework.jobs.start_bg_job(
|
|
"Post: #{mod.refname}",
|
|
ctx,
|
|
Proc.new { |ctx_| self.job_run_proc(ctx_) },
|
|
Proc.new { |ctx_| self.job_cleanup_proc(ctx_) }
|
|
)
|
|
# Propagate this back to the caller for console mgmt
|
|
omod.job_id = mod.job_id
|
|
else
|
|
ctx = [ mod ]
|
|
self.job_run_proc(ctx)
|
|
self.job_cleanup_proc(ctx)
|
|
end
|
|
end
|
|
|
|
#
|
|
# Calls the class method.
|
|
#
|
|
def run_simple(opts = {}, &block)
|
|
Msf::Simple::Post.run_simple(self, opts, &block)
|
|
end
|
|
|
|
protected
|
|
|
|
#
|
|
# Job run proc, sets up the module and kicks it off.
|
|
#
|
|
# XXX: Mostly Copy/pasted from simple/auxiliarly.rb
|
|
#
|
|
def self.job_run_proc(ctx)
|
|
mod = ctx[0]
|
|
begin
|
|
mod.setup
|
|
mod.framework.events.on_module_run(mod)
|
|
# Grab the session object since we need to fire an event for not
|
|
# only the normal module_run event that all module types have to
|
|
# report, but a specific event for sessions as well.
|
|
s = mod.framework.sessions[mod.datastore["SESSION"]]
|
|
mod.framework.events.on_session_module_run(s, mod)
|
|
mod.run
|
|
rescue ::Timeout::Error => e
|
|
mod.error = e
|
|
mod.print_error("Post triggered a timeout exception")
|
|
mod.cleanup
|
|
return
|
|
rescue ::Interrupt => e
|
|
mod.error = e
|
|
mod.print_error("Post interrupted by the console user")
|
|
mod.cleanup
|
|
return
|
|
rescue ::Exception => e
|
|
mod.error = e
|
|
mod.print_error("Post failed: #{e.class} #{e}")
|
|
if(e.class.to_s != 'Msf::OptionValidateError')
|
|
mod.print_error("Call stack:")
|
|
e.backtrace.each do |line|
|
|
break if line =~ /lib.msf.base.simple.post.rb/
|
|
mod.print_error(" #{line}")
|
|
end
|
|
end
|
|
|
|
elog("Post failed: #{e.class} #{e}", 'core', LEV_0)
|
|
dlog("Call stack:\n#{$@.join("\n")}", 'core', LEV_3)
|
|
|
|
mod.cleanup
|
|
|
|
return
|
|
end
|
|
end
|
|
|
|
#
|
|
# Clean up the module after the job completes.
|
|
#
|
|
# Copy/pasted from simple/auxiliarly.rb
|
|
#
|
|
def self.job_cleanup_proc(ctx)
|
|
mod = ctx[0]
|
|
mod.framework.events.on_module_complete(mod)
|
|
# Allow the exploit to cleanup after itself, that messy bugger.
|
|
mod.cleanup
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
end
|
|
|