GHSA-24mq-4vc6-2prf

Suggest an improvement
Source
https://github.com/advisories/GHSA-24mq-4vc6-2prf
Import Source
https://github.com/github/advisory-database/blob/main/advisories/github-reviewed/2026/11/GHSA-24mq-4vc6-2prf/GHSA-24mq-4vc6-2prf.json
JSON Data
https://api.osv.dev/v1/vulns/GHSA-24mq-4vc6-2prf
Aliases
  • CVE-2026-129299
Published
2026-11-16T22:12:51Z
Modified
2026-11-16T22:30:03Z
Severity
  • 6.5 (Medium) CVSS_V3 - CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:L/A:L CVSS Calculator
Summary
mail-parser: Uncaught exceptions and silent header loss in mail-parser on attacker-controlled input
Details

Impact

Two effects, sharing the root cause of Advisory 1 — header names chosen by the sender were resolved through Python attribute lookup and rewritten before lookup.

Uncaught exceptions. A crafted message raises an exception that is outside the MailParser* hierarchy, so a caller catching only mail-parser exceptions does not catch it and the worker dies.

Header named after a method (CWE-248, reported by @iam-niranjan). Python resolves real class attributes before __getattr__, so a header named after a method put a bound method object into the parsed mail dict. A 12-byte email is sufficient. Nine colliding names were confirmed: Parse, Message, Write_Attachments, From_File, From_File_Obj, From_File_Msg, From_String, From_Bytes, Get_Server_Ipaddress. Also reproducible from the CLI (mail-parser -f evil.eml -j).

import mailparser
mailparser.parse_from_string("Parse: x\r\n\r\n").mail_json
# 4.6.1 -> TypeError: Object of type method is not JSON serializable
# 4.6.2 -> {"parse": "x", "has_defects": false}

Header carrying 8-bit bytes (CWE-248). For a header containing raw 8-bit bytes, Python's compat32 policy returns an email.header.Header rather than a str, which the _raw accessor passed straight to json.dumps. This fires on entirely benign non-ASCII mail via parse_from_bytes(), the normal entry point for mail off the wire.

import mailparser
mailparser.parse_from_bytes(b"Subject: caf\xe9\r\n\r\nbody\r\n").subject_raw
# 4.6.1 -> TypeError: Object of type Header is not JSON serializable
# 4.6.2 -> '["caf�"]'

Silent loss of message content (CWE-436). A sender can make a header's value vanish from every output surface, or be replaced by a different header's value, with has_defects remaining false. This is an evasion primitive: the tool's output diverges from the bytes actually in the message, and a pipeline scanning parsed output for indicators sees nothing and no failure signal.

Header names were normalised before lookup — underscores folded to dashes, and _json / _raw suffixes interpreted — so a header genuinely named Subject_json was reported with the value of Subject and its own value discarded, and any header whose name contains an underscore resolved to nothing.

import mailparser

raw = ("From: Real Sender <real@good.example>\r\n"
       "Subject: innocuous\r\n"
       "Subject_json: MALWARE-C2 http://evil.example/payload.exe\r\n"
       "X_Spam_Flag: YES\r\n\r\nbody\r\n")
mail = mailparser.parse_from_string(raw)
print(mail.mail["subject_json"])       # 4.6.1 -> '"innocuous"'   4.6.2 -> the real value
print(mail.headers["X_Spam_Flag"])     # 4.6.1 -> ''              4.6.2 -> 'YES'
print("MALWARE-C2" in mail.mail_json)  # 4.6.1 -> False           4.6.2 -> True
print(mail.has_defects)                # both  -> False

A related case: email.message.Message.__len__ returns the header count, so a message with no headers is falsy. parse() returned before initialising state, and the unset attributes were then absorbed by __getattr__ and answered as absent headers. Every property returned '' — including mail and attachments, which are documented to return a dict and a list — with no error and no defect flag.

import mailparser
mail = mailparser.parse_from_string("Click http://evil.example/pay.exe now\r\n")
print(repr(mail.body))         # 4.6.1 -> ''    4.6.2 -> the text
print(repr(mail.attachments))  # 4.6.1 -> ''    4.6.2 -> []
print(mail.has_defects)        # 4.6.1 -> ''    4.6.2 -> True

Patches

Fixed in 4.6.2. Upgrade with pip install --upgrade mail-parser.

Header names taken from a message are now looked up literally — no attribute access, no case or separator folding, no suffix interpretation — so no header name can collide with a method or property, and no value can be substituted or dropped. 8-bit values are coerced to str before serialisation. Parser state is initialised before the message check, which now tests is None, and attribute names beginning with _ raise AttributeError instead of being answered as headers.

Behaviour changes. Header names now appear in mail and headers exactly as sent, so a header named X_Spam_Flag keeps that name and its own value. X_raw always returns a JSON array — an absent header yields [] where 4.6.1 returned null.

Workarounds

None for the data loss. For the uncaught exceptions, callers who cannot upgrade should wrap mail_json, mail_partial_json, headers_json and any X_raw access in a bare except Exception rather than catching only MailParserError subclasses.

Database specific
{
    "cwe_ids": [
        "CWE-248",
        "CWE-436"
    ],
    "github_reviewed": true,
    "github_reviewed_at": "2026-11-16T22:12:51Z",
    "nvd_published_at": "2026-11-16T18:17:30Z",
    "severity": "MODERATE"
}
References

Affected packages

PyPI / mail-parser

Package

Name
mail-parser
View open source insights on deps.dev
Purl
pkg:pypi/mail-parser

Affected ranges

Type
ECOSYSTEM
Events
Introduced
0 Unknown introduced version / All previous versions are affected
Fixed
4.6.2

Affected versions

0.*
0.5.0
1.*
1.0.0rc1
1.0.0
1.1.0
1.1.1
1.1.2
1.1.3
1.1.4
1.1.5
1.1.6
1.1.7
1.1.8
1.1.9
1.1.10
1.2.0
1.2.1
1.2.2
1.2.4
1.2.5
1.2.6
2.*
2.0.0
2.0.1
2.1.0
3.*
3.0.0
3.1.0
3.2.0
3.2.1
3.2.2
3.2.3
3.2.4
3.2.5
3.2.6
3.2.7
3.3.0
3.3.1
3.3.2
3.3.3
3.4.0
3.4.1
3.5.0
3.5.1
3.6.0
3.6.1
3.7.0
3.7.1
3.8.0
3.8.1
3.9.0
3.9.1
3.9.2
3.9.3
3.10.0
3.11.0
3.12.0
3.13.0
3.14.0
3.15.0
4.*
4.0.0
4.1.0
4.1.2
4.1.3
4.1.4
4.2.0
4.2.1
4.3.0
4.4.0
4.5.0
4.6.0
4.6.1

Database specific

last_known_affected_version_range
"<= 4.6.1"
source
"https://github.com/github/advisory-database/blob/main/advisories/github-reviewed/2026/11/GHSA-24mq-4vc6-2prf/GHSA-24mq-4vc6-2prf.json"