blob: 934e0522a47ffc73a3c4588c75cd1f6f67a9dc42 [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
Adam Langleydc7e9c42015-09-29 15:21:04 -07005package runner
Adam Langley95c29f32014-06-20 12:00:00 -07006
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"
Adam Langley95c29f32014-06-20 12:00:00 -070015 "errors"
16 "fmt"
17 "io"
David Benjamind30a9902014-08-24 01:44:23 -040018 "math/big"
Adam Langley95c29f32014-06-20 12:00:00 -070019)
20
21// serverHandshakeState contains details of a server handshake in progress.
22// It's discarded once the handshake has completed.
23type serverHandshakeState struct {
24 c *Conn
25 clientHello *clientHelloMsg
26 hello *serverHelloMsg
27 suite *cipherSuite
28 ellipticOk bool
29 ecdsaOk bool
30 sessionState *sessionState
31 finishedHash finishedHash
32 masterSecret []byte
33 certsFromClient [][]byte
34 cert *Certificate
David Benjamin83f90402015-01-27 01:09:43 -050035 finishedBytes []byte
Adam Langley95c29f32014-06-20 12:00:00 -070036}
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 }
David Benjaminf25dda92016-07-04 10:05:26 -070052 if err := hs.readClientHello(); err != nil {
53 return err
54 }
Adam Langley95c29f32014-06-20 12:00:00 -070055
David Benjamin8d315d72016-07-18 01:03:18 +020056 if c.vers >= VersionTLS13 {
Nick Harper728eed82016-07-07 17:36:52 -070057 if err := hs.doTLS13Handshake(); err != nil {
Adam Langley95c29f32014-06-20 12:00:00 -070058 return err
59 }
Nick Harper728eed82016-07-07 17:36:52 -070060 } else {
61 isResume, err := hs.processClientHello()
62 if err != nil {
Adam Langley95c29f32014-06-20 12:00:00 -070063 return err
64 }
Nick Harper728eed82016-07-07 17:36:52 -070065
66 // For an overview of TLS handshaking, see https://tools.ietf.org/html/rfc5246#section-7.3
67 if isResume {
68 // The client has included a session ticket and so we do an abbreviated handshake.
69 if err := hs.doResumeHandshake(); err != nil {
70 return err
71 }
72 if err := hs.establishKeys(); err != nil {
73 return err
74 }
75 if c.config.Bugs.RenewTicketOnResume {
76 if err := hs.sendSessionTicket(); err != nil {
77 return err
78 }
79 }
80 if err := hs.sendFinished(c.firstFinished[:]); err != nil {
81 return err
82 }
83 // Most retransmits are triggered by a timeout, but the final
84 // leg of the handshake is retransmited upon re-receiving a
85 // Finished.
86 if err := c.simulatePacketLoss(func() {
David Benjamin02edcd02016-07-27 17:40:37 -040087 c.sendHandshakeSeq--
Nick Harper728eed82016-07-07 17:36:52 -070088 c.writeRecord(recordTypeHandshake, hs.finishedBytes)
89 c.flushHandshake()
90 }); err != nil {
91 return err
92 }
93 if err := hs.readFinished(nil, isResume); err != nil {
94 return err
95 }
96 c.didResume = true
97 } else {
98 // The client didn't include a session ticket, or it wasn't
99 // valid so we do a full handshake.
100 if err := hs.doFullHandshake(); err != nil {
101 return err
102 }
103 if err := hs.establishKeys(); err != nil {
104 return err
105 }
106 if err := hs.readFinished(c.firstFinished[:], isResume); err != nil {
107 return err
108 }
109 if c.config.Bugs.AlertBeforeFalseStartTest != 0 {
110 c.sendAlert(c.config.Bugs.AlertBeforeFalseStartTest)
111 }
112 if c.config.Bugs.ExpectFalseStart {
113 if err := c.readRecord(recordTypeApplicationData); err != nil {
114 return fmt.Errorf("tls: peer did not false start: %s", err)
115 }
116 }
David Benjaminbed9aae2014-08-07 19:13:38 -0400117 if err := hs.sendSessionTicket(); err != nil {
118 return err
119 }
Nick Harper728eed82016-07-07 17:36:52 -0700120 if err := hs.sendFinished(nil); err != nil {
121 return err
David Benjamine58c4f52014-08-24 03:47:07 -0400122 }
123 }
David Benjamin97a0a082016-07-13 17:57:35 -0400124
125 c.exporterSecret = hs.masterSecret
Adam Langley95c29f32014-06-20 12:00:00 -0700126 }
127 c.handshakeComplete = true
David Benjaminc565ebb2015-04-03 04:06:36 -0400128 copy(c.clientRandom[:], hs.clientHello.random)
129 copy(c.serverRandom[:], hs.hello.random)
Adam Langley95c29f32014-06-20 12:00:00 -0700130
131 return nil
132}
133
David Benjaminf25dda92016-07-04 10:05:26 -0700134// readClientHello reads a ClientHello message from the client and determines
135// the protocol version.
136func (hs *serverHandshakeState) readClientHello() error {
Adam Langley95c29f32014-06-20 12:00:00 -0700137 config := hs.c.config
138 c := hs.c
139
David Benjamin83f90402015-01-27 01:09:43 -0500140 if err := c.simulatePacketLoss(nil); err != nil {
David Benjaminf25dda92016-07-04 10:05:26 -0700141 return err
David Benjamin83f90402015-01-27 01:09:43 -0500142 }
Adam Langley95c29f32014-06-20 12:00:00 -0700143 msg, err := c.readHandshake()
144 if err != nil {
David Benjaminf25dda92016-07-04 10:05:26 -0700145 return err
Adam Langley95c29f32014-06-20 12:00:00 -0700146 }
147 var ok bool
148 hs.clientHello, ok = msg.(*clientHelloMsg)
149 if !ok {
150 c.sendAlert(alertUnexpectedMessage)
David Benjaminf25dda92016-07-04 10:05:26 -0700151 return unexpectedMessageError(hs.clientHello, msg)
Adam Langley95c29f32014-06-20 12:00:00 -0700152 }
Adam Langley33ad2b52015-07-20 17:43:53 -0700153 if size := config.Bugs.RequireClientHelloSize; size != 0 && len(hs.clientHello.raw) != size {
David Benjaminf25dda92016-07-04 10:05:26 -0700154 return fmt.Errorf("tls: ClientHello record size is %d, but expected %d", len(hs.clientHello.raw), size)
Feng Lu41aa3252014-11-21 22:47:56 -0800155 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400156
157 if c.isDTLS && !config.Bugs.SkipHelloVerifyRequest {
David Benjamin8bc38f52014-08-16 12:07:27 -0400158 // Per RFC 6347, the version field in HelloVerifyRequest SHOULD
159 // be always DTLS 1.0
David Benjamin83c0bc92014-08-04 01:23:53 -0400160 helloVerifyRequest := &helloVerifyRequestMsg{
David Benjamin8bc38f52014-08-16 12:07:27 -0400161 vers: VersionTLS10,
David Benjamin83c0bc92014-08-04 01:23:53 -0400162 cookie: make([]byte, 32),
163 }
164 if _, err := io.ReadFull(c.config.rand(), helloVerifyRequest.cookie); err != nil {
165 c.sendAlert(alertInternalError)
David Benjaminf25dda92016-07-04 10:05:26 -0700166 return errors.New("dtls: short read from Rand: " + err.Error())
David Benjamin83c0bc92014-08-04 01:23:53 -0400167 }
168 c.writeRecord(recordTypeHandshake, helloVerifyRequest.marshal())
David Benjamin582ba042016-07-07 12:33:25 -0700169 c.flushHandshake()
David Benjamin83c0bc92014-08-04 01:23:53 -0400170
David Benjamin83f90402015-01-27 01:09:43 -0500171 if err := c.simulatePacketLoss(nil); err != nil {
David Benjaminf25dda92016-07-04 10:05:26 -0700172 return err
David Benjamin83f90402015-01-27 01:09:43 -0500173 }
David Benjamin83c0bc92014-08-04 01:23:53 -0400174 msg, err := c.readHandshake()
175 if err != nil {
David Benjaminf25dda92016-07-04 10:05:26 -0700176 return err
David Benjamin83c0bc92014-08-04 01:23:53 -0400177 }
178 newClientHello, ok := msg.(*clientHelloMsg)
179 if !ok {
180 c.sendAlert(alertUnexpectedMessage)
David Benjaminf25dda92016-07-04 10:05:26 -0700181 return unexpectedMessageError(hs.clientHello, msg)
David Benjamin83c0bc92014-08-04 01:23:53 -0400182 }
183 if !bytes.Equal(newClientHello.cookie, helloVerifyRequest.cookie) {
David Benjaminf25dda92016-07-04 10:05:26 -0700184 return errors.New("dtls: invalid cookie")
David Benjamin83c0bc92014-08-04 01:23:53 -0400185 }
David Benjaminf2fedef2014-08-16 01:37:34 -0400186
187 // Apart from the cookie, the two ClientHellos must
188 // match. Note that clientHello.equal compares the
189 // serialization, so we make a copy.
190 oldClientHelloCopy := *hs.clientHello
191 oldClientHelloCopy.raw = nil
192 oldClientHelloCopy.cookie = nil
193 newClientHelloCopy := *newClientHello
194 newClientHelloCopy.raw = nil
195 newClientHelloCopy.cookie = nil
196 if !oldClientHelloCopy.equal(&newClientHelloCopy) {
David Benjaminf25dda92016-07-04 10:05:26 -0700197 return errors.New("dtls: retransmitted ClientHello does not match")
David Benjamin83c0bc92014-08-04 01:23:53 -0400198 }
199 hs.clientHello = newClientHello
200 }
201
David Benjaminc44b1df2014-11-23 12:11:01 -0500202 if config.Bugs.RequireSameRenegoClientVersion && c.clientVersion != 0 {
203 if c.clientVersion != hs.clientHello.vers {
David Benjaminf25dda92016-07-04 10:05:26 -0700204 return fmt.Errorf("tls: client offered different version on renego")
David Benjaminc44b1df2014-11-23 12:11:01 -0500205 }
206 }
Steven Valdezfdd10992016-09-15 16:27:05 -0400207
David Benjaminc44b1df2014-11-23 12:11:01 -0500208 c.clientVersion = hs.clientHello.vers
Steven Valdezfdd10992016-09-15 16:27:05 -0400209
210 // Convert the ClientHello wire version to a protocol version.
David Benjaminb1dd8cd2016-09-26 19:20:48 -0400211 var clientVersion uint16
212 if c.isDTLS {
213 if hs.clientHello.vers <= 0xfefd {
214 clientVersion = VersionTLS12
215 } else if hs.clientHello.vers <= 0xfeff {
216 clientVersion = VersionTLS10
217 }
218 } else {
Steven Valdezfdd10992016-09-15 16:27:05 -0400219 if hs.clientHello.vers >= VersionTLS12 {
David Benjaminb1dd8cd2016-09-26 19:20:48 -0400220 clientVersion = VersionTLS12
221 } else if hs.clientHello.vers >= VersionTLS11 {
222 clientVersion = VersionTLS11
223 } else if hs.clientHello.vers >= VersionTLS10 {
224 clientVersion = VersionTLS10
225 } else if hs.clientHello.vers >= VersionSSL30 {
226 clientVersion = VersionSSL30
227 }
228 }
229
230 if config.Bugs.NegotiateVersion != 0 {
231 c.vers = config.Bugs.NegotiateVersion
232 } else if c.haveVers && config.Bugs.NegotiateVersionOnRenego != 0 {
233 c.vers = config.Bugs.NegotiateVersionOnRenego
Steven Valdezfdd10992016-09-15 16:27:05 -0400234 } else if len(hs.clientHello.supportedVersions) > 0 {
235 // Use the versions extension if supplied.
David Benjamind9791bf2016-09-27 16:39:52 -0400236 var foundVersion, foundGREASE bool
Steven Valdezfdd10992016-09-15 16:27:05 -0400237 for _, extVersion := range hs.clientHello.supportedVersions {
David Benjamind9791bf2016-09-27 16:39:52 -0400238 if isGREASEValue(extVersion) {
239 foundGREASE = true
240 }
Steven Valdezfdd10992016-09-15 16:27:05 -0400241 extVersion, ok = wireToVersion(extVersion, c.isDTLS)
242 if !ok {
243 continue
244 }
David Benjamind9791bf2016-09-27 16:39:52 -0400245 if config.isSupportedVersion(extVersion, c.isDTLS) && !foundVersion {
Steven Valdezfdd10992016-09-15 16:27:05 -0400246 c.vers = extVersion
247 foundVersion = true
248 break
249 }
250 }
251 if !foundVersion {
David Benjaminb1dd8cd2016-09-26 19:20:48 -0400252 c.sendAlert(alertProtocolVersion)
Steven Valdezfdd10992016-09-15 16:27:05 -0400253 return errors.New("tls: client did not offer any supported protocol versions")
254 }
David Benjamind9791bf2016-09-27 16:39:52 -0400255 if config.Bugs.ExpectGREASE && !foundGREASE {
256 return errors.New("tls: no GREASE version value found")
257 }
Steven Valdezfdd10992016-09-15 16:27:05 -0400258 } else {
259 // Otherwise, use the legacy ClientHello version.
260 version := clientVersion
261 if maxVersion := config.maxVersion(c.isDTLS); version > maxVersion {
262 version = maxVersion
263 }
264 if version == 0 || !config.isSupportedVersion(version, c.isDTLS) {
David Benjaminb1dd8cd2016-09-26 19:20:48 -0400265 return fmt.Errorf("tls: client offered an unsupported, maximum protocol version of %x", hs.clientHello.vers)
266 }
Steven Valdezfdd10992016-09-15 16:27:05 -0400267 c.vers = version
David Benjaminb1dd8cd2016-09-26 19:20:48 -0400268 }
269 c.haveVers = true
David Benjaminc44b1df2014-11-23 12:11:01 -0500270
David Benjamin6ae7f072015-01-26 10:22:13 -0500271 // Reject < 1.2 ClientHellos with signature_algorithms.
David Benjamin3c6a1ea2016-09-26 18:30:05 -0400272 if clientVersion < VersionTLS12 && len(hs.clientHello.signatureAlgorithms) > 0 {
David Benjaminf25dda92016-07-04 10:05:26 -0700273 return fmt.Errorf("tls: client included signature_algorithms before TLS 1.2")
David Benjamin72dc7832015-03-16 17:49:43 -0400274 }
David Benjamin6ae7f072015-01-26 10:22:13 -0500275
David Benjaminf93995b2015-11-05 18:23:20 -0500276 // Check the client cipher list is consistent with the version.
David Benjamin3c6a1ea2016-09-26 18:30:05 -0400277 if clientVersion < VersionTLS12 {
David Benjaminf93995b2015-11-05 18:23:20 -0500278 for _, id := range hs.clientHello.cipherSuites {
279 if isTLS12Cipher(id) {
David Benjaminf25dda92016-07-04 10:05:26 -0700280 return fmt.Errorf("tls: client offered TLS 1.2 cipher before TLS 1.2")
David Benjaminf93995b2015-11-05 18:23:20 -0500281 }
282 }
283 }
284
David Benjamin405da482016-08-08 17:25:07 -0400285 if config.Bugs.ExpectNoTLS12Session {
286 if len(hs.clientHello.sessionId) > 0 {
287 return fmt.Errorf("tls: client offered an unexpected session ID")
288 }
289 if len(hs.clientHello.sessionTicket) > 0 {
290 return fmt.Errorf("tls: client offered an unexpected session ticket")
291 }
292 }
293
294 if config.Bugs.ExpectNoTLS13PSK && len(hs.clientHello.pskIdentities) > 0 {
295 return fmt.Errorf("tls: client offered unexpected PSK identities")
296 }
297
David Benjamin65ac9972016-09-02 21:35:25 -0400298 var scsvFound, greaseFound bool
David Benjaminf25dda92016-07-04 10:05:26 -0700299 for _, cipherSuite := range hs.clientHello.cipherSuites {
300 if cipherSuite == fallbackSCSV {
301 scsvFound = true
David Benjamin65ac9972016-09-02 21:35:25 -0400302 }
303 if isGREASEValue(cipherSuite) {
304 greaseFound = true
David Benjaminf25dda92016-07-04 10:05:26 -0700305 }
306 }
307
308 if !scsvFound && config.Bugs.FailIfNotFallbackSCSV {
309 return errors.New("tls: no fallback SCSV found when expected")
310 } else if scsvFound && !config.Bugs.FailIfNotFallbackSCSV {
311 return errors.New("tls: fallback SCSV found when not expected")
312 }
313
David Benjamin65ac9972016-09-02 21:35:25 -0400314 if !greaseFound && config.Bugs.ExpectGREASE {
315 return errors.New("tls: no GREASE cipher suite value found")
316 }
317
318 greaseFound = false
319 for _, curve := range hs.clientHello.supportedCurves {
320 if isGREASEValue(uint16(curve)) {
321 greaseFound = true
322 break
323 }
324 }
325
326 if !greaseFound && config.Bugs.ExpectGREASE {
327 return errors.New("tls: no GREASE curve value found")
328 }
329
330 if len(hs.clientHello.keyShares) > 0 {
331 greaseFound = false
332 for _, keyShare := range hs.clientHello.keyShares {
333 if isGREASEValue(uint16(keyShare.group)) {
334 greaseFound = true
335 break
336 }
337 }
338
339 if !greaseFound && config.Bugs.ExpectGREASE {
340 return errors.New("tls: no GREASE curve value found")
341 }
342 }
343
David Benjaminf25dda92016-07-04 10:05:26 -0700344 if config.Bugs.IgnorePeerSignatureAlgorithmPreferences {
David Benjamin7a41d372016-07-09 11:21:54 -0700345 hs.clientHello.signatureAlgorithms = config.signSignatureAlgorithms()
David Benjaminf25dda92016-07-04 10:05:26 -0700346 }
347 if config.Bugs.IgnorePeerCurvePreferences {
348 hs.clientHello.supportedCurves = config.curvePreferences()
349 }
350 if config.Bugs.IgnorePeerCipherPreferences {
351 hs.clientHello.cipherSuites = config.cipherSuites()
352 }
353
354 return nil
355}
356
Nick Harper728eed82016-07-07 17:36:52 -0700357func (hs *serverHandshakeState) doTLS13Handshake() error {
358 c := hs.c
359 config := c.config
360
361 hs.hello = &serverHelloMsg{
David Benjaminb1dd8cd2016-09-26 19:20:48 -0400362 isDTLS: c.isDTLS,
363 vers: versionToWire(c.vers, c.isDTLS),
364 versOverride: config.Bugs.SendServerHelloVersion,
Steven Valdez5440fe02016-07-18 12:40:30 -0400365 }
366
Nick Harper728eed82016-07-07 17:36:52 -0700367 hs.hello.random = make([]byte, 32)
368 if _, err := io.ReadFull(config.rand(), hs.hello.random); err != nil {
369 c.sendAlert(alertInternalError)
370 return err
371 }
372
373 // TLS 1.3 forbids clients from advertising any non-null compression.
374 if len(hs.clientHello.compressionMethods) != 1 || hs.clientHello.compressionMethods[0] != compressionNone {
375 return errors.New("tls: client sent compression method other than null for TLS 1.3")
376 }
377
378 // Prepare an EncryptedExtensions message, but do not send it yet.
379 encryptedExtensions := new(encryptedExtensionsMsg)
Steven Valdez143e8b32016-07-11 13:19:03 -0400380 encryptedExtensions.empty = config.Bugs.EmptyEncryptedExtensions
Nick Harper728eed82016-07-07 17:36:52 -0700381 if err := hs.processClientExtensions(&encryptedExtensions.extensions); err != nil {
382 return err
383 }
384
385 supportedCurve := false
386 var selectedCurve CurveID
387 preferredCurves := config.curvePreferences()
388Curves:
389 for _, curve := range hs.clientHello.supportedCurves {
390 for _, supported := range preferredCurves {
391 if supported == curve {
392 supportedCurve = true
393 selectedCurve = curve
394 break Curves
395 }
396 }
397 }
398
399 _, ecdsaOk := hs.cert.PrivateKey.(*ecdsa.PrivateKey)
400
David Benjamin405da482016-08-08 17:25:07 -0400401 pskIdentities := hs.clientHello.pskIdentities
402 if len(pskIdentities) == 0 && len(hs.clientHello.sessionTicket) > 0 && c.config.Bugs.AcceptAnySession {
Steven Valdez5b986082016-09-01 12:29:49 -0400403 psk := pskIdentity{
404 keModes: []byte{pskDHEKEMode},
405 authModes: []byte{pskAuthMode},
406 ticket: hs.clientHello.sessionTicket,
407 }
408 pskIdentities = []pskIdentity{psk}
David Benjamin405da482016-08-08 17:25:07 -0400409 }
410 for i, pskIdentity := range pskIdentities {
Steven Valdez5b986082016-09-01 12:29:49 -0400411 foundKE := false
412 foundAuth := false
413
414 for _, keMode := range pskIdentity.keModes {
415 if keMode == pskDHEKEMode {
416 foundKE = true
417 }
418 }
419
420 for _, authMode := range pskIdentity.authModes {
421 if authMode == pskAuthMode {
422 foundAuth = true
423 }
424 }
425
426 if !foundKE || !foundAuth {
427 continue
428 }
429
430 sessionState, ok := c.decryptTicket(pskIdentity.ticket)
Nick Harper0b3625b2016-07-25 16:16:28 -0700431 if !ok {
432 continue
433 }
David Benjamin405da482016-08-08 17:25:07 -0400434 if !config.Bugs.AcceptAnySession {
435 if sessionState.vers != c.vers && c.config.Bugs.AcceptAnySession {
436 continue
437 }
David Benjamin405da482016-08-08 17:25:07 -0400438 if sessionState.ticketExpiration.Before(c.config.time()) {
439 continue
440 }
Nick Harper0b3625b2016-07-25 16:16:28 -0700441 }
David Benjamin405da482016-08-08 17:25:07 -0400442
Nick Harper0b3625b2016-07-25 16:16:28 -0700443 suiteId := ecdhePSKSuite(sessionState.cipherSuite)
David Benjamin405da482016-08-08 17:25:07 -0400444
445 // Check the client offered the cipher.
446 clientCipherSuites := hs.clientHello.cipherSuites
447 if config.Bugs.AcceptAnySession {
448 clientCipherSuites = []uint16{suiteId}
449 }
450 suite := mutualCipherSuite(clientCipherSuites, suiteId)
451
David Benjamin46662482016-08-17 00:51:00 -0400452 // Check the cipher is enabled by the server or is a resumption
453 // suite of one enabled by the server. Account for the cipher
454 // change on resume.
455 //
456 // TODO(davidben): The ecdhePSKSuite mess will be gone with the
457 // new cipher negotiation scheme.
Nick Harper0b3625b2016-07-25 16:16:28 -0700458 var found bool
459 for _, id := range config.cipherSuites() {
David Benjamin46662482016-08-17 00:51:00 -0400460 if ecdhePSKSuite(id) == suiteId {
Nick Harper0b3625b2016-07-25 16:16:28 -0700461 found = true
462 break
463 }
464 }
David Benjamin405da482016-08-08 17:25:07 -0400465
Nick Harper0b3625b2016-07-25 16:16:28 -0700466 if suite != nil && found {
467 hs.sessionState = sessionState
468 hs.suite = suite
469 hs.hello.hasPSKIdentity = true
470 hs.hello.pskIdentity = uint16(i)
471 c.didResume = true
472 break
473 }
Nick Harper728eed82016-07-07 17:36:52 -0700474 }
475
Nick Harper0b3625b2016-07-25 16:16:28 -0700476 // If not resuming, select the cipher suite.
477 if hs.suite == nil {
478 var preferenceList, supportedList []uint16
479 if config.PreferServerCipherSuites {
480 preferenceList = config.cipherSuites()
481 supportedList = hs.clientHello.cipherSuites
482 } else {
483 preferenceList = hs.clientHello.cipherSuites
484 supportedList = config.cipherSuites()
485 }
486
487 for _, id := range preferenceList {
488 if hs.suite = c.tryCipherSuite(id, supportedList, c.vers, supportedCurve, ecdsaOk, false); hs.suite != nil {
489 break
490 }
Nick Harper728eed82016-07-07 17:36:52 -0700491 }
492 }
493
494 if hs.suite == nil {
495 c.sendAlert(alertHandshakeFailure)
496 return errors.New("tls: no cipher suite supported by both client and server")
497 }
498
499 hs.hello.cipherSuite = hs.suite.id
Steven Valdez0ee2e112016-07-15 06:51:15 -0400500 if c.config.Bugs.SendCipherSuite != 0 {
501 hs.hello.cipherSuite = c.config.Bugs.SendCipherSuite
502 }
503
Nick Harper728eed82016-07-07 17:36:52 -0700504 hs.finishedHash = newFinishedHash(c.vers, hs.suite)
505 hs.finishedHash.discardHandshakeBuffer()
506 hs.writeClientHash(hs.clientHello.marshal())
507
508 // Resolve PSK and compute the early secret.
Nick Harper0b3625b2016-07-25 16:16:28 -0700509 var psk []byte
David Benjamin5ecb88b2016-10-04 17:51:35 -0400510 if hs.suite.flags&suitePSK != 0 {
Nick Harper0b3625b2016-07-25 16:16:28 -0700511 psk = deriveResumptionPSK(hs.suite, hs.sessionState.masterSecret)
512 hs.finishedHash.setResumptionContext(deriveResumptionContext(hs.suite, hs.sessionState.masterSecret))
513 } else {
514 psk = hs.finishedHash.zeroSecret()
515 hs.finishedHash.setResumptionContext(hs.finishedHash.zeroSecret())
516 }
Nick Harper728eed82016-07-07 17:36:52 -0700517
518 earlySecret := hs.finishedHash.extractKey(hs.finishedHash.zeroSecret(), psk)
519
520 // Resolve ECDHE and compute the handshake secret.
521 var ecdheSecret []byte
Steven Valdez143e8b32016-07-11 13:19:03 -0400522 if hs.suite.flags&suiteECDHE != 0 && !config.Bugs.MissingKeyShare {
Nick Harper728eed82016-07-07 17:36:52 -0700523 // Look for the key share corresponding to our selected curve.
524 var selectedKeyShare *keyShareEntry
525 for i := range hs.clientHello.keyShares {
526 if hs.clientHello.keyShares[i].group == selectedCurve {
527 selectedKeyShare = &hs.clientHello.keyShares[i]
528 break
529 }
530 }
531
David Benjamine73c7f42016-08-17 00:29:33 -0400532 if config.Bugs.ExpectMissingKeyShare && selectedKeyShare != nil {
533 return errors.New("tls: expected missing key share")
534 }
535
Steven Valdez5440fe02016-07-18 12:40:30 -0400536 sendHelloRetryRequest := selectedKeyShare == nil
537 if config.Bugs.UnnecessaryHelloRetryRequest {
538 sendHelloRetryRequest = true
539 }
540 if config.Bugs.SkipHelloRetryRequest {
541 sendHelloRetryRequest = false
542 }
543 if sendHelloRetryRequest {
544 firstTime := true
545 ResendHelloRetryRequest:
Nick Harperdcfbc672016-07-16 17:47:31 +0200546 // Send HelloRetryRequest.
547 helloRetryRequestMsg := helloRetryRequestMsg{
Steven Valdezfdd10992016-09-15 16:27:05 -0400548 vers: versionToWire(c.vers, c.isDTLS),
Nick Harperdcfbc672016-07-16 17:47:31 +0200549 cipherSuite: hs.hello.cipherSuite,
550 selectedGroup: selectedCurve,
551 }
Steven Valdez5440fe02016-07-18 12:40:30 -0400552 if config.Bugs.SendHelloRetryRequestCurve != 0 {
553 helloRetryRequestMsg.selectedGroup = config.Bugs.SendHelloRetryRequestCurve
554 }
Nick Harperdcfbc672016-07-16 17:47:31 +0200555 hs.writeServerHash(helloRetryRequestMsg.marshal())
556 c.writeRecord(recordTypeHandshake, helloRetryRequestMsg.marshal())
David Benjamine73c7f42016-08-17 00:29:33 -0400557 c.flushHandshake()
Nick Harperdcfbc672016-07-16 17:47:31 +0200558
559 // Read new ClientHello.
560 newMsg, err := c.readHandshake()
561 if err != nil {
562 return err
563 }
564 newClientHello, ok := newMsg.(*clientHelloMsg)
565 if !ok {
566 c.sendAlert(alertUnexpectedMessage)
567 return unexpectedMessageError(newClientHello, newMsg)
568 }
569 hs.writeClientHash(newClientHello.marshal())
570
571 // Check that the new ClientHello matches the old ClientHello, except for
572 // the addition of the new KeyShareEntry at the end of the list, and
573 // removing the EarlyDataIndication extension (if present).
574 newKeyShares := newClientHello.keyShares
575 if len(newKeyShares) == 0 || newKeyShares[len(newKeyShares)-1].group != selectedCurve {
576 return errors.New("tls: KeyShare from HelloRetryRequest not present in new ClientHello")
577 }
578 oldClientHelloCopy := *hs.clientHello
579 oldClientHelloCopy.raw = nil
580 oldClientHelloCopy.hasEarlyData = false
581 oldClientHelloCopy.earlyDataContext = nil
582 newClientHelloCopy := *newClientHello
583 newClientHelloCopy.raw = nil
584 newClientHelloCopy.keyShares = newKeyShares[:len(newKeyShares)-1]
585 if !oldClientHelloCopy.equal(&newClientHelloCopy) {
586 return errors.New("tls: new ClientHello does not match")
587 }
588
Steven Valdez5440fe02016-07-18 12:40:30 -0400589 if firstTime && config.Bugs.SecondHelloRetryRequest {
590 firstTime = false
591 goto ResendHelloRetryRequest
592 }
593
Nick Harperdcfbc672016-07-16 17:47:31 +0200594 selectedKeyShare = &newKeyShares[len(newKeyShares)-1]
Nick Harper728eed82016-07-07 17:36:52 -0700595 }
596
597 // Once a curve has been selected and a key share identified,
598 // the server needs to generate a public value and send it in
599 // the ServerHello.
Steven Valdez5440fe02016-07-18 12:40:30 -0400600 curve, ok := curveForCurveID(selectedCurve)
Nick Harper728eed82016-07-07 17:36:52 -0700601 if !ok {
602 panic("tls: server failed to look up curve ID")
603 }
Steven Valdez5440fe02016-07-18 12:40:30 -0400604 c.curveID = selectedCurve
605
606 var peerKey []byte
607 if config.Bugs.SkipHelloRetryRequest {
608 // If skipping HelloRetryRequest, use a random key to
609 // avoid crashing.
610 curve2, _ := curveForCurveID(selectedCurve)
611 var err error
612 peerKey, err = curve2.offer(config.rand())
613 if err != nil {
614 return err
615 }
616 } else {
617 peerKey = selectedKeyShare.keyExchange
618 }
619
Nick Harper728eed82016-07-07 17:36:52 -0700620 var publicKey []byte
621 var err error
Steven Valdez5440fe02016-07-18 12:40:30 -0400622 publicKey, ecdheSecret, err = curve.accept(config.rand(), peerKey)
Nick Harper728eed82016-07-07 17:36:52 -0700623 if err != nil {
624 c.sendAlert(alertHandshakeFailure)
625 return err
626 }
627 hs.hello.hasKeyShare = true
Steven Valdez0ee2e112016-07-15 06:51:15 -0400628
Steven Valdez5440fe02016-07-18 12:40:30 -0400629 curveID := selectedCurve
Steven Valdez0ee2e112016-07-15 06:51:15 -0400630 if c.config.Bugs.SendCurve != 0 {
631 curveID = config.Bugs.SendCurve
632 }
633 if c.config.Bugs.InvalidECDHPoint {
634 publicKey[0] ^= 0xff
635 }
636
Nick Harper728eed82016-07-07 17:36:52 -0700637 hs.hello.keyShare = keyShareEntry{
Steven Valdez0ee2e112016-07-15 06:51:15 -0400638 group: curveID,
Nick Harper728eed82016-07-07 17:36:52 -0700639 keyExchange: publicKey,
640 }
Steven Valdez143e8b32016-07-11 13:19:03 -0400641
642 if config.Bugs.EncryptedExtensionsWithKeyShare {
643 encryptedExtensions.extensions.hasKeyShare = true
644 encryptedExtensions.extensions.keyShare = keyShareEntry{
645 group: curveID,
646 keyExchange: publicKey,
647 }
648 }
Nick Harper728eed82016-07-07 17:36:52 -0700649 } else {
650 ecdheSecret = hs.finishedHash.zeroSecret()
651 }
652
653 // Send unencrypted ServerHello.
654 hs.writeServerHash(hs.hello.marshal())
David Benjamin7964b182016-07-14 23:36:30 -0400655 if config.Bugs.PartialEncryptedExtensionsWithServerHello {
656 helloBytes := hs.hello.marshal()
657 toWrite := make([]byte, 0, len(helloBytes)+1)
658 toWrite = append(toWrite, helloBytes...)
659 toWrite = append(toWrite, typeEncryptedExtensions)
660 c.writeRecord(recordTypeHandshake, toWrite)
661 } else {
662 c.writeRecord(recordTypeHandshake, hs.hello.marshal())
663 }
Nick Harper728eed82016-07-07 17:36:52 -0700664 c.flushHandshake()
665
666 // Compute the handshake secret.
667 handshakeSecret := hs.finishedHash.extractKey(earlySecret, ecdheSecret)
668
669 // Switch to handshake traffic keys.
670 handshakeTrafficSecret := hs.finishedHash.deriveSecret(handshakeSecret, handshakeTrafficLabel)
David Benjamin21c00282016-07-18 21:56:23 +0200671 c.out.useTrafficSecret(c.vers, hs.suite, handshakeTrafficSecret, handshakePhase, serverWrite)
672 c.in.useTrafficSecret(c.vers, hs.suite, handshakeTrafficSecret, handshakePhase, clientWrite)
Nick Harper728eed82016-07-07 17:36:52 -0700673
Nick Harper0b3625b2016-07-25 16:16:28 -0700674 if hs.suite.flags&suitePSK == 0 {
David Benjamin615119a2016-07-06 19:22:55 -0700675 if hs.clientHello.ocspStapling {
676 encryptedExtensions.extensions.ocspResponse = hs.cert.OCSPStaple
677 }
678 if hs.clientHello.sctListSupported {
679 encryptedExtensions.extensions.sctList = hs.cert.SignedCertificateTimestampList
680 }
David Benjamindaa88502016-10-04 16:32:16 -0400681 } else {
682 if config.Bugs.SendOCSPResponseOnResume != nil {
683 encryptedExtensions.extensions.ocspResponse = config.Bugs.SendOCSPResponseOnResume
684 }
685 if config.Bugs.SendSCTListOnResume != nil {
686 encryptedExtensions.extensions.sctList = config.Bugs.SendSCTListOnResume
687 }
David Benjamin615119a2016-07-06 19:22:55 -0700688 }
689
Nick Harper728eed82016-07-07 17:36:52 -0700690 // Send EncryptedExtensions.
691 hs.writeServerHash(encryptedExtensions.marshal())
David Benjamin7964b182016-07-14 23:36:30 -0400692 if config.Bugs.PartialEncryptedExtensionsWithServerHello {
693 // The first byte has already been sent.
694 c.writeRecord(recordTypeHandshake, encryptedExtensions.marshal()[1:])
695 } else {
696 c.writeRecord(recordTypeHandshake, encryptedExtensions.marshal())
697 }
Nick Harper728eed82016-07-07 17:36:52 -0700698
699 if hs.suite.flags&suitePSK == 0 {
700 if config.ClientAuth >= RequestClientCert {
David Benjamin8d343b42016-07-09 14:26:01 -0700701 // Request a client certificate
702 certReq := &certificateRequestMsg{
703 hasSignatureAlgorithm: true,
704 hasRequestContext: true,
David Benjamin8a8349b2016-08-18 02:32:23 -0400705 requestContext: config.Bugs.SendRequestContext,
David Benjamin8d343b42016-07-09 14:26:01 -0700706 }
707 if !config.Bugs.NoSignatureAlgorithms {
David Benjaminf74ec792016-07-13 21:18:49 -0400708 certReq.signatureAlgorithms = config.verifySignatureAlgorithms()
David Benjamin8d343b42016-07-09 14:26:01 -0700709 }
710
711 // An empty list of certificateAuthorities signals to
712 // the client that it may send any certificate in response
713 // to our request. When we know the CAs we trust, then
714 // we can send them down, so that the client can choose
715 // an appropriate certificate to give to us.
716 if config.ClientCAs != nil {
717 certReq.certificateAuthorities = config.ClientCAs.Subjects()
718 }
719 hs.writeServerHash(certReq.marshal())
720 c.writeRecord(recordTypeHandshake, certReq.marshal())
Nick Harper728eed82016-07-07 17:36:52 -0700721 }
722
723 certMsg := &certificateMsg{
724 hasRequestContext: true,
725 }
726 if !config.Bugs.EmptyCertificateList {
727 certMsg.certificates = hs.cert.Certificate
728 }
David Benjamin1edae6b2016-07-13 16:58:23 -0400729 certMsgBytes := certMsg.marshal()
David Benjamin1edae6b2016-07-13 16:58:23 -0400730 hs.writeServerHash(certMsgBytes)
731 c.writeRecord(recordTypeHandshake, certMsgBytes)
Nick Harper728eed82016-07-07 17:36:52 -0700732
733 certVerify := &certificateVerifyMsg{
734 hasSignatureAlgorithm: true,
735 }
736
737 // Determine the hash to sign.
738 privKey := hs.cert.PrivateKey
739
740 var err error
741 certVerify.signatureAlgorithm, err = selectSignatureAlgorithm(c.vers, privKey, config, hs.clientHello.signatureAlgorithms)
742 if err != nil {
743 c.sendAlert(alertInternalError)
744 return err
745 }
746
747 input := hs.finishedHash.certificateVerifyInput(serverCertificateVerifyContextTLS13)
748 certVerify.signature, err = signMessage(c.vers, privKey, c.config, certVerify.signatureAlgorithm, input)
749 if err != nil {
750 c.sendAlert(alertInternalError)
751 return err
752 }
753
Steven Valdez0ee2e112016-07-15 06:51:15 -0400754 if config.Bugs.SendSignatureAlgorithm != 0 {
755 certVerify.signatureAlgorithm = config.Bugs.SendSignatureAlgorithm
756 }
757
Nick Harper728eed82016-07-07 17:36:52 -0700758 hs.writeServerHash(certVerify.marshal())
759 c.writeRecord(recordTypeHandshake, certVerify.marshal())
Nick Harper0b3625b2016-07-25 16:16:28 -0700760 } else {
761 // Pick up certificates from the session instead.
David Benjamin5ecb88b2016-10-04 17:51:35 -0400762 if len(hs.sessionState.certificates) > 0 {
Nick Harper0b3625b2016-07-25 16:16:28 -0700763 if _, err := hs.processCertsFromClient(hs.sessionState.certificates); err != nil {
764 return err
765 }
766 }
Nick Harper728eed82016-07-07 17:36:52 -0700767 }
768
769 finished := new(finishedMsg)
770 finished.verifyData = hs.finishedHash.serverSum(handshakeTrafficSecret)
771 if config.Bugs.BadFinished {
772 finished.verifyData[0]++
773 }
774 hs.writeServerHash(finished.marshal())
775 c.writeRecord(recordTypeHandshake, finished.marshal())
David Benjamin02edcd02016-07-27 17:40:37 -0400776 if c.config.Bugs.SendExtraFinished {
777 c.writeRecord(recordTypeHandshake, finished.marshal())
778 }
Nick Harper728eed82016-07-07 17:36:52 -0700779 c.flushHandshake()
780
781 // The various secrets do not incorporate the client's final leg, so
782 // derive them now before updating the handshake context.
783 masterSecret := hs.finishedHash.extractKey(handshakeSecret, hs.finishedHash.zeroSecret())
784 trafficSecret := hs.finishedHash.deriveSecret(masterSecret, applicationTrafficLabel)
785
David Benjamin2aad4062016-07-14 23:15:40 -0400786 // Switch to application data keys on write. In particular, any alerts
787 // from the client certificate are sent over these keys.
David Benjamin21c00282016-07-18 21:56:23 +0200788 c.out.useTrafficSecret(c.vers, hs.suite, trafficSecret, applicationPhase, serverWrite)
David Benjamin2aad4062016-07-14 23:15:40 -0400789
Nick Harper728eed82016-07-07 17:36:52 -0700790 // If we requested a client certificate, then the client must send a
791 // certificate message, even if it's empty.
792 if config.ClientAuth >= RequestClientCert {
David Benjamin8d343b42016-07-09 14:26:01 -0700793 msg, err := c.readHandshake()
794 if err != nil {
795 return err
796 }
797
798 certMsg, ok := msg.(*certificateMsg)
799 if !ok {
800 c.sendAlert(alertUnexpectedMessage)
801 return unexpectedMessageError(certMsg, msg)
802 }
803 hs.writeClientHash(certMsg.marshal())
804
805 if len(certMsg.certificates) == 0 {
806 // The client didn't actually send a certificate
807 switch config.ClientAuth {
808 case RequireAnyClientCert, RequireAndVerifyClientCert:
809 c.sendAlert(alertBadCertificate)
810 return errors.New("tls: client didn't provide a certificate")
811 }
812 }
813
814 pub, err := hs.processCertsFromClient(certMsg.certificates)
815 if err != nil {
816 return err
817 }
818
819 if len(c.peerCertificates) > 0 {
820 msg, err = c.readHandshake()
821 if err != nil {
822 return err
823 }
824
825 certVerify, ok := msg.(*certificateVerifyMsg)
826 if !ok {
827 c.sendAlert(alertUnexpectedMessage)
828 return unexpectedMessageError(certVerify, msg)
829 }
830
David Benjaminf74ec792016-07-13 21:18:49 -0400831 c.peerSignatureAlgorithm = certVerify.signatureAlgorithm
David Benjamin8d343b42016-07-09 14:26:01 -0700832 input := hs.finishedHash.certificateVerifyInput(clientCertificateVerifyContextTLS13)
833 if err := verifyMessage(c.vers, pub, config, certVerify.signatureAlgorithm, input, certVerify.signature); err != nil {
834 c.sendAlert(alertBadCertificate)
835 return err
836 }
837 hs.writeClientHash(certVerify.marshal())
838 }
Nick Harper728eed82016-07-07 17:36:52 -0700839 }
840
841 // Read the client Finished message.
842 msg, err := c.readHandshake()
843 if err != nil {
844 return err
845 }
846 clientFinished, ok := msg.(*finishedMsg)
847 if !ok {
848 c.sendAlert(alertUnexpectedMessage)
849 return unexpectedMessageError(clientFinished, msg)
850 }
851
852 verify := hs.finishedHash.clientSum(handshakeTrafficSecret)
853 if len(verify) != len(clientFinished.verifyData) ||
854 subtle.ConstantTimeCompare(verify, clientFinished.verifyData) != 1 {
855 c.sendAlert(alertHandshakeFailure)
856 return errors.New("tls: client's Finished message was incorrect")
857 }
David Benjamin97a0a082016-07-13 17:57:35 -0400858 hs.writeClientHash(clientFinished.marshal())
Nick Harper728eed82016-07-07 17:36:52 -0700859
David Benjamin2aad4062016-07-14 23:15:40 -0400860 // Switch to application data keys on read.
David Benjamin21c00282016-07-18 21:56:23 +0200861 c.in.useTrafficSecret(c.vers, hs.suite, trafficSecret, applicationPhase, clientWrite)
Nick Harper728eed82016-07-07 17:36:52 -0700862
Nick Harper728eed82016-07-07 17:36:52 -0700863 c.cipherSuite = hs.suite
David Benjamin97a0a082016-07-13 17:57:35 -0400864 c.exporterSecret = hs.finishedHash.deriveSecret(masterSecret, exporterLabel)
David Benjamin58104882016-07-18 01:25:41 +0200865 c.resumptionSecret = hs.finishedHash.deriveSecret(masterSecret, resumptionLabel)
866
867 // TODO(davidben): Allow configuring the number of tickets sent for
868 // testing.
869 if !c.config.SessionTicketsDisabled {
870 ticketCount := 2
871 for i := 0; i < ticketCount; i++ {
872 c.SendNewSessionTicket()
873 }
874 }
Nick Harper728eed82016-07-07 17:36:52 -0700875 return nil
876}
877
David Benjaminf25dda92016-07-04 10:05:26 -0700878// processClientHello processes the ClientHello message from the client and
879// decides whether we will perform session resumption.
880func (hs *serverHandshakeState) processClientHello() (isResume bool, err error) {
881 config := hs.c.config
882 c := hs.c
883
884 hs.hello = &serverHelloMsg{
885 isDTLS: c.isDTLS,
David Benjamin3c6a1ea2016-09-26 18:30:05 -0400886 vers: versionToWire(c.vers, c.isDTLS),
David Benjaminb1dd8cd2016-09-26 19:20:48 -0400887 versOverride: config.Bugs.SendServerHelloVersion,
David Benjaminf25dda92016-07-04 10:05:26 -0700888 compressionMethod: compressionNone,
889 }
890
891 hs.hello.random = make([]byte, 32)
892 _, err = io.ReadFull(config.rand(), hs.hello.random)
893 if err != nil {
894 c.sendAlert(alertInternalError)
895 return false, err
896 }
David Benjamin1f61f0d2016-07-10 12:20:35 -0400897 // Signal downgrades in the server random, per draft-ietf-tls-tls13-14,
898 // section 6.3.1.2.
Nick Harper85f20c22016-07-04 10:11:59 -0700899 if c.vers <= VersionTLS12 && config.maxVersion(c.isDTLS) >= VersionTLS13 {
David Benjamin1f61f0d2016-07-10 12:20:35 -0400900 copy(hs.hello.random[len(hs.hello.random)-8:], downgradeTLS13)
Nick Harper85f20c22016-07-04 10:11:59 -0700901 }
902 if c.vers <= VersionTLS11 && config.maxVersion(c.isDTLS) == VersionTLS12 {
David Benjamin1f61f0d2016-07-10 12:20:35 -0400903 copy(hs.hello.random[len(hs.hello.random)-8:], downgradeTLS12)
Nick Harper85f20c22016-07-04 10:11:59 -0700904 }
David Benjaminf25dda92016-07-04 10:05:26 -0700905
906 foundCompression := false
907 // We only support null compression, so check that the client offered it.
908 for _, compression := range hs.clientHello.compressionMethods {
909 if compression == compressionNone {
910 foundCompression = true
911 break
912 }
913 }
914
915 if !foundCompression {
916 c.sendAlert(alertHandshakeFailure)
917 return false, errors.New("tls: client does not support uncompressed connections")
918 }
David Benjamin7d79f832016-07-04 09:20:45 -0700919
920 if err := hs.processClientExtensions(&hs.hello.extensions); err != nil {
921 return false, err
Adam Langley09505632015-07-30 18:10:13 -0700922 }
Adam Langley95c29f32014-06-20 12:00:00 -0700923
924 supportedCurve := false
925 preferredCurves := config.curvePreferences()
926Curves:
927 for _, curve := range hs.clientHello.supportedCurves {
928 for _, supported := range preferredCurves {
929 if supported == curve {
930 supportedCurve = true
931 break Curves
932 }
933 }
934 }
935
936 supportedPointFormat := false
937 for _, pointFormat := range hs.clientHello.supportedPoints {
938 if pointFormat == pointFormatUncompressed {
939 supportedPointFormat = true
940 break
941 }
942 }
943 hs.ellipticOk = supportedCurve && supportedPointFormat
944
Adam Langley95c29f32014-06-20 12:00:00 -0700945 _, hs.ecdsaOk = hs.cert.PrivateKey.(*ecdsa.PrivateKey)
946
David Benjamin4b27d9f2015-05-12 22:42:52 -0400947 // For test purposes, check that the peer never offers a session when
948 // renegotiating.
949 if c.cipherSuite != nil && len(hs.clientHello.sessionId) > 0 && c.config.Bugs.FailIfResumeOnRenego {
950 return false, errors.New("tls: offered resumption on renegotiation")
951 }
952
David Benjamindd6fed92015-10-23 17:41:12 -0400953 if c.config.Bugs.FailIfSessionOffered && (len(hs.clientHello.sessionTicket) > 0 || len(hs.clientHello.sessionId) > 0) {
954 return false, errors.New("tls: client offered a session ticket or ID")
955 }
956
Adam Langley95c29f32014-06-20 12:00:00 -0700957 if hs.checkForResumption() {
958 return true, nil
959 }
960
Adam Langley95c29f32014-06-20 12:00:00 -0700961 var preferenceList, supportedList []uint16
962 if c.config.PreferServerCipherSuites {
963 preferenceList = c.config.cipherSuites()
964 supportedList = hs.clientHello.cipherSuites
965 } else {
966 preferenceList = hs.clientHello.cipherSuites
967 supportedList = c.config.cipherSuites()
968 }
969
970 for _, id := range preferenceList {
Nick Harper728eed82016-07-07 17:36:52 -0700971 if hs.suite = c.tryCipherSuite(id, supportedList, c.vers, hs.ellipticOk, hs.ecdsaOk, true); hs.suite != nil {
Adam Langley95c29f32014-06-20 12:00:00 -0700972 break
973 }
974 }
975
976 if hs.suite == nil {
977 c.sendAlert(alertHandshakeFailure)
978 return false, errors.New("tls: no cipher suite supported by both client and server")
979 }
980
981 return false, nil
982}
983
David Benjamin7d79f832016-07-04 09:20:45 -0700984// processClientExtensions processes all ClientHello extensions not directly
985// related to cipher suite negotiation and writes responses in serverExtensions.
986func (hs *serverHandshakeState) processClientExtensions(serverExtensions *serverExtensions) error {
987 config := hs.c.config
988 c := hs.c
989
David Benjamin8d315d72016-07-18 01:03:18 +0200990 if c.vers < VersionTLS13 || config.Bugs.NegotiateRenegotiationInfoAtAllVersions {
Nick Harper728eed82016-07-07 17:36:52 -0700991 if !bytes.Equal(c.clientVerify, hs.clientHello.secureRenegotiation) {
992 c.sendAlert(alertHandshakeFailure)
993 return errors.New("tls: renegotiation mismatch")
David Benjamin7d79f832016-07-04 09:20:45 -0700994 }
David Benjamin7d79f832016-07-04 09:20:45 -0700995
Nick Harper728eed82016-07-07 17:36:52 -0700996 if len(c.clientVerify) > 0 && !c.config.Bugs.EmptyRenegotiationInfo {
997 serverExtensions.secureRenegotiation = append(serverExtensions.secureRenegotiation, c.clientVerify...)
998 serverExtensions.secureRenegotiation = append(serverExtensions.secureRenegotiation, c.serverVerify...)
999 if c.config.Bugs.BadRenegotiationInfo {
1000 serverExtensions.secureRenegotiation[0] ^= 0x80
1001 }
1002 } else {
1003 serverExtensions.secureRenegotiation = hs.clientHello.secureRenegotiation
1004 }
1005
1006 if c.noRenegotiationInfo() {
1007 serverExtensions.secureRenegotiation = nil
1008 }
David Benjamin7d79f832016-07-04 09:20:45 -07001009 }
1010
1011 serverExtensions.duplicateExtension = c.config.Bugs.DuplicateExtension
1012
1013 if len(hs.clientHello.serverName) > 0 {
1014 c.serverName = hs.clientHello.serverName
1015 }
1016 if len(config.Certificates) == 0 {
1017 c.sendAlert(alertInternalError)
1018 return errors.New("tls: no certificates configured")
1019 }
1020 hs.cert = &config.Certificates[0]
1021 if len(hs.clientHello.serverName) > 0 {
1022 hs.cert = config.getCertificateForName(hs.clientHello.serverName)
1023 }
1024 if expected := c.config.Bugs.ExpectServerName; expected != "" && expected != hs.clientHello.serverName {
1025 return errors.New("tls: unexpected server name")
1026 }
1027
1028 if len(hs.clientHello.alpnProtocols) > 0 {
1029 if proto := c.config.Bugs.ALPNProtocol; proto != nil {
1030 serverExtensions.alpnProtocol = *proto
1031 serverExtensions.alpnProtocolEmpty = len(*proto) == 0
1032 c.clientProtocol = *proto
1033 c.usedALPN = true
1034 } else if selectedProto, fallback := mutualProtocol(hs.clientHello.alpnProtocols, c.config.NextProtos); !fallback {
1035 serverExtensions.alpnProtocol = selectedProto
1036 c.clientProtocol = selectedProto
1037 c.usedALPN = true
1038 }
1039 }
Nick Harper728eed82016-07-07 17:36:52 -07001040
David Benjamin0c40a962016-08-01 12:05:50 -04001041 if len(c.config.Bugs.SendALPN) > 0 {
1042 serverExtensions.alpnProtocol = c.config.Bugs.SendALPN
1043 }
1044
David Benjamin8d315d72016-07-18 01:03:18 +02001045 if c.vers < VersionTLS13 || config.Bugs.NegotiateNPNAtAllVersions {
Nick Harper728eed82016-07-07 17:36:52 -07001046 if len(hs.clientHello.alpnProtocols) == 0 || c.config.Bugs.NegotiateALPNAndNPN {
1047 // Although sending an empty NPN extension is reasonable, Firefox has
1048 // had a bug around this. Best to send nothing at all if
1049 // config.NextProtos is empty. See
1050 // https://code.google.com/p/go/issues/detail?id=5445.
1051 if hs.clientHello.nextProtoNeg && len(config.NextProtos) > 0 {
1052 serverExtensions.nextProtoNeg = true
1053 serverExtensions.nextProtos = config.NextProtos
1054 serverExtensions.npnLast = config.Bugs.SwapNPNAndALPN
1055 }
David Benjamin7d79f832016-07-04 09:20:45 -07001056 }
Steven Valdez143e8b32016-07-11 13:19:03 -04001057 }
David Benjamin7d79f832016-07-04 09:20:45 -07001058
David Benjamin8d315d72016-07-18 01:03:18 +02001059 if c.vers < VersionTLS13 || config.Bugs.NegotiateEMSAtAllVersions {
David Benjamin163c9562016-08-29 23:14:17 -04001060 disableEMS := config.Bugs.NoExtendedMasterSecret
1061 if c.cipherSuite != nil {
1062 disableEMS = config.Bugs.NoExtendedMasterSecretOnRenegotiation
1063 }
1064 serverExtensions.extendedMasterSecret = c.vers >= VersionTLS10 && hs.clientHello.extendedMasterSecret && !disableEMS
Steven Valdez143e8b32016-07-11 13:19:03 -04001065 }
David Benjamin7d79f832016-07-04 09:20:45 -07001066
David Benjamin8d315d72016-07-18 01:03:18 +02001067 if c.vers < VersionTLS13 || config.Bugs.NegotiateChannelIDAtAllVersions {
Nick Harper728eed82016-07-07 17:36:52 -07001068 if hs.clientHello.channelIDSupported && config.RequestChannelID {
1069 serverExtensions.channelIDRequested = true
1070 }
David Benjamin7d79f832016-07-04 09:20:45 -07001071 }
1072
1073 if hs.clientHello.srtpProtectionProfiles != nil {
1074 SRTPLoop:
1075 for _, p1 := range c.config.SRTPProtectionProfiles {
1076 for _, p2 := range hs.clientHello.srtpProtectionProfiles {
1077 if p1 == p2 {
1078 serverExtensions.srtpProtectionProfile = p1
1079 c.srtpProtectionProfile = p1
1080 break SRTPLoop
1081 }
1082 }
1083 }
1084 }
1085
1086 if c.config.Bugs.SendSRTPProtectionProfile != 0 {
1087 serverExtensions.srtpProtectionProfile = c.config.Bugs.SendSRTPProtectionProfile
1088 }
1089
1090 if expected := c.config.Bugs.ExpectedCustomExtension; expected != nil {
1091 if hs.clientHello.customExtension != *expected {
1092 return fmt.Errorf("tls: bad custom extension contents %q", hs.clientHello.customExtension)
1093 }
1094 }
1095 serverExtensions.customExtension = config.Bugs.CustomExtension
1096
Steven Valdez143e8b32016-07-11 13:19:03 -04001097 if c.config.Bugs.AdvertiseTicketExtension {
1098 serverExtensions.ticketSupported = true
1099 }
1100
David Benjamin65ac9972016-09-02 21:35:25 -04001101 if !hs.clientHello.hasGREASEExtension && config.Bugs.ExpectGREASE {
1102 return errors.New("tls: no GREASE extension found")
1103 }
1104
David Benjamin7d79f832016-07-04 09:20:45 -07001105 return nil
1106}
1107
Adam Langley95c29f32014-06-20 12:00:00 -07001108// checkForResumption returns true if we should perform resumption on this connection.
1109func (hs *serverHandshakeState) checkForResumption() bool {
1110 c := hs.c
1111
David Benjamin405da482016-08-08 17:25:07 -04001112 ticket := hs.clientHello.sessionTicket
1113 if len(ticket) == 0 && len(hs.clientHello.pskIdentities) > 0 && c.config.Bugs.AcceptAnySession {
Steven Valdez5b986082016-09-01 12:29:49 -04001114 ticket = hs.clientHello.pskIdentities[0].ticket
David Benjamin405da482016-08-08 17:25:07 -04001115 }
1116 if len(ticket) > 0 {
David Benjaminfe8eb9a2014-11-17 03:19:02 -05001117 if c.config.SessionTicketsDisabled {
1118 return false
1119 }
David Benjaminb0c8db72014-09-24 15:19:56 -04001120
David Benjaminfe8eb9a2014-11-17 03:19:02 -05001121 var ok bool
David Benjamin405da482016-08-08 17:25:07 -04001122 if hs.sessionState, ok = c.decryptTicket(ticket); !ok {
David Benjaminfe8eb9a2014-11-17 03:19:02 -05001123 return false
1124 }
1125 } else {
1126 if c.config.ServerSessionCache == nil {
1127 return false
1128 }
1129
1130 var ok bool
1131 sessionId := string(hs.clientHello.sessionId)
1132 if hs.sessionState, ok = c.config.ServerSessionCache.Get(sessionId); !ok {
1133 return false
1134 }
Adam Langley95c29f32014-06-20 12:00:00 -07001135 }
1136
David Benjamin405da482016-08-08 17:25:07 -04001137 if !c.config.Bugs.AcceptAnySession {
1138 // Never resume a session for a different SSL version.
1139 if c.vers != hs.sessionState.vers {
1140 return false
Adam Langley95c29f32014-06-20 12:00:00 -07001141 }
David Benjamin405da482016-08-08 17:25:07 -04001142
1143 cipherSuiteOk := false
1144 // Check that the client is still offering the ciphersuite in the session.
1145 for _, id := range hs.clientHello.cipherSuites {
1146 if id == hs.sessionState.cipherSuite {
1147 cipherSuiteOk = true
1148 break
1149 }
1150 }
1151 if !cipherSuiteOk {
1152 return false
1153 }
Adam Langley95c29f32014-06-20 12:00:00 -07001154 }
1155
1156 // Check that we also support the ciphersuite from the session.
Nick Harper728eed82016-07-07 17:36:52 -07001157 hs.suite = c.tryCipherSuite(hs.sessionState.cipherSuite, c.config.cipherSuites(), hs.sessionState.vers, hs.ellipticOk, hs.ecdsaOk, true)
Adam Langley95c29f32014-06-20 12:00:00 -07001158 if hs.suite == nil {
1159 return false
1160 }
1161
1162 sessionHasClientCerts := len(hs.sessionState.certificates) != 0
1163 needClientCerts := c.config.ClientAuth == RequireAnyClientCert || c.config.ClientAuth == RequireAndVerifyClientCert
1164 if needClientCerts && !sessionHasClientCerts {
1165 return false
1166 }
1167 if sessionHasClientCerts && c.config.ClientAuth == NoClientCert {
1168 return false
1169 }
1170
1171 return true
1172}
1173
1174func (hs *serverHandshakeState) doResumeHandshake() error {
1175 c := hs.c
1176
1177 hs.hello.cipherSuite = hs.suite.id
David Benjaminece3de92015-03-16 18:02:20 -04001178 if c.config.Bugs.SendCipherSuite != 0 {
1179 hs.hello.cipherSuite = c.config.Bugs.SendCipherSuite
1180 }
Adam Langley95c29f32014-06-20 12:00:00 -07001181 // We echo the client's session ID in the ServerHello to let it know
1182 // that we're doing a resumption.
1183 hs.hello.sessionId = hs.clientHello.sessionId
Nick Harperb3d51be2016-07-01 11:43:18 -04001184 hs.hello.extensions.ticketSupported = c.config.Bugs.RenewTicketOnResume
Adam Langley95c29f32014-06-20 12:00:00 -07001185
David Benjamin80d1b352016-05-04 19:19:06 -04001186 if c.config.Bugs.SendSCTListOnResume != nil {
Nick Harperb3d51be2016-07-01 11:43:18 -04001187 hs.hello.extensions.sctList = c.config.Bugs.SendSCTListOnResume
David Benjamin80d1b352016-05-04 19:19:06 -04001188 }
1189
David Benjamindaa88502016-10-04 16:32:16 -04001190 if c.config.Bugs.SendOCSPResponseOnResume != nil {
1191 // There is no way, syntactically, to send an OCSP response on a
1192 // resumption handshake.
1193 hs.hello.extensions.ocspStapling = true
1194 }
1195
Adam Langley95c29f32014-06-20 12:00:00 -07001196 hs.finishedHash = newFinishedHash(c.vers, hs.suite)
David Benjamine098ec22014-08-27 23:13:20 -04001197 hs.finishedHash.discardHandshakeBuffer()
David Benjamin83c0bc92014-08-04 01:23:53 -04001198 hs.writeClientHash(hs.clientHello.marshal())
1199 hs.writeServerHash(hs.hello.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001200
1201 c.writeRecord(recordTypeHandshake, hs.hello.marshal())
1202
1203 if len(hs.sessionState.certificates) > 0 {
1204 if _, err := hs.processCertsFromClient(hs.sessionState.certificates); err != nil {
1205 return err
1206 }
1207 }
1208
1209 hs.masterSecret = hs.sessionState.masterSecret
Adam Langley75712922014-10-10 16:23:43 -07001210 c.extendedMasterSecret = hs.sessionState.extendedMasterSecret
Adam Langley95c29f32014-06-20 12:00:00 -07001211
1212 return nil
1213}
1214
1215func (hs *serverHandshakeState) doFullHandshake() error {
1216 config := hs.c.config
1217 c := hs.c
1218
David Benjamin48cae082014-10-27 01:06:24 -04001219 isPSK := hs.suite.flags&suitePSK != 0
1220 if !isPSK && hs.clientHello.ocspStapling && len(hs.cert.OCSPStaple) > 0 {
Nick Harperb3d51be2016-07-01 11:43:18 -04001221 hs.hello.extensions.ocspStapling = true
Adam Langley95c29f32014-06-20 12:00:00 -07001222 }
1223
David Benjamin61f95272014-11-25 01:55:35 -05001224 if hs.clientHello.sctListSupported && len(hs.cert.SignedCertificateTimestampList) > 0 {
Nick Harperb3d51be2016-07-01 11:43:18 -04001225 hs.hello.extensions.sctList = hs.cert.SignedCertificateTimestampList
David Benjamin61f95272014-11-25 01:55:35 -05001226 }
1227
Nick Harperb3d51be2016-07-01 11:43:18 -04001228 hs.hello.extensions.ticketSupported = hs.clientHello.ticketSupported && !config.SessionTicketsDisabled && c.vers > VersionSSL30
Adam Langley95c29f32014-06-20 12:00:00 -07001229 hs.hello.cipherSuite = hs.suite.id
David Benjamin6095de82014-12-27 01:50:38 -05001230 if config.Bugs.SendCipherSuite != 0 {
1231 hs.hello.cipherSuite = config.Bugs.SendCipherSuite
1232 }
Nick Harperb3d51be2016-07-01 11:43:18 -04001233 c.extendedMasterSecret = hs.hello.extensions.extendedMasterSecret
Adam Langley95c29f32014-06-20 12:00:00 -07001234
David Benjaminfe8eb9a2014-11-17 03:19:02 -05001235 // Generate a session ID if we're to save the session.
Nick Harperb3d51be2016-07-01 11:43:18 -04001236 if !hs.hello.extensions.ticketSupported && config.ServerSessionCache != nil {
David Benjaminfe8eb9a2014-11-17 03:19:02 -05001237 hs.hello.sessionId = make([]byte, 32)
1238 if _, err := io.ReadFull(config.rand(), hs.hello.sessionId); err != nil {
1239 c.sendAlert(alertInternalError)
1240 return errors.New("tls: short read from Rand: " + err.Error())
1241 }
1242 }
1243
Adam Langley95c29f32014-06-20 12:00:00 -07001244 hs.finishedHash = newFinishedHash(c.vers, hs.suite)
David Benjamin83c0bc92014-08-04 01:23:53 -04001245 hs.writeClientHash(hs.clientHello.marshal())
1246 hs.writeServerHash(hs.hello.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001247
David Benjaminabe94e32016-09-04 14:18:58 -04001248 if config.Bugs.SendSNIWarningAlert {
1249 c.SendAlert(alertLevelWarning, alertUnrecognizedName)
1250 }
1251
Adam Langley95c29f32014-06-20 12:00:00 -07001252 c.writeRecord(recordTypeHandshake, hs.hello.marshal())
1253
David Benjamin48cae082014-10-27 01:06:24 -04001254 if !isPSK {
1255 certMsg := new(certificateMsg)
David Benjamin8923c0b2015-06-07 11:42:34 -04001256 if !config.Bugs.EmptyCertificateList {
1257 certMsg.certificates = hs.cert.Certificate
1258 }
David Benjamin48cae082014-10-27 01:06:24 -04001259 if !config.Bugs.UnauthenticatedECDH {
David Benjaminbcb2d912015-02-24 23:45:43 -05001260 certMsgBytes := certMsg.marshal()
David Benjaminbcb2d912015-02-24 23:45:43 -05001261 hs.writeServerHash(certMsgBytes)
1262 c.writeRecord(recordTypeHandshake, certMsgBytes)
David Benjamin48cae082014-10-27 01:06:24 -04001263 }
David Benjamin1c375dd2014-07-12 00:48:23 -04001264 }
Adam Langley95c29f32014-06-20 12:00:00 -07001265
Nick Harperb3d51be2016-07-01 11:43:18 -04001266 if hs.hello.extensions.ocspStapling && !c.config.Bugs.SkipCertificateStatus {
Adam Langley95c29f32014-06-20 12:00:00 -07001267 certStatus := new(certificateStatusMsg)
1268 certStatus.statusType = statusTypeOCSP
1269 certStatus.response = hs.cert.OCSPStaple
David Benjamin83c0bc92014-08-04 01:23:53 -04001270 hs.writeServerHash(certStatus.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001271 c.writeRecord(recordTypeHandshake, certStatus.marshal())
1272 }
1273
1274 keyAgreement := hs.suite.ka(c.vers)
1275 skx, err := keyAgreement.generateServerKeyExchange(config, hs.cert, hs.clientHello, hs.hello)
1276 if err != nil {
1277 c.sendAlert(alertHandshakeFailure)
1278 return err
1279 }
Steven Valdez5440fe02016-07-18 12:40:30 -04001280 if ecdhe, ok := keyAgreement.(*ecdheKeyAgreement); ok {
1281 c.curveID = ecdhe.curveID
1282 }
David Benjamin9c651c92014-07-12 13:27:45 -04001283 if skx != nil && !config.Bugs.SkipServerKeyExchange {
David Benjamin83c0bc92014-08-04 01:23:53 -04001284 hs.writeServerHash(skx.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001285 c.writeRecord(recordTypeHandshake, skx.marshal())
1286 }
1287
1288 if config.ClientAuth >= RequestClientCert {
1289 // Request a client certificate
David Benjamin7b030512014-07-08 17:30:11 -04001290 certReq := &certificateRequestMsg{
1291 certificateTypes: config.ClientCertificateTypes,
1292 }
1293 if certReq.certificateTypes == nil {
1294 certReq.certificateTypes = []byte{
1295 byte(CertTypeRSASign),
1296 byte(CertTypeECDSASign),
1297 }
Adam Langley95c29f32014-06-20 12:00:00 -07001298 }
1299 if c.vers >= VersionTLS12 {
Nick Harper60edffd2016-06-21 15:19:24 -07001300 certReq.hasSignatureAlgorithm = true
1301 if !config.Bugs.NoSignatureAlgorithms {
David Benjamin7a41d372016-07-09 11:21:54 -07001302 certReq.signatureAlgorithms = config.verifySignatureAlgorithms()
David Benjamin000800a2014-11-14 01:43:59 -05001303 }
Adam Langley95c29f32014-06-20 12:00:00 -07001304 }
1305
1306 // An empty list of certificateAuthorities signals to
1307 // the client that it may send any certificate in response
1308 // to our request. When we know the CAs we trust, then
1309 // we can send them down, so that the client can choose
1310 // an appropriate certificate to give to us.
1311 if config.ClientCAs != nil {
1312 certReq.certificateAuthorities = config.ClientCAs.Subjects()
1313 }
David Benjamin83c0bc92014-08-04 01:23:53 -04001314 hs.writeServerHash(certReq.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001315 c.writeRecord(recordTypeHandshake, certReq.marshal())
1316 }
1317
1318 helloDone := new(serverHelloDoneMsg)
David Benjamin83c0bc92014-08-04 01:23:53 -04001319 hs.writeServerHash(helloDone.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001320 c.writeRecord(recordTypeHandshake, helloDone.marshal())
David Benjamin582ba042016-07-07 12:33:25 -07001321 c.flushHandshake()
Adam Langley95c29f32014-06-20 12:00:00 -07001322
1323 var pub crypto.PublicKey // public key for client auth, if any
1324
David Benjamin83f90402015-01-27 01:09:43 -05001325 if err := c.simulatePacketLoss(nil); err != nil {
1326 return err
1327 }
Adam Langley95c29f32014-06-20 12:00:00 -07001328 msg, err := c.readHandshake()
1329 if err != nil {
1330 return err
1331 }
1332
1333 var ok bool
1334 // If we requested a client certificate, then the client must send a
1335 // certificate message, even if it's empty.
1336 if config.ClientAuth >= RequestClientCert {
David Benjamin48cae082014-10-27 01:06:24 -04001337 var certMsg *certificateMsg
David Benjamin0b7ca7d2016-03-10 15:44:22 -05001338 var certificates [][]byte
1339 if certMsg, ok = msg.(*certificateMsg); ok {
1340 if c.vers == VersionSSL30 && len(certMsg.certificates) == 0 {
1341 return errors.New("tls: empty certificate message in SSL 3.0")
1342 }
1343
1344 hs.writeClientHash(certMsg.marshal())
1345 certificates = certMsg.certificates
1346 } else if c.vers != VersionSSL30 {
1347 // In TLS, the Certificate message is required. In SSL
1348 // 3.0, the peer skips it when sending no certificates.
Adam Langley95c29f32014-06-20 12:00:00 -07001349 c.sendAlert(alertUnexpectedMessage)
1350 return unexpectedMessageError(certMsg, msg)
1351 }
Adam Langley95c29f32014-06-20 12:00:00 -07001352
David Benjamin0b7ca7d2016-03-10 15:44:22 -05001353 if len(certificates) == 0 {
Adam Langley95c29f32014-06-20 12:00:00 -07001354 // The client didn't actually send a certificate
1355 switch config.ClientAuth {
1356 case RequireAnyClientCert, RequireAndVerifyClientCert:
1357 c.sendAlert(alertBadCertificate)
1358 return errors.New("tls: client didn't provide a certificate")
1359 }
1360 }
1361
David Benjamin0b7ca7d2016-03-10 15:44:22 -05001362 pub, err = hs.processCertsFromClient(certificates)
Adam Langley95c29f32014-06-20 12:00:00 -07001363 if err != nil {
1364 return err
1365 }
1366
David Benjamin0b7ca7d2016-03-10 15:44:22 -05001367 if ok {
1368 msg, err = c.readHandshake()
1369 if err != nil {
1370 return err
1371 }
Adam Langley95c29f32014-06-20 12:00:00 -07001372 }
1373 }
1374
1375 // Get client key exchange
1376 ckx, ok := msg.(*clientKeyExchangeMsg)
1377 if !ok {
1378 c.sendAlert(alertUnexpectedMessage)
1379 return unexpectedMessageError(ckx, msg)
1380 }
David Benjamin83c0bc92014-08-04 01:23:53 -04001381 hs.writeClientHash(ckx.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001382
David Benjamine098ec22014-08-27 23:13:20 -04001383 preMasterSecret, err := keyAgreement.processClientKeyExchange(config, hs.cert, ckx, c.vers)
1384 if err != nil {
1385 c.sendAlert(alertHandshakeFailure)
1386 return err
1387 }
Adam Langley75712922014-10-10 16:23:43 -07001388 if c.extendedMasterSecret {
1389 hs.masterSecret = extendedMasterFromPreMasterSecret(c.vers, hs.suite, preMasterSecret, hs.finishedHash)
1390 } else {
1391 if c.config.Bugs.RequireExtendedMasterSecret {
1392 return errors.New("tls: extended master secret required but not supported by peer")
1393 }
1394 hs.masterSecret = masterFromPreMasterSecret(c.vers, hs.suite, preMasterSecret, hs.clientHello.random, hs.hello.random)
1395 }
David Benjamine098ec22014-08-27 23:13:20 -04001396
Adam Langley95c29f32014-06-20 12:00:00 -07001397 // If we received a client cert in response to our certificate request message,
1398 // the client will send us a certificateVerifyMsg immediately after the
1399 // clientKeyExchangeMsg. This message is a digest of all preceding
1400 // handshake-layer messages that is signed using the private key corresponding
1401 // to the client's certificate. This allows us to verify that the client is in
1402 // possession of the private key of the certificate.
1403 if len(c.peerCertificates) > 0 {
1404 msg, err = c.readHandshake()
1405 if err != nil {
1406 return err
1407 }
1408 certVerify, ok := msg.(*certificateVerifyMsg)
1409 if !ok {
1410 c.sendAlert(alertUnexpectedMessage)
1411 return unexpectedMessageError(certVerify, msg)
1412 }
1413
David Benjaminde620d92014-07-18 15:03:41 -04001414 // Determine the signature type.
Nick Harper60edffd2016-06-21 15:19:24 -07001415 var sigAlg signatureAlgorithm
1416 if certVerify.hasSignatureAlgorithm {
1417 sigAlg = certVerify.signatureAlgorithm
Nick Harper60edffd2016-06-21 15:19:24 -07001418 c.peerSignatureAlgorithm = sigAlg
David Benjaminde620d92014-07-18 15:03:41 -04001419 }
1420
Nick Harper60edffd2016-06-21 15:19:24 -07001421 if c.vers > VersionSSL30 {
David Benjamin1fb125c2016-07-08 18:52:12 -07001422 err = verifyMessage(c.vers, pub, c.config, sigAlg, hs.finishedHash.buffer, certVerify.signature)
Nick Harper60edffd2016-06-21 15:19:24 -07001423 } else {
1424 // SSL 3.0's client certificate construction is
1425 // incompatible with signatureAlgorithm.
1426 rsaPub, ok := pub.(*rsa.PublicKey)
1427 if !ok {
1428 err = errors.New("unsupported key type for client certificate")
1429 } else {
1430 digest := hs.finishedHash.hashForClientCertificateSSL3(hs.masterSecret)
1431 err = rsa.VerifyPKCS1v15(rsaPub, crypto.MD5SHA1, digest, certVerify.signature)
David Benjaminde620d92014-07-18 15:03:41 -04001432 }
Adam Langley95c29f32014-06-20 12:00:00 -07001433 }
1434 if err != nil {
1435 c.sendAlert(alertBadCertificate)
1436 return errors.New("could not validate signature of connection nonces: " + err.Error())
1437 }
1438
David Benjamin83c0bc92014-08-04 01:23:53 -04001439 hs.writeClientHash(certVerify.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001440 }
1441
David Benjamine098ec22014-08-27 23:13:20 -04001442 hs.finishedHash.discardHandshakeBuffer()
Adam Langley95c29f32014-06-20 12:00:00 -07001443
1444 return nil
1445}
1446
1447func (hs *serverHandshakeState) establishKeys() error {
1448 c := hs.c
1449
1450 clientMAC, serverMAC, clientKey, serverKey, clientIV, serverIV :=
Nick Harper1fd39d82016-06-14 18:14:35 -07001451 keysFromMasterSecret(c.vers, hs.suite, hs.masterSecret, hs.clientHello.random, hs.hello.random, hs.suite.macLen, hs.suite.keyLen, hs.suite.ivLen(c.vers))
Adam Langley95c29f32014-06-20 12:00:00 -07001452
1453 var clientCipher, serverCipher interface{}
1454 var clientHash, serverHash macFunction
1455
1456 if hs.suite.aead == nil {
1457 clientCipher = hs.suite.cipher(clientKey, clientIV, true /* for reading */)
1458 clientHash = hs.suite.mac(c.vers, clientMAC)
1459 serverCipher = hs.suite.cipher(serverKey, serverIV, false /* not for reading */)
1460 serverHash = hs.suite.mac(c.vers, serverMAC)
1461 } else {
Nick Harper1fd39d82016-06-14 18:14:35 -07001462 clientCipher = hs.suite.aead(c.vers, clientKey, clientIV)
1463 serverCipher = hs.suite.aead(c.vers, serverKey, serverIV)
Adam Langley95c29f32014-06-20 12:00:00 -07001464 }
1465
1466 c.in.prepareCipherSpec(c.vers, clientCipher, clientHash)
1467 c.out.prepareCipherSpec(c.vers, serverCipher, serverHash)
1468
1469 return nil
1470}
1471
Adam Langleyaf0e32c2015-06-03 09:57:23 -07001472func (hs *serverHandshakeState) readFinished(out []byte, isResume bool) error {
Adam Langley95c29f32014-06-20 12:00:00 -07001473 c := hs.c
1474
1475 c.readRecord(recordTypeChangeCipherSpec)
1476 if err := c.in.error(); err != nil {
1477 return err
1478 }
1479
Nick Harperb3d51be2016-07-01 11:43:18 -04001480 if hs.hello.extensions.nextProtoNeg {
Adam Langley95c29f32014-06-20 12:00:00 -07001481 msg, err := c.readHandshake()
1482 if err != nil {
1483 return err
1484 }
1485 nextProto, ok := msg.(*nextProtoMsg)
1486 if !ok {
1487 c.sendAlert(alertUnexpectedMessage)
1488 return unexpectedMessageError(nextProto, msg)
1489 }
David Benjamin83c0bc92014-08-04 01:23:53 -04001490 hs.writeClientHash(nextProto.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001491 c.clientProtocol = nextProto.proto
1492 }
1493
Nick Harperb3d51be2016-07-01 11:43:18 -04001494 if hs.hello.extensions.channelIDRequested {
David Benjamind30a9902014-08-24 01:44:23 -04001495 msg, err := c.readHandshake()
1496 if err != nil {
1497 return err
1498 }
David Benjamin24599a82016-06-30 18:56:53 -04001499 channelIDMsg, ok := msg.(*channelIDMsg)
David Benjamind30a9902014-08-24 01:44:23 -04001500 if !ok {
1501 c.sendAlert(alertUnexpectedMessage)
David Benjamin24599a82016-06-30 18:56:53 -04001502 return unexpectedMessageError(channelIDMsg, msg)
David Benjamind30a9902014-08-24 01:44:23 -04001503 }
David Benjamin24599a82016-06-30 18:56:53 -04001504 x := new(big.Int).SetBytes(channelIDMsg.channelID[0:32])
1505 y := new(big.Int).SetBytes(channelIDMsg.channelID[32:64])
1506 r := new(big.Int).SetBytes(channelIDMsg.channelID[64:96])
1507 s := new(big.Int).SetBytes(channelIDMsg.channelID[96:128])
David Benjamind30a9902014-08-24 01:44:23 -04001508 if !elliptic.P256().IsOnCurve(x, y) {
1509 return errors.New("tls: invalid channel ID public key")
1510 }
1511 channelID := &ecdsa.PublicKey{elliptic.P256(), x, y}
1512 var resumeHash []byte
1513 if isResume {
1514 resumeHash = hs.sessionState.handshakeHash
1515 }
1516 if !ecdsa.Verify(channelID, hs.finishedHash.hashForChannelID(resumeHash), r, s) {
1517 return errors.New("tls: invalid channel ID signature")
1518 }
1519 c.channelID = channelID
1520
David Benjamin24599a82016-06-30 18:56:53 -04001521 hs.writeClientHash(channelIDMsg.marshal())
David Benjamind30a9902014-08-24 01:44:23 -04001522 }
1523
Adam Langley95c29f32014-06-20 12:00:00 -07001524 msg, err := c.readHandshake()
1525 if err != nil {
1526 return err
1527 }
1528 clientFinished, ok := msg.(*finishedMsg)
1529 if !ok {
1530 c.sendAlert(alertUnexpectedMessage)
1531 return unexpectedMessageError(clientFinished, msg)
1532 }
1533
1534 verify := hs.finishedHash.clientSum(hs.masterSecret)
1535 if len(verify) != len(clientFinished.verifyData) ||
1536 subtle.ConstantTimeCompare(verify, clientFinished.verifyData) != 1 {
1537 c.sendAlert(alertHandshakeFailure)
1538 return errors.New("tls: client's Finished message is incorrect")
1539 }
Adam Langley2ae77d22014-10-28 17:29:33 -07001540 c.clientVerify = append(c.clientVerify[:0], clientFinished.verifyData...)
Adam Langleyaf0e32c2015-06-03 09:57:23 -07001541 copy(out, clientFinished.verifyData)
Adam Langley95c29f32014-06-20 12:00:00 -07001542
David Benjamin83c0bc92014-08-04 01:23:53 -04001543 hs.writeClientHash(clientFinished.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001544 return nil
1545}
1546
1547func (hs *serverHandshakeState) sendSessionTicket() error {
Adam Langley95c29f32014-06-20 12:00:00 -07001548 c := hs.c
Adam Langley95c29f32014-06-20 12:00:00 -07001549 state := sessionState{
David Benjamind30a9902014-08-24 01:44:23 -04001550 vers: c.vers,
1551 cipherSuite: hs.suite.id,
1552 masterSecret: hs.masterSecret,
1553 certificates: hs.certsFromClient,
1554 handshakeHash: hs.finishedHash.server.Sum(nil),
Adam Langley95c29f32014-06-20 12:00:00 -07001555 }
David Benjaminfe8eb9a2014-11-17 03:19:02 -05001556
Nick Harperb3d51be2016-07-01 11:43:18 -04001557 if !hs.hello.extensions.ticketSupported || hs.c.config.Bugs.SkipNewSessionTicket {
David Benjaminfe8eb9a2014-11-17 03:19:02 -05001558 if c.config.ServerSessionCache != nil && len(hs.hello.sessionId) != 0 {
1559 c.config.ServerSessionCache.Put(string(hs.hello.sessionId), &state)
1560 }
1561 return nil
1562 }
1563
1564 m := new(newSessionTicketMsg)
1565
David Benjamindd6fed92015-10-23 17:41:12 -04001566 if !c.config.Bugs.SendEmptySessionTicket {
1567 var err error
1568 m.ticket, err = c.encryptTicket(&state)
1569 if err != nil {
1570 return err
1571 }
Adam Langley95c29f32014-06-20 12:00:00 -07001572 }
Adam Langley95c29f32014-06-20 12:00:00 -07001573
David Benjamin83c0bc92014-08-04 01:23:53 -04001574 hs.writeServerHash(m.marshal())
Adam Langley95c29f32014-06-20 12:00:00 -07001575 c.writeRecord(recordTypeHandshake, m.marshal())
1576
1577 return nil
1578}
1579
Adam Langleyaf0e32c2015-06-03 09:57:23 -07001580func (hs *serverHandshakeState) sendFinished(out []byte) error {
Adam Langley95c29f32014-06-20 12:00:00 -07001581 c := hs.c
1582
David Benjamin86271ee2014-07-21 16:14:03 -04001583 finished := new(finishedMsg)
1584 finished.verifyData = hs.finishedHash.serverSum(hs.masterSecret)
Adam Langleyaf0e32c2015-06-03 09:57:23 -07001585 copy(out, finished.verifyData)
David Benjamin513f0ea2015-04-02 19:33:31 -04001586 if c.config.Bugs.BadFinished {
1587 finished.verifyData[0]++
1588 }
Adam Langley2ae77d22014-10-28 17:29:33 -07001589 c.serverVerify = append(c.serverVerify[:0], finished.verifyData...)
David Benjamin83f90402015-01-27 01:09:43 -05001590 hs.finishedBytes = finished.marshal()
1591 hs.writeServerHash(hs.finishedBytes)
1592 postCCSBytes := hs.finishedBytes
David Benjamin86271ee2014-07-21 16:14:03 -04001593
1594 if c.config.Bugs.FragmentAcrossChangeCipherSpec {
1595 c.writeRecord(recordTypeHandshake, postCCSBytes[:5])
1596 postCCSBytes = postCCSBytes[5:]
David Benjamin61672812016-07-14 23:10:43 -04001597 } else if c.config.Bugs.SendUnencryptedFinished {
1598 c.writeRecord(recordTypeHandshake, postCCSBytes)
1599 postCCSBytes = nil
David Benjamin86271ee2014-07-21 16:14:03 -04001600 }
David Benjamin582ba042016-07-07 12:33:25 -07001601 c.flushHandshake()
David Benjamin86271ee2014-07-21 16:14:03 -04001602
David Benjamina0e52232014-07-19 17:39:58 -04001603 if !c.config.Bugs.SkipChangeCipherSpec {
David Benjamin8411b242015-11-26 12:07:28 -05001604 ccs := []byte{1}
1605 if c.config.Bugs.BadChangeCipherSpec != nil {
1606 ccs = c.config.Bugs.BadChangeCipherSpec
1607 }
1608 c.writeRecord(recordTypeChangeCipherSpec, ccs)
David Benjamina0e52232014-07-19 17:39:58 -04001609 }
Adam Langley95c29f32014-06-20 12:00:00 -07001610
David Benjamin4189bd92015-01-25 23:52:39 -05001611 if c.config.Bugs.AppDataAfterChangeCipherSpec != nil {
1612 c.writeRecord(recordTypeApplicationData, c.config.Bugs.AppDataAfterChangeCipherSpec)
1613 }
David Benjamindc3da932015-03-12 15:09:02 -04001614 if c.config.Bugs.AlertAfterChangeCipherSpec != 0 {
1615 c.sendAlert(c.config.Bugs.AlertAfterChangeCipherSpec)
1616 return errors.New("tls: simulating post-CCS alert")
1617 }
David Benjamin4189bd92015-01-25 23:52:39 -05001618
David Benjamin61672812016-07-14 23:10:43 -04001619 if !c.config.Bugs.SkipFinished && len(postCCSBytes) > 0 {
David Benjaminb80168e2015-02-08 18:30:14 -05001620 c.writeRecord(recordTypeHandshake, postCCSBytes)
David Benjamin02edcd02016-07-27 17:40:37 -04001621 if c.config.Bugs.SendExtraFinished {
1622 c.writeRecord(recordTypeHandshake, finished.marshal())
1623 }
1624
David Benjamin12d2c482016-07-24 10:56:51 -04001625 if !c.config.Bugs.PackHelloRequestWithFinished {
1626 // Defer flushing until renegotiation.
1627 c.flushHandshake()
1628 }
David Benjaminb3774b92015-01-31 17:16:01 -05001629 }
Adam Langley95c29f32014-06-20 12:00:00 -07001630
David Benjaminc565ebb2015-04-03 04:06:36 -04001631 c.cipherSuite = hs.suite
Adam Langley95c29f32014-06-20 12:00:00 -07001632
1633 return nil
1634}
1635
1636// processCertsFromClient takes a chain of client certificates either from a
1637// Certificates message or from a sessionState and verifies them. It returns
1638// the public key of the leaf certificate.
1639func (hs *serverHandshakeState) processCertsFromClient(certificates [][]byte) (crypto.PublicKey, error) {
1640 c := hs.c
1641
1642 hs.certsFromClient = certificates
1643 certs := make([]*x509.Certificate, len(certificates))
1644 var err error
1645 for i, asn1Data := range certificates {
1646 if certs[i], err = x509.ParseCertificate(asn1Data); err != nil {
1647 c.sendAlert(alertBadCertificate)
1648 return nil, errors.New("tls: failed to parse client certificate: " + err.Error())
1649 }
1650 }
1651
1652 if c.config.ClientAuth >= VerifyClientCertIfGiven && len(certs) > 0 {
1653 opts := x509.VerifyOptions{
1654 Roots: c.config.ClientCAs,
1655 CurrentTime: c.config.time(),
1656 Intermediates: x509.NewCertPool(),
1657 KeyUsages: []x509.ExtKeyUsage{x509.ExtKeyUsageClientAuth},
1658 }
1659
1660 for _, cert := range certs[1:] {
1661 opts.Intermediates.AddCert(cert)
1662 }
1663
1664 chains, err := certs[0].Verify(opts)
1665 if err != nil {
1666 c.sendAlert(alertBadCertificate)
1667 return nil, errors.New("tls: failed to verify client's certificate: " + err.Error())
1668 }
1669
1670 ok := false
1671 for _, ku := range certs[0].ExtKeyUsage {
1672 if ku == x509.ExtKeyUsageClientAuth {
1673 ok = true
1674 break
1675 }
1676 }
1677 if !ok {
1678 c.sendAlert(alertHandshakeFailure)
1679 return nil, errors.New("tls: client's certificate's extended key usage doesn't permit it to be used for client authentication")
1680 }
1681
1682 c.verifiedChains = chains
1683 }
1684
1685 if len(certs) > 0 {
1686 var pub crypto.PublicKey
1687 switch key := certs[0].PublicKey.(type) {
1688 case *ecdsa.PublicKey, *rsa.PublicKey:
1689 pub = key
1690 default:
1691 c.sendAlert(alertUnsupportedCertificate)
1692 return nil, fmt.Errorf("tls: client's certificate contains an unsupported public key of type %T", certs[0].PublicKey)
1693 }
1694 c.peerCertificates = certs
1695 return pub, nil
1696 }
1697
1698 return nil, nil
1699}
1700
David Benjamin83c0bc92014-08-04 01:23:53 -04001701func (hs *serverHandshakeState) writeServerHash(msg []byte) {
1702 // writeServerHash is called before writeRecord.
1703 hs.writeHash(msg, hs.c.sendHandshakeSeq)
1704}
1705
1706func (hs *serverHandshakeState) writeClientHash(msg []byte) {
1707 // writeClientHash is called after readHandshake.
1708 hs.writeHash(msg, hs.c.recvHandshakeSeq-1)
1709}
1710
1711func (hs *serverHandshakeState) writeHash(msg []byte, seqno uint16) {
1712 if hs.c.isDTLS {
1713 // This is somewhat hacky. DTLS hashes a slightly different format.
1714 // First, the TLS header.
1715 hs.finishedHash.Write(msg[:4])
1716 // Then the sequence number and reassembled fragment offset (always 0).
1717 hs.finishedHash.Write([]byte{byte(seqno >> 8), byte(seqno), 0, 0, 0})
1718 // Then the reassembled fragment (always equal to the message length).
1719 hs.finishedHash.Write(msg[1:4])
1720 // And then the message body.
1721 hs.finishedHash.Write(msg[4:])
1722 } else {
1723 hs.finishedHash.Write(msg)
1724 }
1725}
1726
Adam Langley95c29f32014-06-20 12:00:00 -07001727// tryCipherSuite returns a cipherSuite with the given id if that cipher suite
1728// is acceptable to use.
Nick Harper728eed82016-07-07 17:36:52 -07001729func (c *Conn) tryCipherSuite(id uint16, supportedCipherSuites []uint16, version uint16, ellipticOk, ecdsaOk, pskOk bool) *cipherSuite {
Adam Langley95c29f32014-06-20 12:00:00 -07001730 for _, supported := range supportedCipherSuites {
1731 if id == supported {
1732 var candidate *cipherSuite
1733
1734 for _, s := range cipherSuites {
1735 if s.id == id {
1736 candidate = s
1737 break
1738 }
1739 }
1740 if candidate == nil {
1741 continue
1742 }
1743 // Don't select a ciphersuite which we can't
1744 // support for this client.
David Benjamin5ecb88b2016-10-04 17:51:35 -04001745 if (candidate.flags&suitePSK != 0) && !pskOk {
1746 continue
1747 }
1748 if (candidate.flags&suiteECDHE != 0) && !ellipticOk {
1749 continue
1750 }
1751 if (candidate.flags&suiteECDSA != 0) != ecdsaOk {
1752 continue
1753 }
1754 if version < VersionTLS12 && candidate.flags&suiteTLS12 != 0 {
1755 continue
1756 }
1757 if version >= VersionTLS13 && candidate.flags&suiteTLS13 == 0 {
1758 continue
1759 }
1760 if c.isDTLS && candidate.flags&suiteNoDTLS != 0 {
1761 continue
David Benjamin83c0bc92014-08-04 01:23:53 -04001762 }
Adam Langley95c29f32014-06-20 12:00:00 -07001763 return candidate
1764 }
1765 }
1766
1767 return nil
1768}
David Benjaminf93995b2015-11-05 18:23:20 -05001769
1770func isTLS12Cipher(id uint16) bool {
1771 for _, cipher := range cipherSuites {
1772 if cipher.id != id {
1773 continue
1774 }
1775 return cipher.flags&suiteTLS12 != 0
1776 }
1777 // Unknown cipher.
1778 return false
1779}
David Benjamin65ac9972016-09-02 21:35:25 -04001780
1781func isGREASEValue(val uint16) bool {
David Benjamin3c6a1ea2016-09-26 18:30:05 -04001782 return val&0x0f0f == 0x0a0a && val&0xff == val>>8
David Benjamin65ac9972016-09-02 21:35:25 -04001783}