librex 0.0.4 → 0.0.5
Sign up to get free protection for your applications and to get access to all the features.
- data/README.md +12 -0
- data/lib/rex.rb +0 -0
- data/lib/rex.rb.ts.rb +0 -0
- data/lib/rex/LICENSE +0 -0
- data/lib/rex/arch.rb +0 -0
- data/lib/rex/arch/sparc.rb +0 -0
- data/lib/rex/arch/sparc.rb.ut.rb +0 -0
- data/lib/rex/arch/x86.rb +0 -0
- data/lib/rex/arch/x86.rb.ut.rb +0 -0
- data/lib/rex/assembly/nasm.rb +0 -0
- data/lib/rex/assembly/nasm.rb.ut.rb +0 -0
- data/lib/rex/codepage.map +0 -0
- data/lib/rex/compat.rb +0 -0
- data/lib/rex/constants.rb +0 -0
- data/lib/rex/elfparsey.rb +0 -0
- data/lib/rex/elfparsey/elf.rb +0 -0
- data/lib/rex/elfparsey/elfbase.rb +2 -4
- data/lib/rex/elfparsey/exceptions.rb +0 -0
- data/lib/rex/elfscan.rb +0 -0
- data/lib/rex/elfscan/scanner.rb +0 -0
- data/lib/rex/elfscan/search.rb +10 -10
- data/lib/rex/encoder/alpha2.rb +0 -0
- data/lib/rex/encoder/alpha2/alpha_mixed.rb +0 -0
- data/lib/rex/encoder/alpha2/alpha_upper.rb +0 -0
- data/lib/rex/encoder/alpha2/generic.rb +0 -0
- data/lib/rex/encoder/alpha2/unicode_mixed.rb +0 -0
- data/lib/rex/encoder/alpha2/unicode_upper.rb +0 -0
- data/lib/rex/encoder/ndr.rb +0 -0
- data/lib/rex/encoder/ndr.rb.ut.rb +0 -0
- data/lib/rex/encoder/nonalpha.rb +0 -0
- data/lib/rex/encoder/nonupper.rb +0 -0
- data/lib/rex/encoder/xdr.rb +0 -0
- data/lib/rex/encoder/xdr.rb.ut.rb +0 -0
- data/lib/rex/encoder/xor.rb +0 -0
- data/lib/rex/encoder/xor/dword.rb +0 -0
- data/lib/rex/encoder/xor/dword_additive.rb +0 -0
- data/lib/rex/encoders/xor_dword.rb +0 -0
- data/lib/rex/encoders/xor_dword_additive.rb +0 -0
- data/lib/rex/encoders/xor_dword_additive.rb.ut.rb +0 -0
- data/lib/rex/encoding/xor.rb +0 -0
- data/lib/rex/encoding/xor.rb.ts.rb +0 -0
- data/lib/rex/encoding/xor/byte.rb +0 -0
- data/lib/rex/encoding/xor/byte.rb.ut.rb +0 -0
- data/lib/rex/encoding/xor/dword.rb +0 -0
- data/lib/rex/encoding/xor/dword.rb.ut.rb +0 -0
- data/lib/rex/encoding/xor/dword_additive.rb +0 -0
- data/lib/rex/encoding/xor/dword_additive.rb.ut.rb +0 -0
- data/lib/rex/encoding/xor/exceptions.rb +0 -0
- data/lib/rex/encoding/xor/generic.rb +0 -0
- data/lib/rex/encoding/xor/generic.rb.ut.rb +0 -0
- data/lib/rex/encoding/xor/qword.rb +0 -0
- data/lib/rex/encoding/xor/word.rb +0 -0
- data/lib/rex/encoding/xor/word.rb.ut.rb +0 -0
- data/lib/rex/exceptions.rb +0 -0
- data/lib/rex/exceptions.rb.ut.rb +0 -0
- data/lib/rex/exploitation/cmdstager.rb +0 -0
- data/lib/rex/exploitation/cmdstager/base.rb +6 -1
- data/lib/rex/exploitation/cmdstager/debug_asm.rb +0 -0
- data/lib/rex/exploitation/cmdstager/debug_write.rb +0 -0
- data/lib/rex/exploitation/cmdstager/tftp.rb +8 -8
- data/lib/rex/exploitation/cmdstager/vbs.rb +0 -0
- data/lib/rex/exploitation/egghunter.rb +143 -36
- data/lib/rex/exploitation/egghunter.rb.ut.rb +0 -0
- data/lib/rex/exploitation/encryptjs.rb +0 -0
- data/lib/rex/exploitation/heaplib.js.b64 +0 -0
- data/lib/rex/exploitation/heaplib.rb +0 -0
- data/lib/rex/exploitation/javascriptosdetect.rb +114 -15
- data/lib/rex/exploitation/obfuscatejs.rb +0 -0
- data/lib/rex/exploitation/omelet.rb +320 -0
- data/lib/rex/exploitation/omelet.rb.ut.rb +13 -0
- data/lib/rex/exploitation/opcodedb.rb +0 -0
- data/lib/rex/exploitation/opcodedb.rb.ut.rb +0 -0
- data/lib/rex/exploitation/seh.rb +0 -0
- data/lib/rex/exploitation/seh.rb.ut.rb +0 -0
- data/lib/rex/file.rb +1 -1
- data/lib/rex/file.rb.ut.rb +0 -0
- data/lib/rex/image_source.rb +0 -0
- data/lib/rex/image_source/disk.rb +0 -0
- data/lib/rex/image_source/image_source.rb +0 -0
- data/lib/rex/image_source/memory.rb +0 -0
- data/lib/rex/io/bidirectional_pipe.rb +0 -0
- data/lib/rex/io/datagram_abstraction.rb +0 -0
- data/lib/rex/io/stream.rb +1 -1
- data/lib/rex/io/stream_abstraction.rb +0 -0
- data/lib/rex/io/stream_server.rb +0 -0
- data/lib/rex/job_container.rb +0 -1
- data/lib/rex/logging.rb +0 -0
- data/lib/rex/logging/log_dispatcher.rb +0 -0
- data/lib/rex/logging/log_sink.rb +0 -0
- data/lib/rex/logging/sinks/flatfile.rb +0 -0
- data/lib/rex/logging/sinks/stderr.rb +0 -0
- data/lib/rex/machparsey.rb +0 -0
- data/lib/rex/machparsey/exceptions.rb +0 -0
- data/lib/rex/machparsey/machbase.rb +0 -0
- data/lib/rex/machscan.rb +0 -0
- data/lib/rex/machscan/scanner.rb +0 -0
- data/lib/rex/mime.rb +0 -0
- data/lib/rex/mime/header.rb +0 -0
- data/lib/rex/mime/message.rb +0 -0
- data/lib/rex/mime/part.rb +0 -0
- data/lib/rex/nop/opty2.rb +0 -0
- data/lib/rex/nop/opty2.rb.ut.rb +0 -0
- data/lib/rex/nop/opty2_tables.rb +0 -0
- data/lib/rex/ole.rb +0 -0
- data/lib/rex/ole/clsid.rb +0 -0
- data/lib/rex/ole/difat.rb +0 -0
- data/lib/rex/ole/directory.rb +0 -0
- data/lib/rex/ole/direntry.rb +0 -0
- data/lib/rex/ole/docs/dependencies.txt +8 -0
- data/lib/rex/ole/docs/references.txt +1 -0
- data/lib/rex/ole/fat.rb +0 -0
- data/lib/rex/ole/header.rb +3 -3
- data/lib/rex/ole/minifat.rb +0 -0
- data/lib/rex/ole/storage.rb +4 -4
- data/lib/rex/ole/stream.rb +0 -0
- data/lib/rex/ole/substorage.rb +0 -0
- data/lib/rex/ole/util.rb +0 -0
- data/lib/rex/parser/arguments.rb +0 -0
- data/lib/rex/parser/arguments.rb.ut.rb +0 -0
- data/lib/rex/parser/ini.rb +0 -0
- data/lib/rex/parser/ini.rb.ut.rb +0 -0
- data/lib/rex/parser/nexpose_xml.rb +0 -0
- data/lib/rex/parser/nmap_xml.rb +0 -0
- data/lib/rex/payloads.rb +0 -0
- data/lib/rex/payloads/win32.rb +0 -0
- data/lib/rex/payloads/win32/common.rb +0 -0
- data/lib/rex/payloads/win32/kernel.rb +0 -0
- data/lib/rex/payloads/win32/kernel/common.rb +0 -0
- data/lib/rex/payloads/win32/kernel/migration.rb +0 -0
- data/lib/rex/payloads/win32/kernel/recovery.rb +0 -0
- data/lib/rex/peparsey.rb +0 -0
- data/lib/rex/peparsey/exceptions.rb +0 -0
- data/lib/rex/peparsey/pe.rb +7 -1
- data/lib/rex/peparsey/pe_memdump.rb +0 -0
- data/lib/rex/peparsey/pebase.rb +27 -2
- data/lib/rex/peparsey/section.rb +0 -0
- data/lib/rex/pescan.rb +0 -0
- data/lib/rex/pescan/analyze.rb +0 -0
- data/lib/rex/pescan/scanner.rb +0 -0
- data/lib/rex/pescan/search.rb +0 -0
- data/lib/rex/platforms.rb +0 -0
- data/lib/rex/platforms/windows.rb +0 -0
- data/lib/rex/poly.rb +0 -0
- data/lib/rex/poly/block.rb +0 -0
- data/lib/rex/poly/register.rb +0 -0
- data/lib/rex/poly/register/x86.rb +0 -0
- data/lib/rex/post.rb +0 -0
- data/lib/rex/post/dir.rb +0 -0
- data/lib/rex/post/file.rb +0 -0
- data/lib/rex/post/file_stat.rb +0 -0
- data/lib/rex/post/gen.pl +0 -0
- data/lib/rex/post/io.rb +0 -0
- data/lib/rex/post/meterpreter.rb +0 -0
- data/lib/rex/post/meterpreter/channel.rb +0 -0
- data/lib/rex/post/meterpreter/channel_container.rb +0 -0
- data/lib/rex/post/meterpreter/channels/pool.rb +0 -0
- data/lib/rex/post/meterpreter/channels/pools/file.rb +0 -0
- data/lib/rex/post/meterpreter/channels/pools/stream_pool.rb +0 -0
- data/lib/rex/post/meterpreter/channels/stream.rb +0 -0
- data/lib/rex/post/meterpreter/client.rb +3 -0
- data/lib/rex/post/meterpreter/client_core.rb +0 -0
- data/lib/rex/post/meterpreter/dependencies.rb +0 -0
- data/lib/rex/post/meterpreter/extension.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/espia/espia.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/espia/tlv.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/incognito/incognito.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/incognito/tlv.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/networkpug/networkpug.rb +57 -0
- data/lib/rex/post/meterpreter/extensions/networkpug/tlv.rb +15 -0
- data/lib/rex/post/meterpreter/extensions/priv/fs.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/priv/passwd.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/priv/priv.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/priv/tlv.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/sniffer/sniffer.rb +2 -1
- data/lib/rex/post/meterpreter/extensions/sniffer/tlv.rb +12 -10
- data/lib/rex/post/meterpreter/extensions/stdapi/constants.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/dir.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/file.rb +31 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/file_stat.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/io.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/config.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/interface.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/route.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/socket_subsystem/tcp_server_channel.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/{railgun → stdapi/railgun}/api_constants.rb +38106 -38105
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_advapi32.rb +1804 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_iphlpapi.rb +96 -0
- data/lib/rex/post/meterpreter/extensions/{railgun → stdapi/railgun/def}/def_kernel32.rb +3848 -3678
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_ntdll.rb +153 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_shell32.rb +21 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_user32.rb +3169 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_ws2_32.rb +599 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/model.rb +540 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/multicall.rb +308 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/railgun.rb +196 -0
- data/lib/rex/post/meterpreter/extensions/{railgun → stdapi/railgun}/tlv.rb +6 -9
- data/lib/rex/post/meterpreter/extensions/stdapi/stdapi.rb +5 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/config.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/event_log.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/event_log_subsystem/event_record.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/power.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/image.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/io.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/memory.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/thread.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/registry.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/registry_subsystem/registry_key.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/registry_subsystem/registry_value.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/thread.rb +0 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/tlv.rb +6 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/ui.rb +0 -0
- data/lib/rex/post/meterpreter/inbound_packet_handler.rb +0 -0
- data/lib/rex/post/meterpreter/object_aliases.rb +0 -0
- data/lib/rex/post/meterpreter/packet.rb +23 -1
- data/lib/rex/post/meterpreter/packet_dispatcher.rb +13 -2
- data/lib/rex/post/meterpreter/packet_parser.rb +0 -0
- data/lib/rex/post/meterpreter/packet_response_waiter.rb +17 -10
- data/lib/rex/post/meterpreter/ui/console.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/core.rb +12 -7
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/espia.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/incognito.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/networkpug.rb +221 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv/elevate.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv/passwd.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv/timestomp.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/sniffer.rb +4 -3
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/fs.rb +56 -1
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/net.rb +22 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/sys.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/ui.rb +0 -0
- data/lib/rex/post/meterpreter/ui/console/interactive_channel.rb +0 -0
- data/lib/rex/post/permission.rb +0 -0
- data/lib/rex/post/process.rb +0 -0
- data/lib/rex/post/thread.rb +0 -0
- data/lib/rex/post/ui.rb +0 -0
- data/lib/rex/proto.rb +0 -0
- data/lib/rex/proto.rb.ts.rb +0 -0
- data/lib/rex/proto/dcerpc.rb +0 -0
- data/lib/rex/proto/dcerpc.rb.ts.rb +0 -0
- data/lib/rex/proto/dcerpc/client.rb +3 -1
- data/lib/rex/proto/dcerpc/exceptions.rb +0 -0
- data/lib/rex/proto/dcerpc/handle.rb +0 -0
- data/lib/rex/proto/dcerpc/handle.rb.ut.rb +0 -0
- data/lib/rex/proto/dcerpc/ndr.rb +0 -0
- data/lib/rex/proto/dcerpc/ndr.rb.ut.rb +0 -0
- data/lib/rex/proto/dcerpc/packet.rb +0 -0
- data/lib/rex/proto/dcerpc/packet.rb.ut.rb +0 -0
- data/lib/rex/proto/dcerpc/response.rb.ut.rb +0 -0
- data/lib/rex/proto/dcerpc/uuid.rb +0 -0
- data/lib/rex/proto/dcerpc/uuid.rb.ut.rb +0 -0
- data/lib/rex/proto/dhcp.rb +7 -0
- data/lib/rex/proto/dhcp/constants.rb +33 -0
- data/lib/rex/proto/dhcp/server.rb +285 -0
- data/lib/rex/proto/drda.rb +0 -0
- data/lib/rex/proto/drda.rb.ts.rb +0 -0
- data/lib/rex/proto/drda/constants.rb +0 -0
- data/lib/rex/proto/drda/constants.rb.ut.rb +0 -0
- data/lib/rex/proto/drda/packet.rb +0 -0
- data/lib/rex/proto/drda/packet.rb.ut.rb +0 -0
- data/lib/rex/proto/drda/utils.rb +0 -0
- data/lib/rex/proto/drda/utils.rb.ut.rb +0 -0
- data/lib/rex/proto/http.rb +0 -0
- data/lib/rex/proto/http.rb.ts.rb +0 -0
- data/lib/rex/proto/http/client.rb +27 -2
- data/lib/rex/proto/http/client.rb.ut.rb +4 -2
- data/lib/rex/proto/http/handler.rb +0 -0
- data/lib/rex/proto/http/handler/erb.rb +0 -0
- data/lib/rex/proto/http/handler/erb.rb.ut.rb +0 -0
- data/lib/rex/proto/http/handler/erb.rb.ut.rb.rhtml +0 -0
- data/lib/rex/proto/http/handler/proc.rb +6 -0
- data/lib/rex/proto/http/handler/proc.rb.ut.rb +0 -0
- data/lib/rex/proto/http/header.rb +0 -0
- data/lib/rex/proto/http/header.rb.ut.rb +0 -0
- data/lib/rex/proto/http/packet.rb +20 -19
- data/lib/rex/proto/http/packet.rb.ut.rb +0 -0
- data/lib/rex/proto/http/request.rb +0 -0
- data/lib/rex/proto/http/request.rb.ut.rb +0 -0
- data/lib/rex/proto/http/response.rb +0 -0
- data/lib/rex/proto/http/response.rb.ut.rb +0 -0
- data/lib/rex/proto/http/server.rb +5 -3
- data/lib/rex/proto/http/server.rb.ut.rb +0 -0
- data/lib/rex/proto/proxy/socks4a.rb +440 -0
- data/lib/rex/proto/smb.rb +0 -0
- data/lib/rex/proto/smb.rb.ts.rb +0 -0
- data/lib/rex/proto/smb/client.rb +110 -61
- data/lib/rex/proto/smb/client.rb.ut.rb +0 -0
- data/lib/rex/proto/smb/constants.rb +5 -3
- data/lib/rex/proto/smb/constants.rb.ut.rb +0 -0
- data/lib/rex/proto/smb/crypt.rb +0 -0
- data/lib/rex/proto/smb/crypt.rb.ut.rb +0 -0
- data/lib/rex/proto/smb/exceptions.rb +0 -0
- data/lib/rex/proto/smb/simpleclient.rb +0 -0
- data/lib/rex/proto/smb/simpleclient.rb.ut.rb +0 -0
- data/lib/rex/proto/smb/utils.rb +2 -0
- data/lib/rex/proto/smb/utils.rb.ut.rb +0 -0
- data/lib/rex/proto/sunrpc.rb +0 -0
- data/lib/rex/proto/sunrpc/client.rb +0 -0
- data/lib/rex/proto/tftp.rb +10 -1
- data/lib/rex/proto/tftp/constants.rb +5 -3
- data/lib/rex/proto/tftp/server.rb +79 -9
- data/lib/rex/script.rb +0 -0
- data/lib/rex/script/base.rb +0 -0
- data/lib/rex/script/meterpreter.rb +0 -0
- data/lib/rex/script/shell.rb +0 -0
- data/lib/rex/service.rb +0 -0
- data/lib/rex/service_manager.rb +0 -0
- data/lib/rex/service_manager.rb.ut.rb +0 -0
- data/lib/rex/services/local_relay.rb +0 -0
- data/lib/rex/socket.rb +6 -4
- data/lib/rex/socket.rb.ut.rb +0 -0
- data/lib/rex/socket/comm.rb +0 -0
- data/lib/rex/socket/comm/local.rb +0 -0
- data/lib/rex/socket/comm/local.rb.ut.rb +0 -0
- data/lib/rex/socket/ip.rb +0 -0
- data/lib/rex/socket/parameters.rb +0 -0
- data/lib/rex/socket/parameters.rb.ut.rb +0 -0
- data/lib/rex/socket/range_walker.rb +0 -0
- data/lib/rex/socket/range_walker.rb.ut.rb +0 -0
- data/lib/rex/socket/ssl_tcp.rb +1 -1
- data/lib/rex/socket/ssl_tcp.rb.ut.rb +0 -0
- data/lib/rex/socket/ssl_tcp_server.rb +0 -0
- data/lib/rex/socket/ssl_tcp_server.rb.ut.rb +0 -0
- data/lib/rex/socket/subnet_walker.rb +0 -0
- data/lib/rex/socket/subnet_walker.rb.ut.rb +0 -0
- data/lib/rex/socket/switch_board.rb.ut.rb +0 -0
- data/lib/rex/socket/tcp.rb +0 -0
- data/lib/rex/socket/tcp.rb.ut.rb +0 -0
- data/lib/rex/socket/tcp_server.rb +0 -0
- data/lib/rex/socket/tcp_server.rb.ut.rb +0 -0
- data/lib/rex/socket/udp.rb +0 -0
- data/lib/rex/socket/udp.rb.ut.rb +0 -0
- data/lib/rex/struct2.rb +0 -0
- data/lib/rex/struct2/c_struct.rb +0 -0
- data/lib/rex/struct2/c_struct_template.rb +0 -0
- data/lib/rex/struct2/constant.rb +0 -0
- data/lib/rex/struct2/element.rb +0 -0
- data/lib/rex/struct2/generic.rb +0 -0
- data/lib/rex/struct2/restraint.rb +0 -0
- data/lib/rex/struct2/s_string.rb +0 -0
- data/lib/rex/struct2/s_struct.rb +0 -0
- data/lib/rex/sync.rb +0 -0
- data/lib/rex/sync/event.rb +0 -0
- data/lib/rex/sync/read_write_lock.rb +0 -0
- data/lib/rex/sync/ref.rb +0 -0
- data/lib/rex/sync/thread_safe.rb +0 -0
- data/lib/rex/test.rb +0 -0
- data/lib/rex/text.rb +13 -3
- data/lib/rex/text.rb.ut.rb +9 -4
- data/lib/rex/time.rb +0 -0
- data/lib/rex/transformer.rb +0 -0
- data/lib/rex/transformer.rb.ut.rb +0 -0
- data/lib/rex/ui.rb +0 -0
- data/lib/rex/ui/interactive.rb +0 -0
- data/lib/rex/ui/output.rb +0 -0
- data/lib/rex/ui/output/none.rb +0 -0
- data/lib/rex/ui/progress_tracker.rb +0 -0
- data/lib/rex/ui/subscriber.rb +0 -0
- data/lib/rex/ui/text/color.rb +0 -0
- data/lib/rex/ui/text/color.rb.ut.rb +0 -0
- data/lib/rex/ui/text/dispatcher_shell.rb +0 -0
- data/lib/rex/ui/text/input.rb +0 -0
- data/lib/rex/ui/text/input/buffer.rb +0 -0
- data/lib/rex/ui/text/input/readline.rb +0 -0
- data/lib/rex/ui/text/input/socket.rb +0 -0
- data/lib/rex/ui/text/input/stdio.rb +0 -0
- data/lib/rex/ui/text/irb_shell.rb +0 -0
- data/lib/rex/ui/text/output.rb +0 -0
- data/lib/rex/ui/text/output/buffer.rb +0 -0
- data/lib/rex/ui/text/output/file.rb +0 -0
- data/lib/rex/ui/text/output/socket.rb +0 -0
- data/lib/rex/ui/text/output/stdio.rb +0 -0
- data/lib/rex/ui/text/progress_tracker.rb +0 -0
- data/lib/rex/ui/text/progress_tracker.rb.ut.rb +0 -0
- data/lib/rex/ui/text/shell.rb +9 -6
- data/lib/rex/ui/text/table.rb +5 -0
- data/lib/rex/ui/text/table.rb.ut.rb +0 -0
- data/lib/rex/zip.rb +0 -0
- data/lib/rex/zip/archive.rb +29 -1
- data/lib/rex/zip/blocks.rb +0 -0
- data/lib/rex/zip/entry.rb +5 -1
- metadata +369 -413
- data/README +0 -8
- data/lib/rex/post/meterpreter/extensions/railgun/api.rb +0 -9303
- data/lib/rex/post/meterpreter/extensions/railgun/railgun.rb +0 -815
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/railgun.rb +0 -57
@@ -1,815 +0,0 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
|
3
|
-
# Copyright (c) 2010, patrickHVE@googlemail.com
|
4
|
-
# All rights reserved.
|
5
|
-
#
|
6
|
-
# Redistribution and use in source and binary forms, with or without
|
7
|
-
# modification, are permitted provided that the following conditions are met:
|
8
|
-
# * Redistributions of source code must retain the above copyright
|
9
|
-
# notice, this list of conditions and the following disclaimer.
|
10
|
-
# * Redistributions in binary form must reproduce the above copyright
|
11
|
-
# notice, this list of conditions and the following disclaimer in the
|
12
|
-
# documentation and/or other materials provided with the distribution.
|
13
|
-
# * The names of the author may not be used to endorse or promote products
|
14
|
-
# derived from this software without specific prior written permission.
|
15
|
-
#
|
16
|
-
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
17
|
-
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
18
|
-
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
19
|
-
# DISCLAIMED. IN NO EVENT SHALL patrickHVE@googlemail.com BE LIABLE FOR ANY
|
20
|
-
# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
21
|
-
# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
22
|
-
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
23
|
-
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
24
|
-
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
25
|
-
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
26
|
-
|
27
|
-
require 'rex/post/meterpreter/extensions/railgun/tlv'
|
28
|
-
require "pp"
|
29
|
-
require 'enumerator'
|
30
|
-
require 'rex/post/meterpreter/extensions/railgun/api'
|
31
|
-
require 'rex/post/meterpreter/extensions/railgun/api_constants'
|
32
|
-
|
33
|
-
module Rex
|
34
|
-
module Post
|
35
|
-
module Meterpreter
|
36
|
-
module Extensions
|
37
|
-
module Railgun
|
38
|
-
|
39
|
-
# Manages our library of windows constants
|
40
|
-
class WinConstManager
|
41
|
-
def initialize()
|
42
|
-
@consts = {}
|
43
|
-
end
|
44
|
-
|
45
|
-
def add_const(name, value)
|
46
|
-
@consts[name] = value
|
47
|
-
end
|
48
|
-
|
49
|
-
# parses a string constaining constants and returns an integer
|
50
|
-
# the string can be either "CONST" or "CONST1 | CONST2"
|
51
|
-
#
|
52
|
-
# this function will NOT throw an exception but return "nil" if it can't parse a string
|
53
|
-
def parse(s)
|
54
|
-
if s.class != String
|
55
|
-
return nil # it's not even a string'
|
56
|
-
end
|
57
|
-
return_value = 0
|
58
|
-
for one_const in s.split('|')
|
59
|
-
one_const = one_const.strip()
|
60
|
-
if not @consts.has_key? one_const
|
61
|
-
return nil # at least one "Constant" is unknown to us
|
62
|
-
end
|
63
|
-
return_value |= @consts[one_const]
|
64
|
-
end
|
65
|
-
return return_value
|
66
|
-
end
|
67
|
-
|
68
|
-
def is_parseable(s)
|
69
|
-
return parse(s) != nil
|
70
|
-
end
|
71
|
-
end
|
72
|
-
|
73
|
-
|
74
|
-
# represents one function, e.g. MessageBoxW
|
75
|
-
class DLLFunction
|
76
|
-
attr_reader :return_type, :params, :windows_name
|
77
|
-
|
78
|
-
def initialize(return_type, params, windows_name)
|
79
|
-
check_return_type(return_type) # we do error checking as early as possible so the library is easier to use
|
80
|
-
check_params(params)
|
81
|
-
@return_type = return_type
|
82
|
-
@params = params
|
83
|
-
@windows_name = windows_name
|
84
|
-
end
|
85
|
-
|
86
|
-
@@directions=["in", "out", "inout", "return"]
|
87
|
-
@@allowed_datatypes={
|
88
|
-
"VOID" => ["return"],
|
89
|
-
"BOOL" => ["in", "return"],
|
90
|
-
"DWORD" => ["in", "return"],
|
91
|
-
"WORD" => ["in", "return"],
|
92
|
-
"BYTE" => ["in", "return"],
|
93
|
-
"PDWORD" => ["in", "out", "inout"], # todo: support for functions that return pointers to strings
|
94
|
-
"PWCHAR" => ["in", "out", "inout"],
|
95
|
-
"PCHAR" => ["in", "out", "inout"],
|
96
|
-
"PBLOB" => ["in", "out", "inout"]
|
97
|
-
}
|
98
|
-
private
|
99
|
-
def check_type_exists (type)
|
100
|
-
if not @@allowed_datatypes.has_key?(type)
|
101
|
-
raise "Type unknown: #{type}. Allowed types: #{PP.pp(@@allowed_datatypes.keys, "")}"
|
102
|
-
end
|
103
|
-
end
|
104
|
-
|
105
|
-
def check_return_type (type)
|
106
|
-
check_type_exists(type)
|
107
|
-
if not @@allowed_datatypes[type].include?("return")
|
108
|
-
raise "#{type} is not allowed as a return type"
|
109
|
-
end
|
110
|
-
end
|
111
|
-
|
112
|
-
def check_params (params)
|
113
|
-
params.each do |param|
|
114
|
-
throw "each param must be descriped by a three-tuple [type,name,direction]" unless param.length == 3
|
115
|
-
type = param[0]
|
116
|
-
direction = param[2]
|
117
|
-
check_type_exists(type)
|
118
|
-
throw "invalid direction: #{direction}" unless @@directions.include?(direction)
|
119
|
-
throw "direction 'return' is only for the return value of the function." unless direction != "return"
|
120
|
-
end
|
121
|
-
end
|
122
|
-
end
|
123
|
-
|
124
|
-
class BufferItem
|
125
|
-
attr_reader :belongs_to_param_n, :addr, :length_in_bytes, :datatype
|
126
|
-
|
127
|
-
def initialize(belongs_to_param_n, addr, length_in_bytes, datatype)
|
128
|
-
@belongs_to_param_n = belongs_to_param_n
|
129
|
-
@addr = addr
|
130
|
-
@length_in_bytes = length_in_bytes
|
131
|
-
@datatype = datatype
|
132
|
-
end
|
133
|
-
end
|
134
|
-
|
135
|
-
# shared functions
|
136
|
-
module DLLHelper
|
137
|
-
|
138
|
-
# converts ruby string to zero-terminated ASCII string
|
139
|
-
def str_to_ascii_z(str)
|
140
|
-
return str+"\x00"
|
141
|
-
end
|
142
|
-
|
143
|
-
# converts 0-terminated ASCII string to ruby string
|
144
|
-
def asciiz_to_str(asciiz)
|
145
|
-
zero_byte_idx = asciiz.index("\x00")
|
146
|
-
if zero_byte_idx != nil
|
147
|
-
return asciiz[0, zero_byte_idx]
|
148
|
-
else
|
149
|
-
return asciiz
|
150
|
-
end
|
151
|
-
end
|
152
|
-
|
153
|
-
# converts ruby string to zero-terminated WCHAR string
|
154
|
-
def str_to_uni_z(str)
|
155
|
-
enc = str.unpack("C*").pack("v*")
|
156
|
-
enc += "\x00\x00"
|
157
|
-
return enc
|
158
|
-
end
|
159
|
-
|
160
|
-
# converts 0-terminated UTF16 to ruby string
|
161
|
-
def uniz_to_str(uniz)
|
162
|
-
uniz.unpack("v*").pack("C*").unpack("A*")[0]
|
163
|
-
end
|
164
|
-
|
165
|
-
# parses a DWORD param and returns the value
|
166
|
-
# raises an exception if the param cannot be converted to DWORD
|
167
|
-
# examples:
|
168
|
-
# 3 => 3
|
169
|
-
# "MB_OK" => 0
|
170
|
-
# "SOME_CONSTANT | OTHER_CONSTANT" => 17
|
171
|
-
# "tuna" => !!!!!!!!!!Exception
|
172
|
-
def param_to_dword(v)
|
173
|
-
if v.class == Fixnum then
|
174
|
-
return v # ok, it's already a number
|
175
|
-
elsif v.class == Bignum then
|
176
|
-
return v # ok, it's already a number
|
177
|
-
elsif v.class == String then
|
178
|
-
dw = @win_consts.parse(v) # might raise an exception
|
179
|
-
if dw != nil
|
180
|
-
return dw
|
181
|
-
else
|
182
|
-
raise "Param #{v} (class #{v.class}) cannot be converted to DWORD. It's a string but matches no constants I know."
|
183
|
-
end
|
184
|
-
else
|
185
|
-
raise "Param #{v} (class #{v.class}) should be a number but isn't"
|
186
|
-
end
|
187
|
-
end # param_to_dword(v)
|
188
|
-
|
189
|
-
|
190
|
-
# assembles the buffers "in" and "inout"
|
191
|
-
def assemble_buffer(direction, function, args)
|
192
|
-
layout = {} # paramName => BufferItem
|
193
|
-
blob = ""
|
194
|
-
#puts " building buffer: #{direction}"
|
195
|
-
function.params.each_with_index do |param_desc, param_idx|
|
196
|
-
#puts " processing #{param_desc[0]} #{param_desc[1]} #{param_desc[2]}"
|
197
|
-
# we care only about inout buffers
|
198
|
-
if param_desc[2] == direction
|
199
|
-
buffer = nil
|
200
|
-
|
201
|
-
# Special case:
|
202
|
-
# The user can choose to supply a Null pointer instead of a buffer
|
203
|
-
# in this case we don't need space in any heap buffer
|
204
|
-
if param_desc[0][0,1] == 'P' # type is a pointer
|
205
|
-
if args[param_idx] == nil
|
206
|
-
next
|
207
|
-
end
|
208
|
-
end
|
209
|
-
|
210
|
-
case param_desc[0] # required argument type
|
211
|
-
when "PDWORD"
|
212
|
-
dw = param_to_dword(args[param_idx])
|
213
|
-
buffer = [dw].pack('V')
|
214
|
-
when "PWCHAR"
|
215
|
-
raise "param #{param_desc[1]}: string expected" unless args[param_idx].class == String
|
216
|
-
buffer = str_to_uni_z(args[param_idx])
|
217
|
-
when "PCHAR"
|
218
|
-
raise "param #{param_desc[1]}: string expected" unless args[param_idx].class == String
|
219
|
-
buffer = str_to_ascii_z(args[param_idx])
|
220
|
-
when "PBLOB"
|
221
|
-
raise "param #{param_desc[1]}: please supply your BLOB as string!" unless args[param_idx].class == String
|
222
|
-
buffer = args[param_idx]
|
223
|
-
# other types (non-pointers) don't reference buffers
|
224
|
-
# and don't need any treatment here
|
225
|
-
end
|
226
|
-
if buffer != nil
|
227
|
-
#puts " adding #{buffer.length} bytes to heap blob"
|
228
|
-
layout[param_desc[1]] = BufferItem.new(param_idx, blob.length, buffer.length, param_desc[0])
|
229
|
-
blob += buffer
|
230
|
-
#puts " heap blob size now #{blob.length}"
|
231
|
-
end
|
232
|
-
end
|
233
|
-
end
|
234
|
-
#puts " built buffer: #{direction}"
|
235
|
-
return [layout, blob]
|
236
|
-
end
|
237
|
-
end
|
238
|
-
|
239
|
-
# represents a DLL, e.g. kernel32.dll
|
240
|
-
class DLL
|
241
|
-
|
242
|
-
include DLLHelper
|
243
|
-
|
244
|
-
attr_accessor :functions
|
245
|
-
|
246
|
-
def initialize(dll_path, client, win_consts) #
|
247
|
-
@dll_path = dll_path
|
248
|
-
@client = client
|
249
|
-
@win_consts = win_consts
|
250
|
-
self.functions = {}
|
251
|
-
end
|
252
|
-
|
253
|
-
# adds a function to the DLL
|
254
|
-
# syntax for params:
|
255
|
-
# add_function("MessageBoxW", # name
|
256
|
-
# "DWORD", # return value
|
257
|
-
# [["DWORD","hWnd","in"], # params
|
258
|
-
# ["PWCHAR","lpText","in"],
|
259
|
-
# ["PWCHAR","lpCaption","in"],
|
260
|
-
# ["DWORD","uType","in"],
|
261
|
-
# ])
|
262
|
-
#
|
263
|
-
# Every function argument is described by a tuple (type,name,direction)
|
264
|
-
#
|
265
|
-
# windows_name: Use it when the actual windows name is different from the ruby variable
|
266
|
-
# for example when the actual func name is myFunc@4
|
267
|
-
# or when you want to create an alternative version of an existing function
|
268
|
-
#
|
269
|
-
# When new function is called it will return a list containing the return value and all inout params
|
270
|
-
def add_function(name, return_type, params, windows_name=nil)
|
271
|
-
if windows_name == nil
|
272
|
-
windows_name = name
|
273
|
-
end
|
274
|
-
@functions[name] = DLLFunction.new(return_type, params, windows_name)
|
275
|
-
end
|
276
|
-
|
277
|
-
private
|
278
|
-
|
279
|
-
|
280
|
-
# called when a function like "MessageBoxW" is called
|
281
|
-
def process_function_call(function, args)
|
282
|
-
raise "#{function.params.length} arguments expected. #{args.length} arguments provided." unless args.length == function.params.length
|
283
|
-
#puts "process_function_call(function.windows_name,#{PP.pp(args, "")})"
|
284
|
-
|
285
|
-
# We transmit the immediate stack and three heap-buffers:
|
286
|
-
# in, inout and out. The reason behind the separation is bandwidth.
|
287
|
-
# We don't want to transmit uninitialized data in or no-longer-needed data out.
|
288
|
-
|
289
|
-
# out-only-buffers that are ONLY transmitted on the way BACK
|
290
|
-
out_only_layout = {} # paramName => BufferItem
|
291
|
-
out_only_size_bytes = 0
|
292
|
-
#puts " assembling out-only buffer"
|
293
|
-
function.params.each_with_index do |param_desc, param_idx|
|
294
|
-
#puts " processing #{param_desc[1]}"
|
295
|
-
|
296
|
-
# Special case:
|
297
|
-
# The user can choose to supply a Null pointer instead of a buffer
|
298
|
-
# in this case we don't need space in any heap buffer
|
299
|
-
if param_desc[0][0,1] == 'P' # type is a pointer
|
300
|
-
if args[param_idx] == nil
|
301
|
-
next
|
302
|
-
end
|
303
|
-
end
|
304
|
-
|
305
|
-
# we care only about out-only buffers
|
306
|
-
if param_desc[2] == "out"
|
307
|
-
raise "error in param #{param_desc[1]}: Out-only buffers must be described by a number indicating their size in bytes " unless args[param_idx].class == Fixnum
|
308
|
-
buffer_size = args[param_idx]
|
309
|
-
if param_desc[0] == "PDWORD"
|
310
|
-
raise "Please pass 4 for 'out' PDWORDS, since they require a buffer of size 4" unless buffer_size == 4
|
311
|
-
end
|
312
|
-
|
313
|
-
out_only_layout[param_desc[1]] = BufferItem.new(param_idx, out_only_size_bytes, buffer_size, param_desc[0])
|
314
|
-
out_only_size_bytes += buffer_size
|
315
|
-
end
|
316
|
-
end
|
317
|
-
|
318
|
-
tmp = assemble_buffer("in", function, args)
|
319
|
-
in_only_layout = tmp[0]
|
320
|
-
in_only_buffer = tmp[1]
|
321
|
-
|
322
|
-
tmp = assemble_buffer("inout", function, args)
|
323
|
-
inout_layout = tmp[0]
|
324
|
-
inout_buffer = tmp[1]
|
325
|
-
|
326
|
-
|
327
|
-
# now we build the stack
|
328
|
-
# every stack dword will be described by two dwords:
|
329
|
-
# first dword describes second dword:
|
330
|
-
# 0 - literal,
|
331
|
-
# 1 = relative to in-only buffer
|
332
|
-
# 2 = relative to out-only buffer
|
333
|
-
# 3 = relative to inout buffer
|
334
|
-
|
335
|
-
# (literal numbers and pointers to buffers we have created)
|
336
|
-
literal_pairs_blob = ""
|
337
|
-
#puts " assembling literal stack"
|
338
|
-
function.params.each_with_index do |param_desc, param_idx|
|
339
|
-
#puts " processing (#{param_desc[0]}, #{param_desc[1]}, #{param_desc[2]})"
|
340
|
-
buffer = nil
|
341
|
-
# is it a pointer to a buffer on our stack
|
342
|
-
if ["PDWORD", "PWCHAR", "PCHAR", "PBLOB"].include? param_desc[0]
|
343
|
-
#puts " pointer"
|
344
|
-
if args[param_idx] == nil # null pointer?
|
345
|
-
buffer = [0].pack('V') # type: DWORD (so the dll does not rebase it)
|
346
|
-
buffer += [0].pack('V') # value: 0
|
347
|
-
elsif param_desc[2] == "in"
|
348
|
-
buffer = [1].pack('V')
|
349
|
-
buffer += [in_only_layout[param_desc[1]].addr].pack('V')
|
350
|
-
elsif param_desc[2] == "out"
|
351
|
-
buffer = [2].pack('V')
|
352
|
-
buffer += [out_only_layout[param_desc[1]].addr].pack('V')
|
353
|
-
elsif param_desc[2] == "inout"
|
354
|
-
buffer = [3].pack('V')
|
355
|
-
buffer += [inout_layout[param_desc[1]].addr].pack('V')
|
356
|
-
else
|
357
|
-
raise "unexpected direction"
|
358
|
-
end
|
359
|
-
else
|
360
|
-
#puts " not a pointer"
|
361
|
-
# it's not a pointer
|
362
|
-
buffer = [0].pack('V')
|
363
|
-
case param_desc[0]
|
364
|
-
when "DWORD"
|
365
|
-
dw = param_to_dword(args[param_idx])
|
366
|
-
buffer += [dw].pack('V')
|
367
|
-
when "WORD"
|
368
|
-
dw = param_to_dword(args[param_idx])
|
369
|
-
buffer += [dw % 65536].pack('V')
|
370
|
-
when "BYTE"
|
371
|
-
dw = param_to_dword(args[param_idx])
|
372
|
-
buffer += [dw % 256].pack('V')
|
373
|
-
when "BOOL"
|
374
|
-
case args[param_idx]
|
375
|
-
when true
|
376
|
-
buffer += [1].pack('V')
|
377
|
-
when false
|
378
|
-
buffer += [0].pack('V')
|
379
|
-
else
|
380
|
-
raise "param #{param_desc[1]}: true or false expected"
|
381
|
-
end
|
382
|
-
else
|
383
|
-
raise "unexpected type for param #{param_desc[1]}"
|
384
|
-
end
|
385
|
-
end
|
386
|
-
|
387
|
-
#puts " adding pair to blob"
|
388
|
-
literal_pairs_blob += buffer
|
389
|
-
#puts " buffer size %X" % buffer.length
|
390
|
-
#puts " blob size so far: %X" % literal_pairs_blob.length
|
391
|
-
end
|
392
|
-
|
393
|
-
#puts "\n\nsending Stuff to meterpreter"
|
394
|
-
request = Packet.create_request('railgun_api')
|
395
|
-
request.add_tlv(TLV_TYPE_RAILGUN_SIZE_OUT, out_only_size_bytes)
|
396
|
-
|
397
|
-
request.add_tlv(TLV_TYPE_RAILGUN_STACKBLOB, literal_pairs_blob)
|
398
|
-
request.add_tlv(TLV_TYPE_RAILGUN_BUFFERBLOB_IN, in_only_buffer)
|
399
|
-
request.add_tlv(TLV_TYPE_RAILGUN_BUFFERBLOB_INOUT, inout_buffer)
|
400
|
-
|
401
|
-
request.add_tlv(TLV_TYPE_RAILGUN_DLLNAME, @dll_path )
|
402
|
-
request.add_tlv(TLV_TYPE_RAILGUN_FUNCNAME, function.windows_name)
|
403
|
-
|
404
|
-
|
405
|
-
response = @client.send_request(request)
|
406
|
-
|
407
|
-
#puts "receiving Stuff from meterpreter"
|
408
|
-
#puts "out_only_layout:"
|
409
|
-
#puts out_only_layout
|
410
|
-
|
411
|
-
rec_inout_buffers = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_BUFFERBLOB_INOUT)
|
412
|
-
rec_out_only_buffers = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_BUFFERBLOB_OUT)
|
413
|
-
rec_return_value = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_RET)
|
414
|
-
rec_last_error = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_ERR)
|
415
|
-
|
416
|
-
#puts "received stuff"
|
417
|
-
#puts "out_only_layout:"
|
418
|
-
#puts out_only_layout
|
419
|
-
|
420
|
-
# The hash the function returns
|
421
|
-
return_hash={"GetLastError" => rec_last_error}
|
422
|
-
|
423
|
-
#process return value
|
424
|
-
case function.return_type
|
425
|
-
when "DWORD"
|
426
|
-
return_hash["return"] = rec_return_value
|
427
|
-
when "WORD"
|
428
|
-
return_hash["return"] = rec_return_value % 65536
|
429
|
-
when "BYTE"
|
430
|
-
return_hash["return"] = rec_return_value % 256
|
431
|
-
when "BOOL"
|
432
|
-
return_hash["return"] = (rec_return_value != 0)
|
433
|
-
when "VOID"
|
434
|
-
return_hash["return"] = nil
|
435
|
-
else
|
436
|
-
raise "unexpected return type: #{function.return_type}"
|
437
|
-
end
|
438
|
-
#puts return_hash
|
439
|
-
#puts "out_only_layout:"
|
440
|
-
#puts out_only_layout
|
441
|
-
|
442
|
-
|
443
|
-
# process out-only buffers
|
444
|
-
#puts "processing out-only buffers:"
|
445
|
-
out_only_layout.each_pair do |param_name, buffer_item|
|
446
|
-
#puts " #{param_name}"
|
447
|
-
buffer = rec_out_only_buffers[buffer_item.addr, buffer_item.length_in_bytes]
|
448
|
-
case buffer_item.datatype
|
449
|
-
when "PDWORD"
|
450
|
-
return_hash[param_name] = buffer.unpack('V')[0]
|
451
|
-
when "PCHAR"
|
452
|
-
return_hash[param_name] = asciiz_to_str(buffer)
|
453
|
-
when "PWCHAR"
|
454
|
-
return_hash[param_name] = uniz_to_str(buffer)
|
455
|
-
when "PBLOB"
|
456
|
-
return_hash[param_name] = buffer
|
457
|
-
else
|
458
|
-
raise "unexpected type in out-only buffer of #{param_name}: #{buffer_item.datatype}"
|
459
|
-
end
|
460
|
-
end
|
461
|
-
#puts return_hash
|
462
|
-
|
463
|
-
# process in-out buffers
|
464
|
-
#puts "processing in-out buffers:"
|
465
|
-
inout_layout.each_pair do |param_name, buffer_item|
|
466
|
-
#puts " #{param_name}"
|
467
|
-
buffer = rec_inout_buffers[buffer_item.addr, buffer_item.length_in_bytes]
|
468
|
-
case buffer_item.datatype
|
469
|
-
when "PDWORD"
|
470
|
-
return_hash[param_name] = buffer.unpack('V')[0]
|
471
|
-
when "PCHAR"
|
472
|
-
return_hash[param_name] = asciiz_to_str(buffer)
|
473
|
-
when "PWCHAR"
|
474
|
-
return_hash[param_name] = uniz_to_str(buffer)
|
475
|
-
when "PBLOB"
|
476
|
-
return_hash[param_name] = buffer
|
477
|
-
else
|
478
|
-
raise "unexpected type in in-out-buffer of #{param_name}: #{buffer_item.datatype}"
|
479
|
-
end
|
480
|
-
end
|
481
|
-
#puts return_hash
|
482
|
-
#puts "finished"
|
483
|
-
|
484
|
-
return return_hash
|
485
|
-
end
|
486
|
-
|
487
|
-
# process_function_call
|
488
|
-
|
489
|
-
|
490
|
-
# we fake having methods like "MessageBoxW" by intercepting "method-not-found"-exceptions
|
491
|
-
def method_missing(func_symbol, *args)
|
492
|
-
func_name = func_symbol.to_s
|
493
|
-
raise "DLL-function #{func_name} not found. Known functions: #{PP.pp(@functions.keys, "")}" unless @functions.has_key? func_name
|
494
|
-
function = @functions[func_name]
|
495
|
-
return process_function_call(function, args)
|
496
|
-
end
|
497
|
-
end
|
498
|
-
|
499
|
-
#
|
500
|
-
# This extensions give you access to the full Windows API
|
501
|
-
#
|
502
|
-
class Railgun < Extension
|
503
|
-
|
504
|
-
attr_accessor :dll, :client, :multicaller
|
505
|
-
|
506
|
-
def initialize(client)
|
507
|
-
super(client, 'railgun')
|
508
|
-
self.client = client
|
509
|
-
self.dll = {}
|
510
|
-
@win_consts = WinConstManager.new()
|
511
|
-
|
512
|
-
# Load tons of definitions
|
513
|
-
ApiDefinitions.add_imports(self)
|
514
|
-
ApiConstants.add_constants(@win_consts)
|
515
|
-
|
516
|
-
# Load the multi-caller
|
517
|
-
self.multicaller = MultiCaller.new(self)
|
518
|
-
client.register_extension_aliases(
|
519
|
-
[
|
520
|
-
{
|
521
|
-
'name' => 'railgun',
|
522
|
-
'ext' => self
|
523
|
-
},
|
524
|
-
])
|
525
|
-
end
|
526
|
-
|
527
|
-
# adds a function to an existing DLL-definition
|
528
|
-
def add_function(dll_name, function_name, return_type, params, windows_name=nil)
|
529
|
-
raise "DLL #{dll_name} not found. Known DLLs: #{PP.pp(@dll.keys, "")}" unless @dll.has_key? dll_name
|
530
|
-
@dll[dll_name].add_function(function_name, return_type, params, windows_name)
|
531
|
-
end
|
532
|
-
|
533
|
-
# adds a function to an existing DLL-definition
|
534
|
-
# you can override the dll name if you want to include a path or the DLL name contains
|
535
|
-
# non-ruby-approved characters
|
536
|
-
def add_dll(dll_name, windows_name=nil)
|
537
|
-
raise "DLL #{dll_name} already exists. Existing DLLs: #{PP.pp(@dll.keys, "")}" unless not @dll.has_key? dll_name
|
538
|
-
if windows_name == nil
|
539
|
-
windows_name = dll_name
|
540
|
-
end
|
541
|
-
@dll[dll_name] = DLL.new(windows_name, @client, @win_consts)
|
542
|
-
end
|
543
|
-
|
544
|
-
# we fake having members like user32 and kernel32.
|
545
|
-
# reason is that
|
546
|
-
# ...user32.MessageBoxW()
|
547
|
-
# is prettier than
|
548
|
-
# ...dlls["user32"].functions["MessageBoxW"]()
|
549
|
-
def method_missing(dll_symbol, *args)
|
550
|
-
dll_name = dll_symbol.to_s
|
551
|
-
raise "DLL #{dll_name} not found. Known DLLs: #{PP.pp(@dll.keys, "")}" unless @dll.has_key? dll_name
|
552
|
-
return @dll[dll_name]
|
553
|
-
end
|
554
|
-
|
555
|
-
# Give the programmer access to constants
|
556
|
-
def const(str)
|
557
|
-
return @win_consts.parse(str)
|
558
|
-
end
|
559
|
-
|
560
|
-
# The multi-call shorthand ( ["kernel32", "ExitProcess", [0]] )
|
561
|
-
def multi(functions)
|
562
|
-
self.multicaller.call(functions)
|
563
|
-
end
|
564
|
-
|
565
|
-
# A easier way to call multiple functions in a single request
|
566
|
-
class MultiCaller
|
567
|
-
|
568
|
-
include DLLHelper
|
569
|
-
attr_accessor :parent, :dll, :client
|
570
|
-
|
571
|
-
def initialize(parent)
|
572
|
-
self.parent = parent
|
573
|
-
self.dll = parent.dll
|
574
|
-
self.client = parent.client
|
575
|
-
end
|
576
|
-
|
577
|
-
def call(functions)
|
578
|
-
|
579
|
-
request = Packet.create_request('railgun_api_multi')
|
580
|
-
function_results = []
|
581
|
-
layouts = []
|
582
|
-
functions.each do |f|
|
583
|
-
dll_name,funcname,args = f
|
584
|
-
dll_host = @dll[dll_name]
|
585
|
-
|
586
|
-
if not dll_host
|
587
|
-
raise "DLL #{dll_name} has not been loaded"
|
588
|
-
end
|
589
|
-
|
590
|
-
function = dll_host.functions[funcname]
|
591
|
-
if not function
|
592
|
-
raise "DLL #{dll_name} function #{funcname} has not been defined"
|
593
|
-
end
|
594
|
-
|
595
|
-
raise "#{function.params.length} arguments expected. #{args.length} arguments provided." unless args.length == function.params.length
|
596
|
-
#puts "process_function_call(function.windows_name,#{PP.pp(args, "")})"
|
597
|
-
|
598
|
-
# We transmit the immediate stack and three heap-buffers:
|
599
|
-
# in, inout and out. The reason behind the separation is bandwidth.
|
600
|
-
# We don't want to transmit uninitialized data in or no-longer-needed data out.
|
601
|
-
|
602
|
-
# out-only-buffers that are ONLY transmitted on the way BACK
|
603
|
-
out_only_layout = {} # paramName => BufferItem
|
604
|
-
out_only_size_bytes = 0
|
605
|
-
#puts " assembling out-only buffer"
|
606
|
-
function.params.each_with_index do |param_desc, param_idx|
|
607
|
-
#puts " processing #{param_desc[1]}"
|
608
|
-
|
609
|
-
# Special case:
|
610
|
-
# The user can choose to supply a Null pointer instead of a buffer
|
611
|
-
# in this case we don't need space in any heap buffer
|
612
|
-
if param_desc[0][0,1] == 'P' # type is a pointer
|
613
|
-
if args[param_idx] == nil
|
614
|
-
next
|
615
|
-
end
|
616
|
-
end
|
617
|
-
|
618
|
-
# we care only about out-only buffers
|
619
|
-
if param_desc[2] == "out"
|
620
|
-
raise "error in param #{param_desc[1]}: Out-only buffers must be described by a number indicating their size in bytes " unless args[param_idx].class == Fixnum
|
621
|
-
buffer_size = args[param_idx]
|
622
|
-
if param_desc[0] == "PDWORD"
|
623
|
-
raise "Please pass 4 for 'out' PDWORDS, since they require a buffer of size 4" unless buffer_size == 4
|
624
|
-
end
|
625
|
-
|
626
|
-
out_only_layout[param_desc[1]] = BufferItem.new(param_idx, out_only_size_bytes, buffer_size, param_desc[0])
|
627
|
-
out_only_size_bytes += buffer_size
|
628
|
-
end
|
629
|
-
end
|
630
|
-
|
631
|
-
tmp = assemble_buffer("in", function, args)
|
632
|
-
in_only_layout = tmp[0]
|
633
|
-
in_only_buffer = tmp[1]
|
634
|
-
|
635
|
-
tmp = assemble_buffer("inout", function, args)
|
636
|
-
inout_layout = tmp[0]
|
637
|
-
inout_buffer = tmp[1]
|
638
|
-
|
639
|
-
|
640
|
-
# now we build the stack
|
641
|
-
# every stack dword will be described by two dwords:
|
642
|
-
# first dword describes second dword:
|
643
|
-
# 0 - literal,
|
644
|
-
# 1 = relative to in-only buffer
|
645
|
-
# 2 = relative to out-only buffer
|
646
|
-
# 3 = relative to inout buffer
|
647
|
-
|
648
|
-
# (literal numbers and pointers to buffers we have created)
|
649
|
-
literal_pairs_blob = ""
|
650
|
-
#puts " assembling literal stack"
|
651
|
-
function.params.each_with_index do |param_desc, param_idx|
|
652
|
-
#puts " processing (#{param_desc[0]}, #{param_desc[1]}, #{param_desc[2]})"
|
653
|
-
buffer = nil
|
654
|
-
# is it a pointer to a buffer on our stack
|
655
|
-
if ["PDWORD", "PWCHAR", "PCHAR", "PBLOB"].include? param_desc[0]
|
656
|
-
#puts " pointer"
|
657
|
-
if args[param_idx] == nil # null pointer?
|
658
|
-
buffer = [0].pack('V') # type: DWORD (so the dll does not rebase it)
|
659
|
-
buffer += [0].pack('V') # value: 0
|
660
|
-
elsif param_desc[2] == "in"
|
661
|
-
buffer = [1].pack('V')
|
662
|
-
buffer += [in_only_layout[param_desc[1]].addr].pack('V')
|
663
|
-
elsif param_desc[2] == "out"
|
664
|
-
buffer = [2].pack('V')
|
665
|
-
buffer += [out_only_layout[param_desc[1]].addr].pack('V')
|
666
|
-
elsif param_desc[2] == "inout"
|
667
|
-
buffer = [3].pack('V')
|
668
|
-
buffer += [inout_layout[param_desc[1]].addr].pack('V')
|
669
|
-
else
|
670
|
-
raise "unexpected direction"
|
671
|
-
end
|
672
|
-
else
|
673
|
-
#puts " not a pointer"
|
674
|
-
# it's not a pointer
|
675
|
-
buffer = [0].pack('V')
|
676
|
-
case param_desc[0]
|
677
|
-
when "DWORD"
|
678
|
-
dw = param_to_dword(args[param_idx])
|
679
|
-
buffer += [dw].pack('V')
|
680
|
-
when "WORD"
|
681
|
-
dw = param_to_dword(args[param_idx])
|
682
|
-
buffer += [dw % 65536].pack('V')
|
683
|
-
when "BYTE"
|
684
|
-
dw = param_to_dword(args[param_idx])
|
685
|
-
buffer += [dw % 256].pack('V')
|
686
|
-
when "BOOL"
|
687
|
-
case args[param_idx]
|
688
|
-
when true
|
689
|
-
buffer += [1].pack('V')
|
690
|
-
when false
|
691
|
-
buffer += [0].pack('V')
|
692
|
-
else
|
693
|
-
raise "param #{param_desc[1]}: true or false expected"
|
694
|
-
end
|
695
|
-
else
|
696
|
-
raise "unexpected type for param #{param_desc[1]}"
|
697
|
-
end
|
698
|
-
end
|
699
|
-
|
700
|
-
#puts " adding pair to blob"
|
701
|
-
literal_pairs_blob += buffer
|
702
|
-
#puts " buffer size %X" % buffer.length
|
703
|
-
#puts " blob size so far: %X" % literal_pairs_blob.length
|
704
|
-
end
|
705
|
-
|
706
|
-
#puts "\n\nsending Stuff to meterpreter"
|
707
|
-
|
708
|
-
group = Rex::Post::Meterpreter::GroupTlv.new(TLV_TYPE_RAILGUN_MULTI_GROUP)
|
709
|
-
group.add_tlv(TLV_TYPE_RAILGUN_SIZE_OUT, out_only_size_bytes)
|
710
|
-
group.add_tlv(TLV_TYPE_RAILGUN_STACKBLOB, literal_pairs_blob)
|
711
|
-
group.add_tlv(TLV_TYPE_RAILGUN_BUFFERBLOB_IN, in_only_buffer)
|
712
|
-
group.add_tlv(TLV_TYPE_RAILGUN_BUFFERBLOB_INOUT, inout_buffer)
|
713
|
-
group.add_tlv(TLV_TYPE_RAILGUN_DLLNAME, dll_name )
|
714
|
-
group.add_tlv(TLV_TYPE_RAILGUN_FUNCNAME, function.windows_name)
|
715
|
-
request.tlvs << group
|
716
|
-
|
717
|
-
layouts << [inout_layout, out_only_layout]
|
718
|
-
end
|
719
|
-
|
720
|
-
call_results = []
|
721
|
-
res = @client.send_request(request)
|
722
|
-
res.each(TLV_TYPE_RAILGUN_MULTI_GROUP) do |val|
|
723
|
-
call_results << val
|
724
|
-
end
|
725
|
-
|
726
|
-
functions.each do |f|
|
727
|
-
dll_name,funcname,args = f
|
728
|
-
dll_host = @dll[dll_name]
|
729
|
-
function = dll_host.functions[funcname]
|
730
|
-
response = call_results.shift
|
731
|
-
inout_layout, out_only_layout = layouts.shift
|
732
|
-
|
733
|
-
rec_inout_buffers = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_BUFFERBLOB_INOUT)
|
734
|
-
rec_out_only_buffers = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_BUFFERBLOB_OUT)
|
735
|
-
rec_return_value = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_RET)
|
736
|
-
rec_last_error = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_ERR)
|
737
|
-
|
738
|
-
# The hash the function returns
|
739
|
-
return_hash={"GetLastError" => rec_last_error}
|
740
|
-
|
741
|
-
#process return value
|
742
|
-
case function.return_type
|
743
|
-
when "DWORD"
|
744
|
-
return_hash["return"] = rec_return_value
|
745
|
-
when "WORD"
|
746
|
-
return_hash["return"] = rec_return_value % 65536
|
747
|
-
when "BYTE"
|
748
|
-
return_hash["return"] = rec_return_value % 256
|
749
|
-
when "BOOL"
|
750
|
-
return_hash["return"] = (rec_return_value != 0)
|
751
|
-
when "VOID"
|
752
|
-
return_hash["return"] = nil
|
753
|
-
else
|
754
|
-
raise "unexpected return type: #{function.return_type}"
|
755
|
-
end
|
756
|
-
#puts return_hash
|
757
|
-
#puts "out_only_layout:"
|
758
|
-
#puts out_only_layout
|
759
|
-
|
760
|
-
|
761
|
-
# process out-only buffers
|
762
|
-
#puts "processing out-only buffers:"
|
763
|
-
out_only_layout.each_pair do |param_name, buffer_item|
|
764
|
-
#puts " #{param_name}"
|
765
|
-
buffer = rec_out_only_buffers[buffer_item.addr, buffer_item.length_in_bytes]
|
766
|
-
case buffer_item.datatype
|
767
|
-
when "PDWORD"
|
768
|
-
return_hash[param_name] = buffer.unpack('V')[0]
|
769
|
-
when "PCHAR"
|
770
|
-
return_hash[param_name] = asciiz_to_str(buffer)
|
771
|
-
when "PWCHAR"
|
772
|
-
return_hash[param_name] = uniz_to_str(buffer)
|
773
|
-
when "PBLOB"
|
774
|
-
return_hash[param_name] = buffer
|
775
|
-
else
|
776
|
-
raise "unexpected type in out-only buffer of #{param_name}: #{buffer_item.datatype}"
|
777
|
-
end
|
778
|
-
end
|
779
|
-
#puts return_hash
|
780
|
-
|
781
|
-
# process in-out buffers
|
782
|
-
#puts "processing in-out buffers:"
|
783
|
-
inout_layout.each_pair do |param_name, buffer_item|
|
784
|
-
#puts " #{param_name}"
|
785
|
-
buffer = rec_inout_buffers[buffer_item.addr, buffer_item.length_in_bytes]
|
786
|
-
case buffer_item.datatype
|
787
|
-
when "PDWORD"
|
788
|
-
return_hash[param_name] = buffer.unpack('V')[0]
|
789
|
-
when "PCHAR"
|
790
|
-
return_hash[param_name] = asciiz_to_str(buffer)
|
791
|
-
when "PWCHAR"
|
792
|
-
return_hash[param_name] = uniz_to_str(buffer)
|
793
|
-
when "PBLOB"
|
794
|
-
return_hash[param_name] = buffer
|
795
|
-
else
|
796
|
-
raise "unexpected type in in-out-buffer of #{param_name}: #{buffer_item.datatype}"
|
797
|
-
end
|
798
|
-
end
|
799
|
-
#puts return_hash
|
800
|
-
#puts "finished"
|
801
|
-
|
802
|
-
function_results << return_hash
|
803
|
-
end
|
804
|
-
function_results
|
805
|
-
end
|
806
|
-
# process_multi_function_call
|
807
|
-
end # MultiCall
|
808
|
-
end
|
809
|
-
|
810
|
-
end
|
811
|
-
end
|
812
|
-
end
|
813
|
-
end
|
814
|
-
end
|
815
|
-
|