handshake_messages.go 47 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894
  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 tls
  5. import (
  6. "fmt"
  7. "strings"
  8. "golang.org/x/crypto/cryptobyte"
  9. )
  10. // The marshalingFunction type is an adapter to allow the use of ordinary
  11. // functions as cryptobyte.MarshalingValue.
  12. type marshalingFunction func(b *cryptobyte.Builder) error
  13. func (f marshalingFunction) Marshal(b *cryptobyte.Builder) error {
  14. return f(b)
  15. }
  16. // addBytesWithLength appends a sequence of bytes to the cryptobyte.Builder. If
  17. // the length of the sequence is not the value specified, it produces an error.
  18. func addBytesWithLength(b *cryptobyte.Builder, v []byte, n int) {
  19. b.AddValue(marshalingFunction(func(b *cryptobyte.Builder) error {
  20. if len(v) != n {
  21. return fmt.Errorf("invalid value length: expected %d, got %d", n, len(v))
  22. }
  23. b.AddBytes(v)
  24. return nil
  25. }))
  26. }
  27. // addUint64 appends a big-endian, 64-bit value to the cryptobyte.Builder.
  28. func addUint64(b *cryptobyte.Builder, v uint64) {
  29. b.AddUint32(uint32(v >> 32))
  30. b.AddUint32(uint32(v))
  31. }
  32. // readUint64 decodes a big-endian, 64-bit value into out and advances over it.
  33. // It reports whether the read was successful.
  34. func readUint64(s *cryptobyte.String, out *uint64) bool {
  35. var hi, lo uint32
  36. if !s.ReadUint32(&hi) || !s.ReadUint32(&lo) {
  37. return false
  38. }
  39. *out = uint64(hi)<<32 | uint64(lo)
  40. return true
  41. }
  42. // readUint8LengthPrefixed acts like s.ReadUint8LengthPrefixed, but targets a
  43. // []byte instead of a cryptobyte.String.
  44. func readUint8LengthPrefixed(s *cryptobyte.String, out *[]byte) bool {
  45. return s.ReadUint8LengthPrefixed((*cryptobyte.String)(out))
  46. }
  47. // readUint16LengthPrefixed acts like s.ReadUint16LengthPrefixed, but targets a
  48. // []byte instead of a cryptobyte.String.
  49. func readUint16LengthPrefixed(s *cryptobyte.String, out *[]byte) bool {
  50. return s.ReadUint16LengthPrefixed((*cryptobyte.String)(out))
  51. }
  52. // readUint24LengthPrefixed acts like s.ReadUint24LengthPrefixed, but targets a
  53. // []byte instead of a cryptobyte.String.
  54. func readUint24LengthPrefixed(s *cryptobyte.String, out *[]byte) bool {
  55. return s.ReadUint24LengthPrefixed((*cryptobyte.String)(out))
  56. }
  57. type clientHelloMsg struct {
  58. raw []byte
  59. vers uint16
  60. random []byte
  61. sessionId []byte
  62. cipherSuites []uint16
  63. compressionMethods []uint8
  64. nextProtoNeg bool
  65. serverName string
  66. ocspStapling bool
  67. supportedCurves []CurveID
  68. supportedPoints []uint8
  69. ticketSupported bool
  70. sessionTicket []uint8
  71. supportedSignatureAlgorithms []SignatureScheme
  72. supportedSignatureAlgorithmsCert []SignatureScheme
  73. secureRenegotiationSupported bool
  74. secureRenegotiation []byte
  75. alpnProtocols []string
  76. scts bool
  77. ems bool // [UTLS] actually implemented due to its prevalence
  78. supportedVersions []uint16
  79. cookie []byte
  80. keyShares []keyShare
  81. earlyData bool
  82. pskModes []uint8
  83. pskIdentities []pskIdentity
  84. pskBinders [][]byte
  85. }
  86. func (m *clientHelloMsg) marshal() []byte {
  87. if m.raw != nil {
  88. return m.raw
  89. }
  90. var b cryptobyte.Builder
  91. b.AddUint8(typeClientHello)
  92. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  93. //b.AddUint16(m.vers)
  94. b.AddUint16(0x0505)
  95. addBytesWithLength(b, m.random, 32)
  96. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  97. b.AddBytes(m.sessionId)
  98. })
  99. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  100. for _, suite := range m.cipherSuites {
  101. b.AddUint16(suite)
  102. }
  103. })
  104. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  105. b.AddBytes(m.compressionMethods)
  106. })
  107. // If extensions aren't present, omit them.
  108. var extensionsPresent bool
  109. bWithoutExtensions := *b
  110. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  111. if m.nextProtoNeg {
  112. // draft-agl-tls-nextprotoneg-04
  113. b.AddUint16(extensionNextProtoNeg)
  114. b.AddUint16(0) // empty extension_data
  115. }
  116. if len(m.serverName) > 0 {
  117. // RFC 6066, Section 3
  118. b.AddUint16(extensionServerName)
  119. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  120. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  121. b.AddUint8(0) // name_type = host_name
  122. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  123. b.AddBytes([]byte(m.serverName))
  124. })
  125. })
  126. })
  127. }
  128. if m.ocspStapling {
  129. // RFC 4366, Section 3.6
  130. b.AddUint16(extensionStatusRequest)
  131. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  132. b.AddUint8(1) // status_type = ocsp
  133. b.AddUint16(0) // empty responder_id_list
  134. b.AddUint16(0) // empty request_extensions
  135. })
  136. }
  137. if len(m.supportedCurves) > 0 {
  138. // RFC 4492, sections 5.1.1 and RFC 8446, Section 4.2.7
  139. b.AddUint16(extensionSupportedCurves)
  140. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  141. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  142. for _, curve := range m.supportedCurves {
  143. b.AddUint16(uint16(curve))
  144. }
  145. })
  146. })
  147. }
  148. if len(m.supportedPoints) > 0 {
  149. // RFC 4492, Section 5.1.2
  150. b.AddUint16(extensionSupportedPoints)
  151. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  152. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  153. b.AddBytes(m.supportedPoints)
  154. })
  155. })
  156. }
  157. if m.ticketSupported {
  158. // RFC 5077, Section 3.2
  159. b.AddUint16(extensionSessionTicket)
  160. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  161. b.AddBytes(m.sessionTicket)
  162. })
  163. }
  164. if len(m.supportedSignatureAlgorithms) > 0 {
  165. // RFC 5246, Section 7.4.1.4.1
  166. b.AddUint16(extensionSignatureAlgorithms)
  167. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  168. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  169. for _, sigAlgo := range m.supportedSignatureAlgorithms {
  170. b.AddUint16(uint16(sigAlgo))
  171. }
  172. })
  173. })
  174. }
  175. if len(m.supportedSignatureAlgorithmsCert) > 0 {
  176. // RFC 8446, Section 4.2.3
  177. b.AddUint16(extensionSignatureAlgorithmsCert)
  178. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  179. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  180. for _, sigAlgo := range m.supportedSignatureAlgorithmsCert {
  181. b.AddUint16(uint16(sigAlgo))
  182. }
  183. })
  184. })
  185. }
  186. if m.secureRenegotiationSupported {
  187. // RFC 5746, Section 3.2
  188. b.AddUint16(extensionRenegotiationInfo)
  189. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  190. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  191. b.AddBytes(m.secureRenegotiation)
  192. })
  193. })
  194. }
  195. if len(m.alpnProtocols) > 0 {
  196. // RFC 7301, Section 3.1
  197. b.AddUint16(extensionALPN)
  198. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  199. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  200. for _, proto := range m.alpnProtocols {
  201. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  202. b.AddBytes([]byte(proto))
  203. })
  204. }
  205. })
  206. })
  207. }
  208. if m.scts {
  209. // RFC 6962, Section 3.3.1
  210. b.AddUint16(extensionSCT)
  211. b.AddUint16(0) // empty extension_data
  212. }
  213. if len(m.supportedVersions) > 0 {
  214. // RFC 8446, Section 4.2.1
  215. b.AddUint16(extensionSupportedVersions)
  216. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  217. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  218. for _, vers := range m.supportedVersions {
  219. b.AddUint16(vers)
  220. }
  221. })
  222. })
  223. }
  224. if len(m.cookie) > 0 {
  225. // RFC 8446, Section 4.2.2
  226. b.AddUint16(extensionCookie)
  227. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  228. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  229. b.AddBytes(m.cookie)
  230. })
  231. })
  232. }
  233. if len(m.keyShares) > 0 {
  234. // RFC 8446, Section 4.2.8
  235. b.AddUint16(extensionKeyShare)
  236. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  237. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  238. for _, ks := range m.keyShares {
  239. b.AddUint16(uint16(ks.group))
  240. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  241. b.AddBytes(ks.data)
  242. })
  243. }
  244. })
  245. })
  246. }
  247. if m.earlyData {
  248. // RFC 8446, Section 4.2.10
  249. b.AddUint16(extensionEarlyData)
  250. b.AddUint16(0) // empty extension_data
  251. }
  252. if len(m.pskModes) > 0 {
  253. // RFC 8446, Section 4.2.9
  254. b.AddUint16(extensionPSKModes)
  255. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  256. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  257. b.AddBytes(m.pskModes)
  258. })
  259. })
  260. }
  261. if len(m.pskIdentities) > 0 { // pre_shared_key must be the last extension
  262. // RFC 8446, Section 4.2.11
  263. b.AddUint16(extensionPreSharedKey)
  264. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  265. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  266. for _, psk := range m.pskIdentities {
  267. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  268. b.AddBytes(psk.label)
  269. })
  270. b.AddUint32(psk.obfuscatedTicketAge)
  271. }
  272. })
  273. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  274. for _, binder := range m.pskBinders {
  275. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  276. b.AddBytes(binder)
  277. })
  278. }
  279. })
  280. })
  281. }
  282. extensionsPresent = len(b.BytesOrPanic()) > 2
  283. })
  284. if !extensionsPresent {
  285. *b = bWithoutExtensions
  286. }
  287. })
  288. m.raw = b.BytesOrPanic()
  289. return m.raw
  290. }
  291. // marshalWithoutBinders returns the ClientHello through the
  292. // PreSharedKeyExtension.identities field, according to RFC 8446, Section
  293. // 4.2.11.2. Note that m.pskBinders must be set to slices of the correct length.
  294. func (m *clientHelloMsg) marshalWithoutBinders() []byte {
  295. bindersLen := 2 // uint16 length prefix
  296. for _, binder := range m.pskBinders {
  297. bindersLen += 1 // uint8 length prefix
  298. bindersLen += len(binder)
  299. }
  300. fullMessage := m.marshal()
  301. return fullMessage[:len(fullMessage)-bindersLen]
  302. }
  303. // updateBinders updates the m.pskBinders field, if necessary updating the
  304. // cached marshalled representation. The supplied binders must have the same
  305. // length as the current m.pskBinders.
  306. func (m *clientHelloMsg) updateBinders(pskBinders [][]byte) {
  307. if len(pskBinders) != len(m.pskBinders) {
  308. panic("tls: internal error: pskBinders length mismatch")
  309. }
  310. for i := range m.pskBinders {
  311. if len(pskBinders[i]) != len(m.pskBinders[i]) {
  312. panic("tls: internal error: pskBinders length mismatch")
  313. }
  314. }
  315. m.pskBinders = pskBinders
  316. if m.raw != nil {
  317. lenWithoutBinders := len(m.marshalWithoutBinders())
  318. // TODO(filippo): replace with NewFixedBuilder once CL 148882 is imported.
  319. b := cryptobyte.NewBuilder(m.raw[:lenWithoutBinders])
  320. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  321. for _, binder := range m.pskBinders {
  322. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  323. b.AddBytes(binder)
  324. })
  325. }
  326. })
  327. if len(b.BytesOrPanic()) != len(m.raw) {
  328. panic("tls: internal error: failed to update binders")
  329. }
  330. }
  331. }
  332. func (m *clientHelloMsg) unmarshal(data []byte) bool {
  333. *m = clientHelloMsg{raw: data}
  334. s := cryptobyte.String(data)
  335. if !s.Skip(4) || // message type and uint24 length field
  336. !s.ReadUint16(&m.vers) || !s.ReadBytes(&m.random, 32) ||
  337. !readUint8LengthPrefixed(&s, &m.sessionId) {
  338. return false
  339. }
  340. var cipherSuites cryptobyte.String
  341. if !s.ReadUint16LengthPrefixed(&cipherSuites) {
  342. return false
  343. }
  344. m.cipherSuites = []uint16{}
  345. m.secureRenegotiationSupported = false
  346. for !cipherSuites.Empty() {
  347. var suite uint16
  348. if !cipherSuites.ReadUint16(&suite) {
  349. return false
  350. }
  351. if suite == scsvRenegotiation {
  352. m.secureRenegotiationSupported = true
  353. }
  354. m.cipherSuites = append(m.cipherSuites, suite)
  355. }
  356. if !readUint8LengthPrefixed(&s, &m.compressionMethods) {
  357. return false
  358. }
  359. if s.Empty() {
  360. // ClientHello is optionally followed by extension data
  361. return true
  362. }
  363. var extensions cryptobyte.String
  364. if !s.ReadUint16LengthPrefixed(&extensions) || !s.Empty() {
  365. return false
  366. }
  367. for !extensions.Empty() {
  368. var extension uint16
  369. var extData cryptobyte.String
  370. if !extensions.ReadUint16(&extension) ||
  371. !extensions.ReadUint16LengthPrefixed(&extData) {
  372. return false
  373. }
  374. switch extension {
  375. case extensionServerName:
  376. // RFC 6066, Section 3
  377. var nameList cryptobyte.String
  378. if !extData.ReadUint16LengthPrefixed(&nameList) || nameList.Empty() {
  379. return false
  380. }
  381. for !nameList.Empty() {
  382. var nameType uint8
  383. var serverName cryptobyte.String
  384. if !nameList.ReadUint8(&nameType) ||
  385. !nameList.ReadUint16LengthPrefixed(&serverName) ||
  386. serverName.Empty() {
  387. return false
  388. }
  389. if nameType != 0 {
  390. continue
  391. }
  392. if len(m.serverName) != 0 {
  393. // Multiple names of the same name_type are prohibited.
  394. return false
  395. }
  396. m.serverName = string(serverName)
  397. // An SNI value may not include a trailing dot.
  398. if strings.HasSuffix(m.serverName, ".") {
  399. return false
  400. }
  401. }
  402. case extensionNextProtoNeg:
  403. // draft-agl-tls-nextprotoneg-04
  404. m.nextProtoNeg = true
  405. case extensionStatusRequest:
  406. // RFC 4366, Section 3.6
  407. var statusType uint8
  408. var ignored cryptobyte.String
  409. if !extData.ReadUint8(&statusType) ||
  410. !extData.ReadUint16LengthPrefixed(&ignored) ||
  411. !extData.ReadUint16LengthPrefixed(&ignored) {
  412. return false
  413. }
  414. m.ocspStapling = statusType == statusTypeOCSP
  415. case extensionSupportedCurves:
  416. // RFC 4492, sections 5.1.1 and RFC 8446, Section 4.2.7
  417. var curves cryptobyte.String
  418. if !extData.ReadUint16LengthPrefixed(&curves) || curves.Empty() {
  419. return false
  420. }
  421. for !curves.Empty() {
  422. var curve uint16
  423. if !curves.ReadUint16(&curve) {
  424. return false
  425. }
  426. m.supportedCurves = append(m.supportedCurves, CurveID(curve))
  427. }
  428. case extensionSupportedPoints:
  429. // RFC 4492, Section 5.1.2
  430. if !readUint8LengthPrefixed(&extData, &m.supportedPoints) ||
  431. len(m.supportedPoints) == 0 {
  432. return false
  433. }
  434. case extensionSessionTicket:
  435. // RFC 5077, Section 3.2
  436. m.ticketSupported = true
  437. extData.ReadBytes(&m.sessionTicket, len(extData))
  438. case extensionSignatureAlgorithms:
  439. // RFC 5246, Section 7.4.1.4.1
  440. var sigAndAlgs cryptobyte.String
  441. if !extData.ReadUint16LengthPrefixed(&sigAndAlgs) || sigAndAlgs.Empty() {
  442. return false
  443. }
  444. for !sigAndAlgs.Empty() {
  445. var sigAndAlg uint16
  446. if !sigAndAlgs.ReadUint16(&sigAndAlg) {
  447. return false
  448. }
  449. m.supportedSignatureAlgorithms = append(
  450. m.supportedSignatureAlgorithms, SignatureScheme(sigAndAlg))
  451. }
  452. case extensionSignatureAlgorithmsCert:
  453. // RFC 8446, Section 4.2.3
  454. var sigAndAlgs cryptobyte.String
  455. if !extData.ReadUint16LengthPrefixed(&sigAndAlgs) || sigAndAlgs.Empty() {
  456. return false
  457. }
  458. for !sigAndAlgs.Empty() {
  459. var sigAndAlg uint16
  460. if !sigAndAlgs.ReadUint16(&sigAndAlg) {
  461. return false
  462. }
  463. m.supportedSignatureAlgorithmsCert = append(
  464. m.supportedSignatureAlgorithmsCert, SignatureScheme(sigAndAlg))
  465. }
  466. case extensionRenegotiationInfo:
  467. // RFC 5746, Section 3.2
  468. if !readUint8LengthPrefixed(&extData, &m.secureRenegotiation) {
  469. return false
  470. }
  471. m.secureRenegotiationSupported = true
  472. case extensionALPN:
  473. // RFC 7301, Section 3.1
  474. var protoList cryptobyte.String
  475. if !extData.ReadUint16LengthPrefixed(&protoList) || protoList.Empty() {
  476. return false
  477. }
  478. for !protoList.Empty() {
  479. var proto cryptobyte.String
  480. if !protoList.ReadUint8LengthPrefixed(&proto) || proto.Empty() {
  481. return false
  482. }
  483. m.alpnProtocols = append(m.alpnProtocols, string(proto))
  484. }
  485. case extensionSCT:
  486. // RFC 6962, Section 3.3.1
  487. m.scts = true
  488. case extensionSupportedVersions:
  489. // RFC 8446, Section 4.2.1
  490. var versList cryptobyte.String
  491. if !extData.ReadUint8LengthPrefixed(&versList) || versList.Empty() {
  492. return false
  493. }
  494. for !versList.Empty() {
  495. var vers uint16
  496. if !versList.ReadUint16(&vers) {
  497. return false
  498. }
  499. m.supportedVersions = append(m.supportedVersions, vers)
  500. }
  501. case extensionCookie:
  502. // RFC 8446, Section 4.2.2
  503. if !readUint16LengthPrefixed(&extData, &m.cookie) ||
  504. len(m.cookie) == 0 {
  505. return false
  506. }
  507. case extensionKeyShare:
  508. // RFC 8446, Section 4.2.8
  509. var clientShares cryptobyte.String
  510. if !extData.ReadUint16LengthPrefixed(&clientShares) {
  511. return false
  512. }
  513. for !clientShares.Empty() {
  514. var ks keyShare
  515. if !clientShares.ReadUint16((*uint16)(&ks.group)) ||
  516. !readUint16LengthPrefixed(&clientShares, &ks.data) ||
  517. len(ks.data) == 0 {
  518. return false
  519. }
  520. m.keyShares = append(m.keyShares, ks)
  521. }
  522. case extensionEarlyData:
  523. // RFC 8446, Section 4.2.10
  524. m.earlyData = true
  525. case extensionPSKModes:
  526. // RFC 8446, Section 4.2.9
  527. if !readUint8LengthPrefixed(&extData, &m.pskModes) {
  528. return false
  529. }
  530. case extensionPreSharedKey:
  531. // RFC 8446, Section 4.2.11
  532. if !extensions.Empty() {
  533. return false // pre_shared_key must be the last extension
  534. }
  535. var identities cryptobyte.String
  536. if !extData.ReadUint16LengthPrefixed(&identities) || identities.Empty() {
  537. return false
  538. }
  539. for !identities.Empty() {
  540. var psk pskIdentity
  541. if !readUint16LengthPrefixed(&identities, &psk.label) ||
  542. !identities.ReadUint32(&psk.obfuscatedTicketAge) ||
  543. len(psk.label) == 0 {
  544. return false
  545. }
  546. m.pskIdentities = append(m.pskIdentities, psk)
  547. }
  548. var binders cryptobyte.String
  549. if !extData.ReadUint16LengthPrefixed(&binders) || binders.Empty() {
  550. return false
  551. }
  552. for !binders.Empty() {
  553. var binder []byte
  554. if !readUint8LengthPrefixed(&binders, &binder) ||
  555. len(binder) == 0 {
  556. return false
  557. }
  558. m.pskBinders = append(m.pskBinders, binder)
  559. }
  560. default:
  561. // Ignore unknown extensions.
  562. continue
  563. }
  564. if !extData.Empty() {
  565. return false
  566. }
  567. }
  568. return true
  569. }
  570. type serverHelloMsg struct {
  571. raw []byte
  572. vers uint16
  573. random []byte
  574. sessionId []byte
  575. cipherSuite uint16
  576. compressionMethod uint8
  577. nextProtoNeg bool
  578. nextProtos []string
  579. ocspStapling bool
  580. ticketSupported bool
  581. secureRenegotiationSupported bool
  582. secureRenegotiation []byte
  583. alpnProtocol string
  584. ems bool
  585. scts [][]byte
  586. supportedVersion uint16
  587. serverShare keyShare
  588. selectedIdentityPresent bool
  589. selectedIdentity uint16
  590. // HelloRetryRequest extensions
  591. cookie []byte
  592. selectedGroup CurveID
  593. }
  594. func (m *serverHelloMsg) marshal() []byte {
  595. if m.raw != nil {
  596. return m.raw
  597. }
  598. var b cryptobyte.Builder
  599. b.AddUint8(typeServerHello)
  600. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  601. b.AddUint16(m.vers)
  602. addBytesWithLength(b, m.random, 32)
  603. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  604. b.AddBytes(m.sessionId)
  605. })
  606. b.AddUint16(m.cipherSuite)
  607. b.AddUint8(m.compressionMethod)
  608. // If extensions aren't present, omit them.
  609. var extensionsPresent bool
  610. bWithoutExtensions := *b
  611. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  612. if m.nextProtoNeg {
  613. b.AddUint16(extensionNextProtoNeg)
  614. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  615. for _, proto := range m.nextProtos {
  616. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  617. b.AddBytes([]byte(proto))
  618. })
  619. }
  620. })
  621. }
  622. if m.ocspStapling {
  623. b.AddUint16(extensionStatusRequest)
  624. b.AddUint16(0) // empty extension_data
  625. }
  626. if m.ticketSupported {
  627. b.AddUint16(extensionSessionTicket)
  628. b.AddUint16(0) // empty extension_data
  629. }
  630. if m.secureRenegotiationSupported {
  631. b.AddUint16(extensionRenegotiationInfo)
  632. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  633. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  634. b.AddBytes(m.secureRenegotiation)
  635. })
  636. })
  637. }
  638. if len(m.alpnProtocol) > 0 {
  639. b.AddUint16(extensionALPN)
  640. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  641. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  642. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  643. b.AddBytes([]byte(m.alpnProtocol))
  644. })
  645. })
  646. })
  647. }
  648. if len(m.scts) > 0 {
  649. b.AddUint16(extensionSCT)
  650. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  651. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  652. for _, sct := range m.scts {
  653. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  654. b.AddBytes(sct)
  655. })
  656. }
  657. })
  658. })
  659. }
  660. if m.supportedVersion != 0 {
  661. b.AddUint16(extensionSupportedVersions)
  662. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  663. b.AddUint16(m.supportedVersion)
  664. })
  665. }
  666. if m.serverShare.group != 0 {
  667. b.AddUint16(extensionKeyShare)
  668. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  669. b.AddUint16(uint16(m.serverShare.group))
  670. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  671. b.AddBytes(m.serverShare.data)
  672. })
  673. })
  674. }
  675. if m.selectedIdentityPresent {
  676. b.AddUint16(extensionPreSharedKey)
  677. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  678. b.AddUint16(m.selectedIdentity)
  679. })
  680. }
  681. if len(m.cookie) > 0 {
  682. b.AddUint16(extensionCookie)
  683. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  684. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  685. b.AddBytes(m.cookie)
  686. })
  687. })
  688. }
  689. if m.selectedGroup != 0 {
  690. b.AddUint16(extensionKeyShare)
  691. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  692. b.AddUint16(uint16(m.selectedGroup))
  693. })
  694. }
  695. extensionsPresent = len(b.BytesOrPanic()) > 2
  696. })
  697. if !extensionsPresent {
  698. *b = bWithoutExtensions
  699. }
  700. })
  701. m.raw = b.BytesOrPanic()
  702. return m.raw
  703. }
  704. func (m *serverHelloMsg) unmarshal(data []byte) bool {
  705. *m = serverHelloMsg{raw: data}
  706. s := cryptobyte.String(data)
  707. if !s.Skip(4) || // message type and uint24 length field
  708. !s.ReadUint16(&m.vers) || !s.ReadBytes(&m.random, 32) ||
  709. !readUint8LengthPrefixed(&s, &m.sessionId) ||
  710. !s.ReadUint16(&m.cipherSuite) ||
  711. !s.ReadUint8(&m.compressionMethod) {
  712. return false
  713. }
  714. if s.Empty() {
  715. // ServerHello is optionally followed by extension data
  716. return true
  717. }
  718. var extensions cryptobyte.String
  719. if !s.ReadUint16LengthPrefixed(&extensions) || !s.Empty() {
  720. return false
  721. }
  722. for !extensions.Empty() {
  723. var extension uint16
  724. var extData cryptobyte.String
  725. if !extensions.ReadUint16(&extension) ||
  726. !extensions.ReadUint16LengthPrefixed(&extData) {
  727. return false
  728. }
  729. switch extension {
  730. case extensionNextProtoNeg:
  731. m.nextProtoNeg = true
  732. for !extData.Empty() {
  733. var proto cryptobyte.String
  734. if !extData.ReadUint8LengthPrefixed(&proto) ||
  735. proto.Empty() {
  736. return false
  737. }
  738. m.nextProtos = append(m.nextProtos, string(proto))
  739. }
  740. case extensionStatusRequest:
  741. m.ocspStapling = true
  742. case extensionSessionTicket:
  743. m.ticketSupported = true
  744. case utlsExtensionExtendedMasterSecret:
  745. // No sanity check for this extension: pretending not to know it.
  746. // if length > 0 {
  747. // return false
  748. // }
  749. m.ems = true
  750. case extensionRenegotiationInfo:
  751. if !readUint8LengthPrefixed(&extData, &m.secureRenegotiation) {
  752. return false
  753. }
  754. m.secureRenegotiationSupported = true
  755. case extensionALPN:
  756. var protoList cryptobyte.String
  757. if !extData.ReadUint16LengthPrefixed(&protoList) || protoList.Empty() {
  758. return false
  759. }
  760. var proto cryptobyte.String
  761. if !protoList.ReadUint8LengthPrefixed(&proto) ||
  762. proto.Empty() || !protoList.Empty() {
  763. return false
  764. }
  765. m.alpnProtocol = string(proto)
  766. case extensionSCT:
  767. var sctList cryptobyte.String
  768. if !extData.ReadUint16LengthPrefixed(&sctList) || sctList.Empty() {
  769. return false
  770. }
  771. for !sctList.Empty() {
  772. var sct []byte
  773. if !readUint16LengthPrefixed(&sctList, &sct) ||
  774. len(sct) == 0 {
  775. return false
  776. }
  777. m.scts = append(m.scts, sct)
  778. }
  779. case extensionSupportedVersions:
  780. if !extData.ReadUint16(&m.supportedVersion) {
  781. return false
  782. }
  783. case extensionCookie:
  784. if !readUint16LengthPrefixed(&extData, &m.cookie) ||
  785. len(m.cookie) == 0 {
  786. return false
  787. }
  788. case extensionKeyShare:
  789. // This extension has different formats in SH and HRR, accept either
  790. // and let the handshake logic decide. See RFC 8446, Section 4.2.8.
  791. if len(extData) == 2 {
  792. if !extData.ReadUint16((*uint16)(&m.selectedGroup)) {
  793. return false
  794. }
  795. } else {
  796. if !extData.ReadUint16((*uint16)(&m.serverShare.group)) ||
  797. !readUint16LengthPrefixed(&extData, &m.serverShare.data) {
  798. return false
  799. }
  800. }
  801. case extensionPreSharedKey:
  802. m.selectedIdentityPresent = true
  803. if !extData.ReadUint16(&m.selectedIdentity) {
  804. return false
  805. }
  806. default:
  807. // Ignore unknown extensions.
  808. continue
  809. }
  810. if !extData.Empty() {
  811. return false
  812. }
  813. }
  814. return true
  815. }
  816. type encryptedExtensionsMsg struct {
  817. raw []byte
  818. alpnProtocol string
  819. }
  820. func (m *encryptedExtensionsMsg) marshal() []byte {
  821. if m.raw != nil {
  822. return m.raw
  823. }
  824. var b cryptobyte.Builder
  825. b.AddUint8(typeEncryptedExtensions)
  826. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  827. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  828. if len(m.alpnProtocol) > 0 {
  829. b.AddUint16(extensionALPN)
  830. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  831. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  832. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  833. b.AddBytes([]byte(m.alpnProtocol))
  834. })
  835. })
  836. })
  837. }
  838. })
  839. })
  840. m.raw = b.BytesOrPanic()
  841. return m.raw
  842. }
  843. func (m *encryptedExtensionsMsg) unmarshal(data []byte) bool {
  844. *m = encryptedExtensionsMsg{raw: data}
  845. s := cryptobyte.String(data)
  846. var extensions cryptobyte.String
  847. if !s.Skip(4) || // message type and uint24 length field
  848. !s.ReadUint16LengthPrefixed(&extensions) || !s.Empty() {
  849. return false
  850. }
  851. for !extensions.Empty() {
  852. var extension uint16
  853. var extData cryptobyte.String
  854. if !extensions.ReadUint16(&extension) ||
  855. !extensions.ReadUint16LengthPrefixed(&extData) {
  856. return false
  857. }
  858. switch extension {
  859. case extensionALPN:
  860. var protoList cryptobyte.String
  861. if !extData.ReadUint16LengthPrefixed(&protoList) || protoList.Empty() {
  862. return false
  863. }
  864. var proto cryptobyte.String
  865. if !protoList.ReadUint8LengthPrefixed(&proto) ||
  866. proto.Empty() || !protoList.Empty() {
  867. return false
  868. }
  869. m.alpnProtocol = string(proto)
  870. default:
  871. // Ignore unknown extensions.
  872. continue
  873. }
  874. if !extData.Empty() {
  875. return false
  876. }
  877. }
  878. return true
  879. }
  880. type endOfEarlyDataMsg struct{}
  881. func (m *endOfEarlyDataMsg) marshal() []byte {
  882. x := make([]byte, 4)
  883. x[0] = typeEndOfEarlyData
  884. return x
  885. }
  886. func (m *endOfEarlyDataMsg) unmarshal(data []byte) bool {
  887. return len(data) == 4
  888. }
  889. type keyUpdateMsg struct {
  890. raw []byte
  891. updateRequested bool
  892. }
  893. func (m *keyUpdateMsg) marshal() []byte {
  894. if m.raw != nil {
  895. return m.raw
  896. }
  897. var b cryptobyte.Builder
  898. b.AddUint8(typeKeyUpdate)
  899. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  900. if m.updateRequested {
  901. b.AddUint8(1)
  902. } else {
  903. b.AddUint8(0)
  904. }
  905. })
  906. m.raw = b.BytesOrPanic()
  907. return m.raw
  908. }
  909. func (m *keyUpdateMsg) unmarshal(data []byte) bool {
  910. m.raw = data
  911. s := cryptobyte.String(data)
  912. var updateRequested uint8
  913. if !s.Skip(4) || // message type and uint24 length field
  914. !s.ReadUint8(&updateRequested) || !s.Empty() {
  915. return false
  916. }
  917. switch updateRequested {
  918. case 0:
  919. m.updateRequested = false
  920. case 1:
  921. m.updateRequested = true
  922. default:
  923. return false
  924. }
  925. return true
  926. }
  927. type newSessionTicketMsgTLS13 struct {
  928. raw []byte
  929. lifetime uint32
  930. ageAdd uint32
  931. nonce []byte
  932. label []byte
  933. maxEarlyData uint32
  934. }
  935. func (m *newSessionTicketMsgTLS13) marshal() []byte {
  936. if m.raw != nil {
  937. return m.raw
  938. }
  939. var b cryptobyte.Builder
  940. b.AddUint8(typeNewSessionTicket)
  941. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  942. b.AddUint32(m.lifetime)
  943. b.AddUint32(m.ageAdd)
  944. b.AddUint8LengthPrefixed(func(b *cryptobyte.Builder) {
  945. b.AddBytes(m.nonce)
  946. })
  947. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  948. b.AddBytes(m.label)
  949. })
  950. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  951. if m.maxEarlyData > 0 {
  952. b.AddUint16(extensionEarlyData)
  953. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  954. b.AddUint32(m.maxEarlyData)
  955. })
  956. }
  957. })
  958. })
  959. m.raw = b.BytesOrPanic()
  960. return m.raw
  961. }
  962. func (m *newSessionTicketMsgTLS13) unmarshal(data []byte) bool {
  963. *m = newSessionTicketMsgTLS13{raw: data}
  964. s := cryptobyte.String(data)
  965. var extensions cryptobyte.String
  966. if !s.Skip(4) || // message type and uint24 length field
  967. !s.ReadUint32(&m.lifetime) ||
  968. !s.ReadUint32(&m.ageAdd) ||
  969. !readUint8LengthPrefixed(&s, &m.nonce) ||
  970. !readUint16LengthPrefixed(&s, &m.label) ||
  971. !s.ReadUint16LengthPrefixed(&extensions) ||
  972. !s.Empty() {
  973. return false
  974. }
  975. for !extensions.Empty() {
  976. var extension uint16
  977. var extData cryptobyte.String
  978. if !extensions.ReadUint16(&extension) ||
  979. !extensions.ReadUint16LengthPrefixed(&extData) {
  980. return false
  981. }
  982. switch extension {
  983. case extensionEarlyData:
  984. if !extData.ReadUint32(&m.maxEarlyData) {
  985. return false
  986. }
  987. default:
  988. // Ignore unknown extensions.
  989. continue
  990. }
  991. if !extData.Empty() {
  992. return false
  993. }
  994. }
  995. return true
  996. }
  997. type certificateRequestMsgTLS13 struct {
  998. raw []byte
  999. ocspStapling bool
  1000. scts bool
  1001. supportedSignatureAlgorithms []SignatureScheme
  1002. supportedSignatureAlgorithmsCert []SignatureScheme
  1003. certificateAuthorities [][]byte
  1004. }
  1005. func (m *certificateRequestMsgTLS13) marshal() []byte {
  1006. if m.raw != nil {
  1007. return m.raw
  1008. }
  1009. var b cryptobyte.Builder
  1010. b.AddUint8(typeCertificateRequest)
  1011. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1012. // certificate_request_context (SHALL be zero length unless used for
  1013. // post-handshake authentication)
  1014. b.AddUint8(0)
  1015. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1016. if m.ocspStapling {
  1017. b.AddUint16(extensionStatusRequest)
  1018. b.AddUint16(0) // empty extension_data
  1019. }
  1020. if m.scts {
  1021. // RFC 8446, Section 4.4.2.1 makes no mention of
  1022. // signed_certificate_timestamp in CertificateRequest, but
  1023. // "Extensions in the Certificate message from the client MUST
  1024. // correspond to extensions in the CertificateRequest message
  1025. // from the server." and it appears in the table in Section 4.2.
  1026. b.AddUint16(extensionSCT)
  1027. b.AddUint16(0) // empty extension_data
  1028. }
  1029. if len(m.supportedSignatureAlgorithms) > 0 {
  1030. b.AddUint16(extensionSignatureAlgorithms)
  1031. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1032. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1033. for _, sigAlgo := range m.supportedSignatureAlgorithms {
  1034. b.AddUint16(uint16(sigAlgo))
  1035. }
  1036. })
  1037. })
  1038. }
  1039. if len(m.supportedSignatureAlgorithmsCert) > 0 {
  1040. b.AddUint16(extensionSignatureAlgorithmsCert)
  1041. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1042. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1043. for _, sigAlgo := range m.supportedSignatureAlgorithmsCert {
  1044. b.AddUint16(uint16(sigAlgo))
  1045. }
  1046. })
  1047. })
  1048. }
  1049. if len(m.certificateAuthorities) > 0 {
  1050. b.AddUint16(extensionCertificateAuthorities)
  1051. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1052. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1053. for _, ca := range m.certificateAuthorities {
  1054. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1055. b.AddBytes(ca)
  1056. })
  1057. }
  1058. })
  1059. })
  1060. }
  1061. })
  1062. })
  1063. m.raw = b.BytesOrPanic()
  1064. return m.raw
  1065. }
  1066. func (m *certificateRequestMsgTLS13) unmarshal(data []byte) bool {
  1067. *m = certificateRequestMsgTLS13{raw: data}
  1068. s := cryptobyte.String(data)
  1069. var context, extensions cryptobyte.String
  1070. if !s.Skip(4) || // message type and uint24 length field
  1071. !s.ReadUint8LengthPrefixed(&context) || !context.Empty() ||
  1072. !s.ReadUint16LengthPrefixed(&extensions) ||
  1073. !s.Empty() {
  1074. return false
  1075. }
  1076. for !extensions.Empty() {
  1077. var extension uint16
  1078. var extData cryptobyte.String
  1079. if !extensions.ReadUint16(&extension) ||
  1080. !extensions.ReadUint16LengthPrefixed(&extData) {
  1081. return false
  1082. }
  1083. switch extension {
  1084. case extensionStatusRequest:
  1085. m.ocspStapling = true
  1086. case extensionSCT:
  1087. m.scts = true
  1088. case extensionSignatureAlgorithms:
  1089. var sigAndAlgs cryptobyte.String
  1090. if !extData.ReadUint16LengthPrefixed(&sigAndAlgs) || sigAndAlgs.Empty() {
  1091. return false
  1092. }
  1093. for !sigAndAlgs.Empty() {
  1094. var sigAndAlg uint16
  1095. if !sigAndAlgs.ReadUint16(&sigAndAlg) {
  1096. return false
  1097. }
  1098. m.supportedSignatureAlgorithms = append(
  1099. m.supportedSignatureAlgorithms, SignatureScheme(sigAndAlg))
  1100. }
  1101. case extensionSignatureAlgorithmsCert:
  1102. var sigAndAlgs cryptobyte.String
  1103. if !extData.ReadUint16LengthPrefixed(&sigAndAlgs) || sigAndAlgs.Empty() {
  1104. return false
  1105. }
  1106. for !sigAndAlgs.Empty() {
  1107. var sigAndAlg uint16
  1108. if !sigAndAlgs.ReadUint16(&sigAndAlg) {
  1109. return false
  1110. }
  1111. m.supportedSignatureAlgorithmsCert = append(
  1112. m.supportedSignatureAlgorithmsCert, SignatureScheme(sigAndAlg))
  1113. }
  1114. case extensionCertificateAuthorities:
  1115. var auths cryptobyte.String
  1116. if !extData.ReadUint16LengthPrefixed(&auths) || auths.Empty() {
  1117. return false
  1118. }
  1119. for !auths.Empty() {
  1120. var ca []byte
  1121. if !readUint16LengthPrefixed(&auths, &ca) || len(ca) == 0 {
  1122. return false
  1123. }
  1124. m.certificateAuthorities = append(m.certificateAuthorities, ca)
  1125. }
  1126. default:
  1127. // Ignore unknown extensions.
  1128. continue
  1129. }
  1130. if !extData.Empty() {
  1131. return false
  1132. }
  1133. }
  1134. return true
  1135. }
  1136. type certificateMsg struct {
  1137. raw []byte
  1138. certificates [][]byte
  1139. }
  1140. func (m *certificateMsg) marshal() (x []byte) {
  1141. if m.raw != nil {
  1142. return m.raw
  1143. }
  1144. var i int
  1145. for _, slice := range m.certificates {
  1146. i += len(slice)
  1147. }
  1148. length := 3 + 3*len(m.certificates) + i
  1149. x = make([]byte, 4+length)
  1150. x[0] = typeCertificate
  1151. x[1] = uint8(length >> 16)
  1152. x[2] = uint8(length >> 8)
  1153. x[3] = uint8(length)
  1154. certificateOctets := length - 3
  1155. x[4] = uint8(certificateOctets >> 16)
  1156. x[5] = uint8(certificateOctets >> 8)
  1157. x[6] = uint8(certificateOctets)
  1158. y := x[7:]
  1159. for _, slice := range m.certificates {
  1160. y[0] = uint8(len(slice) >> 16)
  1161. y[1] = uint8(len(slice) >> 8)
  1162. y[2] = uint8(len(slice))
  1163. copy(y[3:], slice)
  1164. y = y[3+len(slice):]
  1165. }
  1166. m.raw = x
  1167. return
  1168. }
  1169. func (m *certificateMsg) unmarshal(data []byte) bool {
  1170. if len(data) < 7 {
  1171. return false
  1172. }
  1173. m.raw = data
  1174. certsLen := uint32(data[4])<<16 | uint32(data[5])<<8 | uint32(data[6])
  1175. if uint32(len(data)) != certsLen+7 {
  1176. return false
  1177. }
  1178. numCerts := 0
  1179. d := data[7:]
  1180. for certsLen > 0 {
  1181. if len(d) < 4 {
  1182. return false
  1183. }
  1184. certLen := uint32(d[0])<<16 | uint32(d[1])<<8 | uint32(d[2])
  1185. if uint32(len(d)) < 3+certLen {
  1186. return false
  1187. }
  1188. d = d[3+certLen:]
  1189. certsLen -= 3 + certLen
  1190. numCerts++
  1191. }
  1192. m.certificates = make([][]byte, numCerts)
  1193. d = data[7:]
  1194. for i := 0; i < numCerts; i++ {
  1195. certLen := uint32(d[0])<<16 | uint32(d[1])<<8 | uint32(d[2])
  1196. m.certificates[i] = d[3 : 3+certLen]
  1197. d = d[3+certLen:]
  1198. }
  1199. return true
  1200. }
  1201. type certificateMsgTLS13 struct {
  1202. raw []byte
  1203. certificate Certificate
  1204. ocspStapling bool
  1205. scts bool
  1206. }
  1207. func (m *certificateMsgTLS13) marshal() []byte {
  1208. if m.raw != nil {
  1209. return m.raw
  1210. }
  1211. var b cryptobyte.Builder
  1212. b.AddUint8(typeCertificate)
  1213. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1214. b.AddUint8(0) // certificate_request_context
  1215. certificate := m.certificate
  1216. if !m.ocspStapling {
  1217. certificate.OCSPStaple = nil
  1218. }
  1219. if !m.scts {
  1220. certificate.SignedCertificateTimestamps = nil
  1221. }
  1222. marshalCertificate(b, certificate)
  1223. })
  1224. m.raw = b.BytesOrPanic()
  1225. return m.raw
  1226. }
  1227. func marshalCertificate(b *cryptobyte.Builder, certificate Certificate) {
  1228. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1229. for i, cert := range certificate.Certificate {
  1230. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1231. b.AddBytes(cert)
  1232. })
  1233. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1234. if i > 0 {
  1235. // This library only supports OCSP and SCT for leaf certificates.
  1236. return
  1237. }
  1238. if certificate.OCSPStaple != nil {
  1239. b.AddUint16(extensionStatusRequest)
  1240. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1241. b.AddUint8(statusTypeOCSP)
  1242. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1243. b.AddBytes(certificate.OCSPStaple)
  1244. })
  1245. })
  1246. }
  1247. if certificate.SignedCertificateTimestamps != nil {
  1248. b.AddUint16(extensionSCT)
  1249. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1250. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1251. for _, sct := range certificate.SignedCertificateTimestamps {
  1252. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1253. b.AddBytes(sct)
  1254. })
  1255. }
  1256. })
  1257. })
  1258. }
  1259. })
  1260. }
  1261. })
  1262. }
  1263. func (m *certificateMsgTLS13) unmarshal(data []byte) bool {
  1264. *m = certificateMsgTLS13{raw: data}
  1265. s := cryptobyte.String(data)
  1266. var context cryptobyte.String
  1267. if !s.Skip(4) || // message type and uint24 length field
  1268. !s.ReadUint8LengthPrefixed(&context) || !context.Empty() ||
  1269. !unmarshalCertificate(&s, &m.certificate) ||
  1270. !s.Empty() {
  1271. return false
  1272. }
  1273. m.scts = m.certificate.SignedCertificateTimestamps != nil
  1274. m.ocspStapling = m.certificate.OCSPStaple != nil
  1275. return true
  1276. }
  1277. func unmarshalCertificate(s *cryptobyte.String, certificate *Certificate) bool {
  1278. var certList cryptobyte.String
  1279. if !s.ReadUint24LengthPrefixed(&certList) {
  1280. return false
  1281. }
  1282. for !certList.Empty() {
  1283. var cert []byte
  1284. var extensions cryptobyte.String
  1285. if !readUint24LengthPrefixed(&certList, &cert) ||
  1286. !certList.ReadUint16LengthPrefixed(&extensions) {
  1287. return false
  1288. }
  1289. certificate.Certificate = append(certificate.Certificate, cert)
  1290. for !extensions.Empty() {
  1291. var extension uint16
  1292. var extData cryptobyte.String
  1293. if !extensions.ReadUint16(&extension) ||
  1294. !extensions.ReadUint16LengthPrefixed(&extData) {
  1295. return false
  1296. }
  1297. if len(certificate.Certificate) > 1 {
  1298. // This library only supports OCSP and SCT for leaf certificates.
  1299. continue
  1300. }
  1301. switch extension {
  1302. case extensionStatusRequest:
  1303. var statusType uint8
  1304. if !extData.ReadUint8(&statusType) || statusType != statusTypeOCSP ||
  1305. !readUint24LengthPrefixed(&extData, &certificate.OCSPStaple) ||
  1306. len(certificate.OCSPStaple) == 0 {
  1307. return false
  1308. }
  1309. case extensionSCT:
  1310. var sctList cryptobyte.String
  1311. if !extData.ReadUint16LengthPrefixed(&sctList) || sctList.Empty() {
  1312. return false
  1313. }
  1314. for !sctList.Empty() {
  1315. var sct []byte
  1316. if !readUint16LengthPrefixed(&sctList, &sct) ||
  1317. len(sct) == 0 {
  1318. return false
  1319. }
  1320. certificate.SignedCertificateTimestamps = append(
  1321. certificate.SignedCertificateTimestamps, sct)
  1322. }
  1323. default:
  1324. // Ignore unknown extensions.
  1325. continue
  1326. }
  1327. if !extData.Empty() {
  1328. return false
  1329. }
  1330. }
  1331. }
  1332. return true
  1333. }
  1334. type serverKeyExchangeMsg struct {
  1335. raw []byte
  1336. key []byte
  1337. }
  1338. func (m *serverKeyExchangeMsg) marshal() []byte {
  1339. if m.raw != nil {
  1340. return m.raw
  1341. }
  1342. length := len(m.key)
  1343. x := make([]byte, length+4)
  1344. x[0] = typeServerKeyExchange
  1345. x[1] = uint8(length >> 16)
  1346. x[2] = uint8(length >> 8)
  1347. x[3] = uint8(length)
  1348. copy(x[4:], m.key)
  1349. m.raw = x
  1350. return x
  1351. }
  1352. func (m *serverKeyExchangeMsg) unmarshal(data []byte) bool {
  1353. m.raw = data
  1354. if len(data) < 4 {
  1355. return false
  1356. }
  1357. m.key = data[4:]
  1358. return true
  1359. }
  1360. type certificateStatusMsg struct {
  1361. raw []byte
  1362. response []byte
  1363. }
  1364. func (m *certificateStatusMsg) marshal() []byte {
  1365. if m.raw != nil {
  1366. return m.raw
  1367. }
  1368. var b cryptobyte.Builder
  1369. b.AddUint8(typeCertificateStatus)
  1370. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1371. b.AddUint8(statusTypeOCSP)
  1372. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1373. b.AddBytes(m.response)
  1374. })
  1375. })
  1376. m.raw = b.BytesOrPanic()
  1377. return m.raw
  1378. }
  1379. func (m *certificateStatusMsg) unmarshal(data []byte) bool {
  1380. m.raw = data
  1381. s := cryptobyte.String(data)
  1382. var statusType uint8
  1383. if !s.Skip(4) || // message type and uint24 length field
  1384. !s.ReadUint8(&statusType) || statusType != statusTypeOCSP ||
  1385. !readUint24LengthPrefixed(&s, &m.response) ||
  1386. len(m.response) == 0 || !s.Empty() {
  1387. return false
  1388. }
  1389. return true
  1390. }
  1391. type serverHelloDoneMsg struct{}
  1392. func (m *serverHelloDoneMsg) marshal() []byte {
  1393. x := make([]byte, 4)
  1394. x[0] = typeServerHelloDone
  1395. return x
  1396. }
  1397. func (m *serverHelloDoneMsg) unmarshal(data []byte) bool {
  1398. return len(data) == 4
  1399. }
  1400. type clientKeyExchangeMsg struct {
  1401. raw []byte
  1402. ciphertext []byte
  1403. }
  1404. func (m *clientKeyExchangeMsg) marshal() []byte {
  1405. if m.raw != nil {
  1406. return m.raw
  1407. }
  1408. length := len(m.ciphertext)
  1409. x := make([]byte, length+4)
  1410. x[0] = typeClientKeyExchange
  1411. x[1] = uint8(length >> 16)
  1412. x[2] = uint8(length >> 8)
  1413. x[3] = uint8(length)
  1414. copy(x[4:], m.ciphertext)
  1415. m.raw = x
  1416. return x
  1417. }
  1418. func (m *clientKeyExchangeMsg) unmarshal(data []byte) bool {
  1419. m.raw = data
  1420. if len(data) < 4 {
  1421. return false
  1422. }
  1423. l := int(data[1])<<16 | int(data[2])<<8 | int(data[3])
  1424. if l != len(data)-4 {
  1425. return false
  1426. }
  1427. m.ciphertext = data[4:]
  1428. return true
  1429. }
  1430. type finishedMsg struct {
  1431. raw []byte
  1432. verifyData []byte
  1433. }
  1434. func (m *finishedMsg) marshal() []byte {
  1435. if m.raw != nil {
  1436. return m.raw
  1437. }
  1438. var b cryptobyte.Builder
  1439. b.AddUint8(typeFinished)
  1440. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1441. b.AddBytes(m.verifyData)
  1442. })
  1443. m.raw = b.BytesOrPanic()
  1444. return m.raw
  1445. }
  1446. func (m *finishedMsg) unmarshal(data []byte) bool {
  1447. m.raw = data
  1448. s := cryptobyte.String(data)
  1449. return s.Skip(1) &&
  1450. readUint24LengthPrefixed(&s, &m.verifyData) &&
  1451. s.Empty()
  1452. }
  1453. type nextProtoMsg struct {
  1454. raw []byte
  1455. proto string
  1456. }
  1457. func (m *nextProtoMsg) marshal() []byte {
  1458. if m.raw != nil {
  1459. return m.raw
  1460. }
  1461. l := len(m.proto)
  1462. if l > 255 {
  1463. l = 255
  1464. }
  1465. padding := 32 - (l+2)%32
  1466. length := l + padding + 2
  1467. x := make([]byte, length+4)
  1468. x[0] = typeNextProtocol
  1469. x[1] = uint8(length >> 16)
  1470. x[2] = uint8(length >> 8)
  1471. x[3] = uint8(length)
  1472. y := x[4:]
  1473. y[0] = byte(l)
  1474. copy(y[1:], []byte(m.proto[0:l]))
  1475. y = y[1+l:]
  1476. y[0] = byte(padding)
  1477. m.raw = x
  1478. return x
  1479. }
  1480. func (m *nextProtoMsg) unmarshal(data []byte) bool {
  1481. m.raw = data
  1482. if len(data) < 5 {
  1483. return false
  1484. }
  1485. data = data[4:]
  1486. protoLen := int(data[0])
  1487. data = data[1:]
  1488. if len(data) < protoLen {
  1489. return false
  1490. }
  1491. m.proto = string(data[0:protoLen])
  1492. data = data[protoLen:]
  1493. if len(data) < 1 {
  1494. return false
  1495. }
  1496. paddingLen := int(data[0])
  1497. data = data[1:]
  1498. if len(data) != paddingLen {
  1499. return false
  1500. }
  1501. return true
  1502. }
  1503. type certificateRequestMsg struct {
  1504. raw []byte
  1505. // hasSignatureAlgorithm indicates whether this message includes a list of
  1506. // supported signature algorithms. This change was introduced with TLS 1.2.
  1507. hasSignatureAlgorithm bool
  1508. certificateTypes []byte
  1509. supportedSignatureAlgorithms []SignatureScheme
  1510. certificateAuthorities [][]byte
  1511. }
  1512. func (m *certificateRequestMsg) marshal() (x []byte) {
  1513. if m.raw != nil {
  1514. return m.raw
  1515. }
  1516. // See RFC 4346, Section 7.4.4.
  1517. length := 1 + len(m.certificateTypes) + 2
  1518. casLength := 0
  1519. for _, ca := range m.certificateAuthorities {
  1520. casLength += 2 + len(ca)
  1521. }
  1522. length += casLength
  1523. if m.hasSignatureAlgorithm {
  1524. length += 2 + 2*len(m.supportedSignatureAlgorithms)
  1525. }
  1526. x = make([]byte, 4+length)
  1527. x[0] = typeCertificateRequest
  1528. x[1] = uint8(length >> 16)
  1529. x[2] = uint8(length >> 8)
  1530. x[3] = uint8(length)
  1531. x[4] = uint8(len(m.certificateTypes))
  1532. copy(x[5:], m.certificateTypes)
  1533. y := x[5+len(m.certificateTypes):]
  1534. if m.hasSignatureAlgorithm {
  1535. n := len(m.supportedSignatureAlgorithms) * 2
  1536. y[0] = uint8(n >> 8)
  1537. y[1] = uint8(n)
  1538. y = y[2:]
  1539. for _, sigAlgo := range m.supportedSignatureAlgorithms {
  1540. y[0] = uint8(sigAlgo >> 8)
  1541. y[1] = uint8(sigAlgo)
  1542. y = y[2:]
  1543. }
  1544. }
  1545. y[0] = uint8(casLength >> 8)
  1546. y[1] = uint8(casLength)
  1547. y = y[2:]
  1548. for _, ca := range m.certificateAuthorities {
  1549. y[0] = uint8(len(ca) >> 8)
  1550. y[1] = uint8(len(ca))
  1551. y = y[2:]
  1552. copy(y, ca)
  1553. y = y[len(ca):]
  1554. }
  1555. m.raw = x
  1556. return
  1557. }
  1558. func (m *certificateRequestMsg) unmarshal(data []byte) bool {
  1559. m.raw = data
  1560. if len(data) < 5 {
  1561. return false
  1562. }
  1563. length := uint32(data[1])<<16 | uint32(data[2])<<8 | uint32(data[3])
  1564. if uint32(len(data))-4 != length {
  1565. return false
  1566. }
  1567. numCertTypes := int(data[4])
  1568. data = data[5:]
  1569. if numCertTypes == 0 || len(data) <= numCertTypes {
  1570. return false
  1571. }
  1572. m.certificateTypes = make([]byte, numCertTypes)
  1573. if copy(m.certificateTypes, data) != numCertTypes {
  1574. return false
  1575. }
  1576. data = data[numCertTypes:]
  1577. if m.hasSignatureAlgorithm {
  1578. if len(data) < 2 {
  1579. return false
  1580. }
  1581. sigAndHashLen := uint16(data[0])<<8 | uint16(data[1])
  1582. data = data[2:]
  1583. if sigAndHashLen&1 != 0 {
  1584. return false
  1585. }
  1586. if len(data) < int(sigAndHashLen) {
  1587. return false
  1588. }
  1589. numSigAlgos := sigAndHashLen / 2
  1590. m.supportedSignatureAlgorithms = make([]SignatureScheme, numSigAlgos)
  1591. for i := range m.supportedSignatureAlgorithms {
  1592. m.supportedSignatureAlgorithms[i] = SignatureScheme(data[0])<<8 | SignatureScheme(data[1])
  1593. data = data[2:]
  1594. }
  1595. }
  1596. if len(data) < 2 {
  1597. return false
  1598. }
  1599. casLength := uint16(data[0])<<8 | uint16(data[1])
  1600. data = data[2:]
  1601. if len(data) < int(casLength) {
  1602. return false
  1603. }
  1604. cas := make([]byte, casLength)
  1605. copy(cas, data)
  1606. data = data[casLength:]
  1607. m.certificateAuthorities = nil
  1608. for len(cas) > 0 {
  1609. if len(cas) < 2 {
  1610. return false
  1611. }
  1612. caLen := uint16(cas[0])<<8 | uint16(cas[1])
  1613. cas = cas[2:]
  1614. if len(cas) < int(caLen) {
  1615. return false
  1616. }
  1617. m.certificateAuthorities = append(m.certificateAuthorities, cas[:caLen])
  1618. cas = cas[caLen:]
  1619. }
  1620. return len(data) == 0
  1621. }
  1622. type certificateVerifyMsg struct {
  1623. raw []byte
  1624. hasSignatureAlgorithm bool // format change introduced in TLS 1.2
  1625. signatureAlgorithm SignatureScheme
  1626. signature []byte
  1627. }
  1628. func (m *certificateVerifyMsg) marshal() (x []byte) {
  1629. if m.raw != nil {
  1630. return m.raw
  1631. }
  1632. var b cryptobyte.Builder
  1633. b.AddUint8(typeCertificateVerify)
  1634. b.AddUint24LengthPrefixed(func(b *cryptobyte.Builder) {
  1635. if m.hasSignatureAlgorithm {
  1636. b.AddUint16(uint16(m.signatureAlgorithm))
  1637. }
  1638. b.AddUint16LengthPrefixed(func(b *cryptobyte.Builder) {
  1639. b.AddBytes(m.signature)
  1640. })
  1641. })
  1642. m.raw = b.BytesOrPanic()
  1643. return m.raw
  1644. }
  1645. func (m *certificateVerifyMsg) unmarshal(data []byte) bool {
  1646. m.raw = data
  1647. s := cryptobyte.String(data)
  1648. if !s.Skip(4) { // message type and uint24 length field
  1649. return false
  1650. }
  1651. if m.hasSignatureAlgorithm {
  1652. if !s.ReadUint16((*uint16)(&m.signatureAlgorithm)) {
  1653. return false
  1654. }
  1655. }
  1656. return readUint16LengthPrefixed(&s, &m.signature) && s.Empty()
  1657. }
  1658. type newSessionTicketMsg struct {
  1659. raw []byte
  1660. ticket []byte
  1661. }
  1662. func (m *newSessionTicketMsg) marshal() (x []byte) {
  1663. if m.raw != nil {
  1664. return m.raw
  1665. }
  1666. // See RFC 5077, Section 3.3.
  1667. ticketLen := len(m.ticket)
  1668. length := 2 + 4 + ticketLen
  1669. x = make([]byte, 4+length)
  1670. x[0] = typeNewSessionTicket
  1671. x[1] = uint8(length >> 16)
  1672. x[2] = uint8(length >> 8)
  1673. x[3] = uint8(length)
  1674. x[8] = uint8(ticketLen >> 8)
  1675. x[9] = uint8(ticketLen)
  1676. copy(x[10:], m.ticket)
  1677. m.raw = x
  1678. return
  1679. }
  1680. func (m *newSessionTicketMsg) unmarshal(data []byte) bool {
  1681. m.raw = data
  1682. if len(data) < 10 {
  1683. return false
  1684. }
  1685. length := uint32(data[1])<<16 | uint32(data[2])<<8 | uint32(data[3])
  1686. if uint32(len(data))-4 != length {
  1687. return false
  1688. }
  1689. ticketLen := int(data[8])<<8 + int(data[9])
  1690. if len(data)-10 != ticketLen {
  1691. return false
  1692. }
  1693. m.ticket = data[10:]
  1694. return true
  1695. }
  1696. type helloRequestMsg struct {
  1697. }
  1698. func (*helloRequestMsg) marshal() []byte {
  1699. return []byte{typeHelloRequest, 0, 0, 0}
  1700. }
  1701. func (*helloRequestMsg) unmarshal(data []byte) bool {
  1702. return len(data) == 4
  1703. }