Skip to content

🚨 [security] Update koa 3.1.1 → 3.1.2 (patch)#644

Open
depfu[bot] wants to merge 1 commit intomasterfrom
depfu/update/yarn/koa-3.1.2
Open

🚨 [security] Update koa 3.1.1 → 3.1.2 (patch)#644
depfu[bot] wants to merge 1 commit intomasterfrom
depfu/update/yarn/koa-3.1.2

Conversation

@depfu
Copy link
Contributor

@depfu depfu bot commented Feb 27, 2026


🚨 Your current dependencies have known security vulnerabilities 🚨

This dependency update fixes known security vulnerabilities. Please see the details below and assess their impact carefully. We recommend to merge and deploy this as soon as possible!


Here is everything you need to know about this update. Please take a good look at what changed and the test results before merging this pull request.

What changed?

✳️ koa (3.1.1 → 3.1.2) · Repo · Changelog

Security Advisories 🚨

🚨 Koa has Host Header Injection via ctx.hostname

Summary

Koa's ctx.hostname API performs naive parsing of the HTTP Host header, extracting everything before the first colon without validating the input conforms to RFC 3986 hostname syntax. When a malformed Host header containing a @ symbol (e.g., evil.com:fake@legitimate.com) is received, ctx.hostname returns evil.com - an attacker-controlled value. Applications using ctx.hostname for URL generation, password reset links, email verification URLs, or routing decisions are vulnerable to Host header injection attacks.

Details

The vulnerability exists in Koa's hostname getter in lib/request.js:

// Koa 2.16.1 - lib/request.js
get hostname() {
  const host = this.host;
  if (!host) return '';
  if ('[' === host[0]) return this.URL.hostname || ''; // IPv6 literal
  return host.split(':', 1)[0];
}

The host getter retrieves the raw header value with HTTP/2 and proxy support:

// Koa 2.16.1 - lib/request.js
get host() {
  const proxy = this.app.proxy;
  let host = proxy && this.get('X-Forwarded-Host');
  if (!host) {
    if (this.req.httpVersionMajor >= 2) host = this.get(':authority');
    if (!host) host = this.get('Host');
  }
  if (!host) return '';
  return host.split(',')[0].trim();
}

The Problem

The parsing logic simply splits on the first : and returns the first segment. There is no validation that the resulting string is a valid hostname per RFC 3986 Section 3.2.2.

RFC 3986 Section 3.2.2 defines the host component as:

host = IP-literal / IPv4address / reg-name
reg-name = *( unreserved / pct-encoded / sub-delims )
unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
sub-delims = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "="

The @ character is explicitly NOT permitted in the host component - it is the delimiter separating userinfo from host in the authority component.

Attack Vector

When an attacker sends:

Host: evil.com:fake@legitimate.com:3000

Koa parses this as:

API Returns Notes
ctx.get('Host') "evil.com:fake@legitimate.com:3000" Raw header
ctx.hostname "evil.com" Attacker-controlled
ctx.host "evil.com:fake@legitimate.com:3000" Raw header value
ctx.origin "http://evil.com:fake@legitimate.com:3000" Protocol + malformed host

The ctx.hostname API returns evil.com because the parser splits on the first : without understanding that evil.com:fake@legitimate.com is a malformed authority component where evil.com:fake would be interpreted as userinfo by a proper URI parser.

Additional Concern: ctx.origin

Koa's ctx.origin property concatenates protocol and host without validation:

// lib/request.js
get origin() {
  return `${this.protocol}://${this.host}`;
}

Applications using ctx.origin for URL generation receive the full malformed Host header value, creating URLs with embedded credentials that browsers may interpret as userinfo.

HTTP/2 Consideration

Koa explicitly checks httpVersionMajor >= 2 to read the :authority pseudo-header:

if (this.req.httpVersionMajor >= 2) host = this.get(':authority');

The same vulnerability applies - malformed :authority values containing userinfo would be accepted and parsed identically.

PoC

Setup

// server.js
const Koa = require('koa'); 
const app = new Koa();

// Simulates password reset URL generation (common vulnerable pattern)
app.use(async ctx => {
if (ctx.path === '/forgot-password') {
const resetToken = 'abc123securtoken';
const resetUrl = <span class="pl-s1"><span class="pl-kos">${</span><span class="pl-s1">ctx</span><span class="pl-kos">.</span><span class="pl-c1">protocol</span><span class="pl-kos">}</span></span>://<span class="pl-s1"><span class="pl-kos">${</span><span class="pl-s1">ctx</span><span class="pl-kos">.</span><span class="pl-c1">hostname</span><span class="pl-kos">}</span></span>/reset?token=<span class="pl-s1"><span class="pl-kos">${</span><span class="pl-s1">resetToken</span><span class="pl-kos">}</span></span>;

<span class="pl-s1">ctx</span><span class="pl-kos">.</span><span class="pl-c1">body</span> <span class="pl-c1">=</span> <span class="pl-kos">{</span>
  <span class="pl-c1">message</span>: <span class="pl-s">'Password reset link generated'</span><span class="pl-kos">,</span>
  <span class="pl-c1">resetUrl</span>: <span class="pl-s1">resetUrl</span><span class="pl-kos">,</span>
  <span class="pl-c1">debug</span>: <span class="pl-kos">{</span>
    <span class="pl-c1">rawHost</span>: <span class="pl-s1">ctx</span><span class="pl-kos">.</span><span class="pl-en">get</span><span class="pl-kos">(</span><span class="pl-s">'Host'</span><span class="pl-kos">)</span><span class="pl-kos">,</span>
    <span class="pl-c1">parsedHostname</span>: <span class="pl-s1">ctx</span><span class="pl-kos">.</span><span class="pl-c1">hostname</span><span class="pl-kos">,</span>
    <span class="pl-c1">origin</span>: <span class="pl-s1">ctx</span><span class="pl-kos">.</span><span class="pl-c1">origin</span><span class="pl-kos">,</span>
    <span class="pl-c1">protocol</span>: <span class="pl-s1">ctx</span><span class="pl-kos">.</span><span class="pl-c1">protocol</span>
  <span class="pl-kos">}</span>
<span class="pl-kos">}</span><span class="pl-kos">;</span>

}
});

app.listen(3000, () => console.log('Server on http://localhost:3000'));

Exploit

curl -H "Host: evil.com:fake@localhost:3000" http://localhost:3000/forgot-password

Result

{
  "message": "Password reset link generated",
  "resetUrl": "http://evil.com/reset?token=abc123securtoken",
  "debug": {
    "rawHost": "evil.com:fake@localhost:3000",
    "parsedHostname": "evil.com",
    "origin": "http://evil.com:fake@localhost:3000",
    "protocol": "http"
  }
}

The password reset URL points to evil.com instead of the legitimate server. In a real attack:

  1. Attacker requests password reset for victim's email with malicious Host header
  2. Server generates reset link using ctx.hostnamehttps://evil.com/reset?token=SECRET
  3. Victim receives email with poisoned link
  4. Victim clicks link, token is sent to attacker's server
  5. Attacker uses token to reset victim's password

Additional Test Cases

# Basic injection
curl -H "Host: evil.com:x@legitimate.com" http://localhost:3000/forgot-password
# Result: hostname = "evil.com"

# With port preservation attempt
curl -H "Host: evil.com:443@legitimate.com:3000" http://localhost:3000/forgot-password
# Result: hostname = "evil.com"

# Unicode/encoded variations
curl -H "Host: evil.com:x%40legitimate.com" http://localhost:3000/forgot-password
# Result: hostname = "evil.com"

Deployment Consideration

For this attack to succeed in production, the malicious Host header must reach the Koa application. This occurs when:

  1. No reverse proxy - Application directly exposed to internet
  2. Misconfigured proxy - Proxy doesn't override/validate Host header
  3. Proxy trust enabled (app.proxy = true) - X-Forwarded-Host can be injected
  4. Default virtual host - Server is the catch-all for unrecognized Host headers

Impact

Vulnerability Type

  • CWE-20: Improper Input Validation
  • CWE-644: Improper Neutralization of HTTP Headers for Scripting Syntax

Attack Scenarios

1. Password Reset Poisoning (High Severity)

  • Attacker hijacks password reset tokens by poisoning reset URLs
  • Requires victim to click link in email
  • Results in account takeover

2. Email Verification Bypass

  • Attacker poisons email verification links
  • Can verify attacker-controlled email on victim accounts

3. OAuth/SSO Callback Manipulation

  • Applications using ctx.hostname for OAuth redirect URIs
  • Attacker redirects OAuth callbacks to malicious server
  • Results in token theft

4. Web Cache Poisoning

  • If responses are cached without Host in cache key
  • Poisoned URLs served to all users
  • Persistent XSS/phishing via cached responses

5. Server-Side Request Forgery (SSRF)

  • Internal routing decisions based on ctx.hostname
  • Attacker manipulates which backend receives requests

Who Is Impacted

  • Direct impact: Any Koa application using ctx.hostname or ctx.origin for URL generation without additional validation
  • Common patterns: Password reset, email verification, webhook URL generation, multi-tenant routing, OAuth implementations
Release Notes

3.1.2

What's Changed

New Contributors

Full Changelog: v3.1.1...v3.1.2

Does any of this look wrong? Please let us know.

Commits

See the full diff on Github. The new version differs by 9 commits:


Depfu Status

Depfu will automatically keep this PR conflict-free, as long as you don't add any commits to this branch yourself. You can also trigger a rebase manually by commenting with @depfu rebase.

All Depfu comment commands
@​depfu rebase
Rebases against your default branch and redoes this update
@​depfu recreate
Recreates this PR, overwriting any edits that you've made to it
@​depfu merge
Merges this PR once your tests are passing and conflicts are resolved
@​depfu cancel merge
Cancels automatic merging of this PR
@​depfu close
Closes this PR and deletes the branch
@​depfu reopen
Restores the branch and reopens this PR (if it's closed)
@​depfu pause
Ignores all future updates for this dependency and closes this PR
@​depfu pause [minor|major]
Ignores all future minor/major updates for this dependency and closes this PR
@​depfu resume
Future versions of this dependency will create PRs again (leaves this PR as is)

@depfu depfu bot added the dependencies Pull requests that update a dependency file label Feb 27, 2026
@depfu depfu bot requested a review from canova as a code owner February 27, 2026 00:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants