flawopen.com/Teardowns/CVE-2024-32002

CVE-2024-32002: Git Submodule Symlink RCE

Critical 9.8 CWE-78 / CWE-59 Git < 2.45.1

Languages: en pt-br es fr de ru zh-cn ja hi ko id

通俗解释 —— 办公室的误导性指示牌

想象一位快递员要将内部包裹送到“101房间”。攻击者在101门上挂了一个指示牌：“101房间已临时搬至总裁保险库”。快递员不加核实，盲目顺着指示牌将包裹放进了保险库。在 Git 中，快递员就是子模块克隆程序，误导性指示牌是一个符号链接（symlink），而保险库就是 Git 的隐藏目录 .git/hooks/，存放在这里的钩子脚本会在特定操作时被自动执行。

Target: Git core CLI

Vector: git clone --recursive <url>

Impact: Remote Code Execution (RCE)

Platform: macOS & Windows (Case-Insensitive Filesystems)

致命的 Git 源码补丁 Diff

在 builtin/submodule--helper.c 和 dir.c 中，Git 在初始化子模块工作区时，未验证克隆路径中的父目录组件是否存在指向外部的符号链接。

builtin/submodule--helper.c (Vulnerable)Vulnerable

// Git clone created submodule directory blindly
static int clone_submodule(const struct module_clone_data *clone_data)
{
    struct strbuf sb = STRBUF_INIT;

    // BUG: clone_data->path could traverse an existing symlink
    strbuf_addf(&sb, "%s", clone_data->path);
    safe_create_leading_directories(sb.buf);
    return do_clone(clone_data);
}

builtin/submodule--helper.c (Fixed)Patched

// Fixed: Refuse to clone into or through symlinked path components
static int clone_submodule(const struct module_clone_data *clone_data)
{
    struct strbuf sb = STRBUF_INIT;

    // FIX: Validate that no parent component is a symlink
    if (path_has_symlinks(clone_data->path))
        die(_("fatal: submodule path '%s' contains a symlink"),
            clone_data->path);

    strbuf_addf(&sb, "%s", clone_data->path);
    return do_clone(clone_data);
}

三步漏洞利用链

11. 伪造符号链接：攻击者在仓库中包含一个名为 sub 的符号链接，指向内部元数据目录 .git/modules/sub。
22. Windows与macOS的大小写碰撞：在大小写不敏感的文件系统（NTFS与APFS）上，当 Git 随后克隆名为 SUB/hooks 的子模块时，操作系统将路径自动解析到符号链接指向的目标位置。
33. 自动触发任意代码执行：攻击者精心编写的恶意脚本被写入 post-checkout 钩子，Git 在克隆完成时立即自动执行该脚本。

面向开发者的核心安全启示

✓绝不可假设文件系统严格区分大小写： 在 Windows 和 macOS 上，Path/A 与 path/a 在底层指向同一物理文件。
✓路径拼接前必须逐级检查符号链接： 简单的字符串拼接路径极易被符号链接劫持，务必通过 lstat 或安全 API 校验中间路径。
✓对配置与元数据目录建立绝对隔离： Git 通过严格禁止子模块路径穿越符号链接，彻底封堵了对 .git/ 目录的非法写入。

Explore more vulnerability mechanisms & language matrices: Command Injection Matrix →