Skip to content

tls: reject trust-store certificates that carry an unhandled critical extension - #38548

Open
robobun wants to merge 2 commits into
mainfrom
farm/437ef0d6/tls-anchor-critical-ext
Open

robobun wants to merge 2 commits into
mainfrom
farm/437ef0d6/tls-anchor-critical-ext

Conversation

@robobun

@robobun robobun commented Aug 14, 2026 •

Copy link
Copy Markdown
Collaborator

Problem

  • Every Bun TLS client and server path accepts a chain whose trust anchor carries a critical extension BoringSSL does not implement: tls.connect({ ca }) reports authorized: true, fetch(url, { tls: { ca } }) returns 200, the HTTP/3 client and node:quic accept too. Node (OpenSSL) rejects the same chain with UNSPECIFIED / unhandled critical extension, and openssl verify fails with error 34 at 1 depth lookup: unhandled critical extension.
  • The same extension on the leaf or on a peer-sent intermediate is already rejected. Only certificates that come out of the trust store are exempt: the anchor, an intermediate configured via ca, or a self-signed certificate pinned via ca: [cert].
  • Cause: BoringSSL's check_chain_extensions() (crypto/x509/x509_vfy.cc) loops for (i = 0; i < ctx->last_untrusted; i++), so the EXFLAG_CRITICAL check never runs on store certificates. OpenSSL walks the whole chain. Nothing in Bun compensated.
  • Practical effect: a constraint a CA places on itself through a critical extension is silently ignored when that CA is the anchor, where Node fails closed. The 121 bundled Mozilla roots are not affected (their only critical extensions are basicConstraints and keyUsage, both implemented), so this only changes behavior for user-supplied CAs (ca, caFile, NODE_EXTRA_CA_CERTS, system CAs).

Fix

  • openssl.c: us_internal_verify_cert_chain() runs X509_verify_cert() and, when the chain came back clean, checks every chain certificate that is neither the leaf nor one of the peer-sent certificates (X509_STORE_CTX_get0_untrusted) for EXFLAG_CRITICAL. Pointer identity is the right test because BoringSSL puts the store's own X509 objects in the chain, never the peer's copies, and those store objects are exactly the ones it skipped.
  • On a hit it sets X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION on the store context and passes it to the socket's verify callback, the same hand-off BoringSSL uses for its own errors. With us_verify_callback the handshake continues and JS sees authorizationError; with the inline-reject callback the error is recorded and the handshake fails; with no callback (node:quic, HTTP/3 client) it is fatal. Existing error reporting is untouched, so the anchor case now reports exactly what the leaf case already reported on each path (UNSPECIFIED + unhandled critical extension on node:tls and node:quic, UNHANDLED_CRITICAL_EXTENSION on fetch).
  • The wrapper is installed with SSL_CTX_set_cert_verify_callback in us_ssl_ctx_build_raw, which every TCP TLS context (node:tls, Bun.connect/listen, fetch, Bun.serve, SQL, HTTP/3 server) goes through; node:quic's TlsContext installs it on its own SSL_CTX; the HTTP/3 client's custom_verify (quic.c), which bypasses SSL_CTX verification, calls the wrapper instead of X509_verify_cert directly.
  • Only an otherwise clean chain gets the new error, so chains that already fail keep reporting the error they reported before.
  • Verified with new tests, all of which fail on the current release and pass with this change:
    • test/js/node/tls/node-tls-cert.test.ts: CA-issued leaf rejected under the anchor with the extension and accepted under the same CA key without it, pinned self-signed certificate, rejectUnauthorized error code and message, server-side requestCert verification.
    • test/js/node/tls/fetch-tls-cert.test.ts: fetch with tls.ca.
    • test/js/web/fetch/fetch-http3-client.test.ts: HTTP/3 client, anchor supplied through NODE_EXTRA_CA_CERTS.
    • test/js/node/quic/quic-sni.test.ts: node:quic validationErrorCode / validationErrorReason.
    • Expectations were checked against Node v26.3.0 running the same fixtures.
    • test/js/node/tls/ and the 245 upstream test-tls-* / test-https-* tests still pass with the change (the allowPartialTrustChain tests included).
  • Fixtures: one EC key behind two self-signed CA certificates that differ only in a 1.2.3.4.5.6.7.99 critical extension, plus a leaf issued with that key, so the extension on the anchor is the only variable between the rejected and accepted cases. The regeneration recipe is in the test file.
  • Touches the same hook as tls: reject SHA-1-signed certificates during client chain verification #35184, which also wraps X509_verify_cert for the SHA-1 policy; whichever lands second needs a small rebase.

Background

  • Chain verification in BoringSSL builds a chain from the peer's certificates plus certificates found in the trust store, then runs per-certificate checks. last_untrusted marks where the peer-sent part ends; everything past it was taken from the store and BoringSSL trusts it by fiat, including skipping the check for critical extensions it cannot interpret. An X.509 extension marked critical means "reject this certificate if you do not understand this extension"; EXFLAG_CRITICAL is the flag BoringSSL computes for a certificate that has such an extension.
  • SSL_CTX_set_cert_verify_callback replaces the X509_verify_cert call BoringSSL makes during the handshake with an application function that receives the prepared X509_STORE_CTX. BoringSSL reads the verify result out of that context afterwards, so an error set there with X509_STORE_CTX_set_error becomes SSL_get_verify_result(), which is what authorizationError, the fetch error and node:quic's validation fields are derived from.
  • Bun's TCP contexts install a per-certificate verify callback (SSL_set_verify) that BoringSSL consults for each error it finds: us_verify_callback returns 1 so the handshake completes and JS applies rejectUnauthorized; us_inline_reject_verify_callback records the error so the handshake is failed on the wire. The wrapper routes its error through the same callback so both models keep working unchanged.
  • The HTTP/3 client uses SSL_set_custom_verify, which replaces BoringSSL's X.509 verification entirely and therefore never reaches an SSL_CTX level callback; that is why quic.c calls the wrapper itself.
Repro against the release (throwaway CA with one extra critical extension)
$ openssl verify -CAfile ca.pem leaf.pem
error 34 at 1 depth lookup: unhandled critical extension

# server presents leaf.pem; client:
tls.connect({ port, servername: "localhost", ca: [ca] }, ...)
  bun 1.4.0 : connected, authorized=true
  node 26.3 : error code=UNSPECIFIED message=unhandled critical extension
# same with the ca.pem itself presented by the server and pinned via ca: [ca]
# fetch(url, { tls: { ca: [ca] } }) -> 200 on bun; h3 fetch with NODE_EXTRA_CA_CERTS=ca.pem -> 200 on bun

[review] gate passed · iteration 4 · 12 files touched

fails on main (without fix)
ASAN without fix: 7 failed, 6 skipped
$ BUN_DEBUG_QUIET_LOGS=1 bun scripts/build.ts --profile=debug --quiet test "--reporter=junit" "--reporter-outfile=/tmp/mechgate.xml" test/js/node/quic/quic-sni.test.ts test/js/node/tls/fetch-tls-cert.test.ts test/js/node/tls/node-tls-cert.test.ts "test/js/web/fetch/fetch-http3-client.test.ts"
bun test v1.4.1 (65362b53b)

test/js/web/fetch/fetch-http3-client.test.ts:
(pass) fetch protocol: http3 > GET text [41.20ms]
(pass) fetch protocol: http3 > 'h3' alias [13.04ms]
(pass) fetch protocol: http3 > POST echo with headers [22.62ms]
(pass) fetch protocol: http3 > JSON + query string [16.22ms]
(pass) fetch protocol: http3 > route params [22.33ms]
(pass) fetch protocol: http3 > large response body (multi-packet) [19.78ms]
(pass) fetch protocol: http3 > large request body [20.86ms]
(pass) fetch protocol: http3 > compress: gzip request body — small (shared-buffer fast path) [31.74ms]
(pass) fetch protocol: http3 > compress: gzip request body — large (zlib-streaming spill path) [15.50ms]
(pass) fetch protocol: http3 > status 200 [12.75ms]
(pass) fetch protocol: http3 > status 204 [7.00ms]
(pass) fetch protocol: http3 > status 404 [6.26ms]
(pass) fetch protocol: http3 > s
... (truncated)

release without fix: 7 failed, 6 skipped
bun test v1.4.1-canary.1 (65362b53b)

test/js/web/fetch/fetch-http3-client.test.ts:
(pass) fetch protocol: http3 > GET text [6.71ms]
(pass) fetch protocol: http3 > 'h3' alias [0.94ms]
(pass) fetch protocol: http3 > POST echo with headers [0.74ms]
(pass) fetch protocol: http3 > JSON + query string [0.53ms]
(pass) fetch protocol: http3 > route params [0.31ms]
(pass) fetch protocol: http3 > large response body (multi-packet) [1.77ms]
(pass) fetch protocol: http3 > large request body [2.38ms]
(pass) fetch protocol: http3 > compress: gzip request body — small (shared-buffer fast path) [1.03ms]
(pass) fetch protocol: http3 > compress: gzip request body — large (zlib-streaming spill path) [1.89ms]
(pass) fetch protocol: http3 > status 200 [0.46ms]
(pass) fetch protocol: http3 > status 204 [0.15ms]
(pass) fetch protocol: http3 > status 404 [0.13ms]
(pass) fetch protocol: http3 > status 500 [0.12ms]
(pass) fetch protocol: http3 > HEAD has no body [0.31ms]
(pass) fetch protocol: http3 > the response to a 204 has a null body [0.31ms]
(pass) fetch protocol: http3 > the response to a 304 has a null body [0.13ms]
(pass) fetch protocol: http3 > the response to a HEAD request h
... (truncated)
passes on PR (with fix)
ASAN with fix: 6 skipped
$ BUN_DEBUG_QUIET_LOGS=1 bun scripts/build.ts --profile=debug --quiet test "--reporter=junit" "--reporter-outfile=/tmp/mechgate.xml" test/js/node/quic/quic-sni.test.ts test/js/node/tls/fetch-tls-cert.test.ts test/js/node/tls/node-tls-cert.test.ts "test/js/web/fetch/fetch-http3-client.test.ts"
bun test v1.4.1 (65362b53b)

test/js/web/fetch/fetch-http3-client.test.ts:
(pass) fetch protocol: http3 > GET text [36.75ms]
(pass) fetch protocol: http3 > 'h3' alias [8.49ms]
(pass) fetch protocol: http3 > POST echo with headers [18.67ms]
(pass) fetch protocol: http3 > JSON + query string [13.54ms]
(pass) fetch protocol: http3 > route params [13.79ms]
(pass) fetch protocol: http3 > large response body (multi-packet) [21.81ms]
(pass) fetch protocol: http3 > large request body [24.20ms]
(pass) fetch protocol: http3 > compress: gzip request body — small (shared-buffer fast path) [41.32ms]
(pass) fetch protocol: http3 > compress: gzip request body — large (zlib-streaming spill path) [16.87ms]
(pass) fetch protocol: http3 > status 200 [14.62ms]
(pass) fetch protocol: http3 > status 204 [7.11ms]
(pass) fetch protocol: http3 > status 404 [5.92ms]
(pass) fetch protocol: http3 > st
... (truncated)

release with fix: 6 skipped
$ bun scripts/build.ts --profile=release
[configured] bun-profile → bun (stripped)
  target       linux-x64-gnu
  build type   Release
  build dir    ./build/release
  revision     e8b2cc0541
  features     baseline

23 deps, 131 codegen, 1172 objects in 761ms

ninja: Entering directory `/workspace/bun/build/release'
[1/1244] install /workspace/bun
bun install v1.4.1-canary.1 (65362b53b)

Checked 26 installs across 63 packages (no changes) [12.00ms]
[2/1244] gen ErrorCode+*.h
[3/1244] install /workspace/bun/packages/bun-error
bun install v1.4.1-canary.1 (65362b53b)

Checked 1 install across 2 packages (no changes) [4.00ms]
[4/1244] fetch tinycc
[tinycc] up to date
[5/1243] fetch zlib
[zlib] up to date
[6/1243] fetch libjpeg-turbo
[libjpeg-turbo] up to date
[7/1216] gen bake.{client,server,error}.js
-> bake.client.js, bake.server.js, bake.error.js
[8/1216] gen bindgenv2
[9/1216] install /workspace/bun/src/node-fallbacks
bun install v1.4.1-canary.1 (65362b53b)

Checked 111 installs across 104 packages (no changes) [8.00ms]
[10/1216] gen ProcessBindingConstants.lut.h
Generating /workspace/bun/build/release/codegen/ProcessBindingConstants.lut.h from /workspace/bun/src
... (truncated)
diff hotspot
packages/bun-usockets/src/crypto/openssl.c         |  61 ++++++++++
 packages/bun-usockets/src/quic.c                   |  10 +-
 src/runtime/node/quic/tls.rs                       |   6 +
 test/js/node/quic/quic-sni.test.ts                 |  40 ++++++-
 test/js/node/tls/fetch-tls-cert.test.ts            |  25 ++++
 .../tls/fixtures/critical-ext-anchor-ca-cert.pem   |  12 ++
 .../tls/fixtures/critical-ext-anchor-ca-key.pem    |   5 +
 .../fixtures/critical-ext-anchor-ca-plain-cert.pem |  11 ++
 .../tls/fixtures/critical-ext-anchor-leaf-cert.pem |  11 ++
 .../tls/fixtures/critical-ext-anchor-leaf-key.pem  |   5 +
 test/js/node/tls/node-tls-cert.test.ts             | 126 ++++++++++++++++++++-
 test/js/web/fetch/fetch-http3-client.test.ts       |  41 +++++++
 12 files changed, 347 insertions(+), 6 deletions(-)

gate history · 2 passed · 0 rejected · iteration 4

evidence per changed file
file                                                      reads  edits  tests
packages/bun-usockets/src/crypto/openssl.c                    5      4      0
packages/bun-usockets/src/quic.c                              2      3      0
src/runtime/node/quic/tls.rs                                  4      4      0
test/js/node/quic/quic-sni.test.ts                            1      0      0
test/js/node/tls/fetch-tls-cert.test.ts                       1      0      0
…st/js/node/tls/fixtures/critical-ext-anchor-ca-cert.pem      0      0      0
test/js/node/tls/fixtures/critical-ext-anchor-ca-key.pem      0      0      0
…node/tls/fixtures/critical-ext-anchor-ca-plain-cert.pem      0      0      0
…/js/node/tls/fixtures/critical-ext-anchor-leaf-cert.pem      0      0      0
…t/js/node/tls/fixtures/critical-ext-anchor-leaf-key.pem      0      0      0
test/js/node/tls/node-tls-cert.test.ts                        2      1      0
test/js/web/fetch/fetch-http3-client.test.ts                  0      0      0

@coderabbitai

coderabbitai Bot commented Aug 14, 2026 •

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

  • Run on-demand review

On-demand reviews are free for the next 24 days. After that, they cost $0.25 per reviewed file.

Or wait 17 minutes for your next included review.

View limit details

Limit details: You’ve used all 5 included reviews currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 3c9bd7a9-7283-43e8-9b62-9f87475349e3

📥 Commits

Reviewing files that changed from the base of the PR and between 49ff888 and e8b2cc0.

⛔ Files ignored due to path filters (5)
  • test/js/node/tls/fixtures/critical-ext-anchor-ca-cert.pem is excluded by !**/*.pem
  • test/js/node/tls/fixtures/critical-ext-anchor-ca-key.pem is excluded by !**/*.pem
  • test/js/node/tls/fixtures/critical-ext-anchor-ca-plain-cert.pem is excluded by !**/*.pem
  • test/js/node/tls/fixtures/critical-ext-anchor-leaf-cert.pem is excluded by !**/*.pem
  • test/js/node/tls/fixtures/critical-ext-anchor-leaf-key.pem is excluded by !**/*.pem
📒 Files selected for processing (7)
  • packages/bun-usockets/src/crypto/openssl.c
  • packages/bun-usockets/src/quic.c
  • src/runtime/node/quic/tls.rs
  • test/js/node/quic/quic-sni.test.ts
  • test/js/node/tls/fetch-tls-cert.test.ts
  • test/js/node/tls/node-tls-cert.test.ts
  • test/js/web/fetch/fetch-http3-client.test.ts

Comment @coderabbitai help to get the list of available commands.

@robobun

robobun commented Aug 14, 2026 •

Copy link
Copy Markdown
Collaborator Author

Status: ready for review; waiting on a maintainer.

Reproduced on bun 1.4.0 with a throwaway CA whose only unusual property is one extra critical extension (1.2.3.4.5.6.7.99): tls.connect({ ca }) reported authorized: true, fetch with tls.ca returned 200, an HTTP/3 fetch with the CA in NODE_EXTRA_CA_CERTS returned 200, and node:quic reported no validation error, while Node v26.3.0 rejected the same server with UNSPECIFIED / unhandled critical extension and openssl verify failed with error 34. The same extension on the leaf was already rejected on every path, so only store-sourced certificates were exempt.

The new tests in node-tls-cert.test.ts, fetch-tls-cert.test.ts, fetch-http3-client.test.ts and quic-sni.test.ts fail on the release and pass with this branch; test/js/node/tls/ and the upstream test-tls-* / test-https-* suites still pass with the change.

Rebased onto main (the node:quic context builder now uses OwnedSslCtx; the one conflict was re-adding the verifier call after it). CI on the rebased head (build 107228): 180 of 181 jobs passed, including the macOS lanes this time; the fail-without / pass-with check passed on the ASAN and release builds. The one failing job is darwin any x64 - test-bun on test/js/web/url/url.test.ts (an ICU IDNA expectation), which fails on main too and is unrelated to TLS.

The automated review found nothing to change. The open question is the policy one: this makes Bun follow OpenSSL/Node in checking trust-store certificates for unknown critical extensions instead of BoringSSL's anchors-are-trusted-as-is behavior. The bundled roots are unaffected either way; it only matters for user-supplied CAs.

@claude claude Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reviewed this PR and didn't find any bugs. Because it installs a new cert_verify_callback on every TLS context and changes the certificate-verification verdict across every path (node:tls, fetch, Bun.serve, HTTP/3, node:quic), a human look would still be worthwhile — and the PR itself flags a rebase interaction with #35184 on the same hook.

What was reviewed:

  • The wrapper only tightens verification on chains that were already X509_V_OK, so existing failure codes are preserved.
  • Verify-callback hand-off matches the two existing callbacks (us_verify_callback returns 1, inline-reject records the error) and falls closed with no callback.
  • SSL_CTX_set_cert_verify_callback is not set anywhere else in the tree, so nothing is being overwritten.
  • Test coverage spans client/server, rejectUnauthorized on/off, pinned self-signed, fetch, h3, and node:quic, each paired with the plain-anchor accepted case.
Extended reasoning...

Overview

This PR wraps X509_verify_cert in us_internal_verify_cert_chain (openssl.c) and installs it via SSL_CTX_set_cert_verify_callback on every TCP TLS context built by us_ssl_ctx_build_raw, on the node:quic Rust TlsContext, and calls it directly from the HTTP/3 client's custom_verify in quic.c. After a clean X509_verify_cert, it walks the built chain and rejects any store-sourced certificate (identified by pointer identity against X509_STORE_CTX_get0_untrusted and the leaf) that carries EXFLAG_CRITICAL, matching OpenSSL/Node behaviour where BoringSSL skips that check for trusted certificates. Five PEM fixtures and four test files exercise node:tls (client and server verification, both rejectUnauthorized modes, pinned self-signed), fetch, the HTTP/3 client via NODE_EXTRA_CA_CERTS, and node:quic.

Security risks

This is squarely security-sensitive: it replaces BoringSSL's default chain-verification entry point on every SSL_CTX in the process. The direction of the change is fail-closed (previously-accepted chains now reject), which is the safer direction, and the extra check only runs after X509_verify_cert already returned OK, so it cannot loosen anything. The verify-callback dispatch mirrors what BoringSSL does for its own errors, and SSL_get_verify_callback is checked for NULL. I confirmed no other SSL_CTX_set_cert_verify_callback exists in the tree that this would clobber. Still, any change that intercepts every TLS chain verification for every subsystem warrants a maintainer's eyes.

Level of scrutiny

High. Per the review guidelines this falls under "never remove [or change] a flag you don't understand in a TLS/crypto path" territory — it's an intentional, well-reasoned change, but it globally alters how peer certificates are verified, and the PR description itself notes it collides with #35184 on the same hook, so whichever lands second needs a rebase.

Other factors

The tests are thorough (positive and negative controls for each path, exact error code/message assertions matching Node), fixtures are documented with a regeneration recipe, and the PR states the full test/js/node/tls/ suite plus 245 upstream test-tls-*/test-https-* tests still pass. The implementation is small and readable. Deferring solely because TLS verification is not something to auto-approve.

… extension

BoringSSL's check_chain_extensions() only examines the untrusted part of
a chain, so a certificate taken from the trust store (the anchor, an
intermediate configured via `ca`, or a pinned self-signed certificate)
verified cleanly even when it carried a critical extension BoringSSL does
not implement. OpenSSL checks every certificate in the chain, so node
rejects those chains with X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION.

Wrap X509_verify_cert in a cert_verify_callback installed on every
SSL_CTX usockets builds, and on node:quic's contexts, that applies the
same check to the store-sourced certificates of an otherwise valid chain
and hands the error to the per-socket verify callback like any other
verification error. The HTTP/3 client's custom_verify calls the same
wrapper.
@robobun
robobun force-pushed the farm/437ef0d6/tls-anchor-critical-ext branch from 4858340 to 4f859fd Compare August 28, 2026 03:25
Comment thread src/runtime/node/quic/tls.rs Outdated
@robobun

robobun commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator Author
Updated 8:50 PM PT - Aug 27th, 2026

❌ @robobun, your commit e8b2cc0 has 1 failures in Build #107228 (All Failures):


🧪   To try this PR locally:

bunx bun-pr 38548

That installs a local version of the PR into your bun-38548 executable, so you can run:

bun-38548 --bun

@claude claude Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code review found no issues

No high-confidence issues detected in this change.

Jarred-Sumner added a commit that referenced this pull request Oct 10, 2026
…ps, WebSocket, SQL) (#44618)

### What does this PR do?

Consolidates the open TLS pull requests into one. Each was reproduced on
`main` and, for `node:*` behavior, on Node v26.3.0 first. About a third
are ported as written, the rest are rewritten smaller or merged into one
fix where several PRs patched the same cause. One commit per fix, so it
can be read commit by commit.

Fixes #43520, fixes #31396, fixes #43635, fixes #37193, fixes #43846,
fixes #17932, fixes #41061, fixes #36887, fixes #31810, fixes #35240,
fixes #32234, fixes #44365, fixes #43807, fixes #42280, fixes #44517.
Addresses #41856 (SNI and `servername`; not `checkServerIdentity` for
SQL), #24845 (the spin is gone, shown with fault injection on Linux; not
run on macOS), #19754 (node-fetch forwards the agent's TLS options; the
Kubernetes client itself was not run).

#### The ones that matter most

| | On `main` | PRs |
|---|---|---|
| Client certificate disclosure | `https.request()` with a client
certificate sends it to a server it then refuses (wrong name,
`checkServerIdentity`, `destroy()` in `'secureConnect'`, `terminate()`
in `handshake`). A server can force it with a junk record behind its
Finished | #43946 |
| False `authorized` | Over a Duplex, `secureConnect` with `authorized
=== true` for a peer that failed the key proof; `secureConnect` for a
plaintext peer with `rejectUnauthorized: false` | #44422, #32929 |
| Cleartext https | `https.createServer()` without a usable key/cert
answers plain HTTP | #41672, #33539 |
| Revoked client certificates | An https mTLS server never sees `crl`,
so a revoked client is `authorized` | #41641 |
| Pooled sockets | Requests with different client certificates or CAs
share an `https.Agent` socket and session | #42498 |
| Silent plaintext | `tls: [...]` given to `Bun.listen` / `Bun.connect`
is plain TCP | #41490 |
| Server weakened by a client knob | `NODE_TLS_REJECT_UNAUTHORIZED=0`
turns off a server's client-certificate enforcement | #35245 |
| Pins never checked | `WebSocket` never calls `tls.checkServerIdentity`
and ignores `tls.serverName` | #41648 |
| `verify-full` dropped | `PGSSLMODE=verify-*` is lost next to a `TLS_*`
URL variable; `tls: true` sends no SNI | #44498 |
| Crashes | use-after-free from `destroy()` in `ALPNCallback` over a
Duplex; `abort()` on a late `setSession()`; SIGABRT in `fetch` with an
https proxy from the environment and a `Bun.file()` body | #44462,
#41671, #44458 |
| Stream corruption | A TLS `write()` can lose 16 KiB it reported as
written while another socket on the loop is stalled | #44529 |
| Hangs and spins | 100% CPU on a failing `send()`; a fatal `SSL_write`
leaves the socket open forever; `idleTimeout` never sheds a TLS client
that ignores `close_notify` | #34510, #38176, #42336 |
| Wrong certificate (regression since 1.3.14) | Connections accepted
before `stop()` / `close()` get the default certificate and skip their
entry's `requestCert` / `ca` | #42355 |
| Quadratic Duplex / proxy tunnel | Reading one chunk over a Duplex,
CPU: 8 MB 0.88 s → 0.14 s, 16 MB 3.18 s → 0.23 s, 32 MB 11.75 s → 0.39
s; `fetch` upload through CONNECT: 1.7 s → 0.18 s (debug build) | #44464
|

#### By area

- **fd engine, write path** (`openssl.c`, `socket.c`): #42352, #34510 +
#38176 + #42336 as one change, #44529, #44458, #44192. A rejected
`send()` ends the write side only and closes at the next writable event
unless the peer's bytes are still queued (a 413 sent before a reset is
still read). No new per-socket state. Also, on kqueue, **a FIN no longer
ends a socket that waits in the low-priority queue** (`loop.c`): with
more than 5 TLS handshakes at once, a client that ended right after its
handshake could be reset and its server socket report `socket hang up`,
because the eof that the sentinel read knote reports was acted on ahead
of the unread Finished. That is on `main` too (the macOS entry for
`node-tls-server.test.ts` in `test/flaky-tests.txt`: 7 of 48 recent
builds of other branches), and this branch made it likelier (6 of 8
builds), since Finished now leaves in one segment with the close_notify.
- **Error reporting, both engines**: #44422, #32929, #44516, #37094,
#41272 + #42324 + #44223 as one change, #44021, #37472, #43946, #33630.
One channel: a fatal error on an established session is reported, then
**the engine closes the connection itself**, whatever the owner does
with the report. `test/js/bun/net/tls-fatal-error-closes.test.ts`
asserts closed-and-nothing-delivered for every owner (node:tls,
`Bun.connect`, `Bun.listen`, `fetch` direct and through CONNECT,
`Bun.serve`, `WebSocket` direct and through a proxy, Postgres, MySQL,
Valkey, Duplex).
- **Duplex engine** (`SSLWrapper`, `UpgradedDuplex`): #44462, #43529,
#42332, #44464. #43877 + #44394 were in and are **out again**, see
"Worth a look" 5.
- **node:tls wrap lifecycle** (`net.ts`, `tls.ts`): #38007, #38058,
#38028 + #38122 + #38076 as one change (six copies of the attach code
become two helpers), #38311, #39008, #38154, #42340 + #42343 + #42339 +
#42453 as one change, #43791, #42425, #44085, #42683, #39088, #39040,
#40375, and what was still real of #36534.
- **SNI, ALPN, server contexts**: #43080, #42050, #37195 + #43849 as one
change (**one** SNI matcher for TCP and HTTP/3), #42355, #42285, #33253,
part of #37896, part of #37013. A `tls.Server` has one `SSL_CTX`.
- **Verification and options**: #44738, #41490, #37005 + the cwd pin of
#40984, #31811, #43982, #33483 + #35245, #41810, #32235, #44441, #38092.
- **node:tls API and CA store**: #41671, #38145, #32824, #43594, #39997,
#41696, #33534, #34748, #42991, #42996, #42970.
- **node:https, Agent, `ws`, node-fetch**: #41672 (https half), #41641,
#38261, #42498, #44346, #35609, #31397, #42325.
- **WebSocket client**: #41648, #37487 + #43048 as one change.
- **SQL, Redis**: #33666, #41711, #44498, part of #42054.
- **Tests only**: #41426, #40040, #44395, #44016, #37860, #40591,
#44440, #41424.

Found on the way and fixed here: an upload that a TLS 1.2 server
interrupts with a renegotiation never completes on `main` (0 of 32 runs
over `https.request`, `fetch`, `node:tls` and `Bun.connect`: the
renegotiation ClientHello lands inside an application record that is
still unsent, or the socket gets no `drain` again) and completes here,
with two tests from robobun; the fix for #40653 (final flight and first
write in one segment) stopped working whenever another TLS socket on the
loop was stalled, on `main` too; the `tls.Server` prototype pinned the
last server constructed and every `SSL_CTX` it owned;
`Object.create(process.env).NODE_TLS_REJECT_UNAUTHORIZED = "0"` turned
verification off process-wide once a `SHARE_ENV` worker existed; two
debug panics when wrapping a shut-down or still-connecting socket; a
`fetch` POST through a proxy sent its headers twice when the origin
renegotiated; `BlockList` ignored IPv6 zone ids; a test now ties
`root_certs.der` to `certdata.txt`.

#### Behavior changes

- **A server's `ca` without `requestCert` no longer asks for a client
certificate** (`Bun.serve`, `Bun.listen`, HTTP/3, node:tls). It matches
the docs and Node. On `main` such a server refused clients with no
certificate but served any unrelated self-signed one, so it was never
authentication. **Set `requestCert: true` to require a certificate.** A
matrix test pins that `requestCert: true` still refuses no certificate
and an untrusted one on 8 kinds of server, TLS 1.2 and 1.3, with
`NODE_TLS_REJECT_UNAUTHORIZED` unset and `0`.
- `NODE_TLS_REJECT_UNAUTHORIZED=0` no longer relaxes a server.
- `Bun.connect` / `Bun.listen` hear of a fatal TLS error after the
handshake through `error(socket, err)`. With no `error` handler the
socket just closes.
- HTTP/3 server names match like TCP: `*.` covers exactly one label,
case is ignored, a trailing dot is ignored, the last registration of a
name wins.
- `requestCert` on node:https is `=== true`, as in Node.
- An array where a generated options dictionary is expected throws
(`tls: []`, `jest.useFakeTimers([])`).
- `key` / `cert` arrays serve every identity. A client that can use both
gets ECDSA, where `main` served whichever pair came last.
- `ecdhCurve` is forwarded by node:https, `ws` and node-fetch now, so a
group BoringSSL lacks (`X448`) throws there as it already does in
`tls.createServer`.
- A wrapped socket's error is re-emitted on the TLS socket as in Node,
so `raw.destroy(err)` with a listener on `raw` only is uncaught, as in
Node.
- `sql.options.tls` is always an object, never `true`. `RedisClient`
sends SNI.
- `tls: { secureContext }` alone asks for TLS on `Bun.listen` /
`Bun.connect` (it was plain TCP), and a value that is not a
`SecureContext` throws. The context is served as it is: the
`requestCert` / `rejectUnauthorized` it was created with hold whatever
the options next to it say, and `requestCert` in the options over a
context that does not ask throws at `listen()`.
- `tls.DEFAULT_CIPHERS` reaches every client once assigned (`fetch`,
`WebSocket`, `Bun.connect`, `RedisClient`, `Bun.SQL`, `S3Client`, proxy
tunnels) and servers again. A list that selects no cipher throws
`ERR_SSL_NO_CIPHER_MATCH` at the assignment. `fetch.preconnect()` dials
nothing after an assignment.
- The warning for an unreadable `NODE_EXTRA_CA_CERTS` is Node's one
line, without the `warn:` prefix.
- `BUN_CONFIG_WS_CLOSE_TIMEOUT` (default 30 s): how long a `WebSocket`
client waits for the server to close the connection after the closing
handshake.

#### Worth a look in review

1. **#44529**: the kernel-refused remainder of a TLS write moves from
the loop's one slot onto the connection (in the existing rare struct),
so the write BIO never refuses a sealed record. Nothing is allocated on
an unstalled path (200 writes: 0 appends, same `send()` count as
`main`), memory with 16 stalled writers is lower than on `main` (276 KB
vs 340 KB, which `main` holds inside BoringSSL's buffers), `us_socket_t`
stays 80 bytes. It needs a bound on how long a deferred close waits, or
a peer that stops reading pins the fd past `destroy()`:
`US_SSL_CLOSE_AFTER_SPILL_TIMEOUT` is a fixed 10 s, not re-armed on
progress. Separate commits, but the fix that keeps the client
certificate off the wire beside a stalled socket builds on them.
2. **The default name check of node:tls also runs inside the
handshake**, so a wrong-name server gets no client certificate on TLS
1.2 either. JS still runs it after every successful handshake, so a
difference between the two matchers can only refuse. Error objects are
byte-identical.
3. **#44441** widens trust by design: a self-issued leaf whose
`keyUsage` lacks `keyCertSign` (`dotnet dev-certs`) is its own anchor
when the store holds a byte-identical copy. No BoringSSL change. Expired
pin, same subject with another key, wrong EKU and a pinned intermediate
are tested to fail.
4. **#32235** only adds Ed25519 and ECDSA P-521 to the verify list. A
captured ClientHello shows `main`'s list with the two inserted;
`rsa_pkcs1_sha1` stays.

5. **A stream that a TLS socket wraps, when that TLS socket closes.** An
earlier state of this branch lost data here while CI was green (found by
#44709's report): with the peer closing first, 4 of 8 MiB arrived with
TLS in TLS, 4 of 32 MiB on the http2 `emit("connection")` path, and a
`write()` with no `'error'` listener ended the process. Three
Node-parity changes only hold together: destroying the wrapped stream at
the close (#38028 + #38122 + #38076, #38154) is safe only if every write
has really completed (#43877), which in turn needs Node's handling of
the peer's close_notify, which needs half-open sockets that the GC can
collect. So:
- #43877 + #44394 are reverted and reopened. A write over a stream
completes once the stream has taken the ciphertext, as on `main`.
- Until the verdict on the peer lets the session through, the
application cannot have written over it. There the wrapped stream is
destroyed as in Node, with the sessions below it. That keeps the release
of the connection after a failed handshake, a rejected certificate and
an early `destroy()`. The same for an http2 socket the application never
got, and for `resetAndDestroy()`.
- After that it is `main`'s teardown: a `net.Socket` only gets the
engine's `end()`, closes at its peer's FIN, keeps its own timeout and
reports its own errors. Any other stream is destroyed with the TLS
socket.

The regular suites cannot see any of this (999 files were green on every
broken variant), so it was steered by eleven seeded differential fuzzers
run on this build, `main`, Node v26.3.0 and the earlier state: close,
`end()`, `destroy()`, `destroySoon()`, resets, hung and half-open peers,
paused writers, timeouts, two and three sessions deep, over TCP and over
Duplexes, before, at and after the handshake, and http2 requests. See
"How did you verify".

#### Known limits

- `fetch` with a `checkServerIdentity` function still sends the client
certificate (not the request) to a server the function refuses. On TLS
1.2 any verdict a JS callback gives is too late, as in Node.
- `addContext()` / `SNICallback` still do not apply to a server-side
socket on the stream engine (`emit("connection", duplex)`, TLS in TLS,
unflushed writes, named pipes), as on `main`.
- A CA bundled in a pfx extends an explicit `ca` only, for `ws` /
node-fetch / `WebSocket`: the native `ca` can only replace the default
store, and that store keeps `SSL_CERT_FILE` / `SSL_CERT_DIR`.
- P-521 leaves work on TLS 1.3 only. TLS 1.2 needs secp521r1 in every
ClientHello (`it.todo`).
- Once `tls.DEFAULT_CIPHERS` is assigned, `fetch(url, { protocol:
"http3" })` is `HTTP3Unsupported`, as with an explicit `ciphers`.
- `addCACert()` by hand does not extend the chains of a context with
several identities.
- A throwing `ALPNCallback` sends `no_application_protocol` on both
engines. Node sends nothing and its client sees `ECONNRESET`.
- TLS in TLS, peer FIN while the outer handshake runs: the inner socket
gets one `write EPIPE`, where Node gives `ECONNRESET` (`main` gives it
no error at all).
- `@SECLEVEL` in `ciphers` is dropped by the `ws` / node-fetch shims,
which used to ignore `ciphers`. node:tls keeps throwing
`ERR_SSL_INVALID_COMMAND`.
- Beside a stalled TLS socket only the first record (16 KiB) of the
first write leaves with the handshake flight. The rest goes record by
record, which is what bounds the memory of stalled writers.
- After a fatal error on an established session the socket emits
`'error'` and then `'close'`. Node emits `'error'` and leaves the socket
open.
- A paused reader whose own write the kernel rejects loses what it had
not read yet, with an `EPIPE`, as on Node. `main` reports no error there
and delivers it.
- On `main` too: a `Bun.listen` socket without `allowHalfOpen` that has
unsent ciphertext when the client's `shutdown()` arrives loses that
ciphertext (32 KiB), and over plain TCP `end()` with the peer still
sending is a close over unread input, so a reset.
- Differences from both `main` and Node that the differential runs below
found and that stay, all with a peer that aborts: `ECONNRESET` instead
of a clean `'end'` after the socket's own `'finish'` when the peer
destroyed with unread data; under TLS 1.2, a zero-length `write()`
followed by `destroy()` in `'secureConnection'` leaves the client
without `'secureConnect'` (a plain `destroy()` there matches Node); a
TLS 1.2 client that destroys in `'secureConnect'` gets no `'session'`; a
`ClientRequest` whose handshake fails with an alert emits `'error'` and
`'close'` but no `'finish'` (`writableFinished` is true).
- Once `tls.DEFAULT_CIPHERS` is assigned, `fetch.preconnect()` opens
nothing: `fetch()` then uses a context of its own, and a socket warmed
under the default one would never be picked up.
- A TLS `send()` that the kernel refuses outside a `write()` call (the
drain of unsent ciphertext) is reported with the close, as `read EPIPE`
/ `read ECONNRESET`. Node says `write EPIPE`. `main` does not report it
at all.
- Once the application has a session over a `net.Socket` (TLS in TLS,
http2 `emit("connection")`), a peer that never sends its FIN holds that
socket after the TLS socket closed, as on `main`. Node destroys it. Two
tests of #38154 are `todo` for this. Closing it any earlier (at its
`'finish'`, say) makes the kernel drop what it has not sent yet as soon
as the peer's close_notify arrives.
- Plaintext that was queued on a socket before it was wrapped (STARTTLS
with a backlog) is dropped when the TLS socket is destroyed, or its
handshake fails, before the session is accepted. Node drops it too,
except on `destroySoon()`. `main` sends it.
- Over a stream that is no `net.Socket`, `end()` can still cut what that
stream has buffered, and there is no backpressure, both as on `main`
(#43877).
- `tls.secureContext` (the undocumented door node:tls uses) is not read
by a Windows named pipe listener, which builds its context from the
options. On `upgradeTLS({ isServer: true })` the options next to it are
the policy, as with Node's `SetVerifyMode`.
- `selectServerName()` rebuilds the name tree per ClientHello for
injected sockets of a server with `addContext()` entries: 0.4 µs for 1
entry, 3.7 µs for 10, 41 µs for 100, against 631–1111 µs for a
handshake.

#### Not included

Left open, because they need a decision or are not TLS: #43877 + #44394
(see "Worth a look" 5; #43874 stays open with them), #38548, #38591
(both shrink who is trusted), #41589 (`verify-full` vs
`NODE_TLS_REJECT_UNAUTHORIZED=0`), #37197, #41706, #43216, #33487,
#33545, #36707, #32435, #37255, #28691, #40275, #30314 (features),
#38120 (needs the BoringSSL fork, as did #33517, which the stale bot has
closed since), #38529 (needs a Windows measurement), #34342, #38232,
#43089, #44454, #40451, #42710, #44527, #38088, #38093, #41898. #37896,
#42054 and #37013 stay open for the halves not taken.
`http.createServer({ key, cert })` keeps serving TLS on purpose.

One open question: `tls: {}` (an object that names no TLS option) is
plain TCP on `Bun.listen` / `Bun.connect`, here and on `main`. It is the
same trap as `tls: []`, but changing it changes a Bun default, so it is
left alone.

### How did you verify your code works?

- Every new test fails on `main` for the stated reason and passes here,
except guards that pin existing behavior, each shown to fail when its
clause is removed. `node:*` tests also pass on Node v26.3.0; the few
that cannot say which Node version has the behavior.
- 212 test files that touch TLS, sockets, http, http2, fetch, WebSocket,
SQL, Valkey and workers: 6154 pass, 2 fail. Both are seen on `main` too:
`serve.test.ts` "root range port" (the box runs as root), and
`worker_threads.test.ts` "terminate(): nothing of the worker's runs
after the request", which is flaky there and passed in the run below.
- 58 of those files the way the ASAN lane runs them (LeakSanitizer +
`BUN_JSC_validateExceptionChecks`): 58 files, 48 of them with leak
checking, 4132 pass, 3 fail. All three also fail on `main`:
`serve.test.ts` "root range port", `node-net.test.ts` "should not leak
when connect({path}) fails synchronously on a reused handle" (times out
under this environment), `worker_threads.test.ts` "process.exit() with a
shell cp in flight" (a `ShellCpTask` leak).
- 647 vendored `test-tls-*`, `test-https-*`, `test-net-*`,
`test-http2-*`: the only two failures also fail on `main`.
- The SNI matcher was diffed against both old matchers: 3 seeds × 1.23 M
lookups × 3 registration flavours, every difference in one of the
intended classes, TCP and HTTP/3 identical on every lookup.
- The headline rows were also driven by hand with scripts against this
build, `main` and Node v26.3.0: cleartext https, `crl`, `tls: []` / `{
secureContext }`, the `ca` / `requestCert` matrix, the client
certificate on a wrong-name server, late `setSession()`, `destroy()` in
`ALPNCallback`, `[rsa, ec]` identities with an intermediate from `ca`,
`WebSocket` `checkServerIdentity`, a corrupted record, the Duplex read
above, `tls.DEFAULT_CIPHERS`.
- The `setSession()` guard was checked against the real `abort()` at 43
handshake states.
- `bun run rust:check-all`: 12 of 12 targets. `tsc`, oxlint, source
lints, prettier, rustfmt, mordant clean.
- usockets' `_Nonnull` is compiled out of debug builds, so 105 of those
files were also run on a local release ASAN build with the CI runner's
environment (92 with leak checking): 4595 pass, 1 fail,
`child_process.test.ts` "spawn reports EPERM after dropping privileges",
which cannot pass as root and fails on `main` too.
- The close of a TLS socket over another stream ("Worth a look" 5):
eleven seeded differential fuzzers, 8,424 scenarios compared, each run
on a release ASAN build of this branch, on `main`, on Node v26.3.0 and
on the earlier state of the branch. Against `main`:
- Data that `main` delivers in full is cut in 5 scenarios, and about 150
that `main` cuts arrive in full. Of the 5, in 2 `main` never notices the
peer's close and keeps the socket for good, 2 call `end()` on the middle
one of three sessions over an in-memory Duplex, and 1 does the same on
Node.
- No dead timeout, no silent reset and no uncaught error that `main`
does not have (4 uncaught errors fewer).
- A socket stays open where `main` closes it in 109, and closes where
`main` keeps it in 295. 92 of the 109 do the same on Node or on the
earlier state (a `destroy()` that an in-memory Duplex does not show its
peer, half-open peers). 14 wait for a peer that paused reading and so
does not read the FIN (#42332's backpressure, as in Node); the socket's
own timeout fires there. 3 are left: one on a 5 ms timer, two with three
sessions over an in-memory Duplex.
- The earlier state of the branch cut data in 173 of the 400 scenarios
of one of them, where `main` cuts none and this cuts none.
- 23 new tests pin what they found. Each earlier attempt at this fix
fails the ones that describe it, the earlier state of the branch fails
7, and all pass on Node.
- After that change: 999 test files on the release ASAN build (20,246
pass; the 11 files that fail need a database, Docker, DNS or a non-root
user, or share a temp directory with a parallel run and pass alone), 61
on the debug build.
- TLS over a file descriptor (`openssl.c`, the path of `fetch`,
`Bun.serve`, `tls.connect`, `Bun.connect`) got the same treatment after
the rebase: seeded differential fuzzers on CI's release build of this
branch, on `main` and, for `node:*`, on Node v26.3.0. Every runtime also
against itself for the noise floor, injected faults and known bugs of
`main` as positive controls, and a difference counts only if it shows in
5 of 5 fresh processes.
- `node:tls` over TCP: 11,500 scenarios (one connection with Node as the
oracle line by line; 2 to 60 connections beside stalled neighbours; raw
peers that break the handshake). HTTPS: about 136,000 runs over
`Bun.serve` + `fetch`, `node:https`, `node:http2` and `wss://`, also
with the two ends in different runtimes. `Bun.connect` / `Bun.listen` /
`upgradeTLS`: 11,500 scenarios and 720 slow connections, with writers
driven by what `write()` returns, beside up to 6 stalled, dripping,
closing or resetting neighbours, and plain TCP as a second oracle. No
crash, hang, duplication, reordering or silent truncation, and no change
in time or in connection reuse.
- They found six things that `main` does better, none of which any test
showed. All are fixed, each with a test that fails on the build before:
what the peer sent lost behind a rejected `send()` (23 scenarios, and an
early HTTPS response lost with only `EPIPE`), the same silently for a
paused reader, `server.close()` never calling back on a half-open server
after a ClientHello and a reset (17), `closeAllConnections()` taking 12
s with a stalled client, `end()` losing up to 1.3 of 4 MiB that
`write()` had reported while the peer still uploads, and `end()` a
little after a stall never closing beside other stalled TLS sockets. The
last two fixes also deliver the 1 to 2 MiB that `main` loses there, and
close the socket that `main` keeps for good without such neighbours.
- All of them again after every fix, on CI's release build of it. That
caught one regression of a fix itself (a reader stopped for backpressure
lost 86,385 bytes, 1 of 6,000 scenarios), fixed too. On the last build:
scenarios that lose data where `main` does not 23 → 2, and Node loses it
in both, with the same `EPIPE`; `server.close()` that never calls back
17 → 0; connections held 4 → 0; requests that end in an error only where
`main` has a response 6 → 0. With a Node server in another process, a
request ends in an error only in 8 and 10 of 1,500 scenarios here, 5 and
3 on `main`, 10 with Node as the client.
- `Bun.connect` / `Bun.listen` on the last build against `main`, in
scenarios: hangs 0 against 1,031, sockets and fds never released 0
against 965, corrupted data 0 against 345, `abort()` 0 against 26
(`setSession()` after the handshake), writers that never close 0 against
101 of 720 connections. No kind of failure shows here and not on `main`.
About a third of the slow connections close later than on `main`, in 1
to 16 s instead of at once, waiting for unsent ciphertext or for the
peer's close_notify, and 79 more of them deliver all that `write()`
reported. RSS and time with 16 to 256 stalled writers are the same.
- What they found that `main` does worse: a `WebSocket` that calls
`close()` with sends pending loses messages in 81 of 999 scenarios (0
here), 37 server sockets left open, 10 `server.close()` that never call
back, 20 write callbacks that never run.
- The kqueue fix cannot be run on Linux. The `connectionListener` count
test now says what became of a missing connection, which is how the
cause was found (`'tlsClientError'` "socket hang up", then `read
ECONNRESET` at the client of the same port, after its
`'secureConnect'`). On macOS x64 it failed every attempt of the three
builds before the fix and passed at the first attempt of the build with
it.
- Windows and macOS were only run by CI. Four new tests asserted what
only the Linux kernel does (a FIN read ahead of a reset, unread bytes
surviving a reset, loopback buffer sizes, `fstat()` on a socket) and now
say so per platform.

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: robobun <117481402+robobun@users.noreply.github.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants