Skip to content

is_zipfile false positives #72680

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
thomaswaldmann mannequin opened this issue Oct 20, 2016 · 18 comments
Open

is_zipfile false positives #72680

thomaswaldmann mannequin opened this issue Oct 20, 2016 · 18 comments
Labels
stdlib Python modules in the Lib dir type-bug An unexpected behavior, bug, or error

Comments

@thomaswaldmann
Copy link
Mannequin

thomaswaldmann mannequin commented Oct 20, 2016

BPO 28494
Nosy @Yhg1s, @gpshead, @vstinner, @serhiy-storchaka, @ThomasWaldmann, @jjolly, @miss-islington
PRs
  • gh-72680: Fix false positives when using zipfile.is_zipfile() #5053
  • bpo-28494: Test existing zipfile working behavior. #15853
  • [3.8] bpo-28494: Test existing zipfile working behavior. (GH-15853) #15891
  • bpo-28494: install ziptestdata to fix install bot. #15902
  • [3.8] bpo-28494: install ziptestdata to fix install bot (GH-15902) #15912
  • Files
  • isz_fail.py
  • isz_fail_fix.diff
  • Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

    Show more details

    GitHub fields:

    assignee = 'https://github.com/gpshead'
    closed_at = None
    created_at = <Date 2016-10-20.21:08:48.959>
    labels = ['3.7', '3.8', 'type-bug', 'library']
    title = 'is_zipfile false positives'
    updated_at = <Date 2019-09-11.11:09:56.949>
    user = 'https://github.com/ThomasWaldmann'

    bugs.python.org fields:

    activity = <Date 2019-09-11.11:09:56.949>
    actor = 'miss-islington'
    assignee = 'gregory.p.smith'
    closed = False
    closed_date = None
    closer = None
    components = ['Library (Lib)']
    creation = <Date 2016-10-20.21:08:48.959>
    creator = 'Thomas.Waldmann'
    dependencies = []
    files = ['45162', '45164']
    hgrepos = []
    issue_num = 28494
    keywords = ['patch']
    message_count = 16.0
    messages = ['279084', '279088', '279089', '280341', '281805', '281817', '309245', '311281', '334595', '351723', '351749', '351750', '351751', '351755', '351802', '351823']
    nosy_count = 9.0
    nosy_names = ['twouters', 'gregory.p.smith', 'alanmcintyre', 'vstinner', 'serhiy.storchaka', 'Thomas.Waldmann', 'mryan1539', 'jjolly', 'miss-islington']
    pr_nums = ['5053', '15853', '15891', '15902', '15912']
    priority = 'normal'
    resolution = None
    stage = 'patch review'
    status = 'open'
    superseder = None
    type = 'behavior'
    url = 'https://bugs.python.org/issue28494'
    versions = ['Python 2.7', 'Python 3.7', 'Python 3.8']

    @thomaswaldmann
    Copy link
    Mannequin Author

    thomaswaldmann mannequin commented Oct 20, 2016

    zipfile.is_zipfile has false positives way too easily.

    I just have seen it in practive when a MoinMoin wiki site with a lot of pdf attachments crashed with 500. This was caused by a valid PDF that just happened to contain PK\005\006 somewhere in the middle - this was enough to satisfy is_zipfile() and triggered further processing as a zipfile, which then crashed with IOError (which was not catched in our code, yet).

    I have looked into zipfile code: if the usual EOCD structure (with empty comment) is not at EOF, it is suspected that there might be a non-empty comment and ~64K before EOF are searched for the PK\005\006 magic. If it is somewhere there, it is assumed that the file is a zip, without any further validity check.

    Attached is a failure demo that works with at least 2.7 and 3.5.

    https://en.wikipedia.org/wiki/Zip_(file_format)

    @thomaswaldmann thomaswaldmann mannequin added stdlib Python modules in the Lib dir type-bug An unexpected behavior, bug, or error labels Oct 20, 2016
    @serhiy-storchaka serhiy-storchaka added the 3.7 (EOL) end of life label Oct 20, 2016
    @thomaswaldmann
    Copy link
    Mannequin Author

    thomaswaldmann mannequin commented Oct 20, 2016

    patch for py2.7

    The EOCD structure is at EOF.

    It either does not contain a comment (this is what the existing code checks first) or it contains a comment of the length that is specified in the structure.

    The patch checks consistency specified length vs. real length (end of fixed part of structure up to EOF). If this does not match, it is likely not a zip file, but just a file that happens to have the magic 4 bytes somewhere in its last 64kB.

    @thomaswaldmann
    Copy link
    Mannequin Author

    thomaswaldmann mannequin commented Oct 20, 2016

    Note: checking the first bytes of the file (PK..) might be another option.

    But this has the "problem" that a self-extracting zip starts with an executable that has different first bytes.

    So whether this is an option or not depends on whether is_zipfile() should return truish for self-extracting ZIP files.

    @serhiy-storchaka serhiy-storchaka self-assigned this Nov 3, 2016
    @serhiy-storchaka
    Copy link
    Member

    The problem is that the zipfile module supports even not well-formed archives, with a data appended past a comment, and with truncated comment. There are special tests for this, and the proposed patch breaks these tests: test_comments, test_ignores_newline_at_end, test_ignores_stuff_appended_past_comments. See bpo-10694 and bpo-1622.

    @thomaswaldmann
    Copy link
    Mannequin Author

    thomaswaldmann mannequin commented Nov 27, 2016

    Well, if you have a better idea how to fix is_zipfile, go on.

    I even suggested an alternative, how about that?

    It is a miserable state when the is_zipfile function in the stdlib detects random crap as a zip file.

    @serhiy-storchaka
    Copy link
    Member

    No, checking the first bytes of the file is not appropriate option. zipfile should support the Python zip application format [1].

    I see two options:

    1. Make is_zipfile() more strict that the ZipFile constructor. The later supports ZIP files with a data past the comment or with truncated comments, but the former should reject them.

    2. Make both is_zipfile() and the ZipFile constructor more robust. They should check not just the EOCD signature, but check the Zip64 end of central directory record (if exists) and the first central file header signature (if the ZIP file is not empty).

    It may be that PDF files contain PK\005\006 not accidentally, but because they contain embedded ZIP files (I don't know if this is a case). In that circumstances is_zipfile() returning True is correct.

    [1] https://docs.python.org/3/library/zipapp.html

    @jjolly
    Copy link
    Mannequin

    jjolly mannequin commented Dec 30, 2017

    Fix submitted that evaluates the ECD structure and validates the first CD entry. The fix also handles empty zipfiles.

    IMO the purpose of this API is to *quickly* verify that the file is a valid zipfile. With this fix, the API only reads another 46 bytes of data (after a seek, of course). This should still qualify as "quick", especially after having potentially read 64k of data.

    Perhaps a full zip validator would be appropriate in addition to is_zipfile. That would be more appropriate as a full feature rather than in this bugfix.

    @jjolly
    Copy link
    Mannequin

    jjolly mannequin commented Jan 30, 2018

    Is there any chance that this will make it into 3.7 or is my reminder too late?

    @gpshead gpshead added the 3.8 (EOL) end of life label Jan 30, 2019
    @gpshead
    Copy link
    Member

    gpshead commented Jan 30, 2019

    it's a bugfix, it seems reasonable for 3.7 to me. I agree that the previous is_zipfile check is too lenient. I'll follow up on jjolly's PR for any specific concerns I have with the implementation.

    @gpshead gpshead assigned gpshead and unassigned serhiy-storchaka Jan 30, 2019
    @Yhg1s
    Copy link
    Member

    Yhg1s commented Sep 10, 2019

    New changeset 3f4db4a by T. Wouters (Gregory P. Smith) in branch 'master':
    bpo-28494: Test existing zipfile working behavior. (GH-15853)
    3f4db4a

    @vstinner
    Copy link
    Member

    x86 Gentoo Installed with X 3.x buildbot is unhappy:

    https://buildbot.python.org/all/#/builders/103/builds/3051

    ======================================================================
    ERROR: test_execute_zip2 (test.test_zipfile.TestExecutablePrependedZip)
    ----------------------------------------------------------------------

    Traceback (most recent call last):
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/test/test_zipfile.py", line 2502, in test_execute_zip2
        output = subprocess.check_output([self.exe_zip, sys.executable])
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 411, in check_output
        return run(*popenargs, stdout=PIPE, timeout=timeout, check=True,
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 489, in run
        with Popen(*popenargs, **kwargs) as process:
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 845, in __init__
        self._execute_child(args, executable, preexec_fn, close_fds,
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 1689, in _execute_child
        raise child_exception_type(errno_num, err_msg, err_filename)
    FileNotFoundError: [Errno 2] No such file or directory: 'ziptestdata/exe_with_zip'

    ======================================================================
    ERROR: test_execute_zip64 (test.test_zipfile.TestExecutablePrependedZip)
    ----------------------------------------------------------------------

    Traceback (most recent call last):
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/test/test_zipfile.py", line 2509, in test_execute_zip64
        output = subprocess.check_output([self.exe_zip64, sys.executable])
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 411, in check_output
        return run(*popenargs, stdout=PIPE, timeout=timeout, check=True,
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 489, in run
        with Popen(*popenargs, **kwargs) as process:
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 845, in __init__
        self._execute_child(args, executable, preexec_fn, close_fds,
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/subprocess.py", line 1689, in _execute_child
        raise child_exception_type(errno_num, err_msg, err_filename)
    FileNotFoundError: [Errno 2] No such file or directory: 'ziptestdata/exe_with_z64'

    ======================================================================
    FAIL: test_read_zip64_with_exe_prepended (test.test_zipfile.TestExecutablePrependedZip)
    ----------------------------------------------------------------------

    Traceback (most recent call last):
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/test/test_zipfile.py", line 2496, in test_read_zip64_with_exe_prepended
        self._test_zip_works(self.exe_zip64)
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/test/test_zipfile.py", line 2484, in _test_zip_works
        self.assertTrue(zipfile.is_zipfile(name),
    AssertionError: False is not true : is_zipfile failed on ziptestdata/exe_with_z64

    ======================================================================
    FAIL: test_read_zip_with_exe_prepended (test.test_zipfile.TestExecutablePrependedZip)
    ----------------------------------------------------------------------

    Traceback (most recent call last):
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/test/test_zipfile.py", line 2493, in test_read_zip_with_exe_prepended
        self._test_zip_works(self.exe_zip)
      File "/buildbot/buildarea/cpython/3.x.ware-gentoo-x86.installed/build/target/lib/python3.9/test/test_zipfile.py", line 2484, in _test_zip_works
        self.assertTrue(zipfile.is_zipfile(name),
    AssertionError: False is not true : is_zipfile failed on ziptestdata/exe_with_zip

    @gpshead
    Copy link
    Member

    gpshead commented Sep 10, 2019

    The new ziptestdata/ subdir appears to not be part of the install that make install does. :/

    @vstinner
    Copy link
    Member

    The new ziptestdata/ subdir appears to not be part of the install that make install does. :/

    It seems like Lib/test/eintrdata/ (for example) is installed using LIBSUBDIRS variable in Makefile.pre.in.

    Note: The Windows installer copies recursively Lib/test/ and subdirectories: see <InstallFiles Include="$(PySourcePath)Lib\test\**\*" ...> in Tools/msi/test/test.wixproj.

    @miss-islington
    Copy link
    Contributor

    New changeset 74b0291 by Miss Islington (bot) in branch '3.8':
    bpo-28494: Test existing zipfile working behavior. (GH-15853)
    74b0291

    @gpshead
    Copy link
    Member

    gpshead commented Sep 11, 2019

    New changeset c374474 by Gregory P. Smith in branch 'master':
    bpo-28494: install ziptestdata to fix install bot (GH-15902)
    c374474

    @miss-islington
    Copy link
    Contributor

    New changeset 7acb22e by Miss Islington (bot) in branch '3.8':
    bpo-28494: install ziptestdata to fix install bot (GH-15902)
    7acb22e

    @vpv-csc
    Copy link

    vpv-csc commented Jun 3, 2024

    Any chance #5053 could be merged? A user of ours has a TIFF file, for which is_zipfile returns True, but calling the ZipFile constructor results in BadZipFile. I probably can not give out the file, but here's an example run:

    Python 3.12.3 (main, Apr 17 2024, 00:00:00) [GCC 14.0.1 20240411 (Red Hat 14.0.1-0)] on linux
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import zipfile
    >>> zipfile.is_zipfile("testfile.tif")
    True
    >>> zipfile.ZipFile("testfile.tif")
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
      File "/usr/lib64/python3.12/zipfile/__init__.py", line 1349, in __init__
        self._RealGetContents()
      File "/usr/lib64/python3.12/zipfile/__init__.py", line 1435, in _RealGetContents
        raise BadZipFile("Bad offset for central directory")
    zipfile.BadZipFile: Bad offset for central directory
    

    @vstinner
    Copy link
    Member

    vstinner commented Jun 3, 2024

    @vpv-csc: test_ignores_newline_at_end() and test_ignores_stuff_appended_past_comments() of test_zipfile fail with attached isz_fail_fix.diff. Someone should design a fix which doesn't break the test suite, or the test suite should be updated as well.

    @gpshead gpshead removed their assignment Jun 3, 2024
    tovento pushed a commit to Digital-Preservation-Finland/file-scraper that referenced this issue Jul 1, 2024
    We cannot directly use zipfile.is_zipfile function because it gives
    false positives.
    
    More info: (python/cpython#72680)
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Labels
    stdlib Python modules in the Lib dir type-bug An unexpected behavior, bug, or error
    Projects
    Status: No status
    Development

    No branches or pull requests

    7 participants