GHSA-m4g8-47f9-h588

Suggest an improvement
Source
https://github.com/advisories/GHSA-m4g8-47f9-h588
Import Source
https://github.com/github/advisory-database/blob/main/advisories/github-reviewed/2026/11/GHSA-m4g8-47f9-h588/GHSA-m4g8-47f9-h588.json
JSON Data
https://api.osv.dev/v1/vulns/GHSA-m4g8-47f9-h588
Aliases
Published
2026-11-19T22:47:08Z
Modified
2026-11-19T23:00:36Z
Severity
  • 5.3 (Medium) CVSS_V3 - CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L CVSS Calculator
Summary
eml_parser: Algorithmic-complexity DoS (O(n^4) regex backtracking) in Received-header parsing
Details

Summary

eml_parser.routing.parserouting() dynamically builds a regex from up to four greedy .* groups (from (?P<from>.*)by (?P<by>.*)with (?P<with>.*)for (?P<for>.*)) terminated by an escaped literal of the date extracted from a normalized copy of the Received header. Because the date literal comes from the normalized text but is searched in the original line, a crafted header can make the trailing literal unmatchable; the search then fails at every start position only after exhaustively backtracking the four nested greedy groups — O(n^4) in header length. A single ~5.9 KB email pins one CPU core for ~12 seconds; doubling the input multiplies the cost ~25x, so a ~13 KB header takes minutes and a ~25 KB header effectively hangs the parse worker.

Details

Root cause: eml_parser/routing.py:140-148 (v3.0.3):

reg = ''
for item in tout:
    reg += item[1] + '(?P<' + item[1].strip() + '>.*)'   # e.g. 'from (?P<from>.*)'
if npdate:
    reg += eml_parser.regexes.escape_special_regex_chars.sub(r"""\\\1""", npdate)
reparse = re.compile(reg)
reparseg = reparse.search(line)   # searched in the ORIGINAL line

npdate is extracted from npline, a normalized copy of the header (spacing added around (, ), ; at routing.py:79-81; parenthesized text removed at line 82; whitespace collapsed at line 83), so it is not guaranteed to be a substring of line. An unbalanced ( in the date tail (e.g. +0000(comment) becomes ( comment in npline but stays (comment in line, making the mandatory trailing literal unmatchable.

Data flow: attacker-controlled Received: header (arbitrary length; the custom policy sets max_line_length=0) -> parser.py:352-355 (lowercased, whitespace-flattened, no size cap - unlike body text, which is sliced) -> parser.py:365 routing.parserouting(...) -> O(n^4) search. Every Received header is processed, multiplying the cost, and the behavior cannot be disabled via any EmlParser option.

Measured on Python 3.14 (identical with stdlib re and the optional regex module):

Segments Header size Wall time
20 1.4 KB 0.022 s
40 2.9 KB 0.43 s
80 5.8 KB 12 s
160 (extrapolated) 13 KB ~5 min

cProfile attributes 83% of wall time to re.Pattern.search called from routing.parserouting. The parse completes normally (no exception) - it is pure CPU exhaustion.

This is distinct from GHSA-g47v-rwmh-r9f8 (recursion DoS in get_raw_body_text(), fixed via MULTIPART_RECURSION_LIMIT - different function and mechanism) and from issue #48 (old url_regex_simple body-path hang; body regexes now run on ~600-char slices, capping impact - the Received-header path is unsliced).

PoC

import eml_parser

seg = 'from h{0}.example.com by mx{0}.example.com with esmtp for u{0}@example.com '
received = ''.join(seg.format(i) for i in range(80)) + ';Mon, 01 Jan 2024 00:00:00 +0000(comment'
# NB: unbalanced '(' in the date tail -> the normalized date literal never occurs in the
# searched line, so the dynamic 4-group greedy regex can never match and backtracks O(n^4).

eml = (
    'Received: ' + received + '\r\n'
    'From: attacker@evil.example\r\n'
    'To: victim@target.example\r\n'
    'Subject: poc\r\n'
    'Content-Type: text/plain\r\n'
    '\r\n'
    'hello\r\n'
).encode()

import time
t0 = time.perf_counter()
eml_parser.EmlParser().decode_email_bytes(eml)
print(f'{time.perf_counter() - t0:.2f}s')   # ~12 s for a 5.9 KB input

Observed on v3.0.3: eml size: 5887 bytes, decode_email_bytes() wall time: 12.33s, message parses fine. Affected APIs: decode_email, decode_email_bytes, parse_email.

Impact

Algorithmic-complexity denial of service. Any application that parses untrusted email with eml_parser (mail gateways, phishing-analysis and forensics pipelines, ticketing systems) can have a parser worker pinned by a single small email; an attacker sending a steady trickle of such messages keeps workers permanently busy (CPU exhaustion, queue backlog) even behind per-message timeouts. No crash, corruption, or information leak - availability impact only.

Reporter credit: Niranjan Ganesan (https://securityinsights.io/, @iam-niranjan)

Resolution

An algorithmic complexity vulnerability ($O(n^4)$ ReDoS) in eml_parser.routing.parserouting() was resolved.

Previously, parserouting() dynamically constructed a regex using multiple greedy .* capture groups appended with a normalized date string (npdate). Because npdate was extracted from a normalized copy of the Received header line, formatting mismatches between npdate and the un-normalized input line could render the trailing literal unmatchable. This forced the engine into exhaustive backtracking across nested greedy groups on unmatchable inputs, causing high CPU consumption and potential worker hangs on malicious headers.

Fix:

  1. Dynamic Regex Construction: Removed the static npdate suffix from the compiled pattern, replacing it with non-greedy field capture groups (.*?) terminated lazily by a semicolon or end-of-line anchor ((?:;|$)).
  2. Keyword Ordering Logic: Streamlined the routing keyword position detection to a single-pass str.find() search, removing $O(k^2)$ matrix evaluations.

These changes eliminate catastrophic backtracking and reduce processing time from $O(n^4)$ to linear $O(n)$ complexity.

Database specific
{
    "cwe_ids": [
        "CWE-1333",
        "CWE-407"
    ],
    "github_reviewed": true,
    "github_reviewed_at": "2026-11-19T22:47:08Z",
    "nvd_published_at": "2026-11-16T19:17:40Z",
    "severity": "MODERATE"
}
References

Affected packages

PyPI / eml-parser

Package

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

Affected ranges

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

Affected versions

0.*
0.9
1.*
1.0
1.1
1.3
1.4
1.5
1.6
1.7
1.8
1.9
1.10
1.11
1.11.1
1.11.2
1.11.4
1.11.5
1.11.6
1.11.7
1.12.0
1.13.0
1.14.0
1.14.1
1.14.2
1.14.3
1.14.4
1.14.5
1.14.6
1.14.7
1.14.8
1.15.0
1.16.0
1.17.0
1.17.1
1.17.2
1.17.3
1.17.4
1.17.5
2.*
2.0.0
2.0.1
3.*
3.0.0
3.0.1
3.0.2
3.0.3

Database specific

last_known_affected_version_range
"<= 3.0.3"
source
"https://github.com/github/advisory-database/blob/main/advisories/github-reviewed/2026/11/GHSA-m4g8-47f9-h588/GHSA-m4g8-47f9-h588.json"