Files
metasploit-gs/modules/encoders/x86/alpha_upper.rb
T
2025-04-14 00:10:31 +10:00

102 lines
2.9 KiB
Ruby

##
# This module requires Metasploit: https://metasploit.com/download
# Current source: https://github.com/rapid7/metasploit-framework
##
require 'rex/encoder/alpha2/alpha_upper'
class MetasploitModule < Msf::Encoder::Alphanum
Rank = LowRanking
def initialize
super(
'Name' => 'Alpha2 Alphanumeric Uppercase Encoder',
'Description' => %q{
Encodes payloads as alphanumeric uppercase text. This encoder uses
SkyLined's Alpha2 encoding suite.
A pure alpha encoder is impossible without having a register that points at or near the shellcode.
In a default configuration the first few bytes at the beginning are an fnstenv getpc stub (the same as used in shikata_ga_nai) and thus are not alphanumeric.
You can set BufferRegister for full alpha (see Encoder options for details).
},
'Author' => [ 'pusscat', 'skylined' ],
'Arch' => ARCH_X86,
'License' => BSD_LICENSE,
'EncoderType' => Msf::Encoder::Type::AlphanumUpper,
'Decoder' => {
'BlockSize' => 1
})
end
#
# Returns the decoder stub that is adjusted for the size of the buffer
# being encoded.
#
def decoder_stub(state)
modified_registers = []
reg = datastore['BufferRegister']
off = (datastore['BufferOffset'] || 0).to_i
buf = ''
# We need to create a GetEIP stub for the exploit
if !reg
if datastore['AllowWin32SEH'] && datastore['AllowWin32SEH'].to_s =~ (/^(t|y|1)/i)
buf = 'VTX630WTX638VXH49HHHPVX5AAQQPVX5YYYYP5YYYD5KKYAPTTX638TDDNVDDX4Z4A63861816'
reg = 'ECX'
off = 0
modified_registers.concat(
[
Rex::Arch::X86::ESP,
Rex::Arch::X86::EDI,
Rex::Arch::X86::ESI,
Rex::Arch::X86::EAX
]
)
else
res = Rex::Arch::X86.geteip_fpu(state.badchars, modified_registers)
if !res
raise EncodingError, 'Unable to generate geteip code'
end
buf, reg, off = res
end
else
reg.upcase!
end
stub = buf + Rex::Encoder::Alpha2::AlphaUpper.gen_decoder(reg, off, modified_registers)
# Sanity check that saved_registers doesn't overlap with modified_registers
modified_registers.uniq!
if !(modified_registers & saved_registers).empty?
raise BadGenerateError
end
stub
end
#
# Encodes a one byte block with the current index of the length of the
# payload.
#
def encode_block(state, block)
return Rex::Encoder::Alpha2::AlphaUpper.encode_byte(block.unpack('C')[0], state.badchars)
end
#
# Tack on our terminator
#
def encode_end(state)
state.encoded += Rex::Encoder::Alpha2::AlphaUpper.add_terminator
end
# Indicate that this module can preserve some registers
def can_preserve_registers?
true
end
# Convert the SaveRegisters to an array of x86 register constants
def saved_registers
Rex::Arch::X86.register_names_to_ids(datastore['SaveRegisters'])
end
end