Skip to content

fix(archive): harden stem traversal, member sanitizer, pre-1980 mtimes and folder extraction - #35

Open
lukisch wants to merge 1 commit into
masterfrom
fix/bugsweep-archive-security-resilience-20261118
Open

lukisch wants to merge 1 commit into
masterfrom
fix/bugsweep-archive-security-resilience-20261118

Conversation

@lukisch

@lukisch lukisch commented Nov 18, 2026

Copy link
Copy Markdown
Collaborator

Zusammenfassung (WC-20261118-SOFTWARE-BUGSEARCH-EXPLORERPRO)

Systematische Sicherheits- und Robustheits-Härtung der nativen Archiv-Engine (src/core/archive_service.py) und der Archiv-Dialog-Suite (src/gui/archive_dialog.py):

  1. Unterordner-Stammnamen-Traversal & Windows-Gerätenamen (src/gui/archive_dialog.py)
    • _get_archive_stem bereinigt Punkt-Traversal-Stämme (..tar.gz, ...tar.gz, ...zip, .zip), nachgestellte Punkte/Leerzeichen, Steuerzeichen sowie reservierte Windows-Gerätenamen (CON, PRN, AUX, NUL, COM1..9, LPT1..9 inkl. Superscripts).
    • ArchiveExtractDialog._start_extraction verifiziert zusätzlich per resolve() + is_relative_to(), dass das Unterordner-Ziel strikt ein Kindverzeichnis von base_dir ist.
  2. Erweiterte Zip-Slip-/Tar-Slip- & Symlink-Abwehr (src/core/archive_service.py)
    • sanitize_archive_member_path weist leere/Root-Pfade, NTFS Alternate Data Streams (:, inkl. 1-Buchstaben-Dateinamen wie a:stream), Steuerzeichen, nachgestellte Punkte/Leerzeichen an allen Pfadsegmenten, reservierte Windows-Gerätenamen sowie Symlinks/Junctions unterhalb von target_dir mit ZipSlipSecurityError ab.
    • extract_zip_archive überspringt analog zu extract_tar_archive Unix-Symlinks (S_IFLNK) und Spezialdateien; harmlose Root-Ordner-Header ("." / "./") in tar -C dir .-Archiven werden bei Verzeichnissen sicher ignoriert, bei regulären Dateien jedoch blockiert.
  3. Selbst-Einschluss-Schutz, Prä-1980-/Post-2107-Zeitstempel & Read-Only-Overwrite (src/core/archive_service.py, src/gui/archive_dialog.py)
    • create_zip_archive und create_tar_archive schließen das Zielarchiv dest_path sowie kollisionsfreie .tmp_<pid>_<uuid>-Staging-Dateien beim Sammeln/Walken aus; ArchiveCompressDialog wählt bei Einzelordner-Kompression mit current_dir == sources[0] automatisch das Elternverzeichnis als Standard-Zielordner.
    • create_zip_archive klemmt Datei-Zeitstempel außerhalb des DOS-ZIP-Fensters (< 1980, inkl. negativer Prä-1970-Zeitstempel unter Windows, sowie > 2107) per speicherschonendem Chunk-Streaming (zinfo.file_size für ZIP64 gesetzt) auf gültige Grenzen, statt mit ValueError / OSError [Errno 22] abzustürzen.
    • _atomic_replace ersetzt bei aktivem Überschreiben bestehende reguläre Read-Only-Dateien unter Windows sauber, ohne andere OSError/PermissionError-Ursachen zu verdecken.
  4. Selektive Ordner-Extraktion & Einzelstream-Abgrenzung (src/core/archive_service.py)
    • _select_matching_members expandiert ausgewählte Ordnerzeilen (nested/ bzw. nested) im ArchiveViewerDialog rekursiv auf alle enthaltenen Dateien ohne Präfix-Nachbar-Kollision (nested2/).
    • SUPPORTED_ARCHIVE_EXTENSIONS & is_archive melden reine Einzelstream-Dateien (.gz, .bz2, .xz ohne TAR-Container) und nicht unterstütztes .tar.zst nicht mehr pauschal per Dateiendung als Archiv (verhindert Fehlrouting in PreviewPanel und FileBrowser).

Verifikation

  • Red -> Green: Alle 8 neuen hermetischen Regressionstests in tests/test_bugsweep_archive_security_and_resilience_20261118.py schlugen vor dem Fix reproduzierbar fehl (8 failed) und laufen nach dem Fix grün (8 passed).
  • Archiv- & Gesamt-Testsuiten: 52 passed in den 4 Archiv-Testsuiten (test_archive_suite.py, test_tar_archive_suite.py, test_archive_gui_integration.py, test_bugsweep_archive_security_and_resilience_20261118.py); 623 passed, 0 failed über die gesamte Repository-Testsuite.
  • Gates: ruff check . (0 Fehler), python -m compileall -q . (0), python manage_translations.py --check (1185 Einträge über alle 6 Sprachen, 0 Lücken), lint_mermaid.py (CLEAN), git diff --check (0), unabhängige Tier-1-Zweitabnahme (IMPRIMATUR: PASS).

…s and folder extraction

- Sanitize archive subfolder stems in _get_archive_stem and enforce strict child-directory confinement in ArchiveExtractDialog (blocks ..tar.gz, ...tar.gz, ...zip, .zip, trailing dots/spaces and Windows device names CON/NUL/COM1..9/LPT1..9).
- Harden sanitize_archive_member_path, extract_zip_archive and extract_tar_archive against empty/root members, NTFS ADS colons (including 1-char names), control chars, trailing dots/spaces on all path segments, symlink/junction intermediates and Unix symlink/special entries in ZIP archives.
- Exclude destination archive and PID+UUID .tmp_* staging files from self-inclusion in create_zip_archive and create_tar_archive; default single-folder compression in ArchiveCompressDialog to the parent directory; handle Windows read-only file replacement atomically.
- Clamp pre-1980 (including negative pre-1970 mtimes on Windows) and post-2107 file timestamps in create_zip_archive via chunked streaming with explicit zinfo.file_size.
- Expand directory prefixes during selective member extraction in ZIP and TAR archives and restrict is_archive from falsely matching standalone .gz/.bz2/.xz streams or unsupported .tar.zst files.
- Add 8 hermetic regression tests in tests/test_bugsweep_archive_security_and_resilience_20261118.py.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant