llamaCVEVulnerability Intelligence
/
Advisory · GitHub · crates.io · gix-worktree-state

GHSA-PMM9-4H7Q-24C8

`gix_worktree_state::checkout()` sigue un enlace simbólico terminal existente en Windows durante la materialización no exclusiva (incremental)

Parche disponible
Descargar PNG JSON
CVSS 3.1
5.3
Media
CVSS:3.1/AV:N/AC:H/PR:N/UI:R/S:U/C:N/I:H/A:N Fuente: GitHub
ExplotaciónSin evidenciaNo figura en CISA KEV
Exploits públicos0Ninguno conocido
Parche3 versionesPrimer parche a -10 d de la divulgación
Exposición111 dDesde la divulgación, 2 ago 2026, 3:30 a. m.
Detección108 dDesde la divulgación hasta su ingreso al índice
Decisión estimadaSeguir
Remediar en la ventana regular de mantenimiento
Estimación de Llama con el árbol SSVC de CISA a partir de vector CVSS 3.1 y la evidencia de explotación (sin evaluación oficial): sin explotación conocida, no automatizable e impacto técnico parcial. Hay versiones corregidas disponibles.
Hoy toca mantenimiento, no heroísmo.Revisa, agenda, parchea. El clásico de siempre.
Timeline

Ciclo de vida de la vulnerabilidad

Hoy
Divulgación
Publicada
Modificada
Explotación
Remediación
Parche 0.33.0 +2
Monitoreo
Detectada +1
23 jul 26
2 ago 26
12 nov 26
18 nov 26
21 nov 26
23 jul 26
22 ago 26
22 sept 26
22 oct 26
21 nov 26
FechaFaseEventoDetalle
Remediación Parche 0.33.0 gix-worktree-state · -10 d desde divulgación
Remediación Parche 0.55.0 gix-worktree · -10 d desde divulgación
Remediación Parche 0.86.0 gix · -10 d desde divulgación
Divulgación Publicada GHSA-PMM9-4H7Q-24C8 divulgada · CVSS 5.3 (GitHub)
Divulgación Modificada Última actualización del registro
Monitoreo Detectada Ingresó al índice
Monitoreo Verificada Última verificación contra las fuentes
Resumen
Traducción automática · Ver original
Descripción del advisory
Traducción automática · GitHub

`gix-worktree-state::checkout()` sigue un enlace simbólico terminal existente en Windows durante la materialización no exclusiva (incremental)

Tipo: Seguridad — recorrido de rutas / escritura arbitraria de archivos fuera del worktree (CWE-59: Resolución inapropiada de enlaces antes del acceso a archivos, «Link Following»)
Componente: `gix_worktree_state::checkout()` — el punto de entrada de bajo nivel real, público y sin modificar (reexportación en la raíz del crate `gix-worktree-state`), accesible mediante el crate paraguas `gix` a través de su builder documentado `Repository::checkout_options()`. Los problemas que contribuyen se encuentran en `gix-worktree-state`, `gix-worktree` y `gix-features`.
Afecta a: cualquier consumidor de `gix_worktree_state::checkout()` que lo invoque con `destination_is_initially_empty: false` (el valor predeterminado devuelto por el propio `Repository::checkout_options()`; ver Alcanzabilidad) en Windows, siempre que `core.symlinks` resuelva a `true` (el valor que lee `fs_capabilities()` cuando la clave no está definida, y el que registra la sonda de sistema de archivos de `gix::init()` cuando el SO o el usuario pueden crear enlaces simbólicos: Modo de desarrollador, administrador, `SeCreateSymbolicLinkPrivilege`).
Confirmado presente en: commit `5e75997fd429365518b42f4aef9c75f50e348593` de `main` de git (2026-07-22T13:23:12Z), prácticamente el HEAD actual (`2315ede7`, ~1 h después; no cambió ningún archivo relevante en ese intervalo, verificado mediante el historial de commits de los tres archivos afectados). También presente en las versiones publicadas en crates.io: `gix-worktree-state` 0.32.0, `gix-worktree` 0.54.0, `gix-features` 0.48.1, `gix-fs` 0.21.2 y `gix` 0.85.0 (sin cambios relevantes en las funciones afectadas desde mucho antes de estas versiones).
Crédito: Sergey Gordeychik ([scadastrangelove@gmail.com](mailto:scadastrangelove@gmail.com)), encontrado con el pipeline rust-in-peace https://github.com/scadastrangelove/rust-in-peace (investigación de vulnerabilidades en Rust asistida por IA).

Resumen

`gix_worktree_state::checkout()` — la función pública real que cualquier herramienta basada en `gix` usaría para materializar un árbol en un worktree — sigue un enlace simbólico existente en Windows cuando una llamada posterior de checkout reemplaza la misma ruta por un archivo regular, escribiendo el nuevo contenido a través del enlace y fuera del worktree.

En concreto: un índice o árbol contiene una entrada de enlace simbólico (modo `120000`) en una ruta `P`, que apunta a cualquier lugar fuera del worktree sobre el que el usuario que realiza el checkout tiene permisos de escritura. Al hacer checkout con `destination_is_initially_empty: true` (un destino nuevo o vacío) se crea un punto de reparse real del sistema de archivos en `<worktree>\P`. Una segunda llamada de checkout, con `destination_is_initially_empty: false` (un destino existente o no vacío, checkout «incremental») contra un índice o árbol que ahora tiene una entrada de archivo regular (modo `100644`) en la misma ruta `P`, sigue el punto de reparse existente en Windows y escribe el contenido del nuevo blob en la ubicación a la que apunta `P`.

Alcanzabilidad

`gix_worktree_state::checkout()` es la reexportación en la raíz del crate `gix-worktree-state` (`pub use checkout::function::checkout;`), la misma función pública que `clone::checkout.rs` de `gix` invoca para materializar un clon nuevo. `Repository::checkout_options()` (`gix/src/repository/checkout.rs`) es un método público documentado como el que devuelve «opciones que pueden usarse para dirigir una operación de checkout de bajo nivel»; es decir, el propio `gix` indica a un consumidor externo que use este punto para construir un checkout más allá del clone. Al revisar su implementación (`gix/src/config/cache/access.rs::checkout_options()`), se observa que `destination_is_initially_empty: false` es el valor literal por defecto que devuelve; quien llama obtiene la configuración incremental o no exclusiva a menos que la sobrescriba explícitamente con `true` (algo que hace exactamente `clone::checkout.rs` para su caso específico de checkout nuevo). El campo `fs.symlink` de las mismas `Options` proviene de `fs_capabilities()`, que lee `core.symlinks` de la configuración, con valor predeterminado `true` si la clave no existe; y la sonda de sistema de archivos de `gix::init()` almacena exactamente ese valor al crear el repositorio real, en línea con la autodetección de `core.symlinks` de git-for-windows.

Se enumeró cada llamada de producción a `gix_worktree_state::checkout()` en el workspace de gitoxide (búsqueda de código en GitHub):
- `gix/src/clone/checkout.rs:122`, la única llamada dentro del propio crate `gix`, establece explícitamente `opts.destination_is_initially_empty = true;` (solo para clones nuevos).
- `gitoxide-core/src/index/checkout.rs` (`checkout_exclusive`, que respalda el comando de plomería de checkout de la CLI `gix`/`ein`) también fija `true` y, de forma explícita, ejecuta `bail!` («Refusing to checkout index into existing directory») si el destino ya existe.

Ningún llamador actual en el workspace de gitoxide pasa `destination_is_initially_empty: false`; todavía no existe una función de `git pull` ni de checkout incremental o sobre un worktree existente construida sobre esta función. Sin embargo, la configuración vulnerable no es una combinación oscura que un desarrollador tenga que construir deliberadamente: es el valor que `checkout_options()` devuelve por defecto. Una aplicación que implemente pull o checkout incremental con el builder recomendado tendría que sobrescribir activamente el flag para ser segura en el caso de checkout nuevo (como hace `clone::checkout.rs`), en lugar de caer en este problema.

Declaración de impacto (la afirmación que respalda este informe): *Una aplicación que invoque `gix_worktree_state::checkout()` con `destination_is_initially_empty: false` sobre un índice cuya entrada de archivo regular colisiona con una ruta que ya contiene un enlace simbólico puede sobrescribir el destino de ese enlace, fuera del destino del checkout, en Windows, en una compilación de release, usando el valor predeterminado de la propia biblioteca.* Esto se confirma como una primitiva de la API de biblioteca mediante la API pública real y el builder de opciones basado en configuración real; no se demuestra que sea alcanzable a través de ninguna función de `git pull`, `git checkout` o CLI distribuida actualmente (ver «Lo que este informe no afirma»).

Causa raíz: tres componentes, todos necesarios

1. El componente de ruta terminal nunca se comprueba contra colisiones para entradas que no son directorios.
`gix-worktree/src/stack/delegate.rs`, `create_leading_directory()`:

fn create_leading_directory(
    is_last_component: bool,
    stack: &gix_fs::Stack,
    mode: Option<gix_index::entry::Mode>,
    mkdir_calls: &mut usize,
    unlink_on_collision: bool,
) -> std::io::Result<()> {
    if is_last_component && !crate::stack::mode_is_dir(mode).unwrap_or(false) {
        return Ok(());   // <-- no symlink/collision check at all for the LAST component
    }
    ...

Toda comprobación de ruta existente o de colisión con enlaces en esta función solo se ejecuta para los componentes de directorio intermedios de la ruta. Para el componente terminal de una entrada de archivo o de enlace simbólico, que es exactamente el caso aquí, la función retorna de inmediato y delega por completo en lo que ocurra después, cuando el archivo se abra.

2. La única red de seguridad restante es una aserción solo de depuración, y no puede dispararse en este escenario ni aun compilada. `gix-worktree-state/src/checkout/entry.rs`:

#[cfg(not(debug_assertions))]
fn debug_assert_dest_is_no_symlink(_path: &Path) {}

/// This is a debug assertion as we expect the machinery calling this to prevent this possibility in the first place
#[cfg(debug_assertions)]
fn debug_assert_dest_is_no_symlink(path: &Path) {
    if let Ok(meta) = path.metadata() {
        debug_assert!(
            !meta.file_type().is_symlink(),
            "BUG: should not ever allow to overwrite/write-into the target of a symbolic link: {}",
            path.display()
        );
    }
}

fn open_options(path: &Path, destination_is_initially_empty: bool, overwrite_existing: bool) -> std::fs::OpenOptions {
    if overwrite_existing || !destination_is_initially_empty {
        debug_assert_dest_is_no_symlink(path);   // <-- no-op in release builds
    }
    ...

La condición que activa la comprobación, `overwrite_existing || !destination_is_initially_empty`, corresponde exactamente al caso de checkout incremental. El comentario documenta la intención («esperamos que el mecanismo que llama a esta función impida esta posibilidad desde el principio»), pero (1) demuestra que ese mecanismo no la impide, y la propia aplicación de esta función es un `debug_assert!`, que no hace nada en cualquier compilación de release.

Incluso en una compilación de depuración, esta comprobación no puede dispararse en el escenario de este informe: llama a `path.metadata()`, que sigue los enlaces simbólicos (a diferencia de `path.symlink_metadata()`, que no los sigue). En un enlace que apunta a un destino *existente*, que es exactamente este ataque, `metadata()` resuelve a través del enlace y devuelve el tipo de archivo del destino (no simbólico), por lo que `meta.file_type().is_symlink()` es `false` y la aserción se cumple de forma trivial. Verificado empíricamente, no solo a partir del código fuente: el PoC `e2e2` (abajo) vuelve a ejecutar de forma independiente la misma comprobación `path.metadata().is_symlink()` en compilaciones de release y de depuración con perfil de depuración en Windows, e imprime el resultado: `false` en ambas.

*

Incluye detalles técnicos publicados por el investigador. Úselos solo para validar y corregir sus propios sistemas.

Vector CVSS 3.1

Desglose de métricas

Opción resaltada = valor del vector · izquierda = peor caso · GitHub
Vector de ataqueAV:N
RedAdyacenteLocalFísica
ComplejidadAC:H
BajaAlta
PrivilegiosPR:N
NingunoBajosAltos
InteracciónUI:R
NingunaRequerida
AlcanceS:U
CambiadoSin cambio
ConfidencialidadC:N
AltoBajoNinguno
IntegridadI:H
AltoBajoNinguno
DisponibilidadA:N
AltoBajoNinguno
Score de explotaciónQué tan fácil y probable es que la exploten
5.9/ 10Medio
Vector 5.9 (moderada) · sin evidencia de explotación.
Versiones

Rangos afectados

Afectada Corregida Última
gix-worktree-state≤ 0.32.0
gix-worktree≤ 0.54.0
gix≤ 0.85.0
0.32.0
0.37.0
0.54.0
0.59.0
0.85.0
0.90.0
Remediación

Estado del parche por paquete

Paquete / productoEstadoCorregida enDesde divulgaciónÚltima versión
crates.iogix-worktree-state
Corregida 0.33.0 -10 d 0.37.0 no afectada
crates.iogix-worktree
Corregida 0.55.0 -10 d 0.59.0 no afectada
crates.iogix
Corregida 0.86.0 -10 d 0.90.0 no afectada
Versiones corregidas0.33.00.55.00.86.0
Explotación

Arsenal público

Sin exploits, módulos ni PoC públicos conocidos a la fecha de verificación.

Referencias
Advisoryhttps://github.com/GitoxideLabs/gitoxide/security/advisories/GHSA-pmm9-4h7q-24c8

Las referencias externas se muestran para copiar: cve.llama.ec no lo redirige a otros sitios.