blob: f811fb21d58c405b4d14c54a548933b1b386a078 [file] [log] [blame]
Adam Langley95c29f32014-06-20 12:00:00 -07001// Copyright 2009 The Go Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style
3// license that can be found in the LICENSE file.
4
5package main
6
7import (
David Benjamin83c0bc92014-08-04 01:23:53 -04008 "bytes"
Adam Langley95c29f32014-06-20 12:00:00 -07009 "crypto"
10 "crypto/ecdsa"
David Benjamind30a9902014-08-24 01:44:23 -040011 "crypto/elliptic"
Adam Langley95c29f32014-06-20 12:00:00 -070012 "crypto/rsa"
13 "crypto/subtle"
14 "crypto/x509"
15 "encoding/asn1"
16 "errors"
17 "fmt"
18 "io"
David Benjamind30a9902014-08-24 01:44:23 -040019 "math/big"
Adam Langley95c29f32014-06-20 12:00:00 -070020)
21
22// serverHandshakeState contains details of a server handshake in progress.
23// It's discarded once the handshake has completed.
24type serverHandshakeState struct {
25 c *Conn
26 clientHello *clientHelloMsg
27 hello *serverHelloMsg
28 suite *cipherSuite
29 ellipticOk bool
30 ecdsaOk bool
31 sessionState *sessionState
32 finishedHash finishedHash
33 masterSecret []byte
34 certsFromClient [][]byte
35 cert *Certificate
36}
37
38// serverHandshake performs a TLS handshake as a server.
39func (c *Conn) serverHandshake() error {
40 config := c.config
41
42 // If this is the first server handshake, we generate a random key to
43 // encrypt the tickets with.
44 config.serverInitOnce.Do(config.serverInit)
45
David Benjamin83c0bc92014-08-04 01:23:53 -040046 c.sendHandshakeSeq = 0
47 c.recvHandshakeSeq = 0
48
Adam Langley95c29f32014-06-20 12:00:00 -070049 hs := serverHandshakeState{
50 c: c,
51 }
52 isResume, err := hs.readClientHello()
53 if err != nil {
54 return err
55 }
56
57 // For an overview of TLS handshaking, see https://tools.ietf.org/html/rfc5246#section-7.3
58 if isResume {
59 // The client has included a session ticket and so we do an abbreviated handshake.
60 if err := hs.doResumeHandshake(); err != nil {
61 return err
62 }
63 if err := hs.establishKeys(); err != nil {
64 return err
65 }
David Benjaminbed9aae2014-08-07 19:13:38 -040066 if c.config.Bugs.RenewTicketOnResume {
67 if err := hs.sendSessionTicket(); err != nil {
68 return err
69 }
70 }
Adam Langley95c29f32014-06-20 12:00:00 -070071 if err := hs.sendFinished(); err != nil {
72 return err
73 }
David Benjamind30a9902014-08-24 01:44:23 -040074 if err := hs.readFinished(isResume); err != nil {
Adam Langley95c29f32014-06-20 12:00:00 -070075 return err
76 }
77 c.didResume = true
78 } else {
79 // The client didn't include a session ticket, or it wasn't
80 // valid so we do a full handshake.
81 if err := hs.doFullHandshake(); err != nil {
82 return err
83 }
84 if err := hs.establishKeys(); err != nil {
85 return err
86 }
David Benjamind30a9902014-08-24 01:44:23 -040087 if err := hs.readFinished(isResume); err != nil {
Adam Langley95c29f32014-06-20 12:00:00 -070088 return err
89 }
David Benjamine58c4f52014-08-24 03:47:07 -040090 if c.config.Bugs.ExpectFalseStart {
91 if err := c.readRecord(recordTypeApplicationData); err != nil {
92 return err
93 }
94 }
Adam Langley95c29f32014-06-20 12:00:00 -070095 if err := hs.sendSessionTicket(); err != nil {
96 return err
97 }
98 if err := hs.sendFinished(); err != nil {
99 return err
100 }
101 }
102 c.handshakeComplete = true
103
104 return nil
105}
106
107// readClientHello reads a ClientHello message from the client and decides
108// whether we will perform session resumption.
109func (hs *serverHandshakeState) readClientHello() (isResume bool, err error) {
110 config := hs.c.config
111 c := hs.c
112
113 msg, err := c.readHandshake()
114 if err != nil {
115 return false, err
116 }
117 var ok bool
118 hs.clientHello, ok = msg.(*clientHelloMsg)
119 if !ok {
120 c.sendAlert(alertUnexpectedMessage)
121 return false, unexpectedMessageError(hs.clientHello, msg)
122 }
Feng Lu41aa3252014-11-21 22:47:56 -0800123 if config.Bugs.RequireFastradioPadding && len(hs.clientHello.raw) < 1000 {
124 return false, errors.New("tls: ClientHello record size should be larger than 1000 bytes when padding enabled.")
125 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400126
127 if c.isDTLS && !config.Bugs.SkipHelloVerifyRequest {
David Benjamin8bc38f52014-08-16 12:07:27 -0400128 // Per RFC 6347, the version field in HelloVerifyRequest SHOULD
129 // be always DTLS 1.0
David Benjamin83c0bc92014-08-04 01:23:53 -0400130 helloVerifyRequest := &helloVerifyRequestMsg{
David Benjamin8bc38f52014-08-16 12:07:27 -0400131 vers: VersionTLS10,
David Benjamin83c0bc92014-08-04 01:23:53 -0400132 cookie: make([]byte, 32),
133 }
134 if _, err := io.ReadFull(c.config.rand(), helloVerifyRequest.cookie); err != nil {
135 c.sendAlert(alertInternalError)
136 return false, errors.New("dtls: short read from Rand: " + err.Error())
137 }
138 c.writeRecord(recordTypeHandshake, helloVerifyRequest.marshal())
139
140 msg, err := c.readHandshake()
141 if err != nil {
142 return false, err
143 }
144 newClientHello, ok := msg.(*clientHelloMsg)
145 if !ok {
146 c.sendAlert(alertUnexpectedMessage)
147 return false, unexpectedMessageError(hs.clientHello, msg)
148 }
149 if !bytes.Equal(newClientHello.cookie, helloVerifyRequest.cookie) {
150 return false, errors.New("dtls: invalid cookie")
151 }
David Benjaminf2fedef2014-08-16 01:37:34 -0400152
153 // Apart from the cookie, the two ClientHellos must
154 // match. Note that clientHello.equal compares the
155 // serialization, so we make a copy.
156 oldClientHelloCopy := *hs.clientHello
157 oldClientHelloCopy.raw = nil
158 oldClientHelloCopy.cookie = nil
159 newClientHelloCopy := *newClientHello
160 newClientHelloCopy.raw = nil
161 newClientHelloCopy.cookie = nil
162 if !oldClientHelloCopy.equal(&newClientHelloCopy) {
David Benjamin83c0bc92014-08-04 01:23:53 -0400163 return false, errors.New("dtls: retransmitted ClientHello does not match")
164 }
165 hs.clientHello = newClientHello
166 }
167
David Benjaminc44b1df2014-11-23 12:11:01 -0500168 if config.Bugs.RequireSameRenegoClientVersion && c.clientVersion != 0 {
169 if c.clientVersion != hs.clientHello.vers {
170 return false, fmt.Errorf("tls: client offered different version on renego")
171 }
172 }
173 c.clientVersion = hs.clientHello.vers
174
David Benjamin8bc38f52014-08-16 12:07:27 -0400175 c.vers, ok = config.mutualVersion(hs.clientHello.vers)
176 if !ok {
177 c.sendAlert(alertProtocolVersion)
178 return false, fmt.Errorf("tls: client offered an unsupported, maximum protocol version of %x", hs.clientHello.vers)
179 }
Adam Langley95c29f32014-06-20 12:00:00 -0700180 c.haveVers = true
181
182 hs.hello = new(serverHelloMsg)
David Benjamin83c0bc92014-08-04 01:23:53 -0400183 hs.hello.isDTLS = c.isDTLS
Adam Langley95c29f32014-06-20 12:00:00 -0700184
185 supportedCurve := false
186 preferredCurves := config.curvePreferences()
187Curves:
188 for _, curve := range hs.clientHello.supportedCurves {
189 for _, supported := range preferredCurves {
190 if supported == curve {
191 supportedCurve = true
192 break Curves
193 }
194 }
195 }
196
197 supportedPointFormat := false
198 for _, pointFormat := range hs.clientHello.supportedPoints {
199 if pointFormat == pointFormatUncompressed {
200 supportedPointFormat = true
201 break
202 }
203 }
204 hs.ellipticOk = supportedCurve && supportedPointFormat
205
206 foundCompression := false
207 // We only support null compression, so check that the client offered it.
208 for _, compression := range hs.clientHello.compressionMethods {
209 if compression == compressionNone {
210 foundCompression = true
211 break
212 }
213 }
214
215 if !foundCompression {
216 c.sendAlert(alertHandshakeFailure)
217 return false, errors.New("tls: client does not support uncompressed connections")
218 }
219
220 hs.hello.vers = c.vers
221 hs.hello.random = make([]byte, 32)
222 _, err = io.ReadFull(config.rand(), hs.hello.random)
223 if err != nil {
224 c.sendAlert(alertInternalError)
225 return false, err
226 }
Adam Langley2ae77d22014-10-28 17:29:33 -0700227
Adam Langleycf2d4f42014-10-28 19:06:14 -0700228 if !bytes.Equal(c.clientVerify, hs.clientHello.secureRenegotiation) {
Adam Langley2ae77d22014-10-28 17:29:33 -0700229 c.sendAlert(alertHandshakeFailure)
Adam Langleycf2d4f42014-10-28 19:06:14 -0700230 return false, errors.New("tls: renegotiation mismatch")
Adam Langley2ae77d22014-10-28 17:29:33 -0700231 }
Adam Langleycf2d4f42014-10-28 19:06:14 -0700232
233 if len(c.clientVerify) > 0 && !c.config.Bugs.EmptyRenegotiationInfo {
234 hs.hello.secureRenegotiation = append(hs.hello.secureRenegotiation, c.clientVerify...)
235 hs.hello.secureRenegotiation = append(hs.hello.secureRenegotiation, c.serverVerify...)
236 if c.config.Bugs.BadRenegotiationInfo {
237 hs.hello.secureRenegotiation[0] ^= 0x80
238 }
239 } else {
240 hs.hello.secureRenegotiation = hs.clientHello.secureRenegotiation
241 }
242
Adam Langley95c29f32014-06-20 12:00:00 -0700243 hs.hello.compressionMethod = compressionNone
David Benjamin35a7a442014-07-05 00:23:20 -0400244 hs.hello.duplicateExtension = c.config.Bugs.DuplicateExtension
Adam Langley95c29f32014-06-20 12:00:00 -0700245 if len(hs.clientHello.serverName) > 0 {
246 c.serverName = hs.clientHello.serverName
247 }
David Benjaminfa055a22014-09-15 16:51:51 -0400248
249 if len(hs.clientHello.alpnProtocols) > 0 {
250 if selectedProto, fallback := mutualProtocol(hs.clientHello.alpnProtocols, c.config.NextProtos); !fallback {
251 hs.hello.alpnProtocol = selectedProto
252 c.clientProtocol = selectedProto
David Benjaminfc7b0862014-09-06 13:21:53 -0400253 c.usedALPN = true
David Benjaminfa055a22014-09-15 16:51:51 -0400254 }
255 } else {
256 // Although sending an empty NPN extension is reasonable, Firefox has
257 // had a bug around this. Best to send nothing at all if
258 // config.NextProtos is empty. See
259 // https://code.google.com/p/go/issues/detail?id=5445.
260 if hs.clientHello.nextProtoNeg && len(config.NextProtos) > 0 {
261 hs.hello.nextProtoNeg = true
262 hs.hello.nextProtos = config.NextProtos
263 }
Adam Langley95c29f32014-06-20 12:00:00 -0700264 }
Adam Langley75712922014-10-10 16:23:43 -0700265 hs.hello.extendedMasterSecret = c.vers >= VersionTLS10 && hs.clientHello.extendedMasterSecret && !c.config.Bugs.NoExtendedMasterSecret
Adam Langley95c29f32014-06-20 12:00:00 -0700266
267 if len(config.Certificates) == 0 {
268 c.sendAlert(alertInternalError)
269 return false, errors.New("tls: no certificates configured")
270 }
271 hs.cert = &config.Certificates[0]
272 if len(hs.clientHello.serverName) > 0 {
273 hs.cert = config.getCertificateForName(hs.clientHello.serverName)
274 }
David Benjamine78bfde2014-09-06 12:45:15 -0400275 if expected := c.config.Bugs.ExpectServerName; expected != "" && expected != hs.clientHello.serverName {
276 return false, errors.New("tls: unexpected server name")
277 }
Adam Langley95c29f32014-06-20 12:00:00 -0700278
David Benjamind30a9902014-08-24 01:44:23 -0400279 if hs.clientHello.channelIDSupported && config.RequestChannelID {
280 hs.hello.channelIDRequested = true
281 }
282
David Benjaminca6c8262014-11-15 19:06:08 -0500283 if hs.clientHello.srtpProtectionProfiles != nil {
284 SRTPLoop:
285 for _, p1 := range c.config.SRTPProtectionProfiles {
286 for _, p2 := range hs.clientHello.srtpProtectionProfiles {
287 if p1 == p2 {
288 hs.hello.srtpProtectionProfile = p1
289 c.srtpProtectionProfile = p1
290 break SRTPLoop
291 }
292 }
293 }
294 }
295
296 if c.config.Bugs.SendSRTPProtectionProfile != 0 {
297 hs.hello.srtpProtectionProfile = c.config.Bugs.SendSRTPProtectionProfile
298 }
299
Adam Langley95c29f32014-06-20 12:00:00 -0700300 _, hs.ecdsaOk = hs.cert.PrivateKey.(*ecdsa.PrivateKey)
301
302 if hs.checkForResumption() {
303 return true, nil
304 }
305
Adam Langleyac61fa32014-06-23 12:03:11 -0700306 var scsvFound bool
307
308 for _, cipherSuite := range hs.clientHello.cipherSuites {
309 if cipherSuite == fallbackSCSV {
310 scsvFound = true
311 break
312 }
313 }
314
315 if !scsvFound && config.Bugs.FailIfNotFallbackSCSV {
316 return false, errors.New("tls: no fallback SCSV found when expected")
317 } else if scsvFound && !config.Bugs.FailIfNotFallbackSCSV {
318 return false, errors.New("tls: fallback SCSV found when not expected")
319 }
320
Adam Langley95c29f32014-06-20 12:00:00 -0700321 var preferenceList, supportedList []uint16
322 if c.config.PreferServerCipherSuites {
323 preferenceList = c.config.cipherSuites()
324 supportedList = hs.clientHello.cipherSuites
325 } else {
326 preferenceList = hs.clientHello.cipherSuites
327 supportedList = c.config.cipherSuites()
328 }
329
330 for _, id := range preferenceList {
331 if hs.suite = c.tryCipherSuite(id, supportedList, c.vers, hs.ellipticOk, hs.ecdsaOk); hs.suite != nil {
332 break
333 }
334 }
335
336 if hs.suite == nil {
337 c.sendAlert(alertHandshakeFailure)
338 return false, errors.New("tls: no cipher suite supported by both client and server")
339 }
340
341 return false, nil
342}
343
344// checkForResumption returns true if we should perform resumption on this connection.
345func (hs *serverHandshakeState) checkForResumption() bool {
346 c := hs.c
347
David Benjaminfe8eb9a2014-11-17 03:19:02 -0500348 if len(hs.clientHello.sessionTicket) > 0 {
349 if c.config.SessionTicketsDisabled {
350 return false
351 }
David Benjaminb0c8db72014-09-24 15:19:56 -0400352
David Benjaminfe8eb9a2014-11-17 03:19:02 -0500353 var ok bool
354 if hs.sessionState, ok = c.decryptTicket(hs.clientHello.sessionTicket); !ok {
355 return false
356 }
357 } else {
358 if c.config.ServerSessionCache == nil {
359 return false
360 }
361
362 var ok bool
363 sessionId := string(hs.clientHello.sessionId)
364 if hs.sessionState, ok = c.config.ServerSessionCache.Get(sessionId); !ok {
365 return false
366 }
Adam Langley95c29f32014-06-20 12:00:00 -0700367 }
368
David Benjamine18d8212014-11-10 02:37:15 -0500369 // Never resume a session for a different SSL version.
370 if !c.config.Bugs.AllowSessionVersionMismatch && c.vers != hs.sessionState.vers {
371 return false
Adam Langley95c29f32014-06-20 12:00:00 -0700372 }
373
374 cipherSuiteOk := false
375 // Check that the client is still offering the ciphersuite in the session.
376 for _, id := range hs.clientHello.cipherSuites {
377 if id == hs.sessionState.cipherSuite {
378 cipherSuiteOk = true
379 break
380 }
381 }
382 if !cipherSuiteOk {
383 return false
384 }
385
386 // Check that we also support the ciphersuite from the session.
387 hs.suite = c.tryCipherSuite(hs.sessionState.cipherSuite, c.config.cipherSuites(), hs.sessionState.vers, hs.ellipticOk, hs.ecdsaOk)
388 if hs.suite == nil {
389 return false
390 }
391
392 sessionHasClientCerts := len(hs.sessionState.certificates) != 0
393 needClientCerts := c.config.ClientAuth == RequireAnyClientCert || c.config.ClientAuth == RequireAndVerifyClientCert
394 if needClientCerts && !sessionHasClientCerts {
395 return false
396 }
397 if sessionHasClientCerts && c.config.ClientAuth == NoClientCert {
398 return false
399 }
400
401 return true
402}
403
404func (hs *serverHandshakeState) doResumeHandshake() error {
405 c := hs.c
406
407 hs.hello.cipherSuite = hs.suite.id
408 // We echo the client's session ID in the ServerHello to let it know
409 // that we're doing a resumption.
410 hs.hello.sessionId = hs.clientHello.sessionId
David Benjaminbed9aae2014-08-07 19:13:38 -0400411 hs.hello.ticketSupported = c.config.Bugs.RenewTicketOnResume
Adam Langley95c29f32014-06-20 12:00:00 -0700412
413 hs.finishedHash = newFinishedHash(c.vers, hs.suite)
David Benjamine098ec22014-08-27 23:13:20 -0400414 hs.finishedHash.discardHandshakeBuffer()
David Benjamin83c0bc92014-08-04 01:23:53 -0400415 hs.writeClientHash(hs.clientHello.marshal())
416 hs.writeServerHash(hs.hello.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700417
418 c.writeRecord(recordTypeHandshake, hs.hello.marshal())
419
420 if len(hs.sessionState.certificates) > 0 {
421 if _, err := hs.processCertsFromClient(hs.sessionState.certificates); err != nil {
422 return err
423 }
424 }
425
426 hs.masterSecret = hs.sessionState.masterSecret
Adam Langley75712922014-10-10 16:23:43 -0700427 c.extendedMasterSecret = hs.sessionState.extendedMasterSecret
Adam Langley95c29f32014-06-20 12:00:00 -0700428
429 return nil
430}
431
432func (hs *serverHandshakeState) doFullHandshake() error {
433 config := hs.c.config
434 c := hs.c
435
David Benjamin48cae082014-10-27 01:06:24 -0400436 isPSK := hs.suite.flags&suitePSK != 0
437 if !isPSK && hs.clientHello.ocspStapling && len(hs.cert.OCSPStaple) > 0 {
Adam Langley95c29f32014-06-20 12:00:00 -0700438 hs.hello.ocspStapling = true
439 }
440
David Benjamin61f95272014-11-25 01:55:35 -0500441 if hs.clientHello.sctListSupported && len(hs.cert.SignedCertificateTimestampList) > 0 {
442 hs.hello.sctList = hs.cert.SignedCertificateTimestampList
443 }
444
David Benjaminfe8eb9a2014-11-17 03:19:02 -0500445 hs.hello.ticketSupported = hs.clientHello.ticketSupported && !config.SessionTicketsDisabled && c.vers > VersionSSL30
Adam Langley95c29f32014-06-20 12:00:00 -0700446 hs.hello.cipherSuite = hs.suite.id
David Benjamin6095de82014-12-27 01:50:38 -0500447 if config.Bugs.SendCipherSuite != 0 {
448 hs.hello.cipherSuite = config.Bugs.SendCipherSuite
449 }
Adam Langley75712922014-10-10 16:23:43 -0700450 c.extendedMasterSecret = hs.hello.extendedMasterSecret
Adam Langley95c29f32014-06-20 12:00:00 -0700451
David Benjaminfe8eb9a2014-11-17 03:19:02 -0500452 // Generate a session ID if we're to save the session.
453 if !hs.hello.ticketSupported && config.ServerSessionCache != nil {
454 hs.hello.sessionId = make([]byte, 32)
455 if _, err := io.ReadFull(config.rand(), hs.hello.sessionId); err != nil {
456 c.sendAlert(alertInternalError)
457 return errors.New("tls: short read from Rand: " + err.Error())
458 }
459 }
460
Adam Langley95c29f32014-06-20 12:00:00 -0700461 hs.finishedHash = newFinishedHash(c.vers, hs.suite)
David Benjamin83c0bc92014-08-04 01:23:53 -0400462 hs.writeClientHash(hs.clientHello.marshal())
463 hs.writeServerHash(hs.hello.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700464
465 c.writeRecord(recordTypeHandshake, hs.hello.marshal())
466
David Benjamin48cae082014-10-27 01:06:24 -0400467 if !isPSK {
468 certMsg := new(certificateMsg)
469 certMsg.certificates = hs.cert.Certificate
470 if !config.Bugs.UnauthenticatedECDH {
471 hs.writeServerHash(certMsg.marshal())
472 c.writeRecord(recordTypeHandshake, certMsg.marshal())
473 }
David Benjamin1c375dd2014-07-12 00:48:23 -0400474 }
Adam Langley95c29f32014-06-20 12:00:00 -0700475
476 if hs.hello.ocspStapling {
477 certStatus := new(certificateStatusMsg)
478 certStatus.statusType = statusTypeOCSP
479 certStatus.response = hs.cert.OCSPStaple
David Benjamin83c0bc92014-08-04 01:23:53 -0400480 hs.writeServerHash(certStatus.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700481 c.writeRecord(recordTypeHandshake, certStatus.marshal())
482 }
483
484 keyAgreement := hs.suite.ka(c.vers)
485 skx, err := keyAgreement.generateServerKeyExchange(config, hs.cert, hs.clientHello, hs.hello)
486 if err != nil {
487 c.sendAlert(alertHandshakeFailure)
488 return err
489 }
David Benjamin9c651c92014-07-12 13:27:45 -0400490 if skx != nil && !config.Bugs.SkipServerKeyExchange {
David Benjamin83c0bc92014-08-04 01:23:53 -0400491 hs.writeServerHash(skx.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700492 c.writeRecord(recordTypeHandshake, skx.marshal())
493 }
494
495 if config.ClientAuth >= RequestClientCert {
496 // Request a client certificate
David Benjamin7b030512014-07-08 17:30:11 -0400497 certReq := &certificateRequestMsg{
498 certificateTypes: config.ClientCertificateTypes,
499 }
500 if certReq.certificateTypes == nil {
501 certReq.certificateTypes = []byte{
502 byte(CertTypeRSASign),
503 byte(CertTypeECDSASign),
504 }
Adam Langley95c29f32014-06-20 12:00:00 -0700505 }
506 if c.vers >= VersionTLS12 {
507 certReq.hasSignatureAndHash = true
David Benjamin000800a2014-11-14 01:43:59 -0500508 if !config.Bugs.NoSignatureAndHashes {
509 certReq.signatureAndHashes = config.signatureAndHashesForServer()
510 }
Adam Langley95c29f32014-06-20 12:00:00 -0700511 }
512
513 // An empty list of certificateAuthorities signals to
514 // the client that it may send any certificate in response
515 // to our request. When we know the CAs we trust, then
516 // we can send them down, so that the client can choose
517 // an appropriate certificate to give to us.
518 if config.ClientCAs != nil {
519 certReq.certificateAuthorities = config.ClientCAs.Subjects()
520 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400521 hs.writeServerHash(certReq.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700522 c.writeRecord(recordTypeHandshake, certReq.marshal())
523 }
524
525 helloDone := new(serverHelloDoneMsg)
David Benjamin83c0bc92014-08-04 01:23:53 -0400526 hs.writeServerHash(helloDone.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700527 c.writeRecord(recordTypeHandshake, helloDone.marshal())
528
529 var pub crypto.PublicKey // public key for client auth, if any
530
531 msg, err := c.readHandshake()
532 if err != nil {
533 return err
534 }
535
536 var ok bool
537 // If we requested a client certificate, then the client must send a
538 // certificate message, even if it's empty.
539 if config.ClientAuth >= RequestClientCert {
David Benjamin48cae082014-10-27 01:06:24 -0400540 var certMsg *certificateMsg
Adam Langley95c29f32014-06-20 12:00:00 -0700541 if certMsg, ok = msg.(*certificateMsg); !ok {
542 c.sendAlert(alertUnexpectedMessage)
543 return unexpectedMessageError(certMsg, msg)
544 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400545 hs.writeClientHash(certMsg.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700546
547 if len(certMsg.certificates) == 0 {
548 // The client didn't actually send a certificate
549 switch config.ClientAuth {
550 case RequireAnyClientCert, RequireAndVerifyClientCert:
551 c.sendAlert(alertBadCertificate)
552 return errors.New("tls: client didn't provide a certificate")
553 }
554 }
555
556 pub, err = hs.processCertsFromClient(certMsg.certificates)
557 if err != nil {
558 return err
559 }
560
561 msg, err = c.readHandshake()
562 if err != nil {
563 return err
564 }
565 }
566
567 // Get client key exchange
568 ckx, ok := msg.(*clientKeyExchangeMsg)
569 if !ok {
570 c.sendAlert(alertUnexpectedMessage)
571 return unexpectedMessageError(ckx, msg)
572 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400573 hs.writeClientHash(ckx.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700574
David Benjamine098ec22014-08-27 23:13:20 -0400575 preMasterSecret, err := keyAgreement.processClientKeyExchange(config, hs.cert, ckx, c.vers)
576 if err != nil {
577 c.sendAlert(alertHandshakeFailure)
578 return err
579 }
Adam Langley75712922014-10-10 16:23:43 -0700580 if c.extendedMasterSecret {
581 hs.masterSecret = extendedMasterFromPreMasterSecret(c.vers, hs.suite, preMasterSecret, hs.finishedHash)
582 } else {
583 if c.config.Bugs.RequireExtendedMasterSecret {
584 return errors.New("tls: extended master secret required but not supported by peer")
585 }
586 hs.masterSecret = masterFromPreMasterSecret(c.vers, hs.suite, preMasterSecret, hs.clientHello.random, hs.hello.random)
587 }
David Benjamine098ec22014-08-27 23:13:20 -0400588
Adam Langley95c29f32014-06-20 12:00:00 -0700589 // If we received a client cert in response to our certificate request message,
590 // the client will send us a certificateVerifyMsg immediately after the
591 // clientKeyExchangeMsg. This message is a digest of all preceding
592 // handshake-layer messages that is signed using the private key corresponding
593 // to the client's certificate. This allows us to verify that the client is in
594 // possession of the private key of the certificate.
595 if len(c.peerCertificates) > 0 {
596 msg, err = c.readHandshake()
597 if err != nil {
598 return err
599 }
600 certVerify, ok := msg.(*certificateVerifyMsg)
601 if !ok {
602 c.sendAlert(alertUnexpectedMessage)
603 return unexpectedMessageError(certVerify, msg)
604 }
605
David Benjaminde620d92014-07-18 15:03:41 -0400606 // Determine the signature type.
607 var signatureAndHash signatureAndHash
608 if certVerify.hasSignatureAndHash {
609 signatureAndHash = certVerify.signatureAndHash
David Benjamin000800a2014-11-14 01:43:59 -0500610 if !isSupportedSignatureAndHash(signatureAndHash, config.signatureAndHashesForServer()) {
611 return errors.New("tls: unsupported hash function for client certificate")
612 }
David Benjaminde620d92014-07-18 15:03:41 -0400613 } else {
614 // Before TLS 1.2 the signature algorithm was implicit
615 // from the key type, and only one hash per signature
616 // algorithm was possible. Leave the hash as zero.
617 switch pub.(type) {
618 case *ecdsa.PublicKey:
619 signatureAndHash.signature = signatureECDSA
620 case *rsa.PublicKey:
621 signatureAndHash.signature = signatureRSA
622 }
623 }
624
Adam Langley95c29f32014-06-20 12:00:00 -0700625 switch key := pub.(type) {
626 case *ecdsa.PublicKey:
David Benjaminde620d92014-07-18 15:03:41 -0400627 if signatureAndHash.signature != signatureECDSA {
628 err = errors.New("tls: bad signature type for client's ECDSA certificate")
629 break
630 }
Adam Langley95c29f32014-06-20 12:00:00 -0700631 ecdsaSig := new(ecdsaSignature)
632 if _, err = asn1.Unmarshal(certVerify.signature, ecdsaSig); err != nil {
633 break
634 }
635 if ecdsaSig.R.Sign() <= 0 || ecdsaSig.S.Sign() <= 0 {
636 err = errors.New("ECDSA signature contained zero or negative values")
637 break
638 }
David Benjaminde620d92014-07-18 15:03:41 -0400639 var digest []byte
David Benjamine098ec22014-08-27 23:13:20 -0400640 digest, _, err = hs.finishedHash.hashForClientCertificate(signatureAndHash, hs.masterSecret)
David Benjaminde620d92014-07-18 15:03:41 -0400641 if err != nil {
642 break
643 }
Adam Langley95c29f32014-06-20 12:00:00 -0700644 if !ecdsa.Verify(key, digest, ecdsaSig.R, ecdsaSig.S) {
645 err = errors.New("ECDSA verification failure")
646 break
647 }
648 case *rsa.PublicKey:
David Benjaminde620d92014-07-18 15:03:41 -0400649 if signatureAndHash.signature != signatureRSA {
650 err = errors.New("tls: bad signature type for client's RSA certificate")
651 break
652 }
653 var digest []byte
654 var hashFunc crypto.Hash
David Benjamine098ec22014-08-27 23:13:20 -0400655 digest, hashFunc, err = hs.finishedHash.hashForClientCertificate(signatureAndHash, hs.masterSecret)
David Benjaminde620d92014-07-18 15:03:41 -0400656 if err != nil {
657 break
658 }
Adam Langley95c29f32014-06-20 12:00:00 -0700659 err = rsa.VerifyPKCS1v15(key, hashFunc, digest, certVerify.signature)
660 }
661 if err != nil {
662 c.sendAlert(alertBadCertificate)
663 return errors.New("could not validate signature of connection nonces: " + err.Error())
664 }
665
David Benjamin83c0bc92014-08-04 01:23:53 -0400666 hs.writeClientHash(certVerify.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700667 }
668
David Benjamine098ec22014-08-27 23:13:20 -0400669 hs.finishedHash.discardHandshakeBuffer()
Adam Langley95c29f32014-06-20 12:00:00 -0700670
671 return nil
672}
673
674func (hs *serverHandshakeState) establishKeys() error {
675 c := hs.c
676
677 clientMAC, serverMAC, clientKey, serverKey, clientIV, serverIV :=
678 keysFromMasterSecret(c.vers, hs.suite, hs.masterSecret, hs.clientHello.random, hs.hello.random, hs.suite.macLen, hs.suite.keyLen, hs.suite.ivLen)
679
680 var clientCipher, serverCipher interface{}
681 var clientHash, serverHash macFunction
682
683 if hs.suite.aead == nil {
684 clientCipher = hs.suite.cipher(clientKey, clientIV, true /* for reading */)
685 clientHash = hs.suite.mac(c.vers, clientMAC)
686 serverCipher = hs.suite.cipher(serverKey, serverIV, false /* not for reading */)
687 serverHash = hs.suite.mac(c.vers, serverMAC)
688 } else {
689 clientCipher = hs.suite.aead(clientKey, clientIV)
690 serverCipher = hs.suite.aead(serverKey, serverIV)
691 }
692
693 c.in.prepareCipherSpec(c.vers, clientCipher, clientHash)
694 c.out.prepareCipherSpec(c.vers, serverCipher, serverHash)
695
696 return nil
697}
698
David Benjamind30a9902014-08-24 01:44:23 -0400699func (hs *serverHandshakeState) readFinished(isResume bool) error {
Adam Langley95c29f32014-06-20 12:00:00 -0700700 c := hs.c
701
702 c.readRecord(recordTypeChangeCipherSpec)
703 if err := c.in.error(); err != nil {
704 return err
705 }
706
707 if hs.hello.nextProtoNeg {
708 msg, err := c.readHandshake()
709 if err != nil {
710 return err
711 }
712 nextProto, ok := msg.(*nextProtoMsg)
713 if !ok {
714 c.sendAlert(alertUnexpectedMessage)
715 return unexpectedMessageError(nextProto, msg)
716 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400717 hs.writeClientHash(nextProto.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700718 c.clientProtocol = nextProto.proto
719 }
720
David Benjamind30a9902014-08-24 01:44:23 -0400721 if hs.hello.channelIDRequested {
722 msg, err := c.readHandshake()
723 if err != nil {
724 return err
725 }
726 encryptedExtensions, ok := msg.(*encryptedExtensionsMsg)
727 if !ok {
728 c.sendAlert(alertUnexpectedMessage)
729 return unexpectedMessageError(encryptedExtensions, msg)
730 }
731 x := new(big.Int).SetBytes(encryptedExtensions.channelID[0:32])
732 y := new(big.Int).SetBytes(encryptedExtensions.channelID[32:64])
733 r := new(big.Int).SetBytes(encryptedExtensions.channelID[64:96])
734 s := new(big.Int).SetBytes(encryptedExtensions.channelID[96:128])
735 if !elliptic.P256().IsOnCurve(x, y) {
736 return errors.New("tls: invalid channel ID public key")
737 }
738 channelID := &ecdsa.PublicKey{elliptic.P256(), x, y}
739 var resumeHash []byte
740 if isResume {
741 resumeHash = hs.sessionState.handshakeHash
742 }
743 if !ecdsa.Verify(channelID, hs.finishedHash.hashForChannelID(resumeHash), r, s) {
744 return errors.New("tls: invalid channel ID signature")
745 }
746 c.channelID = channelID
747
748 hs.writeClientHash(encryptedExtensions.marshal())
749 }
750
Adam Langley95c29f32014-06-20 12:00:00 -0700751 msg, err := c.readHandshake()
752 if err != nil {
753 return err
754 }
755 clientFinished, ok := msg.(*finishedMsg)
756 if !ok {
757 c.sendAlert(alertUnexpectedMessage)
758 return unexpectedMessageError(clientFinished, msg)
759 }
760
761 verify := hs.finishedHash.clientSum(hs.masterSecret)
762 if len(verify) != len(clientFinished.verifyData) ||
763 subtle.ConstantTimeCompare(verify, clientFinished.verifyData) != 1 {
764 c.sendAlert(alertHandshakeFailure)
765 return errors.New("tls: client's Finished message is incorrect")
766 }
Adam Langley2ae77d22014-10-28 17:29:33 -0700767 c.clientVerify = append(c.clientVerify[:0], clientFinished.verifyData...)
Adam Langley95c29f32014-06-20 12:00:00 -0700768
David Benjamin83c0bc92014-08-04 01:23:53 -0400769 hs.writeClientHash(clientFinished.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700770 return nil
771}
772
773func (hs *serverHandshakeState) sendSessionTicket() error {
Adam Langley95c29f32014-06-20 12:00:00 -0700774 c := hs.c
Adam Langley95c29f32014-06-20 12:00:00 -0700775 state := sessionState{
David Benjamind30a9902014-08-24 01:44:23 -0400776 vers: c.vers,
777 cipherSuite: hs.suite.id,
778 masterSecret: hs.masterSecret,
779 certificates: hs.certsFromClient,
780 handshakeHash: hs.finishedHash.server.Sum(nil),
Adam Langley95c29f32014-06-20 12:00:00 -0700781 }
David Benjaminfe8eb9a2014-11-17 03:19:02 -0500782
783 if !hs.hello.ticketSupported || hs.c.config.Bugs.SkipNewSessionTicket {
784 if c.config.ServerSessionCache != nil && len(hs.hello.sessionId) != 0 {
785 c.config.ServerSessionCache.Put(string(hs.hello.sessionId), &state)
786 }
787 return nil
788 }
789
790 m := new(newSessionTicketMsg)
791
792 var err error
Adam Langley95c29f32014-06-20 12:00:00 -0700793 m.ticket, err = c.encryptTicket(&state)
794 if err != nil {
795 return err
796 }
Adam Langley95c29f32014-06-20 12:00:00 -0700797
David Benjamin83c0bc92014-08-04 01:23:53 -0400798 hs.writeServerHash(m.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -0700799 c.writeRecord(recordTypeHandshake, m.marshal())
800
801 return nil
802}
803
804func (hs *serverHandshakeState) sendFinished() error {
805 c := hs.c
806
David Benjamin86271ee2014-07-21 16:14:03 -0400807 finished := new(finishedMsg)
808 finished.verifyData = hs.finishedHash.serverSum(hs.masterSecret)
Adam Langley2ae77d22014-10-28 17:29:33 -0700809 c.serverVerify = append(c.serverVerify[:0], finished.verifyData...)
David Benjamin86271ee2014-07-21 16:14:03 -0400810 postCCSBytes := finished.marshal()
David Benjamin83c0bc92014-08-04 01:23:53 -0400811 hs.writeServerHash(postCCSBytes)
David Benjamin86271ee2014-07-21 16:14:03 -0400812
813 if c.config.Bugs.FragmentAcrossChangeCipherSpec {
814 c.writeRecord(recordTypeHandshake, postCCSBytes[:5])
815 postCCSBytes = postCCSBytes[5:]
816 }
817
David Benjamina0e52232014-07-19 17:39:58 -0400818 if !c.config.Bugs.SkipChangeCipherSpec {
819 c.writeRecord(recordTypeChangeCipherSpec, []byte{1})
820 }
Adam Langley95c29f32014-06-20 12:00:00 -0700821
David Benjamin86271ee2014-07-21 16:14:03 -0400822 c.writeRecord(recordTypeHandshake, postCCSBytes)
Adam Langley95c29f32014-06-20 12:00:00 -0700823
824 c.cipherSuite = hs.suite.id
825
826 return nil
827}
828
829// processCertsFromClient takes a chain of client certificates either from a
830// Certificates message or from a sessionState and verifies them. It returns
831// the public key of the leaf certificate.
832func (hs *serverHandshakeState) processCertsFromClient(certificates [][]byte) (crypto.PublicKey, error) {
833 c := hs.c
834
835 hs.certsFromClient = certificates
836 certs := make([]*x509.Certificate, len(certificates))
837 var err error
838 for i, asn1Data := range certificates {
839 if certs[i], err = x509.ParseCertificate(asn1Data); err != nil {
840 c.sendAlert(alertBadCertificate)
841 return nil, errors.New("tls: failed to parse client certificate: " + err.Error())
842 }
843 }
844
845 if c.config.ClientAuth >= VerifyClientCertIfGiven && len(certs) > 0 {
846 opts := x509.VerifyOptions{
847 Roots: c.config.ClientCAs,
848 CurrentTime: c.config.time(),
849 Intermediates: x509.NewCertPool(),
850 KeyUsages: []x509.ExtKeyUsage{x509.ExtKeyUsageClientAuth},
851 }
852
853 for _, cert := range certs[1:] {
854 opts.Intermediates.AddCert(cert)
855 }
856
857 chains, err := certs[0].Verify(opts)
858 if err != nil {
859 c.sendAlert(alertBadCertificate)
860 return nil, errors.New("tls: failed to verify client's certificate: " + err.Error())
861 }
862
863 ok := false
864 for _, ku := range certs[0].ExtKeyUsage {
865 if ku == x509.ExtKeyUsageClientAuth {
866 ok = true
867 break
868 }
869 }
870 if !ok {
871 c.sendAlert(alertHandshakeFailure)
872 return nil, errors.New("tls: client's certificate's extended key usage doesn't permit it to be used for client authentication")
873 }
874
875 c.verifiedChains = chains
876 }
877
878 if len(certs) > 0 {
879 var pub crypto.PublicKey
880 switch key := certs[0].PublicKey.(type) {
881 case *ecdsa.PublicKey, *rsa.PublicKey:
882 pub = key
883 default:
884 c.sendAlert(alertUnsupportedCertificate)
885 return nil, fmt.Errorf("tls: client's certificate contains an unsupported public key of type %T", certs[0].PublicKey)
886 }
887 c.peerCertificates = certs
888 return pub, nil
889 }
890
891 return nil, nil
892}
893
David Benjamin83c0bc92014-08-04 01:23:53 -0400894func (hs *serverHandshakeState) writeServerHash(msg []byte) {
895 // writeServerHash is called before writeRecord.
896 hs.writeHash(msg, hs.c.sendHandshakeSeq)
897}
898
899func (hs *serverHandshakeState) writeClientHash(msg []byte) {
900 // writeClientHash is called after readHandshake.
901 hs.writeHash(msg, hs.c.recvHandshakeSeq-1)
902}
903
904func (hs *serverHandshakeState) writeHash(msg []byte, seqno uint16) {
905 if hs.c.isDTLS {
906 // This is somewhat hacky. DTLS hashes a slightly different format.
907 // First, the TLS header.
908 hs.finishedHash.Write(msg[:4])
909 // Then the sequence number and reassembled fragment offset (always 0).
910 hs.finishedHash.Write([]byte{byte(seqno >> 8), byte(seqno), 0, 0, 0})
911 // Then the reassembled fragment (always equal to the message length).
912 hs.finishedHash.Write(msg[1:4])
913 // And then the message body.
914 hs.finishedHash.Write(msg[4:])
915 } else {
916 hs.finishedHash.Write(msg)
917 }
918}
919
Adam Langley95c29f32014-06-20 12:00:00 -0700920// tryCipherSuite returns a cipherSuite with the given id if that cipher suite
921// is acceptable to use.
922func (c *Conn) tryCipherSuite(id uint16, supportedCipherSuites []uint16, version uint16, ellipticOk, ecdsaOk bool) *cipherSuite {
923 for _, supported := range supportedCipherSuites {
924 if id == supported {
925 var candidate *cipherSuite
926
927 for _, s := range cipherSuites {
928 if s.id == id {
929 candidate = s
930 break
931 }
932 }
933 if candidate == nil {
934 continue
935 }
936 // Don't select a ciphersuite which we can't
937 // support for this client.
938 if (candidate.flags&suiteECDHE != 0) && !ellipticOk {
939 continue
940 }
941 if (candidate.flags&suiteECDSA != 0) != ecdsaOk {
942 continue
943 }
David Benjamin39ebf532014-08-31 02:23:49 -0400944 if !c.config.Bugs.SkipCipherVersionCheck && version < VersionTLS12 && candidate.flags&suiteTLS12 != 0 {
Adam Langley95c29f32014-06-20 12:00:00 -0700945 continue
946 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400947 if c.isDTLS && candidate.flags&suiteNoDTLS != 0 {
948 continue
949 }
Adam Langley95c29f32014-06-20 12:00:00 -0700950 return candidate
951 }
952 }
953
954 return nil
955}