handshake_server.go 24 KB

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