Skip to content

TGJLS/BOF-Collection

Repository files navigation

BOF-Collection

An AdaptixC2-compatible BOF collection for filesystem and process-control operations executed inside the beacon process.

Installation

# Ubuntu/Kali
apt install gcc-mingw-w64-x86-64-posix gcc-mingw-w64-i686 mingw-w64-tools

# Arch
pacman -Syu mingw-w64-gcc

Building modules via make:

git clone https://github.com/TheGr3atJosh/BOF-Collection
cd BOF-Collection
make

A Docker-based build is also available for systems where installing mingw-w64 directly is inconvenient (e.g. macOS):

docker compose build && docker compose run --rm bof-build

Load all modules in AdaptixC2 client: Main menuAxScriptScript manager, then Context menuLoad new and select the bof-collection.axs file.

To auto-load on server start, add to your AdaptixC2 profile.yaml under Teamserver:

axscripts:
  - "BOF-Collection/bof-collection.axs"  # path relative to the server working directory

Modules

FS-BOF

Filesystem operations: type, mkdir, copy, move, del, rmdir, pwd, cd. More details

Commands Usage Notes
type type <file> Display contents of a file to beacon output
mkdir mkdir <directory> Create a directory and all intermediate directories
move move <source> <destination> Move or rename files; supports wildcards and UNC paths; file-only, directories skipped
del del <target> Delete files; supports wildcards; file-only, directories skipped
copy copy <source> <destination> Copy files; supports wildcards and UNC paths; file-only, directories skipped
pwd pwd Print the beacon's current working directory
cd cd <directory> Change working directory; supports relative paths and UNC paths
rmdir rmdir <directory> Remove an empty directory; supports UNC paths

Exit-BOF

Terminate the beacon process or thread. More details

Commands Usage Notes
exit process exit process Terminate beacon process via RtlExitUserProcess(0). Terminal.
exit thread exit thread Terminate beacon thread via RtlExitUserThread(0). Terminal.

PS-BOF

Process management: ps list, ps kill, ps run, ps grep, ps suspend, ps resume. More details

Commands Usage Notes
ps list ps list List all running processes (PID, PPID, session, owner, arch)
ps kill ps kill <PID> [exit_code] Terminate a process; optional exit code
ps run ps run --command <cmd> [--pipe] [--ppid <PID>] [--state suspended] [--domain <domain> --username <user> --password <pass>] [--token <handle>] Launch a process (CreateProcess/WithLogon/WithToken); optional PPID spoofing and pipe capture
ps grep ps grep <PID> Inspect a process: token, modules, cmdline, threads
ps suspend ps suspend <PID> Suspend a process
ps resume ps resume <PID> Resume a suspended process

TK-BOF

Token management: steal, use, make, rm, revert, privget. More details

Commands Usage Notes
steal tk steal <pid> Duplicate a process token; optionally skip impersonation with --no-apply
use tk use <token_handle> Impersonate a previously obtained token handle
make tk make <username> <password> Create a token via LogonUserW; supports --domain, --logon-type, --no-apply
rm tk rm <token_handle> Close a token handle and free the kernel object
revert tk revert Drop impersonation and revert to process token
privget tk privget Enable all privileges on the current token

Credits

  • Extension-Kit: Project structure and README
  • Kharon: PS-BOF and TK-BOF command implementations

About

A collection of Beacon Object Files (BOFs) for use with AdaptixC2

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors