GHSA-PMM9-4H7Q-24C8
`gix_worktree_state::checkout()` sigue un enlace simbólico terminal existente en Windows durante la materialización no exclusiva (incremental)
CVSS:3.1/AV:N/AC:H/PR:N/UI:R/S:U/C:N/I:H/A:N
Fuente: GitHub
Ciclo de vida de la vulnerabilidad
| Fecha | Fase | Evento | Detalle |
|---|---|---|---|
| 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 |
`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.
Desglose de métricas
Rangos afectados
Estado del parche por paquete
| Paquete / producto | Estado | Corregida en | Desde 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 |
0.33.00.55.00.86.0Arsenal público
Sin exploits, módulos ni PoC públicos conocidos a la fecha de verificación.
https://github.com/GitoxideLabs/gitoxide/security/advisories/GHSA-pmm9-4h7q-24c8Las referencias externas se muestran para copiar: cve.llama.ec no lo redirige a otros sitios.
