AsmHalosGate 项目下载及安装教程

1. 项目介绍

AsmHalosGate 是一个用于绕过 EDR（Endpoint Detection and Response）用户态钩子的 x64 汇编实现项目。该项目通过直接调用 Windows 系统调用，避免了执行 NTDLL.DLL 中的代码，从而绕过了 EDR 的用户态钩子。项目的主要功能包括解析系统调用地址、绕过 EDR 钩子以及显示 explorer.exe 进程的 PPID。

2. 项目下载位置

要下载 AsmHalosGate 项目，请按照以下步骤操作：

1. 打开命令行终端（如 Windows 的命令提示符或 PowerShell）。
2. 使用 git clone 命令下载项目：

git clone https://github.com/boku7/AsmHalosGate.git

3. 项目安装环境配置

在安装 AsmHalosGate 项目之前，需要确保您的开发环境已正确配置。以下是所需的软件和工具：

• Visual Studio（推荐使用 Visual Studio 2019 或更高版本）
• Windows SDK（确保已安装与 Visual Studio 兼容的 Windows SDK 版本）
• MASM（Microsoft 汇编器，通常随 Visual Studio 一起安装）

环境配置示例

4. 项目安装方式

1. 打开项目：

   • 打开 Visual Studio。
   • 选择“打开项目或解决方案”，然后导航到您下载的 AsmHalosGate 项目目录，选择 bcookesHalosGate.sln 文件。

2. 配置项目属性：

   • 在解决方案资源管理器中，右键点击项目名称，选择“属性”。
   • 在“配置属性”中，确保“平台工具集”设置为与您的 Visual Studio 版本匹配的工具集。
   • 在“生成事件”中，确保“预生成事件”和“生成后事件”没有错误。

3. 生成项目：

   • 在 Visual Studio 中，选择“生成”菜单，然后点击“生成解决方案”。
   • 如果一切配置正确，项目将成功编译并生成可执行文件。

5. 项目处理脚本

AsmHalosGate 项目包含多个汇编文件和 C 文件，用于实现绕过 EDR 钩子的功能。以下是项目中的一些关键文件：

• bcookesHalosGate.asm：主要汇编文件，包含绕过 EDR 钩子的核心逻辑。
• main.c：C 语言文件，用于调用汇编代码并实现系统调用。
• bcookesHalosGate.sln：Visual Studio 解决方案文件，用于管理和编译项目。

处理脚本示例

; bcookesHalosGate.asm
.code
main proc
    ; 汇编代码逻辑
    ; ...
    ret
main endp
end

// main.c
#include <stdio.h>
extern void main();

int main(int argc, char* argv[]) {
    main();
    return 0;
}

通过以上步骤，您可以成功下载、配置并安装 AsmHalosGate 项目，并了解项目的关键文件和处理脚本。