update github action build for exe and BOFs

Author: Ap3x

.github/workflows/build.yml

@@ -0,0 +1,46 @@
+name: Build BOFs
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  release:
+    name: Release (Object Files)
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure CMake
+        run: cmake -B build -G "Visual Studio 17 2022" -A x64
+
+      - name: Build BOFs
+        run: cmake --build build --config Release
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: BOFs-Release
+          path: build/bofs/*.obj
+
+  debug:
+    name: Debug (Executables)
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure CMake
+        run: cmake -B build -G "Visual Studio 17 2022" -A x64 -DBUILD_DEBUG_EXES=ON
+
+      - name: Build Debug Executables
+        run: cmake --build build --config Debug --target WhoAmI_debug EnumDeviceDrivers_debug GetSystemDirectory_debug Ipconfig_debug FileExfiltrationUrlEncoded_debug RegistryPersistence_debug TimeStomp_debug
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: BOFs-Debug
+          path: build/debug/Debug/*.exe

CMakeLists.txt

@@ -1,5 +1,9 @@
 cmake_minimum_required(VERSION 3.20)
 
+if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR)
+    project(BeaconObjectFileLibrary LANGUAGES CXX)
+endif()
+
 set(BOF_INCLUDE_DIRS ${CMAKE_CURRENT_SOURCE_DIR}/Core ${CMAKE_CURRENT_SOURCE_DIR}/Core/base)
 set(BOF_OUTPUT_DIR ${CMAKE_BINARY_DIR}/bofs)
 
@@ -15,6 +19,7 @@ set(BOF_TARGETS
     TimeStomp
 )
 
+# Release: compile-only BOF object files
 set(BOF_COPY_COMMANDS)
 
 foreach(BOF_NAME ${BOF_TARGETS})
@@ -27,9 +32,31 @@ foreach(BOF_NAME ${BOF_TARGETS})
     )
 endforeach()
 
-# Convenience target to build all BOFs and copy them
 add_custom_target(bofs ALL
     ${BOF_COPY_COMMANDS}
     DEPENDS ${BOF_TARGETS}
     COMMENT "Copying BOF object files to ${BOF_OUTPUT_DIR}"
 )
+
+# Debug: standalone executables with mocked Beacon APIs
+option(BUILD_DEBUG_EXES "Build debug executables for BOFs" OFF)
+
+if(BUILD_DEBUG_EXES)
+    set(MOCK_SOURCES
+        ${CMAKE_CURRENT_SOURCE_DIR}/Core/base/mock.cpp
+    )
+
+    foreach(BOF_NAME ${BOF_TARGETS})
+        add_executable(${BOF_NAME}_debug
+            ${CMAKE_CURRENT_SOURCE_DIR}/${BOF_NAME}/bof.cpp
+            ${MOCK_SOURCES}
+        )
+        target_include_directories(${BOF_NAME}_debug PRIVATE ${BOF_INCLUDE_DIRS})
+        target_compile_definitions(${BOF_NAME}_debug PRIVATE _DEBUG)
+        target_compile_options(${BOF_NAME}_debug PRIVATE /EHsc /std:c++20)
+        set_target_properties(${BOF_NAME}_debug PROPERTIES
+            OUTPUT_NAME ${BOF_NAME}
+            RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/debug
+        )
+    endforeach()
+endif()

README.md

@@ -2,17 +2,21 @@
 
 A library of Beacon Object Files (BOFs) for Cobalt Strike. This solution uses a modified version of [Cobalt Strike/bof-vs](https://github.com/Cobalt-Strike/bof-vs) to support multiple BOF projects, unit testing, and debug builds within a single Visual Studio solution.
 
+## Download
+
+Pre-built BOF object files are available from the latest [GitHub Actions run](https://github.com/Ap3x/Beacon-Object-File-Library/actions). Go to the most recent successful run and download the `BOFs` artifact.
+
 ## BOFs
 
-| Project | Description |
-|---------|-------------|
-| EnumDeviceDrivers | Enumerates all loaded device drivers |
-| FileExfiltrationUrlEncoded | Exfiltrates a file via chunked URL-encoded GET requests |
-| GetSystemDirectory | Retrieves the Windows system directory path |
-| Ipconfig | Displays network adapter IP, subnet mask, and gateway |
-| RegistryPersistence | Installs or removes a Run key for persistence |
-| TimeStomp | Copies file timestamps from one file to another |
-| WhoAmI | Returns the current username |
+| Project | Description | Download |
+|---------|-------------|----------|
+| EnumDeviceDrivers | Enumerates all loaded device drivers | [Latest](https://github.com/Ap3x/Beacon-Object-File-Library/actions) |
+| FileExfiltrationUrlEncoded | Exfiltrates a file via chunked URL-encoded GET requests | [Latest](https://github.com/Ap3x/Beacon-Object-File-Library/actions) |
+| GetSystemDirectory | Retrieves the Windows system directory path | [Latest](https://github.com/Ap3x/Beacon-Object-File-Library/actions) |
+| Ipconfig | Displays network adapter IP, subnet mask, and gateway | [Latest](https://github.com/Ap3x/Beacon-Object-File-Library/actions) |
+| RegistryPersistence | Installs or removes a Run key for persistence | [Latest](https://github.com/Ap3x/Beacon-Object-File-Library/actions) |
+| TimeStomp | Copies file timestamps from one file to another | [Latest](https://github.com/Ap3x/Beacon-Object-File-Library/actions) |
+| WhoAmI | Returns the current username | [Latest](https://github.com/Ap3x/Beacon-Object-File-Library/actions) |
 
 ## Build Configurations