Advisory

GHSA-fr3h-cpq2-9496

Also known as: CVE-2026-129296

Summary

mail-parser: Path Traversal vulnerability in attachment extraction

Details

A path traversal vulnerability was identified in mail-parser when extracting email attachments using the write_attachments() and write_sample() APIs.

A specially crafted email containing malicious attachment filenames (for example, using directory traversal sequences such as "../" or absolute filesystem paths) could cause files to be written outside the intended output directory. Depending on how the library was used and the permissions of the executing process, this could result in arbitrary file overwrite.

The vulnerability affects mail-parser versions 3.8.0 through 4.5.0.

The issue has been addressed by introducing comprehensive filename sanitization and path validation before any file is written to disk. The fix includes:

  • Sanitization of attachment filenames before writing.
  • Validation that all output paths remain within the intended destination directory.
  • Rejection of symbolic link targets.
  • Normalization of Windows and POSIX path separators.
  • Validation and rejection of invalid or unsafe filenames.
  • Protection applied consistently in both write_attachments() and write_sample() APIs.

Users are strongly encouraged to upgrade to the patched release.

Credits

The vulnerability was responsibly reported by Niranjan Ganesan (Security Insights, https://securityinsights.io/, GitHub: @iam-niranjan).

The vulnerability was analyzed, remediated, and the security fix was implemented by Fedele Mantuano, maintainer of mail-parser (LinkedIn: https://www.linkedin.com/in/fmantuano/).

mail-parser would like to thank Niranjan Ganesan for following a coordinated vulnerability disclosure process and for collaborating throughout the remediation and verification of the fix.

Severity

Medium Basis: The source's own band: MODERATE

Dates

Published
2026-11-16 22:10 UTC
Modified
2026-11-16 22:15 UTC

Affected packages and fixes

mail-parser

PyPI · All systems

Affected

  • introduced 3.8.0, fixed 4.6.0 (ecosystem)

Fixed versions

4.6.0

Fix

  • Fixed version 4.6.0
    pip install --upgrade mail-parser==4.6.0

Fix commands are the export's own generic commands. Ojuju never runs them. Check them against your setup first.

Check your own computer: guard packages check

View this record on OSV.dev

Source

Source: GitHub Advisory Database (reviewed advisories) · CC BY 4.0

Sources & licences