handshake_server.go 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878
  1. // 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. package qtls
  5. import (
  6. "crypto"
  7. "crypto/ecdsa"
  8. "crypto/ed25519"
  9. "crypto/rsa"
  10. "crypto/subtle"
  11. "crypto/x509"
  12. "errors"
  13. "fmt"
  14. "hash"
  15. "io"
  16. "sync/atomic"
  17. "time"
  18. )
  19. // serverHandshakeState contains details of a server handshake in progress.
  20. // It's discarded once the handshake has completed.
  21. type serverHandshakeState struct {
  22. c *Conn
  23. clientHello *clientHelloMsg
  24. hello *serverHelloMsg
  25. suite *cipherSuite
  26. ecdheOk bool
  27. ecSignOk bool
  28. rsaDecryptOk bool
  29. rsaSignOk bool
  30. sessionState *sessionState
  31. finishedHash finishedHash
  32. masterSecret []byte
  33. cert *Certificate
  34. }
  35. // serverHandshake performs a TLS handshake as a server.
  36. func (c *Conn) serverHandshake() error {
  37. c.setAlternativeRecordLayer()
  38. clientHello, err := c.readClientHello()
  39. if err != nil {
  40. return err
  41. }
  42. if c.vers == VersionTLS13 {
  43. hs := serverHandshakeStateTLS13{
  44. c: c,
  45. clientHello: clientHello,
  46. }
  47. return hs.handshake()
  48. } else if c.extraConfig.usesAlternativeRecordLayer() {
  49. // This should already have been caught by the check that the ClientHello doesn't
  50. // offer any (supported) versions older than TLS 1.3.
  51. // Check again to make sure we can't be tricked into using an older version.
  52. c.sendAlert(alertProtocolVersion)
  53. return errors.New("tls: negotiated TLS < 1.3 when using QUIC")
  54. }
  55. hs := serverHandshakeState{
  56. c: c,
  57. clientHello: clientHello,
  58. }
  59. return hs.handshake()
  60. }
  61. func (hs *serverHandshakeState) handshake() error {
  62. c := hs.c
  63. if err := hs.processClientHello(); err != nil {
  64. return err
  65. }
  66. // For an overview of TLS handshaking, see RFC 5246, Section 7.3.
  67. c.buffering = true
  68. if hs.checkForResumption() {
  69. // The client has included a session ticket and so we do an abbreviated handshake.
  70. c.didResume = true
  71. if err := hs.doResumeHandshake(); err != nil {
  72. return err
  73. }
  74. if err := hs.establishKeys(); err != nil {
  75. return err
  76. }
  77. if err := hs.sendSessionTicket(); err != nil {
  78. return err
  79. }
  80. if err := hs.sendFinished(c.serverFinished[:]); err != nil {
  81. return err
  82. }
  83. if _, err := c.flush(); err != nil {
  84. return err
  85. }
  86. c.clientFinishedIsFirst = false
  87. if err := hs.readFinished(nil); err != nil {
  88. return err
  89. }
  90. } else {
  91. // The client didn't include a session ticket, or it wasn't
  92. // valid so we do a full handshake.
  93. if err := hs.pickCipherSuite(); err != nil {
  94. return err
  95. }
  96. if err := hs.doFullHandshake(); err != nil {
  97. return err
  98. }
  99. if err := hs.establishKeys(); err != nil {
  100. return err
  101. }
  102. if err := hs.readFinished(c.clientFinished[:]); err != nil {
  103. return err
  104. }
  105. c.clientFinishedIsFirst = true
  106. c.buffering = true
  107. if err := hs.sendSessionTicket(); err != nil {
  108. return err
  109. }
  110. if err := hs.sendFinished(nil); err != nil {
  111. return err
  112. }
  113. if _, err := c.flush(); err != nil {
  114. return err
  115. }
  116. }
  117. c.ekm = ekmFromMasterSecret(c.vers, hs.suite, hs.masterSecret, hs.clientHello.random, hs.hello.random)
  118. atomic.StoreUint32(&c.handshakeStatus, 1)
  119. return nil
  120. }
  121. // readClientHello reads a ClientHello message and selects the protocol version.
  122. func (c *Conn) readClientHello() (*clientHelloMsg, error) {
  123. msg, err := c.readHandshake()
  124. if err != nil {
  125. return nil, err
  126. }
  127. clientHello, ok := msg.(*clientHelloMsg)
  128. if !ok {
  129. c.sendAlert(alertUnexpectedMessage)
  130. return nil, unexpectedMessageError(clientHello, msg)
  131. }
  132. var configForClient *config
  133. originalConfig := c.config
  134. if c.config.GetConfigForClient != nil {
  135. chi := newClientHelloInfo(c, clientHello)
  136. if cfc, err := c.config.GetConfigForClient(chi); err != nil {
  137. c.sendAlert(alertInternalError)
  138. return nil, err
  139. } else if cfc != nil {
  140. configForClient = fromConfig(cfc)
  141. c.config = configForClient
  142. }
  143. }
  144. c.ticketKeys = originalConfig.ticketKeys(configForClient)
  145. clientVersions := clientHello.supportedVersions
  146. if len(clientHello.supportedVersions) == 0 {
  147. clientVersions = supportedVersionsFromMax(clientHello.vers)
  148. }
  149. if c.extraConfig.usesAlternativeRecordLayer() {
  150. // In QUIC, the client MUST NOT offer any old TLS versions.
  151. // Here, we can only check that none of the other supported versions of this library
  152. // (TLS 1.0 - TLS 1.2) is offered. We don't check for any SSL versions here.
  153. for _, ver := range clientVersions {
  154. if ver == VersionTLS13 {
  155. continue
  156. }
  157. for _, v := range supportedVersions {
  158. if ver == v {
  159. c.sendAlert(alertProtocolVersion)
  160. return nil, fmt.Errorf("tls: client offered old TLS version %#x", ver)
  161. }
  162. }
  163. }
  164. // Make the config we're using allows us to use TLS 1.3.
  165. if c.config.maxSupportedVersion() < VersionTLS13 {
  166. c.sendAlert(alertInternalError)
  167. return nil, errors.New("tls: MaxVersion prevents QUIC from using TLS 1.3")
  168. }
  169. }
  170. c.vers, ok = c.config.mutualVersion(clientVersions)
  171. if !ok {
  172. c.sendAlert(alertProtocolVersion)
  173. return nil, fmt.Errorf("tls: client offered only unsupported versions: %x", clientVersions)
  174. }
  175. c.haveVers = true
  176. c.in.version = c.vers
  177. c.out.version = c.vers
  178. return clientHello, nil
  179. }
  180. func (hs *serverHandshakeState) processClientHello() error {
  181. c := hs.c
  182. hs.hello = new(serverHelloMsg)
  183. hs.hello.vers = c.vers
  184. foundCompression := false
  185. // We only support null compression, so check that the client offered it.
  186. for _, compression := range hs.clientHello.compressionMethods {
  187. if compression == compressionNone {
  188. foundCompression = true
  189. break
  190. }
  191. }
  192. if !foundCompression {
  193. c.sendAlert(alertHandshakeFailure)
  194. return errors.New("tls: client does not support uncompressed connections")
  195. }
  196. hs.hello.random = make([]byte, 32)
  197. serverRandom := hs.hello.random
  198. // Downgrade protection canaries. See RFC 8446, Section 4.1.3.
  199. maxVers := c.config.maxSupportedVersion()
  200. if maxVers >= VersionTLS12 && c.vers < maxVers || testingOnlyForceDowngradeCanary {
  201. if c.vers == VersionTLS12 {
  202. copy(serverRandom[24:], downgradeCanaryTLS12)
  203. } else {
  204. copy(serverRandom[24:], downgradeCanaryTLS11)
  205. }
  206. serverRandom = serverRandom[:24]
  207. }
  208. _, err := io.ReadFull(c.config.rand(), serverRandom)
  209. if err != nil {
  210. c.sendAlert(alertInternalError)
  211. return err
  212. }
  213. if len(hs.clientHello.secureRenegotiation) != 0 {
  214. c.sendAlert(alertHandshakeFailure)
  215. return errors.New("tls: initial handshake had non-empty renegotiation extension")
  216. }
  217. hs.hello.secureRenegotiationSupported = hs.clientHello.secureRenegotiationSupported
  218. hs.hello.compressionMethod = compressionNone
  219. if len(hs.clientHello.serverName) > 0 {
  220. c.serverName = hs.clientHello.serverName
  221. }
  222. if len(hs.clientHello.alpnProtocols) > 0 {
  223. if selectedProto := mutualProtocol(hs.clientHello.alpnProtocols, c.config.NextProtos); selectedProto != "" {
  224. hs.hello.alpnProtocol = selectedProto
  225. c.clientProtocol = selectedProto
  226. }
  227. }
  228. hs.cert, err = c.config.getCertificate(newClientHelloInfo(c, hs.clientHello))
  229. if err != nil {
  230. if err == errNoCertificates {
  231. c.sendAlert(alertUnrecognizedName)
  232. } else {
  233. c.sendAlert(alertInternalError)
  234. }
  235. return err
  236. }
  237. if hs.clientHello.scts {
  238. hs.hello.scts = hs.cert.SignedCertificateTimestamps
  239. }
  240. hs.ecdheOk = supportsECDHE(c.config, hs.clientHello.supportedCurves, hs.clientHello.supportedPoints)
  241. if hs.ecdheOk {
  242. // Although omitting the ec_point_formats extension is permitted, some
  243. // old OpenSSL version will refuse to handshake if not present.
  244. //
  245. // Per RFC 4492, section 5.1.2, implementations MUST support the
  246. // uncompressed point format. See golang.org/issue/31943.
  247. hs.hello.supportedPoints = []uint8{pointFormatUncompressed}
  248. }
  249. if priv, ok := hs.cert.PrivateKey.(crypto.Signer); ok {
  250. switch priv.Public().(type) {
  251. case *ecdsa.PublicKey:
  252. hs.ecSignOk = true
  253. case ed25519.PublicKey:
  254. hs.ecSignOk = true
  255. case *rsa.PublicKey:
  256. hs.rsaSignOk = true
  257. default:
  258. c.sendAlert(alertInternalError)
  259. return fmt.Errorf("tls: unsupported signing key type (%T)", priv.Public())
  260. }
  261. }
  262. if priv, ok := hs.cert.PrivateKey.(crypto.Decrypter); ok {
  263. switch priv.Public().(type) {
  264. case *rsa.PublicKey:
  265. hs.rsaDecryptOk = true
  266. default:
  267. c.sendAlert(alertInternalError)
  268. return fmt.Errorf("tls: unsupported decryption key type (%T)", priv.Public())
  269. }
  270. }
  271. return nil
  272. }
  273. // supportsECDHE returns whether ECDHE key exchanges can be used with this
  274. // pre-TLS 1.3 client.
  275. func supportsECDHE(c *config, supportedCurves []CurveID, supportedPoints []uint8) bool {
  276. supportsCurve := false
  277. for _, curve := range supportedCurves {
  278. if c.supportsCurve(curve) {
  279. supportsCurve = true
  280. break
  281. }
  282. }
  283. supportsPointFormat := false
  284. for _, pointFormat := range supportedPoints {
  285. if pointFormat == pointFormatUncompressed {
  286. supportsPointFormat = true
  287. break
  288. }
  289. }
  290. return supportsCurve && supportsPointFormat
  291. }
  292. func (hs *serverHandshakeState) pickCipherSuite() error {
  293. c := hs.c
  294. var preferenceList, supportedList []uint16
  295. if c.config.PreferServerCipherSuites {
  296. preferenceList = c.config.cipherSuites()
  297. supportedList = hs.clientHello.cipherSuites
  298. // If the client does not seem to have hardware support for AES-GCM,
  299. // and the application did not specify a cipher suite preference order,
  300. // prefer other AEAD ciphers even if we prioritized AES-GCM ciphers
  301. // by default.
  302. if c.config.CipherSuites == nil && !aesgcmPreferred(hs.clientHello.cipherSuites) {
  303. preferenceList = deprioritizeAES(preferenceList)
  304. }
  305. } else {
  306. preferenceList = hs.clientHello.cipherSuites
  307. supportedList = c.config.cipherSuites()
  308. // If we don't have hardware support for AES-GCM, prefer other AEAD
  309. // ciphers even if the client prioritized AES-GCM.
  310. if !hasAESGCMHardwareSupport {
  311. preferenceList = deprioritizeAES(preferenceList)
  312. }
  313. }
  314. hs.suite = selectCipherSuite(preferenceList, supportedList, hs.cipherSuiteOk)
  315. if hs.suite == nil {
  316. c.sendAlert(alertHandshakeFailure)
  317. return errors.New("tls: no cipher suite supported by both client and server")
  318. }
  319. c.cipherSuite = hs.suite.id
  320. for _, id := range hs.clientHello.cipherSuites {
  321. if id == TLS_FALLBACK_SCSV {
  322. // The client is doing a fallback connection. See RFC 7507.
  323. if hs.clientHello.vers < c.config.maxSupportedVersion() {
  324. c.sendAlert(alertInappropriateFallback)
  325. return errors.New("tls: client using inappropriate protocol fallback")
  326. }
  327. break
  328. }
  329. }
  330. return nil
  331. }
  332. func (hs *serverHandshakeState) cipherSuiteOk(c *cipherSuite) bool {
  333. if c.flags&suiteECDHE != 0 {
  334. if !hs.ecdheOk {
  335. return false
  336. }
  337. if c.flags&suiteECSign != 0 {
  338. if !hs.ecSignOk {
  339. return false
  340. }
  341. } else if !hs.rsaSignOk {
  342. return false
  343. }
  344. } else if !hs.rsaDecryptOk {
  345. return false
  346. }
  347. if hs.c.vers < VersionTLS12 && c.flags&suiteTLS12 != 0 {
  348. return false
  349. }
  350. return true
  351. }
  352. // checkForResumption reports whether we should perform resumption on this connection.
  353. func (hs *serverHandshakeState) checkForResumption() bool {
  354. c := hs.c
  355. if c.config.SessionTicketsDisabled {
  356. return false
  357. }
  358. plaintext, usedOldKey := c.decryptTicket(hs.clientHello.sessionTicket)
  359. if plaintext == nil {
  360. return false
  361. }
  362. hs.sessionState = &sessionState{usedOldKey: usedOldKey}
  363. ok := hs.sessionState.unmarshal(plaintext)
  364. if !ok {
  365. return false
  366. }
  367. createdAt := time.Unix(int64(hs.sessionState.createdAt), 0)
  368. if c.config.time().Sub(createdAt) > maxSessionTicketLifetime {
  369. return false
  370. }
  371. // Never resume a session for a different TLS version.
  372. if c.vers != hs.sessionState.vers {
  373. return false
  374. }
  375. cipherSuiteOk := false
  376. // Check that the client is still offering the ciphersuite in the session.
  377. for _, id := range hs.clientHello.cipherSuites {
  378. if id == hs.sessionState.cipherSuite {
  379. cipherSuiteOk = true
  380. break
  381. }
  382. }
  383. if !cipherSuiteOk {
  384. return false
  385. }
  386. // Check that we also support the ciphersuite from the session.
  387. hs.suite = selectCipherSuite([]uint16{hs.sessionState.cipherSuite},
  388. c.config.cipherSuites(), hs.cipherSuiteOk)
  389. if hs.suite == nil {
  390. return false
  391. }
  392. sessionHasClientCerts := len(hs.sessionState.certificates) != 0
  393. needClientCerts := requiresClientCert(c.config.ClientAuth)
  394. if needClientCerts && !sessionHasClientCerts {
  395. return false
  396. }
  397. if sessionHasClientCerts && c.config.ClientAuth == NoClientCert {
  398. return false
  399. }
  400. return true
  401. }
  402. func (hs *serverHandshakeState) doResumeHandshake() error {
  403. c := hs.c
  404. hs.hello.cipherSuite = hs.suite.id
  405. c.cipherSuite = hs.suite.id
  406. // We echo the client's session ID in the ServerHello to let it know
  407. // that we're doing a resumption.
  408. hs.hello.sessionId = hs.clientHello.sessionId
  409. hs.hello.ticketSupported = hs.sessionState.usedOldKey
  410. hs.finishedHash = newFinishedHash(c.vers, hs.suite)
  411. hs.finishedHash.discardHandshakeBuffer()
  412. hs.finishedHash.Write(hs.clientHello.marshal())
  413. hs.finishedHash.Write(hs.hello.marshal())
  414. if _, err := c.writeRecord(recordTypeHandshake, hs.hello.marshal()); err != nil {
  415. return err
  416. }
  417. if err := c.processCertsFromClient(Certificate{
  418. Certificate: hs.sessionState.certificates,
  419. }); err != nil {
  420. return err
  421. }
  422. if c.config.VerifyConnection != nil {
  423. if err := c.config.VerifyConnection(c.connectionStateLocked()); err != nil {
  424. c.sendAlert(alertBadCertificate)
  425. return err
  426. }
  427. }
  428. hs.masterSecret = hs.sessionState.masterSecret
  429. return nil
  430. }
  431. func (hs *serverHandshakeState) doFullHandshake() error {
  432. c := hs.c
  433. if hs.clientHello.ocspStapling && len(hs.cert.OCSPStaple) > 0 {
  434. hs.hello.ocspStapling = true
  435. }
  436. hs.hello.ticketSupported = hs.clientHello.ticketSupported && !c.config.SessionTicketsDisabled
  437. hs.hello.cipherSuite = hs.suite.id
  438. hs.finishedHash = newFinishedHash(hs.c.vers, hs.suite)
  439. if c.config.ClientAuth == NoClientCert {
  440. // No need to keep a full record of the handshake if client
  441. // certificates won't be used.
  442. hs.finishedHash.discardHandshakeBuffer()
  443. }
  444. hs.finishedHash.Write(hs.clientHello.marshal())
  445. hs.finishedHash.Write(hs.hello.marshal())
  446. if _, err := c.writeRecord(recordTypeHandshake, hs.hello.marshal()); err != nil {
  447. return err
  448. }
  449. certMsg := new(certificateMsg)
  450. certMsg.certificates = hs.cert.Certificate
  451. hs.finishedHash.Write(certMsg.marshal())
  452. if _, err := c.writeRecord(recordTypeHandshake, certMsg.marshal()); err != nil {
  453. return err
  454. }
  455. if hs.hello.ocspStapling {
  456. certStatus := new(certificateStatusMsg)
  457. certStatus.response = hs.cert.OCSPStaple
  458. hs.finishedHash.Write(certStatus.marshal())
  459. if _, err := c.writeRecord(recordTypeHandshake, certStatus.marshal()); err != nil {
  460. return err
  461. }
  462. }
  463. keyAgreement := hs.suite.ka(c.vers)
  464. skx, err := keyAgreement.generateServerKeyExchange(c.config, hs.cert, hs.clientHello, hs.hello)
  465. if err != nil {
  466. c.sendAlert(alertHandshakeFailure)
  467. return err
  468. }
  469. if skx != nil {
  470. hs.finishedHash.Write(skx.marshal())
  471. if _, err := c.writeRecord(recordTypeHandshake, skx.marshal()); err != nil {
  472. return err
  473. }
  474. }
  475. var certReq *certificateRequestMsg
  476. if c.config.ClientAuth >= RequestClientCert {
  477. // Request a client certificate
  478. certReq = new(certificateRequestMsg)
  479. certReq.certificateTypes = []byte{
  480. byte(certTypeRSASign),
  481. byte(certTypeECDSASign),
  482. }
  483. if c.vers >= VersionTLS12 {
  484. certReq.hasSignatureAlgorithm = true
  485. certReq.supportedSignatureAlgorithms = supportedSignatureAlgorithms
  486. }
  487. // An empty list of certificateAuthorities signals to
  488. // the client that it may send any certificate in response
  489. // to our request. When we know the CAs we trust, then
  490. // we can send them down, so that the client can choose
  491. // an appropriate certificate to give to us.
  492. if c.config.ClientCAs != nil {
  493. certReq.certificateAuthorities = c.config.ClientCAs.Subjects()
  494. }
  495. hs.finishedHash.Write(certReq.marshal())
  496. if _, err := c.writeRecord(recordTypeHandshake, certReq.marshal()); err != nil {
  497. return err
  498. }
  499. }
  500. helloDone := new(serverHelloDoneMsg)
  501. hs.finishedHash.Write(helloDone.marshal())
  502. if _, err := c.writeRecord(recordTypeHandshake, helloDone.marshal()); err != nil {
  503. return err
  504. }
  505. if _, err := c.flush(); err != nil {
  506. return err
  507. }
  508. var pub crypto.PublicKey // public key for client auth, if any
  509. msg, err := c.readHandshake()
  510. if err != nil {
  511. return err
  512. }
  513. // If we requested a client certificate, then the client must send a
  514. // certificate message, even if it's empty.
  515. if c.config.ClientAuth >= RequestClientCert {
  516. certMsg, ok := msg.(*certificateMsg)
  517. if !ok {
  518. c.sendAlert(alertUnexpectedMessage)
  519. return unexpectedMessageError(certMsg, msg)
  520. }
  521. hs.finishedHash.Write(certMsg.marshal())
  522. if err := c.processCertsFromClient(Certificate{
  523. Certificate: certMsg.certificates,
  524. }); err != nil {
  525. return err
  526. }
  527. if len(certMsg.certificates) != 0 {
  528. pub = c.peerCertificates[0].PublicKey
  529. }
  530. msg, err = c.readHandshake()
  531. if err != nil {
  532. return err
  533. }
  534. }
  535. if c.config.VerifyConnection != nil {
  536. if err := c.config.VerifyConnection(c.connectionStateLocked()); err != nil {
  537. c.sendAlert(alertBadCertificate)
  538. return err
  539. }
  540. }
  541. // Get client key exchange
  542. ckx, ok := msg.(*clientKeyExchangeMsg)
  543. if !ok {
  544. c.sendAlert(alertUnexpectedMessage)
  545. return unexpectedMessageError(ckx, msg)
  546. }
  547. hs.finishedHash.Write(ckx.marshal())
  548. preMasterSecret, err := keyAgreement.processClientKeyExchange(c.config, hs.cert, ckx, c.vers)
  549. if err != nil {
  550. c.sendAlert(alertHandshakeFailure)
  551. return err
  552. }
  553. hs.masterSecret = masterFromPreMasterSecret(c.vers, hs.suite, preMasterSecret, hs.clientHello.random, hs.hello.random)
  554. if err := c.config.writeKeyLog(keyLogLabelTLS12, hs.clientHello.random, hs.masterSecret); err != nil {
  555. c.sendAlert(alertInternalError)
  556. return err
  557. }
  558. // If we received a client cert in response to our certificate request message,
  559. // the client will send us a certificateVerifyMsg immediately after the
  560. // clientKeyExchangeMsg. This message is a digest of all preceding
  561. // handshake-layer messages that is signed using the private key corresponding
  562. // to the client's certificate. This allows us to verify that the client is in
  563. // possession of the private key of the certificate.
  564. if len(c.peerCertificates) > 0 {
  565. msg, err = c.readHandshake()
  566. if err != nil {
  567. return err
  568. }
  569. certVerify, ok := msg.(*certificateVerifyMsg)
  570. if !ok {
  571. c.sendAlert(alertUnexpectedMessage)
  572. return unexpectedMessageError(certVerify, msg)
  573. }
  574. var sigType uint8
  575. var sigHash crypto.Hash
  576. if c.vers >= VersionTLS12 {
  577. if !isSupportedSignatureAlgorithm(certVerify.signatureAlgorithm, certReq.supportedSignatureAlgorithms) {
  578. c.sendAlert(alertIllegalParameter)
  579. return errors.New("tls: client certificate used with invalid signature algorithm")
  580. }
  581. sigType, sigHash, err = typeAndHashFromSignatureScheme(certVerify.signatureAlgorithm)
  582. if err != nil {
  583. return c.sendAlert(alertInternalError)
  584. }
  585. } else {
  586. sigType, sigHash, err = legacyTypeAndHashFromPublicKey(pub)
  587. if err != nil {
  588. c.sendAlert(alertIllegalParameter)
  589. return err
  590. }
  591. }
  592. signed := hs.finishedHash.hashForClientCertificate(sigType, sigHash, hs.masterSecret)
  593. if err := verifyHandshakeSignature(sigType, pub, sigHash, signed, certVerify.signature); err != nil {
  594. c.sendAlert(alertDecryptError)
  595. return errors.New("tls: invalid signature by the client certificate: " + err.Error())
  596. }
  597. hs.finishedHash.Write(certVerify.marshal())
  598. }
  599. hs.finishedHash.discardHandshakeBuffer()
  600. return nil
  601. }
  602. func (hs *serverHandshakeState) establishKeys() error {
  603. c := hs.c
  604. clientMAC, serverMAC, clientKey, serverKey, clientIV, serverIV :=
  605. keysFromMasterSecret(c.vers, hs.suite, hs.masterSecret, hs.clientHello.random, hs.hello.random, hs.suite.macLen, hs.suite.keyLen, hs.suite.ivLen)
  606. var clientCipher, serverCipher interface{}
  607. var clientHash, serverHash hash.Hash
  608. if hs.suite.aead == nil {
  609. clientCipher = hs.suite.cipher(clientKey, clientIV, true /* for reading */)
  610. clientHash = hs.suite.mac(clientMAC)
  611. serverCipher = hs.suite.cipher(serverKey, serverIV, false /* not for reading */)
  612. serverHash = hs.suite.mac(serverMAC)
  613. } else {
  614. clientCipher = hs.suite.aead(clientKey, clientIV)
  615. serverCipher = hs.suite.aead(serverKey, serverIV)
  616. }
  617. c.in.prepareCipherSpec(c.vers, clientCipher, clientHash)
  618. c.out.prepareCipherSpec(c.vers, serverCipher, serverHash)
  619. return nil
  620. }
  621. func (hs *serverHandshakeState) readFinished(out []byte) error {
  622. c := hs.c
  623. if err := c.readChangeCipherSpec(); err != nil {
  624. return err
  625. }
  626. msg, err := c.readHandshake()
  627. if err != nil {
  628. return err
  629. }
  630. clientFinished, ok := msg.(*finishedMsg)
  631. if !ok {
  632. c.sendAlert(alertUnexpectedMessage)
  633. return unexpectedMessageError(clientFinished, msg)
  634. }
  635. verify := hs.finishedHash.clientSum(hs.masterSecret)
  636. if len(verify) != len(clientFinished.verifyData) ||
  637. subtle.ConstantTimeCompare(verify, clientFinished.verifyData) != 1 {
  638. c.sendAlert(alertHandshakeFailure)
  639. return errors.New("tls: client's Finished message is incorrect")
  640. }
  641. hs.finishedHash.Write(clientFinished.marshal())
  642. copy(out, verify)
  643. return nil
  644. }
  645. func (hs *serverHandshakeState) sendSessionTicket() error {
  646. // ticketSupported is set in a resumption handshake if the
  647. // ticket from the client was encrypted with an old session
  648. // ticket key and thus a refreshed ticket should be sent.
  649. if !hs.hello.ticketSupported {
  650. return nil
  651. }
  652. c := hs.c
  653. m := new(newSessionTicketMsg)
  654. createdAt := uint64(c.config.time().Unix())
  655. if hs.sessionState != nil {
  656. // If this is re-wrapping an old key, then keep
  657. // the original time it was created.
  658. createdAt = hs.sessionState.createdAt
  659. }
  660. var certsFromClient [][]byte
  661. for _, cert := range c.peerCertificates {
  662. certsFromClient = append(certsFromClient, cert.Raw)
  663. }
  664. state := sessionState{
  665. vers: c.vers,
  666. cipherSuite: hs.suite.id,
  667. createdAt: createdAt,
  668. masterSecret: hs.masterSecret,
  669. certificates: certsFromClient,
  670. }
  671. var err error
  672. m.ticket, err = c.encryptTicket(state.marshal())
  673. if err != nil {
  674. return err
  675. }
  676. hs.finishedHash.Write(m.marshal())
  677. if _, err := c.writeRecord(recordTypeHandshake, m.marshal()); err != nil {
  678. return err
  679. }
  680. return nil
  681. }
  682. func (hs *serverHandshakeState) sendFinished(out []byte) error {
  683. c := hs.c
  684. if _, err := c.writeRecord(recordTypeChangeCipherSpec, []byte{1}); err != nil {
  685. return err
  686. }
  687. finished := new(finishedMsg)
  688. finished.verifyData = hs.finishedHash.serverSum(hs.masterSecret)
  689. hs.finishedHash.Write(finished.marshal())
  690. if _, err := c.writeRecord(recordTypeHandshake, finished.marshal()); err != nil {
  691. return err
  692. }
  693. copy(out, finished.verifyData)
  694. return nil
  695. }
  696. // processCertsFromClient takes a chain of client certificates either from a
  697. // Certificates message or from a sessionState and verifies them. It returns
  698. // the public key of the leaf certificate.
  699. func (c *Conn) processCertsFromClient(certificate Certificate) error {
  700. certificates := certificate.Certificate
  701. certs := make([]*x509.Certificate, len(certificates))
  702. var err error
  703. for i, asn1Data := range certificates {
  704. if certs[i], err = x509.ParseCertificate(asn1Data); err != nil {
  705. c.sendAlert(alertBadCertificate)
  706. return errors.New("tls: failed to parse client certificate: " + err.Error())
  707. }
  708. }
  709. if len(certs) == 0 && requiresClientCert(c.config.ClientAuth) {
  710. c.sendAlert(alertBadCertificate)
  711. return errors.New("tls: client didn't provide a certificate")
  712. }
  713. if c.config.ClientAuth >= VerifyClientCertIfGiven && len(certs) > 0 {
  714. opts := x509.VerifyOptions{
  715. Roots: c.config.ClientCAs,
  716. CurrentTime: c.config.time(),
  717. Intermediates: x509.NewCertPool(),
  718. KeyUsages: []x509.ExtKeyUsage{x509.ExtKeyUsageClientAuth},
  719. }
  720. for _, cert := range certs[1:] {
  721. opts.Intermediates.AddCert(cert)
  722. }
  723. chains, err := certs[0].Verify(opts)
  724. if err != nil {
  725. c.sendAlert(alertBadCertificate)
  726. return errors.New("tls: failed to verify client certificate: " + err.Error())
  727. }
  728. c.verifiedChains = chains
  729. }
  730. c.peerCertificates = certs
  731. c.ocspResponse = certificate.OCSPStaple
  732. c.scts = certificate.SignedCertificateTimestamps
  733. if len(certs) > 0 {
  734. switch certs[0].PublicKey.(type) {
  735. case *ecdsa.PublicKey, *rsa.PublicKey, ed25519.PublicKey:
  736. default:
  737. c.sendAlert(alertUnsupportedCertificate)
  738. return fmt.Errorf("tls: client certificate contains an unsupported public key of type %T", certs[0].PublicKey)
  739. }
  740. }
  741. if c.config.VerifyPeerCertificate != nil {
  742. if err := c.config.VerifyPeerCertificate(certificates, c.verifiedChains); err != nil {
  743. c.sendAlert(alertBadCertificate)
  744. return err
  745. }
  746. }
  747. return nil
  748. }
  749. func newClientHelloInfo(c *Conn, clientHello *clientHelloMsg) *ClientHelloInfo {
  750. supportedVersions := clientHello.supportedVersions
  751. if len(clientHello.supportedVersions) == 0 {
  752. supportedVersions = supportedVersionsFromMax(clientHello.vers)
  753. }
  754. return toClientHelloInfo(&clientHelloInfo{
  755. CipherSuites: clientHello.cipherSuites,
  756. ServerName: clientHello.serverName,
  757. SupportedCurves: clientHello.supportedCurves,
  758. SupportedPoints: clientHello.supportedPoints,
  759. SignatureSchemes: clientHello.supportedSignatureAlgorithms,
  760. SupportedProtos: clientHello.alpnProtocols,
  761. SupportedVersions: supportedVersions,
  762. Conn: c.conn,
  763. config: toConfig(c.config),
  764. })
  765. }