VYPR
Medium severityGHSA Advisory· Published Sep 24, 2025· Updated Apr 15, 2026

CVE-2025-8869

CVE-2025-8869

Description

When extracting a tar archive pip may not check symbolic links point into the extraction directory if the tarfile module doesn't implement PEP 706. Note that upgrading pip to a "fixed" version for this vulnerability doesn't fix all known vulnerabilities that are remediated by using a Python version that implements PEP 706.

Note that this is a vulnerability in pip's fallback implementation of tar extraction for Python versions that don't implement PEP 706 and therefore are not secure to all vulnerabilities in the Python 'tarfile' module. If you're using a Python version that implements PEP 706 then pip doesn't use the "vulnerable" fallback code.

Mitigations include upgrading to a version of pip that includes the fix, upgrading to a Python version that implements PEP 706 (Python >=3.9.17, >=3.10.12, >=3.11.4, or >=3.12), applying the linked patch, or inspecting source distributions (sdists) before installation as is already a best-practice.

Affected packages

Versions sourced from the GitHub Security Advisory.

PackageAffected versionsPatched versions
pipPyPI
< 25.325.3

Affected products

1

Patches

1
f2b92314da01

Merge pull request #13550 from dkjsone/handle_symlink

https://github.com/pypa/pipDamian ShawSep 24, 2025via ghsa
3 files changed · +170 0
  • news/13550.bugfix.rst+2 0 added
    @@ -0,0 +1,2 @@
    +For Python versions that do not support PEP 706, pip will now raise an installation error for a
    +source distribution when it includes a symlink that points outside the source distribution archive.
    
  • src/pip/_internal/utils/unpacking.py+25 0 modified
    @@ -248,13 +248,30 @@ def pip_filter(member: tarfile.TarInfo, path: str) -> tarfile.TarInfo:
             tar.close()
     
     
    +def is_symlink_target_in_tar(tar: tarfile.TarFile, tarinfo: tarfile.TarInfo) -> bool:
    +    """Check if the file pointed to by the symbolic link is in the tar archive"""
    +    linkname = os.path.join(os.path.dirname(tarinfo.name), tarinfo.linkname)
    +
    +    linkname = os.path.normpath(linkname)
    +    linkname = linkname.replace("\\", "/")
    +
    +    try:
    +        tar.getmember(linkname)
    +        return True
    +    except KeyError:
    +        return False
    +
    +
     def _untar_without_filter(
         filename: str,
         location: str,
         tar: tarfile.TarFile,
         leading: bool,
     ) -> None:
         """Fallback for Python without tarfile.data_filter"""
    +    # NOTE: This function can be removed once pip requires CPython ≥ 3.12.​
    +    # PEP 706 added tarfile.data_filter, made tarfile extraction operations more secure.
    +    # This feature is fully supported from CPython 3.12 onward.
         for member in tar.getmembers():
             fn = member.name
             if leading:
    @@ -269,6 +286,14 @@ def _untar_without_filter(
             if member.isdir():
                 ensure_dir(path)
             elif member.issym():
    +            if not is_symlink_target_in_tar(tar, member):
    +                message = (
    +                    "The tar file ({}) has a file ({}) trying to install "
    +                    "outside target directory ({})"
    +                )
    +                raise InstallationError(
    +                    message.format(filename, member.name, member.linkname)
    +                )
                 try:
                     tar._extract_member(member, path)
                 except Exception as exc:
    
  • tests/unit/test_utils_unpacking.py+143 0 modified
    @@ -10,6 +10,7 @@
     from pathlib import Path
     
     import pytest
    +from _pytest.monkeypatch import MonkeyPatch
     
     from pip._internal.exceptions import InstallationError
     from pip._internal.utils.unpacking import is_within_directory, untar_file, unzip_file
    @@ -238,6 +239,148 @@ def test_unpack_tar_links(self, input_prefix: str, unpack_prefix: str) -> None:
             with open(os.path.join(unpack_dir, "symlink.txt"), "rb") as f:
                 assert f.read() == content
     
    +    def test_unpack_normal_tar_link1_no_data_filter(
    +        self, monkeypatch: MonkeyPatch
    +    ) -> None:
    +        """
    +        Test unpacking a normal tar with file containing soft links, but no data_filter
    +        """
    +        if hasattr(tarfile, "data_filter"):
    +            monkeypatch.delattr("tarfile.data_filter")
    +
    +        tar_filename = "test_tar_links_no_data_filter.tar"
    +        tar_filepath = os.path.join(self.tempdir, tar_filename)
    +
    +        extract_path = os.path.join(self.tempdir, "extract_path")
    +
    +        with tarfile.open(tar_filepath, "w") as tar:
    +            file_data = io.BytesIO(b"normal\n")
    +            normal_file_tarinfo = tarfile.TarInfo(name="normal_file")
    +            normal_file_tarinfo.size = len(file_data.getbuffer())
    +            tar.addfile(normal_file_tarinfo, fileobj=file_data)
    +
    +            info = tarfile.TarInfo("normal_symlink")
    +            info.type = tarfile.SYMTYPE
    +            info.linkpath = "normal_file"
    +            tar.addfile(info)
    +
    +        untar_file(tar_filepath, extract_path)
    +
    +        assert os.path.islink(os.path.join(extract_path, "normal_symlink"))
    +
    +        link_path = os.readlink(os.path.join(extract_path, "normal_symlink"))
    +        assert link_path == "normal_file"
    +
    +        with open(os.path.join(extract_path, "normal_symlink"), "rb") as f:
    +            assert f.read() == b"normal\n"
    +
    +    def test_unpack_normal_tar_link2_no_data_filter(
    +        self, monkeypatch: MonkeyPatch
    +    ) -> None:
    +        """
    +        Test unpacking a normal tar with file containing soft links, but no data_filter
    +        """
    +        if hasattr(tarfile, "data_filter"):
    +            monkeypatch.delattr("tarfile.data_filter")
    +
    +        tar_filename = "test_tar_links_no_data_filter.tar"
    +        tar_filepath = os.path.join(self.tempdir, tar_filename)
    +
    +        extract_path = os.path.join(self.tempdir, "extract_path")
    +
    +        with tarfile.open(tar_filepath, "w") as tar:
    +            file_data = io.BytesIO(b"normal\n")
    +            normal_file_tarinfo = tarfile.TarInfo(name="normal_file")
    +            normal_file_tarinfo.size = len(file_data.getbuffer())
    +            tar.addfile(normal_file_tarinfo, fileobj=file_data)
    +
    +            info = tarfile.TarInfo("sub/normal_symlink")
    +            info.type = tarfile.SYMTYPE
    +            info.linkpath = ".." + os.path.sep + "normal_file"
    +            tar.addfile(info)
    +
    +        untar_file(tar_filepath, extract_path)
    +
    +        assert os.path.islink(os.path.join(extract_path, "sub", "normal_symlink"))
    +
    +        link_path = os.readlink(os.path.join(extract_path, "sub", "normal_symlink"))
    +        assert link_path == ".." + os.path.sep + "normal_file"
    +
    +        with open(os.path.join(extract_path, "sub", "normal_symlink"), "rb") as f:
    +            assert f.read() == b"normal\n"
    +
    +    def test_unpack_evil_tar_link1_no_data_filter(
    +        self, monkeypatch: MonkeyPatch
    +    ) -> None:
    +        """
    +        Test unpacking a evil tar with file containing soft links, but no data_filter
    +        """
    +        if hasattr(tarfile, "data_filter"):
    +            monkeypatch.delattr("tarfile.data_filter")
    +
    +        tar_filename = "test_tar_links_no_data_filter.tar"
    +        tar_filepath = os.path.join(self.tempdir, tar_filename)
    +
    +        import_filename = "import_file"
    +        import_filepath = os.path.join(self.tempdir, import_filename)
    +        open(import_filepath, "w").close()
    +
    +        extract_path = os.path.join(self.tempdir, "extract_path")
    +
    +        with tarfile.open(tar_filepath, "w") as tar:
    +            info = tarfile.TarInfo("evil_symlink")
    +            info.type = tarfile.SYMTYPE
    +            info.linkpath = import_filepath
    +            tar.addfile(info)
    +
    +        with pytest.raises(InstallationError) as e:
    +            untar_file(tar_filepath, extract_path)
    +
    +        msg = (
    +            "The tar file ({}) has a file ({}) trying to install outside "
    +            "target directory ({})"
    +        )
    +        assert msg.format(tar_filepath, "evil_symlink", import_filepath) in str(e.value)
    +
    +        assert not os.path.exists(os.path.join(extract_path, "evil_symlink"))
    +
    +    def test_unpack_evil_tar_link2_no_data_filter(
    +        self, monkeypatch: MonkeyPatch
    +    ) -> None:
    +        """
    +        Test unpacking a evil tar with file containing soft links, but no data_filter
    +        """
    +        if hasattr(tarfile, "data_filter"):
    +            monkeypatch.delattr("tarfile.data_filter")
    +
    +        tar_filename = "test_tar_links_no_data_filter.tar"
    +        tar_filepath = os.path.join(self.tempdir, tar_filename)
    +
    +        import_filename = "import_file"
    +        import_filepath = os.path.join(self.tempdir, import_filename)
    +        open(import_filepath, "w").close()
    +
    +        extract_path = os.path.join(self.tempdir, "extract_path")
    +
    +        link_path = ".." + os.sep + import_filename
    +
    +        with tarfile.open(tar_filepath, "w") as tar:
    +            info = tarfile.TarInfo("evil_symlink")
    +            info.type = tarfile.SYMTYPE
    +            info.linkpath = link_path
    +            tar.addfile(info)
    +
    +        with pytest.raises(InstallationError) as e:
    +            untar_file(tar_filepath, extract_path)
    +
    +        msg = (
    +            "The tar file ({}) has a file ({}) trying to install outside "
    +            "target directory ({})"
    +        )
    +        assert msg.format(tar_filepath, "evil_symlink", link_path) in str(e.value)
    +
    +        assert not os.path.exists(os.path.join(extract_path, "evil_symlink"))
    +
     
     def test_unpack_tar_unicode(tmpdir: Path) -> None:
         test_tar = tmpdir / "test.tar"
    

Vulnerability mechanics

Generated by null/stub on May 9, 2026. Inputs: CWE entries + fix-commit diffs from this CVE's patches. Citations validated against bundle.

References

8

News mentions

0

No linked articles in our index yet.