/BOFs

Collection of Beacon Object Files

Primary LanguageC++

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:

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 SysWhispers 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 SysWhispers 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 SysWhispers 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.