2
0

ssl_local.h 117 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043
  1. /*
  2. * Copyright 1995-2024 The OpenSSL Project Authors. All Rights Reserved.
  3. * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
  4. * Copyright 2005 Nokia. All rights reserved.
  5. *
  6. * Licensed under the Apache License 2.0 (the "License"). You may not use
  7. * this file except in compliance with the License. You can obtain a copy
  8. * in the file LICENSE in the source distribution or at
  9. * https://www.openssl.org/source/license.html
  10. */
  11. #ifndef OSSL_SSL_LOCAL_H
  12. # define OSSL_SSL_LOCAL_H
  13. # include "internal/e_os.h" /* struct timeval for DTLS */
  14. # include <stdlib.h>
  15. # include <time.h>
  16. # include <errno.h>
  17. # include "internal/common.h" /* for HAS_PREFIX */
  18. # include <openssl/buffer.h>
  19. # include <openssl/bio.h>
  20. # include <openssl/comp.h>
  21. # include <openssl/dsa.h>
  22. # include <openssl/err.h>
  23. # include <openssl/ssl.h>
  24. # include <openssl/async.h>
  25. # include <openssl/symhacks.h>
  26. # include <openssl/ct.h>
  27. # include "internal/recordmethod.h"
  28. # include "internal/statem.h"
  29. # include "internal/packet.h"
  30. # include "internal/dane.h"
  31. # include "internal/refcount.h"
  32. # include "internal/tsan_assist.h"
  33. # include "internal/bio.h"
  34. # include "internal/ktls.h"
  35. # include "internal/time.h"
  36. # include "internal/ssl.h"
  37. # include "internal/quic_predef.h"
  38. # include "record/record.h"
  39. # ifdef OPENSSL_BUILD_SHLIBSSL
  40. # undef OPENSSL_EXTERN
  41. # define OPENSSL_EXTERN OPENSSL_EXPORT
  42. # endif
  43. # define TLS_MAX_VERSION_INTERNAL TLS1_3_VERSION
  44. # define DTLS_MAX_VERSION_INTERNAL DTLS1_2_VERSION
  45. /*
  46. * DTLS version numbers are strange because they're inverted. Except for
  47. * DTLS1_BAD_VER, which should be considered "lower" than the rest.
  48. */
  49. # define dtls_ver_ordinal(v1) (((v1) == DTLS1_BAD_VER) ? 0xff00 : (v1))
  50. # define DTLS_VERSION_GT(v1, v2) (dtls_ver_ordinal(v1) < dtls_ver_ordinal(v2))
  51. # define DTLS_VERSION_GE(v1, v2) (dtls_ver_ordinal(v1) <= dtls_ver_ordinal(v2))
  52. # define DTLS_VERSION_LT(v1, v2) (dtls_ver_ordinal(v1) > dtls_ver_ordinal(v2))
  53. # define DTLS_VERSION_LE(v1, v2) (dtls_ver_ordinal(v1) >= dtls_ver_ordinal(v2))
  54. # define SSL_AD_NO_ALERT -1
  55. /*
  56. * Define the Bitmasks for SSL_CIPHER.algorithms.
  57. * This bits are used packed as dense as possible. If new methods/ciphers
  58. * etc will be added, the bits a likely to change, so this information
  59. * is for internal library use only, even though SSL_CIPHER.algorithms
  60. * can be publicly accessed.
  61. * Use the according functions for cipher management instead.
  62. *
  63. * The bit mask handling in the selection and sorting scheme in
  64. * ssl_create_cipher_list() has only limited capabilities, reflecting
  65. * that the different entities within are mutually exclusive:
  66. * ONLY ONE BIT PER MASK CAN BE SET AT A TIME.
  67. */
  68. /* Bits for algorithm_mkey (key exchange algorithm) */
  69. /* RSA key exchange */
  70. # define SSL_kRSA 0x00000001U
  71. /* tmp DH key no DH cert */
  72. # define SSL_kDHE 0x00000002U
  73. /* synonym */
  74. # define SSL_kEDH SSL_kDHE
  75. /* ephemeral ECDH */
  76. # define SSL_kECDHE 0x00000004U
  77. /* synonym */
  78. # define SSL_kEECDH SSL_kECDHE
  79. /* PSK */
  80. # define SSL_kPSK 0x00000008U
  81. /* GOST key exchange */
  82. # define SSL_kGOST 0x00000010U
  83. /* SRP */
  84. # define SSL_kSRP 0x00000020U
  85. # define SSL_kRSAPSK 0x00000040U
  86. # define SSL_kECDHEPSK 0x00000080U
  87. # define SSL_kDHEPSK 0x00000100U
  88. /* GOST KDF key exchange, draft-smyshlyaev-tls12-gost-suites */
  89. # define SSL_kGOST18 0x00000200U
  90. /* all PSK */
  91. # define SSL_PSK (SSL_kPSK | SSL_kRSAPSK | SSL_kECDHEPSK | SSL_kDHEPSK)
  92. /* Any appropriate key exchange algorithm (for TLS 1.3 ciphersuites) */
  93. # define SSL_kANY 0x00000000U
  94. /* Bits for algorithm_auth (server authentication) */
  95. /* RSA auth */
  96. # define SSL_aRSA 0x00000001U
  97. /* DSS auth */
  98. # define SSL_aDSS 0x00000002U
  99. /* no auth (i.e. use ADH or AECDH) */
  100. # define SSL_aNULL 0x00000004U
  101. /* ECDSA auth*/
  102. # define SSL_aECDSA 0x00000008U
  103. /* PSK auth */
  104. # define SSL_aPSK 0x00000010U
  105. /* GOST R 34.10-2001 signature auth */
  106. # define SSL_aGOST01 0x00000020U
  107. /* SRP auth */
  108. # define SSL_aSRP 0x00000040U
  109. /* GOST R 34.10-2012 signature auth */
  110. # define SSL_aGOST12 0x00000080U
  111. /* Any appropriate signature auth (for TLS 1.3 ciphersuites) */
  112. # define SSL_aANY 0x00000000U
  113. /* All bits requiring a certificate */
  114. #define SSL_aCERT \
  115. (SSL_aRSA | SSL_aDSS | SSL_aECDSA | SSL_aGOST01 | SSL_aGOST12)
  116. /* Bits for algorithm_enc (symmetric encryption) */
  117. # define SSL_DES 0x00000001U
  118. # define SSL_3DES 0x00000002U
  119. # define SSL_RC4 0x00000004U
  120. # define SSL_RC2 0x00000008U
  121. # define SSL_IDEA 0x00000010U
  122. # define SSL_eNULL 0x00000020U
  123. # define SSL_AES128 0x00000040U
  124. # define SSL_AES256 0x00000080U
  125. # define SSL_CAMELLIA128 0x00000100U
  126. # define SSL_CAMELLIA256 0x00000200U
  127. # define SSL_eGOST2814789CNT 0x00000400U
  128. # define SSL_SEED 0x00000800U
  129. # define SSL_AES128GCM 0x00001000U
  130. # define SSL_AES256GCM 0x00002000U
  131. # define SSL_AES128CCM 0x00004000U
  132. # define SSL_AES256CCM 0x00008000U
  133. # define SSL_AES128CCM8 0x00010000U
  134. # define SSL_AES256CCM8 0x00020000U
  135. # define SSL_eGOST2814789CNT12 0x00040000U
  136. # define SSL_CHACHA20POLY1305 0x00080000U
  137. # define SSL_ARIA128GCM 0x00100000U
  138. # define SSL_ARIA256GCM 0x00200000U
  139. # define SSL_MAGMA 0x00400000U
  140. # define SSL_KUZNYECHIK 0x00800000U
  141. # define SSL_AESGCM (SSL_AES128GCM | SSL_AES256GCM)
  142. # define SSL_AESCCM (SSL_AES128CCM | SSL_AES256CCM | SSL_AES128CCM8 | SSL_AES256CCM8)
  143. # define SSL_AES (SSL_AES128|SSL_AES256|SSL_AESGCM|SSL_AESCCM)
  144. # define SSL_CAMELLIA (SSL_CAMELLIA128|SSL_CAMELLIA256)
  145. # define SSL_CHACHA20 (SSL_CHACHA20POLY1305)
  146. # define SSL_ARIAGCM (SSL_ARIA128GCM | SSL_ARIA256GCM)
  147. # define SSL_ARIA (SSL_ARIAGCM)
  148. # define SSL_CBC (SSL_DES | SSL_3DES | SSL_RC2 | SSL_IDEA \
  149. | SSL_AES128 | SSL_AES256 | SSL_CAMELLIA128 \
  150. | SSL_CAMELLIA256 | SSL_SEED)
  151. /* Bits for algorithm_mac (symmetric authentication) */
  152. # define SSL_MD5 0x00000001U
  153. # define SSL_SHA1 0x00000002U
  154. # define SSL_GOST94 0x00000004U
  155. # define SSL_GOST89MAC 0x00000008U
  156. # define SSL_SHA256 0x00000010U
  157. # define SSL_SHA384 0x00000020U
  158. /* Not a real MAC, just an indication it is part of cipher */
  159. # define SSL_AEAD 0x00000040U
  160. # define SSL_GOST12_256 0x00000080U
  161. # define SSL_GOST89MAC12 0x00000100U
  162. # define SSL_GOST12_512 0x00000200U
  163. # define SSL_MAGMAOMAC 0x00000400U
  164. # define SSL_KUZNYECHIKOMAC 0x00000800U
  165. /*
  166. * When adding new digest in the ssl_ciph.c and increment SSL_MD_NUM_IDX make
  167. * sure to update this constant too
  168. */
  169. # define SSL_MD_MD5_IDX 0
  170. # define SSL_MD_SHA1_IDX 1
  171. # define SSL_MD_GOST94_IDX 2
  172. # define SSL_MD_GOST89MAC_IDX 3
  173. # define SSL_MD_SHA256_IDX 4
  174. # define SSL_MD_SHA384_IDX 5
  175. # define SSL_MD_GOST12_256_IDX 6
  176. # define SSL_MD_GOST89MAC12_IDX 7
  177. # define SSL_MD_GOST12_512_IDX 8
  178. # define SSL_MD_MD5_SHA1_IDX 9
  179. # define SSL_MD_SHA224_IDX 10
  180. # define SSL_MD_SHA512_IDX 11
  181. # define SSL_MD_MAGMAOMAC_IDX 12
  182. # define SSL_MD_KUZNYECHIKOMAC_IDX 13
  183. # define SSL_MAX_DIGEST 14
  184. #define SSL_MD_NUM_IDX SSL_MAX_DIGEST
  185. /* Bits for algorithm2 (handshake digests and other extra flags) */
  186. /* Bits 0-7 are handshake MAC */
  187. # define SSL_HANDSHAKE_MAC_MASK 0xFF
  188. # define SSL_HANDSHAKE_MAC_MD5_SHA1 SSL_MD_MD5_SHA1_IDX
  189. # define SSL_HANDSHAKE_MAC_SHA256 SSL_MD_SHA256_IDX
  190. # define SSL_HANDSHAKE_MAC_SHA384 SSL_MD_SHA384_IDX
  191. # define SSL_HANDSHAKE_MAC_GOST94 SSL_MD_GOST94_IDX
  192. # define SSL_HANDSHAKE_MAC_GOST12_256 SSL_MD_GOST12_256_IDX
  193. # define SSL_HANDSHAKE_MAC_GOST12_512 SSL_MD_GOST12_512_IDX
  194. # define SSL_HANDSHAKE_MAC_DEFAULT SSL_HANDSHAKE_MAC_MD5_SHA1
  195. /* Bits 8-15 bits are PRF */
  196. # define TLS1_PRF_DGST_SHIFT 8
  197. # define TLS1_PRF_SHA1_MD5 (SSL_MD_MD5_SHA1_IDX << TLS1_PRF_DGST_SHIFT)
  198. # define TLS1_PRF_SHA256 (SSL_MD_SHA256_IDX << TLS1_PRF_DGST_SHIFT)
  199. # define TLS1_PRF_SHA384 (SSL_MD_SHA384_IDX << TLS1_PRF_DGST_SHIFT)
  200. # define TLS1_PRF_GOST94 (SSL_MD_GOST94_IDX << TLS1_PRF_DGST_SHIFT)
  201. # define TLS1_PRF_GOST12_256 (SSL_MD_GOST12_256_IDX << TLS1_PRF_DGST_SHIFT)
  202. # define TLS1_PRF_GOST12_512 (SSL_MD_GOST12_512_IDX << TLS1_PRF_DGST_SHIFT)
  203. # define TLS1_PRF (SSL_MD_MD5_SHA1_IDX << TLS1_PRF_DGST_SHIFT)
  204. /*
  205. * Stream MAC for GOST ciphersuites from cryptopro draft (currently this also
  206. * goes into algorithm2)
  207. */
  208. # define TLS1_STREAM_MAC 0x10000
  209. /*
  210. * TLSTREE cipher/mac key derivation from draft-smyshlyaev-tls12-gost-suites
  211. * (currently this also goes into algorithm2)
  212. */
  213. # define TLS1_TLSTREE 0x20000
  214. /* Ciphersuite supported in QUIC */
  215. # define SSL_QUIC 0x00040000U
  216. # define SSL_STRONG_MASK 0x0000001FU
  217. # define SSL_DEFAULT_MASK 0X00000020U
  218. # define SSL_STRONG_NONE 0x00000001U
  219. # define SSL_LOW 0x00000002U
  220. # define SSL_MEDIUM 0x00000004U
  221. # define SSL_HIGH 0x00000008U
  222. # define SSL_FIPS 0x00000010U
  223. # define SSL_NOT_DEFAULT 0x00000020U
  224. /* we have used 0000003f - 26 bits left to go */
  225. /* Flag used on OpenSSL ciphersuite ids to indicate they are for SSLv3+ */
  226. # define SSL3_CK_CIPHERSUITE_FLAG 0x03000000
  227. /* Check if an SSL structure is using DTLS */
  228. # define SSL_CONNECTION_IS_DTLS(s) \
  229. (SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS)
  230. /* Check if we are using TLSv1.3 */
  231. # define SSL_CONNECTION_IS_TLS13(s) (!SSL_CONNECTION_IS_DTLS(s) \
  232. && SSL_CONNECTION_GET_SSL(s)->method->version >= TLS1_3_VERSION \
  233. && SSL_CONNECTION_GET_SSL(s)->method->version != TLS_ANY_VERSION)
  234. # define SSL_CONNECTION_TREAT_AS_TLS13(s) \
  235. (SSL_CONNECTION_IS_TLS13(s) \
  236. || (s)->early_data_state == SSL_EARLY_DATA_CONNECTING \
  237. || (s)->early_data_state == SSL_EARLY_DATA_CONNECT_RETRY \
  238. || (s)->early_data_state == SSL_EARLY_DATA_WRITING \
  239. || (s)->early_data_state == SSL_EARLY_DATA_WRITE_RETRY \
  240. || (s)->hello_retry_request == SSL_HRR_PENDING)
  241. # define SSL_IS_FIRST_HANDSHAKE(s) ((s)->s3.tmp.finish_md_len == 0 \
  242. || (s)->s3.tmp.peer_finish_md_len == 0)
  243. /* See if we need explicit IV */
  244. # define SSL_USE_EXPLICIT_IV(s) \
  245. (SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_EXPLICIT_IV)
  246. /*
  247. * See if we use signature algorithms extension and signature algorithm
  248. * before signatures.
  249. */
  250. # define SSL_USE_SIGALGS(s) \
  251. (SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_SIGALGS)
  252. /*
  253. * Allow TLS 1.2 ciphersuites: applies to DTLS 1.2 as well as TLS 1.2: may
  254. * apply to others in future.
  255. */
  256. # define SSL_USE_TLS1_2_CIPHERS(s) \
  257. (SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_TLS1_2_CIPHERS)
  258. /*
  259. * Determine if a client can use TLS 1.2 ciphersuites: can't rely on method
  260. * flags because it may not be set to correct version yet.
  261. */
  262. # define SSL_CLIENT_USE_TLS1_2_CIPHERS(s) \
  263. ((!SSL_CONNECTION_IS_DTLS(s) && s->client_version >= TLS1_2_VERSION) || \
  264. (SSL_CONNECTION_IS_DTLS(s) && DTLS_VERSION_GE(s->client_version, DTLS1_2_VERSION)))
  265. /*
  266. * Determine if a client should send signature algorithms extension:
  267. * as with TLS1.2 cipher we can't rely on method flags.
  268. */
  269. # define SSL_CLIENT_USE_SIGALGS(s) \
  270. SSL_CLIENT_USE_TLS1_2_CIPHERS(s)
  271. # define IS_MAX_FRAGMENT_LENGTH_EXT_VALID(value) \
  272. (((value) >= TLSEXT_max_fragment_length_512) && \
  273. ((value) <= TLSEXT_max_fragment_length_4096))
  274. # define USE_MAX_FRAGMENT_LENGTH_EXT(session) \
  275. IS_MAX_FRAGMENT_LENGTH_EXT_VALID(session->ext.max_fragment_len_mode)
  276. # define GET_MAX_FRAGMENT_LENGTH(session) \
  277. (512U << (session->ext.max_fragment_len_mode - 1))
  278. # define SSL_READ_ETM(s) (s->s3.flags & TLS1_FLAGS_ENCRYPT_THEN_MAC_READ)
  279. # define SSL_WRITE_ETM(s) (s->s3.flags & TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE)
  280. # define SSL_IS_QUIC_HANDSHAKE(s) (((s)->s3.flags & TLS1_FLAGS_QUIC) != 0)
  281. /* alert_dispatch values */
  282. /* No alert pending */
  283. # define SSL_ALERT_DISPATCH_NONE 0
  284. /* Alert pending */
  285. # define SSL_ALERT_DISPATCH_PENDING 1
  286. /* Pending alert write needs to be retried */
  287. # define SSL_ALERT_DISPATCH_RETRY 2
  288. /* Mostly for SSLv3 */
  289. # define SSL_PKEY_RSA 0
  290. # define SSL_PKEY_RSA_PSS_SIGN 1
  291. # define SSL_PKEY_DSA_SIGN 2
  292. # define SSL_PKEY_ECC 3
  293. # define SSL_PKEY_GOST01 4
  294. # define SSL_PKEY_GOST12_256 5
  295. # define SSL_PKEY_GOST12_512 6
  296. # define SSL_PKEY_ED25519 7
  297. # define SSL_PKEY_ED448 8
  298. # define SSL_PKEY_NUM 9
  299. # define SSL_ENC_DES_IDX 0
  300. # define SSL_ENC_3DES_IDX 1
  301. # define SSL_ENC_RC4_IDX 2
  302. # define SSL_ENC_RC2_IDX 3
  303. # define SSL_ENC_IDEA_IDX 4
  304. # define SSL_ENC_NULL_IDX 5
  305. # define SSL_ENC_AES128_IDX 6
  306. # define SSL_ENC_AES256_IDX 7
  307. # define SSL_ENC_CAMELLIA128_IDX 8
  308. # define SSL_ENC_CAMELLIA256_IDX 9
  309. # define SSL_ENC_GOST89_IDX 10
  310. # define SSL_ENC_SEED_IDX 11
  311. # define SSL_ENC_AES128GCM_IDX 12
  312. # define SSL_ENC_AES256GCM_IDX 13
  313. # define SSL_ENC_AES128CCM_IDX 14
  314. # define SSL_ENC_AES256CCM_IDX 15
  315. # define SSL_ENC_AES128CCM8_IDX 16
  316. # define SSL_ENC_AES256CCM8_IDX 17
  317. # define SSL_ENC_GOST8912_IDX 18
  318. # define SSL_ENC_CHACHA_IDX 19
  319. # define SSL_ENC_ARIA128GCM_IDX 20
  320. # define SSL_ENC_ARIA256GCM_IDX 21
  321. # define SSL_ENC_MAGMA_IDX 22
  322. # define SSL_ENC_KUZNYECHIK_IDX 23
  323. # define SSL_ENC_NUM_IDX 24
  324. /*-
  325. * SSL_kRSA <- RSA_ENC
  326. * SSL_kDH <- DH_ENC & (RSA_ENC | RSA_SIGN | DSA_SIGN)
  327. * SSL_kDHE <- RSA_ENC | RSA_SIGN | DSA_SIGN
  328. * SSL_aRSA <- RSA_ENC | RSA_SIGN
  329. * SSL_aDSS <- DSA_SIGN
  330. */
  331. /*-
  332. #define CERT_INVALID 0
  333. #define CERT_PUBLIC_KEY 1
  334. #define CERT_PRIVATE_KEY 2
  335. */
  336. /* Certificate Type State */
  337. # define OSSL_CERT_TYPE_CTOS_NONE 0
  338. # define OSSL_CERT_TYPE_CTOS_GOOD 1
  339. # define OSSL_CERT_TYPE_CTOS_ERROR 2
  340. /* Post-Handshake Authentication state */
  341. typedef enum {
  342. SSL_PHA_NONE = 0,
  343. SSL_PHA_EXT_SENT, /* client-side only: extension sent */
  344. SSL_PHA_EXT_RECEIVED, /* server-side only: extension received */
  345. SSL_PHA_REQUEST_PENDING, /* server-side only: request pending */
  346. SSL_PHA_REQUESTED /* request received by client, or sent by server */
  347. } SSL_PHA_STATE;
  348. /* CipherSuite length. SSLv3 and all TLS versions. */
  349. # define TLS_CIPHER_LEN 2
  350. /* used to hold info on the particular ciphers used */
  351. struct ssl_cipher_st {
  352. uint32_t valid;
  353. const char *name; /* text name */
  354. const char *stdname; /* RFC name */
  355. uint32_t id; /* id, 4 bytes, first is version */
  356. /*
  357. * changed in 1.0.0: these four used to be portions of a single value
  358. * 'algorithms'
  359. */
  360. uint32_t algorithm_mkey; /* key exchange algorithm */
  361. uint32_t algorithm_auth; /* server authentication */
  362. uint32_t algorithm_enc; /* symmetric encryption */
  363. uint32_t algorithm_mac; /* symmetric authentication */
  364. int min_tls; /* minimum SSL/TLS protocol version */
  365. int max_tls; /* maximum SSL/TLS protocol version */
  366. int min_dtls; /* minimum DTLS protocol version */
  367. int max_dtls; /* maximum DTLS protocol version */
  368. uint32_t algo_strength; /* strength and export flags */
  369. uint32_t algorithm2; /* Extra flags */
  370. int32_t strength_bits; /* Number of bits really used */
  371. uint32_t alg_bits; /* Number of bits for algorithm */
  372. };
  373. /* Used to hold SSL/TLS functions */
  374. struct ssl_method_st {
  375. int version;
  376. unsigned flags;
  377. unsigned long mask;
  378. SSL *(*ssl_new) (SSL_CTX *ctx);
  379. void (*ssl_free) (SSL *s);
  380. int (*ssl_reset) (SSL *s);
  381. int (*ssl_init) (SSL *s);
  382. int (*ssl_clear) (SSL *s);
  383. void (*ssl_deinit) (SSL *s);
  384. int (*ssl_accept) (SSL *s);
  385. int (*ssl_connect) (SSL *s);
  386. int (*ssl_read) (SSL *s, void *buf, size_t len, size_t *readbytes);
  387. int (*ssl_peek) (SSL *s, void *buf, size_t len, size_t *readbytes);
  388. int (*ssl_write) (SSL *s, const void *buf, size_t len, size_t *written);
  389. int (*ssl_shutdown) (SSL *s);
  390. int (*ssl_renegotiate) (SSL *s);
  391. int (*ssl_renegotiate_check) (SSL *s, int);
  392. int (*ssl_read_bytes) (SSL *s, uint8_t type, uint8_t *recvd_type,
  393. unsigned char *buf, size_t len, int peek,
  394. size_t *readbytes);
  395. int (*ssl_write_bytes) (SSL *s, uint8_t type, const void *buf_, size_t len,
  396. size_t *written);
  397. int (*ssl_dispatch_alert) (SSL *s);
  398. long (*ssl_ctrl) (SSL *s, int cmd, long larg, void *parg);
  399. long (*ssl_ctx_ctrl) (SSL_CTX *ctx, int cmd, long larg, void *parg);
  400. const SSL_CIPHER *(*get_cipher_by_char) (const unsigned char *ptr);
  401. int (*put_cipher_by_char) (const SSL_CIPHER *cipher, WPACKET *pkt,
  402. size_t *len);
  403. size_t (*ssl_pending) (const SSL *s);
  404. int (*num_ciphers) (void);
  405. const SSL_CIPHER *(*get_cipher) (unsigned ncipher);
  406. OSSL_TIME (*get_timeout) (void);
  407. const struct ssl3_enc_method *ssl3_enc; /* Extra SSLv3/TLS stuff */
  408. int (*ssl_version) (void);
  409. long (*ssl_callback_ctrl) (SSL *s, int cb_id, void (*fp) (void));
  410. long (*ssl_ctx_callback_ctrl) (SSL_CTX *s, int cb_id, void (*fp) (void));
  411. };
  412. /*
  413. * Matches the length of PSK_MAX_PSK_LEN. We keep it the same value for
  414. * consistency, even in the event of OPENSSL_NO_PSK being defined.
  415. */
  416. # define TLS13_MAX_RESUMPTION_PSK_LENGTH 512
  417. /*-
  418. * Lets make this into an ASN.1 type structure as follows
  419. * SSL_SESSION_ID ::= SEQUENCE {
  420. * version INTEGER, -- structure version number
  421. * SSLversion INTEGER, -- SSL version number
  422. * Cipher OCTET STRING, -- the 3 byte cipher ID
  423. * Session_ID OCTET STRING, -- the Session ID
  424. * Master_key OCTET STRING, -- the master key
  425. * Key_Arg [ 0 ] IMPLICIT OCTET STRING, -- the optional Key argument
  426. * Time [ 1 ] EXPLICIT INTEGER, -- optional Start Time
  427. * Timeout [ 2 ] EXPLICIT INTEGER, -- optional Timeout ins seconds
  428. * Peer [ 3 ] EXPLICIT X509, -- optional Peer Certificate
  429. * Session_ID_context [ 4 ] EXPLICIT OCTET STRING, -- the Session ID context
  430. * Verify_result [ 5 ] EXPLICIT INTEGER, -- X509_V_... code for `Peer'
  431. * HostName [ 6 ] EXPLICIT OCTET STRING, -- optional HostName from servername TLS extension
  432. * PSK_identity_hint [ 7 ] EXPLICIT OCTET STRING, -- optional PSK identity hint
  433. * PSK_identity [ 8 ] EXPLICIT OCTET STRING, -- optional PSK identity
  434. * Ticket_lifetime_hint [9] EXPLICIT INTEGER, -- server's lifetime hint for session ticket
  435. * Ticket [10] EXPLICIT OCTET STRING, -- session ticket (clients only)
  436. * Compression_meth [11] EXPLICIT OCTET STRING, -- optional compression method
  437. * SRP_username [ 12 ] EXPLICIT OCTET STRING -- optional SRP username
  438. * flags [ 13 ] EXPLICIT INTEGER -- optional flags
  439. * }
  440. * Look in ssl/ssl_asn1.c for more details
  441. * I'm using EXPLICIT tags so I can read the damn things using asn1parse :-).
  442. */
  443. struct ssl_session_st {
  444. int ssl_version; /* what ssl version session info is being kept
  445. * in here? */
  446. size_t master_key_length;
  447. /* TLSv1.3 early_secret used for external PSKs */
  448. unsigned char early_secret[EVP_MAX_MD_SIZE];
  449. /*
  450. * For <=TLS1.2 this is the master_key. For TLS1.3 this is the resumption
  451. * PSK
  452. */
  453. unsigned char master_key[TLS13_MAX_RESUMPTION_PSK_LENGTH];
  454. /* session_id - valid? */
  455. size_t session_id_length;
  456. unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
  457. /*
  458. * this is used to determine whether the session is being reused in the
  459. * appropriate context. It is up to the application to set this, via
  460. * SSL_new
  461. */
  462. size_t sid_ctx_length;
  463. unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
  464. # ifndef OPENSSL_NO_PSK
  465. char *psk_identity_hint;
  466. char *psk_identity;
  467. # endif
  468. /*
  469. * Used to indicate that session resumption is not allowed. Applications
  470. * can also set this bit for a new session via not_resumable_session_cb
  471. * to disable session caching and tickets.
  472. */
  473. int not_resumable;
  474. /* Peer raw public key, if available */
  475. EVP_PKEY *peer_rpk;
  476. /* This is the cert and type for the other end. */
  477. X509 *peer;
  478. /* Certificate chain peer sent. */
  479. STACK_OF(X509) *peer_chain;
  480. /*
  481. * when app_verify_callback accepts a session where the peer's
  482. * certificate is not ok, we must remember the error for session reuse:
  483. */
  484. long verify_result; /* only for servers */
  485. CRYPTO_REF_COUNT references;
  486. OSSL_TIME timeout;
  487. OSSL_TIME time;
  488. OSSL_TIME calc_timeout;
  489. unsigned int compress_meth; /* Need to lookup the method */
  490. const SSL_CIPHER *cipher;
  491. unsigned long cipher_id; /* when ASN.1 loaded, this needs to be used to
  492. * load the 'cipher' structure */
  493. unsigned int kex_group; /* TLS group from key exchange */
  494. CRYPTO_EX_DATA ex_data; /* application specific data */
  495. /*
  496. * These are used to make removal of session-ids more efficient and to
  497. * implement a maximum cache size.
  498. */
  499. struct ssl_session_st *prev, *next;
  500. struct {
  501. char *hostname;
  502. /* RFC4507 info */
  503. unsigned char *tick; /* Session ticket */
  504. size_t ticklen; /* Session ticket length */
  505. /* Session lifetime hint in seconds */
  506. unsigned long tick_lifetime_hint;
  507. uint32_t tick_age_add;
  508. /* Max number of bytes that can be sent as early data */
  509. uint32_t max_early_data;
  510. /* The ALPN protocol selected for this session */
  511. unsigned char *alpn_selected;
  512. size_t alpn_selected_len;
  513. /*
  514. * Maximum Fragment Length as per RFC 4366.
  515. * If this value does not contain RFC 4366 allowed values (1-4) then
  516. * either the Maximum Fragment Length Negotiation failed or was not
  517. * performed at all.
  518. */
  519. uint8_t max_fragment_len_mode;
  520. } ext;
  521. # ifndef OPENSSL_NO_SRP
  522. char *srp_username;
  523. # endif
  524. unsigned char *ticket_appdata;
  525. size_t ticket_appdata_len;
  526. uint32_t flags;
  527. SSL_CTX *owner;
  528. };
  529. /* Extended master secret support */
  530. # define SSL_SESS_FLAG_EXTMS 0x1
  531. # ifndef OPENSSL_NO_SRP
  532. typedef struct srp_ctx_st {
  533. /* param for all the callbacks */
  534. void *SRP_cb_arg;
  535. /* set client Hello login callback */
  536. int (*TLS_ext_srp_username_callback) (SSL *, int *, void *);
  537. /* set SRP N/g param callback for verification */
  538. int (*SRP_verify_param_callback) (SSL *, void *);
  539. /* set SRP client passwd callback */
  540. char *(*SRP_give_srp_client_pwd_callback) (SSL *, void *);
  541. char *login;
  542. BIGNUM *N, *g, *s, *B, *A;
  543. BIGNUM *a, *b, *v;
  544. char *info;
  545. int strength;
  546. unsigned long srp_Mask;
  547. } SRP_CTX;
  548. # endif
  549. typedef enum {
  550. SSL_EARLY_DATA_NONE = 0,
  551. SSL_EARLY_DATA_CONNECT_RETRY,
  552. SSL_EARLY_DATA_CONNECTING,
  553. SSL_EARLY_DATA_WRITE_RETRY,
  554. SSL_EARLY_DATA_WRITING,
  555. SSL_EARLY_DATA_WRITE_FLUSH,
  556. SSL_EARLY_DATA_UNAUTH_WRITING,
  557. SSL_EARLY_DATA_FINISHED_WRITING,
  558. SSL_EARLY_DATA_ACCEPT_RETRY,
  559. SSL_EARLY_DATA_ACCEPTING,
  560. SSL_EARLY_DATA_READ_RETRY,
  561. SSL_EARLY_DATA_READING,
  562. SSL_EARLY_DATA_FINISHED_READING
  563. } SSL_EARLY_DATA_STATE;
  564. /*
  565. * We check that the amount of unreadable early data doesn't exceed
  566. * max_early_data. max_early_data is given in plaintext bytes. However if it is
  567. * unreadable then we only know the number of ciphertext bytes. We also don't
  568. * know how much the overhead should be because it depends on the ciphersuite.
  569. * We make a small allowance. We assume 5 records of actual data plus the end
  570. * of early data alert record. Each record has a tag and a content type byte.
  571. * The longest tag length we know of is EVP_GCM_TLS_TAG_LEN. We don't count the
  572. * content of the alert record either which is 2 bytes.
  573. */
  574. # define EARLY_DATA_CIPHERTEXT_OVERHEAD ((6 * (EVP_GCM_TLS_TAG_LEN + 1)) + 2)
  575. /*
  576. * The allowance we have between the client's calculated ticket age and our own.
  577. * We allow for 10 seconds. If a ticket is presented and the
  578. * client's age calculation is different by more than this than our own then we
  579. * do not allow that ticket for early_data.
  580. */
  581. # define TICKET_AGE_ALLOWANCE ossl_seconds2time(10)
  582. #define MAX_COMPRESSIONS_SIZE 255
  583. struct ssl_comp_st {
  584. int id;
  585. const char *name;
  586. COMP_METHOD *method;
  587. };
  588. typedef struct raw_extension_st {
  589. /* Raw packet data for the extension */
  590. PACKET data;
  591. /* Set to 1 if the extension is present or 0 otherwise */
  592. int present;
  593. /* Set to 1 if we have already parsed the extension or 0 otherwise */
  594. int parsed;
  595. /* The type of this extension, i.e. a TLSEXT_TYPE_* value */
  596. unsigned int type;
  597. /* Track what order extensions are received in (0-based). */
  598. size_t received_order;
  599. } RAW_EXTENSION;
  600. typedef struct {
  601. unsigned int isv2;
  602. unsigned int legacy_version;
  603. unsigned char random[SSL3_RANDOM_SIZE];
  604. size_t session_id_len;
  605. unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
  606. size_t dtls_cookie_len;
  607. unsigned char dtls_cookie[DTLS1_COOKIE_LENGTH];
  608. PACKET ciphersuites;
  609. size_t compressions_len;
  610. unsigned char compressions[MAX_COMPRESSIONS_SIZE];
  611. PACKET extensions;
  612. size_t pre_proc_exts_len;
  613. RAW_EXTENSION *pre_proc_exts;
  614. } CLIENTHELLO_MSG;
  615. /*
  616. * Extension index values NOTE: Any updates to these defines should be mirrored
  617. * with equivalent updates to ext_defs in extensions.c
  618. */
  619. typedef enum tlsext_index_en {
  620. TLSEXT_IDX_renegotiate,
  621. TLSEXT_IDX_server_name,
  622. TLSEXT_IDX_max_fragment_length,
  623. TLSEXT_IDX_srp,
  624. TLSEXT_IDX_ec_point_formats,
  625. TLSEXT_IDX_supported_groups,
  626. TLSEXT_IDX_session_ticket,
  627. TLSEXT_IDX_status_request,
  628. TLSEXT_IDX_next_proto_neg,
  629. TLSEXT_IDX_application_layer_protocol_negotiation,
  630. TLSEXT_IDX_use_srtp,
  631. TLSEXT_IDX_encrypt_then_mac,
  632. TLSEXT_IDX_signed_certificate_timestamp,
  633. TLSEXT_IDX_extended_master_secret,
  634. TLSEXT_IDX_signature_algorithms_cert,
  635. TLSEXT_IDX_post_handshake_auth,
  636. TLSEXT_IDX_client_cert_type,
  637. TLSEXT_IDX_server_cert_type,
  638. TLSEXT_IDX_signature_algorithms,
  639. TLSEXT_IDX_supported_versions,
  640. TLSEXT_IDX_psk_kex_modes,
  641. TLSEXT_IDX_key_share,
  642. TLSEXT_IDX_cookie,
  643. TLSEXT_IDX_cryptopro_bug,
  644. TLSEXT_IDX_compress_certificate,
  645. TLSEXT_IDX_early_data,
  646. TLSEXT_IDX_certificate_authorities,
  647. TLSEXT_IDX_padding,
  648. TLSEXT_IDX_psk,
  649. /* Dummy index - must always be the last entry */
  650. TLSEXT_IDX_num_builtins
  651. } TLSEXT_INDEX;
  652. DEFINE_LHASH_OF_EX(SSL_SESSION);
  653. /* Needed in ssl_cert.c */
  654. DEFINE_LHASH_OF_EX(X509_NAME);
  655. # define TLSEXT_KEYNAME_LENGTH 16
  656. # define TLSEXT_TICK_KEY_LENGTH 32
  657. typedef struct ssl_ctx_ext_secure_st {
  658. unsigned char tick_hmac_key[TLSEXT_TICK_KEY_LENGTH];
  659. unsigned char tick_aes_key[TLSEXT_TICK_KEY_LENGTH];
  660. } SSL_CTX_EXT_SECURE;
  661. /*
  662. * Helper function for HMAC
  663. * The structure should be considered opaque, it will change once the low
  664. * level deprecated calls are removed. At that point it can be replaced
  665. * by EVP_MAC_CTX and most of the functions converted to macros or inlined
  666. * directly.
  667. */
  668. typedef struct ssl_hmac_st {
  669. EVP_MAC_CTX *ctx;
  670. # ifndef OPENSSL_NO_DEPRECATED_3_0
  671. HMAC_CTX *old_ctx;
  672. # endif
  673. } SSL_HMAC;
  674. SSL_HMAC *ssl_hmac_new(const SSL_CTX *ctx);
  675. void ssl_hmac_free(SSL_HMAC *ctx);
  676. # ifndef OPENSSL_NO_DEPRECATED_3_0
  677. HMAC_CTX *ssl_hmac_get0_HMAC_CTX(SSL_HMAC *ctx);
  678. # endif
  679. EVP_MAC_CTX *ssl_hmac_get0_EVP_MAC_CTX(SSL_HMAC *ctx);
  680. int ssl_hmac_init(SSL_HMAC *ctx, void *key, size_t len, char *md);
  681. int ssl_hmac_update(SSL_HMAC *ctx, const unsigned char *data, size_t len);
  682. int ssl_hmac_final(SSL_HMAC *ctx, unsigned char *md, size_t *len,
  683. size_t max_size);
  684. size_t ssl_hmac_size(const SSL_HMAC *ctx);
  685. int ssl_get_EC_curve_nid(const EVP_PKEY *pkey);
  686. __owur int tls13_set_encoded_pub_key(EVP_PKEY *pkey,
  687. const unsigned char *enckey,
  688. size_t enckeylen);
  689. typedef struct tls_group_info_st {
  690. char *tlsname; /* Curve Name as in TLS specs */
  691. char *realname; /* Curve Name according to provider */
  692. char *algorithm; /* Algorithm name to fetch */
  693. unsigned int secbits; /* Bits of security (from SP800-57) */
  694. uint16_t group_id; /* Group ID */
  695. int mintls; /* Minimum TLS version, -1 unsupported */
  696. int maxtls; /* Maximum TLS version (or 0 for undefined) */
  697. int mindtls; /* Minimum DTLS version, -1 unsupported */
  698. int maxdtls; /* Maximum DTLS version (or 0 for undefined) */
  699. char is_kem; /* Mode for this Group: 0 is KEX, 1 is KEM */
  700. } TLS_GROUP_INFO;
  701. typedef struct tls_sigalg_info_st {
  702. char *name; /* name as in IANA TLS specs */
  703. uint16_t code_point; /* IANA-specified code point of sigalg-name */
  704. char *sigalg_name; /* (combined) sigalg name */
  705. char *sigalg_oid; /* (combined) sigalg OID */
  706. char *sig_name; /* pure signature algorithm name */
  707. char *sig_oid; /* pure signature algorithm OID */
  708. char *hash_name; /* hash algorithm name */
  709. char *hash_oid; /* hash algorithm OID */
  710. char *keytype; /* keytype name */
  711. char *keytype_oid; /* keytype OID */
  712. unsigned int secbits; /* Bits of security (from SP800-57) */
  713. int mintls; /* Minimum TLS version, -1 unsupported */
  714. int maxtls; /* Maximum TLS version (or 0 for undefined) */
  715. } TLS_SIGALG_INFO;
  716. /*
  717. * Structure containing table entry of certificate info corresponding to
  718. * CERT_PKEY entries
  719. */
  720. typedef struct {
  721. int nid; /* NID of public key algorithm */
  722. uint32_t amask; /* authmask corresponding to key type */
  723. } SSL_CERT_LOOKUP;
  724. /* flags values */
  725. # define TLS_GROUP_TYPE 0x0000000FU /* Mask for group type */
  726. # define TLS_GROUP_CURVE_PRIME 0x00000001U
  727. # define TLS_GROUP_CURVE_CHAR2 0x00000002U
  728. # define TLS_GROUP_CURVE_CUSTOM 0x00000004U
  729. # define TLS_GROUP_FFDHE 0x00000008U
  730. # define TLS_GROUP_ONLY_FOR_TLS1_3 0x00000010U
  731. # define TLS_GROUP_FFDHE_FOR_TLS1_3 (TLS_GROUP_FFDHE|TLS_GROUP_ONLY_FOR_TLS1_3)
  732. struct ssl_ctx_st {
  733. OSSL_LIB_CTX *libctx;
  734. const SSL_METHOD *method;
  735. STACK_OF(SSL_CIPHER) *cipher_list;
  736. /* same as above but sorted for lookup */
  737. STACK_OF(SSL_CIPHER) *cipher_list_by_id;
  738. /* TLSv1.3 specific ciphersuites */
  739. STACK_OF(SSL_CIPHER) *tls13_ciphersuites;
  740. struct x509_store_st /* X509_STORE */ *cert_store;
  741. LHASH_OF(SSL_SESSION) *sessions;
  742. /*
  743. * Most session-ids that will be cached, default is
  744. * SSL_SESSION_CACHE_MAX_SIZE_DEFAULT. 0 is unlimited.
  745. */
  746. size_t session_cache_size;
  747. struct ssl_session_st *session_cache_head;
  748. struct ssl_session_st *session_cache_tail;
  749. /*
  750. * This can have one of 2 values, ored together, SSL_SESS_CACHE_CLIENT,
  751. * SSL_SESS_CACHE_SERVER, Default is SSL_SESSION_CACHE_SERVER, which
  752. * means only SSL_accept will cache SSL_SESSIONS.
  753. */
  754. uint32_t session_cache_mode;
  755. /*
  756. * If timeout is not 0, it is the default timeout value set when
  757. * SSL_new() is called. This has been put in to make life easier to set
  758. * things up
  759. */
  760. OSSL_TIME session_timeout;
  761. /*
  762. * If this callback is not null, it will be called each time a session id
  763. * is added to the cache. If this function returns 1, it means that the
  764. * callback will do a SSL_SESSION_free() when it has finished using it.
  765. * Otherwise, on 0, it means the callback has finished with it. If
  766. * remove_session_cb is not null, it will be called when a session-id is
  767. * removed from the cache. After the call, OpenSSL will
  768. * SSL_SESSION_free() it.
  769. */
  770. int (*new_session_cb) (struct ssl_st *ssl, SSL_SESSION *sess);
  771. void (*remove_session_cb) (struct ssl_ctx_st *ctx, SSL_SESSION *sess);
  772. SSL_SESSION *(*get_session_cb) (struct ssl_st *ssl,
  773. const unsigned char *data, int len,
  774. int *copy);
  775. struct {
  776. TSAN_QUALIFIER int sess_connect; /* SSL new conn - started */
  777. TSAN_QUALIFIER int sess_connect_renegotiate; /* SSL reneg - requested */
  778. TSAN_QUALIFIER int sess_connect_good; /* SSL new conne/reneg - finished */
  779. TSAN_QUALIFIER int sess_accept; /* SSL new accept - started */
  780. TSAN_QUALIFIER int sess_accept_renegotiate; /* SSL reneg - requested */
  781. TSAN_QUALIFIER int sess_accept_good; /* SSL accept/reneg - finished */
  782. TSAN_QUALIFIER int sess_miss; /* session lookup misses */
  783. TSAN_QUALIFIER int sess_timeout; /* reuse attempt on timeouted session */
  784. TSAN_QUALIFIER int sess_cache_full; /* session removed due to full cache */
  785. TSAN_QUALIFIER int sess_hit; /* session reuse actually done */
  786. TSAN_QUALIFIER int sess_cb_hit; /* session-id that was not in
  787. * the cache was passed back via
  788. * the callback. This indicates
  789. * that the application is
  790. * supplying session-id's from
  791. * other processes - spooky
  792. * :-) */
  793. } stats;
  794. #ifdef TSAN_REQUIRES_LOCKING
  795. CRYPTO_RWLOCK *tsan_lock;
  796. #endif
  797. CRYPTO_REF_COUNT references;
  798. /* if defined, these override the X509_verify_cert() calls */
  799. int (*app_verify_callback) (X509_STORE_CTX *, void *);
  800. void *app_verify_arg;
  801. /*
  802. * before OpenSSL 0.9.7, 'app_verify_arg' was ignored
  803. * ('app_verify_callback' was called with just one argument)
  804. */
  805. /* Default password callback. */
  806. pem_password_cb *default_passwd_callback;
  807. /* Default password callback user data. */
  808. void *default_passwd_callback_userdata;
  809. /* get client cert callback */
  810. int (*client_cert_cb) (SSL *ssl, X509 **x509, EVP_PKEY **pkey);
  811. /* cookie generate callback */
  812. int (*app_gen_cookie_cb) (SSL *ssl, unsigned char *cookie,
  813. unsigned int *cookie_len);
  814. /* verify cookie callback */
  815. int (*app_verify_cookie_cb) (SSL *ssl, const unsigned char *cookie,
  816. unsigned int cookie_len);
  817. /* TLS1.3 app-controlled cookie generate callback */
  818. int (*gen_stateless_cookie_cb) (SSL *ssl, unsigned char *cookie,
  819. size_t *cookie_len);
  820. /* TLS1.3 verify app-controlled cookie callback */
  821. int (*verify_stateless_cookie_cb) (SSL *ssl, const unsigned char *cookie,
  822. size_t cookie_len);
  823. CRYPTO_EX_DATA ex_data;
  824. const EVP_MD *md5; /* For SSLv3/TLSv1 'ssl3-md5' */
  825. const EVP_MD *sha1; /* For SSLv3/TLSv1 'ssl3-sha1' */
  826. STACK_OF(X509) *extra_certs;
  827. STACK_OF(SSL_COMP) *comp_methods; /* stack of SSL_COMP, SSLv3/TLSv1 */
  828. /* Default values used when no per-SSL value is defined follow */
  829. /* used if SSL's info_callback is NULL */
  830. void (*info_callback) (const SSL *ssl, int type, int val);
  831. /*
  832. * What we put in certificate_authorities extension for TLS 1.3
  833. * (ClientHello and CertificateRequest) or just client cert requests for
  834. * earlier versions. If client_ca_names is populated then it is only used
  835. * for client cert requests, and in preference to ca_names.
  836. */
  837. STACK_OF(X509_NAME) *ca_names;
  838. STACK_OF(X509_NAME) *client_ca_names;
  839. /*
  840. * Default values to use in SSL structures follow (these are copied by
  841. * SSL_new)
  842. */
  843. uint64_t options;
  844. uint32_t mode;
  845. int min_proto_version;
  846. int max_proto_version;
  847. size_t max_cert_list;
  848. struct cert_st /* CERT */ *cert;
  849. SSL_CERT_LOOKUP *ssl_cert_info;
  850. int read_ahead;
  851. /* callback that allows applications to peek at protocol messages */
  852. ossl_msg_cb msg_callback;
  853. void *msg_callback_arg;
  854. uint32_t verify_mode;
  855. size_t sid_ctx_length;
  856. unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
  857. /* called 'verify_callback' in the SSL */
  858. int (*default_verify_callback) (int ok, X509_STORE_CTX *ctx);
  859. /* Default generate session ID callback. */
  860. GEN_SESSION_CB generate_session_id;
  861. X509_VERIFY_PARAM *param;
  862. int quiet_shutdown;
  863. # ifndef OPENSSL_NO_CT
  864. CTLOG_STORE *ctlog_store; /* CT Log Store */
  865. /*
  866. * Validates that the SCTs (Signed Certificate Timestamps) are sufficient.
  867. * If they are not, the connection should be aborted.
  868. */
  869. ssl_ct_validation_cb ct_validation_callback;
  870. void *ct_validation_callback_arg;
  871. # endif
  872. /*
  873. * If we're using more than one pipeline how should we divide the data
  874. * up between the pipes?
  875. */
  876. size_t split_send_fragment;
  877. /*
  878. * Maximum amount of data to send in one fragment. actual record size can
  879. * be more than this due to padding and MAC overheads.
  880. */
  881. size_t max_send_fragment;
  882. /* Up to how many pipelines should we use? If 0 then 1 is assumed */
  883. size_t max_pipelines;
  884. /* The default read buffer length to use (0 means not set) */
  885. size_t default_read_buf_len;
  886. # ifndef OPENSSL_NO_ENGINE
  887. /*
  888. * Engine to pass requests for client certs to
  889. */
  890. ENGINE *client_cert_engine;
  891. # endif
  892. /* ClientHello callback. Mostly for extensions, but not entirely. */
  893. SSL_client_hello_cb_fn client_hello_cb;
  894. void *client_hello_cb_arg;
  895. /* TLS extensions. */
  896. struct {
  897. /* TLS extensions servername callback */
  898. int (*servername_cb) (SSL *, int *, void *);
  899. void *servername_arg;
  900. /* RFC 4507 session ticket keys */
  901. unsigned char tick_key_name[TLSEXT_KEYNAME_LENGTH];
  902. SSL_CTX_EXT_SECURE *secure;
  903. # ifndef OPENSSL_NO_DEPRECATED_3_0
  904. /* Callback to support customisation of ticket key setting */
  905. int (*ticket_key_cb) (SSL *ssl,
  906. unsigned char *name, unsigned char *iv,
  907. EVP_CIPHER_CTX *ectx, HMAC_CTX *hctx, int enc);
  908. #endif
  909. int (*ticket_key_evp_cb) (SSL *ssl,
  910. unsigned char *name, unsigned char *iv,
  911. EVP_CIPHER_CTX *ectx, EVP_MAC_CTX *hctx,
  912. int enc);
  913. /* certificate status request info */
  914. /* Callback for status request */
  915. int (*status_cb) (SSL *ssl, void *arg);
  916. void *status_arg;
  917. /* ext status type used for CSR extension (OCSP Stapling) */
  918. int status_type;
  919. /* RFC 4366 Maximum Fragment Length Negotiation */
  920. uint8_t max_fragment_len_mode;
  921. /* EC extension values inherited by SSL structure */
  922. size_t ecpointformats_len;
  923. unsigned char *ecpointformats;
  924. size_t supportedgroups_len;
  925. uint16_t *supportedgroups;
  926. uint16_t *supported_groups_default;
  927. size_t supported_groups_default_len;
  928. /*
  929. * ALPN information (we are in the process of transitioning from NPN to
  930. * ALPN.)
  931. */
  932. /*-
  933. * For a server, this contains a callback function that allows the
  934. * server to select the protocol for the connection.
  935. * out: on successful return, this must point to the raw protocol
  936. * name (without the length prefix).
  937. * outlen: on successful return, this contains the length of |*out|.
  938. * in: points to the client's list of supported protocols in
  939. * wire-format.
  940. * inlen: the length of |in|.
  941. */
  942. int (*alpn_select_cb) (SSL *s,
  943. const unsigned char **out,
  944. unsigned char *outlen,
  945. const unsigned char *in,
  946. unsigned int inlen, void *arg);
  947. void *alpn_select_cb_arg;
  948. /*
  949. * For a client, this contains the list of supported protocols in wire
  950. * format.
  951. */
  952. unsigned char *alpn;
  953. size_t alpn_len;
  954. # ifndef OPENSSL_NO_NEXTPROTONEG
  955. /* Next protocol negotiation information */
  956. /*
  957. * For a server, this contains a callback function by which the set of
  958. * advertised protocols can be provided.
  959. */
  960. SSL_CTX_npn_advertised_cb_func npn_advertised_cb;
  961. void *npn_advertised_cb_arg;
  962. /*
  963. * For a client, this contains a callback function that selects the next
  964. * protocol from the list provided by the server.
  965. */
  966. SSL_CTX_npn_select_cb_func npn_select_cb;
  967. void *npn_select_cb_arg;
  968. # endif
  969. unsigned char cookie_hmac_key[SHA256_DIGEST_LENGTH];
  970. } ext;
  971. # ifndef OPENSSL_NO_PSK
  972. SSL_psk_client_cb_func psk_client_callback;
  973. SSL_psk_server_cb_func psk_server_callback;
  974. # endif
  975. SSL_psk_find_session_cb_func psk_find_session_cb;
  976. SSL_psk_use_session_cb_func psk_use_session_cb;
  977. # ifndef OPENSSL_NO_SRP
  978. SRP_CTX srp_ctx; /* ctx for SRP authentication */
  979. # endif
  980. /* Shared DANE context */
  981. struct dane_ctx_st dane;
  982. # ifndef OPENSSL_NO_SRTP
  983. /* SRTP profiles we are willing to do from RFC 5764 */
  984. STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles;
  985. # endif
  986. /*
  987. * Callback for disabling session caching and ticket support on a session
  988. * basis, depending on the chosen cipher.
  989. */
  990. int (*not_resumable_session_cb) (SSL *ssl, int is_forward_secure);
  991. CRYPTO_RWLOCK *lock;
  992. /*
  993. * Callback for logging key material for use with debugging tools like
  994. * Wireshark. The callback should log `line` followed by a newline.
  995. */
  996. SSL_CTX_keylog_cb_func keylog_callback;
  997. /*
  998. * The maximum number of bytes advertised in session tickets that can be
  999. * sent as early data.
  1000. */
  1001. uint32_t max_early_data;
  1002. /*
  1003. * The maximum number of bytes of early data that a server will tolerate
  1004. * (which should be at least as much as max_early_data).
  1005. */
  1006. uint32_t recv_max_early_data;
  1007. /* TLS1.3 padding callback */
  1008. size_t (*record_padding_cb)(SSL *s, int type, size_t len, void *arg);
  1009. void *record_padding_arg;
  1010. size_t block_padding;
  1011. /* Session ticket appdata */
  1012. SSL_CTX_generate_session_ticket_fn generate_ticket_cb;
  1013. SSL_CTX_decrypt_session_ticket_fn decrypt_ticket_cb;
  1014. void *ticket_cb_data;
  1015. /* The number of TLS1.3 tickets to automatically send */
  1016. size_t num_tickets;
  1017. /* Callback to determine if early_data is acceptable or not */
  1018. SSL_allow_early_data_cb_fn allow_early_data_cb;
  1019. void *allow_early_data_cb_data;
  1020. /* Do we advertise Post-handshake auth support? */
  1021. int pha_enabled;
  1022. /* Callback for SSL async handling */
  1023. SSL_async_callback_fn async_cb;
  1024. void *async_cb_arg;
  1025. char *propq;
  1026. int ssl_mac_pkey_id[SSL_MD_NUM_IDX];
  1027. const EVP_CIPHER *ssl_cipher_methods[SSL_ENC_NUM_IDX];
  1028. const EVP_MD *ssl_digest_methods[SSL_MD_NUM_IDX];
  1029. size_t ssl_mac_secret_size[SSL_MD_NUM_IDX];
  1030. size_t tls12_sigalgs_len;
  1031. /* Cache of all sigalgs we know and whether they are available or not */
  1032. struct sigalg_lookup_st *sigalg_lookup_cache;
  1033. /* List of all sigalgs (code points) available, incl. from providers */
  1034. uint16_t *tls12_sigalgs;
  1035. TLS_GROUP_INFO *group_list;
  1036. size_t group_list_len;
  1037. size_t group_list_max_len;
  1038. TLS_SIGALG_INFO *sigalg_list;
  1039. size_t sigalg_list_len;
  1040. size_t sigalg_list_max_len;
  1041. /* masks of disabled algorithms */
  1042. uint32_t disabled_enc_mask;
  1043. uint32_t disabled_mac_mask;
  1044. uint32_t disabled_mkey_mask;
  1045. uint32_t disabled_auth_mask;
  1046. #ifndef OPENSSL_NO_COMP_ALG
  1047. /* certificate compression preferences */
  1048. int cert_comp_prefs[TLSEXT_comp_cert_limit];
  1049. #endif
  1050. /* Certificate Type stuff - for RPK vs X.509 */
  1051. unsigned char *client_cert_type;
  1052. size_t client_cert_type_len;
  1053. unsigned char *server_cert_type;
  1054. size_t server_cert_type_len;
  1055. # ifndef OPENSSL_NO_QLOG
  1056. char *qlog_title; /* Session title for qlog */
  1057. # endif
  1058. };
  1059. typedef struct cert_pkey_st CERT_PKEY;
  1060. #define SSL_TYPE_SSL_CONNECTION 0
  1061. #define SSL_TYPE_QUIC_CONNECTION 0x80
  1062. #define SSL_TYPE_QUIC_XSO 0x81
  1063. #define SSL_TYPE_QUIC_LISTENER 0x82
  1064. #define SSL_TYPE_IS_QUIC(x) (((x) & 0x80) != 0)
  1065. struct ssl_st {
  1066. int type;
  1067. SSL_CTX *ctx;
  1068. const SSL_METHOD *defltmeth;
  1069. const SSL_METHOD *method;
  1070. CRYPTO_REF_COUNT references;
  1071. CRYPTO_RWLOCK *lock;
  1072. /* extra application data */
  1073. CRYPTO_EX_DATA ex_data;
  1074. };
  1075. struct ssl_connection_st {
  1076. /* type identifier and common data */
  1077. struct ssl_st ssl;
  1078. /*
  1079. * protocol version (one of SSL2_VERSION, SSL3_VERSION, TLS1_VERSION,
  1080. * DTLS1_VERSION)
  1081. */
  1082. int version;
  1083. /*
  1084. * There are 2 BIO's even though they are normally both the same. This
  1085. * is so data can be read and written to different handlers
  1086. */
  1087. /* used by SSL_read */
  1088. BIO *rbio;
  1089. /* used by SSL_write */
  1090. BIO *wbio;
  1091. /* used during session-id reuse to concatenate messages */
  1092. BIO *bbio;
  1093. /*
  1094. * This holds a variable that indicates what we were doing when a 0 or -1
  1095. * is returned. This is needed for non-blocking IO so we know what
  1096. * request needs re-doing when in SSL_accept or SSL_connect
  1097. */
  1098. int rwstate;
  1099. int (*handshake_func) (SSL *);
  1100. /*
  1101. * Imagine that here's a boolean member "init" that is switched as soon
  1102. * as SSL_set_{accept/connect}_state is called for the first time, so
  1103. * that "state" and "handshake_func" are properly initialized. But as
  1104. * handshake_func is == 0 until then, we use this test instead of an
  1105. * "init" member.
  1106. */
  1107. /* are we the server side? */
  1108. int server;
  1109. /*
  1110. * Generate a new session or reuse an old one.
  1111. * NB: For servers, the 'new' session may actually be a previously
  1112. * cached session or even the previous session unless
  1113. * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION is set
  1114. */
  1115. int new_session;
  1116. /* don't send shutdown packets */
  1117. int quiet_shutdown;
  1118. /* we have shut things down, 0x01 sent, 0x02 for received */
  1119. int shutdown;
  1120. /* Timestamps used to calculate the handshake RTT */
  1121. OSSL_TIME ts_msg_write;
  1122. OSSL_TIME ts_msg_read;
  1123. /* where we are */
  1124. OSSL_STATEM statem;
  1125. SSL_EARLY_DATA_STATE early_data_state;
  1126. BUF_MEM *init_buf; /* buffer used during init */
  1127. void *init_msg; /* pointer to handshake message body, set by
  1128. * tls_get_message_header() */
  1129. size_t init_num; /* amount read/written */
  1130. size_t init_off; /* amount read/written */
  1131. size_t ssl_pkey_num;
  1132. struct {
  1133. long flags;
  1134. unsigned char server_random[SSL3_RANDOM_SIZE];
  1135. unsigned char client_random[SSL3_RANDOM_SIZE];
  1136. /* used during startup, digest all incoming/outgoing packets */
  1137. BIO *handshake_buffer;
  1138. /*
  1139. * When handshake digest is determined, buffer is hashed and
  1140. * freed and MD_CTX for the required digest is stored here.
  1141. */
  1142. EVP_MD_CTX *handshake_dgst;
  1143. /*
  1144. * Set whenever an expected ChangeCipherSpec message is processed.
  1145. * Unset when the peer's Finished message is received.
  1146. * Unexpected ChangeCipherSpec messages trigger a fatal alert.
  1147. */
  1148. int change_cipher_spec;
  1149. int warn_alert;
  1150. int fatal_alert;
  1151. /*
  1152. * we allow one fatal and one warning alert to be outstanding, send close
  1153. * alert via the warning alert
  1154. */
  1155. int alert_dispatch;
  1156. unsigned char send_alert[2];
  1157. /*
  1158. * This flag is set when we should renegotiate ASAP, basically when there
  1159. * is no more data in the read or write buffers
  1160. */
  1161. int renegotiate;
  1162. int total_renegotiations;
  1163. int num_renegotiations;
  1164. int in_read_app_data;
  1165. struct {
  1166. /* actually only need to be 16+20 for SSLv3 and 12 for TLS */
  1167. unsigned char finish_md[EVP_MAX_MD_SIZE * 2];
  1168. size_t finish_md_len;
  1169. unsigned char peer_finish_md[EVP_MAX_MD_SIZE * 2];
  1170. size_t peer_finish_md_len;
  1171. size_t message_size;
  1172. int message_type;
  1173. /* used to hold the new cipher we are going to use */
  1174. const SSL_CIPHER *new_cipher;
  1175. EVP_PKEY *pkey; /* holds short lived key exchange key */
  1176. /* used for certificate requests */
  1177. int cert_req;
  1178. /* Certificate types in certificate request message. */
  1179. uint8_t *ctype;
  1180. size_t ctype_len;
  1181. /* Certificate authorities list peer sent */
  1182. STACK_OF(X509_NAME) *peer_ca_names;
  1183. size_t key_block_length;
  1184. unsigned char *key_block;
  1185. const EVP_CIPHER *new_sym_enc;
  1186. const EVP_MD *new_hash;
  1187. int new_mac_pkey_type;
  1188. size_t new_mac_secret_size;
  1189. # ifndef OPENSSL_NO_COMP
  1190. const SSL_COMP *new_compression;
  1191. # else
  1192. char *new_compression;
  1193. # endif
  1194. int cert_request;
  1195. /* Raw values of the cipher list from a client */
  1196. unsigned char *ciphers_raw;
  1197. size_t ciphers_rawlen;
  1198. /* Temporary storage for premaster secret */
  1199. unsigned char *pms;
  1200. size_t pmslen;
  1201. # ifndef OPENSSL_NO_PSK
  1202. /* Temporary storage for PSK key */
  1203. unsigned char *psk;
  1204. size_t psklen;
  1205. # endif
  1206. /* Signature algorithm we actually use */
  1207. const struct sigalg_lookup_st *sigalg;
  1208. /* Pointer to certificate we use */
  1209. CERT_PKEY *cert;
  1210. /*
  1211. * signature algorithms peer reports: e.g. supported signature
  1212. * algorithms extension for server or as part of a certificate
  1213. * request for client.
  1214. * Keep track of the algorithms for TLS and X.509 usage separately.
  1215. */
  1216. uint16_t *peer_sigalgs;
  1217. uint16_t *peer_cert_sigalgs;
  1218. /* Size of above arrays */
  1219. size_t peer_sigalgslen;
  1220. size_t peer_cert_sigalgslen;
  1221. /* Sigalg peer actually uses */
  1222. const struct sigalg_lookup_st *peer_sigalg;
  1223. /*
  1224. * Set if corresponding CERT_PKEY can be used with current
  1225. * SSL session: e.g. appropriate curve, signature algorithms etc.
  1226. * If zero it can't be used at all.
  1227. */
  1228. uint32_t *valid_flags;
  1229. /*
  1230. * For servers the following masks are for the key and auth algorithms
  1231. * that are supported by the certs below. For clients they are masks of
  1232. * *disabled* algorithms based on the current session.
  1233. */
  1234. uint32_t mask_k;
  1235. uint32_t mask_a;
  1236. /*
  1237. * The following are used by the client to see if a cipher is allowed or
  1238. * not. It contains the minimum and maximum version the client's using
  1239. * based on what it knows so far.
  1240. */
  1241. int min_ver;
  1242. int max_ver;
  1243. } tmp;
  1244. /* Connection binding to prevent renegotiation attacks */
  1245. unsigned char previous_client_finished[EVP_MAX_MD_SIZE];
  1246. size_t previous_client_finished_len;
  1247. unsigned char previous_server_finished[EVP_MAX_MD_SIZE];
  1248. size_t previous_server_finished_len;
  1249. int send_connection_binding;
  1250. # ifndef OPENSSL_NO_NEXTPROTONEG
  1251. /*
  1252. * Set if we saw the Next Protocol Negotiation extension from our peer.
  1253. */
  1254. int npn_seen;
  1255. # endif
  1256. /*
  1257. * ALPN information (we are in the process of transitioning from NPN to
  1258. * ALPN.)
  1259. */
  1260. /*
  1261. * In a server these point to the selected ALPN protocol after the
  1262. * ClientHello has been processed. In a client these contain the protocol
  1263. * that the server selected once the ServerHello has been processed.
  1264. */
  1265. unsigned char *alpn_selected;
  1266. size_t alpn_selected_len;
  1267. /* used by the server to know what options were proposed */
  1268. unsigned char *alpn_proposed;
  1269. size_t alpn_proposed_len;
  1270. /* used by the client to know if it actually sent alpn */
  1271. int alpn_sent;
  1272. /*
  1273. * This is set to true if we believe that this is a version of Safari
  1274. * running on OS X 10.6 or newer. We wish to know this because Safari on
  1275. * 10.8 .. 10.8.3 has broken ECDHE-ECDSA support.
  1276. */
  1277. char is_probably_safari;
  1278. /*
  1279. * Track whether we did a key exchange this handshake or not, so
  1280. * SSL_get_negotiated_group() knows whether to fall back to the
  1281. * value in the SSL_SESSION.
  1282. */
  1283. char did_kex;
  1284. /* For clients: peer temporary key */
  1285. /* The group_id for the key exchange key */
  1286. uint16_t group_id;
  1287. EVP_PKEY *peer_tmp;
  1288. } s3;
  1289. struct dtls1_state_st *d1; /* DTLSv1 variables */
  1290. /* callback that allows applications to peek at protocol messages */
  1291. void (*msg_callback) (int write_p, int version, int content_type,
  1292. const void *buf, size_t len, SSL *ssl, void *arg);
  1293. void *msg_callback_arg;
  1294. int hit; /* reusing a previous session */
  1295. X509_VERIFY_PARAM *param;
  1296. /* Per connection DANE state */
  1297. SSL_DANE dane;
  1298. /* crypto */
  1299. STACK_OF(SSL_CIPHER) *peer_ciphers;
  1300. STACK_OF(SSL_CIPHER) *cipher_list;
  1301. STACK_OF(SSL_CIPHER) *cipher_list_by_id;
  1302. /* TLSv1.3 specific ciphersuites */
  1303. STACK_OF(SSL_CIPHER) *tls13_ciphersuites;
  1304. /*
  1305. * These are the ones being used, the ones in SSL_SESSION are the ones to
  1306. * be 'copied' into these ones
  1307. */
  1308. uint32_t mac_flags;
  1309. /*
  1310. * The TLS1.3 secrets.
  1311. */
  1312. unsigned char early_secret[EVP_MAX_MD_SIZE];
  1313. unsigned char handshake_secret[EVP_MAX_MD_SIZE];
  1314. unsigned char master_secret[EVP_MAX_MD_SIZE];
  1315. unsigned char resumption_master_secret[EVP_MAX_MD_SIZE];
  1316. unsigned char client_finished_secret[EVP_MAX_MD_SIZE];
  1317. unsigned char server_finished_secret[EVP_MAX_MD_SIZE];
  1318. unsigned char server_finished_hash[EVP_MAX_MD_SIZE];
  1319. unsigned char handshake_traffic_hash[EVP_MAX_MD_SIZE];
  1320. unsigned char client_app_traffic_secret[EVP_MAX_MD_SIZE];
  1321. unsigned char server_app_traffic_secret[EVP_MAX_MD_SIZE];
  1322. unsigned char exporter_master_secret[EVP_MAX_MD_SIZE];
  1323. unsigned char early_exporter_master_secret[EVP_MAX_MD_SIZE];
  1324. /* session info */
  1325. /* client cert? */
  1326. /* This is used to hold the server certificate used */
  1327. struct cert_st /* CERT */ *cert;
  1328. /*
  1329. * The hash of all messages prior to the CertificateVerify, and the length
  1330. * of that hash.
  1331. */
  1332. unsigned char cert_verify_hash[EVP_MAX_MD_SIZE];
  1333. size_t cert_verify_hash_len;
  1334. /* Flag to indicate whether we should send a HelloRetryRequest or not */
  1335. enum {SSL_HRR_NONE = 0, SSL_HRR_PENDING, SSL_HRR_COMPLETE}
  1336. hello_retry_request;
  1337. /*
  1338. * the session_id_context is used to ensure sessions are only reused in
  1339. * the appropriate context
  1340. */
  1341. size_t sid_ctx_length;
  1342. unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
  1343. /* This can also be in the session once a session is established */
  1344. SSL_SESSION *session;
  1345. /* TLSv1.3 PSK session */
  1346. SSL_SESSION *psksession;
  1347. unsigned char *psksession_id;
  1348. size_t psksession_id_len;
  1349. /* Default generate session ID callback. */
  1350. GEN_SESSION_CB generate_session_id;
  1351. /*
  1352. * The temporary TLSv1.3 session id. This isn't really a session id at all
  1353. * but is a random value sent in the legacy session id field.
  1354. */
  1355. unsigned char tmp_session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
  1356. size_t tmp_session_id_len;
  1357. /* Used in SSL3 */
  1358. /*
  1359. * 0 don't care about verify failure.
  1360. * 1 fail if verify fails
  1361. */
  1362. uint32_t verify_mode;
  1363. /* fail if callback returns 0 */
  1364. int (*verify_callback) (int ok, X509_STORE_CTX *ctx);
  1365. /* optional informational callback */
  1366. void (*info_callback) (const SSL *ssl, int type, int val);
  1367. /* error bytes to be written */
  1368. int error;
  1369. /* actual code */
  1370. int error_code;
  1371. # ifndef OPENSSL_NO_PSK
  1372. SSL_psk_client_cb_func psk_client_callback;
  1373. SSL_psk_server_cb_func psk_server_callback;
  1374. # endif
  1375. SSL_psk_find_session_cb_func psk_find_session_cb;
  1376. SSL_psk_use_session_cb_func psk_use_session_cb;
  1377. /* Verified chain of peer */
  1378. STACK_OF(X509) *verified_chain;
  1379. long verify_result;
  1380. /*
  1381. * What we put in certificate_authorities extension for TLS 1.3
  1382. * (ClientHello and CertificateRequest) or just client cert requests for
  1383. * earlier versions. If client_ca_names is populated then it is only used
  1384. * for client cert requests, and in preference to ca_names.
  1385. */
  1386. STACK_OF(X509_NAME) *ca_names;
  1387. STACK_OF(X509_NAME) *client_ca_names;
  1388. /* protocol behaviour */
  1389. uint64_t options;
  1390. /* API behaviour */
  1391. uint32_t mode;
  1392. int min_proto_version;
  1393. int max_proto_version;
  1394. size_t max_cert_list;
  1395. int first_packet;
  1396. /*
  1397. * What was passed in ClientHello.legacy_version. Used for RSA pre-master
  1398. * secret and SSLv3/TLS (<=1.2) rollback check
  1399. */
  1400. int client_version;
  1401. /*
  1402. * If we're using more than one pipeline how should we divide the data
  1403. * up between the pipes?
  1404. */
  1405. size_t split_send_fragment;
  1406. /*
  1407. * Maximum amount of data to send in one fragment. actual record size can
  1408. * be more than this due to padding and MAC overheads.
  1409. */
  1410. size_t max_send_fragment;
  1411. /* Up to how many pipelines should we use? If 0 then 1 is assumed */
  1412. size_t max_pipelines;
  1413. struct {
  1414. /* Built-in extension flags */
  1415. uint8_t extflags[TLSEXT_IDX_num_builtins];
  1416. /* TLS extension debug callback */
  1417. void (*debug_cb)(SSL *s, int client_server, int type,
  1418. const unsigned char *data, int len, void *arg);
  1419. void *debug_arg;
  1420. char *hostname;
  1421. /* certificate status request info */
  1422. /* Status type or -1 if no status type */
  1423. int status_type;
  1424. /* Raw extension data, if seen */
  1425. unsigned char *scts;
  1426. /* Length of raw extension data, if seen */
  1427. uint16_t scts_len;
  1428. /* Expect OCSP CertificateStatus message */
  1429. int status_expected;
  1430. struct {
  1431. /* OCSP status request only */
  1432. STACK_OF(OCSP_RESPID) *ids;
  1433. X509_EXTENSIONS *exts;
  1434. /* OCSP response received or to be sent */
  1435. unsigned char *resp;
  1436. size_t resp_len;
  1437. } ocsp;
  1438. /* RFC4507 session ticket expected to be received or sent */
  1439. int ticket_expected;
  1440. /* TLS 1.3 tickets requested by the application. */
  1441. int extra_tickets_expected;
  1442. size_t ecpointformats_len;
  1443. /* our list */
  1444. unsigned char *ecpointformats;
  1445. size_t peer_ecpointformats_len;
  1446. /* peer's list */
  1447. unsigned char *peer_ecpointformats;
  1448. size_t supportedgroups_len;
  1449. /* our list */
  1450. uint16_t *supportedgroups;
  1451. size_t peer_supportedgroups_len;
  1452. /* peer's list */
  1453. uint16_t *peer_supportedgroups;
  1454. /* TLS Session Ticket extension override */
  1455. TLS_SESSION_TICKET_EXT *session_ticket;
  1456. /* TLS Session Ticket extension callback */
  1457. tls_session_ticket_ext_cb_fn session_ticket_cb;
  1458. void *session_ticket_cb_arg;
  1459. /* TLS pre-shared secret session resumption */
  1460. tls_session_secret_cb_fn session_secret_cb;
  1461. void *session_secret_cb_arg;
  1462. /*
  1463. * For a client, this contains the list of supported protocols in wire
  1464. * format.
  1465. */
  1466. unsigned char *alpn;
  1467. size_t alpn_len;
  1468. /*
  1469. * Next protocol negotiation. For the client, this is the protocol that
  1470. * we sent in NextProtocol and is set when handling ServerHello
  1471. * extensions. For a server, this is the client's selected_protocol from
  1472. * NextProtocol and is set when handling the NextProtocol message, before
  1473. * the Finished message.
  1474. */
  1475. unsigned char *npn;
  1476. size_t npn_len;
  1477. /* The available PSK key exchange modes */
  1478. int psk_kex_mode;
  1479. /* Set to one if we have negotiated ETM */
  1480. int use_etm;
  1481. /* Are we expecting to receive early data? */
  1482. int early_data;
  1483. /* Is the session suitable for early data? */
  1484. int early_data_ok;
  1485. /* May be sent by a server in HRR. Must be echoed back in ClientHello */
  1486. unsigned char *tls13_cookie;
  1487. size_t tls13_cookie_len;
  1488. /* Have we received a cookie from the client? */
  1489. int cookieok;
  1490. /*
  1491. * Maximum Fragment Length as per RFC 4366.
  1492. * If this member contains one of the allowed values (1-4)
  1493. * then we should include Maximum Fragment Length Negotiation
  1494. * extension in Client Hello.
  1495. * Please note that value of this member does not have direct
  1496. * effect. The actual (binding) value is stored in SSL_SESSION,
  1497. * as this extension is optional on server side.
  1498. */
  1499. uint8_t max_fragment_len_mode;
  1500. /*
  1501. * On the client side the number of ticket identities we sent in the
  1502. * ClientHello. On the server side the identity of the ticket we
  1503. * selected.
  1504. */
  1505. int tick_identity;
  1506. /* This is the list of algorithms the peer supports that we also support */
  1507. int compress_certificate_from_peer[TLSEXT_comp_cert_limit];
  1508. /* indicate that we sent the extension, so we'll accept it */
  1509. int compress_certificate_sent;
  1510. uint8_t client_cert_type;
  1511. uint8_t client_cert_type_ctos;
  1512. uint8_t server_cert_type;
  1513. uint8_t server_cert_type_ctos;
  1514. } ext;
  1515. /*
  1516. * Parsed form of the ClientHello, kept around across client_hello_cb
  1517. * calls.
  1518. */
  1519. CLIENTHELLO_MSG *clienthello;
  1520. /*-
  1521. * no further mod of servername
  1522. * 0 : call the servername extension callback.
  1523. * 1 : prepare 2, allow last ack just after in server callback.
  1524. * 2 : don't call servername callback, no ack in server hello
  1525. */
  1526. int servername_done;
  1527. # ifndef OPENSSL_NO_CT
  1528. /*
  1529. * Validates that the SCTs (Signed Certificate Timestamps) are sufficient.
  1530. * If they are not, the connection should be aborted.
  1531. */
  1532. ssl_ct_validation_cb ct_validation_callback;
  1533. /* User-supplied argument that is passed to the ct_validation_callback */
  1534. void *ct_validation_callback_arg;
  1535. /*
  1536. * Consolidated stack of SCTs from all sources.
  1537. * Lazily populated by CT_get_peer_scts(SSL*)
  1538. */
  1539. STACK_OF(SCT) *scts;
  1540. /* Have we attempted to find/parse SCTs yet? */
  1541. int scts_parsed;
  1542. # endif
  1543. SSL_CTX *session_ctx; /* initial ctx, used to store sessions */
  1544. # ifndef OPENSSL_NO_SRTP
  1545. /* What we'll do */
  1546. STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles;
  1547. /* What's been chosen */
  1548. SRTP_PROTECTION_PROFILE *srtp_profile;
  1549. # endif
  1550. /*-
  1551. * 1 if we are renegotiating.
  1552. * 2 if we are a server and are inside a handshake
  1553. * (i.e. not just sending a HelloRequest)
  1554. */
  1555. int renegotiate;
  1556. /* If sending a KeyUpdate is pending */
  1557. int key_update;
  1558. /* Post-handshake authentication state */
  1559. SSL_PHA_STATE post_handshake_auth;
  1560. int pha_enabled;
  1561. uint8_t* pha_context;
  1562. size_t pha_context_len;
  1563. int certreqs_sent;
  1564. EVP_MD_CTX *pha_dgst; /* this is just the digest through ClientFinished */
  1565. # ifndef OPENSSL_NO_SRP
  1566. /* ctx for SRP authentication */
  1567. SRP_CTX srp_ctx;
  1568. # endif
  1569. /*
  1570. * Callback for disabling session caching and ticket support on a session
  1571. * basis, depending on the chosen cipher.
  1572. */
  1573. int (*not_resumable_session_cb) (SSL *ssl, int is_forward_secure);
  1574. /* Record layer data */
  1575. RECORD_LAYER rlayer;
  1576. /* Default password callback. */
  1577. pem_password_cb *default_passwd_callback;
  1578. /* Default password callback user data. */
  1579. void *default_passwd_callback_userdata;
  1580. /* Async Job info */
  1581. ASYNC_JOB *job;
  1582. ASYNC_WAIT_CTX *waitctx;
  1583. size_t asyncrw;
  1584. /*
  1585. * The maximum number of bytes advertised in session tickets that can be
  1586. * sent as early data.
  1587. */
  1588. uint32_t max_early_data;
  1589. /*
  1590. * The maximum number of bytes of early data that a server will tolerate
  1591. * (which should be at least as much as max_early_data).
  1592. */
  1593. uint32_t recv_max_early_data;
  1594. /*
  1595. * The number of bytes of early data received so far. If we accepted early
  1596. * data then this is a count of the plaintext bytes. If we rejected it then
  1597. * this is a count of the ciphertext bytes.
  1598. */
  1599. uint32_t early_data_count;
  1600. /* The number of TLS1.3 tickets to automatically send */
  1601. size_t num_tickets;
  1602. /* The number of TLS1.3 tickets actually sent so far */
  1603. size_t sent_tickets;
  1604. /* The next nonce value to use when we send a ticket on this connection */
  1605. uint64_t next_ticket_nonce;
  1606. /* Callback to determine if early_data is acceptable or not */
  1607. SSL_allow_early_data_cb_fn allow_early_data_cb;
  1608. void *allow_early_data_cb_data;
  1609. /* Callback for SSL async handling */
  1610. SSL_async_callback_fn async_cb;
  1611. void *async_cb_arg;
  1612. /*
  1613. * Signature algorithms shared by client and server: cached because these
  1614. * are used most often.
  1615. */
  1616. const struct sigalg_lookup_st **shared_sigalgs;
  1617. size_t shared_sigalgslen;
  1618. #ifndef OPENSSL_NO_COMP_ALG
  1619. /* certificate compression preferences */
  1620. int cert_comp_prefs[TLSEXT_comp_cert_limit];
  1621. #endif
  1622. /* Certificate Type stuff - for RPK vs X.509 */
  1623. unsigned char *client_cert_type;
  1624. size_t client_cert_type_len;
  1625. unsigned char *server_cert_type;
  1626. size_t server_cert_type_len;
  1627. };
  1628. /*
  1629. * Structure containing table entry of values associated with the signature
  1630. * algorithms (signature scheme) extension
  1631. */
  1632. typedef struct sigalg_lookup_st {
  1633. /* TLS 1.3 signature scheme name */
  1634. const char *name;
  1635. /* Raw value used in extension */
  1636. uint16_t sigalg;
  1637. /* NID of hash algorithm or NID_undef if no hash */
  1638. int hash;
  1639. /* Index of hash algorithm or -1 if no hash algorithm */
  1640. int hash_idx;
  1641. /* NID of signature algorithm */
  1642. int sig;
  1643. /* Index of signature algorithm */
  1644. int sig_idx;
  1645. /* Combined hash and signature NID, if any */
  1646. int sigandhash;
  1647. /* Required public key curve (ECDSA only) */
  1648. int curve;
  1649. /* Whether this signature algorithm is actually available for use */
  1650. int enabled;
  1651. } SIGALG_LOOKUP;
  1652. /* DTLS structures */
  1653. # ifndef OPENSSL_NO_SCTP
  1654. # define DTLS1_SCTP_AUTH_LABEL "EXPORTER_DTLS_OVER_SCTP"
  1655. # endif
  1656. /* Max MTU overhead we know about so far is 40 for IPv6 + 8 for UDP */
  1657. # define DTLS1_MAX_MTU_OVERHEAD 48
  1658. /*
  1659. * Flag used in message reuse to indicate the buffer contains the record
  1660. * header as well as the handshake message header.
  1661. */
  1662. # define DTLS1_SKIP_RECORD_HEADER 2
  1663. struct dtls1_retransmit_state {
  1664. const OSSL_RECORD_METHOD *wrlmethod;
  1665. OSSL_RECORD_LAYER *wrl;
  1666. };
  1667. struct hm_header_st {
  1668. unsigned char type;
  1669. size_t msg_len;
  1670. unsigned short seq;
  1671. size_t frag_off;
  1672. size_t frag_len;
  1673. unsigned int is_ccs;
  1674. struct dtls1_retransmit_state saved_retransmit_state;
  1675. };
  1676. typedef struct hm_fragment_st {
  1677. struct hm_header_st msg_header;
  1678. unsigned char *fragment;
  1679. unsigned char *reassembly;
  1680. } hm_fragment;
  1681. typedef struct pqueue_st pqueue;
  1682. typedef struct pitem_st pitem;
  1683. struct pitem_st {
  1684. unsigned char priority[8]; /* 64-bit value in big-endian encoding */
  1685. void *data;
  1686. pitem *next;
  1687. };
  1688. typedef struct pitem_st *piterator;
  1689. pitem *pitem_new(unsigned char *prio64be, void *data);
  1690. void pitem_free(pitem *item);
  1691. pqueue *pqueue_new(void);
  1692. void pqueue_free(pqueue *pq);
  1693. pitem *pqueue_insert(pqueue *pq, pitem *item);
  1694. pitem *pqueue_peek(pqueue *pq);
  1695. pitem *pqueue_pop(pqueue *pq);
  1696. pitem *pqueue_find(pqueue *pq, unsigned char *prio64be);
  1697. pitem *pqueue_iterator(pqueue *pq);
  1698. pitem *pqueue_next(piterator *iter);
  1699. size_t pqueue_size(pqueue *pq);
  1700. typedef struct dtls1_state_st {
  1701. unsigned char cookie[DTLS1_COOKIE_LENGTH];
  1702. size_t cookie_len;
  1703. unsigned int cookie_verified;
  1704. /* handshake message numbers */
  1705. unsigned short handshake_write_seq;
  1706. unsigned short next_handshake_write_seq;
  1707. unsigned short handshake_read_seq;
  1708. /* Buffered handshake messages */
  1709. pqueue *buffered_messages;
  1710. /* Buffered (sent) handshake records */
  1711. pqueue *sent_messages;
  1712. size_t link_mtu; /* max on-the-wire DTLS packet size */
  1713. size_t mtu; /* max DTLS packet size */
  1714. struct hm_header_st w_msg_hdr;
  1715. struct hm_header_st r_msg_hdr;
  1716. /* Number of alerts received so far */
  1717. unsigned int timeout_num_alerts;
  1718. /*
  1719. * Indicates when the last handshake msg sent will timeout
  1720. */
  1721. OSSL_TIME next_timeout;
  1722. /* Timeout duration */
  1723. unsigned int timeout_duration_us;
  1724. unsigned int retransmitting;
  1725. # ifndef OPENSSL_NO_SCTP
  1726. int shutdown_received;
  1727. # endif
  1728. DTLS_timer_cb timer_cb;
  1729. } DTLS1_STATE;
  1730. /*
  1731. * From ECC-TLS draft, used in encoding the curve type in ECParameters
  1732. */
  1733. # define EXPLICIT_PRIME_CURVE_TYPE 1
  1734. # define EXPLICIT_CHAR2_CURVE_TYPE 2
  1735. # define NAMED_CURVE_TYPE 3
  1736. # ifndef OPENSSL_NO_COMP_ALG
  1737. struct ossl_comp_cert_st {
  1738. unsigned char *data;
  1739. size_t len;
  1740. size_t orig_len;
  1741. CRYPTO_REF_COUNT references;
  1742. int alg;
  1743. };
  1744. typedef struct ossl_comp_cert_st OSSL_COMP_CERT;
  1745. void OSSL_COMP_CERT_free(OSSL_COMP_CERT *c);
  1746. int OSSL_COMP_CERT_up_ref(OSSL_COMP_CERT *c);
  1747. # endif
  1748. struct cert_pkey_st {
  1749. X509 *x509;
  1750. EVP_PKEY *privatekey;
  1751. /* Chain for this certificate */
  1752. STACK_OF(X509) *chain;
  1753. /*-
  1754. * serverinfo data for this certificate. The data is in TLS Extension
  1755. * wire format, specifically it's a series of records like:
  1756. * uint16_t extension_type; // (RFC 5246, 7.4.1.4, Extension)
  1757. * uint16_t length;
  1758. * uint8_t data[length];
  1759. */
  1760. unsigned char *serverinfo;
  1761. size_t serverinfo_length;
  1762. # ifndef OPENSSL_NO_COMP_ALG
  1763. /* Compressed certificate data - index 0 is unused */
  1764. OSSL_COMP_CERT *comp_cert[TLSEXT_comp_cert_limit];
  1765. int cert_comp_used;
  1766. # endif
  1767. };
  1768. /* Retrieve Suite B flags */
  1769. # define tls1_suiteb(s) (s->cert->cert_flags & SSL_CERT_FLAG_SUITEB_128_LOS)
  1770. /* Uses to check strict mode: suite B modes are always strict */
  1771. # define SSL_CERT_FLAGS_CHECK_TLS_STRICT \
  1772. (SSL_CERT_FLAG_SUITEB_128_LOS|SSL_CERT_FLAG_TLS_STRICT)
  1773. typedef enum {
  1774. ENDPOINT_CLIENT = 0,
  1775. ENDPOINT_SERVER,
  1776. ENDPOINT_BOTH
  1777. } ENDPOINT;
  1778. typedef struct {
  1779. unsigned short ext_type;
  1780. ENDPOINT role;
  1781. /* The context which this extension applies to */
  1782. unsigned int context;
  1783. /*
  1784. * Per-connection flags relating to this extension type: not used if
  1785. * part of an SSL_CTX structure.
  1786. */
  1787. uint32_t ext_flags;
  1788. SSL_custom_ext_add_cb_ex add_cb;
  1789. SSL_custom_ext_free_cb_ex free_cb;
  1790. void *add_arg;
  1791. SSL_custom_ext_parse_cb_ex parse_cb;
  1792. void *parse_arg;
  1793. } custom_ext_method;
  1794. /* ext_flags values */
  1795. /*
  1796. * Indicates an extension has been received. Used to check for unsolicited or
  1797. * duplicate extensions.
  1798. */
  1799. # define SSL_EXT_FLAG_RECEIVED 0x1
  1800. /*
  1801. * Indicates an extension has been sent: used to enable sending of
  1802. * corresponding ServerHello extension.
  1803. */
  1804. # define SSL_EXT_FLAG_SENT 0x2
  1805. typedef struct {
  1806. custom_ext_method *meths;
  1807. size_t meths_count;
  1808. } custom_ext_methods;
  1809. typedef struct cert_st {
  1810. /* Current active set */
  1811. /*
  1812. * ALWAYS points to an element of the pkeys array
  1813. * Probably it would make more sense to store
  1814. * an index, not a pointer.
  1815. */
  1816. CERT_PKEY *key;
  1817. EVP_PKEY *dh_tmp;
  1818. DH *(*dh_tmp_cb) (SSL *ssl, int is_export, int keysize);
  1819. int dh_tmp_auto;
  1820. /* Flags related to certificates */
  1821. uint32_t cert_flags;
  1822. CERT_PKEY *pkeys;
  1823. size_t ssl_pkey_num;
  1824. /* Custom certificate types sent in certificate request message. */
  1825. uint8_t *ctype;
  1826. size_t ctype_len;
  1827. /*
  1828. * supported signature algorithms. When set on a client this is sent in
  1829. * the client hello as the supported signature algorithms extension. For
  1830. * servers it represents the signature algorithms we are willing to use.
  1831. */
  1832. uint16_t *conf_sigalgs;
  1833. /* Size of above array */
  1834. size_t conf_sigalgslen;
  1835. /*
  1836. * Client authentication signature algorithms, if not set then uses
  1837. * conf_sigalgs. On servers these will be the signature algorithms sent
  1838. * to the client in a certificate request for TLS 1.2. On a client this
  1839. * represents the signature algorithms we are willing to use for client
  1840. * authentication.
  1841. */
  1842. uint16_t *client_sigalgs;
  1843. /* Size of above array */
  1844. size_t client_sigalgslen;
  1845. /*
  1846. * Certificate setup callback: if set is called whenever a certificate
  1847. * may be required (client or server). the callback can then examine any
  1848. * appropriate parameters and setup any certificates required. This
  1849. * allows advanced applications to select certificates on the fly: for
  1850. * example based on supported signature algorithms or curves.
  1851. */
  1852. int (*cert_cb) (SSL *ssl, void *arg);
  1853. void *cert_cb_arg;
  1854. /*
  1855. * Optional X509_STORE for chain building or certificate validation If
  1856. * NULL the parent SSL_CTX store is used instead.
  1857. */
  1858. X509_STORE *chain_store;
  1859. X509_STORE *verify_store;
  1860. /* Custom extensions */
  1861. custom_ext_methods custext;
  1862. /* Security callback */
  1863. int (*sec_cb) (const SSL *s, const SSL_CTX *ctx, int op, int bits, int nid,
  1864. void *other, void *ex);
  1865. /* Security level */
  1866. int sec_level;
  1867. void *sec_ex;
  1868. # ifndef OPENSSL_NO_PSK
  1869. /* If not NULL psk identity hint to use for servers */
  1870. char *psk_identity_hint;
  1871. # endif
  1872. CRYPTO_REF_COUNT references; /* >1 only if SSL_copy_session_id is used */
  1873. } CERT;
  1874. # define FP_ICC (int (*)(const void *,const void *))
  1875. /*
  1876. * This is for the SSLv3/TLSv1.0 differences in crypto/hash stuff It is a bit
  1877. * of a mess of functions, but hell, think of it as an opaque structure :-)
  1878. */
  1879. typedef struct ssl3_enc_method {
  1880. int (*setup_key_block) (SSL_CONNECTION *);
  1881. int (*generate_master_secret) (SSL_CONNECTION *, unsigned char *,
  1882. unsigned char *, size_t, size_t *);
  1883. int (*change_cipher_state) (SSL_CONNECTION *, int);
  1884. size_t (*final_finish_mac) (SSL_CONNECTION *, const char *, size_t,
  1885. unsigned char *);
  1886. const char *client_finished_label;
  1887. size_t client_finished_label_len;
  1888. const char *server_finished_label;
  1889. size_t server_finished_label_len;
  1890. int (*alert_value) (int);
  1891. int (*export_keying_material) (SSL_CONNECTION *, unsigned char *, size_t,
  1892. const char *, size_t,
  1893. const unsigned char *, size_t,
  1894. int use_context);
  1895. /* Various flags indicating protocol version requirements */
  1896. uint32_t enc_flags;
  1897. /* Set the handshake header */
  1898. int (*set_handshake_header) (SSL_CONNECTION *s, WPACKET *pkt, int type);
  1899. /* Close construction of the handshake message */
  1900. int (*close_construct_packet) (SSL_CONNECTION *s, WPACKET *pkt, int htype);
  1901. /* Write out handshake message */
  1902. int (*do_write) (SSL_CONNECTION *s);
  1903. } SSL3_ENC_METHOD;
  1904. # define ssl_set_handshake_header(s, pkt, htype) \
  1905. SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->set_handshake_header((s), (pkt), (htype))
  1906. # define ssl_close_construct_packet(s, pkt, htype) \
  1907. SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->close_construct_packet((s), (pkt), (htype))
  1908. # define ssl_do_write(s) SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->do_write(s)
  1909. /* Values for enc_flags */
  1910. /* Uses explicit IV for CBC mode */
  1911. # define SSL_ENC_FLAG_EXPLICIT_IV 0x1
  1912. /* Uses signature algorithms extension */
  1913. # define SSL_ENC_FLAG_SIGALGS 0x2
  1914. /* Uses SHA256 default PRF */
  1915. # define SSL_ENC_FLAG_SHA256_PRF 0x4
  1916. /* Is DTLS */
  1917. # define SSL_ENC_FLAG_DTLS 0x8
  1918. /*
  1919. * Allow TLS 1.2 ciphersuites: applies to DTLS 1.2 as well as TLS 1.2: may
  1920. * apply to others in future.
  1921. */
  1922. # define SSL_ENC_FLAG_TLS1_2_CIPHERS 0x10
  1923. typedef enum downgrade_en {
  1924. DOWNGRADE_NONE,
  1925. DOWNGRADE_TO_1_2,
  1926. DOWNGRADE_TO_1_1
  1927. } DOWNGRADE;
  1928. /*
  1929. * Dummy status type for the status_type extension. Indicates no status type
  1930. * set
  1931. */
  1932. #define TLSEXT_STATUSTYPE_nothing -1
  1933. /* Sigalgs values */
  1934. #define TLSEXT_SIGALG_ecdsa_secp256r1_sha256 0x0403
  1935. #define TLSEXT_SIGALG_ecdsa_secp384r1_sha384 0x0503
  1936. #define TLSEXT_SIGALG_ecdsa_secp521r1_sha512 0x0603
  1937. #define TLSEXT_SIGALG_ecdsa_sha224 0x0303
  1938. #define TLSEXT_SIGALG_ecdsa_sha1 0x0203
  1939. #define TLSEXT_SIGALG_rsa_pss_rsae_sha256 0x0804
  1940. #define TLSEXT_SIGALG_rsa_pss_rsae_sha384 0x0805
  1941. #define TLSEXT_SIGALG_rsa_pss_rsae_sha512 0x0806
  1942. #define TLSEXT_SIGALG_rsa_pss_pss_sha256 0x0809
  1943. #define TLSEXT_SIGALG_rsa_pss_pss_sha384 0x080a
  1944. #define TLSEXT_SIGALG_rsa_pss_pss_sha512 0x080b
  1945. #define TLSEXT_SIGALG_rsa_pkcs1_sha256 0x0401
  1946. #define TLSEXT_SIGALG_rsa_pkcs1_sha384 0x0501
  1947. #define TLSEXT_SIGALG_rsa_pkcs1_sha512 0x0601
  1948. #define TLSEXT_SIGALG_rsa_pkcs1_sha224 0x0301
  1949. #define TLSEXT_SIGALG_rsa_pkcs1_sha1 0x0201
  1950. #define TLSEXT_SIGALG_dsa_sha256 0x0402
  1951. #define TLSEXT_SIGALG_dsa_sha384 0x0502
  1952. #define TLSEXT_SIGALG_dsa_sha512 0x0602
  1953. #define TLSEXT_SIGALG_dsa_sha224 0x0302
  1954. #define TLSEXT_SIGALG_dsa_sha1 0x0202
  1955. #define TLSEXT_SIGALG_gostr34102012_256_intrinsic 0x0840
  1956. #define TLSEXT_SIGALG_gostr34102012_512_intrinsic 0x0841
  1957. #define TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256 0xeeee
  1958. #define TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512 0xefef
  1959. #define TLSEXT_SIGALG_gostr34102001_gostr3411 0xeded
  1960. #define TLSEXT_SIGALG_ed25519 0x0807
  1961. #define TLSEXT_SIGALG_ed448 0x0808
  1962. #define TLSEXT_SIGALG_ecdsa_brainpoolP256r1_sha256 0x081a
  1963. #define TLSEXT_SIGALG_ecdsa_brainpoolP384r1_sha384 0x081b
  1964. #define TLSEXT_SIGALG_ecdsa_brainpoolP512r1_sha512 0x081c
  1965. /* Known PSK key exchange modes */
  1966. #define TLSEXT_KEX_MODE_KE 0x00
  1967. #define TLSEXT_KEX_MODE_KE_DHE 0x01
  1968. /*
  1969. * Internal representations of key exchange modes
  1970. */
  1971. #define TLSEXT_KEX_MODE_FLAG_NONE 0
  1972. #define TLSEXT_KEX_MODE_FLAG_KE 1
  1973. #define TLSEXT_KEX_MODE_FLAG_KE_DHE 2
  1974. #define SSL_USE_PSS(s) (s->s3.tmp.peer_sigalg != NULL && \
  1975. s->s3.tmp.peer_sigalg->sig == EVP_PKEY_RSA_PSS)
  1976. /* A dummy signature value not valid for TLSv1.2 signature algs */
  1977. #define TLSEXT_signature_rsa_pss 0x0101
  1978. /* TLSv1.3 downgrade protection sentinel values */
  1979. extern const unsigned char tls11downgrade[8];
  1980. extern const unsigned char tls12downgrade[8];
  1981. extern const SSL3_ENC_METHOD ssl3_undef_enc_method;
  1982. __owur const SSL_METHOD *sslv3_method(void);
  1983. __owur const SSL_METHOD *sslv3_server_method(void);
  1984. __owur const SSL_METHOD *sslv3_client_method(void);
  1985. __owur const SSL_METHOD *tlsv1_method(void);
  1986. __owur const SSL_METHOD *tlsv1_server_method(void);
  1987. __owur const SSL_METHOD *tlsv1_client_method(void);
  1988. __owur const SSL_METHOD *tlsv1_1_method(void);
  1989. __owur const SSL_METHOD *tlsv1_1_server_method(void);
  1990. __owur const SSL_METHOD *tlsv1_1_client_method(void);
  1991. __owur const SSL_METHOD *tlsv1_2_method(void);
  1992. __owur const SSL_METHOD *tlsv1_2_server_method(void);
  1993. __owur const SSL_METHOD *tlsv1_2_client_method(void);
  1994. __owur const SSL_METHOD *tlsv1_3_method(void);
  1995. __owur const SSL_METHOD *tlsv1_3_server_method(void);
  1996. __owur const SSL_METHOD *tlsv1_3_client_method(void);
  1997. __owur const SSL_METHOD *dtlsv1_method(void);
  1998. __owur const SSL_METHOD *dtlsv1_server_method(void);
  1999. __owur const SSL_METHOD *dtlsv1_client_method(void);
  2000. __owur const SSL_METHOD *dtls_bad_ver_client_method(void);
  2001. __owur const SSL_METHOD *dtlsv1_2_method(void);
  2002. __owur const SSL_METHOD *dtlsv1_2_server_method(void);
  2003. __owur const SSL_METHOD *dtlsv1_2_client_method(void);
  2004. extern const SSL3_ENC_METHOD TLSv1_enc_data;
  2005. extern const SSL3_ENC_METHOD TLSv1_1_enc_data;
  2006. extern const SSL3_ENC_METHOD TLSv1_2_enc_data;
  2007. extern const SSL3_ENC_METHOD TLSv1_3_enc_data;
  2008. extern const SSL3_ENC_METHOD SSLv3_enc_data;
  2009. extern const SSL3_ENC_METHOD DTLSv1_enc_data;
  2010. extern const SSL3_ENC_METHOD DTLSv1_2_enc_data;
  2011. /*
  2012. * Flags for SSL methods
  2013. */
  2014. # define SSL_METHOD_NO_FIPS (1U<<0)
  2015. # define SSL_METHOD_NO_SUITEB (1U<<1)
  2016. # define IMPLEMENT_tls_meth_func(version, flags, mask, func_name, s_accept, \
  2017. s_connect, enc_data) \
  2018. const SSL_METHOD *func_name(void) \
  2019. { \
  2020. static const SSL_METHOD func_name##_data= { \
  2021. version, \
  2022. flags, \
  2023. mask, \
  2024. ossl_ssl_connection_new, \
  2025. ossl_ssl_connection_free, \
  2026. ossl_ssl_connection_reset, \
  2027. tls1_new, \
  2028. tls1_clear, \
  2029. tls1_free, \
  2030. s_accept, \
  2031. s_connect, \
  2032. ssl3_read, \
  2033. ssl3_peek, \
  2034. ssl3_write, \
  2035. ssl3_shutdown, \
  2036. ssl3_renegotiate, \
  2037. ssl3_renegotiate_check, \
  2038. ssl3_read_bytes, \
  2039. ssl3_write_bytes, \
  2040. ssl3_dispatch_alert, \
  2041. ssl3_ctrl, \
  2042. ssl3_ctx_ctrl, \
  2043. ssl3_get_cipher_by_char, \
  2044. ssl3_put_cipher_by_char, \
  2045. ssl3_pending, \
  2046. ssl3_num_ciphers, \
  2047. ssl3_get_cipher, \
  2048. tls1_default_timeout, \
  2049. &enc_data, \
  2050. ssl_undefined_void_function, \
  2051. ssl3_callback_ctrl, \
  2052. ssl3_ctx_callback_ctrl, \
  2053. }; \
  2054. return &func_name##_data; \
  2055. }
  2056. # define IMPLEMENT_ssl3_meth_func(func_name, s_accept, s_connect) \
  2057. const SSL_METHOD *func_name(void) \
  2058. { \
  2059. static const SSL_METHOD func_name##_data= { \
  2060. SSL3_VERSION, \
  2061. SSL_METHOD_NO_FIPS | SSL_METHOD_NO_SUITEB, \
  2062. SSL_OP_NO_SSLv3, \
  2063. ossl_ssl_connection_new, \
  2064. ossl_ssl_connection_free, \
  2065. ossl_ssl_connection_reset, \
  2066. ssl3_new, \
  2067. ssl3_clear, \
  2068. ssl3_free, \
  2069. s_accept, \
  2070. s_connect, \
  2071. ssl3_read, \
  2072. ssl3_peek, \
  2073. ssl3_write, \
  2074. ssl3_shutdown, \
  2075. ssl3_renegotiate, \
  2076. ssl3_renegotiate_check, \
  2077. ssl3_read_bytes, \
  2078. ssl3_write_bytes, \
  2079. ssl3_dispatch_alert, \
  2080. ssl3_ctrl, \
  2081. ssl3_ctx_ctrl, \
  2082. ssl3_get_cipher_by_char, \
  2083. ssl3_put_cipher_by_char, \
  2084. ssl3_pending, \
  2085. ssl3_num_ciphers, \
  2086. ssl3_get_cipher, \
  2087. ssl3_default_timeout, \
  2088. &SSLv3_enc_data, \
  2089. ssl_undefined_void_function, \
  2090. ssl3_callback_ctrl, \
  2091. ssl3_ctx_callback_ctrl, \
  2092. }; \
  2093. return &func_name##_data; \
  2094. }
  2095. # define IMPLEMENT_dtls1_meth_func(version, flags, mask, func_name, s_accept, \
  2096. s_connect, enc_data) \
  2097. const SSL_METHOD *func_name(void) \
  2098. { \
  2099. static const SSL_METHOD func_name##_data= { \
  2100. version, \
  2101. flags, \
  2102. mask, \
  2103. ossl_ssl_connection_new, \
  2104. ossl_ssl_connection_free, \
  2105. ossl_ssl_connection_reset, \
  2106. dtls1_new, \
  2107. dtls1_clear, \
  2108. dtls1_free, \
  2109. s_accept, \
  2110. s_connect, \
  2111. ssl3_read, \
  2112. ssl3_peek, \
  2113. ssl3_write, \
  2114. dtls1_shutdown, \
  2115. ssl3_renegotiate, \
  2116. ssl3_renegotiate_check, \
  2117. dtls1_read_bytes, \
  2118. dtls1_write_app_data_bytes, \
  2119. dtls1_dispatch_alert, \
  2120. dtls1_ctrl, \
  2121. ssl3_ctx_ctrl, \
  2122. ssl3_get_cipher_by_char, \
  2123. ssl3_put_cipher_by_char, \
  2124. ssl3_pending, \
  2125. ssl3_num_ciphers, \
  2126. ssl3_get_cipher, \
  2127. dtls1_default_timeout, \
  2128. &enc_data, \
  2129. ssl_undefined_void_function, \
  2130. ssl3_callback_ctrl, \
  2131. ssl3_ctx_callback_ctrl, \
  2132. }; \
  2133. return &func_name##_data; \
  2134. }
  2135. struct openssl_ssl_test_functions {
  2136. int (*p_ssl_init_wbio_buffer) (SSL_CONNECTION *s);
  2137. };
  2138. const char *ssl_protocol_to_string(int version);
  2139. static ossl_inline int tls12_rpk_and_privkey(const SSL_CONNECTION *sc, int idx)
  2140. {
  2141. /*
  2142. * This is to check for special cases when using RPK with just
  2143. * a private key, and NO CERTIFICATE
  2144. */
  2145. return ((sc->server && sc->ext.server_cert_type == TLSEXT_cert_type_rpk)
  2146. || (!sc->server && sc->ext.client_cert_type == TLSEXT_cert_type_rpk))
  2147. && sc->cert->pkeys[idx].privatekey != NULL
  2148. && sc->cert->pkeys[idx].x509 == NULL;
  2149. }
  2150. static ossl_inline int ssl_has_cert_type(const SSL_CONNECTION *sc, unsigned char ct)
  2151. {
  2152. unsigned char *ptr;
  2153. size_t len;
  2154. if (sc->server) {
  2155. ptr = sc->server_cert_type;
  2156. len = sc->server_cert_type_len;
  2157. } else {
  2158. ptr = sc->client_cert_type;
  2159. len = sc->client_cert_type_len;
  2160. }
  2161. if (ptr == NULL)
  2162. return 0;
  2163. return memchr(ptr, ct, len) != NULL;
  2164. }
  2165. /* Returns true if certificate and private key for 'idx' are present */
  2166. static ossl_inline int ssl_has_cert(const SSL_CONNECTION *s, int idx)
  2167. {
  2168. if (idx < 0 || idx >= (int)s->ssl_pkey_num)
  2169. return 0;
  2170. /* If RPK is enabled for this SSL... only require private key */
  2171. if (ssl_has_cert_type(s, TLSEXT_cert_type_rpk))
  2172. return s->cert->pkeys[idx].privatekey != NULL;
  2173. return s->cert->pkeys[idx].x509 != NULL
  2174. && s->cert->pkeys[idx].privatekey != NULL;
  2175. }
  2176. static ossl_inline void tls1_get_peer_groups(SSL_CONNECTION *s,
  2177. const uint16_t **pgroups,
  2178. size_t *pgroupslen)
  2179. {
  2180. *pgroups = s->ext.peer_supportedgroups;
  2181. *pgroupslen = s->ext.peer_supportedgroups_len;
  2182. }
  2183. # ifndef OPENSSL_UNIT_TEST
  2184. __owur int ossl_ssl_init(SSL *ssl, SSL_CTX *ctx, const SSL_METHOD *method,
  2185. int type);
  2186. __owur SSL *ossl_ssl_connection_new_int(SSL_CTX *ctx, const SSL_METHOD *method);
  2187. __owur SSL *ossl_ssl_connection_new(SSL_CTX *ctx);
  2188. void ossl_ssl_connection_free(SSL *ssl);
  2189. __owur int ossl_ssl_connection_reset(SSL *ssl);
  2190. __owur int ssl_read_internal(SSL *s, void *buf, size_t num, size_t *readbytes);
  2191. __owur int ssl_write_internal(SSL *s, const void *buf, size_t num,
  2192. uint64_t flags, size_t *written);
  2193. int ssl_clear_bad_session(SSL_CONNECTION *s);
  2194. __owur CERT *ssl_cert_new(size_t ssl_pkey_num);
  2195. __owur CERT *ssl_cert_dup(CERT *cert);
  2196. void ssl_cert_clear_certs(CERT *c);
  2197. void ssl_cert_free(CERT *c);
  2198. __owur int ssl_generate_session_id(SSL_CONNECTION *s, SSL_SESSION *ss);
  2199. __owur int ssl_get_new_session(SSL_CONNECTION *s, int session);
  2200. __owur SSL_SESSION *lookup_sess_in_cache(SSL_CONNECTION *s,
  2201. const unsigned char *sess_id,
  2202. size_t sess_id_len);
  2203. __owur int ssl_get_prev_session(SSL_CONNECTION *s, CLIENTHELLO_MSG *hello);
  2204. __owur SSL_SESSION *ssl_session_dup(const SSL_SESSION *src, int ticket);
  2205. __owur int ssl_cipher_id_cmp(const SSL_CIPHER *a, const SSL_CIPHER *b);
  2206. DECLARE_OBJ_BSEARCH_GLOBAL_CMP_FN(SSL_CIPHER, SSL_CIPHER, ssl_cipher_id);
  2207. __owur int ssl_cipher_ptr_id_cmp(const SSL_CIPHER *const *ap,
  2208. const SSL_CIPHER *const *bp);
  2209. __owur STACK_OF(SSL_CIPHER) *ssl_create_cipher_list(SSL_CTX *ctx,
  2210. STACK_OF(SSL_CIPHER) *tls13_ciphersuites,
  2211. STACK_OF(SSL_CIPHER) **cipher_list,
  2212. STACK_OF(SSL_CIPHER) **cipher_list_by_id,
  2213. const char *rule_str,
  2214. CERT *c);
  2215. __owur int ssl_cache_cipherlist(SSL_CONNECTION *s, PACKET *cipher_suites,
  2216. int sslv2format);
  2217. __owur int ossl_bytes_to_cipher_list(SSL_CONNECTION *s, PACKET *cipher_suites,
  2218. STACK_OF(SSL_CIPHER) **skp,
  2219. STACK_OF(SSL_CIPHER) **scsvs, int sslv2format,
  2220. int fatal);
  2221. void ssl_update_cache(SSL_CONNECTION *s, int mode);
  2222. __owur int ssl_cipher_get_evp_cipher(SSL_CTX *ctx, const SSL_CIPHER *sslc,
  2223. const EVP_CIPHER **enc);
  2224. __owur int ssl_cipher_get_evp(SSL_CTX *ctxc, const SSL_SESSION *s,
  2225. const EVP_CIPHER **enc, const EVP_MD **md,
  2226. int *mac_pkey_type, size_t *mac_secret_size,
  2227. SSL_COMP **comp, int use_etm);
  2228. __owur int ssl_cipher_get_overhead(const SSL_CIPHER *c, size_t *mac_overhead,
  2229. size_t *int_overhead, size_t *blocksize,
  2230. size_t *ext_overhead);
  2231. __owur int ssl_cert_is_disabled(SSL_CTX *ctx, size_t idx);
  2232. __owur const SSL_CIPHER *ssl_get_cipher_by_char(SSL_CONNECTION *ssl,
  2233. const unsigned char *ptr,
  2234. int all);
  2235. __owur int ssl_cert_set0_chain(SSL_CONNECTION *s, SSL_CTX *ctx,
  2236. STACK_OF(X509) *chain);
  2237. __owur int ssl_cert_set1_chain(SSL_CONNECTION *s, SSL_CTX *ctx,
  2238. STACK_OF(X509) *chain);
  2239. __owur int ssl_cert_add0_chain_cert(SSL_CONNECTION *s, SSL_CTX *ctx, X509 *x);
  2240. __owur int ssl_cert_add1_chain_cert(SSL_CONNECTION *s, SSL_CTX *ctx, X509 *x);
  2241. __owur int ssl_cert_select_current(CERT *c, X509 *x);
  2242. __owur int ssl_cert_set_current(CERT *c, long arg);
  2243. void ssl_cert_set_cert_cb(CERT *c, int (*cb) (SSL *ssl, void *arg), void *arg);
  2244. __owur int ssl_verify_cert_chain(SSL_CONNECTION *s, STACK_OF(X509) *sk);
  2245. __owur int ssl_verify_rpk(SSL_CONNECTION *s, EVP_PKEY *rpk);
  2246. __owur int ssl_build_cert_chain(SSL_CONNECTION *s, SSL_CTX *ctx, int flags);
  2247. __owur int ssl_cert_set_cert_store(CERT *c, X509_STORE *store, int chain,
  2248. int ref);
  2249. __owur int ssl_cert_get_cert_store(CERT *c, X509_STORE **pstore, int chain);
  2250. __owur int ssl_security(const SSL_CONNECTION *s, int op, int bits, int nid,
  2251. void *other);
  2252. __owur int ssl_ctx_security(const SSL_CTX *ctx, int op, int bits, int nid,
  2253. void *other);
  2254. int ssl_get_security_level_bits(const SSL *s, const SSL_CTX *ctx, int *levelp);
  2255. __owur int ssl_cert_lookup_by_nid(int nid, size_t *pidx, SSL_CTX *ctx);
  2256. __owur const SSL_CERT_LOOKUP *ssl_cert_lookup_by_pkey(const EVP_PKEY *pk,
  2257. size_t *pidx,
  2258. SSL_CTX *ctx);
  2259. __owur const SSL_CERT_LOOKUP *ssl_cert_lookup_by_idx(size_t idx, SSL_CTX *ctx);
  2260. int ssl_undefined_function(SSL *s);
  2261. __owur int ssl_undefined_void_function(void);
  2262. __owur int ssl_undefined_const_function(const SSL *s);
  2263. __owur int ssl_get_server_cert_serverinfo(SSL_CONNECTION *s,
  2264. const unsigned char **serverinfo,
  2265. size_t *serverinfo_length);
  2266. void ssl_set_masks(SSL_CONNECTION *s);
  2267. __owur STACK_OF(SSL_CIPHER) *ssl_get_ciphers_by_id(SSL_CONNECTION *sc);
  2268. __owur int ssl_x509err2alert(int type);
  2269. void ssl_sort_cipher_list(void);
  2270. int ssl_load_ciphers(SSL_CTX *ctx);
  2271. __owur int ssl_setup_sigalgs(SSL_CTX *ctx);
  2272. int ssl_load_groups(SSL_CTX *ctx);
  2273. int ssl_load_sigalgs(SSL_CTX *ctx);
  2274. __owur int ssl_fill_hello_random(SSL_CONNECTION *s, int server,
  2275. unsigned char *field, size_t len,
  2276. DOWNGRADE dgrd);
  2277. __owur int ssl_generate_master_secret(SSL_CONNECTION *s, unsigned char *pms,
  2278. size_t pmslen, int free_pms);
  2279. __owur EVP_PKEY *ssl_generate_pkey(SSL_CONNECTION *s, EVP_PKEY *pm);
  2280. __owur int ssl_gensecret(SSL_CONNECTION *s, unsigned char *pms, size_t pmslen);
  2281. __owur int ssl_derive(SSL_CONNECTION *s, EVP_PKEY *privkey, EVP_PKEY *pubkey,
  2282. int genmaster);
  2283. __owur int ssl_decapsulate(SSL_CONNECTION *s, EVP_PKEY *privkey,
  2284. const unsigned char *ct, size_t ctlen,
  2285. int gensecret);
  2286. __owur int ssl_encapsulate(SSL_CONNECTION *s, EVP_PKEY *pubkey,
  2287. unsigned char **ctp, size_t *ctlenp,
  2288. int gensecret);
  2289. __owur EVP_PKEY *ssl_dh_to_pkey(DH *dh);
  2290. __owur int ssl_set_tmp_ecdh_groups(uint16_t **pext, size_t *pextlen,
  2291. void *key);
  2292. __owur unsigned int ssl_get_max_send_fragment(const SSL_CONNECTION *sc);
  2293. __owur unsigned int ssl_get_split_send_fragment(const SSL_CONNECTION *sc);
  2294. __owur const SSL_CIPHER *ssl3_get_cipher_by_id(uint32_t id);
  2295. __owur const SSL_CIPHER *ssl3_get_cipher_by_std_name(const char *stdname);
  2296. __owur const SSL_CIPHER *ssl3_get_cipher_by_char(const unsigned char *p);
  2297. __owur int ssl3_put_cipher_by_char(const SSL_CIPHER *c, WPACKET *pkt,
  2298. size_t *len);
  2299. int ssl3_init_finished_mac(SSL_CONNECTION *s);
  2300. __owur int ssl3_setup_key_block(SSL_CONNECTION *s);
  2301. __owur int ssl3_change_cipher_state(SSL_CONNECTION *s, int which);
  2302. void ssl3_cleanup_key_block(SSL_CONNECTION *s);
  2303. __owur int ssl3_do_write(SSL_CONNECTION *s, uint8_t type);
  2304. int ssl3_send_alert(SSL_CONNECTION *s, int level, int desc);
  2305. __owur int ssl3_generate_master_secret(SSL_CONNECTION *s, unsigned char *out,
  2306. unsigned char *p, size_t len,
  2307. size_t *secret_size);
  2308. __owur int ssl3_get_req_cert_type(SSL_CONNECTION *s, WPACKET *pkt);
  2309. __owur int ssl3_num_ciphers(void);
  2310. __owur const SSL_CIPHER *ssl3_get_cipher(unsigned int u);
  2311. int ssl3_renegotiate(SSL *ssl);
  2312. int ssl3_renegotiate_check(SSL *ssl, int initok);
  2313. void ssl3_digest_master_key_set_params(const SSL_SESSION *session,
  2314. OSSL_PARAM params[]);
  2315. __owur int ssl3_dispatch_alert(SSL *s);
  2316. __owur size_t ssl3_final_finish_mac(SSL_CONNECTION *s, const char *sender,
  2317. size_t slen, unsigned char *p);
  2318. __owur int ssl3_finish_mac(SSL_CONNECTION *s, const unsigned char *buf,
  2319. size_t len);
  2320. void ssl3_free_digest_list(SSL_CONNECTION *s);
  2321. __owur unsigned long ssl3_output_cert_chain(SSL_CONNECTION *s, WPACKET *pkt,
  2322. CERT_PKEY *cpk, int for_comp);
  2323. __owur const SSL_CIPHER *ssl3_choose_cipher(SSL_CONNECTION *s,
  2324. STACK_OF(SSL_CIPHER) *clnt,
  2325. STACK_OF(SSL_CIPHER) *srvr);
  2326. __owur int ssl3_digest_cached_records(SSL_CONNECTION *s, int keep);
  2327. __owur int ssl3_new(SSL *s);
  2328. void ssl3_free(SSL *s);
  2329. __owur int ssl3_read(SSL *s, void *buf, size_t len, size_t *readbytes);
  2330. __owur int ssl3_peek(SSL *s, void *buf, size_t len, size_t *readbytes);
  2331. __owur int ssl3_write(SSL *s, const void *buf, size_t len, size_t *written);
  2332. __owur int ssl3_shutdown(SSL *s);
  2333. int ssl3_clear(SSL *s);
  2334. __owur long ssl3_ctrl(SSL *s, int cmd, long larg, void *parg);
  2335. __owur long ssl3_ctx_ctrl(SSL_CTX *s, int cmd, long larg, void *parg);
  2336. __owur long ssl3_callback_ctrl(SSL *s, int cmd, void (*fp) (void));
  2337. __owur long ssl3_ctx_callback_ctrl(SSL_CTX *s, int cmd, void (*fp) (void));
  2338. __owur int ssl3_do_change_cipher_spec(SSL_CONNECTION *s);
  2339. __owur OSSL_TIME ssl3_default_timeout(void);
  2340. __owur int ssl3_set_handshake_header(SSL_CONNECTION *s, WPACKET *pkt,
  2341. int htype);
  2342. __owur int tls_close_construct_packet(SSL_CONNECTION *s, WPACKET *pkt, int htype);
  2343. __owur int tls_setup_handshake(SSL_CONNECTION *s);
  2344. __owur int dtls1_set_handshake_header(SSL_CONNECTION *s, WPACKET *pkt, int htype);
  2345. __owur int dtls1_close_construct_packet(SSL_CONNECTION *s, WPACKET *pkt, int htype);
  2346. __owur int ssl3_handshake_write(SSL_CONNECTION *s);
  2347. __owur int ssl_allow_compression(SSL_CONNECTION *s);
  2348. __owur int ssl_version_cmp(const SSL_CONNECTION *s, int versiona, int versionb);
  2349. __owur int ssl_version_supported(const SSL_CONNECTION *s, int version,
  2350. const SSL_METHOD **meth);
  2351. __owur int ssl_set_client_hello_version(SSL_CONNECTION *s);
  2352. __owur int ssl_check_version_downgrade(SSL_CONNECTION *s);
  2353. __owur int ssl_set_version_bound(int method_version, int version, int *bound);
  2354. __owur int ssl_choose_server_version(SSL_CONNECTION *s, CLIENTHELLO_MSG *hello,
  2355. DOWNGRADE *dgrd);
  2356. __owur int ssl_choose_client_version(SSL_CONNECTION *s, int version,
  2357. RAW_EXTENSION *extensions);
  2358. __owur int ssl_get_min_max_version(const SSL_CONNECTION *s, int *min_version,
  2359. int *max_version, int *real_max);
  2360. __owur OSSL_TIME tls1_default_timeout(void);
  2361. __owur int dtls1_do_write(SSL_CONNECTION *s, uint8_t type);
  2362. void dtls1_set_message_header(SSL_CONNECTION *s,
  2363. unsigned char mt,
  2364. size_t len,
  2365. size_t frag_off, size_t frag_len);
  2366. int dtls1_write_app_data_bytes(SSL *s, uint8_t type, const void *buf_,
  2367. size_t len, size_t *written);
  2368. __owur int dtls1_read_failed(SSL_CONNECTION *s, int code);
  2369. __owur int dtls1_buffer_message(SSL_CONNECTION *s, int ccs);
  2370. __owur int dtls1_retransmit_message(SSL_CONNECTION *s, unsigned short seq,
  2371. int *found);
  2372. __owur int dtls1_get_queue_priority(unsigned short seq, int is_ccs);
  2373. int dtls1_retransmit_buffered_messages(SSL_CONNECTION *s);
  2374. void dtls1_clear_received_buffer(SSL_CONNECTION *s);
  2375. void dtls1_clear_sent_buffer(SSL_CONNECTION *s);
  2376. void dtls1_get_message_header(const unsigned char *data,
  2377. struct hm_header_st *msg_hdr);
  2378. __owur OSSL_TIME dtls1_default_timeout(void);
  2379. __owur int dtls1_get_timeout(const SSL_CONNECTION *s, OSSL_TIME *timeleft);
  2380. __owur int dtls1_check_timeout_num(SSL_CONNECTION *s);
  2381. __owur int dtls1_handle_timeout(SSL_CONNECTION *s);
  2382. void dtls1_start_timer(SSL_CONNECTION *s);
  2383. void dtls1_stop_timer(SSL_CONNECTION *s);
  2384. __owur int dtls1_is_timer_expired(SSL_CONNECTION *s);
  2385. __owur int dtls_raw_hello_verify_request(WPACKET *pkt, unsigned char *cookie,
  2386. size_t cookie_len);
  2387. __owur size_t dtls1_min_mtu(SSL_CONNECTION *s);
  2388. void dtls1_hm_fragment_free(hm_fragment *frag);
  2389. __owur int dtls1_query_mtu(SSL_CONNECTION *s);
  2390. __owur int tls1_new(SSL *s);
  2391. void tls1_free(SSL *s);
  2392. int tls1_clear(SSL *s);
  2393. __owur int dtls1_new(SSL *s);
  2394. void dtls1_free(SSL *s);
  2395. int dtls1_clear(SSL *s);
  2396. long dtls1_ctrl(SSL *s, int cmd, long larg, void *parg);
  2397. __owur int dtls1_shutdown(SSL *s);
  2398. __owur int dtls1_dispatch_alert(SSL *s);
  2399. __owur int ssl_init_wbio_buffer(SSL_CONNECTION *s);
  2400. int ssl_free_wbio_buffer(SSL_CONNECTION *s);
  2401. __owur int tls1_change_cipher_state(SSL_CONNECTION *s, int which);
  2402. __owur int tls1_setup_key_block(SSL_CONNECTION *s);
  2403. __owur size_t tls1_final_finish_mac(SSL_CONNECTION *s, const char *str,
  2404. size_t slen, unsigned char *p);
  2405. __owur int tls1_generate_master_secret(SSL_CONNECTION *s, unsigned char *out,
  2406. unsigned char *p, size_t len,
  2407. size_t *secret_size);
  2408. __owur int tls13_setup_key_block(SSL_CONNECTION *s);
  2409. __owur size_t tls13_final_finish_mac(SSL_CONNECTION *s, const char *str, size_t slen,
  2410. unsigned char *p);
  2411. __owur int tls13_change_cipher_state(SSL_CONNECTION *s, int which);
  2412. __owur int tls13_update_key(SSL_CONNECTION *s, int send);
  2413. __owur int tls13_hkdf_expand(SSL_CONNECTION *s,
  2414. const EVP_MD *md,
  2415. const unsigned char *secret,
  2416. const unsigned char *label, size_t labellen,
  2417. const unsigned char *data, size_t datalen,
  2418. unsigned char *out, size_t outlen, int fatal);
  2419. __owur int tls13_hkdf_expand_ex(OSSL_LIB_CTX *libctx, const char *propq,
  2420. const EVP_MD *md,
  2421. const unsigned char *secret,
  2422. const unsigned char *label, size_t labellen,
  2423. const unsigned char *data, size_t datalen,
  2424. unsigned char *out, size_t outlen,
  2425. int raise_error);
  2426. __owur int tls13_derive_key(SSL_CONNECTION *s, const EVP_MD *md,
  2427. const unsigned char *secret, unsigned char *key,
  2428. size_t keylen);
  2429. __owur int tls13_derive_iv(SSL_CONNECTION *s, const EVP_MD *md,
  2430. const unsigned char *secret, unsigned char *iv,
  2431. size_t ivlen);
  2432. __owur int tls13_derive_finishedkey(SSL_CONNECTION *s, const EVP_MD *md,
  2433. const unsigned char *secret,
  2434. unsigned char *fin, size_t finlen);
  2435. int tls13_generate_secret(SSL_CONNECTION *s, const EVP_MD *md,
  2436. const unsigned char *prevsecret,
  2437. const unsigned char *insecret,
  2438. size_t insecretlen,
  2439. unsigned char *outsecret);
  2440. __owur int tls13_generate_handshake_secret(SSL_CONNECTION *s,
  2441. const unsigned char *insecret,
  2442. size_t insecretlen);
  2443. __owur int tls13_generate_master_secret(SSL_CONNECTION *s, unsigned char *out,
  2444. unsigned char *prev, size_t prevlen,
  2445. size_t *secret_size);
  2446. __owur int tls1_export_keying_material(SSL_CONNECTION *s,
  2447. unsigned char *out, size_t olen,
  2448. const char *label, size_t llen,
  2449. const unsigned char *p, size_t plen,
  2450. int use_context);
  2451. __owur int tls13_export_keying_material(SSL_CONNECTION *s,
  2452. unsigned char *out, size_t olen,
  2453. const char *label, size_t llen,
  2454. const unsigned char *context,
  2455. size_t contextlen, int use_context);
  2456. __owur int tls13_export_keying_material_early(SSL_CONNECTION *s,
  2457. unsigned char *out, size_t olen,
  2458. const char *label, size_t llen,
  2459. const unsigned char *context,
  2460. size_t contextlen);
  2461. __owur int tls1_alert_code(int code);
  2462. __owur int tls13_alert_code(int code);
  2463. __owur int ssl3_alert_code(int code);
  2464. __owur int ssl_check_srvr_ecc_cert_and_alg(X509 *x, SSL_CONNECTION *s);
  2465. SSL_COMP *ssl3_comp_find(STACK_OF(SSL_COMP) *sk, int n);
  2466. __owur const TLS_GROUP_INFO *tls1_group_id_lookup(SSL_CTX *ctx, uint16_t curve_id);
  2467. __owur const char *tls1_group_id2name(SSL_CTX *ctx, uint16_t group_id);
  2468. __owur int tls1_group_id2nid(uint16_t group_id, int include_unknown);
  2469. __owur uint16_t tls1_nid2group_id(int nid);
  2470. __owur int tls1_check_group_id(SSL_CONNECTION *s, uint16_t group_id,
  2471. int check_own_curves);
  2472. __owur uint16_t tls1_shared_group(SSL_CONNECTION *s, int nmatch);
  2473. __owur int tls1_set_groups(uint16_t **pext, size_t *pextlen,
  2474. int *curves, size_t ncurves);
  2475. __owur int tls1_set_groups_list(SSL_CTX *ctx, uint16_t **pext, size_t *pextlen,
  2476. const char *str);
  2477. __owur EVP_PKEY *ssl_generate_pkey_group(SSL_CONNECTION *s, uint16_t id);
  2478. __owur int tls_valid_group(SSL_CONNECTION *s, uint16_t group_id, int minversion,
  2479. int maxversion, int isec, int *okfortls13);
  2480. __owur EVP_PKEY *ssl_generate_param_group(SSL_CONNECTION *s, uint16_t id);
  2481. void tls1_get_formatlist(SSL_CONNECTION *s, const unsigned char **pformats,
  2482. size_t *num_formats);
  2483. __owur int tls1_check_ec_tmp_key(SSL_CONNECTION *s, unsigned long id);
  2484. __owur int tls_group_allowed(SSL_CONNECTION *s, uint16_t curve, int op);
  2485. void tls1_get_supported_groups(SSL_CONNECTION *s, const uint16_t **pgroups,
  2486. size_t *pgroupslen);
  2487. __owur int tls1_set_server_sigalgs(SSL_CONNECTION *s);
  2488. __owur SSL_TICKET_STATUS tls_get_ticket_from_client(SSL_CONNECTION *s,
  2489. CLIENTHELLO_MSG *hello,
  2490. SSL_SESSION **ret);
  2491. __owur SSL_TICKET_STATUS tls_decrypt_ticket(SSL_CONNECTION *s,
  2492. const unsigned char *etick,
  2493. size_t eticklen,
  2494. const unsigned char *sess_id,
  2495. size_t sesslen, SSL_SESSION **psess);
  2496. __owur int tls_use_ticket(SSL_CONNECTION *s);
  2497. void ssl_set_sig_mask(uint32_t *pmask_a, SSL_CONNECTION *s, int op);
  2498. __owur int tls1_set_sigalgs_list(SSL_CTX *ctx, CERT *c, const char *str, int client);
  2499. __owur int tls1_set_raw_sigalgs(CERT *c, const uint16_t *psigs, size_t salglen,
  2500. int client);
  2501. __owur int tls1_set_sigalgs(CERT *c, const int *salg, size_t salglen,
  2502. int client);
  2503. int tls1_check_chain(SSL_CONNECTION *s, X509 *x, EVP_PKEY *pk,
  2504. STACK_OF(X509) *chain, int idx);
  2505. void tls1_set_cert_validity(SSL_CONNECTION *s);
  2506. # ifndef OPENSSL_NO_CT
  2507. __owur int ssl_validate_ct(SSL_CONNECTION *s);
  2508. # endif
  2509. __owur EVP_PKEY *ssl_get_auto_dh(SSL_CONNECTION *s);
  2510. __owur int ssl_security_cert(SSL_CONNECTION *s, SSL_CTX *ctx, X509 *x, int vfy,
  2511. int is_ee);
  2512. __owur int ssl_security_cert_chain(SSL_CONNECTION *s, STACK_OF(X509) *sk,
  2513. X509 *ex, int vfy);
  2514. int tls_choose_sigalg(SSL_CONNECTION *s, int fatalerrs);
  2515. __owur long ssl_get_algorithm2(SSL_CONNECTION *s);
  2516. __owur int tls12_copy_sigalgs(SSL_CONNECTION *s, WPACKET *pkt,
  2517. const uint16_t *psig, size_t psiglen);
  2518. __owur int tls1_save_u16(PACKET *pkt, uint16_t **pdest, size_t *pdestlen);
  2519. __owur int tls1_save_sigalgs(SSL_CONNECTION *s, PACKET *pkt, int cert);
  2520. __owur int tls1_process_sigalgs(SSL_CONNECTION *s);
  2521. __owur int tls1_set_peer_legacy_sigalg(SSL_CONNECTION *s, const EVP_PKEY *pkey);
  2522. __owur int tls1_lookup_md(SSL_CTX *ctx, const SIGALG_LOOKUP *lu,
  2523. const EVP_MD **pmd);
  2524. __owur size_t tls12_get_psigalgs(SSL_CONNECTION *s, int sent,
  2525. const uint16_t **psigs);
  2526. __owur int tls_check_sigalg_curve(const SSL_CONNECTION *s, int curve);
  2527. __owur int tls12_check_peer_sigalg(SSL_CONNECTION *s, uint16_t, EVP_PKEY *pkey);
  2528. __owur int ssl_set_client_disabled(SSL_CONNECTION *s);
  2529. __owur int ssl_cipher_disabled(const SSL_CONNECTION *s, const SSL_CIPHER *c,
  2530. int op, int echde);
  2531. __owur int ssl_handshake_hash(SSL_CONNECTION *s,
  2532. unsigned char *out, size_t outlen,
  2533. size_t *hashlen);
  2534. __owur const EVP_MD *ssl_md(SSL_CTX *ctx, int idx);
  2535. int ssl_get_md_idx(int md_nid);
  2536. __owur const EVP_MD *ssl_handshake_md(SSL_CONNECTION *s);
  2537. __owur const EVP_MD *ssl_prf_md(SSL_CONNECTION *s);
  2538. /*
  2539. * ssl_log_rsa_client_key_exchange logs |premaster| to the SSL_CTX associated
  2540. * with |ssl|, if logging is enabled. It returns one on success and zero on
  2541. * failure. The entry is identified by the first 8 bytes of
  2542. * |encrypted_premaster|.
  2543. */
  2544. __owur int ssl_log_rsa_client_key_exchange(SSL_CONNECTION *s,
  2545. const uint8_t *encrypted_premaster,
  2546. size_t encrypted_premaster_len,
  2547. const uint8_t *premaster,
  2548. size_t premaster_len);
  2549. /*
  2550. * ssl_log_secret logs |secret| to the SSL_CTX associated with |ssl|, if
  2551. * logging is available. It returns one on success and zero on failure. It tags
  2552. * the entry with |label|.
  2553. */
  2554. __owur int ssl_log_secret(SSL_CONNECTION *s, const char *label,
  2555. const uint8_t *secret, size_t secret_len);
  2556. #define MASTER_SECRET_LABEL "CLIENT_RANDOM"
  2557. #define CLIENT_EARLY_LABEL "CLIENT_EARLY_TRAFFIC_SECRET"
  2558. #define CLIENT_HANDSHAKE_LABEL "CLIENT_HANDSHAKE_TRAFFIC_SECRET"
  2559. #define SERVER_HANDSHAKE_LABEL "SERVER_HANDSHAKE_TRAFFIC_SECRET"
  2560. #define CLIENT_APPLICATION_LABEL "CLIENT_TRAFFIC_SECRET_0"
  2561. #define CLIENT_APPLICATION_N_LABEL "CLIENT_TRAFFIC_SECRET_N"
  2562. #define SERVER_APPLICATION_LABEL "SERVER_TRAFFIC_SECRET_0"
  2563. #define SERVER_APPLICATION_N_LABEL "SERVER_TRAFFIC_SECRET_N"
  2564. #define EARLY_EXPORTER_SECRET_LABEL "EARLY_EXPORTER_SECRET"
  2565. #define EXPORTER_SECRET_LABEL "EXPORTER_SECRET"
  2566. __owur int srp_generate_server_master_secret(SSL_CONNECTION *s);
  2567. __owur int srp_generate_client_master_secret(SSL_CONNECTION *s);
  2568. __owur int srp_verify_server_param(SSL_CONNECTION *s);
  2569. /* statem/statem_srvr.c */
  2570. __owur int send_certificate_request(SSL_CONNECTION *s);
  2571. /* statem/extensions_cust.c */
  2572. custom_ext_method *custom_ext_find(const custom_ext_methods *exts,
  2573. ENDPOINT role, unsigned int ext_type,
  2574. size_t *idx);
  2575. void custom_ext_init(custom_ext_methods *meths);
  2576. int ossl_tls_add_custom_ext_intern(SSL_CTX *ctx, custom_ext_methods *exts,
  2577. ENDPOINT role, unsigned int ext_type,
  2578. unsigned int context,
  2579. SSL_custom_ext_add_cb_ex add_cb,
  2580. SSL_custom_ext_free_cb_ex free_cb,
  2581. void *add_arg,
  2582. SSL_custom_ext_parse_cb_ex parse_cb,
  2583. void *parse_arg);
  2584. __owur int custom_ext_parse(SSL_CONNECTION *s, unsigned int context,
  2585. unsigned int ext_type,
  2586. const unsigned char *ext_data, size_t ext_size,
  2587. X509 *x, size_t chainidx);
  2588. __owur int custom_ext_add(SSL_CONNECTION *s, int context, WPACKET *pkt, X509 *x,
  2589. size_t chainidx, int maxversion);
  2590. __owur int custom_exts_copy(custom_ext_methods *dst,
  2591. const custom_ext_methods *src);
  2592. __owur int custom_exts_copy_flags(custom_ext_methods *dst,
  2593. const custom_ext_methods *src);
  2594. void custom_exts_free(custom_ext_methods *exts);
  2595. void ssl_comp_free_compression_methods_int(void);
  2596. /* ssl_mcnf.c */
  2597. void ssl_ctx_system_config(SSL_CTX *ctx);
  2598. const EVP_CIPHER *ssl_evp_cipher_fetch(OSSL_LIB_CTX *libctx,
  2599. int nid,
  2600. const char *properties);
  2601. int ssl_evp_cipher_up_ref(const EVP_CIPHER *cipher);
  2602. void ssl_evp_cipher_free(const EVP_CIPHER *cipher);
  2603. const EVP_MD *ssl_evp_md_fetch(OSSL_LIB_CTX *libctx,
  2604. int nid,
  2605. const char *properties);
  2606. int ssl_evp_md_up_ref(const EVP_MD *md);
  2607. void ssl_evp_md_free(const EVP_MD *md);
  2608. void tls_engine_finish(ENGINE *e);
  2609. const EVP_CIPHER *tls_get_cipher_from_engine(int nid);
  2610. const EVP_MD *tls_get_digest_from_engine(int nid);
  2611. int tls_engine_load_ssl_client_cert(SSL_CONNECTION *s, X509 **px509,
  2612. EVP_PKEY **ppkey);
  2613. int ssl_hmac_old_new(SSL_HMAC *ret);
  2614. void ssl_hmac_old_free(SSL_HMAC *ctx);
  2615. int ssl_hmac_old_init(SSL_HMAC *ctx, void *key, size_t len, char *md);
  2616. int ssl_hmac_old_update(SSL_HMAC *ctx, const unsigned char *data, size_t len);
  2617. int ssl_hmac_old_final(SSL_HMAC *ctx, unsigned char *md, size_t *len);
  2618. size_t ssl_hmac_old_size(const SSL_HMAC *ctx);
  2619. int ssl_ctx_srp_ctx_free_intern(SSL_CTX *ctx);
  2620. int ssl_ctx_srp_ctx_init_intern(SSL_CTX *ctx);
  2621. int ssl_srp_ctx_free_intern(SSL_CONNECTION *s);
  2622. int ssl_srp_ctx_init_intern(SSL_CONNECTION *s);
  2623. int ssl_srp_calc_a_param_intern(SSL_CONNECTION *s);
  2624. int ssl_srp_server_param_with_username_intern(SSL_CONNECTION *s, int *ad);
  2625. void ssl_session_calculate_timeout(SSL_SESSION *ss);
  2626. # else /* OPENSSL_UNIT_TEST */
  2627. # define ssl_init_wbio_buffer SSL_test_functions()->p_ssl_init_wbio_buffer
  2628. # endif
  2629. /* Some helper routines to support TSAN operations safely */
  2630. static ossl_unused ossl_inline int ssl_tsan_lock(const SSL_CTX *ctx)
  2631. {
  2632. #ifdef TSAN_REQUIRES_LOCKING
  2633. if (!CRYPTO_THREAD_write_lock(ctx->tsan_lock))
  2634. return 0;
  2635. #endif
  2636. return 1;
  2637. }
  2638. static ossl_unused ossl_inline void ssl_tsan_unlock(const SSL_CTX *ctx)
  2639. {
  2640. #ifdef TSAN_REQUIRES_LOCKING
  2641. CRYPTO_THREAD_unlock(ctx->tsan_lock);
  2642. #endif
  2643. }
  2644. static ossl_unused ossl_inline void ssl_tsan_counter(const SSL_CTX *ctx,
  2645. TSAN_QUALIFIER int *stat)
  2646. {
  2647. if (ssl_tsan_lock(ctx)) {
  2648. tsan_counter(stat);
  2649. ssl_tsan_unlock(ctx);
  2650. }
  2651. }
  2652. int ossl_comp_has_alg(int a);
  2653. size_t ossl_calculate_comp_expansion(int alg, size_t length);
  2654. void ossl_ssl_set_custom_record_layer(SSL_CONNECTION *s,
  2655. const OSSL_RECORD_METHOD *meth,
  2656. void *rlarg);
  2657. long ossl_ctrl_internal(SSL *s, int cmd, long larg, void *parg, int no_quic);
  2658. /*
  2659. * Options which no longer have any effect, but which can be implemented
  2660. * as no-ops for QUIC.
  2661. */
  2662. #define OSSL_LEGACY_SSL_OPTIONS \
  2663. (SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG | \
  2664. SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER | \
  2665. SSL_OP_SSLEAY_080_CLIENT_DH_BUG | \
  2666. SSL_OP_TLS_D5_BUG | \
  2667. SSL_OP_TLS_BLOCK_PADDING_BUG | \
  2668. SSL_OP_MSIE_SSLV2_RSA_PADDING | \
  2669. SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG | \
  2670. SSL_OP_MICROSOFT_SESS_ID_BUG | \
  2671. SSL_OP_NETSCAPE_CHALLENGE_BUG | \
  2672. SSL_OP_PKCS1_CHECK_1 | \
  2673. SSL_OP_PKCS1_CHECK_2 | \
  2674. SSL_OP_SINGLE_DH_USE | \
  2675. SSL_OP_SINGLE_ECDH_USE | \
  2676. SSL_OP_EPHEMERAL_RSA )
  2677. /* This option is undefined in public headers with no-dtls1-method. */
  2678. #ifndef SSL_OP_CISCO_ANYCONNECT
  2679. # define SSL_OP_CISCO_ANYCONNECT 0
  2680. #endif
  2681. /*
  2682. * Options which are no-ops under QUIC or TLSv1.3 and which are therefore
  2683. * allowed but ignored under QUIC.
  2684. */
  2685. #define OSSL_TLS1_2_OPTIONS \
  2686. (SSL_OP_CRYPTOPRO_TLSEXT_BUG | \
  2687. SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS | \
  2688. SSL_OP_ALLOW_CLIENT_RENEGOTIATION | \
  2689. SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION | \
  2690. SSL_OP_NO_COMPRESSION | \
  2691. SSL_OP_NO_SSLv3 | \
  2692. SSL_OP_NO_TLSv1 | \
  2693. SSL_OP_NO_TLSv1_1 | \
  2694. SSL_OP_NO_TLSv1_2 | \
  2695. SSL_OP_NO_DTLSv1 | \
  2696. SSL_OP_NO_DTLSv1_2 | \
  2697. SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION | \
  2698. SSL_OP_CISCO_ANYCONNECT | \
  2699. SSL_OP_NO_RENEGOTIATION | \
  2700. SSL_OP_NO_EXTENDED_MASTER_SECRET | \
  2701. SSL_OP_NO_ENCRYPT_THEN_MAC | \
  2702. SSL_OP_COOKIE_EXCHANGE | \
  2703. SSL_OP_LEGACY_SERVER_CONNECT | \
  2704. SSL_OP_IGNORE_UNEXPECTED_EOF )
  2705. /* Total mask of connection-level options permitted or ignored under QUIC. */
  2706. #define OSSL_QUIC_PERMITTED_OPTIONS_CONN \
  2707. (OSSL_LEGACY_SSL_OPTIONS | \
  2708. OSSL_TLS1_2_OPTIONS | \
  2709. SSL_OP_CIPHER_SERVER_PREFERENCE | \
  2710. SSL_OP_DISABLE_TLSEXT_CA_NAMES | \
  2711. SSL_OP_NO_TX_CERTIFICATE_COMPRESSION | \
  2712. SSL_OP_NO_RX_CERTIFICATE_COMPRESSION | \
  2713. SSL_OP_PRIORITIZE_CHACHA | \
  2714. SSL_OP_NO_QUERY_MTU | \
  2715. SSL_OP_NO_TICKET | \
  2716. SSL_OP_NO_ANTI_REPLAY )
  2717. /* Total mask of stream-level options permitted or ignored under QUIC. */
  2718. #define OSSL_QUIC_PERMITTED_OPTIONS_STREAM \
  2719. (OSSL_LEGACY_SSL_OPTIONS | \
  2720. OSSL_TLS1_2_OPTIONS | \
  2721. SSL_OP_CLEANSE_PLAINTEXT )
  2722. /* Total mask of options permitted on either connections or streams. */
  2723. #define OSSL_QUIC_PERMITTED_OPTIONS \
  2724. (OSSL_QUIC_PERMITTED_OPTIONS_CONN | \
  2725. OSSL_QUIC_PERMITTED_OPTIONS_STREAM)
  2726. #endif