{"id":"CVE-2026-129299","aliases":["GHSA-24mq-4vc6-2prf"],"url":"https://o3.security/vulnerability/CVE-2026-129299","summary":"mail-parser: Uncaught exceptions and silent header loss in mail-parser on attacker-controlled input","details":"### Impact\n\nTwo effects, sharing the root cause of Advisory 1 — header names chosen by the sender were\nresolved through Python attribute lookup and rewritten before lookup.\n\n**Uncaught exceptions.** A crafted message raises an exception that is *outside* the\n`MailParser*` hierarchy, so a caller catching only mail-parser exceptions does not catch it\nand the worker dies.\n\n*Header named after a method* (CWE-248, reported by @iam-niranjan). Python resolves real\nclass attributes before `__getattr__`, so a header named after a method put a bound method\nobject into the parsed mail dict. A 12-byte email is sufficient. Nine colliding names were\nconfirmed: `Parse`, `Message`, `Write_Attachments`, `From_File`, `From_File_Obj`,\n`From_File_Msg`, `From_String`, `From_Bytes`, `Get_Server_Ipaddress`. Also reproducible from\nthe CLI (`mail-parser -f evil.eml -j`).\n\n```python\nimport mailparser\nmailparser.parse_from_string(\"Parse: x\\r\\n\\r\\n\").mail_json\n# 4.6.1 -> TypeError: Object of type method is not JSON serializable\n# 4.6.2 -> {\"parse\": \"x\", \"has_defects\": false}\n```\n\n*Header carrying 8-bit bytes* (CWE-248). For a header containing raw 8-bit bytes, Python's\n`compat32` policy returns an `email.header.Header` rather than a `str`, which the `_raw`\naccessor passed straight to `json.dumps`. This fires on entirely benign non-ASCII mail via\n`parse_from_bytes()`, the normal entry point for mail off the wire.\n\n```python\nimport mailparser\nmailparser.parse_from_bytes(b\"Subject: caf\\xe9\\r\\n\\r\\nbody\\r\\n\").subject_raw\n# 4.6.1 -> TypeError: Object of type Header is not JSON serializable\n# 4.6.2 -> '[\"caf�\"]'\n```\n\n**Silent loss of message content** (CWE-436). A sender can make a header's value vanish from\nevery output surface, or be replaced by a different header's value, with `has_defects`\nremaining `false`. This is an evasion primitive: the tool's output diverges from the bytes\nactually in the message, and a pipeline scanning parsed output for indicators sees nothing\nand no failure signal.\n\nHeader names were normalised before lookup — underscores folded to dashes, and `_json` /\n`_raw` suffixes interpreted — so a header genuinely named `Subject_json` was reported with\nthe value of `Subject` and its own value discarded, and any header whose name contains an\nunderscore resolved to nothing.\n\n```python\nimport mailparser\n\nraw = (\"From: Real Sender <real@good.example>\\r\\n\"\n       \"Subject: innocuous\\r\\n\"\n       \"Subject_json: MALWARE-C2 http://evil.example/payload.exe\\r\\n\"\n       \"X_Spam_Flag: YES\\r\\n\\r\\nbody\\r\\n\")\nmail = mailparser.parse_from_string(raw)\nprint(mail.mail[\"subject_json\"])       # 4.6.1 -> '\"innocuous\"'   4.6.2 -> the real value\nprint(mail.headers[\"X_Spam_Flag\"])     # 4.6.1 -> ''              4.6.2 -> 'YES'\nprint(\"MALWARE-C2\" in mail.mail_json)  # 4.6.1 -> False           4.6.2 -> True\nprint(mail.has_defects)                # both  -> False\n```\n\nA related case: `email.message.Message.__len__` returns the header count, so a message with\n**no headers** is falsy. `parse()` returned before initialising state, and the unset\nattributes were then absorbed by `__getattr__` and answered as absent headers. Every\nproperty returned `''` — including `mail` and `attachments`, which are documented to return\na `dict` and a `list` — with no error and no defect flag.\n\n```python\nimport mailparser\nmail = mailparser.parse_from_string(\"Click http://evil.example/pay.exe now\\r\\n\")\nprint(repr(mail.body))         # 4.6.1 -> ''    4.6.2 -> the text\nprint(repr(mail.attachments))  # 4.6.1 -> ''    4.6.2 -> []\nprint(mail.has_defects)        # 4.6.1 -> ''    4.6.2 -> True\n```\n\n### Patches\n\nFixed in **4.6.2**. Upgrade with `pip install --upgrade mail-parser`.\n\nHeader names taken from a message are now looked up literally — no attribute access, no\ncase or separator folding, no suffix interpretation — so no header name can collide with a\nmethod or property, and no value can be substituted or dropped. 8-bit values are coerced to\n`str` before serialisation. Parser state is initialised before the message check, which now\ntests `is None`, and attribute names beginning with `_` raise `AttributeError` instead of\nbeing answered as headers.\n\n**Behaviour changes.** Header names now appear in `mail` and `headers` exactly as sent, so a\nheader named `X_Spam_Flag` keeps that name and its own value. `X_raw` always returns a JSON\narray — an absent header yields `[]` where 4.6.1 returned `null`.\n\n### Workarounds\n\nNone for the data loss. For the uncaught exceptions, callers who cannot upgrade should wrap\n`mail_json`, `mail_partial_json`, `headers_json` and any `X_raw` access in a bare\n`except Exception` rather than catching only `MailParserError` subclasses.","published":"2026-11-16T17:43:22.605Z","modified":"2026-11-17T21:00:55.235653443Z","cvss":{"score":6.5,"severity":"MEDIUM","vector":"CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:L/A:L"},"epss":{"score":0.00355,"percentile":0.29663,"asOf":"2026-11-17"},"cisaKev":null,"exploitsKnown":0,"affectedPackages":[{"ecosystem":"PyPI","name":"mail-parser","fixedVersion":"4.6.2"}],"fix":{"url":"https://github.com/SpamScope/mail-parser/commit/ce3cf3559db1ff806bda598b378de9f8c2a5be96","label":"SpamScope/mail-parser@ce3cf35"},"references":[{"type":"WEB","url":"https://github.com/SpamScope/mail-parser/releases/tag/4.6.2"},{"type":"ADVISORY","url":"https://github.com/CVEProject/cvelistV5/tree/main/cves/2026/129xxx/CVE-2026-129299.json"},{"type":"ADVISORY","url":"https://github.com/SpamScope/mail-parser/security/advisories/GHSA-24mq-4vc6-2prf"},{"type":"ADVISORY","url":"https://nvd.nist.gov/vuln/detail/CVE-2026-129299"},{"type":"FIX","url":"https://github.com/SpamScope/mail-parser/commit/ce3cf3559db1ff806bda598b378de9f8c2a5be96"},{"type":"FIX","url":"https://github.com/SpamScope/mail-parser/pull/167"},{"type":"PACKAGE","url":"https://github.com/SpamScope/mail-parser"}],"provenance":{"sources":["OSV.dev","FIRST.org (EPSS)"],"lastVerified":"2026-11-17T21:00:55.235653443Z"}}