Ashupup / BOFs

Collection of Beacon Object Files

Beacon Object Files

Name	Syntax
ETW Patching	etw stop / etw start
API Function Utility	read_function / check_function / patch_function <dll_path> <function_name>
Syscalls Shellcode Injection	syscalls_inject <PID> <listener_name> / syscalls_shinject <PID> <path_to_bin>
Spawn and Syscalls Shellcode Injection	syscalls_spawn <listener> / syscalls_shspawn <path_to_bin>
Spawn and Static Syscalls Shellcode Injection (NtQueueApcThread)	static_syscalls_apc_spawn <listener> / static_syscalls_apc_spawn <path_to_bin>
Static Syscalls Shellcode Injection (NtCreateThreadEx)	static_syscalls_inject <PID> <listener_name> / static_syscalls_shinject <PID> <path_to_bin>
Static Syscalls Process Dump	static_syscalls_dump <PID> [path_to_output]
Curl	curl host [port] [method] [--show] [useragent] [headers] [body]

ETW Patching BOF

Simple Beacon object file to patch (and revert) the EtwEventWrite function in ntdll.dll to degrade ETW based logging.

All credit goes to @xpn: https://www.mdsec.co.uk/2020/03/hiding-your-net-etw/.

API Function Utility BOF

Beacon object file to:

• Read bytes of loaded module API function
• Read relevant on-disk DLL and compare functions to identify differencies (e.g. EPP/EDR hooking)
• Patch functions with the on-disk copy (i.e. API unhooking)

Credit goes to @spotheplanet for the Dll parsing technique: https://www.ired.team/offensive-security/defense-evasion/retrieving-ntdll-syscall-stubs-at-run-time

Syscalls Shellcode Injection BOF (64-bit only)

Beacon object file to:

• Fetch Syscall Stubs from on-disk ntdll.dll (All credit to @odzhan - https://github.com/odzhan/injection/blob/master/syscalls/inject_dll.c)
• Inject shellcode (either custom or beacon) into remote process using NtOpenProcess -> NtAllocateVirtualMemory -> NtWriteVirtualMemory -> NtCreateThreadEx.

Credit also to @tomcarver16 for their DLL inject BOF and aggressor script (https://github.com/tomcarver16/BOF-DLL-Inject)

Spawn with Syscalls Shellcode Injection BOF (64-bit only)

Same syscalls injection process as SyscallsInject (above) but uses BeaconSpawnTemporaryProcess to create the target process.

Spawn with Syscalls Shellcode Injection (NtMapViewOfSection -> NtQueueApcThread) BOF (64-bit only)

NtCreateSection -> NtMapViewOfSection -> NtQueueApcThread -> NtResumeThead. Uses BeaconSpawnTemporaryProcess to create the target process.

Syscalls generated using @jthuraisamy's SysWhispers2, @FalconForce's SysWhispers2BOF and @Outflanknl's InlineWhispers.

Code adapted from @peperunas's injectopi

Static Syscalls Shellcode Injection BOF (64-bit only)

Beacon object file to:

• Inject shellcode (either custom or beacon) into remote process using NtOpenProcess -> NtAllocateVirtualMemory -> NtWriteVirtualMemory -> NtCreateThreadEx.

Same injection process as above, but using static Syscalls, rather than stubs fetched from Ntdll.

Syscalls generated using @jthuraisamy's SysWhispers2, @FalconForce's SysWhispers2BOF and @Outflanknl's InlineWhispers.

Static Syscalls Process Dump BOF (64-bit only)

Beacon object file to:

• Unhook NtReadVirtualMemory function.
• Create process memory dump using MiniDumpWriteDump function to specified (or default) location

Syscalls generated using @jthuraisamy's SysWhispers2, @FalconForce's SysWhispers2BOF and @Outflanknl's InlineWhispers.

This is effectively a rough port of @Outflank's Dumpert tool. All credit to them for that.

Simple Web Utility BOF (Curl)

Beacon object file and associated aggressor to make simple web requests without establishing SOCKS PROXY. Example use case could be confirming outbound access to specific service before deploying a relay from F-Secure's C3.