Skip to content

Commit 2e5685d

Browse files
fix: preserve server identity check when omitting SNI
When a socket is passed to `tls.connect()` without a `host` option, the certificate identity check falls back to `options.servername || options.host || options.socket._host || 'localhost'`. Setting `servername` to an empty string for IP addresses therefore caused the server's certificate to be validated against `'localhost'` instead of the IP address, breaking connections to IP addresses that use `trustServerCertificate: false` with a certificate carrying matching `IP Address` SANs. Pass the target host explicitly so that certificate validation keeps using it while the SNI extension remains omitted for IP addresses. The IPv6 test is skipped on Node.js versions affected by nodejs/node#64144, where `tls.checkServerIdentity()` cannot match IPv6 addresses against `IP Address` SANs at all. Co-Authored-By: Claude Fable 5 <[email protected]>
1 parent 19afe9a commit 2e5685d

4 files changed

Lines changed: 195 additions & 2 deletions

File tree

‎src/message-io.ts‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,12 @@ class MessageIO extends EventEmitter {
7373
const securePair = this.securePair = {
7474
cleartext: tls.connect({
7575
socket: duplexpair.socket1 as Socket,
76+
// The `host` is used to verify the server's certificate identity.
77+
// It is not used to establish a connection as a `socket` is
78+
// specified.
79+
host: hostname,
80+
// RFC 6066 does not allow IP addresses to be used as the server
81+
// name, so omit the SNI extension in that case.
7682
servername: isIP(hostname) ? '' : hostname,
7783
secureContext: secureContext,
7884
rejectUnauthorized: !trustServerCertificate

‎test/fixtures/loopback-ip.crt‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
-----BEGIN CERTIFICATE-----
2+
MIIDOzCCAiOgAwIBAgIUOagp5aI+GnvGz2kGV/dacO4z8+kwDQYJKoZIhvcNAQEL
3+
BQAwEzERMA8GA1UEAwwIbG9vcGJhY2swIBcNMjYwNzE3MTA1MTI5WhgPMjEyNjA2
4+
MjMxMDUxMjlaMBMxETAPBgNVBAMMCGxvb3BiYWNrMIIBIjANBgkqhkiG9w0BAQEF
5+
AAOCAQ8AMIIBCgKCAQEArSY7wJmq2PkFrf5/U9cAQmBhQiMhMKSav4may7JXEqyJ
6+
iS1esCDBk4kr0tdWAFX7od3l4Kmd21LfsqNCAdiJqsOpxc51CdyTp1gSAiesHOee
7+
b9t9fDvRu5vnRYWkAg3JHf4En09LGpnVMJ0fS9g9Jj5Oj+W+RTOnHZ5C5ZJgumhz
8+
TCv3UxfEoFA009hNHf0qYRGWJUG27Wcuo6AakPhJAaMhVQfi730AsIJkkHMSZWDa
9+
+CjhaNALLtNsyL9uUROtITZX/oX95ke8RCFB1oZ2Tq45MdWcj8OHY1t7c7tpOl/f
10+
tmbc3casio21iDiYe6FR29XE3+qNg6D04YdRE7VM/wIDAQABo4GEMIGBMB0GA1Ud
11+
DgQWBBThheYYWTAI/HjE2Oq6YLP/YdF55DAfBgNVHSMEGDAWgBThheYYWTAI/HjE
12+
2Oq6YLP/YdF55DAPBgNVHRMBAf8EBTADAQH/MCEGA1UdEQQaMBiHBH8AAAGHEAAA
13+
AAAAAAAAAAAAAAAAAAEwCwYDVR0PBAQDAgWgMA0GCSqGSIb3DQEBCwUAA4IBAQBu
14+
vUt7/fKxpuvhzScGfYcrDXHCVPBYG31PiqB3E95AWxSxE9pwAczVWiG8hm8ObhHy
15+
V2UD0D0oZhrrqfGfiIpdggvO7GZot6oZbBj9G9OrxDvjniKJ1ZFoDD+aMruA+Ulg
16+
6bm2fg1GRyYtON9zc+uTgDeCQxe3vuW59+z0r4+M4jdbA9DDjU1PGWkjbTspKUuA
17+
e1+Ceb5RWseBNCkS39oq5IX6av3CwboxEn35xAZGO4HZD9WIiMUbm3Zh7RU3ylrQ
18+
A9heYMjqxteiYQBXHK0A08CFLoXJAkPYtNRePVS99Hwn0tL4NCQCEDvDyDDkmFEr
19+
Il8meQR4AMX5EoAjl5D3
20+
-----END CERTIFICATE-----

‎test/fixtures/loopback-ip.key‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
-----BEGIN PRIVATE KEY-----
2+
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCtJjvAmarY+QWt
3+
/n9T1wBCYGFCIyEwpJq/iZrLslcSrImJLV6wIMGTiSvS11YAVfuh3eXgqZ3bUt+y
4+
o0IB2Imqw6nFznUJ3JOnWBICJ6wc555v2318O9G7m+dFhaQCDckd/gSfT0samdUw
5+
nR9L2D0mPk6P5b5FM6cdnkLlkmC6aHNMK/dTF8SgUDTT2E0d/SphEZYlQbbtZy6j
6+
oBqQ+EkBoyFVB+LvfQCwgmSQcxJlYNr4KOFo0Asu02zIv25RE60hNlf+hf3mR7xE
7+
IUHWhnZOrjkx1ZyPw4djW3tzu2k6X9+2ZtzdxqyKjbWIOJh7oVHb1cTf6o2DoPTh
8+
h1ETtUz/AgMBAAECggEAU2MYX7chyoCTNapdE7l1jIHyFPHqKAz94cSZYgQvXvTs
9+
/71z3orH7w+epVnDN0Ixf1DoRnwpY9jTlqp9PXpVQoIcnwDA6NDr4ynM8nC8uObr
10+
LJ+eHViJtzpr9NVZmQueke0luLttRhBT1ae1zMcFHAfhufdA3P71OpRfT0RhhSPA
11+
LLj8q26e21RVViCS6rlTyPqZwTAM8+numV455t5N651MGchbUmnFfTCmgL5g9DlV
12+
dDSMSC3izH3XvrcN0LKp9ILopJNi2nQikA75KYDeiz2J36WIUJFuddUpmw+CywAg
13+
tZtx0A0UpXPCojFzoYUB0boBfUbAtP+LCf4CYeeZYQKBgQDtnU6JJVM2a/1ntTIu
14+
GIKjIgXb0jJYA0j9EFdJegQmsIcn9CFdr4na9Bl0QeFtPoQ9LaQRry92pFzXL07U
15+
X6ASF7cv5FTjU3cDD+GgOdPDIwjZ1c4jVInNqt1JDodAreSxRAxK9f/kMRHBEdco
16+
va6oB9XJJDoKyylTEbYT8CapZwKBgQC6i/6Pi0sp40CUGHPr9co5GiuEXyWkeZQX
17+
Xb65diSVN9ufpUnz4LvY5o27lxcr0oE9gDSjXj9Fw3p98XAcQb8txapUkjPE0zmb
18+
XsUxlC5kfiJnJxXUk6uME+xl0T/rqc2bo68K9VS0Hcim6+RydZvQ4oUj43bGyk89
19+
KGW7ehHIqQKBgFAXN8OOay/q0m1Ea/eRl2b5LtRbU1DLOqzh9ynzELchxUy4Qw7a
20+
/jJpGLNRCXTTH6unWKgFTpBE8m4tqfp3iPLQP5TK97nwBitoDPr+wtwBURhrsqHB
21+
+vjx4MihNwGcG3uMnkAeDvSRfZSAOO+oj9hfW7YCmfXNaM5xJ9gsmDt9AoGANdcf
22+
4ogeanmHcvbXxjuLYQ23j53yfFUGs/O/j0GU72hOv/XxsSykqsZoE8NY0bIQ0RJG
23+
nvwdoOH5YY4kgFNNfUV2krAbtuwLzVb97QBKn4B0J3d1aoQwV96MNRq+qyK4D/qf
24+
E7eY+d86wUqGBa8CCLjIGoKVDmznj8wwCHsD1PkCgYEAvO+PBa7poGWmGfw04cJ5
25+
zt7vdjag/YNob95hbHAUaJ8V+5qi8hrF6EiztTSfu5pSUFcJn8Ir1PTL9lGQP48N
26+
Mtrc4cZ+rK8jTJq6zjAqzAZR8s1+9/cH8XQuZ9mqw7fc5HS3D+b6Pon3c5zYAwAV
27+
4lmBEggRtnMfLaIewQABj4s=
28+
-----END PRIVATE KEY-----

‎test/unit/message-io-test.ts‎

Lines changed: 141 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ import { once } from 'events';
33
import { assert } from 'chai';
44
import { promisify } from 'util';
55
import DuplexPair from 'native-duplexpair';
6-
import { TLSSocket } from 'tls';
6+
import { checkServerIdentity, type PeerCertificate, TLSSocket } from 'tls';
77
import { readFileSync } from 'fs';
88
import { Duplex } from 'stream';
99

@@ -339,7 +339,9 @@ describe('MessageIO', function() {
339339
});
340340

341341
describe('#startTls', function() {
342-
let securePair: { encrypted: Duplex, cleartext: TLSSocket };
342+
// `@types/node` does not declare the server-side `servername` getter
343+
// on `TLSSocket`, so widen the type here.
344+
let securePair: { encrypted: Duplex, cleartext: TLSSocket & { servername?: string } };
343345

344346
beforeEach(function() {
345347
const duplexpair = new DuplexPair();
@@ -362,6 +364,30 @@ describe('MessageIO', function() {
362364
securePair.encrypted.destroy();
363365
});
364366

367+
/**
368+
* Forwards TLS handshake data between the given `MessageIO` and the
369+
* server side of the secure pair, unwrapping it from / wrapping it into
370+
* `PRELOGIN` messages.
371+
*/
372+
async function forwardTlsHandshake(io: MessageIO, rounds: number) {
373+
for (let i = 0; i < rounds; i++) {
374+
const message = await io.readMessage();
375+
for await (const chunk of message) {
376+
securePair.encrypted.write(chunk);
377+
}
378+
379+
await once(securePair.encrypted, 'readable');
380+
381+
const chunks = [];
382+
let chunk;
383+
while (chunk = securePair.encrypted.read()) {
384+
chunks.push(chunk);
385+
}
386+
387+
io.sendMessage(TYPE.PRELOGIN, Buffer.concat(chunks));
388+
}
389+
}
390+
365391
it('performs TLS negotiation', async function() {
366392
await Promise.all([
367393
// Client side
@@ -517,6 +543,119 @@ describe('MessageIO', function() {
517543
]);
518544
});
519545

546+
it('sends the hostname via the SNI extension', async function() {
547+
await Promise.all([
548+
// Client side
549+
(async () => {
550+
const io = new MessageIO(clientConnection, packetSize, debug);
551+
552+
await io.startTls({}, 'localhost', true);
553+
554+
assert(io.tlsNegotiationComplete);
555+
})(),
556+
557+
// Server side
558+
(async () => {
559+
const io = new MessageIO(serverConnection, packetSize, debug);
560+
561+
const onSecure = once(securePair.cleartext, 'secure');
562+
563+
await forwardTlsHandshake(io, 2);
564+
565+
await onSecure;
566+
567+
assert.strictEqual(securePair.cleartext.servername, 'localhost');
568+
})()
569+
]);
570+
});
571+
572+
describe('when connecting to an IP address', function() {
573+
beforeEach(function() {
574+
// Replace the server side of the secure pair with one that uses a
575+
// certificate that carries IP address SANs (and no DNS SANs).
576+
securePair.cleartext.destroy();
577+
securePair.encrypted.destroy();
578+
579+
const duplexpair = new DuplexPair();
580+
581+
securePair = {
582+
cleartext: new TLSSocket(duplexpair.socket1 as Socket, {
583+
key: readFileSync('./test/fixtures/loopback-ip.key'),
584+
cert: readFileSync('./test/fixtures/loopback-ip.crt'),
585+
isServer: true,
586+
ciphers: 'ECDHE-RSA-AES128-GCM-SHA256',
587+
// TDS 7.x only supports TLS versions up to TLS v1.2
588+
maxVersion: 'TLSv1.2'
589+
}),
590+
encrypted: duplexpair.socket2
591+
};
592+
});
593+
594+
it('omits the SNI extension and validates the certificate against the IPv4 address', async function() {
595+
await Promise.all([
596+
// Client side
597+
(async () => {
598+
const io = new MessageIO(clientConnection, packetSize, debug);
599+
600+
await io.startTls({
601+
ca: [readFileSync('./test/fixtures/loopback-ip.crt')]
602+
}, '127.0.0.1', false);
603+
604+
assert(io.tlsNegotiationComplete);
605+
})(),
606+
607+
// Server side
608+
(async () => {
609+
const io = new MessageIO(serverConnection, packetSize, debug);
610+
611+
const onSecure = once(securePair.cleartext, 'secure');
612+
613+
await forwardTlsHandshake(io, 2);
614+
615+
await onSecure;
616+
617+
assert.notOk(securePair.cleartext.servername);
618+
})()
619+
]);
620+
});
621+
622+
it('omits the SNI extension and validates the certificate against the IPv6 address', async function() {
623+
// Some Node.js versions are affected by an upstream regression that
624+
// prevents IPv6 addresses from being matched against `IP Address`
625+
// SANs. See https://github.com/nodejs/node/issues/64144
626+
const cert = { subject: { CN: 'dummy' }, subjectaltname: 'IP Address:0:0:0:0:0:0:0:1' };
627+
if (checkServerIdentity('::1', cert as PeerCertificate) !== undefined) {
628+
this.skip();
629+
}
630+
631+
await Promise.all([
632+
// Client side
633+
(async () => {
634+
const io = new MessageIO(clientConnection, packetSize, debug);
635+
636+
await io.startTls({
637+
ca: [readFileSync('./test/fixtures/loopback-ip.crt')]
638+
}, '::1', false);
639+
640+
assert(io.tlsNegotiationComplete);
641+
})(),
642+
643+
// Server side
644+
(async () => {
645+
const io = new MessageIO(serverConnection, packetSize, debug);
646+
647+
const onSecure = once(securePair.cleartext, 'secure');
648+
649+
await forwardTlsHandshake(io, 2);
650+
651+
await onSecure;
652+
653+
assert.notOk(securePair.cleartext.servername);
654+
})()
655+
]);
656+
});
657+
});
658+
520659
it('handles errors happening before TLS negotiation has sent any data', async function() {
521660
await Promise.all([
522661
// Client side

0 commit comments

Comments
 (0)