tls13.c 425 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981998299839984998599869987998899899990999199929993999499959996999799989999100001000110002100031000410005100061000710008100091001010011100121001310014100151001610017100181001910020100211002210023100241002510026100271002810029100301003110032100331003410035100361003710038100391004010041100421004310044100451004610047100481004910050100511005210053100541005510056100571005810059100601006110062100631006410065100661006710068100691007010071100721007310074100751007610077100781007910080100811008210083100841008510086100871008810089100901009110092100931009410095100961009710098100991010010101101021010310104101051010610107101081010910110101111011210113101141011510116101171011810119101201012110122101231012410125101261012710128101291013010131101321013310134101351013610137101381013910140101411014210143101441014510146101471014810149101501015110152101531015410155101561015710158101591016010161101621016310164101651016610167101681016910170101711017210173101741017510176101771017810179101801018110182101831018410185101861018710188101891019010191101921019310194101951019610197101981019910200102011020210203102041020510206102071020810209102101021110212102131021410215102161021710218102191022010221102221022310224102251022610227102281022910230102311023210233102341023510236102371023810239102401024110242102431024410245102461024710248102491025010251102521025310254102551025610257102581025910260102611026210263102641026510266102671026810269102701027110272102731027410275102761027710278102791028010281102821028310284102851028610287102881028910290102911029210293102941029510296102971029810299103001030110302103031030410305103061030710308103091031010311103121031310314103151031610317103181031910320103211032210323103241032510326103271032810329103301033110332103331033410335103361033710338103391034010341103421034310344103451034610347103481034910350103511035210353103541035510356103571035810359103601036110362103631036410365103661036710368103691037010371103721037310374103751037610377103781037910380103811038210383103841038510386103871038810389103901039110392103931039410395103961039710398103991040010401104021040310404104051040610407104081040910410104111041210413104141041510416104171041810419104201042110422104231042410425104261042710428104291043010431104321043310434104351043610437104381043910440104411044210443104441044510446104471044810449104501045110452104531045410455104561045710458104591046010461104621046310464104651046610467104681046910470104711047210473104741047510476104771047810479104801048110482104831048410485104861048710488104891049010491104921049310494104951049610497104981049910500105011050210503105041050510506105071050810509105101051110512105131051410515105161051710518105191052010521105221052310524105251052610527105281052910530105311053210533105341053510536105371053810539105401054110542105431054410545105461054710548105491055010551105521055310554105551055610557105581055910560105611056210563105641056510566105671056810569105701057110572105731057410575105761057710578105791058010581105821058310584105851058610587105881058910590105911059210593105941059510596105971059810599106001060110602106031060410605106061060710608106091061010611106121061310614106151061610617106181061910620106211062210623106241062510626106271062810629106301063110632106331063410635106361063710638106391064010641106421064310644106451064610647106481064910650106511065210653106541065510656106571065810659106601066110662106631066410665106661066710668106691067010671106721067310674106751067610677106781067910680106811068210683106841068510686106871068810689106901069110692106931069410695106961069710698106991070010701107021070310704107051070610707107081070910710107111071210713107141071510716107171071810719107201072110722107231072410725107261072710728107291073010731107321073310734107351073610737107381073910740107411074210743107441074510746107471074810749107501075110752107531075410755107561075710758107591076010761107621076310764107651076610767107681076910770107711077210773107741077510776107771077810779107801078110782107831078410785107861078710788107891079010791107921079310794107951079610797107981079910800108011080210803108041080510806108071080810809108101081110812108131081410815108161081710818108191082010821108221082310824108251082610827108281082910830108311083210833108341083510836108371083810839108401084110842108431084410845108461084710848108491085010851108521085310854108551085610857108581085910860108611086210863108641086510866108671086810869108701087110872108731087410875108761087710878108791088010881108821088310884108851088610887108881088910890108911089210893108941089510896108971089810899109001090110902109031090410905109061090710908109091091010911109121091310914109151091610917109181091910920109211092210923109241092510926109271092810929109301093110932109331093410935109361093710938109391094010941109421094310944109451094610947109481094910950109511095210953109541095510956109571095810959109601096110962109631096410965109661096710968109691097010971109721097310974109751097610977109781097910980109811098210983109841098510986109871098810989109901099110992109931099410995109961099710998109991100011001110021100311004110051100611007110081100911010110111101211013110141101511016110171101811019110201102111022110231102411025110261102711028110291103011031110321103311034110351103611037110381103911040110411104211043110441104511046110471104811049110501105111052110531105411055110561105711058110591106011061110621106311064110651106611067110681106911070110711107211073110741107511076110771107811079110801108111082110831108411085110861108711088110891109011091110921109311094110951109611097110981109911100111011110211103111041110511106111071110811109111101111111112111131111411115111161111711118111191112011121111221112311124111251112611127111281112911130111311113211133111341113511136111371113811139111401114111142111431114411145111461114711148111491115011151111521115311154111551115611157111581115911160111611116211163111641116511166111671116811169111701117111172111731117411175111761117711178111791118011181111821118311184111851118611187111881118911190111911119211193111941119511196111971119811199112001120111202112031120411205112061120711208112091121011211112121121311214112151121611217112181121911220112211122211223112241122511226112271122811229112301123111232112331123411235112361123711238112391124011241112421124311244112451124611247112481124911250112511125211253112541125511256112571125811259112601126111262112631126411265112661126711268112691127011271112721127311274112751127611277112781127911280112811128211283112841128511286112871128811289112901129111292112931129411295112961129711298112991130011301113021130311304113051130611307113081130911310113111131211313113141131511316113171131811319113201132111322113231132411325113261132711328113291133011331113321133311334113351133611337113381133911340113411134211343113441134511346113471134811349113501135111352113531135411355113561135711358113591136011361113621136311364113651136611367113681136911370113711137211373113741137511376113771137811379113801138111382113831138411385113861138711388113891139011391113921139311394113951139611397113981139911400114011140211403114041140511406114071140811409114101141111412114131141411415114161141711418114191142011421114221142311424114251142611427114281142911430114311143211433114341143511436114371143811439114401144111442114431144411445114461144711448114491145011451114521145311454114551145611457114581145911460114611146211463114641146511466114671146811469114701147111472114731147411475114761147711478114791148011481114821148311484114851148611487114881148911490114911149211493114941149511496114971149811499115001150111502115031150411505115061150711508115091151011511115121151311514115151151611517115181151911520115211152211523115241152511526115271152811529115301153111532115331153411535115361153711538115391154011541115421154311544115451154611547115481154911550115511155211553115541155511556115571155811559115601156111562115631156411565115661156711568115691157011571115721157311574115751157611577115781157911580115811158211583115841158511586115871158811589115901159111592115931159411595115961159711598115991160011601116021160311604116051160611607116081160911610116111161211613116141161511616116171161811619116201162111622116231162411625116261162711628116291163011631116321163311634116351163611637116381163911640116411164211643116441164511646116471164811649116501165111652116531165411655116561165711658116591166011661116621166311664116651166611667116681166911670116711167211673116741167511676116771167811679116801168111682116831168411685116861168711688116891169011691116921169311694116951169611697116981169911700117011170211703117041170511706117071170811709117101171111712117131171411715117161171711718117191172011721117221172311724117251172611727117281172911730117311173211733117341173511736117371173811739117401174111742117431174411745117461174711748117491175011751117521175311754117551175611757117581175911760117611176211763117641176511766117671176811769117701177111772117731177411775117761177711778117791178011781117821178311784117851178611787117881178911790117911179211793117941179511796117971179811799118001180111802118031180411805118061180711808118091181011811118121181311814118151181611817118181181911820118211182211823118241182511826118271182811829118301183111832118331183411835118361183711838118391184011841118421184311844118451184611847118481184911850118511185211853118541185511856118571185811859118601186111862118631186411865118661186711868118691187011871118721187311874118751187611877118781187911880118811188211883118841188511886118871188811889118901189111892118931189411895118961189711898118991190011901119021190311904119051190611907119081190911910119111191211913119141191511916119171191811919119201192111922119231192411925119261192711928119291193011931119321193311934119351193611937119381193911940119411194211943119441194511946119471194811949119501195111952119531195411955119561195711958119591196011961119621196311964119651196611967119681196911970119711197211973119741197511976119771197811979119801198111982119831198411985119861198711988119891199011991119921199311994119951199611997119981199912000120011200212003120041200512006120071200812009120101201112012120131201412015120161201712018120191202012021120221202312024120251202612027120281202912030120311203212033120341203512036120371203812039120401204112042120431204412045120461204712048120491205012051120521205312054120551205612057120581205912060120611206212063120641206512066120671206812069120701207112072120731207412075120761207712078120791208012081120821208312084120851208612087120881208912090120911209212093120941209512096120971209812099121001210112102121031210412105121061210712108121091211012111121121211312114121151211612117121181211912120121211212212123121241212512126121271212812129121301213112132121331213412135121361213712138121391214012141121421214312144121451214612147121481214912150121511215212153121541215512156121571215812159121601216112162121631216412165121661216712168121691217012171121721217312174121751217612177121781217912180121811218212183121841218512186121871218812189121901219112192121931219412195121961219712198121991220012201122021220312204122051220612207122081220912210122111221212213122141221512216122171221812219122201222112222122231222412225122261222712228122291223012231122321223312234122351223612237122381223912240122411224212243122441224512246122471224812249122501225112252122531225412255122561225712258122591226012261122621226312264122651226612267122681226912270122711227212273122741227512276122771227812279122801228112282122831228412285122861228712288122891229012291122921229312294122951229612297122981229912300123011230212303123041230512306123071230812309123101231112312123131231412315123161231712318123191232012321123221232312324123251232612327123281232912330123311233212333123341233512336123371233812339123401234112342123431234412345123461234712348123491235012351123521235312354123551235612357123581235912360123611236212363123641236512366123671236812369123701237112372123731237412375123761237712378123791238012381123821238312384123851238612387123881238912390123911239212393123941239512396123971239812399124001240112402124031240412405124061240712408124091241012411124121241312414124151241612417124181241912420124211242212423124241242512426124271242812429124301243112432124331243412435124361243712438124391244012441124421244312444124451244612447124481244912450124511245212453124541245512456124571245812459124601246112462124631246412465124661246712468124691247012471124721247312474124751247612477124781247912480124811248212483124841248512486124871248812489124901249112492124931249412495124961249712498124991250012501125021250312504125051250612507125081250912510125111251212513125141251512516125171251812519125201252112522125231252412525125261252712528125291253012531125321253312534125351253612537125381253912540125411254212543125441254512546125471254812549125501255112552125531255412555125561255712558125591256012561125621256312564125651256612567125681256912570125711257212573125741257512576125771257812579125801258112582125831258412585125861258712588125891259012591125921259312594125951259612597125981259912600126011260212603126041260512606126071260812609126101261112612126131261412615126161261712618126191262012621126221262312624126251262612627126281262912630126311263212633126341263512636126371263812639126401264112642126431264412645126461264712648126491265012651126521265312654126551265612657126581265912660126611266212663126641266512666126671266812669126701267112672126731267412675126761267712678126791268012681126821268312684126851268612687126881268912690126911269212693126941269512696126971269812699127001270112702127031270412705127061270712708127091271012711127121271312714127151271612717127181271912720127211272212723127241272512726127271272812729127301273112732127331273412735127361273712738127391274012741127421274312744127451274612747127481274912750127511275212753127541275512756127571275812759127601276112762127631276412765127661276712768127691277012771127721277312774127751277612777127781277912780127811278212783127841278512786127871278812789127901279112792127931279412795127961279712798127991280012801128021280312804128051280612807128081280912810128111281212813128141281512816128171281812819128201282112822128231282412825128261282712828128291283012831128321283312834128351283612837128381283912840128411284212843128441284512846128471284812849128501285112852128531285412855128561285712858128591286012861128621286312864128651286612867128681286912870128711287212873128741287512876128771287812879128801288112882128831288412885128861288712888128891289012891128921289312894128951289612897128981289912900129011290212903129041290512906129071290812909129101291112912129131291412915129161291712918129191292012921129221292312924129251292612927129281292912930129311293212933129341293512936129371293812939129401294112942129431294412945129461294712948129491295012951129521295312954129551295612957129581295912960129611296212963129641296512966129671296812969129701297112972129731297412975129761297712978129791298012981129821298312984129851298612987129881298912990129911299212993129941299512996129971299812999130001300113002130031300413005130061300713008130091301013011130121301313014130151301613017130181301913020130211302213023130241302513026130271302813029130301303113032130331303413035130361303713038130391304013041130421304313044130451304613047130481304913050130511305213053130541305513056130571305813059130601306113062130631306413065130661306713068130691307013071130721307313074130751307613077130781307913080130811308213083130841308513086130871308813089130901309113092130931309413095130961309713098130991310013101131021310313104131051310613107131081310913110131111311213113131141311513116131171311813119131201312113122131231312413125131261312713128131291313013131131321313313134131351313613137131381313913140131411314213143131441314513146131471314813149131501315113152131531315413155131561315713158131591316013161131621316313164131651316613167131681316913170131711317213173131741317513176131771317813179131801318113182131831318413185131861318713188131891319013191131921319313194131951319613197131981319913200132011320213203132041320513206132071320813209132101321113212132131321413215132161321713218
  1. /* tls13.c
  2. *
  3. * Copyright (C) 2006-2023 wolfSSL Inc.
  4. *
  5. * This file is part of wolfSSL.
  6. *
  7. * wolfSSL is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU General Public License as published by
  9. * the Free Software Foundation; either version 2 of the License, or
  10. * (at your option) any later version.
  11. *
  12. * wolfSSL is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15. * GNU General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU General Public License
  18. * along with this program; if not, write to the Free Software
  19. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335, USA
  20. */
  21. /*
  22. * BUILD_GCM
  23. * Enables AES-GCM ciphersuites.
  24. * HAVE_AESCCM
  25. * Enables AES-CCM ciphersuites.
  26. * HAVE_SESSION_TICKET
  27. * Enables session tickets - required for TLS 1.3 resumption.
  28. * NO_PSK
  29. * Do not enable Pre-Shared Keys.
  30. * HAVE_KEYING_MATERIAL
  31. * Enables exporting keying material based on section 7.5 of RFC 8446.
  32. * WOLFSSL_ASYNC_CRYPT
  33. * Enables the use of asynchronous cryptographic operations.
  34. * This is available for ciphers and certificates.
  35. * HAVE_CHACHA && HAVE_POLY1305
  36. * Enables use of CHACHA20-POLY1305 ciphersuites.
  37. * WOLFSSL_DEBUG_TLS
  38. * Writes out details of TLS 1.3 protocol including handshake message buffers
  39. * and key generation input and output.
  40. * WOLFSSL_EARLY_DATA
  41. * Allow 0-RTT Handshake using Early Data extensions and handshake message
  42. * WOLFSSL_EARLY_DATA_GROUP
  43. * Group EarlyData message with ClientHello when sending
  44. * WOLFSSL_NO_SERVER_GROUPS_EXT
  45. * Do not send the server's groups in an extension when the server's top
  46. * preference is not in client's list.
  47. * WOLFSSL_POST_HANDSHAKE_AUTH
  48. * Allow TLS v1.3 code to perform post-handshake authentication of the
  49. * client.
  50. * WOLFSSL_SEND_HRR_COOKIE
  51. * Send a cookie in hello_retry_request message to enable stateless tracking
  52. * of ClientHello replies.
  53. * WOLFSSL_TLS13
  54. * Enable TLS 1.3 protocol implementation.
  55. * WOLFSSL_TLS13_MIDDLEBOX_COMPAT
  56. * Enable middlebox compatibility in the TLS 1.3 handshake.
  57. * This includes sending ChangeCipherSpec before encrypted messages and
  58. * including a session id.
  59. * WOLFSSL_TLS13_SHA512
  60. * Allow generation of SHA-512 digests in handshake - no ciphersuite
  61. * requires SHA-512 at this time.
  62. * WOLFSSL_TLS13_TICKET_BEFORE_FINISHED
  63. * Allow a NewSessionTicket message to be sent by server before Client's
  64. * Finished message.
  65. * See TLS v1.3 specification, Section 4.6.1, Paragraph 4 (Note).
  66. * WOLFSSL_PSK_ONE_ID
  67. * When only one PSK ID is used and only one call to the PSK callback can
  68. * be made per connect.
  69. * You cannot use wc_psk_client_cs_callback type callback on client.
  70. * WOLFSSL_CHECK_ALERT_ON_ERR
  71. * Check for alerts during the handshake in the event of an error.
  72. * WOLFSSL_NO_CLIENT_CERT_ERROR
  73. * Requires client to set a client certificate
  74. * WOLFSSL_PSK_MULTI_ID_PER_CS
  75. * When multiple PSK identities are available for the same cipher suite.
  76. * Sets the first byte of the client identity to the count of identites
  77. * that have been seen so far for the cipher suite.
  78. * WOLFSSL_CHECK_SIG_FAULTS
  79. * Verifies the ECC signature after signing in case of faults in the
  80. * calculation of the signature. Useful when signature fault injection is a
  81. * possible attack.
  82. * WOLFSSL_32BIT_MILLI_TIME
  83. * Function TimeNowInMilliseconds() returns an unsigned 32-bit value.
  84. * Default behavior is to return a signed 64-bit value.
  85. */
  86. #ifdef HAVE_CONFIG_H
  87. #include <config.h>
  88. #endif
  89. #include <wolfssl/wolfcrypt/settings.h>
  90. #ifdef WOLFSSL_TLS13
  91. #ifdef HAVE_SESSION_TICKET
  92. #include <wolfssl/wolfcrypt/wc_port.h>
  93. #endif
  94. #ifndef WOLFCRYPT_ONLY
  95. #ifdef HAVE_ERRNO_H
  96. #include <errno.h>
  97. #endif
  98. #if defined(__MACH__) || defined(__FreeBSD__) || defined(__INCLUDE_NUTTX_CONFIG_H)
  99. #include <sys/time.h>
  100. #endif /* __MACH__ || __FreeBSD__ || __INCLUDE_NUTTX_CONFIG_H */
  101. #include <wolfssl/internal.h>
  102. #include <wolfssl/error-ssl.h>
  103. #include <wolfssl/wolfcrypt/asn.h>
  104. #include <wolfssl/wolfcrypt/dh.h>
  105. #include <wolfssl/wolfcrypt/kdf.h>
  106. #ifdef NO_INLINE
  107. #include <wolfssl/wolfcrypt/misc.h>
  108. #else
  109. #define WOLFSSL_MISC_INCLUDED
  110. #include <wolfcrypt/src/misc.c>
  111. #endif
  112. #ifdef __sun
  113. #include <sys/filio.h>
  114. #endif
  115. #ifndef TRUE
  116. #define TRUE 1
  117. #endif
  118. #ifndef FALSE
  119. #define FALSE 0
  120. #endif
  121. #ifndef HAVE_HKDF
  122. #ifndef _MSC_VER
  123. #error "The build option HAVE_HKDF is required for TLS 1.3"
  124. #else
  125. #pragma message("error: The build option HAVE_HKDF is required for TLS 1.3")
  126. #endif
  127. #endif
  128. #ifndef HAVE_TLS_EXTENSIONS
  129. #ifndef _MSC_VER
  130. #error "The build option HAVE_TLS_EXTENSIONS is required for TLS 1.3"
  131. #else
  132. #pragma message("error: The build option HAVE_TLS_EXTENSIONS is required for TLS 1.3")
  133. #endif
  134. #endif
  135. /* Set ret to error value and jump to label.
  136. *
  137. * err The error value to set.
  138. * eLabel The label to jump to.
  139. */
  140. #define ERROR_OUT(err, eLabel) { ret = (err); goto eLabel; }
  141. /* Size of the TLS v1.3 label use when deriving keys. */
  142. #define TLS13_PROTOCOL_LABEL_SZ 6
  143. /* The protocol label for TLS v1.3. */
  144. static const byte tls13ProtocolLabel[TLS13_PROTOCOL_LABEL_SZ + 1] = "tls13 ";
  145. #ifdef WOLFSSL_DTLS13
  146. #define DTLS13_PROTOCOL_LABEL_SZ 6
  147. static const byte dtls13ProtocolLabel[DTLS13_PROTOCOL_LABEL_SZ + 1] = "dtls13";
  148. #endif /* WOLFSSL_DTLS13 */
  149. #if defined(HAVE_ECH)
  150. #define ECH_ACCEPT_CONFIRMATION_SZ 8
  151. #define ECH_ACCEPT_CONFIRMATION_LABEL_SZ 23
  152. static const byte
  153. echAcceptConfirmationLabel[ECH_ACCEPT_CONFIRMATION_LABEL_SZ + 1] =
  154. "ech accept confirmation";
  155. #endif
  156. #ifndef NO_CERTS
  157. #if !defined(NO_RSA) || defined(HAVE_ECC) || defined(HAVE_ED25519) || \
  158. defined(HAVE_ED448) || defined(HAVE_PQC)
  159. static WC_INLINE int GetMsgHash(WOLFSSL* ssl, byte* hash);
  160. #endif
  161. #endif
  162. /* Expand data using HMAC, salt and label and info.
  163. * TLS v1.3 defines this function. Use callback if available.
  164. *
  165. * ssl The SSL/TLS object.
  166. * okm The generated pseudorandom key - output key material.
  167. * okmLen The length of generated pseudorandom key -
  168. * output key material.
  169. * prk The salt - pseudo-random key.
  170. * prkLen The length of the salt - pseudo-random key.
  171. * protocol The TLS protocol label.
  172. * protocolLen The length of the TLS protocol label.
  173. * info The information to expand.
  174. * infoLen The length of the information.
  175. * digest The type of digest to use.
  176. * returns 0 on success, otherwise failure.
  177. */
  178. static int Tls13HKDFExpandLabel(WOLFSSL* ssl, byte* okm, word32 okmLen,
  179. const byte* prk, word32 prkLen,
  180. const byte* protocol, word32 protocolLen,
  181. const byte* label, word32 labelLen,
  182. const byte* info, word32 infoLen,
  183. int digest)
  184. {
  185. int ret = NOT_COMPILED_IN;
  186. #if defined(HAVE_PK_CALLBACKS)
  187. if (ssl->ctx && ssl->ctx->HKDFExpandLabelCb) {
  188. ret = ssl->ctx->HKDFExpandLabelCb(okm, okmLen, prk, prkLen,
  189. protocol, protocolLen,
  190. label, labelLen,
  191. info, infoLen, digest,
  192. WOLFSSL_CLIENT_END /* ignored */);
  193. }
  194. if (ret != NOT_COMPILED_IN)
  195. return ret;
  196. #endif
  197. (void)ssl;
  198. PRIVATE_KEY_UNLOCK();
  199. ret = wc_Tls13_HKDF_Expand_Label(okm, okmLen, prk, prkLen,
  200. protocol, protocolLen,
  201. label, labelLen,
  202. info, infoLen, digest);
  203. PRIVATE_KEY_LOCK();
  204. return ret;
  205. }
  206. #if !defined(HAVE_FIPS) || !defined(wc_Tls13_HKDF_Expand_Label)
  207. /* Same as above, but pass in the side we are expanding for.
  208. *
  209. * side The side (WOLFSSL_CLIENT_END or WOLFSSL_SERVER_END).
  210. */
  211. static int Tls13HKDFExpandKeyLabel(WOLFSSL* ssl, byte* okm, word32 okmLen,
  212. const byte* prk, word32 prkLen,
  213. const byte* protocol, word32 protocolLen,
  214. const byte* label, word32 labelLen,
  215. const byte* info, word32 infoLen,
  216. int digest, int side)
  217. {
  218. #if defined(HAVE_PK_CALLBACKS)
  219. int ret = NOT_COMPILED_IN;
  220. if (ssl->ctx && ssl->ctx->HKDFExpandLabelCb) {
  221. ret = ssl->ctx->HKDFExpandLabelCb(okm, okmLen, prk, prkLen,
  222. protocol, protocolLen,
  223. label, labelLen,
  224. info, infoLen,
  225. digest, side);
  226. }
  227. if (ret != NOT_COMPILED_IN)
  228. return ret;
  229. #endif
  230. /* hash buffer may not be fully initialized, but the sending length won't
  231. * extend beyond the initialized span.
  232. */
  233. PRAGMA_GCC_DIAG_PUSH;
  234. PRAGMA_GCC("GCC diagnostic ignored \"-Wmaybe-uninitialized\"");
  235. (void)ssl;
  236. (void)side;
  237. return wc_Tls13_HKDF_Expand_Label(okm, okmLen, prk, prkLen,
  238. protocol, protocolLen,
  239. label, labelLen,
  240. info, infoLen, digest);
  241. PRAGMA_GCC_DIAG_POP;
  242. }
  243. #endif /* !HAVE_FIPS || !wc_Tls13_HKDF_Expand_Label */
  244. /* Derive a key from a message.
  245. *
  246. * ssl The SSL/TLS object.
  247. * output The buffer to hold the derived key.
  248. * outputLen The length of the derived key.
  249. * secret The secret used to derive the key (HMAC secret).
  250. * label The label used to distinguish the context.
  251. * labelLen The length of the label.
  252. * msg The message data to derive key from.
  253. * msgLen The length of the message data to derive key from.
  254. * hashAlgo The hash algorithm to use in the HMAC.
  255. * returns 0 on success, otherwise failure.
  256. */
  257. static int DeriveKeyMsg(WOLFSSL* ssl, byte* output, int outputLen,
  258. const byte* secret, const byte* label, word32 labelLen,
  259. byte* msg, int msgLen, int hashAlgo)
  260. {
  261. byte hash[WC_MAX_DIGEST_SIZE];
  262. Digest digest;
  263. word32 hashSz = 0;
  264. const byte* protocol;
  265. word32 protocolLen;
  266. int digestAlg = -1;
  267. int ret = BAD_FUNC_ARG;
  268. switch (hashAlgo) {
  269. #ifndef NO_WOLFSSL_SHA256
  270. case sha256_mac:
  271. ret = wc_InitSha256_ex(&digest.sha256, ssl->heap, INVALID_DEVID);
  272. if (ret == 0) {
  273. ret = wc_Sha256Update(&digest.sha256, msg, msgLen);
  274. if (ret == 0)
  275. ret = wc_Sha256Final(&digest.sha256, hash);
  276. wc_Sha256Free(&digest.sha256);
  277. }
  278. hashSz = WC_SHA256_DIGEST_SIZE;
  279. digestAlg = WC_SHA256;
  280. break;
  281. #endif
  282. #ifdef WOLFSSL_SHA384
  283. case sha384_mac:
  284. ret = wc_InitSha384_ex(&digest.sha384, ssl->heap, INVALID_DEVID);
  285. if (ret == 0) {
  286. ret = wc_Sha384Update(&digest.sha384, msg, msgLen);
  287. if (ret == 0)
  288. ret = wc_Sha384Final(&digest.sha384, hash);
  289. wc_Sha384Free(&digest.sha384);
  290. }
  291. hashSz = WC_SHA384_DIGEST_SIZE;
  292. digestAlg = WC_SHA384;
  293. break;
  294. #endif
  295. #ifdef WOLFSSL_TLS13_SHA512
  296. case sha512_mac:
  297. ret = wc_InitSha512_ex(&digest.sha512, ssl->heap, INVALID_DEVID);
  298. if (ret == 0) {
  299. ret = wc_Sha512Update(&digest.sha512, msg, msgLen);
  300. if (ret == 0)
  301. ret = wc_Sha512Final(&digest.sha512, hash);
  302. wc_Sha512Free(&digest.sha512);
  303. }
  304. hashSz = WC_SHA512_DIGEST_SIZE;
  305. digestAlg = WC_SHA512;
  306. break;
  307. #endif
  308. default:
  309. digestAlg = -1;
  310. break;
  311. }
  312. if (digestAlg < 0)
  313. return HASH_TYPE_E;
  314. if (ret != 0)
  315. return ret;
  316. switch (ssl->version.minor) {
  317. case TLSv1_3_MINOR:
  318. protocol = tls13ProtocolLabel;
  319. protocolLen = TLS13_PROTOCOL_LABEL_SZ;
  320. break;
  321. #ifdef WOLFSSL_DTLS13
  322. case DTLSv1_3_MINOR:
  323. if (!ssl->options.dtls)
  324. return VERSION_ERROR;
  325. protocol = dtls13ProtocolLabel;
  326. protocolLen = DTLS13_PROTOCOL_LABEL_SZ;
  327. break;
  328. #endif /* WOLFSSL_DTLS13 */
  329. default:
  330. return VERSION_ERROR;
  331. }
  332. if (outputLen == -1)
  333. outputLen = hashSz;
  334. ret = Tls13HKDFExpandLabel(ssl, output, outputLen, secret, hashSz,
  335. protocol, protocolLen, label, labelLen,
  336. hash, hashSz, digestAlg);
  337. return ret;
  338. }
  339. /* Derive a key.
  340. *
  341. * ssl The SSL/TLS object.
  342. * output The buffer to hold the derived key.
  343. * outputLen The length of the derived key.
  344. * secret The secret used to derive the key (HMAC secret).
  345. * label The label used to distinguish the context.
  346. * labelLen The length of the label.
  347. * hashAlgo The hash algorithm to use in the HMAC.
  348. * includeMsgs Whether to include a hash of the handshake messages so far.
  349. * side The side that we are deriving the secret for.
  350. * returns 0 on success, otherwise failure.
  351. */
  352. int Tls13DeriveKey(WOLFSSL* ssl, byte* output, int outputLen,
  353. const byte* secret, const byte* label, word32 labelLen,
  354. int hashAlgo, int includeMsgs, int side)
  355. {
  356. int ret = 0;
  357. byte hash[WC_MAX_DIGEST_SIZE];
  358. word32 hashSz = 0;
  359. word32 hashOutSz = 0;
  360. const byte* protocol;
  361. word32 protocolLen;
  362. int digestAlg = 0;
  363. switch (hashAlgo) {
  364. #ifndef NO_SHA256
  365. case sha256_mac:
  366. hashSz = WC_SHA256_DIGEST_SIZE;
  367. digestAlg = WC_SHA256;
  368. if (includeMsgs)
  369. ret = wc_Sha256GetHash(&ssl->hsHashes->hashSha256, hash);
  370. break;
  371. #endif
  372. #ifdef WOLFSSL_SHA384
  373. case sha384_mac:
  374. hashSz = WC_SHA384_DIGEST_SIZE;
  375. digestAlg = WC_SHA384;
  376. if (includeMsgs)
  377. ret = wc_Sha384GetHash(&ssl->hsHashes->hashSha384, hash);
  378. break;
  379. #endif
  380. #ifdef WOLFSSL_TLS13_SHA512
  381. case sha512_mac:
  382. hashSz = WC_SHA512_DIGEST_SIZE;
  383. digestAlg = WC_SHA512;
  384. if (includeMsgs)
  385. ret = wc_Sha512GetHash(&ssl->hsHashes->hashSha512, hash);
  386. break;
  387. #endif
  388. default:
  389. ret = HASH_TYPE_E;
  390. break;
  391. }
  392. if (ret != 0)
  393. return ret;
  394. protocol = tls13ProtocolLabel;
  395. protocolLen = TLS13_PROTOCOL_LABEL_SZ;
  396. #ifdef WOLFSSL_DTLS13
  397. if (ssl->options.dtls) {
  398. protocol = dtls13ProtocolLabel;
  399. protocolLen = DTLS13_PROTOCOL_LABEL_SZ;
  400. }
  401. #endif /* WOLFSSL_DTLS13 */
  402. if (outputLen == -1)
  403. outputLen = hashSz;
  404. if (includeMsgs)
  405. hashOutSz = hashSz;
  406. /* hash buffer may not be fully initialized, but the sending length won't
  407. * extend beyond the initialized span.
  408. */
  409. PRAGMA_GCC_DIAG_PUSH;
  410. PRAGMA_GCC("GCC diagnostic ignored \"-Wmaybe-uninitialized\"");
  411. PRIVATE_KEY_UNLOCK();
  412. #if defined(HAVE_FIPS) && defined(wc_Tls13_HKDF_Expand_Label)
  413. (void)side;
  414. ret = wc_Tls13_HKDF_Expand_Label_fips(output, outputLen, secret, hashSz,
  415. protocol, protocolLen, label, labelLen,
  416. hash, hashOutSz, digestAlg);
  417. #else
  418. ret = Tls13HKDFExpandKeyLabel(ssl, output, outputLen, secret, hashSz,
  419. protocol, protocolLen, label, labelLen,
  420. hash, hashOutSz, digestAlg, side);
  421. #endif
  422. PRIVATE_KEY_LOCK();
  423. #ifdef WOLFSSL_CHECK_MEM_ZERO
  424. wc_MemZero_Add("TLS 1.3 derived key", output, outputLen);
  425. #endif
  426. return ret;
  427. PRAGMA_GCC_DIAG_POP;
  428. }
  429. /* Convert TLS mac ID to a hash algorithm ID
  430. *
  431. * mac Mac ID to convert
  432. * returns hash ID on success, or the NONE type.
  433. */
  434. static WC_INLINE int mac2hash(int mac)
  435. {
  436. int hash;
  437. switch (mac) {
  438. #ifndef NO_SHA256
  439. case sha256_mac:
  440. hash = WC_SHA256;
  441. break;
  442. #endif
  443. #ifdef WOLFSSL_SHA384
  444. case sha384_mac:
  445. hash = WC_SHA384;
  446. break;
  447. #endif
  448. #ifdef WOLFSSL_TLS13_SHA512
  449. case sha512_mac:
  450. hash = WC_SHA512;
  451. break;
  452. #endif
  453. default:
  454. hash = WC_HASH_TYPE_NONE;
  455. }
  456. return hash;
  457. }
  458. #ifndef NO_PSK
  459. /* The length of the binder key label. */
  460. #define BINDER_KEY_LABEL_SZ 10
  461. /* The binder key label. */
  462. static const byte binderKeyLabel[BINDER_KEY_LABEL_SZ + 1] =
  463. "ext binder";
  464. /* Derive the binder key.
  465. *
  466. * ssl The SSL/TLS object.
  467. * key The derived key.
  468. * returns 0 on success, otherwise failure.
  469. */
  470. static int DeriveBinderKey(WOLFSSL* ssl, byte* key)
  471. {
  472. WOLFSSL_MSG("Derive Binder Key");
  473. if (ssl == NULL || ssl->arrays == NULL) {
  474. return BAD_FUNC_ARG;
  475. }
  476. return DeriveKeyMsg(ssl, key, -1, ssl->arrays->secret,
  477. binderKeyLabel, BINDER_KEY_LABEL_SZ,
  478. NULL, 0, ssl->specs.mac_algorithm);
  479. }
  480. #endif /* !NO_PSK */
  481. #if defined(HAVE_SESSION_TICKET) && \
  482. (!defined(NO_WOLFSSL_CLIENT) || !defined(NO_WOLFSSL_SERVER))
  483. /* The length of the binder key resume label. */
  484. #define BINDER_KEY_RESUME_LABEL_SZ 10
  485. /* The binder key resume label. */
  486. static const byte binderKeyResumeLabel[BINDER_KEY_RESUME_LABEL_SZ + 1] =
  487. "res binder";
  488. /* Derive the binder resumption key.
  489. *
  490. * ssl The SSL/TLS object.
  491. * key The derived key.
  492. * returns 0 on success, otherwise failure.
  493. */
  494. static int DeriveBinderKeyResume(WOLFSSL* ssl, byte* key)
  495. {
  496. WOLFSSL_MSG("Derive Binder Key - Resumption");
  497. if (ssl == NULL || ssl->arrays == NULL) {
  498. return BAD_FUNC_ARG;
  499. }
  500. return DeriveKeyMsg(ssl, key, -1, ssl->arrays->secret,
  501. binderKeyResumeLabel, BINDER_KEY_RESUME_LABEL_SZ,
  502. NULL, 0, ssl->specs.mac_algorithm);
  503. }
  504. #endif /* HAVE_SESSION_TICKET && (!NO_WOLFSSL_CLIENT || !NO_WOLFSSL_SERVER) */
  505. #ifdef WOLFSSL_EARLY_DATA
  506. /* The length of the early traffic label. */
  507. #define EARLY_TRAFFIC_LABEL_SZ 11
  508. /* The early traffic label. */
  509. static const byte earlyTrafficLabel[EARLY_TRAFFIC_LABEL_SZ + 1] =
  510. "c e traffic";
  511. /* Derive the early traffic key.
  512. *
  513. * ssl The SSL/TLS object.
  514. * key The derived key.
  515. * side The side that we are deriving the secret for.
  516. * returns 0 on success, otherwise failure.
  517. */
  518. static int DeriveEarlyTrafficSecret(WOLFSSL* ssl, byte* key, int side)
  519. {
  520. int ret;
  521. WOLFSSL_MSG("Derive Early Traffic Secret");
  522. if (ssl == NULL || ssl->arrays == NULL) {
  523. return BAD_FUNC_ARG;
  524. }
  525. ret = Tls13DeriveKey(ssl, key, -1, ssl->arrays->secret,
  526. earlyTrafficLabel, EARLY_TRAFFIC_LABEL_SZ,
  527. ssl->specs.mac_algorithm, 1, side);
  528. #ifdef HAVE_SECRET_CALLBACK
  529. if (ret == 0 && ssl->tls13SecretCb != NULL) {
  530. ret = ssl->tls13SecretCb(ssl, CLIENT_EARLY_TRAFFIC_SECRET, key,
  531. ssl->specs.hash_size, ssl->tls13SecretCtx);
  532. if (ret != 0) {
  533. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  534. return TLS13_SECRET_CB_E;
  535. }
  536. }
  537. #ifdef OPENSSL_EXTRA
  538. if (ret == 0 && ssl->tls13KeyLogCb != NULL) {
  539. ret = ssl->tls13KeyLogCb(ssl, CLIENT_EARLY_TRAFFIC_SECRET, key,
  540. ssl->specs.hash_size, NULL);
  541. if (ret != 0) {
  542. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  543. return TLS13_SECRET_CB_E;
  544. }
  545. }
  546. #endif /* OPENSSL_EXTRA */
  547. #endif /* HAVE_SECRET_CALLBACK */
  548. return ret;
  549. }
  550. #endif
  551. /* The length of the client handshake label. */
  552. #define CLIENT_HANDSHAKE_LABEL_SZ 12
  553. /* The client handshake label. */
  554. static const byte clientHandshakeLabel[CLIENT_HANDSHAKE_LABEL_SZ + 1] =
  555. "c hs traffic";
  556. /* Derive the client handshake key.
  557. *
  558. * ssl The SSL/TLS object.
  559. * key The derived key.
  560. * returns 0 on success, otherwise failure.
  561. */
  562. static int DeriveClientHandshakeSecret(WOLFSSL* ssl, byte* key)
  563. {
  564. int ret;
  565. WOLFSSL_MSG("Derive Client Handshake Secret");
  566. if (ssl == NULL || ssl->arrays == NULL) {
  567. return BAD_FUNC_ARG;
  568. }
  569. ret = Tls13DeriveKey(ssl, key, -1, ssl->arrays->preMasterSecret,
  570. clientHandshakeLabel, CLIENT_HANDSHAKE_LABEL_SZ,
  571. ssl->specs.mac_algorithm, 1, WOLFSSL_CLIENT_END);
  572. #ifdef HAVE_SECRET_CALLBACK
  573. if (ret == 0 && ssl->tls13SecretCb != NULL) {
  574. ret = ssl->tls13SecretCb(ssl, CLIENT_HANDSHAKE_TRAFFIC_SECRET, key,
  575. ssl->specs.hash_size, ssl->tls13SecretCtx);
  576. if (ret != 0) {
  577. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  578. return TLS13_SECRET_CB_E;
  579. }
  580. }
  581. #ifdef OPENSSL_EXTRA
  582. if (ret == 0 && ssl->tls13KeyLogCb != NULL) {
  583. ret = ssl->tls13KeyLogCb(ssl, CLIENT_HANDSHAKE_TRAFFIC_SECRET, key,
  584. ssl->specs.hash_size, NULL);
  585. if (ret != 0) {
  586. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  587. return TLS13_SECRET_CB_E;
  588. }
  589. }
  590. #endif /* OPENSSL_EXTRA */
  591. #endif /* HAVE_SECRET_CALLBACK */
  592. return ret;
  593. }
  594. /* The length of the server handshake label. */
  595. #define SERVER_HANDSHAKE_LABEL_SZ 12
  596. /* The server handshake label. */
  597. static const byte serverHandshakeLabel[SERVER_HANDSHAKE_LABEL_SZ + 1] =
  598. "s hs traffic";
  599. /* Derive the server handshake key.
  600. *
  601. * ssl The SSL/TLS object.
  602. * key The derived key.
  603. * returns 0 on success, otherwise failure.
  604. */
  605. static int DeriveServerHandshakeSecret(WOLFSSL* ssl, byte* key)
  606. {
  607. int ret;
  608. WOLFSSL_MSG("Derive Server Handshake Secret");
  609. if (ssl == NULL || ssl->arrays == NULL) {
  610. return BAD_FUNC_ARG;
  611. }
  612. ret = Tls13DeriveKey(ssl, key, -1, ssl->arrays->preMasterSecret,
  613. serverHandshakeLabel, SERVER_HANDSHAKE_LABEL_SZ,
  614. ssl->specs.mac_algorithm, 1, WOLFSSL_SERVER_END);
  615. #ifdef HAVE_SECRET_CALLBACK
  616. if (ret == 0 && ssl->tls13SecretCb != NULL) {
  617. ret = ssl->tls13SecretCb(ssl, SERVER_HANDSHAKE_TRAFFIC_SECRET, key,
  618. ssl->specs.hash_size, ssl->tls13SecretCtx);
  619. if (ret != 0) {
  620. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  621. return TLS13_SECRET_CB_E;
  622. }
  623. }
  624. #ifdef OPENSSL_EXTRA
  625. if (ret == 0 && ssl->tls13KeyLogCb != NULL) {
  626. ret = ssl->tls13KeyLogCb(ssl, SERVER_HANDSHAKE_TRAFFIC_SECRET, key,
  627. ssl->specs.hash_size, NULL);
  628. if (ret != 0) {
  629. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  630. return TLS13_SECRET_CB_E;
  631. }
  632. }
  633. #endif /* OPENSSL_EXTRA */
  634. #endif /* HAVE_SECRET_CALLBACK */
  635. return ret;
  636. }
  637. /* The length of the client application traffic label. */
  638. #define CLIENT_APP_LABEL_SZ 12
  639. /* The client application traffic label. */
  640. static const byte clientAppLabel[CLIENT_APP_LABEL_SZ + 1] =
  641. "c ap traffic";
  642. /* Derive the client application traffic key.
  643. *
  644. * ssl The SSL/TLS object.
  645. * key The derived key.
  646. * returns 0 on success, otherwise failure.
  647. */
  648. static int DeriveClientTrafficSecret(WOLFSSL* ssl, byte* key)
  649. {
  650. int ret;
  651. WOLFSSL_MSG("Derive Client Traffic Secret");
  652. if (ssl == NULL || ssl->arrays == NULL) {
  653. return BAD_FUNC_ARG;
  654. }
  655. ret = Tls13DeriveKey(ssl, key, -1, ssl->arrays->masterSecret,
  656. clientAppLabel, CLIENT_APP_LABEL_SZ,
  657. ssl->specs.mac_algorithm, 1, WOLFSSL_CLIENT_END);
  658. #ifdef HAVE_SECRET_CALLBACK
  659. if (ret == 0 && ssl->tls13SecretCb != NULL) {
  660. ret = ssl->tls13SecretCb(ssl, CLIENT_TRAFFIC_SECRET, key,
  661. ssl->specs.hash_size, ssl->tls13SecretCtx);
  662. if (ret != 0) {
  663. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  664. return TLS13_SECRET_CB_E;
  665. }
  666. }
  667. #ifdef OPENSSL_EXTRA
  668. if (ret == 0 && ssl->tls13KeyLogCb != NULL) {
  669. ret = ssl->tls13KeyLogCb(ssl, CLIENT_TRAFFIC_SECRET, key,
  670. ssl->specs.hash_size, NULL);
  671. if (ret != 0) {
  672. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  673. return TLS13_SECRET_CB_E;
  674. }
  675. }
  676. #endif /* OPENSSL_EXTRA */
  677. #endif /* HAVE_SECRET_CALLBACK */
  678. return ret;
  679. }
  680. /* The length of the server application traffic label. */
  681. #define SERVER_APP_LABEL_SZ 12
  682. /* The server application traffic label. */
  683. static const byte serverAppLabel[SERVER_APP_LABEL_SZ + 1] =
  684. "s ap traffic";
  685. /* Derive the server application traffic key.
  686. *
  687. * ssl The SSL/TLS object.
  688. * key The derived key.
  689. * returns 0 on success, otherwise failure.
  690. */
  691. static int DeriveServerTrafficSecret(WOLFSSL* ssl, byte* key)
  692. {
  693. int ret;
  694. WOLFSSL_MSG("Derive Server Traffic Secret");
  695. if (ssl == NULL || ssl->arrays == NULL) {
  696. return BAD_FUNC_ARG;
  697. }
  698. ret = Tls13DeriveKey(ssl, key, -1, ssl->arrays->masterSecret,
  699. serverAppLabel, SERVER_APP_LABEL_SZ,
  700. ssl->specs.mac_algorithm, 1, WOLFSSL_SERVER_END);
  701. #ifdef HAVE_SECRET_CALLBACK
  702. if (ret == 0 && ssl->tls13SecretCb != NULL) {
  703. ret = ssl->tls13SecretCb(ssl, SERVER_TRAFFIC_SECRET, key,
  704. ssl->specs.hash_size, ssl->tls13SecretCtx);
  705. if (ret != 0) {
  706. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  707. return TLS13_SECRET_CB_E;
  708. }
  709. }
  710. #ifdef OPENSSL_EXTRA
  711. if (ret == 0 && ssl->tls13KeyLogCb != NULL) {
  712. ret = ssl->tls13KeyLogCb(ssl, SERVER_TRAFFIC_SECRET, key,
  713. ssl->specs.hash_size, NULL);
  714. if (ret != 0) {
  715. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  716. return TLS13_SECRET_CB_E;
  717. }
  718. }
  719. #endif /* OPENSSL_EXTRA */
  720. #endif /* HAVE_SECRET_CALLBACK */
  721. return ret;
  722. }
  723. #ifdef HAVE_KEYING_MATERIAL
  724. /* The length of the exporter master secret label. */
  725. #define EXPORTER_MASTER_LABEL_SZ 10
  726. /* The exporter master secret label. */
  727. static const byte exporterMasterLabel[EXPORTER_MASTER_LABEL_SZ + 1] =
  728. "exp master";
  729. /* Derive the exporter secret.
  730. *
  731. * ssl The SSL/TLS object.
  732. * key The derived key.
  733. * returns 0 on success, otherwise failure.
  734. */
  735. static int DeriveExporterSecret(WOLFSSL* ssl, byte* key)
  736. {
  737. int ret;
  738. WOLFSSL_ENTER("Derive Exporter Secret");
  739. if (ssl == NULL || ssl->arrays == NULL) {
  740. return BAD_FUNC_ARG;
  741. }
  742. ret = Tls13DeriveKey(ssl, key, -1, ssl->arrays->masterSecret,
  743. exporterMasterLabel, EXPORTER_MASTER_LABEL_SZ,
  744. ssl->specs.mac_algorithm, 1, 0 /* Unused */);
  745. #ifdef HAVE_SECRET_CALLBACK
  746. if (ret == 0 && ssl->tls13SecretCb != NULL) {
  747. ret = ssl->tls13SecretCb(ssl, EXPORTER_SECRET, key,
  748. ssl->specs.hash_size, ssl->tls13SecretCtx);
  749. if (ret != 0) {
  750. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  751. return TLS13_SECRET_CB_E;
  752. }
  753. }
  754. #ifdef OPENSSL_EXTRA
  755. if (ret == 0 && ssl->tls13KeyLogCb != NULL) {
  756. ret = ssl->tls13KeyLogCb(ssl, EXPORTER_SECRET, key,
  757. ssl->specs.hash_size, NULL);
  758. if (ret != 0) {
  759. WOLFSSL_ERROR_VERBOSE(TLS13_SECRET_CB_E);
  760. return TLS13_SECRET_CB_E;
  761. }
  762. }
  763. #endif /* OPENSSL_EXTRA */
  764. #endif /* HAVE_SECRET_CALLBACK */
  765. return ret;
  766. }
  767. /* The length of the exporter label. */
  768. #define EXPORTER_LABEL_SZ 8
  769. /* The exporter label. */
  770. static const byte exporterLabel[EXPORTER_LABEL_SZ + 1] =
  771. "exporter";
  772. /* Hash("") */
  773. #ifndef NO_SHA256
  774. static const byte emptySHA256Hash[] = {
  775. 0xE3, 0xB0, 0xC4, 0x42, 0x98, 0xFC, 0x1C, 0x14, 0x9A, 0xFB, 0xF4, 0xC8,
  776. 0x99, 0x6F, 0xB9, 0x24, 0x27, 0xAE, 0x41, 0xE4, 0x64, 0x9B, 0x93, 0x4C,
  777. 0xA4, 0x95, 0x99, 0x1B, 0x78, 0x52, 0xB8, 0x55
  778. };
  779. #endif
  780. #ifdef WOLFSSL_SHA384
  781. static const byte emptySHA384Hash[] = {
  782. 0x38, 0xB0, 0x60, 0xA7, 0x51, 0xAC, 0x96, 0x38, 0x4C, 0xD9, 0x32, 0x7E,
  783. 0xB1, 0xB1, 0xE3, 0x6A, 0x21, 0xFD, 0xB7, 0x11, 0x14, 0xBE, 0x07, 0x43,
  784. 0x4C, 0x0C, 0xC7, 0xBF, 0x63, 0xF6, 0xE1, 0xDA, 0x27, 0x4E, 0xDE, 0xBF,
  785. 0xE7, 0x6F, 0x65, 0xFB, 0xD5, 0x1A, 0xD2, 0xF1, 0x48, 0x98, 0xB9, 0x5B
  786. };
  787. #endif
  788. #ifdef WOLFSSL_TLS13_SHA512
  789. static const byte emptySHA512Hash[] = {
  790. 0xCF, 0x83, 0xE1, 0x35, 0x7E, 0xEF, 0xB8, 0xBD, 0xF1, 0x54, 0x28, 0x50,
  791. 0xD6, 0x6D, 0x80, 0x07, 0xD6, 0x20, 0xE4, 0x05, 0x0B, 0x57, 0x15, 0xDC,
  792. 0x83, 0xF4, 0xA9, 0x21, 0xD3, 0x6C, 0xE9, 0xCE, 0x47, 0xD0, 0xD1, 0x3C,
  793. 0x5D, 0x85, 0xF2, 0xB0, 0xFF, 0x83, 0x18, 0xD2, 0x87, 0x7E, 0xEC, 0x2F,
  794. 0x63, 0xB9, 0x31, 0xBD, 0x47, 0x41, 0x7A, 0x81, 0xA5, 0x38, 0x32, 0x7A,
  795. 0xF9, 0x27, 0xDA, 0x3E
  796. };
  797. #endif
  798. /**
  799. * Implement section 7.5 of RFC 8446
  800. * @return 0 on success
  801. * <0 on failure
  802. */
  803. int Tls13_Exporter(WOLFSSL* ssl, unsigned char *out, size_t outLen,
  804. const char *label, size_t labelLen,
  805. const unsigned char *context, size_t contextLen)
  806. {
  807. int ret;
  808. enum wc_HashType hashType = WC_HASH_TYPE_NONE;
  809. int hashLen = 0;
  810. byte hashOut[WC_MAX_DIGEST_SIZE];
  811. const byte* emptyHash = NULL;
  812. byte firstExpand[WC_MAX_DIGEST_SIZE];
  813. const byte* protocol = tls13ProtocolLabel;
  814. word32 protocolLen = TLS13_PROTOCOL_LABEL_SZ;
  815. if (ssl->version.minor != TLSv1_3_MINOR)
  816. return VERSION_ERROR;
  817. switch (ssl->specs.mac_algorithm) {
  818. #ifndef NO_SHA256
  819. case sha256_mac:
  820. hashType = WC_HASH_TYPE_SHA256;
  821. hashLen = WC_SHA256_DIGEST_SIZE;
  822. emptyHash = emptySHA256Hash;
  823. break;
  824. #endif
  825. #ifdef WOLFSSL_SHA384
  826. case sha384_mac:
  827. hashType = WC_HASH_TYPE_SHA384;
  828. hashLen = WC_SHA384_DIGEST_SIZE;
  829. emptyHash = emptySHA384Hash;
  830. break;
  831. #endif
  832. #ifdef WOLFSSL_TLS13_SHA512
  833. case sha512_mac:
  834. hashType = WC_HASH_TYPE_SHA512;
  835. hashLen = WC_SHA512_DIGEST_SIZE;
  836. emptyHash = emptySHA512Hash;
  837. break;
  838. #endif
  839. }
  840. /* Derive-Secret(Secret, label, "") */
  841. ret = Tls13HKDFExpandLabel(ssl, firstExpand, hashLen,
  842. ssl->arrays->exporterSecret, hashLen,
  843. protocol, protocolLen, (byte*)label, (word32)labelLen,
  844. emptyHash, hashLen, hashType);
  845. if (ret != 0)
  846. return ret;
  847. /* Hash(context_value) */
  848. ret = wc_Hash(hashType, context, (word32)contextLen, hashOut, WC_MAX_DIGEST_SIZE);
  849. if (ret != 0)
  850. return ret;
  851. ret = Tls13HKDFExpandLabel(ssl, out, (word32)outLen, firstExpand, hashLen,
  852. protocol, protocolLen, exporterLabel, EXPORTER_LABEL_SZ,
  853. hashOut, hashLen, hashType);
  854. return ret;
  855. }
  856. #endif
  857. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  858. /* The length of the resumption master secret label. */
  859. #define RESUME_MASTER_LABEL_SZ 10
  860. /* The resumption master secret label. */
  861. static const byte resumeMasterLabel[RESUME_MASTER_LABEL_SZ + 1] =
  862. "res master";
  863. /* Derive the resumption secret.
  864. *
  865. * ssl The SSL/TLS object.
  866. * key The derived key.
  867. * returns 0 on success, otherwise failure.
  868. */
  869. int DeriveResumptionSecret(WOLFSSL* ssl, byte* key)
  870. {
  871. byte* masterSecret;
  872. WOLFSSL_MSG("Derive Resumption Secret");
  873. if (ssl == NULL) {
  874. return BAD_FUNC_ARG;
  875. }
  876. if (ssl->arrays != NULL) {
  877. masterSecret = ssl->arrays->masterSecret;
  878. }
  879. else {
  880. masterSecret = ssl->session->masterSecret;
  881. }
  882. return Tls13DeriveKey(ssl, key, -1, masterSecret, resumeMasterLabel,
  883. RESUME_MASTER_LABEL_SZ, ssl->specs.mac_algorithm, 1,
  884. 0 /* Unused */);
  885. }
  886. #endif
  887. /* Length of the finished label. */
  888. #define FINISHED_LABEL_SZ 8
  889. /* Finished label for generating finished key. */
  890. static const byte finishedLabel[FINISHED_LABEL_SZ+1] = "finished";
  891. /* Derive the finished secret.
  892. *
  893. * ssl The SSL/TLS object.
  894. * key The key to use with the HMAC.
  895. * secret The derived secret.
  896. * side The side that we are deriving the secret for.
  897. * returns 0 on success, otherwise failure.
  898. */
  899. static int DeriveFinishedSecret(WOLFSSL* ssl, byte* key, byte* secret,
  900. int side)
  901. {
  902. WOLFSSL_MSG("Derive Finished Secret");
  903. return Tls13DeriveKey(ssl, secret, -1, key, finishedLabel,
  904. FINISHED_LABEL_SZ, ssl->specs.mac_algorithm, 0,
  905. side);
  906. }
  907. /* The length of the application traffic label. */
  908. #define APP_TRAFFIC_LABEL_SZ 11
  909. /* The application traffic label. */
  910. static const byte appTrafficLabel[APP_TRAFFIC_LABEL_SZ + 1] =
  911. "traffic upd";
  912. /* Update the traffic secret.
  913. *
  914. * ssl The SSL/TLS object.
  915. * secret The previous secret and derived secret.
  916. * side The side that we are deriving the secret for.
  917. * returns 0 on success, otherwise failure.
  918. */
  919. static int DeriveTrafficSecret(WOLFSSL* ssl, byte* secret, int side)
  920. {
  921. WOLFSSL_MSG("Derive New Application Traffic Secret");
  922. return Tls13DeriveKey(ssl, secret, -1, secret,
  923. appTrafficLabel, APP_TRAFFIC_LABEL_SZ,
  924. ssl->specs.mac_algorithm, 0, side);
  925. }
  926. static int Tls13_HKDF_Extract(WOLFSSL *ssl, byte* prk, const byte* salt, int saltLen,
  927. byte* ikm, int ikmLen, int digest)
  928. {
  929. int ret;
  930. #ifdef HAVE_PK_CALLBACKS
  931. void *cb_ctx = ssl->HkdfExtractCtx;
  932. CallbackHKDFExtract cb = ssl->ctx->HkdfExtractCb;
  933. if (cb != NULL) {
  934. ret = cb(prk, salt, saltLen, ikm, ikmLen, digest, cb_ctx);
  935. }
  936. else
  937. #endif
  938. {
  939. (void)ssl;
  940. ret = wc_Tls13_HKDF_Extract(prk, salt, saltLen, ikm, ikmLen, digest);
  941. }
  942. return ret;
  943. }
  944. /* Derive the early secret using HKDF Extract.
  945. *
  946. * ssl The SSL/TLS object.
  947. */
  948. int DeriveEarlySecret(WOLFSSL* ssl)
  949. {
  950. int ret;
  951. WOLFSSL_MSG("Derive Early Secret");
  952. if (ssl == NULL || ssl->arrays == NULL) {
  953. return BAD_FUNC_ARG;
  954. }
  955. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  956. ret = tsip_Tls13DeriveEarlySecret(ssl);
  957. if (ret != CRYPTOCB_UNAVAILABLE)
  958. return ret;
  959. #endif
  960. PRIVATE_KEY_UNLOCK();
  961. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  962. ret = Tls13_HKDF_Extract(ssl, ssl->arrays->secret, NULL, 0,
  963. ssl->arrays->psk_key, ssl->arrays->psk_keySz,
  964. mac2hash(ssl->specs.mac_algorithm));
  965. #else
  966. ret = Tls13_HKDF_Extract(ssl, ssl->arrays->secret, NULL, 0,
  967. ssl->arrays->masterSecret, 0, mac2hash(ssl->specs.mac_algorithm));
  968. #endif
  969. PRIVATE_KEY_LOCK();
  970. return ret;
  971. }
  972. /* The length of the derived label. */
  973. #define DERIVED_LABEL_SZ 7
  974. /* The derived label. */
  975. static const byte derivedLabel[DERIVED_LABEL_SZ + 1] =
  976. "derived";
  977. /* Derive the handshake secret using HKDF Extract.
  978. *
  979. * ssl The SSL/TLS object.
  980. */
  981. int DeriveHandshakeSecret(WOLFSSL* ssl)
  982. {
  983. byte key[WC_MAX_DIGEST_SIZE];
  984. int ret;
  985. WOLFSSL_MSG("Derive Handshake Secret");
  986. if (ssl == NULL || ssl->arrays == NULL) {
  987. return BAD_FUNC_ARG;
  988. }
  989. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  990. ret = tsip_Tls13DeriveHandshakeSecret(ssl);
  991. if (ret != CRYPTOCB_UNAVAILABLE)
  992. return ret;
  993. #endif
  994. ret = DeriveKeyMsg(ssl, key, -1, ssl->arrays->secret,
  995. derivedLabel, DERIVED_LABEL_SZ,
  996. NULL, 0, ssl->specs.mac_algorithm);
  997. if (ret != 0)
  998. return ret;
  999. PRIVATE_KEY_UNLOCK();
  1000. ret = Tls13_HKDF_Extract(ssl, ssl->arrays->preMasterSecret,
  1001. key, ssl->specs.hash_size,
  1002. ssl->arrays->preMasterSecret, ssl->arrays->preMasterSz,
  1003. mac2hash(ssl->specs.mac_algorithm));
  1004. PRIVATE_KEY_LOCK();
  1005. return ret;
  1006. }
  1007. /* Derive the master secret using HKDF Extract.
  1008. *
  1009. * ssl The SSL/TLS object.
  1010. */
  1011. int DeriveMasterSecret(WOLFSSL* ssl)
  1012. {
  1013. byte key[WC_MAX_DIGEST_SIZE];
  1014. int ret;
  1015. WOLFSSL_MSG("Derive Master Secret");
  1016. if (ssl == NULL || ssl->arrays == NULL) {
  1017. return BAD_FUNC_ARG;
  1018. }
  1019. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  1020. ret = tsip_Tls13DeriveMasterSecret(ssl);
  1021. if (ret != CRYPTOCB_UNAVAILABLE)
  1022. return ret;
  1023. #endif
  1024. ret = DeriveKeyMsg(ssl, key, -1, ssl->arrays->preMasterSecret,
  1025. derivedLabel, DERIVED_LABEL_SZ,
  1026. NULL, 0, ssl->specs.mac_algorithm);
  1027. if (ret != 0)
  1028. return ret;
  1029. PRIVATE_KEY_UNLOCK();
  1030. ret = Tls13_HKDF_Extract(ssl, ssl->arrays->masterSecret,
  1031. key, ssl->specs.hash_size,
  1032. ssl->arrays->masterSecret, 0, mac2hash(ssl->specs.mac_algorithm));
  1033. PRIVATE_KEY_LOCK();
  1034. #ifdef HAVE_KEYING_MATERIAL
  1035. if (ret != 0)
  1036. return ret;
  1037. /* Calculate exporter secret only when saving arrays */
  1038. if (ssl->options.saveArrays)
  1039. ret = DeriveExporterSecret(ssl, ssl->arrays->exporterSecret);
  1040. #endif
  1041. return ret;
  1042. }
  1043. #if defined(HAVE_SESSION_TICKET)
  1044. /* Length of the resumption label. */
  1045. #define RESUMPTION_LABEL_SZ 10
  1046. /* Resumption label for generating PSK associated with the ticket. */
  1047. static const byte resumptionLabel[RESUMPTION_LABEL_SZ+1] = "resumption";
  1048. /* Derive the PSK associated with the ticket.
  1049. *
  1050. * ssl The SSL/TLS object.
  1051. * nonce The nonce to derive with.
  1052. * nonceLen The length of the nonce to derive with.
  1053. * secret The derived secret.
  1054. * returns 0 on success, otherwise failure.
  1055. */
  1056. int DeriveResumptionPSK(WOLFSSL* ssl, byte* nonce, byte nonceLen, byte* secret)
  1057. {
  1058. int digestAlg;
  1059. /* Only one protocol version defined at this time. */
  1060. const byte* protocol = tls13ProtocolLabel;
  1061. word32 protocolLen = TLS13_PROTOCOL_LABEL_SZ;
  1062. int ret;
  1063. WOLFSSL_MSG("Derive Resumption PSK");
  1064. switch (ssl->specs.mac_algorithm) {
  1065. #ifndef NO_SHA256
  1066. case sha256_mac:
  1067. digestAlg = WC_SHA256;
  1068. break;
  1069. #endif
  1070. #ifdef WOLFSSL_SHA384
  1071. case sha384_mac:
  1072. digestAlg = WC_SHA384;
  1073. break;
  1074. #endif
  1075. #ifdef WOLFSSL_TLS13_SHA512
  1076. case sha512_mac:
  1077. digestAlg = WC_SHA512;
  1078. break;
  1079. #endif
  1080. default:
  1081. return BAD_FUNC_ARG;
  1082. }
  1083. #if defined(WOLFSSL_TICKET_NONCE_MALLOC) && \
  1084. (!defined(HAVE_FIPS) || (defined(FIPS_VERSION_GE) && FIPS_VERSION_GE(5,3)))
  1085. PRIVATE_KEY_UNLOCK();
  1086. ret = wc_Tls13_HKDF_Expand_Label_Alloc(secret, ssl->specs.hash_size,
  1087. ssl->session->masterSecret, ssl->specs.hash_size, protocol, protocolLen,
  1088. resumptionLabel, RESUMPTION_LABEL_SZ, nonce, nonceLen, digestAlg,
  1089. ssl->heap);
  1090. PRIVATE_KEY_LOCK();
  1091. #else
  1092. ret = Tls13HKDFExpandLabel(ssl, secret, ssl->specs.hash_size,
  1093. ssl->session->masterSecret, ssl->specs.hash_size,
  1094. protocol, protocolLen, resumptionLabel,
  1095. RESUMPTION_LABEL_SZ, nonce, nonceLen, digestAlg);
  1096. #endif /* !defined(HAVE_FIPS) || FIPS_VERSION_GE(5,3) */
  1097. return ret;
  1098. }
  1099. #endif /* HAVE_SESSION_TICKET */
  1100. /* Calculate the HMAC of message data to this point.
  1101. *
  1102. * ssl The SSL/TLS object.
  1103. * key The HMAC key.
  1104. * hash The hash result - verify data.
  1105. * returns length of verify data generated.
  1106. */
  1107. static int BuildTls13HandshakeHmac(WOLFSSL* ssl, byte* key, byte* hash,
  1108. word32* pHashSz)
  1109. {
  1110. #ifdef WOLFSSL_SMALL_STACK
  1111. Hmac* verifyHmac;
  1112. #else
  1113. Hmac verifyHmac[1];
  1114. #endif
  1115. int hashType = WC_SHA256;
  1116. int hashSz = WC_SHA256_DIGEST_SIZE;
  1117. int ret = BAD_FUNC_ARG;
  1118. if (ssl == NULL || key == NULL || hash == NULL) {
  1119. return BAD_FUNC_ARG;
  1120. }
  1121. /* Get the hash of the previous handshake messages. */
  1122. switch (ssl->specs.mac_algorithm) {
  1123. #ifndef NO_SHA256
  1124. case sha256_mac:
  1125. hashType = WC_SHA256;
  1126. hashSz = WC_SHA256_DIGEST_SIZE;
  1127. ret = wc_Sha256GetHash(&ssl->hsHashes->hashSha256, hash);
  1128. break;
  1129. #endif /* !NO_SHA256 */
  1130. #ifdef WOLFSSL_SHA384
  1131. case sha384_mac:
  1132. hashType = WC_SHA384;
  1133. hashSz = WC_SHA384_DIGEST_SIZE;
  1134. ret = wc_Sha384GetHash(&ssl->hsHashes->hashSha384, hash);
  1135. break;
  1136. #endif /* WOLFSSL_SHA384 */
  1137. #ifdef WOLFSSL_TLS13_SHA512
  1138. case sha512_mac:
  1139. hashType = WC_SHA512;
  1140. hashSz = WC_SHA512_DIGEST_SIZE;
  1141. ret = wc_Sha512GetHash(&ssl->hsHashes->hashSha512, hash);
  1142. break;
  1143. #endif /* WOLFSSL_TLS13_SHA512 */
  1144. default:
  1145. break;
  1146. }
  1147. if (ret != 0)
  1148. return ret;
  1149. #ifdef WOLFSSL_DEBUG_TLS
  1150. WOLFSSL_MSG(" Key");
  1151. WOLFSSL_BUFFER(key, ssl->specs.hash_size);
  1152. WOLFSSL_MSG(" Msg Hash");
  1153. WOLFSSL_BUFFER(hash, hashSz);
  1154. #endif
  1155. #ifdef WOLFSSL_SMALL_STACK
  1156. verifyHmac = (Hmac*)XMALLOC(sizeof(Hmac), NULL, DYNAMIC_TYPE_HMAC);
  1157. if (verifyHmac == NULL) {
  1158. return MEMORY_E;
  1159. }
  1160. #endif
  1161. /* Calculate the verify data. */
  1162. ret = wc_HmacInit(verifyHmac, ssl->heap, ssl->devId);
  1163. if (ret == 0) {
  1164. ret = wc_HmacSetKey(verifyHmac, hashType, key, ssl->specs.hash_size);
  1165. if (ret == 0)
  1166. ret = wc_HmacUpdate(verifyHmac, hash, hashSz);
  1167. if (ret == 0)
  1168. ret = wc_HmacFinal(verifyHmac, hash);
  1169. wc_HmacFree(verifyHmac);
  1170. }
  1171. #ifdef WOLFSSL_SMALL_STACK
  1172. XFREE(verifyHmac, NULL, DYNAMIC_TYPE_HMAC);
  1173. #endif
  1174. #ifdef WOLFSSL_DEBUG_TLS
  1175. WOLFSSL_MSG(" Hash");
  1176. WOLFSSL_BUFFER(hash, hashSz);
  1177. #endif
  1178. if (pHashSz)
  1179. *pHashSz = hashSz;
  1180. return ret;
  1181. }
  1182. /* The length of the label to use when deriving keys. */
  1183. #define WRITE_KEY_LABEL_SZ 3
  1184. /* The length of the label to use when deriving IVs. */
  1185. #define WRITE_IV_LABEL_SZ 2
  1186. /* The label to use when deriving keys. */
  1187. static const byte writeKeyLabel[WRITE_KEY_LABEL_SZ+1] = "key";
  1188. /* The label to use when deriving IVs. */
  1189. static const byte writeIVLabel[WRITE_IV_LABEL_SZ+1] = "iv";
  1190. /* Derive the keys and IVs for TLS v1.3.
  1191. *
  1192. * ssl The SSL/TLS object.
  1193. * secret early_data_key when deriving the key and IV for encrypting early
  1194. * data application data and end_of_early_data messages.
  1195. * handshake_key when deriving keys and IVs for encrypting handshake
  1196. * messages.
  1197. * traffic_key when deriving first keys and IVs for encrypting
  1198. * traffic messages.
  1199. * update_traffic_key when deriving next keys and IVs for encrypting
  1200. * traffic messages.
  1201. * side ENCRYPT_SIDE_ONLY when only encryption secret needs to be derived.
  1202. * DECRYPT_SIDE_ONLY when only decryption secret needs to be derived.
  1203. * ENCRYPT_AND_DECRYPT_SIDE when both secret needs to be derived.
  1204. * store 1 indicates to derive the keys and IVs from derived secret and
  1205. * store ready for provisioning.
  1206. * returns 0 on success, otherwise failure.
  1207. */
  1208. int DeriveTls13Keys(WOLFSSL* ssl, int secret, int side, int store)
  1209. {
  1210. int ret = BAD_FUNC_ARG; /* Assume failure */
  1211. int i = 0;
  1212. #ifdef WOLFSSL_SMALL_STACK
  1213. byte* key_dig;
  1214. #else
  1215. byte key_dig[MAX_PRF_DIG];
  1216. #endif
  1217. int provision;
  1218. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  1219. ret = tsip_Tls13DeriveKeys(ssl, secret, side);
  1220. if (ret != CRYPTOCB_UNAVAILABLE) {
  1221. return ret;
  1222. }
  1223. ret = BAD_FUNC_ARG; /* Assume failure */
  1224. #endif
  1225. #ifdef WOLFSSL_SMALL_STACK
  1226. key_dig = (byte*)XMALLOC(MAX_PRF_DIG, ssl->heap, DYNAMIC_TYPE_DIGEST);
  1227. if (key_dig == NULL)
  1228. return MEMORY_E;
  1229. #endif
  1230. if (side == ENCRYPT_AND_DECRYPT_SIDE) {
  1231. provision = PROVISION_CLIENT_SERVER;
  1232. }
  1233. else {
  1234. provision = ((ssl->options.side != WOLFSSL_CLIENT_END) ^
  1235. (side == ENCRYPT_SIDE_ONLY)) ? PROVISION_CLIENT :
  1236. PROVISION_SERVER;
  1237. }
  1238. /* Derive the appropriate secret to use in the HKDF. */
  1239. switch (secret) {
  1240. #ifdef WOLFSSL_EARLY_DATA
  1241. case early_data_key:
  1242. ret = DeriveEarlyTrafficSecret(ssl, ssl->clientSecret,
  1243. WOLFSSL_CLIENT_END);
  1244. if (ret != 0)
  1245. goto end;
  1246. break;
  1247. #endif
  1248. case handshake_key:
  1249. if (provision & PROVISION_CLIENT) {
  1250. ret = DeriveClientHandshakeSecret(ssl,
  1251. ssl->clientSecret);
  1252. if (ret != 0)
  1253. goto end;
  1254. }
  1255. if (provision & PROVISION_SERVER) {
  1256. ret = DeriveServerHandshakeSecret(ssl,
  1257. ssl->serverSecret);
  1258. if (ret != 0)
  1259. goto end;
  1260. }
  1261. break;
  1262. case traffic_key:
  1263. if (provision & PROVISION_CLIENT) {
  1264. ret = DeriveClientTrafficSecret(ssl, ssl->clientSecret);
  1265. if (ret != 0)
  1266. goto end;
  1267. }
  1268. if (provision & PROVISION_SERVER) {
  1269. ret = DeriveServerTrafficSecret(ssl, ssl->serverSecret);
  1270. if (ret != 0)
  1271. goto end;
  1272. }
  1273. break;
  1274. case update_traffic_key:
  1275. if (provision & PROVISION_CLIENT) {
  1276. ret = DeriveTrafficSecret(ssl, ssl->clientSecret,
  1277. WOLFSSL_CLIENT_END);
  1278. if (ret != 0)
  1279. goto end;
  1280. }
  1281. if (provision & PROVISION_SERVER) {
  1282. ret = DeriveTrafficSecret(ssl, ssl->serverSecret,
  1283. WOLFSSL_SERVER_END);
  1284. if (ret != 0)
  1285. goto end;
  1286. }
  1287. break;
  1288. default:
  1289. break;
  1290. }
  1291. #ifdef WOLFSSL_QUIC
  1292. if (WOLFSSL_IS_QUIC(ssl)) {
  1293. ret = wolfSSL_quic_forward_secrets(ssl, secret, side);
  1294. if (ret != 0)
  1295. goto end;
  1296. }
  1297. #endif /* WOLFSSL_QUIC */
  1298. if (!store)
  1299. goto end;
  1300. /* Key data = client key | server key | client IV | server IV */
  1301. if (provision & PROVISION_CLIENT) {
  1302. /* Derive the client key. */
  1303. WOLFSSL_MSG("Derive Client Key");
  1304. ret = Tls13DeriveKey(ssl, &key_dig[i], ssl->specs.key_size,
  1305. ssl->clientSecret, writeKeyLabel,
  1306. WRITE_KEY_LABEL_SZ, ssl->specs.mac_algorithm, 0,
  1307. WOLFSSL_CLIENT_END);
  1308. if (ret != 0)
  1309. goto end;
  1310. i += ssl->specs.key_size;
  1311. }
  1312. if (provision & PROVISION_SERVER) {
  1313. /* Derive the server key. */
  1314. WOLFSSL_MSG("Derive Server Key");
  1315. ret = Tls13DeriveKey(ssl, &key_dig[i], ssl->specs.key_size,
  1316. ssl->serverSecret, writeKeyLabel,
  1317. WRITE_KEY_LABEL_SZ, ssl->specs.mac_algorithm, 0,
  1318. WOLFSSL_SERVER_END);
  1319. if (ret != 0)
  1320. goto end;
  1321. i += ssl->specs.key_size;
  1322. }
  1323. if (provision & PROVISION_CLIENT) {
  1324. /* Derive the client IV. */
  1325. WOLFSSL_MSG("Derive Client IV");
  1326. ret = Tls13DeriveKey(ssl, &key_dig[i], ssl->specs.iv_size,
  1327. ssl->clientSecret, writeIVLabel,
  1328. WRITE_IV_LABEL_SZ, ssl->specs.mac_algorithm, 0,
  1329. WOLFSSL_CLIENT_END);
  1330. if (ret != 0)
  1331. goto end;
  1332. i += ssl->specs.iv_size;
  1333. }
  1334. if (provision & PROVISION_SERVER) {
  1335. /* Derive the server IV. */
  1336. WOLFSSL_MSG("Derive Server IV");
  1337. ret = Tls13DeriveKey(ssl, &key_dig[i], ssl->specs.iv_size,
  1338. ssl->serverSecret, writeIVLabel,
  1339. WRITE_IV_LABEL_SZ, ssl->specs.mac_algorithm, 0,
  1340. WOLFSSL_SERVER_END);
  1341. if (ret != 0)
  1342. goto end;
  1343. i += ssl->specs.iv_size;
  1344. }
  1345. /* Store keys and IVs but don't activate them. */
  1346. ret = StoreKeys(ssl, key_dig, provision);
  1347. #ifdef WOLFSSL_DTLS13
  1348. if (ret != 0)
  1349. goto end;
  1350. if (ssl->options.dtls) {
  1351. ret = Dtls13DeriveSnKeys(ssl, provision);
  1352. if (ret != 0)
  1353. return ret;
  1354. }
  1355. #endif /* WOLFSSL_DTLS13 */
  1356. end:
  1357. ForceZero(key_dig, i);
  1358. #ifdef WOLFSSL_SMALL_STACK
  1359. XFREE(key_dig, ssl->heap, DYNAMIC_TYPE_DIGEST);
  1360. #elif defined(WOLFSSL_CHECK_MEM_ZERO)
  1361. wc_MemZero_Check(key_dig, MAX_PRF_DIG);
  1362. #endif
  1363. if (ret != 0) {
  1364. WOLFSSL_ERROR_VERBOSE(ret);
  1365. }
  1366. return ret;
  1367. }
  1368. #if (defined(HAVE_SESSION_TICKET) || !defined(NO_PSK))
  1369. #ifdef WOLFSSL_32BIT_MILLI_TIME
  1370. #ifndef NO_ASN_TIME
  1371. #if defined(USER_TICKS)
  1372. #if 0
  1373. word32 TimeNowInMilliseconds(void)
  1374. {
  1375. /*
  1376. write your own clock tick function if don't want gettimeofday()
  1377. needs millisecond accuracy but doesn't have to correlated to EPOCH
  1378. */
  1379. }
  1380. #endif
  1381. #elif defined(TIME_OVERRIDES)
  1382. #if !defined(NO_ASN) && !defined(NO_ASN_TIME)
  1383. word32 TimeNowInMilliseconds(void)
  1384. {
  1385. return (word32) wc_Time(0) * 1000;
  1386. }
  1387. #else
  1388. #ifndef HAVE_TIME_T_TYPE
  1389. typedef long time_t;
  1390. #endif
  1391. extern time_t XTIME(time_t * timer);
  1392. /* The time in milliseconds.
  1393. * Used for tickets to represent difference between when first seen and when
  1394. * sending.
  1395. *
  1396. * returns the time in milliseconds as a 32-bit value.
  1397. */
  1398. word32 TimeNowInMilliseconds(void)
  1399. {
  1400. return (word32) XTIME(0) * 1000;
  1401. }
  1402. #endif
  1403. #elif defined(XTIME_MS)
  1404. word32 TimeNowInMilliseconds(void)
  1405. {
  1406. return (word32)XTIME_MS(0);
  1407. }
  1408. #elif defined(USE_WINDOWS_API)
  1409. /* The time in milliseconds.
  1410. * Used for tickets to represent difference between when first seen and when
  1411. * sending.
  1412. *
  1413. * returns the time in milliseconds as a 32-bit value.
  1414. */
  1415. word32 TimeNowInMilliseconds(void)
  1416. {
  1417. static int init = 0;
  1418. static LARGE_INTEGER freq;
  1419. LARGE_INTEGER count;
  1420. if (!init) {
  1421. QueryPerformanceFrequency(&freq);
  1422. init = 1;
  1423. }
  1424. QueryPerformanceCounter(&count);
  1425. return (word32)(count.QuadPart / (freq.QuadPart / 1000));
  1426. }
  1427. #elif defined(HAVE_RTP_SYS)
  1428. #include "rtptime.h"
  1429. /* The time in milliseconds.
  1430. * Used for tickets to represent difference between when first seen and when
  1431. * sending.
  1432. *
  1433. * returns the time in milliseconds as a 32-bit value.
  1434. */
  1435. word32 TimeNowInMilliseconds(void)
  1436. {
  1437. return (word32)rtp_get_system_sec() * 1000;
  1438. }
  1439. #elif defined(WOLFSSL_DEOS)
  1440. word32 TimeNowInMilliseconds(void)
  1441. {
  1442. const word32 systemTickTimeInHz = 1000000 / systemTickInMicroseconds();
  1443. word32 *systemTickPtr = systemTickPointer();
  1444. return (word32) (*systemTickPtr/systemTickTimeInHz) * 1000;
  1445. }
  1446. #elif defined(MICRIUM)
  1447. /* The time in milliseconds.
  1448. * Used for tickets to represent difference between when first seen and when
  1449. * sending.
  1450. *
  1451. * returns the time in milliseconds as a 32-bit value.
  1452. */
  1453. word32 TimeNowInMilliseconds(void)
  1454. {
  1455. OS_TICK ticks = 0;
  1456. OS_ERR err;
  1457. ticks = OSTimeGet(&err);
  1458. return (word32) (ticks / OSCfg_TickRate_Hz) * 1000;
  1459. }
  1460. #elif defined(MICROCHIP_TCPIP_V5)
  1461. /* The time in milliseconds.
  1462. * Used for tickets to represent difference between when first seen and when
  1463. * sending.
  1464. *
  1465. * returns the time in milliseconds as a 32-bit value.
  1466. */
  1467. word32 TimeNowInMilliseconds(void)
  1468. {
  1469. return (word32) (TickGet() / (TICKS_PER_SECOND / 1000));
  1470. }
  1471. #elif defined(MICROCHIP_TCPIP)
  1472. #if defined(MICROCHIP_MPLAB_HARMONY)
  1473. #include <system/tmr/sys_tmr.h>
  1474. /* The time in milliseconds.
  1475. * Used for tickets to represent difference between when first seen and when
  1476. * sending.
  1477. *
  1478. * returns the time in milliseconds as a 32-bit value.
  1479. */
  1480. word32 TimeNowInMilliseconds(void)
  1481. {
  1482. return (word32)(SYS_TMR_TickCountGet() /
  1483. (SYS_TMR_TickCounterFrequencyGet() / 1000));
  1484. }
  1485. #else
  1486. /* The time in milliseconds.
  1487. * Used for tickets to represent difference between when first seen and when
  1488. * sending.
  1489. *
  1490. * returns the time in milliseconds as a 32-bit value.
  1491. */
  1492. word32 TimeNowInMilliseconds(void)
  1493. {
  1494. return (word32)(SYS_TICK_Get() / (SYS_TICK_TicksPerSecondGet() / 1000));
  1495. }
  1496. #endif
  1497. #elif defined(FREESCALE_MQX) || defined(FREESCALE_KSDK_MQX)
  1498. /* The time in milliseconds.
  1499. * Used for tickets to represent difference between when first seen and when
  1500. * sending.
  1501. *
  1502. * returns the time in milliseconds as a 32-bit value.
  1503. */
  1504. word32 TimeNowInMilliseconds(void)
  1505. {
  1506. TIME_STRUCT mqxTime;
  1507. _time_get_elapsed(&mqxTime);
  1508. return (word32) mqxTime.SECONDS * 1000;
  1509. }
  1510. #elif defined(FREESCALE_FREE_RTOS) || defined(FREESCALE_KSDK_FREERTOS)
  1511. #include "include/task.h"
  1512. /* The time in milliseconds.
  1513. * Used for tickets to represent difference between when first seen and when
  1514. * sending.
  1515. *
  1516. * returns the time in milliseconds as a 32-bit value.
  1517. */
  1518. word32 TimeNowInMilliseconds(void)
  1519. {
  1520. return (unsigned int)(((float)xTaskGetTickCount()) /
  1521. (configTICK_RATE_HZ / 1000));
  1522. }
  1523. #elif defined(FREESCALE_KSDK_BM)
  1524. #include "lwip/sys.h" /* lwIP */
  1525. /* The time in milliseconds.
  1526. * Used for tickets to represent difference between when first seen and when
  1527. * sending.
  1528. *
  1529. * returns the time in milliseconds as a 32-bit value.
  1530. */
  1531. word32 TimeNowInMilliseconds(void)
  1532. {
  1533. return sys_now();
  1534. }
  1535. #elif defined(WOLFSSL_TIRTOS)
  1536. /* The time in milliseconds.
  1537. * Used for tickets to represent difference between when first seen and when
  1538. * sending.
  1539. *
  1540. * returns the time in milliseconds as a 32-bit value.
  1541. */
  1542. word32 TimeNowInMilliseconds(void)
  1543. {
  1544. return (word32) Seconds_get() * 1000;
  1545. }
  1546. #elif defined(WOLFSSL_UTASKER)
  1547. /* The time in milliseconds.
  1548. * Used for tickets to represent difference between when first seen and when
  1549. * sending.
  1550. *
  1551. * returns the time in milliseconds as a 32-bit value.
  1552. */
  1553. word32 TimeNowInMilliseconds(void)
  1554. {
  1555. return (word32)(uTaskerSystemTick / (TICK_RESOLUTION / 1000));
  1556. }
  1557. #elif defined(WOLFSSL_LINUXKM)
  1558. word32 TimeNowInMilliseconds(void)
  1559. {
  1560. s64 t;
  1561. #if LINUX_VERSION_CODE < KERNEL_VERSION(4, 0, 0)
  1562. struct timespec ts;
  1563. getnstimeofday(&ts);
  1564. t = ts.tv_sec * (s64)1000;
  1565. t += ts.tv_nsec / (s64)1000000;
  1566. #else
  1567. struct timespec64 ts;
  1568. #if LINUX_VERSION_CODE < KERNEL_VERSION(5, 0, 0)
  1569. ts = current_kernel_time64();
  1570. #else
  1571. ktime_get_coarse_real_ts64(&ts);
  1572. #endif
  1573. t = ts.tv_sec * 1000L;
  1574. t += ts.tv_nsec / 1000000L;
  1575. #endif
  1576. return (word32)t;
  1577. }
  1578. #elif defined(WOLFSSL_QNX_CAAM)
  1579. word32 TimeNowInMilliseconds(void)
  1580. {
  1581. struct timespec now;
  1582. clock_gettime(CLOCK_REALTIME, &now);
  1583. return (word32)(now.tv_sec * 1000 + now.tv_nsec / 1000000);
  1584. }
  1585. #elif defined(FUSION_RTOS)
  1586. /* The time in milliseconds.
  1587. * Used for tickets to represent difference between when first seen and when
  1588. * sending.
  1589. *
  1590. * returns the time in milliseconds as a 32-bit value.
  1591. */
  1592. word32 TimeNowInMilliseconds(void)
  1593. {
  1594. struct timeval now;
  1595. if (FCL_GETTIMEOFDAY(&now, 0) < 0)
  1596. return 0;
  1597. /* Convert to milliseconds number. */
  1598. return (word32)(now.tv_sec * 1000 + now.tv_usec / 1000);
  1599. }
  1600. #elif defined(WOLFSSL_ZEPHYR)
  1601. word32 TimeNowInMilliseconds(void)
  1602. {
  1603. #if defined(CONFIG_ARCH_POSIX)
  1604. k_cpu_idle();
  1605. #endif
  1606. return (word32)k_uptime_get() / 1000;
  1607. }
  1608. #else
  1609. /* The time in milliseconds.
  1610. * Used for tickets to represent difference between when first seen and when
  1611. * sending.
  1612. *
  1613. * returns the time in milliseconds as a 32-bit value.
  1614. */
  1615. word32 TimeNowInMilliseconds(void)
  1616. {
  1617. struct timeval now;
  1618. if (gettimeofday(&now, 0) < 0)
  1619. return 0;
  1620. /* Convert to milliseconds number. */
  1621. return (word32)(now.tv_sec * 1000 + now.tv_usec / 1000);
  1622. }
  1623. #endif
  1624. #else
  1625. /* user must supply time in milliseconds function:
  1626. * word32 TimeNowInMilliseconds(void);
  1627. * The response is milliseconds elapsed
  1628. */
  1629. #endif /* !NO_ASN_TIME */
  1630. #else
  1631. #ifndef NO_ASN_TIME
  1632. #if defined(USER_TICKS)
  1633. #if 0
  1634. sword64 TimeNowInMilliseconds(void)
  1635. {
  1636. /*
  1637. write your own clock tick function if don't want gettimeofday()
  1638. needs millisecond accuracy but doesn't have to correlated to EPOCH
  1639. */
  1640. }
  1641. #endif
  1642. #elif defined(TIME_OVERRIDES)
  1643. #if !defined(NO_ASN) && !defined(NO_ASN_TIME)
  1644. sword64 TimeNowInMilliseconds(void)
  1645. {
  1646. return (sword64) wc_Time(0) * 1000;
  1647. }
  1648. #else
  1649. #ifndef HAVE_TIME_T_TYPE
  1650. typedef long time_t;
  1651. #endif
  1652. extern time_t XTIME(time_t * timer);
  1653. /* The time in milliseconds.
  1654. * Used for tickets to represent difference between when first seen and when
  1655. * sending.
  1656. *
  1657. * returns the time in milliseconds as a 32-bit value.
  1658. */
  1659. sword64 TimeNowInMilliseconds(void)
  1660. {
  1661. return (sword64) XTIME(0) * 1000;
  1662. }
  1663. #endif
  1664. #elif defined(XTIME_MS)
  1665. sword64 TimeNowInMilliseconds(void)
  1666. {
  1667. return (sword64)XTIME_MS(0);
  1668. }
  1669. #elif defined(USE_WINDOWS_API)
  1670. /* The time in milliseconds.
  1671. * Used for tickets to represent difference between when first seen and when
  1672. * sending.
  1673. *
  1674. * returns the time in milliseconds as a 64-bit value.
  1675. */
  1676. sword64 TimeNowInMilliseconds(void)
  1677. {
  1678. static int init = 0;
  1679. static LARGE_INTEGER freq;
  1680. LARGE_INTEGER count;
  1681. if (!init) {
  1682. QueryPerformanceFrequency(&freq);
  1683. init = 1;
  1684. }
  1685. QueryPerformanceCounter(&count);
  1686. return (sword64)(count.QuadPart / (freq.QuadPart / 1000));
  1687. }
  1688. #elif defined(HAVE_RTP_SYS)
  1689. #include "rtptime.h"
  1690. /* The time in milliseconds.
  1691. * Used for tickets to represent difference between when first seen and when
  1692. * sending.
  1693. *
  1694. * returns the time in milliseconds as a 64-bit value.
  1695. */
  1696. sword64 TimeNowInMilliseconds(void)
  1697. {
  1698. return (sword64)rtp_get_system_sec() * 1000;
  1699. }
  1700. #elif defined(WOLFSSL_DEOS)
  1701. sword64 TimeNowInMilliseconds(void)
  1702. {
  1703. const word32 systemTickTimeInHz = 1000000 / systemTickInMicroseconds();
  1704. word32 *systemTickPtr = systemTickPointer();
  1705. return (sword64) (*systemTickPtr/systemTickTimeInHz) * 1000;
  1706. }
  1707. #elif defined(MICRIUM)
  1708. /* The time in milliseconds.
  1709. * Used for tickets to represent difference between when first seen and when
  1710. * sending.
  1711. *
  1712. * returns the time in milliseconds as a 64-bit value.
  1713. */
  1714. sword64 TimeNowInMilliseconds(void)
  1715. {
  1716. OS_TICK ticks = 0;
  1717. OS_ERR err;
  1718. ticks = OSTimeGet(&err);
  1719. return (sword64) (ticks / OSCfg_TickRate_Hz) * 1000;
  1720. }
  1721. #elif defined(MICROCHIP_TCPIP_V5)
  1722. /* The time in milliseconds.
  1723. * Used for tickets to represent difference between when first seen and when
  1724. * sending.
  1725. *
  1726. * returns the time in milliseconds as a 64-bit value.
  1727. */
  1728. sword64 TimeNowInMilliseconds(void)
  1729. {
  1730. return (sword64) (TickGet() / (TICKS_PER_SECOND / 1000));
  1731. }
  1732. #elif defined(MICROCHIP_TCPIP)
  1733. #if defined(MICROCHIP_MPLAB_HARMONY)
  1734. #include <system/tmr/sys_tmr.h>
  1735. /* The time in milliseconds.
  1736. * Used for tickets to represent difference between when first seen and when
  1737. * sending.
  1738. *
  1739. * returns the time in milliseconds as a 64-bit value.
  1740. */
  1741. sword64 TimeNowInMilliseconds(void)
  1742. {
  1743. return (sword64)SYS_TMR_TickCountGet() /
  1744. (SYS_TMR_TickCounterFrequencyGet() / 1000);
  1745. }
  1746. #else
  1747. /* The time in milliseconds.
  1748. * Used for tickets to represent difference between when first seen and when
  1749. * sending.
  1750. *
  1751. * returns the time in milliseconds as a 64-bit value.
  1752. */
  1753. sword64 TimeNowInMilliseconds(void)
  1754. {
  1755. return (sword64)SYS_TICK_Get() / (SYS_TICK_TicksPerSecondGet() / 1000);
  1756. }
  1757. #endif
  1758. #elif defined(FREESCALE_MQX) || defined(FREESCALE_KSDK_MQX)
  1759. /* The time in milliseconds.
  1760. * Used for tickets to represent difference between when first seen and when
  1761. * sending.
  1762. *
  1763. * returns the time in milliseconds as a 64-bit value.
  1764. */
  1765. sword64 TimeNowInMilliseconds(void)
  1766. {
  1767. TIME_STRUCT mqxTime;
  1768. _time_get_elapsed(&mqxTime);
  1769. return (sword64) mqxTime.SECONDS * 1000;
  1770. }
  1771. #elif defined(FREESCALE_FREE_RTOS) || defined(FREESCALE_KSDK_FREERTOS)
  1772. #include "include/task.h"
  1773. /* The time in milliseconds.
  1774. * Used for tickets to represent difference between when first seen and when
  1775. * sending.
  1776. *
  1777. * returns the time in milliseconds as a 64-bit value.
  1778. */
  1779. sword64 TimeNowInMilliseconds(void)
  1780. {
  1781. return (sword64)xTaskGetTickCount() / (configTICK_RATE_HZ / 1000);
  1782. }
  1783. #elif defined(FREESCALE_KSDK_BM)
  1784. #include "lwip/sys.h" /* lwIP */
  1785. /* The time in milliseconds.
  1786. * Used for tickets to represent difference between when first seen and when
  1787. * sending.
  1788. *
  1789. * returns the time in milliseconds as a 64-bit value.
  1790. */
  1791. sword64 TimeNowInMilliseconds(void)
  1792. {
  1793. return sys_now();
  1794. }
  1795. #elif defined(WOLFSSL_TIRTOS)
  1796. /* The time in milliseconds.
  1797. * Used for tickets to represent difference between when first seen and when
  1798. * sending.
  1799. *
  1800. * returns the time in milliseconds as a 64-bit value.
  1801. */
  1802. sword64 TimeNowInMilliseconds(void)
  1803. {
  1804. return (sword64) Seconds_get() * 1000;
  1805. }
  1806. #elif defined(WOLFSSL_UTASKER)
  1807. /* The time in milliseconds.
  1808. * Used for tickets to represent difference between when first seen and when
  1809. * sending.
  1810. *
  1811. * returns the time in milliseconds as a 64-bit value.
  1812. */
  1813. sword64 TimeNowInMilliseconds(void)
  1814. {
  1815. return (sword64)(uTaskerSystemTick / (TICK_RESOLUTION / 1000));
  1816. }
  1817. #elif defined(WOLFSSL_LINUXKM)
  1818. sword64 TimeNowInMilliseconds(void)
  1819. {
  1820. s64 t;
  1821. #if LINUX_VERSION_CODE < KERNEL_VERSION(4, 0, 0)
  1822. struct timespec ts;
  1823. getnstimeofday(&ts);
  1824. t = ts.tv_sec * (s64)1000;
  1825. t += ts.tv_nsec / (s64)1000000;
  1826. #else
  1827. struct timespec64 ts;
  1828. #if LINUX_VERSION_CODE < KERNEL_VERSION(5, 0, 0)
  1829. ts = current_kernel_time64();
  1830. #else
  1831. ktime_get_coarse_real_ts64(&ts);
  1832. #endif
  1833. t = ts.tv_sec * 1000L;
  1834. t += ts.tv_nsec / 1000000L;
  1835. #endif
  1836. return (sword64)t;
  1837. }
  1838. #elif defined(WOLFSSL_QNX_CAAM)
  1839. sword64 TimeNowInMilliseconds(void)
  1840. {
  1841. struct timespec now;
  1842. clock_gettime(CLOCK_REALTIME, &now);
  1843. return (sword64)(now.tv_sec * 1000 + now.tv_nsec / 1000000);
  1844. }
  1845. #elif defined(FUSION_RTOS)
  1846. /* The time in milliseconds.
  1847. * Used for tickets to represent difference between when first seen and when
  1848. * sending.
  1849. *
  1850. * returns the time in milliseconds as a 64-bit value.
  1851. */
  1852. sword64 TimeNowInMilliseconds(void)
  1853. {
  1854. struct timeval now;
  1855. if (FCL_GETTIMEOFDAY(&now, 0) < 0)
  1856. return 0;
  1857. /* Convert to milliseconds number. */
  1858. return (sword64)now.tv_sec * 1000 + now.tv_usec / 1000;
  1859. }
  1860. #elif defined(WOLFSSL_ZEPHYR)
  1861. sword64 TimeNowInMilliseconds(void)
  1862. {
  1863. #if defined(CONFIG_ARCH_POSIX)
  1864. k_cpu_idle();
  1865. #endif
  1866. return (sword64)k_uptime_get() / 1000;
  1867. }
  1868. #else
  1869. /* The time in milliseconds.
  1870. * Used for tickets to represent difference between when first seen and when
  1871. * sending.
  1872. *
  1873. * returns the time in milliseconds as a 64-bit value.
  1874. */
  1875. sword64 TimeNowInMilliseconds(void)
  1876. {
  1877. struct timeval now;
  1878. if (gettimeofday(&now, 0) < 0)
  1879. return 0;
  1880. /* Convert to milliseconds number. */
  1881. return (sword64)now.tv_sec * 1000 + now.tv_usec / 1000;
  1882. }
  1883. #endif
  1884. #else
  1885. /* user must supply time in milliseconds function:
  1886. * sword64 TimeNowInMilliseconds(void);
  1887. * The response is milliseconds elapsed
  1888. */
  1889. #endif /* !NO_ASN_TIME */
  1890. #endif /* WOLFSSL_32BIT_MILLI_TIME */
  1891. #endif /* HAVE_SESSION_TICKET || !NO_PSK */
  1892. /* Extract the handshake header information.
  1893. *
  1894. * ssl The SSL/TLS object.
  1895. * input The buffer holding the message data.
  1896. * inOutIdx On entry, the index into the buffer of the handshake data.
  1897. * On exit, the start of the handshake data.
  1898. * type Type of handshake message.
  1899. * size The length of the handshake message data.
  1900. * totalSz The total size of data in the buffer.
  1901. * returns BUFFER_E if there is not enough input data and 0 on success.
  1902. */
  1903. static int GetHandshakeHeader(WOLFSSL* ssl, const byte* input, word32* inOutIdx,
  1904. byte* type, word32* size, word32 totalSz)
  1905. {
  1906. const byte* ptr = input + *inOutIdx;
  1907. (void)ssl;
  1908. *inOutIdx += HANDSHAKE_HEADER_SZ;
  1909. if (*inOutIdx > totalSz)
  1910. return BUFFER_E;
  1911. *type = ptr[0];
  1912. c24to32(&ptr[1], size);
  1913. return 0;
  1914. }
  1915. /* Add record layer header to message.
  1916. *
  1917. * output The buffer to write the record layer header into.
  1918. * length The length of the record data.
  1919. * type The type of record message.
  1920. * ssl The SSL/TLS object.
  1921. */
  1922. static void AddTls13RecordHeader(byte* output, word32 length, byte type,
  1923. WOLFSSL* ssl)
  1924. {
  1925. RecordLayerHeader* rl;
  1926. rl = (RecordLayerHeader*)output;
  1927. rl->type = type;
  1928. rl->pvMajor = ssl->version.major;
  1929. /* NOTE: May be TLSv1_MINOR when sending first ClientHello. */
  1930. rl->pvMinor = TLSv1_2_MINOR;
  1931. c16toa((word16)length, rl->length);
  1932. }
  1933. /* Add handshake header to message.
  1934. *
  1935. * output The buffer to write the handshake header into.
  1936. * length The length of the handshake data.
  1937. * fragOffset The offset of the fragment data. (DTLS)
  1938. * fragLength The length of the fragment data. (DTLS)
  1939. * type The type of handshake message.
  1940. * ssl The SSL/TLS object. (DTLS)
  1941. */
  1942. static void AddTls13HandShakeHeader(byte* output, word32 length,
  1943. word32 fragOffset, word32 fragLength,
  1944. byte type, WOLFSSL* ssl)
  1945. {
  1946. HandShakeHeader* hs;
  1947. (void)fragOffset;
  1948. (void)fragLength;
  1949. (void)ssl;
  1950. #ifdef WOLFSSL_DTLS13
  1951. /* message_hash type is used for a syntetic message that replaces the first
  1952. ClientHello in the hash transcript when using HelloRetryRequest. It will
  1953. never be transmitted and, as the DTLS-only fields must not be considered
  1954. when computing the hash transcript, we can avoid to use the DTLS
  1955. handshake header. */
  1956. if (ssl->options.dtls && type != message_hash) {
  1957. Dtls13HandshakeAddHeader(ssl, output, (enum HandShakeType)type, length);
  1958. return;
  1959. }
  1960. #endif /* WOLFSSL_DTLS13 */
  1961. /* handshake header */
  1962. hs = (HandShakeHeader*)output;
  1963. hs->type = type;
  1964. c32to24(length, hs->length);
  1965. }
  1966. /* Add both record layer and handshake header to message.
  1967. *
  1968. * output The buffer to write the headers into.
  1969. * length The length of the handshake data.
  1970. * type The type of record layer message.
  1971. * ssl The SSL/TLS object. (DTLS)
  1972. */
  1973. static void AddTls13Headers(byte* output, word32 length, byte type,
  1974. WOLFSSL* ssl)
  1975. {
  1976. word32 lengthAdj = HANDSHAKE_HEADER_SZ;
  1977. word32 outputAdj = RECORD_HEADER_SZ;
  1978. #ifdef WOLFSSL_DTLS13
  1979. if (ssl->options.dtls) {
  1980. Dtls13AddHeaders(output, length, (enum HandShakeType)type, ssl);
  1981. return;
  1982. }
  1983. #endif /* WOLFSSL_DTLS13 */
  1984. AddTls13RecordHeader(output, length + lengthAdj, handshake, ssl);
  1985. AddTls13HandShakeHeader(output + outputAdj, length, 0, length, type, ssl);
  1986. }
  1987. #if (!defined(NO_WOLFSSL_CLIENT) || !defined(NO_WOLFSSL_SERVER)) \
  1988. && !defined(NO_CERTS)
  1989. /* Add both record layer and fragment handshake header to message.
  1990. *
  1991. * output The buffer to write the headers into.
  1992. * fragOffset The offset of the fragment data. (DTLS)
  1993. * fragLength The length of the fragment data. (DTLS)
  1994. * length The length of the handshake data.
  1995. * type The type of record layer message.
  1996. * ssl The SSL/TLS object. (DTLS)
  1997. */
  1998. static void AddTls13FragHeaders(byte* output, word32 fragSz, word32 fragOffset,
  1999. word32 length, byte type, WOLFSSL* ssl)
  2000. {
  2001. word32 lengthAdj = HANDSHAKE_HEADER_SZ;
  2002. word32 outputAdj = RECORD_HEADER_SZ;
  2003. (void)fragSz;
  2004. #ifdef WOLFSSL_DTLS13
  2005. /* we ignore fragmentation fields here because fragmentation logic for
  2006. DTLS1.3 is inside dtls13_handshake_send(). */
  2007. if (ssl->options.dtls) {
  2008. Dtls13AddHeaders(output, length, (enum HandShakeType)type, ssl);
  2009. return;
  2010. }
  2011. #endif /* WOLFSSL_DTLS13 */
  2012. AddTls13RecordHeader(output, fragSz + lengthAdj, handshake, ssl);
  2013. AddTls13HandShakeHeader(output + outputAdj, length, fragOffset, fragSz,
  2014. type, ssl);
  2015. }
  2016. #endif /* (!NO_WOLFSSL_CLIENT || !NO_WOLFSSL_SERVER) && !NO_CERTS */
  2017. /* Write the sequence number into the buffer.
  2018. * No DTLS v1.3 support.
  2019. *
  2020. * ssl The SSL/TLS object.
  2021. * verifyOrder Which set of sequence numbers to use.
  2022. * out The buffer to write into.
  2023. */
  2024. static WC_INLINE void WriteSEQTls13(WOLFSSL* ssl, int verifyOrder, byte* out)
  2025. {
  2026. word32 seq[2] = {0, 0};
  2027. if (ssl->options.dtls) {
  2028. #ifdef WOLFSSL_DTLS13
  2029. Dtls13GetSeq(ssl, verifyOrder, seq, 1);
  2030. #endif /* WOLFSSL_DTLS13 */
  2031. }
  2032. else if (verifyOrder == PEER_ORDER) {
  2033. seq[0] = ssl->keys.peer_sequence_number_hi;
  2034. seq[1] = ssl->keys.peer_sequence_number_lo++;
  2035. /* handle rollover */
  2036. if (seq[1] > ssl->keys.peer_sequence_number_lo)
  2037. ssl->keys.peer_sequence_number_hi++;
  2038. }
  2039. else {
  2040. seq[0] = ssl->keys.sequence_number_hi;
  2041. seq[1] = ssl->keys.sequence_number_lo++;
  2042. /* handle rollover */
  2043. if (seq[1] > ssl->keys.sequence_number_lo)
  2044. ssl->keys.sequence_number_hi++;
  2045. }
  2046. c32toa(seq[0], out);
  2047. c32toa(seq[1], out + OPAQUE32_LEN);
  2048. }
  2049. /* Build the nonce for TLS v1.3 encryption and decryption.
  2050. *
  2051. * ssl The SSL/TLS object.
  2052. * nonce The nonce data to use when encrypting or decrypting.
  2053. * iv The derived IV.
  2054. * order The side on which the message is to be or was sent.
  2055. */
  2056. static WC_INLINE void BuildTls13Nonce(WOLFSSL* ssl, byte* nonce, const byte* iv,
  2057. int order)
  2058. {
  2059. int i;
  2060. /* The nonce is the IV with the sequence XORed into the last bytes. */
  2061. WriteSEQTls13(ssl, order, nonce + AEAD_NONCE_SZ - SEQ_SZ);
  2062. for (i = 0; i < AEAD_NONCE_SZ - SEQ_SZ; i++)
  2063. nonce[i] = iv[i];
  2064. for (; i < AEAD_NONCE_SZ; i++)
  2065. nonce[i] ^= iv[i];
  2066. }
  2067. #if defined(HAVE_CHACHA) && defined(HAVE_POLY1305)
  2068. /* Encrypt with ChaCha20 and create authentication tag with Poly1305.
  2069. *
  2070. * ssl The SSL/TLS object.
  2071. * output The buffer to write encrypted data and authentication tag into.
  2072. * May be the same pointer as input.
  2073. * input The data to encrypt.
  2074. * sz The number of bytes to encrypt.
  2075. * nonce The nonce to use with ChaCha20.
  2076. * aad The additional authentication data.
  2077. * aadSz The size of the addition authentication data.
  2078. * tag The authentication tag buffer.
  2079. * returns 0 on success, otherwise failure.
  2080. */
  2081. static int ChaCha20Poly1305_Encrypt(WOLFSSL* ssl, byte* output,
  2082. const byte* input, word16 sz, byte* nonce,
  2083. const byte* aad, word16 aadSz, byte* tag)
  2084. {
  2085. int ret = 0;
  2086. byte poly[CHACHA20_256_KEY_SIZE];
  2087. /* Poly1305 key is 256 bits of zero encrypted with ChaCha20. */
  2088. XMEMSET(poly, 0, sizeof(poly));
  2089. /* Set the nonce for ChaCha and get Poly1305 key. */
  2090. ret = wc_Chacha_SetIV(ssl->encrypt.chacha, nonce, 0);
  2091. if (ret != 0)
  2092. return ret;
  2093. /* Create Poly1305 key using ChaCha20 keystream. */
  2094. ret = wc_Chacha_Process(ssl->encrypt.chacha, poly, poly, sizeof(poly));
  2095. if (ret != 0)
  2096. return ret;
  2097. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2098. wc_MemZero_Add("ChaCha20Poly1305_Encrypt poly", poly, sizeof(poly));
  2099. #endif
  2100. ret = wc_Chacha_SetIV(ssl->encrypt.chacha, nonce, 1);
  2101. if (ret != 0)
  2102. return ret;
  2103. /* Encrypt the plain text. */
  2104. ret = wc_Chacha_Process(ssl->encrypt.chacha, output, input, sz);
  2105. if (ret != 0) {
  2106. ForceZero(poly, sizeof(poly));
  2107. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2108. wc_MemZero_Check(poly, sizeof(poly));
  2109. #endif
  2110. return ret;
  2111. }
  2112. /* Set key for Poly1305. */
  2113. ret = wc_Poly1305SetKey(ssl->auth.poly1305, poly, sizeof(poly));
  2114. ForceZero(poly, sizeof(poly)); /* done with poly1305 key, clear it */
  2115. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2116. wc_MemZero_Check(poly, sizeof(poly));
  2117. #endif
  2118. if (ret != 0)
  2119. return ret;
  2120. /* Add authentication code of encrypted data to end. */
  2121. ret = wc_Poly1305_MAC(ssl->auth.poly1305, aad, aadSz, output, sz, tag,
  2122. POLY1305_AUTH_SZ);
  2123. return ret;
  2124. }
  2125. #endif
  2126. #ifdef HAVE_NULL_CIPHER
  2127. /* Create authentication tag and copy data over input.
  2128. *
  2129. * ssl The SSL/TLS object.
  2130. * output The buffer to copy data into.
  2131. * May be the same pointer as input.
  2132. * input The data.
  2133. * sz The number of bytes of data.
  2134. * nonce The nonce to use with authentication.
  2135. * aad The additional authentication data.
  2136. * aadSz The size of the addition authentication data.
  2137. * tag The authentication tag buffer.
  2138. * returns 0 on success, otherwise failure.
  2139. */
  2140. static int Tls13IntegrityOnly_Encrypt(WOLFSSL* ssl, byte* output,
  2141. const byte* input, word16 sz,
  2142. const byte* nonce,
  2143. const byte* aad, word16 aadSz, byte* tag)
  2144. {
  2145. int ret;
  2146. /* HMAC: nonce | aad | input */
  2147. ret = wc_HmacUpdate(ssl->encrypt.hmac, nonce, HMAC_NONCE_SZ);
  2148. if (ret == 0)
  2149. ret = wc_HmacUpdate(ssl->encrypt.hmac, aad, aadSz);
  2150. if (ret == 0)
  2151. ret = wc_HmacUpdate(ssl->encrypt.hmac, input, sz);
  2152. if (ret == 0)
  2153. ret = wc_HmacFinal(ssl->encrypt.hmac, tag);
  2154. /* Copy the input to output if not the same buffer */
  2155. if (ret == 0 && output != input)
  2156. XMEMCPY(output, input, sz);
  2157. return ret;
  2158. }
  2159. #endif
  2160. /* Encrypt data for TLS v1.3.
  2161. *
  2162. * ssl The SSL/TLS object.
  2163. * output The buffer to write encrypted data and authentication tag into.
  2164. * May be the same pointer as input.
  2165. * input The record header and data to encrypt.
  2166. * sz The number of bytes to encrypt.
  2167. * aad The additional authentication data.
  2168. * aadSz The size of the addition authentication data.
  2169. * asyncOkay If non-zero can return WC_PENDING_E, otherwise blocks on crypto
  2170. * returns 0 on success, otherwise failure.
  2171. */
  2172. static int EncryptTls13(WOLFSSL* ssl, byte* output, const byte* input,
  2173. word16 sz, const byte* aad, word16 aadSz, int asyncOkay)
  2174. {
  2175. int ret = 0;
  2176. word16 dataSz = sz - ssl->specs.aead_mac_size;
  2177. word16 macSz = ssl->specs.aead_mac_size;
  2178. word32 nonceSz = 0;
  2179. #ifdef WOLFSSL_ASYNC_CRYPT
  2180. WC_ASYNC_DEV* asyncDev = NULL;
  2181. word32 event_flags = WC_ASYNC_FLAG_CALL_AGAIN;
  2182. #endif
  2183. WOLFSSL_ENTER("EncryptTls13");
  2184. (void)output;
  2185. (void)input;
  2186. (void)sz;
  2187. (void)dataSz;
  2188. (void)macSz;
  2189. (void)asyncOkay;
  2190. (void)nonceSz;
  2191. #ifdef WOLFSSL_ASYNC_CRYPT
  2192. if (ssl->error == WC_PENDING_E) {
  2193. ssl->error = 0; /* clear async */
  2194. }
  2195. #endif
  2196. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  2197. ret = tsip_Tls13AesEncrypt(ssl, output, input, dataSz);
  2198. if (ret != CRYPTOCB_UNAVAILABLE) {
  2199. if (ret > 0) {
  2200. ret = 0; /* tsip_Tls13AesEncrypt returns output size */
  2201. }
  2202. return ret;
  2203. }
  2204. ret = 0;
  2205. #endif /* WOLFSSL_RENESAS_TSIP_TLS && WOLFSSL_RENESAS_TSIP_VER >= 115 */
  2206. switch (ssl->encrypt.state) {
  2207. case CIPHER_STATE_BEGIN:
  2208. {
  2209. #ifdef WOLFSSL_DEBUG_TLS
  2210. WOLFSSL_MSG("Data to encrypt");
  2211. WOLFSSL_BUFFER(input, dataSz);
  2212. WOLFSSL_MSG("Additional Authentication Data");
  2213. WOLFSSL_BUFFER(aad, aadSz);
  2214. #endif
  2215. #ifdef WOLFSSL_CIPHER_TEXT_CHECK
  2216. if (ssl->specs.bulk_cipher_algorithm != wolfssl_cipher_null) {
  2217. XMEMCPY(ssl->encrypt.sanityCheck, input,
  2218. min(dataSz, sizeof(ssl->encrypt.sanityCheck)));
  2219. }
  2220. #endif
  2221. #ifdef CIPHER_NONCE
  2222. if (ssl->encrypt.nonce == NULL) {
  2223. ssl->encrypt.nonce = (byte*)XMALLOC(AEAD_NONCE_SZ,
  2224. ssl->heap, DYNAMIC_TYPE_AES_BUFFER);
  2225. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2226. if (ssl->encrypt.nonce != NULL) {
  2227. wc_MemZero_Add("EncryptTls13 nonce", ssl->encrypt.nonce,
  2228. AEAD_NONCE_SZ);
  2229. }
  2230. #endif
  2231. }
  2232. if (ssl->encrypt.nonce == NULL)
  2233. return MEMORY_E;
  2234. BuildTls13Nonce(ssl, ssl->encrypt.nonce, ssl->keys.aead_enc_imp_IV,
  2235. CUR_ORDER);
  2236. #endif
  2237. /* Advance state and proceed */
  2238. ssl->encrypt.state = CIPHER_STATE_DO;
  2239. }
  2240. FALL_THROUGH;
  2241. case CIPHER_STATE_DO:
  2242. {
  2243. switch (ssl->specs.bulk_cipher_algorithm) {
  2244. #ifdef BUILD_AESGCM
  2245. case wolfssl_aes_gcm:
  2246. #ifdef WOLFSSL_ASYNC_CRYPT
  2247. /* initialize event */
  2248. asyncDev = &ssl->encrypt.aes->asyncDev;
  2249. ret = wolfSSL_AsyncInit(ssl, asyncDev, event_flags);
  2250. if (ret != 0)
  2251. break;
  2252. #endif
  2253. nonceSz = AESGCM_NONCE_SZ;
  2254. #if defined(HAVE_PK_CALLBACKS)
  2255. ret = NOT_COMPILED_IN;
  2256. if (ssl->ctx && ssl->ctx->PerformTlsRecordProcessingCb) {
  2257. ret = ssl->ctx->PerformTlsRecordProcessingCb(ssl, 1,
  2258. output, input, dataSz,
  2259. ssl->encrypt.nonce, nonceSz,
  2260. output + dataSz, macSz,
  2261. aad, aadSz);
  2262. }
  2263. if (ret == NOT_COMPILED_IN)
  2264. #endif
  2265. {
  2266. #if ((defined(HAVE_FIPS) || defined(HAVE_SELFTEST)) && \
  2267. (!defined(HAVE_FIPS_VERSION) || (HAVE_FIPS_VERSION < 2)))
  2268. ret = wc_AesGcmEncrypt(ssl->encrypt.aes, output, input,
  2269. dataSz, ssl->encrypt.nonce, nonceSz,
  2270. output + dataSz, macSz, aad, aadSz);
  2271. #else
  2272. ret = wc_AesGcmSetExtIV(ssl->encrypt.aes,
  2273. ssl->encrypt.nonce, nonceSz);
  2274. if (ret == 0) {
  2275. ret = wc_AesGcmEncrypt_ex(ssl->encrypt.aes, output,
  2276. input, dataSz, ssl->encrypt.nonce, nonceSz,
  2277. output + dataSz, macSz, aad, aadSz);
  2278. }
  2279. #endif
  2280. }
  2281. break;
  2282. #endif
  2283. #ifdef HAVE_AESCCM
  2284. case wolfssl_aes_ccm:
  2285. #ifdef WOLFSSL_ASYNC_CRYPT
  2286. /* initialize event */
  2287. asyncDev = &ssl->encrypt.aes->asyncDev;
  2288. ret = wolfSSL_AsyncInit(ssl, asyncDev, event_flags);
  2289. if (ret != 0)
  2290. break;
  2291. #endif
  2292. nonceSz = AESCCM_NONCE_SZ;
  2293. #if defined(HAVE_PK_CALLBACKS)
  2294. ret = NOT_COMPILED_IN;
  2295. if (ssl->ctx && ssl->ctx->PerformTlsRecordProcessingCb) {
  2296. ret = ssl->ctx->PerformTlsRecordProcessingCb(ssl, 1,
  2297. output, input, dataSz,
  2298. ssl->encrypt.nonce, nonceSz,
  2299. output + dataSz, macSz,
  2300. aad, aadSz);
  2301. }
  2302. if (ret == NOT_COMPILED_IN)
  2303. #endif
  2304. {
  2305. #if ((defined(HAVE_FIPS) || defined(HAVE_SELFTEST)) && \
  2306. (!defined(HAVE_FIPS_VERSION) || (HAVE_FIPS_VERSION < 2)))
  2307. ret = wc_AesCcmEncrypt(ssl->encrypt.aes, output, input,
  2308. dataSz, ssl->encrypt.nonce, nonceSz,
  2309. output + dataSz, macSz, aad, aadSz);
  2310. #else
  2311. ret = wc_AesCcmSetNonce(ssl->encrypt.aes,
  2312. ssl->encrypt.nonce, nonceSz);
  2313. if (ret == 0) {
  2314. ret = wc_AesCcmEncrypt_ex(ssl->encrypt.aes, output,
  2315. input, dataSz, ssl->encrypt.nonce, nonceSz,
  2316. output + dataSz, macSz, aad, aadSz);
  2317. }
  2318. #endif
  2319. }
  2320. break;
  2321. #endif
  2322. #if defined(HAVE_CHACHA) && defined(HAVE_POLY1305)
  2323. case wolfssl_chacha:
  2324. ret = ChaCha20Poly1305_Encrypt(ssl, output, input, dataSz,
  2325. ssl->encrypt.nonce, aad, aadSz, output + dataSz);
  2326. break;
  2327. #endif
  2328. #ifdef HAVE_NULL_CIPHER
  2329. case wolfssl_cipher_null:
  2330. ret = Tls13IntegrityOnly_Encrypt(ssl, output, input, dataSz,
  2331. ssl->encrypt.nonce, aad, aadSz, output + dataSz);
  2332. break;
  2333. #endif
  2334. default:
  2335. WOLFSSL_MSG("wolfSSL Encrypt programming error");
  2336. return ENCRYPT_ERROR;
  2337. }
  2338. /* Advance state */
  2339. ssl->encrypt.state = CIPHER_STATE_END;
  2340. #ifdef WOLFSSL_ASYNC_CRYPT
  2341. if (ret == WC_PENDING_E) {
  2342. /* if async is not okay, then block */
  2343. if (!asyncOkay) {
  2344. ret = wc_AsyncWait(ret, asyncDev, event_flags);
  2345. }
  2346. else {
  2347. /* If pending, then leave and return will resume below */
  2348. return wolfSSL_AsyncPush(ssl, asyncDev);
  2349. }
  2350. }
  2351. #endif
  2352. }
  2353. FALL_THROUGH;
  2354. case CIPHER_STATE_END:
  2355. {
  2356. #ifdef WOLFSSL_DEBUG_TLS
  2357. #ifdef CIPHER_NONCE
  2358. WOLFSSL_MSG("Nonce");
  2359. WOLFSSL_BUFFER(ssl->encrypt.nonce, ssl->specs.iv_size);
  2360. #endif
  2361. WOLFSSL_MSG("Encrypted data");
  2362. WOLFSSL_BUFFER(output, dataSz);
  2363. WOLFSSL_MSG("Authentication Tag");
  2364. WOLFSSL_BUFFER(output + dataSz, macSz);
  2365. #endif
  2366. #ifdef WOLFSSL_CIPHER_TEXT_CHECK
  2367. if (ssl->specs.bulk_cipher_algorithm != wolfssl_cipher_null &&
  2368. XMEMCMP(output, ssl->encrypt.sanityCheck,
  2369. min(dataSz, sizeof(ssl->encrypt.sanityCheck))) == 0) {
  2370. WOLFSSL_MSG("EncryptTls13 sanity check failed! Glitch?");
  2371. return ENCRYPT_ERROR;
  2372. }
  2373. ForceZero(ssl->encrypt.sanityCheck,
  2374. sizeof(ssl->encrypt.sanityCheck));
  2375. #endif
  2376. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2377. if ((ssl->specs.bulk_cipher_algorithm != wolfssl_cipher_null) &&
  2378. (output != input) && (ret == 0)) {
  2379. wc_MemZero_Add("TLS 1.3 Encrypt plaintext", input, sz);
  2380. }
  2381. #endif
  2382. #ifdef CIPHER_NONCE
  2383. ForceZero(ssl->encrypt.nonce, AEAD_NONCE_SZ);
  2384. #endif
  2385. break;
  2386. }
  2387. default:
  2388. break;
  2389. }
  2390. /* Reset state */
  2391. ssl->encrypt.state = CIPHER_STATE_BEGIN;
  2392. return ret;
  2393. }
  2394. #if defined(HAVE_CHACHA) && defined(HAVE_POLY1305)
  2395. /* Decrypt with ChaCha20 and check authentication tag with Poly1305.
  2396. *
  2397. * ssl The SSL/TLS object.
  2398. * output The buffer to write decrypted data into.
  2399. * May be the same pointer as input.
  2400. * input The data to decrypt.
  2401. * sz The number of bytes to decrypt.
  2402. * nonce The nonce to use with ChaCha20.
  2403. * aad The additional authentication data.
  2404. * aadSz The size of the addition authentication data.
  2405. * tagIn The authentication tag data from packet.
  2406. * returns 0 on success, otherwise failure.
  2407. */
  2408. static int ChaCha20Poly1305_Decrypt(WOLFSSL* ssl, byte* output,
  2409. const byte* input, word16 sz, byte* nonce,
  2410. const byte* aad, word16 aadSz,
  2411. const byte* tagIn)
  2412. {
  2413. int ret;
  2414. byte tag[POLY1305_AUTH_SZ];
  2415. byte poly[CHACHA20_256_KEY_SIZE]; /* generated key for mac */
  2416. /* Poly1305 key is 256 bits of zero encrypted with ChaCha20. */
  2417. XMEMSET(poly, 0, sizeof(poly));
  2418. /* Set nonce and get Poly1305 key. */
  2419. ret = wc_Chacha_SetIV(ssl->decrypt.chacha, nonce, 0);
  2420. if (ret != 0)
  2421. return ret;
  2422. /* Use ChaCha20 keystream to get Poly1305 key for tag. */
  2423. ret = wc_Chacha_Process(ssl->decrypt.chacha, poly, poly, sizeof(poly));
  2424. if (ret != 0)
  2425. return ret;
  2426. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2427. wc_MemZero_Add("ChaCha20Poly1305_Decrypt poly", poly, sizeof(poly));
  2428. #endif
  2429. ret = wc_Chacha_SetIV(ssl->decrypt.chacha, nonce, 1);
  2430. if (ret != 0) {
  2431. ForceZero(poly, sizeof(poly)); /* done with poly1305 key, clear it */
  2432. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2433. wc_MemZero_Check(poly, sizeof(poly));
  2434. #endif
  2435. return ret;
  2436. }
  2437. /* Set key for Poly1305. */
  2438. ret = wc_Poly1305SetKey(ssl->auth.poly1305, poly, sizeof(poly));
  2439. ForceZero(poly, sizeof(poly)); /* done with poly1305 key, clear it */
  2440. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2441. wc_MemZero_Check(poly, sizeof(poly));
  2442. #endif
  2443. if (ret != 0)
  2444. return ret;
  2445. /* Generate authentication tag for encrypted data. */
  2446. if ((ret = wc_Poly1305_MAC(ssl->auth.poly1305, aad, aadSz, input, sz, tag,
  2447. sizeof(tag))) != 0) {
  2448. return ret;
  2449. }
  2450. /* Check tag sent along with packet. */
  2451. if (ConstantCompare(tagIn, tag, POLY1305_AUTH_SZ) != 0) {
  2452. WOLFSSL_MSG("MAC did not match");
  2453. return VERIFY_MAC_ERROR;
  2454. }
  2455. /* If the tag was good decrypt message. */
  2456. ret = wc_Chacha_Process(ssl->decrypt.chacha, output, input, sz);
  2457. return ret;
  2458. }
  2459. #endif
  2460. #ifdef HAVE_NULL_CIPHER
  2461. /* Check HMAC tag and copy over input.
  2462. *
  2463. * ssl The SSL/TLS object.
  2464. * output The buffer to copy data into.
  2465. * May be the same pointer as input.
  2466. * input The data.
  2467. * sz The number of bytes of data.
  2468. * nonce The nonce to use with authentication.
  2469. * aad The additional authentication data.
  2470. * aadSz The size of the addition authentication data.
  2471. * tagIn The authentication tag data from packet.
  2472. * returns 0 on success, otherwise failure.
  2473. */
  2474. static int Tls13IntegrityOnly_Decrypt(WOLFSSL* ssl, byte* output,
  2475. const byte* input, word16 sz,
  2476. const byte* nonce,
  2477. const byte* aad, word16 aadSz,
  2478. const byte* tagIn)
  2479. {
  2480. int ret;
  2481. byte hmac[WC_MAX_DIGEST_SIZE];
  2482. /* HMAC: nonce | aad | input */
  2483. ret = wc_HmacUpdate(ssl->decrypt.hmac, nonce, HMAC_NONCE_SZ);
  2484. if (ret == 0)
  2485. ret = wc_HmacUpdate(ssl->decrypt.hmac, aad, aadSz);
  2486. if (ret == 0)
  2487. ret = wc_HmacUpdate(ssl->decrypt.hmac, input, sz);
  2488. if (ret == 0)
  2489. ret = wc_HmacFinal(ssl->decrypt.hmac, hmac);
  2490. /* Check authentication tag matches */
  2491. if (ret == 0 && ConstantCompare(tagIn, hmac, ssl->specs.hash_size) != 0)
  2492. ret = DECRYPT_ERROR;
  2493. /* Copy the input to output if not the same buffer */
  2494. if (ret == 0 && output != input)
  2495. XMEMCPY(output, input, sz);
  2496. return ret;
  2497. }
  2498. #endif
  2499. /* Decrypt data for TLS v1.3.
  2500. *
  2501. * ssl The SSL/TLS object.
  2502. * output The buffer to write decrypted data into.
  2503. * May be the same pointer as input.
  2504. * input The data to decrypt and authentication tag.
  2505. * sz The length of the encrypted data plus authentication tag.
  2506. * aad The additional authentication data.
  2507. * aadSz The size of the addition authentication data.
  2508. * returns 0 on success, otherwise failure.
  2509. */
  2510. int DecryptTls13(WOLFSSL* ssl, byte* output, const byte* input, word16 sz,
  2511. const byte* aad, word16 aadSz)
  2512. {
  2513. int ret = 0;
  2514. word16 dataSz = sz - ssl->specs.aead_mac_size;
  2515. word16 macSz = ssl->specs.aead_mac_size;
  2516. word32 nonceSz = 0;
  2517. WOLFSSL_ENTER("DecryptTls13");
  2518. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  2519. ret = tsip_Tls13AesDecrypt(ssl, output, input, sz);
  2520. if (ret != CRYPTOCB_UNAVAILABLE) {
  2521. #ifndef WOLFSSL_EARLY_DATA
  2522. if (ret < 0) {
  2523. ret = VERIFY_MAC_ERROR;
  2524. WOLFSSL_ERROR_VERBOSE(ret);
  2525. }
  2526. #endif
  2527. return ret;
  2528. }
  2529. #endif
  2530. #ifdef WOLFSSL_ASYNC_CRYPT
  2531. ret = wolfSSL_AsyncPop(ssl, &ssl->decrypt.state);
  2532. if (ret != WC_NOT_PENDING_E) {
  2533. /* check for still pending */
  2534. if (ret == WC_PENDING_E)
  2535. return ret;
  2536. ssl->error = 0; /* clear async */
  2537. /* let failures through so CIPHER_STATE_END logic is run */
  2538. }
  2539. else
  2540. #endif
  2541. {
  2542. /* Reset state */
  2543. ret = 0;
  2544. ssl->decrypt.state = CIPHER_STATE_BEGIN;
  2545. }
  2546. (void)output;
  2547. (void)input;
  2548. (void)sz;
  2549. (void)dataSz;
  2550. (void)macSz;
  2551. (void)nonceSz;
  2552. switch (ssl->decrypt.state) {
  2553. case CIPHER_STATE_BEGIN:
  2554. {
  2555. #ifdef WOLFSSL_DEBUG_TLS
  2556. WOLFSSL_MSG("Data to decrypt");
  2557. WOLFSSL_BUFFER(input, dataSz);
  2558. WOLFSSL_MSG("Additional Authentication Data");
  2559. WOLFSSL_BUFFER(aad, aadSz);
  2560. WOLFSSL_MSG("Authentication tag");
  2561. WOLFSSL_BUFFER(input + dataSz, macSz);
  2562. #endif
  2563. #ifdef CIPHER_NONCE
  2564. if (ssl->decrypt.nonce == NULL) {
  2565. ssl->decrypt.nonce = (byte*)XMALLOC(AEAD_NONCE_SZ,
  2566. ssl->heap, DYNAMIC_TYPE_AES_BUFFER);
  2567. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2568. if (ssl->decrypt.nonce != NULL) {
  2569. wc_MemZero_Add("DecryptTls13 nonce", ssl->decrypt.nonce,
  2570. AEAD_NONCE_SZ);
  2571. }
  2572. #endif
  2573. }
  2574. if (ssl->decrypt.nonce == NULL)
  2575. return MEMORY_E;
  2576. BuildTls13Nonce(ssl, ssl->decrypt.nonce, ssl->keys.aead_dec_imp_IV,
  2577. PEER_ORDER);
  2578. #endif
  2579. /* Advance state and proceed */
  2580. ssl->decrypt.state = CIPHER_STATE_DO;
  2581. }
  2582. FALL_THROUGH;
  2583. case CIPHER_STATE_DO:
  2584. {
  2585. switch (ssl->specs.bulk_cipher_algorithm) {
  2586. #ifdef BUILD_AESGCM
  2587. case wolfssl_aes_gcm:
  2588. #ifdef WOLFSSL_ASYNC_CRYPT
  2589. /* initialize event */
  2590. ret = wolfSSL_AsyncInit(ssl, &ssl->decrypt.aes->asyncDev,
  2591. WC_ASYNC_FLAG_NONE);
  2592. if (ret != 0)
  2593. break;
  2594. #endif
  2595. nonceSz = AESGCM_NONCE_SZ;
  2596. #if defined(HAVE_PK_CALLBACKS)
  2597. ret = NOT_COMPILED_IN;
  2598. if (ssl->ctx && ssl->ctx->PerformTlsRecordProcessingCb) {
  2599. ret = ssl->ctx->PerformTlsRecordProcessingCb(ssl, 0,
  2600. output, input, dataSz,
  2601. ssl->decrypt.nonce, nonceSz,
  2602. (byte *)(input + dataSz), macSz,
  2603. aad, aadSz);
  2604. }
  2605. if (ret == NOT_COMPILED_IN)
  2606. #endif
  2607. {
  2608. ret = wc_AesGcmDecrypt(ssl->decrypt.aes, output, input,
  2609. dataSz, ssl->decrypt.nonce, nonceSz,
  2610. input + dataSz, macSz, aad, aadSz);
  2611. #ifdef WOLFSSL_ASYNC_CRYPT
  2612. if (ret == WC_PENDING_E) {
  2613. ret = wolfSSL_AsyncPush(ssl,
  2614. &ssl->decrypt.aes->asyncDev);
  2615. }
  2616. #endif
  2617. }
  2618. break;
  2619. #endif
  2620. #ifdef HAVE_AESCCM
  2621. case wolfssl_aes_ccm:
  2622. #ifdef WOLFSSL_ASYNC_CRYPT
  2623. /* initialize event */
  2624. ret = wolfSSL_AsyncInit(ssl, &ssl->decrypt.aes->asyncDev,
  2625. WC_ASYNC_FLAG_NONE);
  2626. if (ret != 0)
  2627. break;
  2628. #endif
  2629. nonceSz = AESCCM_NONCE_SZ;
  2630. #if defined(HAVE_PK_CALLBACKS)
  2631. ret = NOT_COMPILED_IN;
  2632. if (ssl->ctx && ssl->ctx->PerformTlsRecordProcessingCb) {
  2633. ret = ssl->ctx->PerformTlsRecordProcessingCb(ssl, 0,
  2634. output, input, dataSz,
  2635. ssl->decrypt.nonce, nonceSz,
  2636. (byte *)(input + dataSz), macSz,
  2637. aad, aadSz);
  2638. }
  2639. if (ret == NOT_COMPILED_IN)
  2640. #endif
  2641. {
  2642. ret = wc_AesCcmDecrypt(ssl->decrypt.aes, output, input,
  2643. dataSz, ssl->decrypt.nonce, nonceSz,
  2644. input + dataSz, macSz, aad, aadSz);
  2645. #ifdef WOLFSSL_ASYNC_CRYPT
  2646. if (ret == WC_PENDING_E) {
  2647. ret = wolfSSL_AsyncPush(ssl,
  2648. &ssl->decrypt.aes->asyncDev);
  2649. }
  2650. #endif
  2651. }
  2652. break;
  2653. #endif
  2654. #if defined(HAVE_CHACHA) && defined(HAVE_POLY1305)
  2655. case wolfssl_chacha:
  2656. ret = ChaCha20Poly1305_Decrypt(ssl, output, input, dataSz,
  2657. ssl->decrypt.nonce, aad, aadSz, input + dataSz);
  2658. break;
  2659. #endif
  2660. #ifdef HAVE_NULL_CIPHER
  2661. case wolfssl_cipher_null:
  2662. ret = Tls13IntegrityOnly_Decrypt(ssl, output, input, dataSz,
  2663. ssl->decrypt.nonce, aad, aadSz, input + dataSz);
  2664. break;
  2665. #endif
  2666. default:
  2667. WOLFSSL_MSG("wolfSSL Decrypt programming error");
  2668. return DECRYPT_ERROR;
  2669. }
  2670. /* Advance state */
  2671. ssl->decrypt.state = CIPHER_STATE_END;
  2672. #ifdef WOLFSSL_ASYNC_CRYPT
  2673. /* If pending, leave now */
  2674. if (ret == WC_PENDING_E) {
  2675. return ret;
  2676. }
  2677. #endif
  2678. }
  2679. FALL_THROUGH;
  2680. case CIPHER_STATE_END:
  2681. {
  2682. #ifdef WOLFSSL_DEBUG_TLS
  2683. #ifdef CIPHER_NONCE
  2684. WOLFSSL_MSG("Nonce");
  2685. WOLFSSL_BUFFER(ssl->decrypt.nonce, ssl->specs.iv_size);
  2686. #endif
  2687. WOLFSSL_MSG("Decrypted data");
  2688. WOLFSSL_BUFFER(output, dataSz);
  2689. #endif
  2690. #ifdef WOLFSSL_CHECK_MEM_ZERO
  2691. if ((ssl->specs.bulk_cipher_algorithm != wolfssl_cipher_null) &&
  2692. (ret == 0)) {
  2693. wc_MemZero_Add("TLS 1.3 Decrypted data", output, sz);
  2694. }
  2695. #endif
  2696. #ifdef CIPHER_NONCE
  2697. ForceZero(ssl->decrypt.nonce, AEAD_NONCE_SZ);
  2698. #endif
  2699. break;
  2700. }
  2701. default:
  2702. break;
  2703. }
  2704. if (ret < 0) {
  2705. WOLFSSL_ERROR_VERBOSE(ret);
  2706. }
  2707. return ret;
  2708. }
  2709. /* Persistable BuildTls13Message arguments */
  2710. typedef struct BuildMsg13Args {
  2711. word32 sz;
  2712. word32 idx;
  2713. word32 headerSz;
  2714. word16 size;
  2715. } BuildMsg13Args;
  2716. static void FreeBuildMsg13Args(WOLFSSL* ssl, void* pArgs)
  2717. {
  2718. BuildMsg13Args* args = (BuildMsg13Args*)pArgs;
  2719. (void)ssl;
  2720. (void)args;
  2721. /* no allocations in BuildTls13Message */
  2722. }
  2723. /* Build SSL Message, encrypted.
  2724. * TLS v1.3 encryption is AEAD only.
  2725. *
  2726. * ssl The SSL/TLS object.
  2727. * output The buffer to write record message to.
  2728. * outSz Size of the buffer being written into.
  2729. * input The record data to encrypt (excluding record header).
  2730. * inSz The size of the record data.
  2731. * type The recorder header content type.
  2732. * hashOutput Whether to hash the unencrypted record data.
  2733. * sizeOnly Only want the size of the record message.
  2734. * asyncOkay If non-zero can return WC_PENDING_E, otherwise blocks on crypto
  2735. * returns the size of the encrypted record message or negative value on error.
  2736. */
  2737. int BuildTls13Message(WOLFSSL* ssl, byte* output, int outSz, const byte* input,
  2738. int inSz, int type, int hashOutput, int sizeOnly, int asyncOkay)
  2739. {
  2740. int ret;
  2741. BuildMsg13Args* args;
  2742. BuildMsg13Args lcl_args;
  2743. WOLFSSL_ENTER("BuildTls13Message");
  2744. #ifdef WOLFSSL_ASYNC_CRYPT
  2745. ret = WC_NOT_PENDING_E;
  2746. if (asyncOkay) {
  2747. WOLFSSL_ASSERT_SIZEOF_GE(ssl->async->args, *args);
  2748. if (ssl->async == NULL) {
  2749. ssl->async = (struct WOLFSSL_ASYNC*)
  2750. XMALLOC(sizeof(struct WOLFSSL_ASYNC), ssl->heap,
  2751. DYNAMIC_TYPE_ASYNC);
  2752. if (ssl->async == NULL)
  2753. return MEMORY_E;
  2754. }
  2755. args = (BuildMsg13Args*)ssl->async->args;
  2756. ret = wolfSSL_AsyncPop(ssl, &ssl->options.buildMsgState);
  2757. if (ret != WC_NOT_PENDING_E) {
  2758. /* Check for error */
  2759. if (ret < 0)
  2760. goto exit_buildmsg;
  2761. }
  2762. }
  2763. else
  2764. #endif
  2765. {
  2766. args = &lcl_args;
  2767. }
  2768. /* Reset state */
  2769. #ifdef WOLFSSL_ASYNC_CRYPT
  2770. if (ret == WC_NOT_PENDING_E)
  2771. #endif
  2772. {
  2773. ret = 0;
  2774. ssl->options.buildMsgState = BUILD_MSG_BEGIN;
  2775. XMEMSET(args, 0, sizeof(BuildMsg13Args));
  2776. args->headerSz = RECORD_HEADER_SZ;
  2777. #ifdef WOLFSSL_DTLS13
  2778. if (ssl->options.dtls)
  2779. args->headerSz = Dtls13GetRlHeaderLength(ssl, 1);
  2780. #endif /* WOLFSSL_DTLS13 */
  2781. args->sz = args->headerSz + inSz;
  2782. args->idx = args->headerSz;
  2783. #ifdef WOLFSSL_ASYNC_CRYPT
  2784. if (asyncOkay)
  2785. ssl->async->freeArgs = FreeBuildMsg13Args;
  2786. #endif
  2787. }
  2788. switch (ssl->options.buildMsgState) {
  2789. case BUILD_MSG_BEGIN:
  2790. {
  2791. /* catch mistaken sizeOnly parameter */
  2792. if (sizeOnly) {
  2793. if (output || input) {
  2794. WOLFSSL_MSG("BuildTls13Message with sizeOnly "
  2795. "doesn't need input or output");
  2796. return BAD_FUNC_ARG;
  2797. }
  2798. }
  2799. else if (output == NULL || input == NULL) {
  2800. return BAD_FUNC_ARG;
  2801. }
  2802. /* Record layer content type at the end of record data. */
  2803. args->sz++;
  2804. /* Authentication data at the end. */
  2805. args->sz += ssl->specs.aead_mac_size;
  2806. if (sizeOnly)
  2807. return args->sz;
  2808. if (args->sz > (word32)outSz) {
  2809. WOLFSSL_MSG("Oops, want to write past output buffer size");
  2810. return BUFFER_E;
  2811. }
  2812. /* Record data length. */
  2813. args->size = (word16)(args->sz - args->headerSz);
  2814. /* Write/update the record header with the new size.
  2815. * Always have the content type as application data for encrypted
  2816. * messages in TLS v1.3.
  2817. */
  2818. if (ssl->options.dtls) {
  2819. #ifdef WOLFSSL_DTLS13
  2820. Dtls13RlAddCiphertextHeader(ssl, output, args->size);
  2821. #endif /* WOLFSSL_DTLS13 */
  2822. }
  2823. else {
  2824. AddTls13RecordHeader(output, args->size, application_data, ssl);
  2825. }
  2826. /* TLS v1.3 can do in place encryption. */
  2827. if (input != output + args->idx)
  2828. XMEMCPY(output + args->idx, input, inSz);
  2829. args->idx += inSz;
  2830. ssl->options.buildMsgState = BUILD_MSG_HASH;
  2831. }
  2832. FALL_THROUGH;
  2833. case BUILD_MSG_HASH:
  2834. {
  2835. if (hashOutput) {
  2836. ret = HashOutput(ssl, output, args->headerSz + inSz, 0);
  2837. if (ret != 0)
  2838. goto exit_buildmsg;
  2839. }
  2840. /* The real record content type goes at the end of the data. */
  2841. output[args->idx++] = (byte)type;
  2842. ssl->options.buildMsgState = BUILD_MSG_ENCRYPT;
  2843. }
  2844. FALL_THROUGH;
  2845. case BUILD_MSG_ENCRYPT:
  2846. {
  2847. #ifdef WOLFSSL_QUIC
  2848. if (WOLFSSL_IS_QUIC(ssl)) {
  2849. /* QUIC does not use encryption of the TLS Record Layer.
  2850. * Return the original length + added headers
  2851. * and restore it in the record header. */
  2852. AddTls13RecordHeader(output, inSz, type, ssl);
  2853. ret = args->headerSz + inSz;
  2854. goto exit_buildmsg;
  2855. }
  2856. #endif
  2857. #ifdef ATOMIC_USER
  2858. if (ssl->ctx->MacEncryptCb) {
  2859. /* User Record Layer Callback handling */
  2860. byte* mac = output + args->idx;
  2861. output += args->headerSz;
  2862. ret = ssl->ctx->MacEncryptCb(ssl, mac, output, inSz, type, 0,
  2863. output, output, args->size, ssl->MacEncryptCtx);
  2864. }
  2865. else
  2866. #endif
  2867. {
  2868. const byte* aad = output;
  2869. output += args->headerSz;
  2870. ret = EncryptTls13(ssl, output, output, args->size, aad,
  2871. (word16)args->headerSz, asyncOkay);
  2872. if (ret != 0) {
  2873. #ifdef WOLFSSL_ASYNC_CRYPT
  2874. if (ret != WC_PENDING_E)
  2875. #endif
  2876. {
  2877. /* Zeroize plaintext. */
  2878. ForceZero(output, args->size);
  2879. }
  2880. }
  2881. #ifdef WOLFSSL_DTLS13
  2882. if (ret == 0 && ssl->options.dtls) {
  2883. /* AAD points to the header. Reuse the variable */
  2884. ret = Dtls13EncryptRecordNumber(ssl, (byte*)aad, (word16)args->sz);
  2885. }
  2886. #endif /* WOLFSSL_DTLS13 */
  2887. }
  2888. break;
  2889. }
  2890. default:
  2891. break;
  2892. }
  2893. exit_buildmsg:
  2894. WOLFSSL_LEAVE("BuildTls13Message", ret);
  2895. #ifdef WOLFSSL_ASYNC_CRYPT
  2896. if (ret == WC_PENDING_E) {
  2897. return ret;
  2898. }
  2899. #endif
  2900. /* make sure build message state is reset */
  2901. ssl->options.buildMsgState = BUILD_MSG_BEGIN;
  2902. /* return sz on success */
  2903. if (ret == 0) {
  2904. ret = args->sz;
  2905. }
  2906. else {
  2907. WOLFSSL_ERROR_VERBOSE(ret);
  2908. }
  2909. /* Final cleanup */
  2910. #ifdef WOLFSSL_ASYNC_CRYPT
  2911. if (asyncOkay)
  2912. FreeAsyncCtx(ssl, 0);
  2913. else
  2914. #endif
  2915. FreeBuildMsg13Args(ssl, args);
  2916. return ret;
  2917. }
  2918. #if !defined(NO_WOLFSSL_CLIENT) || (!defined(NO_WOLFSSL_SERVER) && \
  2919. (defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)) && \
  2920. defined(WOLFSSL_PSK_ONE_ID)) \
  2921. /* Find the cipher suite in the suites set in the SSL.
  2922. *
  2923. * ssl SSL/TLS object.
  2924. * suite Cipher suite to look for.
  2925. * returns 1 when suite is found in SSL/TLS object's list and 0 otherwise.
  2926. */
  2927. static int FindSuiteSSL(WOLFSSL* ssl, byte* suite)
  2928. {
  2929. word16 i;
  2930. const Suites* suites = WOLFSSL_SUITES(ssl);
  2931. for (i = 0; i < suites->suiteSz; i += 2) {
  2932. if (suites->suites[i+0] == suite[0] &&
  2933. suites->suites[i+1] == suite[1]) {
  2934. return 1;
  2935. }
  2936. }
  2937. return 0;
  2938. }
  2939. #endif
  2940. #ifndef NO_PSK
  2941. /* Get the MAC algorithm for the TLS 1.3 cipher suite.
  2942. *
  2943. * @param [in] suite.
  2944. * @return A value from wc_MACAlgorithm enumeration.
  2945. */
  2946. byte SuiteMac(const byte* suite)
  2947. {
  2948. byte mac = no_mac;
  2949. if (suite[0] == TLS13_BYTE) {
  2950. switch (suite[1]) {
  2951. #ifdef BUILD_TLS_AES_128_GCM_SHA256
  2952. case TLS_AES_128_GCM_SHA256:
  2953. mac = sha256_mac;
  2954. break;
  2955. #endif
  2956. #ifdef BUILD_TLS_CHACHA20_POLY1305_SHA256
  2957. case TLS_CHACHA20_POLY1305_SHA256:
  2958. mac = sha256_mac;
  2959. break;
  2960. #endif
  2961. #ifdef BUILD_TLS_AES_128_CCM_SHA256
  2962. case TLS_AES_128_CCM_SHA256:
  2963. mac = sha256_mac;
  2964. break;
  2965. #endif
  2966. #ifdef BUILD_TLS_AES_128_CCM_8_SHA256
  2967. case TLS_AES_128_CCM_8_SHA256:
  2968. mac = sha256_mac;
  2969. break;
  2970. #endif
  2971. #ifdef BUILD_TLS_AES_256_GCM_SHA384
  2972. case TLS_AES_256_GCM_SHA384:
  2973. mac = sha384_mac;
  2974. break;
  2975. #endif
  2976. default:
  2977. break;
  2978. }
  2979. }
  2980. #ifdef HAVE_NULL_CIPHER
  2981. else if (suite[0] == ECC_BYTE) {
  2982. switch (suite[1]) {
  2983. #ifdef BUILD_TLS_SHA256_SHA256
  2984. case TLS_SHA256_SHA256:
  2985. mac = sha256_mac;
  2986. break;
  2987. #endif
  2988. #ifdef BUILD_TLS_SHA384_SHA384
  2989. case TLS_SHA384_SHA384:
  2990. mac = sha384_mac;
  2991. break;
  2992. #endif
  2993. default:
  2994. break;
  2995. }
  2996. }
  2997. #endif
  2998. return mac;
  2999. }
  3000. #endif
  3001. #if defined(WOLFSSL_SEND_HRR_COOKIE) && !defined(NO_WOLFSSL_SERVER)
  3002. /* Create Cookie extension using the hash of the first ClientHello.
  3003. *
  3004. * ssl SSL/TLS object.
  3005. * hash The hash data.
  3006. * hashSz The size of the hash data in bytes.
  3007. * returns 0 on success, otherwise failure.
  3008. */
  3009. static int CreateCookie(WOLFSSL* ssl, byte* hash, byte hashSz)
  3010. {
  3011. int ret;
  3012. byte mac[WC_MAX_DIGEST_SIZE] = {0};
  3013. Hmac cookieHmac;
  3014. byte cookieType = 0;
  3015. byte macSz = 0;
  3016. #if !defined(NO_SHA) && defined(NO_SHA256)
  3017. cookieType = SHA;
  3018. macSz = WC_SHA_DIGEST_SIZE;
  3019. #endif /* NO_SHA */
  3020. #ifndef NO_SHA256
  3021. cookieType = WC_SHA256;
  3022. macSz = WC_SHA256_DIGEST_SIZE;
  3023. #endif /* NO_SHA256 */
  3024. ret = wc_HmacInit(&cookieHmac, ssl->heap, INVALID_DEVID);
  3025. if (ret == 0) {
  3026. ret = wc_HmacSetKey(&cookieHmac, cookieType,
  3027. ssl->buffers.tls13CookieSecret.buffer,
  3028. ssl->buffers.tls13CookieSecret.length);
  3029. }
  3030. if (ret == 0)
  3031. ret = wc_HmacUpdate(&cookieHmac, hash, hashSz);
  3032. #ifdef WOLFSSL_DTLS13
  3033. /* Tie cookie to peer address */
  3034. if (ret == 0) {
  3035. if (ssl->options.dtls && ssl->buffers.dtlsCtx.peer.sz > 0) {
  3036. ret = wc_HmacUpdate(&cookieHmac,
  3037. (byte*)ssl->buffers.dtlsCtx.peer.sa,
  3038. ssl->buffers.dtlsCtx.peer.sz);
  3039. }
  3040. }
  3041. #endif
  3042. if (ret == 0)
  3043. ret = wc_HmacFinal(&cookieHmac, mac);
  3044. wc_HmacFree(&cookieHmac);
  3045. if (ret != 0)
  3046. return ret;
  3047. /* The cookie data is the hash and the integrity check. */
  3048. return TLSX_Cookie_Use(ssl, hash, hashSz, mac, macSz, 1);
  3049. }
  3050. #endif
  3051. #ifdef WOLFSSL_DTLS13
  3052. #define HRR_MAX_HS_HEADER_SZ DTLS_HANDSHAKE_HEADER_SZ
  3053. #else
  3054. #define HRR_MAX_HS_HEADER_SZ HANDSHAKE_HEADER_SZ
  3055. #endif /* WOLFSSL_DTLS13 */
  3056. /* Restart the handshake hash with a hash of the previous messages.
  3057. *
  3058. * ssl The SSL/TLS object.
  3059. * returns 0 on success, otherwise failure.
  3060. */
  3061. int RestartHandshakeHash(WOLFSSL* ssl)
  3062. {
  3063. int ret;
  3064. Hashes hashes;
  3065. byte header[HANDSHAKE_HEADER_SZ] = {0};
  3066. byte* hash = NULL;
  3067. byte hashSz = 0;
  3068. ret = BuildCertHashes(ssl, &hashes);
  3069. if (ret != 0)
  3070. return ret;
  3071. switch (ssl->specs.mac_algorithm) {
  3072. #ifndef NO_SHA256
  3073. case sha256_mac:
  3074. hash = hashes.sha256;
  3075. break;
  3076. #endif
  3077. #ifdef WOLFSSL_SHA384
  3078. case sha384_mac:
  3079. hash = hashes.sha384;
  3080. break;
  3081. #endif
  3082. #ifdef WOLFSSL_TLS13_SHA512
  3083. case sha512_mac:
  3084. hash = hashes.sha512;
  3085. break;
  3086. #endif
  3087. }
  3088. hashSz = ssl->specs.hash_size;
  3089. /* check hash */
  3090. if (hash == NULL && hashSz > 0)
  3091. return BAD_FUNC_ARG;
  3092. AddTls13HandShakeHeader(header, hashSz, 0, 0, message_hash, ssl);
  3093. #ifdef WOLFSSL_DEBUG_TLS
  3094. WOLFSSL_MSG("Restart Hash");
  3095. WOLFSSL_BUFFER(hash, hashSz);
  3096. #endif
  3097. #if defined(WOLFSSL_SEND_HRR_COOKIE) && !defined(NO_WOLFSSL_SERVER)
  3098. if (ssl->options.sendCookie && ssl->options.side == WOLFSSL_SERVER_END) {
  3099. byte cookie[OPAQUE8_LEN + WC_MAX_DIGEST_SIZE + OPAQUE16_LEN * 2];
  3100. TLSX* ext;
  3101. word32 idx = 0;
  3102. /* Cookie Data = Hash Len | Hash | CS | KeyShare Group */
  3103. cookie[idx++] = hashSz;
  3104. if (hash)
  3105. XMEMCPY(cookie + idx, hash, hashSz);
  3106. idx += hashSz;
  3107. cookie[idx++] = ssl->options.cipherSuite0;
  3108. cookie[idx++] = ssl->options.cipherSuite;
  3109. if ((ext = TLSX_Find(ssl->extensions, TLSX_KEY_SHARE)) != NULL) {
  3110. KeyShareEntry* kse = (KeyShareEntry*)ext->data;
  3111. c16toa(kse->group, cookie + idx);
  3112. idx += OPAQUE16_LEN;
  3113. }
  3114. return CreateCookie(ssl, cookie, idx);
  3115. }
  3116. #endif
  3117. ret = InitHandshakeHashes(ssl);
  3118. if (ret != 0)
  3119. return ret;
  3120. ret = HashRaw(ssl, header, sizeof(header));
  3121. if (ret != 0)
  3122. return ret;
  3123. return HashRaw(ssl, hash, hashSz);
  3124. }
  3125. #if !defined(NO_WOLFSSL_CLIENT) || !defined(NO_WOLFSSL_SERVER)
  3126. /* The value in the random field of a ServerHello to indicate
  3127. * HelloRetryRequest.
  3128. */
  3129. static byte helloRetryRequestRandom[] = {
  3130. 0xCF, 0x21, 0xAD, 0x74, 0xE5, 0x9A, 0x61, 0x11,
  3131. 0xBE, 0x1D, 0x8C, 0x02, 0x1E, 0x65, 0xB8, 0x91,
  3132. 0xC2, 0xA2, 0x11, 0x16, 0x7A, 0xBB, 0x8C, 0x5E,
  3133. 0x07, 0x9E, 0x09, 0xE2, 0xC8, 0xA8, 0x33, 0x9C
  3134. };
  3135. #endif
  3136. #ifndef NO_WOLFSSL_CLIENT
  3137. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  3138. #if defined(OPENSSL_EXTRA) && !defined(WOLFSSL_PSK_ONE_ID) && \
  3139. !defined(NO_PSK)
  3140. /**
  3141. * convert mac algorithm to WOLFSSL_EVP_MD
  3142. * @param mac_alg mac algorithm
  3143. * @return const WOLFSSL_EVP_MD on successful, otherwise NULL
  3144. */
  3145. static const WOLFSSL_EVP_MD* ssl_handshake_md(const byte mac_alg)
  3146. {
  3147. switch(mac_alg) {
  3148. case no_mac:
  3149. #ifndef NO_MD5
  3150. case md5_mac:
  3151. return wolfSSL_EVP_md5();
  3152. #endif
  3153. #ifndef NO_SHA
  3154. case sha_mac:
  3155. return wolfSSL_EVP_sha1();
  3156. #endif
  3157. #ifdef WOLFSSL_SHA224
  3158. case sha224_mac:
  3159. return wolfSSL_EVP_sha224();
  3160. #endif
  3161. case sha256_mac:
  3162. return wolfSSL_EVP_sha256();
  3163. #ifdef WOLFSSL_SHA384
  3164. case sha384_mac:
  3165. return wolfSSL_EVP_sha384();
  3166. #endif
  3167. #ifdef WOLFSSL_SHA512
  3168. case sha512_mac:
  3169. return wolfSSL_EVP_sha512();
  3170. #endif
  3171. case rmd_mac:
  3172. case blake2b_mac:
  3173. WOLFSSL_MSG("no suitable EVP_MD");
  3174. return NULL;
  3175. default:
  3176. WOLFSSL_MSG("Unknown mac algorithm");
  3177. return NULL;
  3178. }
  3179. }
  3180. #endif
  3181. /* Setup pre-shared key based on the details in the extension data.
  3182. *
  3183. * ssl SSL/TLS object.
  3184. * psk Pre-shared key extension data.
  3185. * clientHello Whether called from client_hello construction.
  3186. * returns 0 on success, PSK_KEY_ERROR when the client PSK callback fails and
  3187. * other negative value on failure.
  3188. */
  3189. static int SetupPskKey(WOLFSSL* ssl, PreSharedKey* psk, int clientHello)
  3190. {
  3191. #if defined(HAVE_SESSION_TICKET) || !defined(WOLFSSL_PSK_ONE_ID)
  3192. int ret;
  3193. #endif
  3194. byte suite[2];
  3195. if (psk == NULL)
  3196. return BAD_FUNC_ARG;
  3197. suite[0] = ssl->options.cipherSuite0;
  3198. suite[1] = ssl->options.cipherSuite;
  3199. #ifdef HAVE_SESSION_TICKET
  3200. if (psk->resumption) {
  3201. if (clientHello) {
  3202. /* Ensure cipher suite is supported or changed suite to one with
  3203. * the same MAC algorithm. */
  3204. if (!FindSuiteSSL(ssl, suite)) {
  3205. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  3206. return PSK_KEY_ERROR;
  3207. }
  3208. /* Setting mac for binder and keys for deriving EarlyData. */
  3209. ret = SetCipherSpecs(ssl);
  3210. if (ret != 0)
  3211. return ret;
  3212. }
  3213. #ifdef WOLFSSL_EARLY_DATA
  3214. if (ssl->session->maxEarlyDataSz == 0)
  3215. ssl->earlyData = no_early_data;
  3216. #endif
  3217. /* Resumption PSK is master secret. */
  3218. ssl->arrays->psk_keySz = ssl->specs.hash_size;
  3219. if ((ret = DeriveResumptionPSK(ssl, ssl->session->ticketNonce.data,
  3220. ssl->session->ticketNonce.len, ssl->arrays->psk_key)) != 0) {
  3221. return ret;
  3222. }
  3223. if (!clientHello) {
  3224. /* CLIENT: using secret in ticket for peer authentication. */
  3225. ssl->options.peerAuthGood = 1;
  3226. }
  3227. }
  3228. #endif
  3229. #ifndef NO_PSK
  3230. if (!psk->resumption) {
  3231. /* Get the pre-shared key. */
  3232. #ifndef WOLFSSL_PSK_ONE_ID
  3233. const char* cipherName = NULL;
  3234. #ifdef OPENSSL_EXTRA
  3235. WOLFSSL_SESSION* psksession = NULL;
  3236. #endif
  3237. /* Set the client identity to use. */
  3238. XMEMSET(ssl->arrays->client_identity, 0,
  3239. sizeof(ssl->arrays->client_identity));
  3240. XMEMCPY(ssl->arrays->client_identity, psk->identity, psk->identityLen);
  3241. #ifdef WOLFSSL_DEBUG_TLS
  3242. WOLFSSL_MSG("PSK cipher suite:");
  3243. WOLFSSL_MSG(GetCipherNameInternal(psk->cipherSuite0, psk->cipherSuite));
  3244. #endif
  3245. /* Get the pre-shared key. */
  3246. #ifdef OPENSSL_EXTRA
  3247. if (ssl->options.session_psk_cb != NULL) {
  3248. const unsigned char* id = NULL;
  3249. size_t idlen = 0;
  3250. const WOLFSSL_EVP_MD* handshake_md = NULL;
  3251. if (ssl->msgsReceived.got_hello_retry_request >= 1) {
  3252. handshake_md = ssl_handshake_md(ssl->specs.mac_algorithm);
  3253. }
  3254. /* OpenSSL compatible callback that gets cached session. */
  3255. if (ssl->options.session_psk_cb(ssl, handshake_md, &id, &idlen,
  3256. &psksession) == 0) {
  3257. wolfSSL_FreeSession(ssl->ctx, psksession);
  3258. WOLFSSL_MSG("psk session callback failed");
  3259. return PSK_KEY_ERROR;
  3260. }
  3261. if (psksession != NULL) {
  3262. if (idlen > MAX_PSK_KEY_LEN) {
  3263. wolfSSL_FreeSession(ssl->ctx, psksession);
  3264. WOLFSSL_MSG("psk key length is too long");
  3265. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  3266. return PSK_KEY_ERROR;
  3267. }
  3268. ssl->arrays->psk_keySz = (word32)idlen;
  3269. XMEMCPY(ssl->arrays->psk_key, id, idlen);
  3270. suite[0] = psksession->cipherSuite0;
  3271. suite[1] = psksession->cipherSuite;
  3272. /* Not needed anymore. */
  3273. wolfSSL_FreeSession(ssl->ctx, psksession);
  3274. /* Leave pointer not NULL to indicate success with callback. */
  3275. }
  3276. }
  3277. if (psksession != NULL) {
  3278. /* Don't try other callbacks - we have an answer. */
  3279. }
  3280. else
  3281. #endif /* OPENSSL_EXTRA */
  3282. if (ssl->options.client_psk_cs_cb != NULL) {
  3283. #ifdef WOLFSSL_PSK_MULTI_ID_PER_CS
  3284. ssl->arrays->client_identity[0] = 0;
  3285. #endif
  3286. /* Lookup key again for next identity. */
  3287. ssl->arrays->psk_keySz = ssl->options.client_psk_cs_cb(
  3288. ssl, ssl->arrays->server_hint,
  3289. ssl->arrays->client_identity, MAX_PSK_ID_LEN,
  3290. ssl->arrays->psk_key, MAX_PSK_KEY_LEN,
  3291. GetCipherNameInternal(psk->cipherSuite0, psk->cipherSuite));
  3292. if (clientHello) {
  3293. /* Use PSK cipher suite. */
  3294. ssl->options.cipherSuite0 = psk->cipherSuite0;
  3295. ssl->options.cipherSuite = psk->cipherSuite;
  3296. }
  3297. else {
  3298. byte pskCS[2] = { psk->cipherSuite0, psk->cipherSuite };
  3299. /* Ensure PSK and negotiated cipher suites have same hash. */
  3300. if (SuiteMac(pskCS) != SuiteMac(suite)) {
  3301. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  3302. return PSK_KEY_ERROR;
  3303. }
  3304. /* Negotiated cipher suite is to be used - update PSK. */
  3305. psk->cipherSuite0 = suite[0];
  3306. psk->cipherSuite = suite[1];
  3307. }
  3308. }
  3309. else if (ssl->options.client_psk_tls13_cb != NULL) {
  3310. byte cipherSuite0;
  3311. byte cipherSuite;
  3312. int cipherSuiteFlags = WOLFSSL_CIPHER_SUITE_FLAG_NONE;
  3313. ssl->arrays->psk_keySz = ssl->options.client_psk_tls13_cb(ssl,
  3314. ssl->arrays->server_hint, ssl->arrays->client_identity,
  3315. MAX_PSK_ID_LEN, ssl->arrays->psk_key, MAX_PSK_KEY_LEN,
  3316. &cipherName);
  3317. if (GetCipherSuiteFromName(cipherName, &cipherSuite0,
  3318. &cipherSuite, &cipherSuiteFlags) != 0) {
  3319. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  3320. return PSK_KEY_ERROR;
  3321. }
  3322. ssl->options.cipherSuite0 = cipherSuite0;
  3323. ssl->options.cipherSuite = cipherSuite;
  3324. (void)cipherSuiteFlags;
  3325. }
  3326. else {
  3327. ssl->arrays->psk_keySz = ssl->options.client_psk_cb(ssl,
  3328. ssl->arrays->server_hint, ssl->arrays->client_identity,
  3329. MAX_PSK_ID_LEN, ssl->arrays->psk_key, MAX_PSK_KEY_LEN);
  3330. ssl->options.cipherSuite0 = TLS13_BYTE;
  3331. ssl->options.cipherSuite = WOLFSSL_DEF_PSK_CIPHER;
  3332. }
  3333. if (ssl->arrays->psk_keySz == 0 ||
  3334. ssl->arrays->psk_keySz > MAX_PSK_KEY_LEN) {
  3335. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  3336. return PSK_KEY_ERROR;
  3337. }
  3338. ret = SetCipherSpecs(ssl);
  3339. if (ret != 0)
  3340. return ret;
  3341. #else
  3342. /* PSK information loaded during setting of default TLS extensions. */
  3343. #endif /* !WOLFSSL_PSK_ONE_ID */
  3344. if (!clientHello && (psk->cipherSuite0 != suite[0] ||
  3345. psk->cipherSuite != suite[1])) {
  3346. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  3347. return PSK_KEY_ERROR;
  3348. }
  3349. if (!clientHello) {
  3350. /* CLIENT: using PSK for peer authentication. */
  3351. ssl->options.peerAuthGood = 1;
  3352. }
  3353. }
  3354. #endif
  3355. if (ssl->options.noPskDheKe) {
  3356. ssl->arrays->preMasterSz = 0;
  3357. }
  3358. /* Derive the early secret using the PSK. */
  3359. return DeriveEarlySecret(ssl);
  3360. }
  3361. /* Derive and write the binders into the ClientHello in space left when
  3362. * writing the Pre-Shared Key extension.
  3363. *
  3364. * ssl The SSL/TLS object.
  3365. * output The buffer containing the ClientHello.
  3366. * idx The index at the end of the completed ClientHello.
  3367. * returns 0 on success and otherwise failure.
  3368. */
  3369. static int WritePSKBinders(WOLFSSL* ssl, byte* output, word32 idx)
  3370. {
  3371. int ret;
  3372. TLSX* ext;
  3373. PreSharedKey* current;
  3374. byte binderKey[WC_MAX_DIGEST_SIZE];
  3375. word16 len;
  3376. WOLFSSL_ENTER("WritePSKBinders");
  3377. ext = TLSX_Find(ssl->extensions, TLSX_PRE_SHARED_KEY);
  3378. if (ext == NULL)
  3379. return SANITY_MSG_E;
  3380. /* Get the size of the binders to determine where to write binders. */
  3381. ret = TLSX_PreSharedKey_GetSizeBinders((PreSharedKey*)ext->data,
  3382. client_hello, &len);
  3383. if (ret < 0)
  3384. return ret;
  3385. idx -= len;
  3386. /* Hash truncated ClientHello - up to binders. */
  3387. #ifdef WOLFSSL_DTLS13
  3388. if (ssl->options.dtls)
  3389. ret = Dtls13HashHandshake(ssl, output + Dtls13GetRlHeaderLength(ssl, 0),
  3390. idx - Dtls13GetRlHeaderLength(ssl, 0));
  3391. else
  3392. #endif /* WOLFSSL_DTLS13 */
  3393. ret = HashOutput(ssl, output, idx, 0);
  3394. if (ret != 0)
  3395. return ret;
  3396. current = (PreSharedKey*)ext->data;
  3397. #ifdef WOLFSSL_CHECK_MEM_ZERO
  3398. if (current != NULL) {
  3399. wc_MemZero_Add("WritePSKBinders binderKey", binderKey,
  3400. sizeof(binderKey));
  3401. }
  3402. #endif
  3403. /* Calculate the binder for each identity based on previous handshake data.
  3404. */
  3405. while (current != NULL) {
  3406. if ((ret = SetupPskKey(ssl, current, 1)) != 0)
  3407. break;
  3408. #ifdef HAVE_SESSION_TICKET
  3409. if (current->resumption)
  3410. ret = DeriveBinderKeyResume(ssl, binderKey);
  3411. #endif
  3412. #ifndef NO_PSK
  3413. if (!current->resumption)
  3414. ret = DeriveBinderKey(ssl, binderKey);
  3415. #endif
  3416. if (ret != 0)
  3417. break;
  3418. /* Derive the Finished message secret. */
  3419. ret = DeriveFinishedSecret(ssl, binderKey,
  3420. ssl->keys.client_write_MAC_secret,
  3421. 0 /* neither end */);
  3422. if (ret != 0)
  3423. break;
  3424. /* Build the HMAC of the handshake message data = binder. */
  3425. ret = BuildTls13HandshakeHmac(ssl, ssl->keys.client_write_MAC_secret,
  3426. current->binder, &current->binderLen);
  3427. if (ret != 0)
  3428. break;
  3429. current = current->next;
  3430. }
  3431. ForceZero(binderKey, sizeof(binderKey));
  3432. #ifdef WOLFSSL_CHECK_MEM_ZERO
  3433. wc_MemZero_Check(binderKey, sizeof(binderKey));
  3434. #endif
  3435. if (ret != 0)
  3436. return ret;
  3437. /* Data entered into extension, now write to message. */
  3438. ret = TLSX_PreSharedKey_WriteBinders((PreSharedKey*)ext->data, output + idx,
  3439. client_hello, &len);
  3440. if (ret < 0)
  3441. return ret;
  3442. /* Hash binders to complete the hash of the ClientHello. */
  3443. ret = HashRaw(ssl, output + idx, len);
  3444. if (ret < 0)
  3445. return ret;
  3446. #ifdef WOLFSSL_EARLY_DATA
  3447. if (ssl->earlyData != no_early_data) {
  3448. if ((ret = SetupPskKey(ssl, (PreSharedKey*)ext->data, 1)) != 0)
  3449. return ret;
  3450. /* Derive early data encryption key. */
  3451. ret = DeriveTls13Keys(ssl, early_data_key, ENCRYPT_SIDE_ONLY, 1);
  3452. if (ret != 0)
  3453. return ret;
  3454. if ((ret = SetKeysSide(ssl, ENCRYPT_SIDE_ONLY)) != 0)
  3455. return ret;
  3456. #ifdef WOLFSSL_DTLS13
  3457. if (ssl->options.dtls) {
  3458. ret = Dtls13NewEpoch(
  3459. ssl, w64From32(0x0, DTLS13_EPOCH_EARLYDATA), ENCRYPT_SIDE_ONLY);
  3460. if (ret != 0)
  3461. return ret;
  3462. }
  3463. #endif /* WOLFSSL_DTLS13 */
  3464. }
  3465. #endif
  3466. WOLFSSL_LEAVE("WritePSKBinders", ret);
  3467. return ret;
  3468. }
  3469. #endif
  3470. #if defined(HAVE_ECH)
  3471. /* returns the index of the first supported cipher suite, -1 if none */
  3472. int EchConfigGetSupportedCipherSuite(WOLFSSL_EchConfig* config)
  3473. {
  3474. int i, j, supported = 0;
  3475. for (i = 0; i < config->numCipherSuites; i++) {
  3476. supported = 0;
  3477. for (j = 0; j < HPKE_SUPPORTED_KDF_LEN; j++) {
  3478. if (config->cipherSuites[i].kdfId == hpkeSupportedKdf[j])
  3479. break;
  3480. }
  3481. if (j < HPKE_SUPPORTED_KDF_LEN)
  3482. for (j = 0; j < HPKE_SUPPORTED_AEAD_LEN; j++) {
  3483. if (config->cipherSuites[i].aeadId == hpkeSupportedAead[j]) {
  3484. supported = 1;
  3485. break;
  3486. }
  3487. }
  3488. if (supported)
  3489. return i;
  3490. }
  3491. return -1;
  3492. }
  3493. /* returns status after we hash the ech inner */
  3494. static int EchHashHelloInner(WOLFSSL* ssl, WOLFSSL_ECH* ech)
  3495. {
  3496. int ret;
  3497. HS_Hashes* tmpHashes;
  3498. byte falseHeader[HANDSHAKE_HEADER_SZ];
  3499. if (ssl == NULL || ech == NULL)
  3500. return BAD_FUNC_ARG;
  3501. /* switch hsHashes to the ech version */
  3502. InitHandshakeHashesAndCopy(ssl, ssl->hsHashes, &ssl->hsHashesEch);
  3503. /* swap hsHashes so the regular hash functions work */
  3504. tmpHashes = ssl->hsHashes;
  3505. ssl->hsHashes = ssl->hsHashesEch;
  3506. /* do the handshake header then the body */
  3507. AddTls13HandShakeHeader(falseHeader,
  3508. ech->innerClientHelloLen - ech->paddingLen - ech->hpke->Nt, 0, 0,
  3509. client_hello, ssl);
  3510. ret = HashRaw(ssl, falseHeader, HANDSHAKE_HEADER_SZ);
  3511. /* hash the body */
  3512. if (ret == 0) {
  3513. ret = HashRaw(ssl, ech->innerClientHello,
  3514. ech->innerClientHelloLen - ech->paddingLen - ech->hpke->Nt);
  3515. }
  3516. /* swap hsHashes back */
  3517. ssl->hsHashes = tmpHashes;
  3518. return ret;
  3519. }
  3520. #endif
  3521. /* handle generation of TLS 1.3 client_hello (1) */
  3522. /* Send a ClientHello message to the server.
  3523. * Include the information required to start a handshake with servers using
  3524. * protocol versions less than TLS v1.3.
  3525. * Only a client will send this message.
  3526. *
  3527. * ssl The SSL/TLS object.
  3528. * returns 0 on success and otherwise failure.
  3529. */
  3530. typedef struct Sch13Args {
  3531. byte* output;
  3532. word32 idx;
  3533. int sendSz;
  3534. word16 length;
  3535. #if defined(HAVE_ECH)
  3536. int clientRandomOffset;
  3537. int preXLength;
  3538. WOLFSSL_ECH* ech;
  3539. #endif
  3540. } Sch13Args;
  3541. int SendTls13ClientHello(WOLFSSL* ssl)
  3542. {
  3543. int ret;
  3544. #ifdef WOLFSSL_ASYNC_CRYPT
  3545. Sch13Args* args = NULL;
  3546. WOLFSSL_ASSERT_SIZEOF_GE(ssl->async->args, *args);
  3547. #else
  3548. Sch13Args args[1];
  3549. #endif
  3550. byte major, tls12minor;
  3551. const Suites* suites;
  3552. WOLFSSL_START(WC_FUNC_CLIENT_HELLO_SEND);
  3553. WOLFSSL_ENTER("SendTls13ClientHello");
  3554. if (ssl == NULL) {
  3555. return BAD_FUNC_ARG;
  3556. }
  3557. ssl->options.buildingMsg = 1;
  3558. major = SSLv3_MAJOR;
  3559. tls12minor = TLSv1_2_MINOR;
  3560. #ifdef WOLFSSL_DTLS13
  3561. if (ssl->options.dtls) {
  3562. major = DTLS_MAJOR;
  3563. tls12minor = DTLSv1_2_MINOR;
  3564. }
  3565. #endif /* WOLFSSL_DTLS */
  3566. #ifdef HAVE_SESSION_TICKET
  3567. if (ssl->options.resuming &&
  3568. (ssl->session->version.major != ssl->version.major ||
  3569. ssl->session->version.minor != ssl->version.minor)) {
  3570. #ifndef WOLFSSL_NO_TLS12
  3571. if (ssl->session->version.major == ssl->version.major &&
  3572. ssl->session->version.minor < ssl->version.minor) {
  3573. /* Cannot resume with a different protocol version. */
  3574. ssl->options.resuming = 0;
  3575. ssl->version.major = ssl->session->version.major;
  3576. ssl->version.minor = ssl->session->version.minor;
  3577. return SendClientHello(ssl);
  3578. }
  3579. else
  3580. #endif
  3581. {
  3582. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  3583. return VERSION_ERROR;
  3584. }
  3585. }
  3586. #endif
  3587. suites = WOLFSSL_SUITES(ssl);
  3588. if (suites == NULL) {
  3589. WOLFSSL_MSG("Bad suites pointer in SendTls13ClientHello");
  3590. return SUITES_ERROR;
  3591. }
  3592. #ifdef WOLFSSL_ASYNC_CRYPT
  3593. if (ssl->async == NULL) {
  3594. ssl->async = (struct WOLFSSL_ASYNC*)
  3595. XMALLOC(sizeof(struct WOLFSSL_ASYNC), ssl->heap,
  3596. DYNAMIC_TYPE_ASYNC);
  3597. if (ssl->async == NULL)
  3598. return MEMORY_E;
  3599. ssl->async->freeArgs = NULL;
  3600. }
  3601. args = (Sch13Args*)ssl->async->args;
  3602. ret = wolfSSL_AsyncPop(ssl, &ssl->options.asyncState);
  3603. if (ret != WC_NOT_PENDING_E) {
  3604. /* Check for error */
  3605. if (ret < 0)
  3606. return ret;
  3607. }
  3608. else
  3609. #endif
  3610. {
  3611. /* Reset state */
  3612. ssl->options.asyncState = TLS_ASYNC_BEGIN;
  3613. XMEMSET(args, 0, sizeof(Sch13Args));
  3614. }
  3615. switch (ssl->options.asyncState) {
  3616. case TLS_ASYNC_BEGIN:
  3617. {
  3618. args->idx = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  3619. #ifdef WOLFSSL_DTLS13
  3620. if (ssl->options.dtls)
  3621. args->idx += DTLS_RECORD_EXTRA + DTLS_HANDSHAKE_EXTRA;
  3622. #endif /* WOLFSSL_DTLS13 */
  3623. /* Version | Random | Session Id | Cipher Suites | Compression */
  3624. args->length = VERSION_SZ + RAN_LEN + ENUM_LEN + suites->suiteSz +
  3625. SUITE_LEN + COMP_LEN + ENUM_LEN;
  3626. #ifdef WOLFSSL_QUIC
  3627. if (WOLFSSL_IS_QUIC(ssl)) {
  3628. /* RFC 9001 ch. 8.4 sessionID in ClientHello MUST be 0 length */
  3629. ssl->session->sessionIDSz = 0;
  3630. ssl->options.tls13MiddleBoxCompat = 0;
  3631. }
  3632. else
  3633. #endif
  3634. #if defined(WOLFSSL_TLS13_MIDDLEBOX_COMPAT)
  3635. {
  3636. args->length += ID_LEN;
  3637. ssl->options.tls13MiddleBoxCompat = 1;
  3638. }
  3639. #else
  3640. if (ssl->session->sessionIDSz > 0)
  3641. args->length += ssl->session->sessionIDSz;
  3642. #endif
  3643. #ifdef WOLFSSL_DTLS13
  3644. if (ssl->options.dtls) {
  3645. /* legacy_cookie_id len */
  3646. args->length += ENUM_LEN;
  3647. /* server sent us an HelloVerifyRequest and we allow downgrade */
  3648. if (ssl->arrays->cookieSz > 0 && ssl->options.downgrade)
  3649. args->length += ssl->arrays->cookieSz;
  3650. }
  3651. #endif /* WOLFSSL_DTLS13 */
  3652. /* Advance state and proceed */
  3653. ssl->options.asyncState = TLS_ASYNC_BUILD;
  3654. } /* case TLS_ASYNC_BEGIN */
  3655. FALL_THROUGH;
  3656. case TLS_ASYNC_BUILD:
  3657. case TLS_ASYNC_DO:
  3658. {
  3659. /* Auto populate extensions supported unless user defined. */
  3660. if ((ret = TLSX_PopulateExtensions(ssl, 0)) != 0)
  3661. return ret;
  3662. /* Advance state and proceed */
  3663. ssl->options.asyncState = TLS_ASYNC_FINALIZE;
  3664. } /* case TLS_ASYNC_BUILD */
  3665. FALL_THROUGH;
  3666. case TLS_ASYNC_FINALIZE:
  3667. {
  3668. #ifdef WOLFSSL_EARLY_DATA
  3669. #ifndef NO_PSK
  3670. if (!ssl->options.resuming &&
  3671. ssl->options.client_psk_tls13_cb == NULL &&
  3672. ssl->options.client_psk_cb == NULL)
  3673. #else
  3674. if (!ssl->options.resuming)
  3675. #endif
  3676. ssl->earlyData = no_early_data;
  3677. if (ssl->options.serverState == SERVER_HELLO_RETRY_REQUEST_COMPLETE)
  3678. ssl->earlyData = no_early_data;
  3679. if (ssl->earlyData == no_early_data)
  3680. TLSX_Remove(&ssl->extensions, TLSX_EARLY_DATA, ssl->heap);
  3681. if (ssl->earlyData != no_early_data &&
  3682. (ret = TLSX_EarlyData_Use(ssl, 0, 0)) < 0) {
  3683. return ret;
  3684. }
  3685. #endif
  3686. #ifdef WOLFSSL_QUIC
  3687. if (WOLFSSL_IS_QUIC(ssl) && IsAtLeastTLSv1_3(ssl->version)) {
  3688. ret = wolfSSL_quic_add_transport_extensions(ssl, client_hello);
  3689. if (ret != 0)
  3690. return ret;
  3691. }
  3692. #endif
  3693. /* find length of outer and inner */
  3694. #if defined(HAVE_ECH)
  3695. if (ssl->options.useEch == 1) {
  3696. TLSX* echX = TLSX_Find(ssl->extensions, TLSX_ECH);
  3697. if (echX == NULL)
  3698. return -1;
  3699. args->ech = (WOLFSSL_ECH*)echX->data;
  3700. if (args->ech == NULL)
  3701. return -1;
  3702. /* set the type to inner */
  3703. args->ech->type = ECH_TYPE_INNER;
  3704. args->preXLength = args->length;
  3705. /* get size for inner */
  3706. ret = TLSX_GetRequestSize(ssl, client_hello, &args->length);
  3707. if (ret != 0)
  3708. return ret;
  3709. /* set the type to outer */
  3710. args->ech->type = 0;
  3711. /* set innerClientHelloLen to ClientHelloInner + padding + tag */
  3712. args->ech->paddingLen = 31 - ((args->length - 1) % 32);
  3713. args->ech->innerClientHelloLen = args->length +
  3714. args->ech->paddingLen + args->ech->hpke->Nt;
  3715. /* set the length back to before we computed ClientHelloInner size */
  3716. args->length = args->preXLength;
  3717. }
  3718. #endif
  3719. /* Include length of TLS extensions. */
  3720. ret = TLSX_GetRequestSize(ssl, client_hello, &args->length);
  3721. if (ret != 0)
  3722. return ret;
  3723. /* Total message size. */
  3724. args->sendSz = args->length + HANDSHAKE_HEADER_SZ + RECORD_HEADER_SZ;
  3725. #ifdef WOLFSSL_DTLS13
  3726. if (ssl->options.dtls)
  3727. args->sendSz += DTLS_RECORD_EXTRA + DTLS_HANDSHAKE_EXTRA;
  3728. #endif /* WOLFSSL_DTLS13 */
  3729. /* Check buffers are big enough and grow if needed. */
  3730. if ((ret = CheckAvailableSize(ssl, args->sendSz)) != 0)
  3731. return ret;
  3732. /* Get position in output buffer to write new message to. */
  3733. args->output = ssl->buffers.outputBuffer.buffer +
  3734. ssl->buffers.outputBuffer.length;
  3735. /* Put the record and handshake headers on. */
  3736. AddTls13Headers(args->output, args->length, client_hello, ssl);
  3737. /* Protocol version - negotiation now in extension: supported_versions. */
  3738. args->output[args->idx++] = major;
  3739. args->output[args->idx++] = tls12minor;
  3740. /* Keep for downgrade. */
  3741. ssl->chVersion = ssl->version;
  3742. if (ssl->arrays == NULL) {
  3743. return BAD_FUNC_ARG;
  3744. }
  3745. /* Client Random */
  3746. if (ssl->options.connectState == CONNECT_BEGIN) {
  3747. ret = wc_RNG_GenerateBlock(ssl->rng, args->output + args->idx, RAN_LEN);
  3748. if (ret != 0)
  3749. return ret;
  3750. /* Store random for possible second ClientHello. */
  3751. XMEMCPY(ssl->arrays->clientRandom, args->output + args->idx, RAN_LEN);
  3752. }
  3753. else
  3754. XMEMCPY(args->output + args->idx, ssl->arrays->clientRandom, RAN_LEN);
  3755. #if defined(HAVE_ECH)
  3756. args->clientRandomOffset = args->idx;
  3757. #endif
  3758. args->idx += RAN_LEN;
  3759. if (ssl->session->sessionIDSz > 0) {
  3760. /* Session resumption for old versions of protocol. */
  3761. args->output[args->idx++] = ID_LEN;
  3762. XMEMCPY(args->output + args->idx, ssl->session->sessionID,
  3763. ssl->session->sessionIDSz);
  3764. args->idx += ID_LEN;
  3765. }
  3766. else {
  3767. #ifdef WOLFSSL_TLS13_MIDDLEBOX_COMPAT
  3768. if (ssl->options.tls13MiddleBoxCompat) {
  3769. args->output[args->idx++] = ID_LEN;
  3770. XMEMCPY(args->output + args->idx, ssl->arrays->clientRandom, ID_LEN);
  3771. args->idx += ID_LEN;
  3772. }
  3773. else
  3774. #endif /* WOLFSSL_TLS13_MIDDLEBOX_COMPAT */
  3775. {
  3776. /* TLS v1.3 does not use session id - 0 length. */
  3777. args->output[args->idx++] = 0;
  3778. }
  3779. }
  3780. #ifdef WOLFSSL_DTLS13
  3781. if (ssl->options.dtls) {
  3782. args->output[args->idx++] = ssl->arrays->cookieSz;
  3783. if (ssl->arrays->cookieSz > 0) {
  3784. /* We have a cookie saved, so the server sent us an
  3785. * HelloVerifyRequest, it means it is a v1.2 server */
  3786. if (!ssl->options.downgrade)
  3787. return VERSION_ERROR;
  3788. XMEMCPY(args->output + args->idx, ssl->arrays->cookie,
  3789. ssl->arrays->cookieSz);
  3790. args->idx += ssl->arrays->cookieSz;
  3791. }
  3792. }
  3793. #endif /* WOLFSSL_DTLS13 */
  3794. /* Cipher suites */
  3795. c16toa(suites->suiteSz, args->output + args->idx);
  3796. args->idx += OPAQUE16_LEN;
  3797. XMEMCPY(args->output + args->idx, &suites->suites,
  3798. suites->suiteSz);
  3799. args->idx += suites->suiteSz;
  3800. #ifdef WOLFSSL_DEBUG_TLS
  3801. {
  3802. int ii;
  3803. WOLFSSL_MSG("Ciphers:");
  3804. for (ii = 0 ; ii < suites->suiteSz; ii += 2) {
  3805. WOLFSSL_MSG(GetCipherNameInternal(suites->suites[ii+0],
  3806. suites->suites[ii+1]));
  3807. }
  3808. }
  3809. #endif
  3810. /* Compression not supported in TLS v1.3. */
  3811. args->output[args->idx++] = COMP_LEN;
  3812. args->output[args->idx++] = NO_COMPRESSION;
  3813. #if defined(HAVE_ECH)
  3814. /* write inner then outer */
  3815. if (ssl->options.useEch == 1) {
  3816. /* set the type to inner */
  3817. args->ech->type = ECH_TYPE_INNER;
  3818. /* allocate the inner */
  3819. args->ech->innerClientHello =
  3820. (byte*)XMALLOC(args->ech->innerClientHelloLen - args->ech->hpke->Nt,
  3821. ssl->heap, DYNAMIC_TYPE_TMP_BUFFER);
  3822. if (args->ech->innerClientHello == NULL)
  3823. return MEMORY_E;
  3824. /* set the padding bytes to 0 */
  3825. XMEMSET(args->ech->innerClientHello + args->ech->innerClientHelloLen -
  3826. args->ech->hpke->Nt - args->ech->paddingLen, 0,
  3827. args->ech->paddingLen);
  3828. /* copy the client hello to the ech innerClientHello, exclude record */
  3829. /* and handshake headers */
  3830. XMEMCPY(args->ech->innerClientHello,
  3831. args->output + RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ,
  3832. args->idx - (RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ));
  3833. /* copy the client random to inner */
  3834. XMEMCPY(ssl->arrays->clientRandomInner, ssl->arrays->clientRandom,
  3835. RAN_LEN);
  3836. /* change the outer client random */
  3837. ret = wc_RNG_GenerateBlock(ssl->rng, args->output +
  3838. args->clientRandomOffset, RAN_LEN);
  3839. if (ret != 0)
  3840. return ret;
  3841. /* copy the new client random */
  3842. XMEMCPY(ssl->arrays->clientRandom, args->output +
  3843. args->clientRandomOffset, RAN_LEN);
  3844. /* write the extensions for inner */
  3845. args->length = 0;
  3846. ret = TLSX_WriteRequest(ssl, args->ech->innerClientHello + args->idx -
  3847. (RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ), client_hello,
  3848. &args->length);
  3849. if (ret != 0)
  3850. return ret;
  3851. /* set the type to outer */
  3852. args->ech->type = 0;
  3853. }
  3854. #endif
  3855. /* Write out extensions for a request. */
  3856. args->length = 0;
  3857. ret = TLSX_WriteRequest(ssl, args->output + args->idx, client_hello,
  3858. &args->length);
  3859. if (ret != 0)
  3860. return ret;
  3861. args->idx += args->length;
  3862. #if defined(HAVE_ECH)
  3863. /* encrypt and pack the ech innerClientHello */
  3864. if (ssl->options.useEch == 1) {
  3865. ret = TLSX_FinalizeEch(args->ech,
  3866. args->output + RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ,
  3867. args->sendSz - (RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ));
  3868. if (ret != 0)
  3869. return ret;
  3870. }
  3871. #endif
  3872. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  3873. /* Resumption has a specific set of extensions and binder is calculated
  3874. * for each identity.
  3875. */
  3876. if (TLSX_Find(ssl->extensions, TLSX_PRE_SHARED_KEY)) {
  3877. ret = WritePSKBinders(ssl, args->output, args->idx);
  3878. }
  3879. else
  3880. #endif
  3881. {
  3882. #ifdef WOLFSSL_DTLS13
  3883. if (ssl->options.dtls)
  3884. ret = Dtls13HashHandshake(ssl,
  3885. args->output + Dtls13GetRlHeaderLength(ssl, 0),
  3886. (word16)args->idx - Dtls13GetRlHeaderLength(ssl, 0));
  3887. else
  3888. #endif /* WOLFSSL_DTLS13 */
  3889. {
  3890. #if defined(HAVE_ECH)
  3891. /* compute the inner hash */
  3892. if (ssl->options.useEch == 1) {
  3893. ret = EchHashHelloInner(ssl, args->ech);
  3894. }
  3895. #endif
  3896. /* compute the outer hash */
  3897. if (ret == 0)
  3898. ret = HashOutput(ssl, args->output, args->idx, 0);
  3899. }
  3900. }
  3901. if (ret != 0)
  3902. return ret;
  3903. ssl->options.clientState = CLIENT_HELLO_COMPLETE;
  3904. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  3905. if (ssl->hsInfoOn) AddPacketName(ssl, "ClientHello");
  3906. if (ssl->toInfoOn) {
  3907. ret = AddPacketInfo(ssl, "ClientHello", handshake, args->output,
  3908. args->sendSz, WRITE_PROTO, 0, ssl->heap);
  3909. if (ret != 0)
  3910. return ret;
  3911. }
  3912. #endif
  3913. ssl->options.buildingMsg = 0;
  3914. #ifdef WOLFSSL_DTLS13
  3915. if (ssl->options.dtls) {
  3916. ret = Dtls13HandshakeSend(ssl, args->output, (word16)args->sendSz,
  3917. (word16)args->idx, client_hello, 0);
  3918. WOLFSSL_LEAVE("SendTls13ClientHello", ret);
  3919. WOLFSSL_END(WC_FUNC_CLIENT_HELLO_SEND);
  3920. return ret;
  3921. }
  3922. #endif /* WOLFSSL_DTLS13 */
  3923. ssl->buffers.outputBuffer.length += args->sendSz;
  3924. /* Advance state and proceed */
  3925. ssl->options.asyncState = TLS_ASYNC_END;
  3926. }
  3927. /* case TLS_ASYNC_BUILD */
  3928. FALL_THROUGH;
  3929. case TLS_ASYNC_END:
  3930. {
  3931. #ifdef WOLFSSL_EARLY_DATA_GROUP
  3932. /* QUIC needs to forward records at their encryption level
  3933. * and is therefore unable to group here */
  3934. if (ssl->earlyData == no_early_data || WOLFSSL_IS_QUIC(ssl))
  3935. #endif
  3936. ret = SendBuffered(ssl);
  3937. break;
  3938. }
  3939. default:
  3940. ret = INPUT_CASE_ERROR;
  3941. } /* switch (ssl->options.asyncState) */
  3942. #ifdef WOLFSSL_ASYNC_CRYPT
  3943. if (ret == 0)
  3944. FreeAsyncCtx(ssl, 0);
  3945. #endif
  3946. WOLFSSL_LEAVE("SendTls13ClientHello", ret);
  3947. WOLFSSL_END(WC_FUNC_CLIENT_HELLO_SEND);
  3948. return ret;
  3949. }
  3950. #if defined(WOLFSSL_DTLS13) && !defined(WOLFSSL_NO_CLIENT)
  3951. static int Dtls13DoDowngrade(WOLFSSL* ssl)
  3952. {
  3953. int ret;
  3954. if (ssl->dtls13ClientHello == NULL)
  3955. return BAD_STATE_E;
  3956. /* v1.3 and v1.2 hash messages to compute the transcript hash. When we are
  3957. * using DTLSv1.3 we hash the first clientHello following v1.3 but the
  3958. * server can negotiate a lower version. So we need to re-hash the
  3959. * clientHello to adhere to DTLS <= v1.2 rules. */
  3960. ret = InitHandshakeHashes(ssl);
  3961. if (ret != 0)
  3962. return ret;
  3963. ret = HashRaw(ssl, ssl->dtls13ClientHello, ssl->dtls13ClientHelloSz);
  3964. XFREE(ssl->dtls13ClientHello, ssl->heap, DYNAMIC_TYPE_DTLS_MSG);
  3965. ssl->dtls13ClientHello = NULL;
  3966. ssl->dtls13ClientHelloSz = 0;
  3967. ssl->keys.dtls_sequence_number_hi =
  3968. (word16)w64GetHigh32(ssl->dtls13EncryptEpoch->nextSeqNumber);
  3969. ssl->keys.dtls_sequence_number_lo =
  3970. w64GetLow32(ssl->dtls13EncryptEpoch->nextSeqNumber);
  3971. return ret;
  3972. }
  3973. #endif /* WOLFSSL_DTLS13 && !WOLFSSL_NO_CLIENT*/
  3974. #if defined(HAVE_ECH)
  3975. /* check if the server accepted ech or not */
  3976. static int EchCheckAcceptance(WOLFSSL* ssl, const byte* input,
  3977. int serverRandomOffset, int helloSz)
  3978. {
  3979. int ret = 0;
  3980. int digestType;
  3981. int digestSize;
  3982. HS_Hashes* tmpHashes;
  3983. HS_Hashes* acceptHashes;
  3984. byte zeros[WC_MAX_DIGEST_SIZE] = {0};
  3985. byte transcriptEchConf[WC_MAX_DIGEST_SIZE];
  3986. byte expandLabelPrk[WC_MAX_DIGEST_SIZE];
  3987. byte acceptConfirmation[ECH_ACCEPT_CONFIRMATION_SZ];
  3988. /* copy ech hashes to accept */
  3989. ret = InitHandshakeHashesAndCopy(ssl, ssl->hsHashesEch, &acceptHashes);
  3990. /* swap hsHashes to acceptHashes */
  3991. tmpHashes = ssl->hsHashes;
  3992. ssl->hsHashes = acceptHashes;
  3993. /* hash up to the last 8 bytes */
  3994. if (ret == 0)
  3995. ret = HashRaw(ssl, input, serverRandomOffset + RAN_LEN -
  3996. ECH_ACCEPT_CONFIRMATION_SZ);
  3997. /* hash 8 zeros */
  3998. if (ret == 0)
  3999. ret = HashRaw(ssl, zeros, ECH_ACCEPT_CONFIRMATION_SZ);
  4000. /* hash the rest of the hello */
  4001. if (ret == 0)
  4002. ret = HashRaw(ssl, input + serverRandomOffset + RAN_LEN,
  4003. helloSz + HANDSHAKE_HEADER_SZ - (serverRandomOffset + RAN_LEN));
  4004. /* get the modified transcript hash */
  4005. if (ret == 0)
  4006. ret = GetMsgHash(ssl, transcriptEchConf);
  4007. if (ret > 0)
  4008. ret = 0;
  4009. /* pick the right type and size based on mac_algorithm */
  4010. if (ret == 0)
  4011. switch (ssl->specs.mac_algorithm) {
  4012. #ifndef NO_SHA256
  4013. case sha256_mac:
  4014. digestType = WC_SHA256;
  4015. digestSize = WC_SHA256_DIGEST_SIZE;
  4016. break;
  4017. #endif /* !NO_SHA256 */
  4018. #ifdef WOLFSSL_SHA384
  4019. case sha384_mac:
  4020. digestType = WC_SHA384;
  4021. digestSize = WC_SHA384_DIGEST_SIZE;
  4022. break;
  4023. #endif /* WOLFSSL_SHA384 */
  4024. #ifdef WOLFSSL_TLS13_SHA512
  4025. case sha512_mac:
  4026. digestType = WC_SHA512;
  4027. digestSize = WC_SHA512_DIGEST_SIZE;
  4028. break;
  4029. #endif /* WOLFSSL_TLS13_SHA512 */
  4030. default:
  4031. ret = -1;
  4032. break;
  4033. }
  4034. /* extract clientRandomInner with a key of all zeros */
  4035. if (ret == 0)
  4036. ret = wc_HKDF_Extract(digestType, zeros, digestSize,
  4037. ssl->arrays->clientRandomInner, RAN_LEN, expandLabelPrk);
  4038. /* tls expand with the confirmation label */
  4039. if (ret == 0)
  4040. ret = wc_Tls13_HKDF_Expand_Label(acceptConfirmation,
  4041. ECH_ACCEPT_CONFIRMATION_SZ,
  4042. expandLabelPrk, digestSize, tls13ProtocolLabel,
  4043. TLS13_PROTOCOL_LABEL_SZ, echAcceptConfirmationLabel,
  4044. ECH_ACCEPT_CONFIRMATION_LABEL_SZ, transcriptEchConf, digestSize,
  4045. digestType);
  4046. if (ret == 0) {
  4047. /* last 8 bytes should match our expand output */
  4048. ret = XMEMCMP(acceptConfirmation,
  4049. ssl->arrays->serverRandom + RAN_LEN - ECH_ACCEPT_CONFIRMATION_SZ,
  4050. ECH_ACCEPT_CONFIRMATION_SZ);
  4051. /* ech accepted */
  4052. if (ret == 0) {
  4053. /* use the inner random for client random */
  4054. XMEMCPY(ssl->arrays->clientRandom, ssl->arrays->clientRandomInner,
  4055. RAN_LEN);
  4056. /* switch back to original hsHashes */
  4057. ssl->hsHashes = tmpHashes;
  4058. /* free hsHashes */
  4059. FreeHandshakeHashes(ssl);
  4060. /* set the final hsHashes to the ech hashes */
  4061. tmpHashes = ssl->hsHashesEch;
  4062. /* set hsHashesEch to NULL to avoid double free */
  4063. ssl->hsHashesEch = NULL;
  4064. }
  4065. /* ech rejected */
  4066. else {
  4067. /* switch to hsHashesEch */
  4068. ssl->hsHashes = ssl->hsHashesEch;
  4069. /* free ech hashes */
  4070. FreeHandshakeHashes(ssl);
  4071. }
  4072. /* continue with outer if we failed to verify ech was accepted */
  4073. ret = 0;
  4074. }
  4075. /* switch to acceptHashes */
  4076. ssl->hsHashes = acceptHashes;
  4077. /* free acceptHashes */
  4078. FreeHandshakeHashes(ssl);
  4079. ssl->hsHashes = tmpHashes;
  4080. return ret;
  4081. }
  4082. /* replace the last 8 bytes of the server random with the ech acceptance
  4083. * parameter, return status */
  4084. static int EchWriteAcceptance(WOLFSSL* ssl, byte* output,
  4085. int serverRandomOffset, int helloSz)
  4086. {
  4087. int ret = 0;
  4088. int digestType;
  4089. int digestSize;
  4090. HS_Hashes* tmpHashes;
  4091. HS_Hashes* acceptHashes;
  4092. byte zeros[WC_MAX_DIGEST_SIZE] = {0};
  4093. byte transcriptEchConf[WC_MAX_DIGEST_SIZE];
  4094. byte expandLabelPrk[WC_MAX_DIGEST_SIZE];
  4095. /* copy ech hashes to accept */
  4096. ret = InitHandshakeHashesAndCopy(ssl, ssl->hsHashes, &acceptHashes);
  4097. /* swap hsHashes to acceptHashes */
  4098. tmpHashes = ssl->hsHashes;
  4099. ssl->hsHashes = acceptHashes;
  4100. /* hash up to the last 8 bytes */
  4101. if (ret == 0)
  4102. ret = HashRaw(ssl, output, serverRandomOffset + RAN_LEN -
  4103. ECH_ACCEPT_CONFIRMATION_SZ);
  4104. /* hash 8 zeros */
  4105. if (ret == 0)
  4106. ret = HashRaw(ssl, zeros, ECH_ACCEPT_CONFIRMATION_SZ);
  4107. /* hash the rest of the hello */
  4108. if (ret == 0)
  4109. ret = HashRaw(ssl, output + serverRandomOffset + RAN_LEN,
  4110. helloSz - (serverRandomOffset + RAN_LEN));
  4111. /* get the modified transcript hash */
  4112. if (ret == 0)
  4113. ret = GetMsgHash(ssl, transcriptEchConf);
  4114. if (ret > 0)
  4115. ret = 0;
  4116. /* pick the right type and size based on mac_algorithm */
  4117. if (ret == 0)
  4118. switch (ssl->specs.mac_algorithm) {
  4119. #ifndef NO_SHA256
  4120. case sha256_mac:
  4121. digestType = WC_SHA256;
  4122. digestSize = WC_SHA256_DIGEST_SIZE;
  4123. break;
  4124. #endif /* !NO_SHA256 */
  4125. #ifdef WOLFSSL_SHA384
  4126. case sha384_mac:
  4127. digestType = WC_SHA384;
  4128. digestSize = WC_SHA384_DIGEST_SIZE;
  4129. break;
  4130. #endif /* WOLFSSL_SHA384 */
  4131. #ifdef WOLFSSL_TLS13_SHA512
  4132. case sha512_mac:
  4133. digestType = WC_SHA512;
  4134. digestSize = WC_SHA512_DIGEST_SIZE;
  4135. break;
  4136. #endif /* WOLFSSL_TLS13_SHA512 */
  4137. default:
  4138. ret = -1;
  4139. break;
  4140. }
  4141. /* extract clientRandom with a key of all zeros */
  4142. if (ret == 0) {
  4143. PRIVATE_KEY_UNLOCK();
  4144. ret = wc_HKDF_Extract(digestType, zeros, digestSize,
  4145. ssl->arrays->clientRandom, RAN_LEN, expandLabelPrk);
  4146. PRIVATE_KEY_LOCK();
  4147. }
  4148. /* tls expand with the confirmation label */
  4149. if (ret == 0) {
  4150. PRIVATE_KEY_UNLOCK();
  4151. ret = wc_Tls13_HKDF_Expand_Label(
  4152. output + serverRandomOffset + RAN_LEN - ECH_ACCEPT_CONFIRMATION_SZ,
  4153. ECH_ACCEPT_CONFIRMATION_SZ,
  4154. expandLabelPrk, digestSize, tls13ProtocolLabel,
  4155. TLS13_PROTOCOL_LABEL_SZ, echAcceptConfirmationLabel,
  4156. ECH_ACCEPT_CONFIRMATION_LABEL_SZ, transcriptEchConf, digestSize,
  4157. digestType);
  4158. PRIVATE_KEY_LOCK();
  4159. }
  4160. if (ret == 0)
  4161. XMEMCPY(ssl->arrays->serverRandom, output + serverRandomOffset,
  4162. RAN_LEN);
  4163. /* free acceptHashes */
  4164. FreeHandshakeHashes(ssl);
  4165. ssl->hsHashes = tmpHashes;
  4166. return ret;
  4167. }
  4168. #endif
  4169. /* handle processing of TLS 1.3 server_hello (2) and hello_retry_request (6) */
  4170. /* Handle the ServerHello message from the server.
  4171. * Only a client will receive this message.
  4172. *
  4173. * ssl The SSL/TLS object.
  4174. * input The message buffer.
  4175. * inOutIdx On entry, the index into the message buffer of ServerHello.
  4176. * On exit, the index of byte after the ServerHello message.
  4177. * helloSz The length of the current handshake message.
  4178. * returns 0 on success and otherwise failure.
  4179. */
  4180. typedef struct Dsh13Args {
  4181. ProtocolVersion pv;
  4182. word32 idx;
  4183. word32 begin;
  4184. const byte* sessId;
  4185. word16 totalExtSz;
  4186. byte sessIdSz;
  4187. byte extMsgType;
  4188. #if defined(HAVE_ECH)
  4189. int serverRandomOffset;
  4190. #endif
  4191. } Dsh13Args;
  4192. int DoTls13ServerHello(WOLFSSL* ssl, const byte* input, word32* inOutIdx,
  4193. word32 helloSz, byte* extMsgType)
  4194. {
  4195. int ret;
  4196. byte suite[2];
  4197. byte tls12minor;
  4198. #ifdef WOLFSSL_ASYNC_CRYPT
  4199. Dsh13Args* args = NULL;
  4200. WOLFSSL_ASSERT_SIZEOF_GE(ssl->async->args, *args);
  4201. #else
  4202. Dsh13Args args[1];
  4203. #endif
  4204. WOLFSSL_START(WC_FUNC_SERVER_HELLO_DO);
  4205. WOLFSSL_ENTER("DoTls13ServerHello");
  4206. tls12minor = TLSv1_2_MINOR;
  4207. #ifdef WOLFSSL_DTLS13
  4208. if (ssl->options.dtls)
  4209. tls12minor = DTLSv1_2_MINOR;
  4210. #endif /* WOLFSSL_DTLS13 */
  4211. if (ssl == NULL || ssl->arrays == NULL)
  4212. return BAD_FUNC_ARG;
  4213. #ifdef WOLFSSL_ASYNC_CRYPT
  4214. if (ssl->async == NULL) {
  4215. ssl->async = (struct WOLFSSL_ASYNC*)
  4216. XMALLOC(sizeof(struct WOLFSSL_ASYNC), ssl->heap,
  4217. DYNAMIC_TYPE_ASYNC);
  4218. if (ssl->async == NULL)
  4219. return MEMORY_E;
  4220. ssl->async->freeArgs = NULL;
  4221. }
  4222. args = (Dsh13Args*)ssl->async->args;
  4223. ret = wolfSSL_AsyncPop(ssl, &ssl->options.asyncState);
  4224. if (ret != WC_NOT_PENDING_E) {
  4225. /* Check for error */
  4226. if (ret < 0) {
  4227. if (ret == WC_PENDING_E) {
  4228. /* Mark message as not received so it can process again */
  4229. ssl->msgsReceived.got_server_hello = 0;
  4230. }
  4231. return ret;
  4232. }
  4233. }
  4234. else
  4235. #endif
  4236. {
  4237. /* Reset state */
  4238. ssl->options.asyncState = TLS_ASYNC_BEGIN;
  4239. XMEMSET(args, 0, sizeof(Dsh13Args));
  4240. }
  4241. switch (ssl->options.asyncState) {
  4242. case TLS_ASYNC_BEGIN:
  4243. {
  4244. byte b;
  4245. #ifdef WOLFSSL_CALLBACKS
  4246. if (ssl->hsInfoOn) AddPacketName(ssl, "ServerHello");
  4247. if (ssl->toInfoOn) AddLateName("ServerHello", &ssl->timeoutInfo);
  4248. #endif
  4249. /* Protocol version length check. */
  4250. if (helloSz < OPAQUE16_LEN)
  4251. return BUFFER_ERROR;
  4252. args->idx = *inOutIdx;
  4253. args->begin = args->idx;
  4254. /* Protocol version */
  4255. XMEMCPY(&args->pv, input + args->idx, OPAQUE16_LEN);
  4256. args->idx += OPAQUE16_LEN;
  4257. #ifdef WOLFSSL_DTLS
  4258. if (ssl->options.dtls &&
  4259. (args->pv.major != DTLS_MAJOR || args->pv.minor == DTLS_BOGUS_MINOR))
  4260. return VERSION_ERROR;
  4261. #endif /* WOLFSSL_DTLS */
  4262. #ifndef WOLFSSL_NO_TLS12
  4263. {
  4264. byte wantDowngrade;
  4265. wantDowngrade = args->pv.major == ssl->version.major &&
  4266. args->pv.minor < TLSv1_2_MINOR;
  4267. #ifdef WOLFSSL_DTLS13
  4268. if (ssl->options.dtls)
  4269. wantDowngrade = args->pv.major == ssl->version.major &&
  4270. args->pv.minor > DTLSv1_2_MINOR;
  4271. #endif /* WOLFSSL_DTLS13 */
  4272. if (wantDowngrade && ssl->options.downgrade) {
  4273. /* Force client hello version 1.2 to work for static RSA. */
  4274. ssl->chVersion.minor = TLSv1_2_MINOR;
  4275. ssl->version.minor = TLSv1_2_MINOR;
  4276. #ifdef WOLFSSL_DTLS13
  4277. if (ssl->options.dtls) {
  4278. ssl->chVersion.minor = DTLSv1_2_MINOR;
  4279. ssl->version.minor = DTLSv1_2_MINOR;
  4280. ret = Dtls13DoDowngrade(ssl);
  4281. if (ret != 0)
  4282. return ret;
  4283. }
  4284. #endif /* WOLFSSL_DTLS13 */
  4285. return DoServerHello(ssl, input, inOutIdx, helloSz);
  4286. }
  4287. }
  4288. #endif
  4289. if (args->pv.major != ssl->version.major ||
  4290. args->pv.minor != tls12minor) {
  4291. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  4292. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  4293. return VERSION_ERROR;
  4294. }
  4295. /* Random and session id length check */
  4296. if ((args->idx - args->begin) + RAN_LEN + ENUM_LEN > helloSz)
  4297. return BUFFER_ERROR;
  4298. /* Check if hello retry request */
  4299. if (XMEMCMP(input + args->idx, helloRetryRequestRandom, RAN_LEN) == 0) {
  4300. WOLFSSL_MSG("HelloRetryRequest format");
  4301. *extMsgType = hello_retry_request;
  4302. /* A HelloRetryRequest comes in as an ServerHello for MiddleBox compat.
  4303. * Found message to be a HelloRetryRequest.
  4304. * Don't allow more than one HelloRetryRequest or ServerHello.
  4305. */
  4306. if (ssl->msgsReceived.got_hello_retry_request) {
  4307. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  4308. return DUPLICATE_MSG_E;
  4309. }
  4310. }
  4311. args->extMsgType = *extMsgType;
  4312. /* Server random - keep for debugging. */
  4313. XMEMCPY(ssl->arrays->serverRandom, input + args->idx, RAN_LEN);
  4314. #if defined(HAVE_ECH)
  4315. args->serverRandomOffset = args->idx;
  4316. #endif
  4317. args->idx += RAN_LEN;
  4318. /* Session id */
  4319. args->sessIdSz = input[args->idx++];
  4320. if ((args->idx - args->begin) + args->sessIdSz > helloSz)
  4321. return BUFFER_ERROR;
  4322. args->sessId = input + args->idx;
  4323. args->idx += args->sessIdSz;
  4324. ssl->options.haveSessionId = 1;
  4325. /* Ciphersuite and compression check */
  4326. if ((args->idx - args->begin) + OPAQUE16_LEN + OPAQUE8_LEN > helloSz)
  4327. return BUFFER_ERROR;
  4328. /* Set the cipher suite from the message. */
  4329. ssl->options.cipherSuite0 = input[args->idx++];
  4330. ssl->options.cipherSuite = input[args->idx++];
  4331. #ifdef WOLFSSL_DEBUG_TLS
  4332. WOLFSSL_MSG("Chosen cipher suite:");
  4333. WOLFSSL_MSG(GetCipherNameInternal(ssl->options.cipherSuite0,
  4334. ssl->options.cipherSuite));
  4335. #endif
  4336. /* Compression */
  4337. b = input[args->idx++];
  4338. if (b != 0) {
  4339. WOLFSSL_MSG("Must be no compression types in list");
  4340. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4341. return INVALID_PARAMETER;
  4342. }
  4343. if ((args->idx - args->begin) + OPAQUE16_LEN > helloSz) {
  4344. if (!ssl->options.downgrade)
  4345. return BUFFER_ERROR;
  4346. #ifndef WOLFSSL_NO_TLS12
  4347. /* Force client hello version 1.2 to work for static RSA. */
  4348. ssl->chVersion.minor = TLSv1_2_MINOR;
  4349. ssl->version.minor = TLSv1_2_MINOR;
  4350. #ifdef WOLFSSL_DTLS13
  4351. if (ssl->options.dtls) {
  4352. ssl->chVersion.minor = DTLSv1_2_MINOR;
  4353. ssl->version.minor = DTLSv1_2_MINOR;
  4354. ret = Dtls13DoDowngrade(ssl);
  4355. if (ret != 0)
  4356. return ret;
  4357. }
  4358. #endif /* WOLFSSL_DTLS13 */
  4359. #endif
  4360. ssl->options.haveEMS = 0;
  4361. if (args->pv.minor < ssl->options.minDowngrade) {
  4362. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  4363. return VERSION_ERROR;
  4364. }
  4365. #ifndef WOLFSSL_NO_TLS12
  4366. return DoServerHello(ssl, input, inOutIdx, helloSz);
  4367. #else
  4368. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  4369. return VERSION_ERROR;
  4370. #endif
  4371. }
  4372. if ((args->idx - args->begin) < helloSz) {
  4373. int foundVersion;
  4374. /* Get extension length and length check. */
  4375. if ((args->idx - args->begin) + OPAQUE16_LEN > helloSz)
  4376. return BUFFER_ERROR;
  4377. ato16(&input[args->idx], &args->totalExtSz);
  4378. args->idx += OPAQUE16_LEN;
  4379. if ((args->idx - args->begin) + args->totalExtSz > helloSz)
  4380. return BUFFER_ERROR;
  4381. /* Need to negotiate version first. */
  4382. if ((ret = TLSX_ParseVersion(ssl, input + args->idx,
  4383. args->totalExtSz, *extMsgType, &foundVersion))) {
  4384. return ret;
  4385. }
  4386. if (!foundVersion) {
  4387. if (!ssl->options.downgrade) {
  4388. WOLFSSL_MSG("Server trying to downgrade to version less than "
  4389. "TLS v1.3");
  4390. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  4391. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  4392. return VERSION_ERROR;
  4393. }
  4394. #if defined(OPENSSL_EXTRA) || defined(HAVE_WEBSERVER) || \
  4395. defined(WOLFSSL_WPAS_SMALL)
  4396. /* Check if client has disabled TLS 1.2 */
  4397. if (args->pv.minor == TLSv1_2_MINOR &&
  4398. (ssl->options.mask & SSL_OP_NO_TLSv1_2) == SSL_OP_NO_TLSv1_2) {
  4399. WOLFSSL_MSG("\tOption set to not allow TLSv1.2");
  4400. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  4401. return VERSION_ERROR;
  4402. }
  4403. #endif
  4404. if (!ssl->options.dtls &&
  4405. args->pv.minor < ssl->options.minDowngrade) {
  4406. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  4407. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  4408. return VERSION_ERROR;
  4409. }
  4410. if (ssl->options.dtls &&
  4411. args->pv.minor > ssl->options.minDowngrade) {
  4412. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  4413. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  4414. return VERSION_ERROR;
  4415. }
  4416. ssl->version.minor = args->pv.minor;
  4417. #ifdef WOLFSSL_DTLS13
  4418. if (ssl->options.dtls) {
  4419. ret = Dtls13DoDowngrade(ssl);
  4420. if (ret != 0)
  4421. return ret;
  4422. }
  4423. #endif /* WOLFSSL_DTLS13 */
  4424. }
  4425. }
  4426. #ifdef WOLFSSL_DTLS13
  4427. /* we are sure that version is >= v1.3 now, we can get rid of buffered
  4428. * ClientHello that was buffered to re-compute the hash in case of
  4429. * downgrade */
  4430. if (ssl->options.dtls && ssl->dtls13ClientHello != NULL) {
  4431. XFREE(ssl->dtls13ClientHello, ssl->heap, DYNAMIC_TYPE_DTLS_MSG);
  4432. ssl->dtls13ClientHello = NULL;
  4433. ssl->dtls13ClientHelloSz = 0;
  4434. }
  4435. #endif /* WOLFSSL_DTLS13 */
  4436. /* Advance state and proceed */
  4437. ssl->options.asyncState = TLS_ASYNC_BUILD;
  4438. } /* case TLS_ASYNC_BEGIN */
  4439. FALL_THROUGH;
  4440. case TLS_ASYNC_BUILD:
  4441. case TLS_ASYNC_DO:
  4442. {
  4443. /* restore message type */
  4444. *extMsgType = args->extMsgType;
  4445. if (args->totalExtSz > 0) {
  4446. /* Parse and handle extensions. */
  4447. ret = TLSX_Parse(ssl, input + args->idx, args->totalExtSz,
  4448. *extMsgType, NULL);
  4449. if (ret != 0) {
  4450. #ifdef WOLFSSL_ASYNC_CRYPT
  4451. /* Handle async operation */
  4452. if (ret == WC_PENDING_E) {
  4453. /* Mark message as not received so it can process again */
  4454. ssl->msgsReceived.got_server_hello = 0;
  4455. }
  4456. #endif
  4457. return ret;
  4458. }
  4459. if (*extMsgType == hello_retry_request) {
  4460. /* Update counts to reflect change of message type. */
  4461. ssl->msgsReceived.got_hello_retry_request = 1;
  4462. ssl->msgsReceived.got_server_hello = 0;
  4463. }
  4464. args->idx += args->totalExtSz;
  4465. }
  4466. #ifdef WOLFSSL_DTLS_CID
  4467. if (ssl->options.useDtlsCID && *extMsgType == server_hello)
  4468. DtlsCIDOnExtensionsParsed(ssl);
  4469. #endif /* WOLFSSL_DTLS_CID */
  4470. *inOutIdx = args->idx;
  4471. ssl->options.serverState = SERVER_HELLO_COMPLETE;
  4472. #ifdef HAVE_SECRET_CALLBACK
  4473. if (ssl->sessionSecretCb != NULL
  4474. #ifdef HAVE_SESSION_TICKET
  4475. && ssl->session->ticketLen > 0
  4476. #endif
  4477. ) {
  4478. int secretSz = SECRET_LEN;
  4479. ret = ssl->sessionSecretCb(ssl, ssl->session->masterSecret,
  4480. &secretSz, ssl->sessionSecretCtx);
  4481. if (ret != 0 || secretSz != SECRET_LEN) {
  4482. WOLFSSL_ERROR_VERBOSE(SESSION_SECRET_CB_E);
  4483. return SESSION_SECRET_CB_E;
  4484. }
  4485. }
  4486. #endif /* HAVE_SECRET_CALLBACK */
  4487. /* Version only negotiated in extensions for TLS v1.3.
  4488. * Only now do we know how to deal with session id.
  4489. */
  4490. if (!IsAtLeastTLSv1_3(ssl->version)) {
  4491. #ifndef WOLFSSL_NO_TLS12
  4492. ssl->arrays->sessionIDSz = args->sessIdSz;
  4493. if (ssl->arrays->sessionIDSz > ID_LEN) {
  4494. WOLFSSL_MSG("Invalid session ID size");
  4495. ssl->arrays->sessionIDSz = 0;
  4496. return BUFFER_ERROR;
  4497. }
  4498. else if (ssl->arrays->sessionIDSz) {
  4499. XMEMCPY(ssl->arrays->sessionID, args->sessId,
  4500. ssl->arrays->sessionIDSz);
  4501. ssl->options.haveSessionId = 1;
  4502. }
  4503. /* Force client hello version 1.2 to work for static RSA. */
  4504. ssl->chVersion.minor = TLSv1_2_MINOR;
  4505. /* Complete TLS v1.2 processing of ServerHello. */
  4506. ret = CompleteServerHello(ssl);
  4507. #else
  4508. WOLFSSL_MSG("Client using higher version, fatal error");
  4509. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  4510. ret = VERSION_ERROR;
  4511. #endif
  4512. WOLFSSL_LEAVE("DoTls13ServerHello", ret);
  4513. return ret;
  4514. }
  4515. /* Advance state and proceed */
  4516. ssl->options.asyncState = TLS_ASYNC_FINALIZE;
  4517. } /* case TLS_ASYNC_BUILD || TLS_ASYNC_DO */
  4518. FALL_THROUGH;
  4519. case TLS_ASYNC_FINALIZE:
  4520. {
  4521. #ifdef WOLFSSL_TLS13_MIDDLEBOX_COMPAT
  4522. if (ssl->options.tls13MiddleBoxCompat) {
  4523. if (args->sessIdSz == 0) {
  4524. WOLFSSL_MSG("args->sessIdSz == 0");
  4525. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4526. return INVALID_PARAMETER;
  4527. }
  4528. if (ssl->session->sessionIDSz != 0) {
  4529. if (ssl->session->sessionIDSz != args->sessIdSz ||
  4530. XMEMCMP(ssl->session->sessionID, args->sessId,
  4531. args->sessIdSz) != 0) {
  4532. WOLFSSL_MSG("session id doesn't match");
  4533. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4534. return INVALID_PARAMETER;
  4535. }
  4536. }
  4537. else if (XMEMCMP(ssl->arrays->clientRandom, args->sessId,
  4538. args->sessIdSz) != 0) {
  4539. WOLFSSL_MSG("session id doesn't match client random");
  4540. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4541. return INVALID_PARAMETER;
  4542. }
  4543. }
  4544. else
  4545. #endif /* WOLFSSL_TLS13_MIDDLEBOX_COMPAT */
  4546. #ifdef WOLFSSL_QUIC
  4547. if (WOLFSSL_IS_QUIC(ssl)) {
  4548. if (args->sessIdSz != 0) {
  4549. WOLFSSL_MSG("args->sessIdSz != 0");
  4550. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4551. return INVALID_PARAMETER;
  4552. }
  4553. }
  4554. else
  4555. #endif /* WOLFSSL_QUIC */
  4556. if (args->sessIdSz != ssl->session->sessionIDSz || (args->sessIdSz > 0 &&
  4557. XMEMCMP(ssl->session->sessionID, args->sessId, args->sessIdSz) != 0))
  4558. {
  4559. WOLFSSL_MSG("Server sent different session id");
  4560. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4561. return INVALID_PARAMETER;
  4562. }
  4563. ret = SetCipherSpecs(ssl);
  4564. if (ret != 0)
  4565. return ret;
  4566. #if defined(HAVE_ECH)
  4567. /* check for acceptConfirmation and HashInput with 8 0 bytes */
  4568. if (ssl->options.useEch == 1) {
  4569. ret = EchCheckAcceptance(ssl, input, args->serverRandomOffset, helloSz);
  4570. if (ret != 0)
  4571. return ret;
  4572. }
  4573. #endif
  4574. #ifdef HAVE_NULL_CIPHER
  4575. if (ssl->options.cipherSuite0 == ECC_BYTE &&
  4576. (ssl->options.cipherSuite == TLS_SHA256_SHA256 ||
  4577. ssl->options.cipherSuite == TLS_SHA384_SHA384)) {
  4578. ;
  4579. }
  4580. else
  4581. #endif
  4582. /* Check that the negotiated ciphersuite matches protocol version. */
  4583. if (ssl->options.cipherSuite0 != TLS13_BYTE) {
  4584. WOLFSSL_MSG("Server sent non-TLS13 cipher suite in TLS 1.3 packet");
  4585. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4586. return INVALID_PARAMETER;
  4587. }
  4588. suite[0] = ssl->options.cipherSuite0;
  4589. suite[1] = ssl->options.cipherSuite;
  4590. if (!FindSuiteSSL(ssl, suite)) {
  4591. WOLFSSL_MSG("Cipher suite not supported on client");
  4592. WOLFSSL_ERROR_VERBOSE(MATCH_SUITE_ERROR);
  4593. return MATCH_SUITE_ERROR;
  4594. }
  4595. if (*extMsgType == server_hello) {
  4596. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  4597. PreSharedKey* psk = NULL;
  4598. TLSX* ext = TLSX_Find(ssl->extensions, TLSX_PRE_SHARED_KEY);
  4599. if (ext != NULL)
  4600. psk = (PreSharedKey*)ext->data;
  4601. while (psk != NULL && !psk->chosen)
  4602. psk = psk->next;
  4603. if (psk == NULL) {
  4604. ssl->options.resuming = 0;
  4605. ssl->arrays->psk_keySz = 0;
  4606. XMEMSET(ssl->arrays->psk_key, 0, MAX_PSK_KEY_LEN);
  4607. }
  4608. else {
  4609. if ((ret = SetupPskKey(ssl, psk, 0)) != 0)
  4610. return ret;
  4611. ssl->options.pskNegotiated = 1;
  4612. }
  4613. #endif
  4614. ssl->keys.encryptionOn = 1;
  4615. ssl->options.serverState = SERVER_HELLO_COMPLETE;
  4616. }
  4617. else {
  4618. ssl->options.tls1_3 = 1;
  4619. ssl->options.serverState = SERVER_HELLO_RETRY_REQUEST_COMPLETE;
  4620. ret = RestartHandshakeHash(ssl);
  4621. }
  4622. break;
  4623. } /* case TLS_ASYNC_FINALIZE */
  4624. default:
  4625. ret = INPUT_CASE_ERROR;
  4626. } /* switch (ssl->options.asyncState) */
  4627. #ifdef WOLFSSL_ASYNC_CRYPT
  4628. if (ret == 0)
  4629. FreeAsyncCtx(ssl, 0);
  4630. #endif
  4631. WOLFSSL_LEAVE("DoTls13ServerHello", ret);
  4632. WOLFSSL_END(WC_FUNC_SERVER_HELLO_DO);
  4633. return ret;
  4634. }
  4635. /* handle processing TLS 1.3 encrypted_extensions (8) */
  4636. /* Parse and handle an EncryptedExtensions message.
  4637. * Only a client will receive this message.
  4638. *
  4639. * ssl The SSL/TLS object.
  4640. * input The message buffer.
  4641. * inOutIdx On entry, the index into the message buffer of
  4642. * EncryptedExtensions.
  4643. * On exit, the index of byte after the EncryptedExtensions
  4644. * message.
  4645. * totalSz The length of the current handshake message.
  4646. * returns 0 on success and otherwise failure.
  4647. */
  4648. static int DoTls13EncryptedExtensions(WOLFSSL* ssl, const byte* input,
  4649. word32* inOutIdx, word32 totalSz)
  4650. {
  4651. int ret;
  4652. word32 begin = *inOutIdx;
  4653. word32 i = begin;
  4654. word16 totalExtSz;
  4655. WOLFSSL_START(WC_FUNC_ENCRYPTED_EXTENSIONS_DO);
  4656. WOLFSSL_ENTER("DoTls13EncryptedExtensions");
  4657. #ifdef WOLFSSL_CALLBACKS
  4658. if (ssl->hsInfoOn) AddPacketName(ssl, "EncryptedExtensions");
  4659. if (ssl->toInfoOn) AddLateName("EncryptedExtensions", &ssl->timeoutInfo);
  4660. #endif
  4661. /* Length field of extension data. */
  4662. if (totalSz < OPAQUE16_LEN)
  4663. return BUFFER_ERROR;
  4664. ato16(&input[i], &totalExtSz);
  4665. i += OPAQUE16_LEN;
  4666. /* Extension data. */
  4667. if (i - begin + totalExtSz > totalSz)
  4668. return BUFFER_ERROR;
  4669. if ((ret = TLSX_Parse(ssl, input + i, totalExtSz, encrypted_extensions,
  4670. NULL))) {
  4671. return ret;
  4672. }
  4673. /* Move index to byte after message. */
  4674. *inOutIdx = i + totalExtSz;
  4675. /* Always encrypted. */
  4676. *inOutIdx += ssl->keys.padSz;
  4677. #ifdef WOLFSSL_EARLY_DATA
  4678. if (ssl->earlyData != no_early_data) {
  4679. TLSX* ext = TLSX_Find(ssl->extensions, TLSX_EARLY_DATA);
  4680. if (ext == NULL || !ext->val)
  4681. ssl->earlyData = no_early_data;
  4682. }
  4683. #endif
  4684. #ifdef WOLFSSL_EARLY_DATA
  4685. if (ssl->earlyData == no_early_data) {
  4686. ret = SetKeysSide(ssl, ENCRYPT_SIDE_ONLY);
  4687. if (ret != 0)
  4688. return ret;
  4689. }
  4690. #endif
  4691. ssl->options.serverState = SERVER_ENCRYPTED_EXTENSIONS_COMPLETE;
  4692. WOLFSSL_LEAVE("DoTls13EncryptedExtensions", ret);
  4693. WOLFSSL_END(WC_FUNC_ENCRYPTED_EXTENSIONS_DO);
  4694. return ret;
  4695. }
  4696. #ifndef NO_CERTS
  4697. /* handle processing TLS v1.3 certificate_request (13) */
  4698. /* Handle a TLS v1.3 CertificateRequest message.
  4699. * This message is always encrypted.
  4700. * Only a client will receive this message.
  4701. *
  4702. * ssl The SSL/TLS object.
  4703. * input The message buffer.
  4704. * inOutIdx On entry, the index into the message buffer of CertificateRequest.
  4705. * On exit, the index of byte after the CertificateRequest message.
  4706. * size The length of the current handshake message.
  4707. * returns 0 on success and otherwise failure.
  4708. */
  4709. static int DoTls13CertificateRequest(WOLFSSL* ssl, const byte* input,
  4710. word32* inOutIdx, word32 size)
  4711. {
  4712. word16 len;
  4713. word32 begin = *inOutIdx;
  4714. int ret = 0;
  4715. Suites peerSuites;
  4716. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  4717. CertReqCtx* certReqCtx;
  4718. #endif
  4719. WOLFSSL_START(WC_FUNC_CERTIFICATE_REQUEST_DO);
  4720. WOLFSSL_ENTER("DoTls13CertificateRequest");
  4721. XMEMSET(&peerSuites, 0, sizeof(Suites));
  4722. #ifdef WOLFSSL_CALLBACKS
  4723. if (ssl->hsInfoOn) AddPacketName(ssl, "CertificateRequest");
  4724. if (ssl->toInfoOn) AddLateName("CertificateRequest", &ssl->timeoutInfo);
  4725. #endif
  4726. if (OPAQUE8_LEN > size)
  4727. return BUFFER_ERROR;
  4728. /* Length of the request context. */
  4729. len = input[(*inOutIdx)++];
  4730. if ((*inOutIdx - begin) + len > size)
  4731. return BUFFER_ERROR;
  4732. if (ssl->options.connectState < FINISHED_DONE && len > 0)
  4733. return BUFFER_ERROR;
  4734. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  4735. /* CertReqCtx has one byte at end for context value.
  4736. * Increase size to handle other implementations sending more than one byte.
  4737. * That is, allocate extra space, over one byte, to hold the context value.
  4738. */
  4739. certReqCtx = (CertReqCtx*)XMALLOC(sizeof(CertReqCtx) + len - 1, ssl->heap,
  4740. DYNAMIC_TYPE_TMP_BUFFER);
  4741. if (certReqCtx == NULL)
  4742. return MEMORY_E;
  4743. certReqCtx->next = ssl->certReqCtx;
  4744. certReqCtx->len = len;
  4745. XMEMCPY(&certReqCtx->ctx, input + *inOutIdx, len);
  4746. ssl->certReqCtx = certReqCtx;
  4747. #endif
  4748. *inOutIdx += len;
  4749. /* TODO: Add support for more extensions:
  4750. * signed_certificate_timestamp, certificate_authorities, oid_filters.
  4751. */
  4752. /* Certificate extensions */
  4753. if ((*inOutIdx - begin) + OPAQUE16_LEN > size)
  4754. return BUFFER_ERROR;
  4755. ato16(input + *inOutIdx, &len);
  4756. *inOutIdx += OPAQUE16_LEN;
  4757. if ((*inOutIdx - begin) + len > size)
  4758. return BUFFER_ERROR;
  4759. if (len == 0)
  4760. return INVALID_PARAMETER;
  4761. if ((ret = TLSX_Parse(ssl, input + *inOutIdx, len, certificate_request,
  4762. &peerSuites))) {
  4763. return ret;
  4764. }
  4765. *inOutIdx += len;
  4766. if ((ssl->buffers.certificate && ssl->buffers.certificate->buffer &&
  4767. ((ssl->buffers.key && ssl->buffers.key->buffer)
  4768. #ifdef HAVE_PK_CALLBACKS
  4769. || wolfSSL_CTX_IsPrivatePkSet(ssl->ctx)
  4770. #endif
  4771. ))
  4772. #ifdef OPENSSL_EXTRA
  4773. || ssl->ctx->certSetupCb != NULL
  4774. #endif
  4775. ) {
  4776. if (PickHashSigAlgo(ssl, peerSuites.hashSigAlgo,
  4777. peerSuites.hashSigAlgoSz) != 0) {
  4778. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  4779. return INVALID_PARAMETER;
  4780. }
  4781. ssl->options.sendVerify = SEND_CERT;
  4782. }
  4783. else {
  4784. #ifndef WOLFSSL_NO_CLIENT_CERT_ERROR
  4785. ssl->options.sendVerify = SEND_BLANK_CERT;
  4786. #else
  4787. WOLFSSL_MSG("Certificate required but none set on client");
  4788. SendAlert(ssl, alert_fatal, illegal_parameter);
  4789. WOLFSSL_ERROR_VERBOSE(NO_CERT_ERROR);
  4790. return NO_CERT_ERROR;
  4791. #endif
  4792. }
  4793. /* This message is always encrypted so add encryption padding. */
  4794. *inOutIdx += ssl->keys.padSz;
  4795. WOLFSSL_LEAVE("DoTls13CertificateRequest", ret);
  4796. WOLFSSL_END(WC_FUNC_CERTIFICATE_REQUEST_DO);
  4797. return ret;
  4798. }
  4799. #endif /* !NO_CERTS */
  4800. #endif /* !NO_WOLFSSL_CLIENT */
  4801. #ifndef NO_WOLFSSL_SERVER
  4802. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  4803. /* Refine list of supported cipher suites to those common to server and client.
  4804. *
  4805. * ssl SSL/TLS object.
  4806. * peerSuites The peer's advertised list of supported cipher suites.
  4807. */
  4808. static void RefineSuites(WOLFSSL* ssl, Suites* peerSuites)
  4809. {
  4810. byte suites[WOLFSSL_MAX_SUITE_SZ];
  4811. word16 suiteSz = 0;
  4812. word16 i;
  4813. word16 j;
  4814. if (AllocateSuites(ssl) != 0)
  4815. return;
  4816. XMEMSET(suites, 0, WOLFSSL_MAX_SUITE_SZ);
  4817. if (!ssl->options.useClientOrder) {
  4818. /* Server order refining. */
  4819. for (i = 0; i < ssl->suites->suiteSz; i += 2) {
  4820. for (j = 0; j < peerSuites->suiteSz; j += 2) {
  4821. if ((ssl->suites->suites[i+0] == peerSuites->suites[j+0]) &&
  4822. (ssl->suites->suites[i+1] == peerSuites->suites[j+1])) {
  4823. suites[suiteSz++] = peerSuites->suites[j+0];
  4824. suites[suiteSz++] = peerSuites->suites[j+1];
  4825. break;
  4826. }
  4827. }
  4828. if (suiteSz == WOLFSSL_MAX_SUITE_SZ)
  4829. break;
  4830. }
  4831. }
  4832. else {
  4833. /* Client order refining. */
  4834. for (j = 0; j < peerSuites->suiteSz; j += 2) {
  4835. for (i = 0; i < ssl->suites->suiteSz; i += 2) {
  4836. if ((ssl->suites->suites[i+0] == peerSuites->suites[j+0]) &&
  4837. (ssl->suites->suites[i+1] == peerSuites->suites[j+1])) {
  4838. suites[suiteSz++] = peerSuites->suites[j+0];
  4839. suites[suiteSz++] = peerSuites->suites[j+1];
  4840. break;
  4841. }
  4842. }
  4843. if (suiteSz == WOLFSSL_MAX_SUITE_SZ)
  4844. break;
  4845. }
  4846. }
  4847. ssl->suites->suiteSz = suiteSz;
  4848. XMEMCPY(ssl->suites->suites, &suites, sizeof(suites));
  4849. #ifdef WOLFSSL_DEBUG_TLS
  4850. {
  4851. int ii;
  4852. WOLFSSL_MSG("Refined Ciphers:");
  4853. for (ii = 0 ; ii < ssl->suites->suiteSz; ii += 2) {
  4854. WOLFSSL_MSG(GetCipherNameInternal(ssl->suites->suites[ii+0],
  4855. ssl->suites->suites[ii+1]));
  4856. }
  4857. }
  4858. #endif
  4859. }
  4860. #ifndef NO_PSK
  4861. /* Attempt to find the PSK (not session ticket) that matches.
  4862. *
  4863. * @param [in, out] ssl The SSL/TLS object.
  4864. * @param [in] psk A pre-shared key from the extension.
  4865. * @param [out] suite Cipher suite to use with PSK.
  4866. * @param [out] err Error code.
  4867. * PSK_KEY_ERROR when key is too big or ticket age is
  4868. * invalid,
  4869. * UNSUPPORTED_SUITE on invalid suite.
  4870. * Other error when attempting to derive early secret.
  4871. * @return 1 when a match found - but check error code.
  4872. * @return 0 when no match found.
  4873. */
  4874. static int FindPsk(WOLFSSL* ssl, PreSharedKey* psk, const byte* suite, int* err)
  4875. {
  4876. int ret = 0;
  4877. int found = 0;
  4878. const char* cipherName = NULL;
  4879. byte cipherSuite0 = TLS13_BYTE;
  4880. byte cipherSuite = WOLFSSL_DEF_PSK_CIPHER;
  4881. Arrays* sa = ssl->arrays;
  4882. if (ssl->options.server_psk_tls13_cb != NULL) {
  4883. sa->psk_keySz = ssl->options.server_psk_tls13_cb(ssl,
  4884. sa->client_identity, sa->psk_key, MAX_PSK_KEY_LEN, &cipherName);
  4885. if (sa->psk_keySz != 0) {
  4886. int cipherSuiteFlags = WOLFSSL_CIPHER_SUITE_FLAG_NONE;
  4887. found = (GetCipherSuiteFromName(cipherName, &cipherSuite0,
  4888. &cipherSuite, &cipherSuiteFlags) == 0);
  4889. (void)cipherSuiteFlags;
  4890. }
  4891. }
  4892. if (!found && (ssl->options.server_psk_cb != NULL)) {
  4893. sa->psk_keySz = ssl->options.server_psk_cb(ssl,
  4894. sa->client_identity, sa->psk_key,
  4895. MAX_PSK_KEY_LEN);
  4896. found = (sa->psk_keySz != 0);
  4897. }
  4898. if (found) {
  4899. if (sa->psk_keySz > MAX_PSK_KEY_LEN) {
  4900. ret = PSK_KEY_ERROR;
  4901. WOLFSSL_ERROR_VERBOSE(ret);
  4902. }
  4903. if (ret == 0) {
  4904. #ifndef WOLFSSL_PSK_ONE_ID
  4905. /* Check whether PSK ciphersuite is in SSL. */
  4906. found = (suite[0] == cipherSuite0) && (suite[1] == cipherSuite);
  4907. #else
  4908. /* Check whether PSK ciphersuite is in SSL. */
  4909. {
  4910. byte s[2] = {
  4911. cipherSuite0,
  4912. cipherSuite,
  4913. };
  4914. found = FindSuiteSSL(ssl, s);
  4915. }
  4916. #endif
  4917. }
  4918. if ((ret == 0) && found) {
  4919. /* Default to ciphersuite if cb doesn't specify. */
  4920. ssl->options.resuming = 0;
  4921. /* Don't send certificate request when using PSK. */
  4922. ssl->options.verifyPeer = 0;
  4923. /* PSK age is always zero. */
  4924. if (psk->ticketAge != ssl->session->ticketAdd) {
  4925. ret = PSK_KEY_ERROR;
  4926. WOLFSSL_ERROR_VERBOSE(ret);
  4927. }
  4928. }
  4929. if ((ret == 0) && found) {
  4930. /* Set PSK ciphersuite into SSL. */
  4931. ssl->options.cipherSuite0 = cipherSuite0;
  4932. ssl->options.cipherSuite = cipherSuite;
  4933. ret = SetCipherSpecs(ssl);
  4934. }
  4935. if ((ret == 0) && found) {
  4936. /* Derive the early secret using the PSK. */
  4937. ret = DeriveEarlySecret(ssl);
  4938. }
  4939. if ((ret == 0) && found) {
  4940. /* PSK negotiation has succeeded */
  4941. ssl->options.isPSK = 1;
  4942. /* SERVER: using PSK for peer authentication. */
  4943. ssl->options.peerAuthGood = 1;
  4944. }
  4945. }
  4946. *err = ret;
  4947. return found;
  4948. }
  4949. #endif
  4950. /* Handle any Pre-Shared Key (PSK) extension.
  4951. * Find a PSK that supports the cipher suite passed in.
  4952. *
  4953. * ssl SSL/TLS object.
  4954. * suite Cipher suite to find PSK for.
  4955. * usingPSK 1=Indicates handshake is using Pre-Shared Keys (2=Ephemeral)
  4956. * first Set to 1 if first in extension
  4957. * returns 0 on success and otherwise failure.
  4958. */
  4959. static int DoPreSharedKeys(WOLFSSL* ssl, const byte* input, word32 inputSz,
  4960. const byte* suite, int* usingPSK, int* first)
  4961. {
  4962. int ret = 0;
  4963. TLSX* ext;
  4964. PreSharedKey* current;
  4965. byte binderKey[WC_MAX_DIGEST_SIZE];
  4966. byte binder[WC_MAX_DIGEST_SIZE];
  4967. word32 binderLen;
  4968. WOLFSSL_ENTER("DoPreSharedKeys");
  4969. ext = TLSX_Find(ssl->extensions, TLSX_PRE_SHARED_KEY);
  4970. if (ext == NULL) {
  4971. WOLFSSL_MSG("No pre shared extension keys found");
  4972. return BAD_FUNC_ARG;
  4973. }
  4974. /* Look through all client's pre-shared keys for a match. */
  4975. current = (PreSharedKey*)ext->data;
  4976. while (current != NULL) {
  4977. #ifndef NO_PSK
  4978. if (current->identityLen > MAX_PSK_ID_LEN) {
  4979. return BUFFER_ERROR;
  4980. }
  4981. XMEMCPY(ssl->arrays->client_identity, current->identity,
  4982. current->identityLen);
  4983. ssl->arrays->client_identity[current->identityLen] = '\0';
  4984. #endif
  4985. #ifdef HAVE_SESSION_TICKET
  4986. /* Decode the identity. */
  4987. ret = DoClientTicket(ssl, current->identity, current->identityLen);
  4988. #ifdef WOLFSSL_ASYNC_CRYPT
  4989. if (ret == WC_PENDING_E)
  4990. return ret;
  4991. #endif
  4992. if (ret == WOLFSSL_TICKET_RET_OK) {
  4993. #ifdef WOLFSSL_32BIT_MILLI_TIME
  4994. word32 now;
  4995. sword64 diff;
  4996. now = TimeNowInMilliseconds();
  4997. if (now == 0)
  4998. return GETTIME_ERROR;
  4999. /* Difference between now and time ticket constructed
  5000. * (from decrypted ticket). */
  5001. diff = now;
  5002. diff -= ssl->session->ticketSeen;
  5003. if (diff > (sword64)ssl->timeout * 1000 ||
  5004. diff > (sword64)TLS13_MAX_TICKET_AGE * 1000) {
  5005. current = current->next;
  5006. continue;
  5007. }
  5008. #else
  5009. sword64 diff;
  5010. diff = TimeNowInMilliseconds();
  5011. if (diff == 0)
  5012. return GETTIME_ERROR;
  5013. /* Difference between now and time ticket constructed
  5014. * (from decrypted ticket). */
  5015. diff -= ssl->session->ticketSeen;
  5016. if (diff > (sword64)ssl->timeout * 1000 ||
  5017. diff > (sword64)TLS13_MAX_TICKET_AGE * 1000) {
  5018. current = current->next;
  5019. continue;
  5020. }
  5021. #endif
  5022. /* Subtract client's ticket age and unobfuscate. */
  5023. diff -= current->ticketAge;
  5024. diff += ssl->session->ticketAdd;
  5025. /* Check session and ticket age timeout.
  5026. * Allow +/- 1000 milliseconds on ticket age.
  5027. */
  5028. if (diff < -1000 || diff - MAX_TICKET_AGE_DIFF * 1000 > 1000) {
  5029. current = current->next;
  5030. continue;
  5031. }
  5032. #ifndef WOLFSSL_PSK_ONE_ID
  5033. /* Check whether resumption is possible based on suites in SSL and
  5034. * ciphersuite in ticket.
  5035. */
  5036. if ((suite[0] != ssl->session->cipherSuite0) ||
  5037. (suite[1] != ssl->session->cipherSuite)) {
  5038. current = current->next;
  5039. continue;
  5040. }
  5041. #else
  5042. {
  5043. byte s[2] = {
  5044. ssl->session->cipherSuite0,
  5045. ssl->session->cipherSuite,
  5046. };
  5047. if (!FindSuiteSSL(ssl, s)) {
  5048. current = current->next;
  5049. continue;
  5050. }
  5051. }
  5052. #endif
  5053. /* SERVER: using secret in session ticket for peer auth. */
  5054. ssl->options.peerAuthGood = 1;
  5055. #ifdef WOLFSSL_EARLY_DATA
  5056. ssl->options.maxEarlyDataSz = ssl->session->maxEarlyDataSz;
  5057. #endif
  5058. /* Use the same cipher suite as before and set up for use. */
  5059. ssl->options.cipherSuite0 = ssl->session->cipherSuite0;
  5060. ssl->options.cipherSuite = ssl->session->cipherSuite;
  5061. ret = SetCipherSpecs(ssl);
  5062. if (ret != 0)
  5063. return ret;
  5064. /* Resumption PSK is resumption master secret. */
  5065. ssl->arrays->psk_keySz = ssl->specs.hash_size;
  5066. if ((ret = DeriveResumptionPSK(ssl, ssl->session->ticketNonce.data,
  5067. ssl->session->ticketNonce.len, ssl->arrays->psk_key)) != 0) {
  5068. return ret;
  5069. }
  5070. /* Derive the early secret using the PSK. */
  5071. ret = DeriveEarlySecret(ssl);
  5072. if (ret != 0)
  5073. return ret;
  5074. /* Hash data up to binders for deriving binders in PSK extension. */
  5075. ret = HashInput(ssl, input, inputSz);
  5076. if (ret < 0)
  5077. return ret;
  5078. /* Derive the binder key to use with HMAC. */
  5079. ret = DeriveBinderKeyResume(ssl, binderKey);
  5080. if (ret != 0)
  5081. return ret;
  5082. }
  5083. else
  5084. #endif
  5085. #ifndef NO_PSK
  5086. if (FindPsk(ssl, current, suite, &ret)) {
  5087. if (ret != 0)
  5088. return ret;
  5089. ret = HashInput(ssl, input, inputSz);
  5090. if (ret < 0)
  5091. return ret;
  5092. /* Derive the binder key to use with HMAC. */
  5093. ret = DeriveBinderKey(ssl, binderKey);
  5094. if (ret != 0)
  5095. return ret;
  5096. }
  5097. else
  5098. #endif
  5099. {
  5100. current = current->next;
  5101. continue;
  5102. }
  5103. ssl->options.sendVerify = 0;
  5104. /* Derive the Finished message secret. */
  5105. ret = DeriveFinishedSecret(ssl, binderKey,
  5106. ssl->keys.client_write_MAC_secret,
  5107. 0 /* neither end */);
  5108. if (ret != 0)
  5109. return ret;
  5110. /* Derive the binder and compare with the one in the extension. */
  5111. ret = BuildTls13HandshakeHmac(ssl,
  5112. ssl->keys.client_write_MAC_secret, binder, &binderLen);
  5113. if (ret != 0)
  5114. return ret;
  5115. if (binderLen != current->binderLen ||
  5116. XMEMCMP(binder, current->binder, binderLen) != 0) {
  5117. WOLFSSL_ERROR_VERBOSE(BAD_BINDER);
  5118. return BAD_BINDER;
  5119. }
  5120. /* This PSK works, no need to try any more. */
  5121. current->chosen = 1;
  5122. ext->resp = 1;
  5123. break;
  5124. }
  5125. if (current == NULL) {
  5126. #ifdef WOLFSSL_PSK_ID_PROTECTION
  5127. #ifndef NO_CERTS
  5128. if (ssl->buffers.certChainCnt != 0)
  5129. return 0;
  5130. #endif
  5131. WOLFSSL_ERROR_VERBOSE(BAD_BINDER);
  5132. return BAD_BINDER;
  5133. #else
  5134. return 0;
  5135. #endif
  5136. }
  5137. *first = (current == ext->data);
  5138. *usingPSK = 1;
  5139. WOLFSSL_LEAVE("DoPreSharedKeys", ret);
  5140. return ret;
  5141. }
  5142. /* Handle any Pre-Shared Key (PSK) extension.
  5143. * Must do this in ClientHello as it requires a hash of the truncated message.
  5144. * Don't know size of binders until Pre-Shared Key extension has been parsed.
  5145. *
  5146. * ssl SSL/TLS object.
  5147. * input ClientHello message.
  5148. * helloSz Size of the ClientHello message (including binders if present).
  5149. * clSuites Client's cipher suite list.
  5150. * usingPSK Indicates handshake is using Pre-Shared Keys.
  5151. */
  5152. static int CheckPreSharedKeys(WOLFSSL* ssl, const byte* input, word32 helloSz,
  5153. Suites* clSuites, int* usingPSK)
  5154. {
  5155. int ret;
  5156. TLSX* ext;
  5157. word16 bindersLen;
  5158. int first = 0;
  5159. #ifndef WOLFSSL_PSK_ONE_ID
  5160. int i;
  5161. const Suites* suites = WOLFSSL_SUITES(ssl);
  5162. #else
  5163. byte suite[2];
  5164. #endif
  5165. WOLFSSL_ENTER("CheckPreSharedKeys");
  5166. ext = TLSX_Find(ssl->extensions, TLSX_PRE_SHARED_KEY);
  5167. if (ext == NULL) {
  5168. #ifdef WOLFSSL_EARLY_DATA
  5169. ssl->earlyData = no_early_data;
  5170. #endif
  5171. if (usingPSK)
  5172. *usingPSK = 0;
  5173. /* Hash data up to binders for deriving binders in PSK extension. */
  5174. ret = HashInput(ssl, input, helloSz);
  5175. return ret;
  5176. }
  5177. /* Extensions pushed on stack/list and PSK must be last. */
  5178. if (ssl->extensions != ext) {
  5179. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  5180. return PSK_KEY_ERROR;
  5181. }
  5182. /* Assume we are going to resume with a pre-shared key. */
  5183. ssl->options.resuming = 1;
  5184. /* Find the pre-shared key extension and calculate hash of truncated
  5185. * ClientHello for binders.
  5186. */
  5187. ret = TLSX_PreSharedKey_GetSizeBinders((PreSharedKey*)ext->data,
  5188. client_hello, &bindersLen);
  5189. if (ret < 0)
  5190. return ret;
  5191. /* Refine list for PSK processing. */
  5192. RefineSuites(ssl, clSuites);
  5193. #ifndef WOLFSSL_PSK_ONE_ID
  5194. if (usingPSK == NULL)
  5195. return BAD_FUNC_ARG;
  5196. /* Server list has only common suites from refining in server or client
  5197. * order. */
  5198. for (i = 0; !(*usingPSK) && i < suites->suiteSz; i += 2) {
  5199. ret = DoPreSharedKeys(ssl, input, helloSz - bindersLen,
  5200. suites->suites + i, usingPSK, &first);
  5201. if (ret != 0) {
  5202. return ret;
  5203. }
  5204. }
  5205. #else
  5206. ret = DoPreSharedKeys(ssl, input, helloSz - bindersLen, suite, usingPSK,
  5207. &first);
  5208. if (ret != 0)
  5209. return ret;
  5210. #endif
  5211. if (*usingPSK) {
  5212. /* While verifying the selected PSK, we updated the
  5213. * handshake hash up to the binder bytes in the PSK extensions.
  5214. * Continuing, we need the rest of the ClientHello hashed as well.
  5215. */
  5216. ret = HashRaw(ssl, input + helloSz - bindersLen, bindersLen);
  5217. }
  5218. else {
  5219. /* No suitable PSK found, Hash the complete ClientHello,
  5220. * as caller expect it after we return */
  5221. ret = HashInput(ssl, input, helloSz);
  5222. }
  5223. if (ret != 0)
  5224. return ret;
  5225. if (*usingPSK != 0) {
  5226. word16 modes;
  5227. #ifdef WOLFSSL_EARLY_DATA
  5228. TLSX* extEarlyData;
  5229. extEarlyData = TLSX_Find(ssl->extensions, TLSX_EARLY_DATA);
  5230. if (extEarlyData != NULL) {
  5231. /* Check if accepting early data and first PSK. */
  5232. if (ssl->earlyData != no_early_data && first) {
  5233. extEarlyData->resp = 1;
  5234. /* Derive early data decryption key. */
  5235. ret = DeriveTls13Keys(ssl, early_data_key, DECRYPT_SIDE_ONLY,
  5236. 1);
  5237. if (ret != 0)
  5238. return ret;
  5239. if ((ret = SetKeysSide(ssl, DECRYPT_SIDE_ONLY)) != 0)
  5240. return ret;
  5241. #ifdef WOLFSSL_DTLS13
  5242. if (ssl->options.dtls) {
  5243. ret = Dtls13NewEpoch(ssl,
  5244. w64From32(0x0, DTLS13_EPOCH_EARLYDATA),
  5245. DECRYPT_SIDE_ONLY);
  5246. if (ret != 0)
  5247. return ret;
  5248. }
  5249. #endif /* WOLFSSL_DTLS13 */
  5250. ssl->earlyData = process_early_data;
  5251. }
  5252. else
  5253. extEarlyData->resp = 0;
  5254. }
  5255. #endif
  5256. /* Get the PSK key exchange modes the client wants to negotiate. */
  5257. ext = TLSX_Find(ssl->extensions, TLSX_PSK_KEY_EXCHANGE_MODES);
  5258. if (ext == NULL) {
  5259. WOLFSSL_ERROR_VERBOSE(MISSING_HANDSHAKE_DATA);
  5260. return MISSING_HANDSHAKE_DATA;
  5261. }
  5262. modes = ext->val;
  5263. #ifdef HAVE_SUPPORTED_CURVES
  5264. ext = TLSX_Find(ssl->extensions, TLSX_KEY_SHARE);
  5265. /* Use (EC)DHE for forward-security if possible. */
  5266. if ((modes & (1 << PSK_DHE_KE)) != 0 && !ssl->options.noPskDheKe &&
  5267. ext != NULL) {
  5268. /* Only use named group used in last session. */
  5269. ssl->namedGroup = ssl->session->namedGroup;
  5270. *usingPSK = 2; /* generate new ephemeral key */
  5271. }
  5272. else
  5273. #endif
  5274. {
  5275. if ((modes & (1 << PSK_KE)) == 0) {
  5276. WOLFSSL_MSG("psk_ke mode does not allow key share");
  5277. WOLFSSL_ERROR_VERBOSE(PSK_KEY_ERROR);
  5278. return PSK_KEY_ERROR;
  5279. }
  5280. ssl->options.noPskDheKe = 1;
  5281. ssl->arrays->preMasterSz = 0;
  5282. *usingPSK = 1;
  5283. }
  5284. }
  5285. #ifdef WOLFSSL_PSK_ID_PROTECTION
  5286. else {
  5287. #ifndef NO_CERTS
  5288. if (ssl->buffers.certChainCnt != 0)
  5289. return 0;
  5290. #endif
  5291. WOLFSSL_ERROR_VERBOSE(BAD_BINDER);
  5292. return BAD_BINDER;
  5293. }
  5294. #endif
  5295. WOLFSSL_LEAVE("CheckPreSharedKeys", ret);
  5296. return 0;
  5297. }
  5298. #endif /* HAVE_SESSION_TICKET || !NO_PSK */
  5299. #if defined(WOLFSSL_SEND_HRR_COOKIE)
  5300. /* Check that the Cookie data's integrity.
  5301. *
  5302. * ssl SSL/TLS object.
  5303. * cookie The cookie data - hash and MAC.
  5304. * cookieSz The length of the cookie data in bytes.
  5305. * returns Length of the hash on success, otherwise failure.
  5306. */
  5307. static int CheckCookie(WOLFSSL* ssl, byte* cookie, byte cookieSz)
  5308. {
  5309. int ret;
  5310. byte mac[WC_MAX_DIGEST_SIZE] = {0};
  5311. Hmac cookieHmac;
  5312. byte cookieType = 0;
  5313. byte macSz = 0;
  5314. #if !defined(NO_SHA) && defined(NO_SHA256)
  5315. cookieType = SHA;
  5316. macSz = WC_SHA_DIGEST_SIZE;
  5317. #endif /* NO_SHA */
  5318. #ifndef NO_SHA256
  5319. cookieType = WC_SHA256;
  5320. macSz = WC_SHA256_DIGEST_SIZE;
  5321. #endif /* NO_SHA256 */
  5322. if (cookieSz < ssl->specs.hash_size + macSz)
  5323. return HRR_COOKIE_ERROR;
  5324. cookieSz -= macSz;
  5325. ret = wc_HmacInit(&cookieHmac, ssl->heap, INVALID_DEVID);
  5326. if (ret == 0) {
  5327. ret = wc_HmacSetKey(&cookieHmac, cookieType,
  5328. ssl->buffers.tls13CookieSecret.buffer,
  5329. ssl->buffers.tls13CookieSecret.length);
  5330. }
  5331. if (ret == 0)
  5332. ret = wc_HmacUpdate(&cookieHmac, cookie, cookieSz);
  5333. #ifdef WOLFSSL_DTLS13
  5334. /* Tie cookie to peer address */
  5335. if (ret == 0) {
  5336. if (ssl->options.dtls && ssl->buffers.dtlsCtx.peer.sz > 0) {
  5337. ret = wc_HmacUpdate(&cookieHmac,
  5338. (byte*)ssl->buffers.dtlsCtx.peer.sa,
  5339. ssl->buffers.dtlsCtx.peer.sz);
  5340. }
  5341. }
  5342. #endif
  5343. if (ret == 0)
  5344. ret = wc_HmacFinal(&cookieHmac, mac);
  5345. wc_HmacFree(&cookieHmac);
  5346. if (ret != 0)
  5347. return ret;
  5348. if (ConstantCompare(cookie + cookieSz, mac, macSz) != 0) {
  5349. WOLFSSL_ERROR_VERBOSE(HRR_COOKIE_ERROR);
  5350. return HRR_COOKIE_ERROR;
  5351. }
  5352. return cookieSz;
  5353. }
  5354. /* Length of the KeyShare Extension */
  5355. #define HRR_KEY_SHARE_SZ (OPAQUE16_LEN + OPAQUE16_LEN + OPAQUE16_LEN)
  5356. /* Length of the Supported Versions Extension */
  5357. #define HRR_VERSIONS_SZ (OPAQUE16_LEN + OPAQUE16_LEN + OPAQUE16_LEN)
  5358. /* Length of the Cookie Extension excluding cookie data */
  5359. #define HRR_COOKIE_HDR_SZ (OPAQUE16_LEN + OPAQUE16_LEN + OPAQUE16_LEN)
  5360. /* PV | Random | Session Id | CipherSuite | Compression | Ext Len */
  5361. #define HRR_BODY_SZ (VERSION_SZ + RAN_LEN + ENUM_LEN + ID_LEN + \
  5362. SUITE_LEN + COMP_LEN + OPAQUE16_LEN)
  5363. /* HH | PV | CipherSuite | Ext Len | Key Share | Supported Version | Cookie */
  5364. #define MAX_HRR_SZ (HRR_MAX_HS_HEADER_SZ + \
  5365. HRR_BODY_SZ + \
  5366. HRR_KEY_SHARE_SZ + \
  5367. HRR_VERSIONS_SZ + \
  5368. HRR_COOKIE_HDR_SZ)
  5369. /* Restart the handshake hash from the cookie value.
  5370. *
  5371. * ssl SSL/TLS object.
  5372. * cookie Cookie data from client.
  5373. * returns 0 on success, otherwise failure.
  5374. */
  5375. static int RestartHandshakeHashWithCookie(WOLFSSL* ssl, Cookie* cookie)
  5376. {
  5377. byte header[HANDSHAKE_HEADER_SZ] = {0};
  5378. byte hrr[MAX_HRR_SZ] = {0};
  5379. int hrrIdx;
  5380. word32 idx;
  5381. byte hashSz;
  5382. byte* cookieData;
  5383. byte cookieDataSz;
  5384. word16 length;
  5385. int keyShareExt = 0;
  5386. int ret;
  5387. cookieDataSz = ret = CheckCookie(ssl, &cookie->data, cookie->len);
  5388. if (ret < 0)
  5389. return ret;
  5390. hashSz = cookie->data;
  5391. cookieData = &cookie->data;
  5392. idx = OPAQUE8_LEN;
  5393. /* Restart handshake hash with synthetic message hash. */
  5394. AddTls13HandShakeHeader(header, hashSz, 0, 0, message_hash, ssl);
  5395. if ((ret = InitHandshakeHashes(ssl)) != 0)
  5396. return ret;
  5397. if ((ret = HashRaw(ssl, header, sizeof(header))) != 0)
  5398. return ret;
  5399. #ifdef WOLFSSL_DEBUG_TLS
  5400. WOLFSSL_MSG("Restart Hash from Cookie");
  5401. WOLFSSL_BUFFER(cookieData + idx, hashSz);
  5402. #endif
  5403. if ((ret = HashRaw(ssl, cookieData + idx, hashSz)) != 0)
  5404. return ret;
  5405. /* Reconstruct the HelloRetryMessage for handshake hash. */
  5406. length = HRR_BODY_SZ - ID_LEN + ssl->session->sessionIDSz +
  5407. HRR_COOKIE_HDR_SZ + cookie->len;
  5408. length += HRR_VERSIONS_SZ;
  5409. /* HashSz (1 byte) + Hash (HashSz bytes) + CipherSuite (2 bytes) */
  5410. if (cookieDataSz > OPAQUE8_LEN + hashSz + OPAQUE16_LEN) {
  5411. keyShareExt = 1;
  5412. length += HRR_KEY_SHARE_SZ;
  5413. }
  5414. AddTls13HandShakeHeader(hrr, length, 0, 0, server_hello, ssl);
  5415. idx += hashSz;
  5416. hrrIdx = HANDSHAKE_HEADER_SZ;
  5417. #ifdef WOLFSSL_DTLS13
  5418. if (ssl->options.dtls)
  5419. hrrIdx += DTLS_HANDSHAKE_EXTRA;
  5420. #endif /* WOLFSSL_DTLS13 */
  5421. /* The negotiated protocol version. */
  5422. hrr[hrrIdx++] = ssl->version.major;
  5423. hrr[hrrIdx++] = ssl->options.dtls ? DTLSv1_2_MINOR : TLSv1_2_MINOR;
  5424. /* HelloRetryRequest message has fixed value for random. */
  5425. XMEMCPY(hrr + hrrIdx, helloRetryRequestRandom, RAN_LEN);
  5426. hrrIdx += RAN_LEN;
  5427. hrr[hrrIdx++] = ssl->session->sessionIDSz;
  5428. if (ssl->session->sessionIDSz > 0) {
  5429. XMEMCPY(hrr + hrrIdx, ssl->session->sessionID, ssl->session->sessionIDSz);
  5430. hrrIdx += ssl->session->sessionIDSz;
  5431. }
  5432. /* Cipher Suite */
  5433. hrr[hrrIdx++] = cookieData[idx++];
  5434. hrr[hrrIdx++] = cookieData[idx++];
  5435. /* Compression not supported in TLS v1.3. */
  5436. hrr[hrrIdx++] = 0;
  5437. /* Extensions' length */
  5438. length -= HRR_BODY_SZ - ID_LEN + ssl->session->sessionIDSz;
  5439. c16toa(length, hrr + hrrIdx);
  5440. hrrIdx += 2;
  5441. /* Optional KeyShare Extension */
  5442. if (keyShareExt) {
  5443. c16toa(TLSX_KEY_SHARE, hrr + hrrIdx);
  5444. hrrIdx += 2;
  5445. c16toa(OPAQUE16_LEN, hrr + hrrIdx);
  5446. hrrIdx += 2;
  5447. hrr[hrrIdx++] = cookieData[idx++];
  5448. hrr[hrrIdx++] = cookieData[idx++];
  5449. }
  5450. c16toa(TLSX_SUPPORTED_VERSIONS, hrr + hrrIdx);
  5451. hrrIdx += 2;
  5452. c16toa(OPAQUE16_LEN, hrr + hrrIdx);
  5453. hrrIdx += 2;
  5454. #ifdef WOLFSSL_TLS13_DRAFT
  5455. hrr[hrrIdx++] = TLS_DRAFT_MAJOR;
  5456. hrr[hrrIdx++] = TLS_DRAFT_MINOR;
  5457. #else
  5458. hrr[hrrIdx++] = ssl->version.major;
  5459. hrr[hrrIdx++] = ssl->version.minor;
  5460. #endif
  5461. /* Mandatory Cookie Extension */
  5462. c16toa(TLSX_COOKIE, hrr + hrrIdx);
  5463. hrrIdx += 2;
  5464. c16toa(cookie->len + OPAQUE16_LEN, hrr + hrrIdx);
  5465. hrrIdx += 2;
  5466. c16toa(cookie->len, hrr + hrrIdx);
  5467. hrrIdx += 2;
  5468. #ifdef WOLFSSL_DEBUG_TLS
  5469. WOLFSSL_MSG("Reconstructed HelloRetryRequest");
  5470. WOLFSSL_BUFFER(hrr, hrrIdx);
  5471. WOLFSSL_MSG("Cookie");
  5472. WOLFSSL_BUFFER(cookieData, cookie->len);
  5473. #endif
  5474. #ifdef WOLFSSL_DTLS13
  5475. if (ssl->options.dtls) {
  5476. ret = Dtls13HashHandshake(ssl, hrr, hrrIdx);
  5477. }
  5478. else
  5479. #endif /* WOLFSSL_DTLS13 */
  5480. {
  5481. ret = HashRaw(ssl, hrr, hrrIdx);
  5482. }
  5483. if (ret != 0)
  5484. return ret;
  5485. return HashRaw(ssl, cookieData, cookie->len);
  5486. }
  5487. #endif
  5488. /* Do SupportedVersion extension for TLS v1.3+ otherwise it is not.
  5489. *
  5490. * ssl The SSL/TLS object.
  5491. * input The message buffer.
  5492. * i The index into the message buffer of ClientHello.
  5493. * helloSz The length of the current handshake message.
  5494. * returns 0 on success and otherwise failure.
  5495. */
  5496. static int DoTls13SupportedVersions(WOLFSSL* ssl, const byte* input, word32 i,
  5497. word32 helloSz, int* wantDowngrade)
  5498. {
  5499. int ret;
  5500. byte b;
  5501. word16 suiteSz;
  5502. word16 totalExtSz;
  5503. int foundVersion = 0;
  5504. /* Client random */
  5505. i += RAN_LEN;
  5506. /* Session id - not used in TLS v1.3 */
  5507. b = input[i++];
  5508. if (i + b > helloSz) {
  5509. return BUFFER_ERROR;
  5510. }
  5511. i += b;
  5512. #ifdef WOLFSSL_DTLS13
  5513. if (ssl->options.dtls) {
  5514. /* legacy_cookie - not used in DTLS v1.3 */
  5515. b = input[i++];
  5516. if (i + b > helloSz) {
  5517. return BUFFER_ERROR;
  5518. }
  5519. i += b;
  5520. }
  5521. #endif /* WOLFSSL_DTLS13 */
  5522. /* Cipher suites */
  5523. if (i + OPAQUE16_LEN > helloSz)
  5524. return BUFFER_ERROR;
  5525. ato16(input + i, &suiteSz);
  5526. i += OPAQUE16_LEN;
  5527. if (i + suiteSz + 1 > helloSz)
  5528. return BUFFER_ERROR;
  5529. i += suiteSz;
  5530. /* Compression */
  5531. b = input[i++];
  5532. if (i + b > helloSz)
  5533. return BUFFER_ERROR;
  5534. i += b;
  5535. /* TLS 1.3 must have extensions */
  5536. if (i < helloSz) {
  5537. if (i + OPAQUE16_LEN > helloSz)
  5538. return BUFFER_ERROR;
  5539. ato16(&input[i], &totalExtSz);
  5540. i += OPAQUE16_LEN;
  5541. if (totalExtSz != helloSz - i)
  5542. return BUFFER_ERROR;
  5543. /* Need to negotiate version first. */
  5544. if ((ret = TLSX_ParseVersion(ssl, input + i, totalExtSz, client_hello,
  5545. &foundVersion))) {
  5546. return ret;
  5547. }
  5548. }
  5549. *wantDowngrade = !foundVersion || !IsAtLeastTLSv1_3(ssl->version);
  5550. return 0;
  5551. }
  5552. /* Handle a ClientHello handshake message.
  5553. * If the protocol version in the message is not TLS v1.3 or higher, use
  5554. * DoClientHello()
  5555. * Only a server will receive this message.
  5556. *
  5557. * ssl The SSL/TLS object.
  5558. * input The message buffer.
  5559. * inOutIdx On entry, the index into the message buffer of ClientHello.
  5560. * On exit, the index of byte after the ClientHello message and
  5561. * padding.
  5562. * helloSz The length of the current handshake message.
  5563. * returns 0 on success and otherwise failure.
  5564. */
  5565. typedef struct Dch13Args {
  5566. ProtocolVersion pv;
  5567. Suites* clSuites;
  5568. word32 idx;
  5569. word32 begin;
  5570. int usingPSK;
  5571. } Dch13Args;
  5572. static void FreeDch13Args(WOLFSSL* ssl, void* pArgs)
  5573. {
  5574. Dch13Args* args = (Dch13Args*)pArgs;
  5575. (void)ssl;
  5576. if (args && args->clSuites) {
  5577. XFREE(args->clSuites, ssl->heap, DYNAMIC_TYPE_SUITES);
  5578. args->clSuites = NULL;
  5579. }
  5580. }
  5581. int DoTls13ClientHello(WOLFSSL* ssl, const byte* input, word32* inOutIdx,
  5582. word32 helloSz)
  5583. {
  5584. int ret;
  5585. #ifdef WOLFSSL_ASYNC_CRYPT
  5586. Dch13Args* args = NULL;
  5587. WOLFSSL_ASSERT_SIZEOF_GE(ssl->async->args, *args);
  5588. #else
  5589. Dch13Args args[1];
  5590. #endif
  5591. #if defined(HAVE_ECH)
  5592. TLSX* echX = NULL;
  5593. #endif
  5594. WOLFSSL_START(WC_FUNC_CLIENT_HELLO_DO);
  5595. WOLFSSL_ENTER("DoTls13ClientHello");
  5596. #ifdef WOLFSSL_ASYNC_CRYPT
  5597. if (ssl->async == NULL) {
  5598. ssl->async = (struct WOLFSSL_ASYNC*)
  5599. XMALLOC(sizeof(struct WOLFSSL_ASYNC), ssl->heap,
  5600. DYNAMIC_TYPE_ASYNC);
  5601. if (ssl->async == NULL)
  5602. ERROR_OUT(MEMORY_E, exit_dch);
  5603. }
  5604. args = (Dch13Args*)ssl->async->args;
  5605. ret = wolfSSL_AsyncPop(ssl, &ssl->options.asyncState);
  5606. if (ret != WC_NOT_PENDING_E) {
  5607. /* Check for error */
  5608. if (ret < 0) {
  5609. goto exit_dch;
  5610. }
  5611. }
  5612. else
  5613. #endif
  5614. {
  5615. /* Reset state */
  5616. ret = VERSION_ERROR;
  5617. ssl->options.asyncState = TLS_ASYNC_BEGIN;
  5618. XMEMSET(args, 0, sizeof(Dch13Args));
  5619. #ifdef WOLFSSL_ASYNC_CRYPT
  5620. ssl->async->freeArgs = FreeDch13Args;
  5621. #endif
  5622. }
  5623. switch (ssl->options.asyncState) {
  5624. case TLS_ASYNC_BEGIN:
  5625. {
  5626. byte b;
  5627. byte sessIdSz;
  5628. int wantDowngrade = 0;
  5629. word16 totalExtSz = 0;
  5630. #ifdef WOLFSSL_CALLBACKS
  5631. if (ssl->hsInfoOn) AddPacketName(ssl, "ClientHello");
  5632. if (ssl->toInfoOn) AddLateName("ClientHello", &ssl->timeoutInfo);
  5633. #endif
  5634. args->idx = *inOutIdx;
  5635. args->begin = args->idx;
  5636. /* protocol version, random and session id length check */
  5637. if (OPAQUE16_LEN + RAN_LEN + OPAQUE8_LEN > helloSz) {
  5638. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5639. }
  5640. /* Protocol version */
  5641. XMEMCPY(&args->pv, input + args->idx, OPAQUE16_LEN);
  5642. ssl->chVersion = args->pv; /* store */
  5643. args->idx += OPAQUE16_LEN;
  5644. /* this check pass for DTLS Major (0xff) */
  5645. if (args->pv.major < SSLv3_MAJOR) {
  5646. WOLFSSL_MSG("Legacy version field contains unsupported value");
  5647. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  5648. ERROR_OUT(INVALID_PARAMETER, exit_dch);
  5649. }
  5650. #ifdef WOLFSSL_DTLS13
  5651. if (ssl->options.dtls &&
  5652. args->pv.major == DTLS_MAJOR && args->pv.minor > DTLSv1_2_MINOR) {
  5653. wantDowngrade = 1;
  5654. ssl->version.minor = args->pv.minor;
  5655. }
  5656. #endif /* WOLFSSL_DTLS13 */
  5657. if (!ssl->options.dtls) {
  5658. /* Legacy protocol version cannot negotiate TLS 1.3 or higher. */
  5659. if (args->pv.major > SSLv3_MAJOR || (args->pv.major == SSLv3_MAJOR &&
  5660. args->pv.minor >= TLSv1_3_MINOR)) {
  5661. args->pv.major = SSLv3_MAJOR;
  5662. args->pv.minor = TLSv1_2_MINOR;
  5663. wantDowngrade = 1;
  5664. ssl->version.minor = args->pv.minor;
  5665. }
  5666. /* Legacy version must be [ SSLv3_MAJOR, TLSv1_2_MINOR ] for TLS v1.3 */
  5667. else if (args->pv.major == SSLv3_MAJOR &&
  5668. args->pv.minor < TLSv1_2_MINOR) {
  5669. wantDowngrade = 1;
  5670. ssl->version.minor = args->pv.minor;
  5671. }
  5672. }
  5673. if (!wantDowngrade) {
  5674. ret = DoTls13SupportedVersions(ssl, input + args->begin,
  5675. args->idx - args->begin, helloSz, &wantDowngrade);
  5676. if (ret < 0)
  5677. goto exit_dch;
  5678. }
  5679. if (wantDowngrade) {
  5680. #ifndef WOLFSSL_NO_TLS12
  5681. byte realMinor;
  5682. if (!ssl->options.downgrade) {
  5683. WOLFSSL_MSG("Client trying to connect with lesser version than "
  5684. "TLS v1.3");
  5685. ERROR_OUT(VERSION_ERROR, exit_dch);
  5686. }
  5687. if ((!ssl->options.dtls
  5688. && args->pv.minor < ssl->options.minDowngrade) ||
  5689. (ssl->options.dtls && args->pv.minor > ssl->options.minDowngrade)) {
  5690. WOLFSSL_MSG("\tversion below minimum allowed, fatal error");
  5691. ERROR_OUT(VERSION_ERROR, exit_dch);
  5692. }
  5693. realMinor = ssl->version.minor;
  5694. ssl->version.minor = args->pv.minor;
  5695. ret = HashInput(ssl, input + args->begin, helloSz);
  5696. ssl->version.minor = realMinor;
  5697. if (ret == 0) {
  5698. ret = DoClientHello(ssl, input, inOutIdx, helloSz);
  5699. }
  5700. goto exit_dch;
  5701. #else
  5702. WOLFSSL_MSG("Client trying to connect with lesser version than "
  5703. "TLS v1.3");
  5704. ERROR_OUT(VERSION_ERROR, exit_dch);
  5705. #endif
  5706. }
  5707. /* From here on we are a TLS 1.3 ClientHello. */
  5708. /* Client random */
  5709. XMEMCPY(ssl->arrays->clientRandom, input + args->idx, RAN_LEN);
  5710. args->idx += RAN_LEN;
  5711. #ifdef WOLFSSL_DEBUG_TLS
  5712. WOLFSSL_MSG("client random");
  5713. WOLFSSL_BUFFER(ssl->arrays->clientRandom, RAN_LEN);
  5714. #endif
  5715. sessIdSz = input[args->idx++];
  5716. if (sessIdSz != ID_LEN && sessIdSz != 0)
  5717. ERROR_OUT(INVALID_PARAMETER, exit_dch);
  5718. if (sessIdSz + args->idx > helloSz) {
  5719. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5720. }
  5721. ssl->session->sessionIDSz = sessIdSz;
  5722. if (sessIdSz == ID_LEN) {
  5723. XMEMCPY(ssl->session->sessionID, input + args->idx, sessIdSz);
  5724. args->idx += ID_LEN;
  5725. }
  5726. #ifdef WOLFSSL_DTLS13
  5727. /* legacy_cookie */
  5728. if (ssl->options.dtls)
  5729. args->idx += OPAQUE8_LEN;
  5730. #endif /* WOLFSSL_DTLS13 */
  5731. args->clSuites = (Suites*)XMALLOC(sizeof(Suites), ssl->heap,
  5732. DYNAMIC_TYPE_SUITES);
  5733. if (args->clSuites == NULL) {
  5734. ERROR_OUT(MEMORY_E, exit_dch);
  5735. }
  5736. /* Cipher suites */
  5737. if ((args->idx - args->begin) + OPAQUE16_LEN > helloSz)
  5738. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5739. ato16(&input[args->idx], &args->clSuites->suiteSz);
  5740. args->idx += OPAQUE16_LEN;
  5741. if ((args->clSuites->suiteSz % 2) != 0) {
  5742. ERROR_OUT(INVALID_PARAMETER, exit_dch);
  5743. }
  5744. /* suites and compression length check */
  5745. if ((args->idx - args->begin) + args->clSuites->suiteSz + OPAQUE8_LEN > helloSz)
  5746. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5747. if (args->clSuites->suiteSz > WOLFSSL_MAX_SUITE_SZ)
  5748. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5749. XMEMCPY(args->clSuites->suites, input + args->idx, args->clSuites->suiteSz);
  5750. args->idx += args->clSuites->suiteSz;
  5751. args->clSuites->hashSigAlgoSz = 0;
  5752. /* Compression */
  5753. b = input[args->idx++];
  5754. if ((args->idx - args->begin) + b > helloSz)
  5755. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5756. if (b != COMP_LEN) {
  5757. WOLFSSL_MSG("Must be one compression type in list");
  5758. ERROR_OUT(INVALID_PARAMETER, exit_dch);
  5759. }
  5760. b = input[args->idx++];
  5761. if (b != NO_COMPRESSION) {
  5762. WOLFSSL_MSG("Must be no compression type in list");
  5763. ERROR_OUT(INVALID_PARAMETER, exit_dch);
  5764. }
  5765. /* Extensions */
  5766. if ((args->idx - args->begin) == helloSz)
  5767. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5768. if ((args->idx - args->begin) + OPAQUE16_LEN > helloSz)
  5769. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5770. ato16(&input[args->idx], &totalExtSz);
  5771. args->idx += OPAQUE16_LEN;
  5772. if ((args->idx - args->begin) + totalExtSz > helloSz)
  5773. ERROR_OUT(BUFFER_ERROR, exit_dch);
  5774. /* Auto populate extensions supported unless user defined. */
  5775. if ((ret = TLSX_PopulateExtensions(ssl, 1)) != 0)
  5776. goto exit_dch;
  5777. #if defined(HAVE_ECH)
  5778. if (ssl->ctx->echConfigs != NULL) {
  5779. /* save the start of the buffer so we can use it when parsing ech */
  5780. echX = TLSX_Find(ssl->extensions, TLSX_ECH);
  5781. if (echX == NULL)
  5782. return -1;
  5783. ((WOLFSSL_ECH*)echX->data)->aad = input + HANDSHAKE_HEADER_SZ;
  5784. ((WOLFSSL_ECH*)echX->data)->aadLen = helloSz;
  5785. }
  5786. #endif
  5787. /* Parse extensions */
  5788. if ((ret = TLSX_Parse(ssl, input + args->idx, totalExtSz, client_hello,
  5789. args->clSuites))) {
  5790. goto exit_dch;
  5791. }
  5792. #if defined(HAVE_ECH)
  5793. /* jump to the end to clean things up */
  5794. if (echX != NULL && ((WOLFSSL_ECH*)echX->data)->state == ECH_WRITE_NONE)
  5795. goto exit_dch;
  5796. #endif
  5797. #ifdef HAVE_SNI
  5798. if ((ret = SNI_Callback(ssl)) != 0)
  5799. goto exit_dch;
  5800. ssl->options.side = WOLFSSL_SERVER_END;
  5801. #endif
  5802. args->idx += totalExtSz;
  5803. ssl->options.haveSessionId = 1;
  5804. ssl->options.sendVerify = SEND_CERT;
  5805. #if defined(WOLFSSL_SEND_HRR_COOKIE)
  5806. if (ssl->options.sendCookie &&
  5807. (ssl->options.serverState == SERVER_HELLO_RETRY_REQUEST_COMPLETE
  5808. #ifdef WOLFSSL_DTLS13
  5809. /* Always check for a valid cookie since we may have already
  5810. * sent a HRR but we reset the state. */
  5811. || ssl->options.dtls
  5812. #endif
  5813. )) {
  5814. TLSX* ext = TLSX_Find(ssl->extensions, TLSX_COOKIE);
  5815. if (ext != NULL) {
  5816. /* Ensure the cookie came from client and isn't the one in the
  5817. * response - HelloRetryRequest.
  5818. */
  5819. if (ext->resp == 0) {
  5820. ret = RestartHandshakeHashWithCookie(ssl, (Cookie*)ext->data);
  5821. #ifdef WOLFSSL_DTLS13
  5822. /* Send a new cookie request */
  5823. if (ret == HRR_COOKIE_ERROR && ssl->options.dtls)
  5824. ssl->options.serverState = NULL_STATE;
  5825. else
  5826. #endif
  5827. if (ret != 0)
  5828. goto exit_dch;
  5829. ssl->options.serverState = SERVER_HELLO_COMPLETE;
  5830. }
  5831. else {
  5832. #ifdef WOLFSSL_DTLS13
  5833. if (ssl->options.dtls)
  5834. ssl->options.serverState = NULL_STATE;
  5835. else
  5836. #endif
  5837. ERROR_OUT(HRR_COOKIE_ERROR, exit_dch);
  5838. }
  5839. }
  5840. else
  5841. #ifdef WOLFSSL_DTLS13
  5842. if (!ssl->options.dtls)
  5843. #endif
  5844. ERROR_OUT(HRR_COOKIE_ERROR, exit_dch);
  5845. }
  5846. #endif
  5847. #if (defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)) && \
  5848. defined(HAVE_TLS_EXTENSIONS)
  5849. ret = CheckPreSharedKeys(ssl, input + args->begin, helloSz, args->clSuites,
  5850. &args->usingPSK);
  5851. if (ret != 0)
  5852. goto exit_dch;
  5853. #else
  5854. if ((ret = HashInput(ssl, input + args->begin, helloSz)) != 0)
  5855. goto exit_dch;
  5856. #endif
  5857. #if (defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)) && \
  5858. defined(HAVE_TLS_EXTENSIONS)
  5859. if (!args->usingPSK)
  5860. #endif
  5861. {
  5862. /* Not using PSK so don't require no KE. */
  5863. ssl->options.noPskDheKe = 0;
  5864. #ifndef NO_CERTS
  5865. if (TLSX_Find(ssl->extensions, TLSX_KEY_SHARE) == NULL) {
  5866. WOLFSSL_MSG("Client did not send a KeyShare extension");
  5867. SendAlert(ssl, alert_fatal, missing_extension);
  5868. ERROR_OUT(INCOMPLETE_DATA, exit_dch);
  5869. }
  5870. if (TLSX_Find(ssl->extensions, TLSX_SIGNATURE_ALGORITHMS) == NULL) {
  5871. WOLFSSL_MSG("Client did not send a SignatureAlgorithms extension");
  5872. SendAlert(ssl, alert_fatal, missing_extension);
  5873. ERROR_OUT(INCOMPLETE_DATA, exit_dch);
  5874. }
  5875. #else
  5876. ERROR_OUT(INVALID_PARAMETER, exit_dch);
  5877. #endif
  5878. }
  5879. #ifdef HAVE_ALPN
  5880. /* With PSK and all other things validated, it's time to
  5881. * select the ALPN protocol, if so requested */
  5882. if ((ret = ALPN_Select(ssl)) != 0)
  5883. goto exit_dch;
  5884. #endif
  5885. /* Advance state and proceed */
  5886. ssl->options.asyncState = TLS_ASYNC_BUILD;
  5887. } /* case TLS_ASYNC_BEGIN */
  5888. FALL_THROUGH;
  5889. case TLS_ASYNC_BUILD:
  5890. case TLS_ASYNC_DO:
  5891. {
  5892. #ifndef NO_CERTS
  5893. if (!args->usingPSK) {
  5894. if ((ret = MatchSuite(ssl, args->clSuites)) < 0) {
  5895. #ifdef WOLFSSL_ASYNC_CRYPT
  5896. if (ret == WC_PENDING_E)
  5897. goto exit_dch;
  5898. #endif
  5899. WOLFSSL_MSG("Unsupported cipher suite, ClientHello");
  5900. SendAlert(ssl, alert_fatal, handshake_failure);
  5901. goto exit_dch;
  5902. }
  5903. }
  5904. else
  5905. #endif
  5906. #ifdef HAVE_SUPPORTED_CURVES
  5907. if (args->usingPSK == 2) {
  5908. /* Pick key share and Generate a new key if not present. */
  5909. int doHelloRetry = 0;
  5910. ret = TLSX_KeyShare_Establish(ssl, &doHelloRetry);
  5911. if (doHelloRetry) {
  5912. ssl->options.serverState = SERVER_HELLO_RETRY_REQUEST_COMPLETE;
  5913. if (ret != WC_PENDING_E)
  5914. ret = 0; /* for hello_retry return 0 */
  5915. }
  5916. if (ret != 0)
  5917. goto exit_dch;
  5918. }
  5919. #endif
  5920. /* Advance state and proceed */
  5921. ssl->options.asyncState = TLS_ASYNC_FINALIZE;
  5922. } /* case TLS_ASYNC_BUILD || TLS_ASYNC_DO */
  5923. FALL_THROUGH;
  5924. case TLS_ASYNC_FINALIZE:
  5925. {
  5926. *inOutIdx = args->idx;
  5927. ssl->options.clientState = CLIENT_HELLO_COMPLETE;
  5928. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  5929. ssl->options.pskNegotiated = (args->usingPSK != 0);
  5930. #endif
  5931. if (!args->usingPSK) {
  5932. #ifndef NO_CERTS
  5933. #ifdef HAVE_NULL_CIPHER
  5934. if (ssl->options.cipherSuite0 == ECC_BYTE &&
  5935. (ssl->options.cipherSuite == TLS_SHA256_SHA256 ||
  5936. ssl->options.cipherSuite == TLS_SHA384_SHA384)) {
  5937. ;
  5938. }
  5939. else
  5940. #endif
  5941. /* Check that the negotiated ciphersuite matches protocol version. */
  5942. if (ssl->options.cipherSuite0 != TLS13_BYTE) {
  5943. WOLFSSL_MSG("Negotiated ciphersuite from lesser version than "
  5944. "TLS v1.3");
  5945. SendAlert(ssl, alert_fatal, handshake_failure);
  5946. ERROR_OUT(VERSION_ERROR, exit_dch);
  5947. }
  5948. #ifdef HAVE_SESSION_TICKET
  5949. if (ssl->options.resuming) {
  5950. ssl->options.resuming = 0;
  5951. XMEMSET(ssl->arrays->psk_key, 0, ssl->specs.hash_size);
  5952. }
  5953. #endif
  5954. /* Derive early secret for handshake secret. */
  5955. if ((ret = DeriveEarlySecret(ssl)) != 0)
  5956. goto exit_dch;
  5957. #endif /* !NO_CERTS */
  5958. }
  5959. break;
  5960. } /* case TLS_ASYNC_FINALIZE */
  5961. default:
  5962. ret = INPUT_CASE_ERROR;
  5963. } /* switch (ssl->options.asyncState) */
  5964. #if defined(WOLFSSL_DTLS13) && defined(WOLFSSL_SEND_HRR_COOKIE)
  5965. /* We are using DTLSv13 and set the HRR cookie secret, use the cookie to
  5966. perform a return-routability check. */
  5967. if (ret == 0 && ssl->options.dtls && ssl->options.sendCookie &&
  5968. ssl->options.serverState < SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  5969. /* ssl->options.serverState < SERVER_HELLO_RETRY_REQUEST_COMPLETE
  5970. so the client already provided a good KeyShareEntry. In this case
  5971. we don't add the KEY_SHARE extension to the HelloRetryRequest or
  5972. in the Cookie. The RFC8446 forbids to select a supported group
  5973. with KeyShare extension in HelloRetryRequest if the client
  5974. already provided a KeyShareEntry for that group. See rfc8446
  5975. section 4.1.4 */
  5976. TLSX_Remove(&ssl->extensions, TLSX_KEY_SHARE, ssl->heap);
  5977. /* send an HRR (see wolfSSL_Accept_TLSv13()) */
  5978. ssl->options.serverState = SERVER_HELLO_RETRY_REQUEST_COMPLETE;
  5979. }
  5980. #endif /* WOLFSSL_DTLS13 */
  5981. #ifdef WOLFSSL_DTLS_CID
  5982. /* do not modify CID state if we are sending an HRR */
  5983. if (ssl->options.useDtlsCID &&
  5984. ssl->options.serverState != SERVER_HELLO_RETRY_REQUEST_COMPLETE)
  5985. DtlsCIDOnExtensionsParsed(ssl);
  5986. #endif /* WOLFSSL_DTLS_CID */
  5987. exit_dch:
  5988. WOLFSSL_LEAVE("DoTls13ClientHello", ret);
  5989. #ifdef WOLFSSL_ASYNC_CRYPT
  5990. if (ret == WC_PENDING_E) {
  5991. ssl->msgsReceived.got_client_hello = 0;
  5992. return ret;
  5993. }
  5994. #endif
  5995. if (ret == VERSION_ERROR)
  5996. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  5997. FreeDch13Args(ssl, args);
  5998. #ifdef WOLFSSL_ASYNC_CRYPT
  5999. FreeAsyncCtx(ssl, 0);
  6000. #endif
  6001. WOLFSSL_END(WC_FUNC_CLIENT_HELLO_DO);
  6002. if (ret != 0) {
  6003. WOLFSSL_ERROR_VERBOSE(ret);
  6004. }
  6005. #if defined(HAVE_ECH)
  6006. if (ret == 0 && echX != NULL &&
  6007. ((WOLFSSL_ECH*)echX->data)->state == ECH_WRITE_NONE) {
  6008. /* add the header to the inner hello */
  6009. AddTls13HandShakeHeader(((WOLFSSL_ECH*)echX->data)->innerClientHello,
  6010. ((WOLFSSL_ECH*)echX->data)->innerClientHelloLen, 0, 0,
  6011. client_hello, ssl);
  6012. }
  6013. #endif
  6014. return ret;
  6015. }
  6016. /* Send TLS v1.3 ServerHello message to client.
  6017. * Only a server will send this message.
  6018. *
  6019. * ssl The SSL/TLS object.
  6020. * returns 0 on success, otherwise failure.
  6021. */
  6022. /* handle generation of TLS 1.3 server_hello (2) */
  6023. int SendTls13ServerHello(WOLFSSL* ssl, byte extMsgType)
  6024. {
  6025. int ret;
  6026. byte* output;
  6027. word16 length;
  6028. word32 idx = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  6029. int sendSz;
  6030. #if defined(HAVE_ECH)
  6031. TLSX* echX = NULL;
  6032. word32 serverRandomOffset;
  6033. #endif
  6034. WOLFSSL_START(WC_FUNC_SERVER_HELLO_SEND);
  6035. WOLFSSL_ENTER("SendTls13ServerHello");
  6036. if (extMsgType == hello_retry_request) {
  6037. WOLFSSL_MSG("wolfSSL Sending HelloRetryRequest");
  6038. if ((ret = RestartHandshakeHash(ssl)) < 0)
  6039. return ret;
  6040. }
  6041. ssl->options.buildingMsg = 1;
  6042. #ifdef WOLFSSL_DTLS13
  6043. if (ssl->options.dtls)
  6044. idx = DTLS_RECORD_HEADER_SZ + DTLS_HANDSHAKE_HEADER_SZ;
  6045. #endif /* WOLFSSL_DTLS13 */
  6046. /* Protocol version, server random, session id, cipher suite, compression
  6047. * and extensions.
  6048. */
  6049. length = VERSION_SZ + RAN_LEN + ENUM_LEN + ssl->session->sessionIDSz +
  6050. SUITE_LEN + COMP_LEN;
  6051. ret = TLSX_GetResponseSize(ssl, extMsgType, &length);
  6052. if (ret != 0)
  6053. return ret;
  6054. sendSz = idx + length;
  6055. /* Check buffers are big enough and grow if needed. */
  6056. if ((ret = CheckAvailableSize(ssl, sendSz)) != 0)
  6057. return ret;
  6058. /* Get position in output buffer to write new message to. */
  6059. output = ssl->buffers.outputBuffer.buffer +
  6060. ssl->buffers.outputBuffer.length;
  6061. /* Put the record and handshake headers on. */
  6062. AddTls13Headers(output, length, server_hello, ssl);
  6063. /* The protocol version must be TLS v1.2 for middleboxes. */
  6064. output[idx++] = ssl->version.major;
  6065. output[idx++] = ssl->options.dtls ? DTLSv1_2_MINOR : TLSv1_2_MINOR;
  6066. if (extMsgType == server_hello) {
  6067. /* Generate server random. */
  6068. if ((ret = wc_RNG_GenerateBlock(ssl->rng, output + idx, RAN_LEN)) != 0)
  6069. return ret;
  6070. }
  6071. else {
  6072. /* HelloRetryRequest message has fixed value for random. */
  6073. XMEMCPY(output + idx, helloRetryRequestRandom, RAN_LEN);
  6074. }
  6075. #if defined(HAVE_ECH)
  6076. serverRandomOffset = idx;
  6077. #endif
  6078. /* Store in SSL for debugging. */
  6079. XMEMCPY(ssl->arrays->serverRandom, output + idx, RAN_LEN);
  6080. idx += RAN_LEN;
  6081. #ifdef WOLFSSL_DEBUG_TLS
  6082. WOLFSSL_MSG("Server random");
  6083. WOLFSSL_BUFFER(ssl->arrays->serverRandom, RAN_LEN);
  6084. #endif
  6085. output[idx++] = ssl->session->sessionIDSz;
  6086. if (ssl->session->sessionIDSz > 0) {
  6087. XMEMCPY(output + idx, ssl->session->sessionID, ssl->session->sessionIDSz);
  6088. idx += ssl->session->sessionIDSz;
  6089. }
  6090. /* Chosen cipher suite */
  6091. output[idx++] = ssl->options.cipherSuite0;
  6092. output[idx++] = ssl->options.cipherSuite;
  6093. #ifdef WOLFSSL_DEBUG_TLS
  6094. WOLFSSL_MSG("Chosen cipher suite:");
  6095. WOLFSSL_MSG(GetCipherNameInternal(ssl->options.cipherSuite0,
  6096. ssl->options.cipherSuite));
  6097. #endif
  6098. /* Compression not supported in TLS v1.3. */
  6099. output[idx++] = 0;
  6100. /* Extensions */
  6101. ret = TLSX_WriteResponse(ssl, output + idx, extMsgType, NULL);
  6102. if (ret != 0)
  6103. return ret;
  6104. #ifdef WOLFSSL_SEND_HRR_COOKIE
  6105. if (ssl->options.sendCookie && extMsgType == hello_retry_request) {
  6106. /* Reset the hashes from here. We will be able to restart the hashes
  6107. * from the cookie in RestartHandshakeHashWithCookie */
  6108. ret = InitHandshakeHashes(ssl);
  6109. }
  6110. else
  6111. #endif
  6112. {
  6113. #ifdef WOLFSSL_DTLS13
  6114. if (ssl->options.dtls) {
  6115. ret = Dtls13HashHandshake(
  6116. ssl,
  6117. output + Dtls13GetRlHeaderLength(ssl, 0) ,
  6118. (word16)sendSz - Dtls13GetRlHeaderLength(ssl, 0));
  6119. }
  6120. else
  6121. #endif /* WOLFSSL_DTLS13 */
  6122. {
  6123. #if defined(HAVE_ECH)
  6124. if (ssl->ctx->echConfigs != NULL) {
  6125. echX = TLSX_Find(ssl->extensions, TLSX_ECH);
  6126. if (echX == NULL)
  6127. return -1;
  6128. /* replace the last 8 bytes of server random with the accept */
  6129. if (((WOLFSSL_ECH*)echX->data)->state == ECH_PARSED_INTERNAL) {
  6130. ret = EchWriteAcceptance(ssl, output + RECORD_HEADER_SZ,
  6131. serverRandomOffset - RECORD_HEADER_SZ,
  6132. sendSz - RECORD_HEADER_SZ);
  6133. /* remove ech so we don't keep sending it in write */
  6134. TLSX_Remove(&ssl->extensions, TLSX_ECH, ssl->heap);
  6135. }
  6136. }
  6137. #endif
  6138. if (ret == 0)
  6139. ret = HashOutput(ssl, output, sendSz, 0);
  6140. }
  6141. }
  6142. if (ret != 0)
  6143. return ret;
  6144. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  6145. if (ssl->hsInfoOn)
  6146. AddPacketName(ssl, "ServerHello");
  6147. if (ssl->toInfoOn) {
  6148. ret = AddPacketInfo(ssl, "ServerHello", handshake, output, sendSz,
  6149. WRITE_PROTO, 0, ssl->heap);
  6150. if (ret != 0)
  6151. return ret;
  6152. }
  6153. #endif
  6154. if (extMsgType == server_hello)
  6155. ssl->options.serverState = SERVER_HELLO_COMPLETE;
  6156. ssl->options.buildingMsg = 0;
  6157. #ifdef WOLFSSL_DTLS13
  6158. if (ssl->options.dtls) {
  6159. ret = Dtls13HandshakeSend(ssl, output, (word16)sendSz, (word16)sendSz,
  6160. (enum HandShakeType)extMsgType, 0);
  6161. WOLFSSL_LEAVE("SendTls13ServerHello", ret);
  6162. WOLFSSL_END(WC_FUNC_SERVER_HELLO_SEND);
  6163. return ret;
  6164. }
  6165. #endif /* WOLFSSL_DTLS13 */
  6166. ssl->buffers.outputBuffer.length += sendSz;
  6167. if (!ssl->options.groupMessages || extMsgType != server_hello)
  6168. ret = SendBuffered(ssl);
  6169. WOLFSSL_LEAVE("SendTls13ServerHello", ret);
  6170. WOLFSSL_END(WC_FUNC_SERVER_HELLO_SEND);
  6171. return ret;
  6172. }
  6173. /* handle generation of TLS 1.3 encrypted_extensions (8) */
  6174. /* Send the rest of the extensions encrypted under the handshake key.
  6175. * This message is always encrypted in TLS v1.3.
  6176. * Only a server will send this message.
  6177. *
  6178. * ssl The SSL/TLS object.
  6179. * returns 0 on success, otherwise failure.
  6180. */
  6181. static int SendTls13EncryptedExtensions(WOLFSSL* ssl)
  6182. {
  6183. int ret;
  6184. byte* output;
  6185. word16 length = 0;
  6186. word32 idx;
  6187. int sendSz;
  6188. WOLFSSL_START(WC_FUNC_ENCRYPTED_EXTENSIONS_SEND);
  6189. WOLFSSL_ENTER("SendTls13EncryptedExtensions");
  6190. ssl->options.buildingMsg = 1;
  6191. ssl->keys.encryptionOn = 1;
  6192. #ifdef WOLFSSL_DTLS13
  6193. if (ssl->options.dtls) {
  6194. idx = Dtls13GetHeadersLength(ssl, encrypted_extensions);
  6195. }
  6196. else
  6197. #endif /* WOLFSSL_DTLS13 */
  6198. {
  6199. idx = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  6200. }
  6201. #if defined(HAVE_SUPPORTED_CURVES) && !defined(WOLFSSL_NO_SERVER_GROUPS_EXT)
  6202. if ((ret = TLSX_SupportedCurve_CheckPriority(ssl)) != 0)
  6203. return ret;
  6204. #endif
  6205. /* Derive the handshake secret now that we are at first message to be
  6206. * encrypted under the keys.
  6207. */
  6208. if ((ret = DeriveHandshakeSecret(ssl)) != 0)
  6209. return ret;
  6210. if ((ret = DeriveTls13Keys(ssl, handshake_key,
  6211. ENCRYPT_AND_DECRYPT_SIDE, 1)) != 0)
  6212. return ret;
  6213. /* Setup encrypt/decrypt keys for following messages. */
  6214. #ifdef WOLFSSL_EARLY_DATA
  6215. if ((ret = SetKeysSide(ssl, ENCRYPT_SIDE_ONLY)) != 0)
  6216. return ret;
  6217. if (ssl->earlyData != process_early_data) {
  6218. if ((ret = SetKeysSide(ssl, DECRYPT_SIDE_ONLY)) != 0)
  6219. return ret;
  6220. }
  6221. #else
  6222. if ((ret = SetKeysSide(ssl, ENCRYPT_AND_DECRYPT_SIDE)) != 0)
  6223. return ret;
  6224. #endif
  6225. #ifdef WOLFSSL_QUIC
  6226. if (IsAtLeastTLSv1_3(ssl->version) && WOLFSSL_IS_QUIC(ssl)) {
  6227. ret = wolfSSL_quic_add_transport_extensions(ssl, encrypted_extensions);
  6228. if (ret != 0)
  6229. return ret;
  6230. }
  6231. #endif
  6232. #ifdef WOLFSSL_DTLS13
  6233. if (ssl->options.dtls) {
  6234. w64wrapper epochHandshake = w64From32(0, DTLS13_EPOCH_HANDSHAKE);
  6235. ssl->dtls13Epoch = epochHandshake;
  6236. ret = Dtls13NewEpoch(
  6237. ssl, epochHandshake, ENCRYPT_AND_DECRYPT_SIDE);
  6238. if (ret != 0)
  6239. return ret;
  6240. ret = Dtls13SetEpochKeys(
  6241. ssl, epochHandshake, ENCRYPT_AND_DECRYPT_SIDE);
  6242. if (ret != 0)
  6243. return ret;
  6244. }
  6245. #endif /* WOLFSSL_DTLS13 */
  6246. ret = TLSX_GetResponseSize(ssl, encrypted_extensions, &length);
  6247. if (ret != 0)
  6248. return ret;
  6249. sendSz = idx + length;
  6250. /* Encryption always on. */
  6251. sendSz += MAX_MSG_EXTRA;
  6252. /* Check buffers are big enough and grow if needed. */
  6253. ret = CheckAvailableSize(ssl, sendSz);
  6254. if (ret != 0)
  6255. return ret;
  6256. /* Get position in output buffer to write new message to. */
  6257. output = ssl->buffers.outputBuffer.buffer +
  6258. ssl->buffers.outputBuffer.length;
  6259. /* Put the record and handshake headers on. */
  6260. AddTls13Headers(output, length, encrypted_extensions, ssl);
  6261. ret = TLSX_WriteResponse(ssl, output + idx, encrypted_extensions, NULL);
  6262. if (ret != 0)
  6263. return ret;
  6264. idx += length;
  6265. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  6266. if (ssl->hsInfoOn)
  6267. AddPacketName(ssl, "EncryptedExtensions");
  6268. if (ssl->toInfoOn) {
  6269. ret = AddPacketInfo(ssl, "EncryptedExtensions", handshake, output,
  6270. sendSz, WRITE_PROTO, 0, ssl->heap);
  6271. if (ret != 0)
  6272. return ret;
  6273. }
  6274. #endif
  6275. #ifdef WOLFSSL_DTLS13
  6276. if (ssl->options.dtls) {
  6277. ssl->options.buildingMsg = 0;
  6278. ret = Dtls13HandshakeSend(ssl, output, (word16)sendSz, (word16)idx,
  6279. encrypted_extensions, 1);
  6280. if (ret == 0)
  6281. ssl->options.serverState = SERVER_ENCRYPTED_EXTENSIONS_COMPLETE;
  6282. WOLFSSL_LEAVE("SendTls13EncryptedExtensions", ret);
  6283. WOLFSSL_END(WC_FUNC_ENCRYPTED_EXTENSIONS_SEND);
  6284. return ret;
  6285. }
  6286. #endif /* WOLFSSL_DTLS13 */
  6287. /* This handshake message is always encrypted. */
  6288. sendSz = BuildTls13Message(ssl, output, sendSz, output + RECORD_HEADER_SZ,
  6289. idx - RECORD_HEADER_SZ, handshake, 1, 0, 0);
  6290. if (sendSz < 0)
  6291. return sendSz;
  6292. ssl->buffers.outputBuffer.length += sendSz;
  6293. ssl->options.buildingMsg = 0;
  6294. ssl->options.serverState = SERVER_ENCRYPTED_EXTENSIONS_COMPLETE;
  6295. if (!ssl->options.groupMessages)
  6296. ret = SendBuffered(ssl);
  6297. WOLFSSL_LEAVE("SendTls13EncryptedExtensions", ret);
  6298. WOLFSSL_END(WC_FUNC_ENCRYPTED_EXTENSIONS_SEND);
  6299. return ret;
  6300. }
  6301. #ifndef NO_CERTS
  6302. /* handle generation TLS v1.3 certificate_request (13) */
  6303. /* Send the TLS v1.3 CertificateRequest message.
  6304. * This message is always encrypted in TLS v1.3.
  6305. * Only a server will send this message.
  6306. *
  6307. * ssl SSL/TLS object.
  6308. * reqCtx Request context.
  6309. * reqCtxLen Length of context. 0 when sending as part of handshake.
  6310. * returns 0 on success, otherwise failure.
  6311. */
  6312. static int SendTls13CertificateRequest(WOLFSSL* ssl, byte* reqCtx,
  6313. int reqCtxLen)
  6314. {
  6315. byte* output;
  6316. int ret;
  6317. int sendSz;
  6318. word32 i;
  6319. word16 reqSz;
  6320. word16 hashSigAlgoSz = 0;
  6321. SignatureAlgorithms* sa;
  6322. WOLFSSL_START(WC_FUNC_CERTIFICATE_REQUEST_SEND);
  6323. WOLFSSL_ENTER("SendTls13CertificateRequest");
  6324. ssl->options.buildingMsg = 1;
  6325. if (ssl->options.side != WOLFSSL_SERVER_END)
  6326. return SIDE_ERROR;
  6327. /* Get the length of the hashSigAlgo buffer */
  6328. InitSuitesHashSigAlgo_ex(NULL, 1, 1, 1, 1, 0, 1, ssl->buffers.keySz,
  6329. &hashSigAlgoSz);
  6330. sa = TLSX_SignatureAlgorithms_New(ssl, hashSigAlgoSz, ssl->heap);
  6331. if (sa == NULL)
  6332. return MEMORY_ERROR;
  6333. InitSuitesHashSigAlgo_ex(sa->hashSigAlgo, 1, 1, 1, 1, 0, 1,
  6334. ssl->buffers.keySz, &sa->hashSigAlgoSz);
  6335. ret = TLSX_Push(&ssl->extensions, TLSX_SIGNATURE_ALGORITHMS, sa, ssl->heap);
  6336. if (ret != 0) {
  6337. TLSX_SignatureAlgorithms_FreeAll(sa, ssl->heap);
  6338. return ret;
  6339. }
  6340. i = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  6341. #ifdef WOLFSSL_DTLS13
  6342. if (ssl->options.dtls)
  6343. i = Dtls13GetRlHeaderLength(ssl, 1) + DTLS_HANDSHAKE_HEADER_SZ;
  6344. #endif /* WOLFSSL_DTLS13 */
  6345. reqSz = (word16)(OPAQUE8_LEN + reqCtxLen);
  6346. ret = TLSX_GetRequestSize(ssl, certificate_request, &reqSz);
  6347. if (ret != 0)
  6348. return ret;
  6349. sendSz = i + reqSz;
  6350. /* Always encrypted and make room for padding. */
  6351. sendSz += MAX_MSG_EXTRA;
  6352. /* Check buffers are big enough and grow if needed. */
  6353. if ((ret = CheckAvailableSize(ssl, sendSz)) != 0)
  6354. return ret;
  6355. /* Get position in output buffer to write new message to. */
  6356. output = ssl->buffers.outputBuffer.buffer +
  6357. ssl->buffers.outputBuffer.length;
  6358. /* Put the record and handshake headers on. */
  6359. AddTls13Headers(output, reqSz, certificate_request, ssl);
  6360. /* Certificate request context. */
  6361. output[i++] = (byte)reqCtxLen;
  6362. if (reqCtxLen != 0) {
  6363. XMEMCPY(output + i, reqCtx, reqCtxLen);
  6364. i += reqCtxLen;
  6365. }
  6366. /* Certificate extensions. */
  6367. reqSz = 0;
  6368. ret = TLSX_WriteRequest(ssl, output + i, certificate_request, &reqSz);
  6369. if (ret != 0)
  6370. return ret;
  6371. i += reqSz;
  6372. #ifdef WOLFSSL_DTLS13
  6373. if (ssl->options.dtls) {
  6374. ssl->options.buildingMsg = 0;
  6375. ret =
  6376. Dtls13HandshakeSend(ssl, output, (word16)sendSz, (word16)i,
  6377. certificate_request, 1);
  6378. WOLFSSL_LEAVE("SendTls13CertificateRequest", ret);
  6379. WOLFSSL_END(WC_FUNC_CERTIFICATE_REQUEST_SEND);
  6380. return ret;
  6381. }
  6382. #endif /* WOLFSSL_DTLS13 */
  6383. /* Always encrypted. */
  6384. sendSz = BuildTls13Message(ssl, output, sendSz, output + RECORD_HEADER_SZ,
  6385. i - RECORD_HEADER_SZ, handshake, 1, 0, 0);
  6386. if (sendSz < 0)
  6387. return sendSz;
  6388. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  6389. if (ssl->hsInfoOn)
  6390. AddPacketName(ssl, "CertificateRequest");
  6391. if (ssl->toInfoOn) {
  6392. ret = AddPacketInfo(ssl, "CertificateRequest", handshake, output,
  6393. sendSz, WRITE_PROTO, 0, ssl->heap);
  6394. if (ret != 0)
  6395. return ret;
  6396. }
  6397. #endif
  6398. ssl->buffers.outputBuffer.length += sendSz;
  6399. ssl->options.buildingMsg = 0;
  6400. if (!ssl->options.groupMessages)
  6401. ret = SendBuffered(ssl);
  6402. WOLFSSL_LEAVE("SendTls13CertificateRequest", ret);
  6403. WOLFSSL_END(WC_FUNC_CERTIFICATE_REQUEST_SEND);
  6404. return ret;
  6405. }
  6406. #endif /* NO_CERTS */
  6407. #endif /* NO_WOLFSSL_SERVER */
  6408. #ifndef NO_CERTS
  6409. #if !defined(NO_RSA) || defined(HAVE_ECC) || defined(HAVE_ED25519) || \
  6410. defined(HAVE_ED448) || defined(HAVE_PQC)
  6411. /* Encode the signature algorithm into buffer.
  6412. *
  6413. * hashalgo The hash algorithm.
  6414. * hsType The signature type.
  6415. * output The buffer to encode into.
  6416. */
  6417. static WC_INLINE void EncodeSigAlg(byte hashAlgo, byte hsType, byte* output)
  6418. {
  6419. switch (hsType) {
  6420. #ifdef HAVE_ECC
  6421. case ecc_dsa_sa_algo:
  6422. output[0] = hashAlgo;
  6423. output[1] = ecc_dsa_sa_algo;
  6424. break;
  6425. #endif
  6426. #ifdef HAVE_ED25519
  6427. /* ED25519: 0x0807 */
  6428. case ed25519_sa_algo:
  6429. output[0] = ED25519_SA_MAJOR;
  6430. output[1] = ED25519_SA_MINOR;
  6431. (void)hashAlgo;
  6432. break;
  6433. #endif
  6434. #ifdef HAVE_ED448
  6435. /* ED448: 0x0808 */
  6436. case ed448_sa_algo:
  6437. output[0] = ED448_SA_MAJOR;
  6438. output[1] = ED448_SA_MINOR;
  6439. (void)hashAlgo;
  6440. break;
  6441. #endif
  6442. #ifndef NO_RSA
  6443. /* PSS signatures: 0x080[4-6] */
  6444. case rsa_pss_sa_algo:
  6445. output[0] = rsa_pss_sa_algo;
  6446. output[1] = hashAlgo;
  6447. break;
  6448. #endif
  6449. #ifdef HAVE_PQC
  6450. #ifdef HAVE_FALCON
  6451. case falcon_level1_sa_algo:
  6452. output[0] = FALCON_LEVEL1_SA_MAJOR;
  6453. output[1] = FALCON_LEVEL1_SA_MINOR;
  6454. break;
  6455. case falcon_level5_sa_algo:
  6456. output[0] = FALCON_LEVEL5_SA_MAJOR;
  6457. output[1] = FALCON_LEVEL5_SA_MINOR;
  6458. break;
  6459. #endif
  6460. #ifdef HAVE_DILITHIUM
  6461. case dilithium_level2_sa_algo:
  6462. output[0] = DILITHIUM_LEVEL2_SA_MAJOR;
  6463. output[1] = DILITHIUM_LEVEL2_SA_MINOR;
  6464. break;
  6465. case dilithium_level3_sa_algo:
  6466. output[0] = DILITHIUM_LEVEL3_SA_MAJOR;
  6467. output[1] = DILITHIUM_LEVEL3_SA_MINOR;
  6468. break;
  6469. case dilithium_level5_sa_algo:
  6470. output[0] = DILITHIUM_LEVEL5_SA_MAJOR;
  6471. output[1] = DILITHIUM_LEVEL5_SA_MINOR;
  6472. break;
  6473. #endif
  6474. #endif
  6475. default:
  6476. break;
  6477. }
  6478. }
  6479. /* Decode the signature algorithm.
  6480. *
  6481. * input The encoded signature algorithm.
  6482. * hashalgo The hash algorithm.
  6483. * hsType The signature type.
  6484. * returns INVALID_PARAMETER if not recognized and 0 otherwise.
  6485. */
  6486. static WC_INLINE int DecodeTls13SigAlg(byte* input, byte* hashAlgo,
  6487. byte* hsType)
  6488. {
  6489. int ret = 0;
  6490. switch (input[0]) {
  6491. case NEW_SA_MAJOR:
  6492. /* PSS signatures: 0x080[4-6] */
  6493. if (input[1] >= sha256_mac && input[1] <= sha512_mac) {
  6494. *hsType = input[0];
  6495. *hashAlgo = input[1];
  6496. }
  6497. #ifdef HAVE_ED25519
  6498. /* ED25519: 0x0807 */
  6499. else if (input[1] == ED25519_SA_MINOR) {
  6500. *hsType = ed25519_sa_algo;
  6501. /* Hash performed as part of sign/verify operation. */
  6502. *hashAlgo = sha512_mac;
  6503. }
  6504. #endif
  6505. #ifdef HAVE_ED448
  6506. /* ED448: 0x0808 */
  6507. else if (input[1] == ED448_SA_MINOR) {
  6508. *hsType = ed448_sa_algo;
  6509. /* Hash performed as part of sign/verify operation. */
  6510. *hashAlgo = sha512_mac;
  6511. }
  6512. #endif
  6513. else
  6514. ret = INVALID_PARAMETER;
  6515. break;
  6516. #ifdef HAVE_PQC
  6517. case PQC_SA_MAJOR:
  6518. #if defined(HAVE_FALCON)
  6519. if (input[1] == FALCON_LEVEL1_SA_MINOR) {
  6520. *hsType = falcon_level1_sa_algo;
  6521. /* Hash performed as part of sign/verify operation. */
  6522. *hashAlgo = sha512_mac;
  6523. } else if (input[1] == FALCON_LEVEL5_SA_MINOR) {
  6524. *hsType = falcon_level5_sa_algo;
  6525. /* Hash performed as part of sign/verify operation. */
  6526. *hashAlgo = sha512_mac;
  6527. }
  6528. else
  6529. #endif /* HAVE_FALCON */
  6530. #if defined(HAVE_DILITHIUM)
  6531. if (input[1] == DILITHIUM_LEVEL2_SA_MINOR) {
  6532. *hsType = dilithium_level2_sa_algo;
  6533. /* Hash performed as part of sign/verify operation. */
  6534. *hashAlgo = sha512_mac;
  6535. } else if (input[1] == DILITHIUM_LEVEL3_SA_MINOR) {
  6536. *hsType = dilithium_level3_sa_algo;
  6537. /* Hash performed as part of sign/verify operation. */
  6538. *hashAlgo = sha512_mac;
  6539. } else if (input[1] == DILITHIUM_LEVEL5_SA_MINOR) {
  6540. *hsType = dilithium_level5_sa_algo;
  6541. /* Hash performed as part of sign/verify operation. */
  6542. *hashAlgo = sha512_mac;
  6543. }
  6544. else
  6545. #endif /* HAVE_DILITHIUM */
  6546. {
  6547. ret = INVALID_PARAMETER;
  6548. }
  6549. break;
  6550. #endif
  6551. default:
  6552. *hashAlgo = input[0];
  6553. *hsType = input[1];
  6554. break;
  6555. }
  6556. return ret;
  6557. }
  6558. /* Get the hash of the messages so far.
  6559. *
  6560. * ssl The SSL/TLS object.
  6561. * hash The buffer to write the hash to.
  6562. * returns the length of the hash.
  6563. */
  6564. static WC_INLINE int GetMsgHash(WOLFSSL* ssl, byte* hash)
  6565. {
  6566. int ret = 0;
  6567. switch (ssl->specs.mac_algorithm) {
  6568. #ifndef NO_SHA256
  6569. case sha256_mac:
  6570. ret = wc_Sha256GetHash(&ssl->hsHashes->hashSha256, hash);
  6571. if (ret == 0)
  6572. ret = WC_SHA256_DIGEST_SIZE;
  6573. break;
  6574. #endif /* !NO_SHA256 */
  6575. #ifdef WOLFSSL_SHA384
  6576. case sha384_mac:
  6577. ret = wc_Sha384GetHash(&ssl->hsHashes->hashSha384, hash);
  6578. if (ret == 0)
  6579. ret = WC_SHA384_DIGEST_SIZE;
  6580. break;
  6581. #endif /* WOLFSSL_SHA384 */
  6582. #ifdef WOLFSSL_TLS13_SHA512
  6583. case sha512_mac:
  6584. ret = wc_Sha512GetHash(&ssl->hsHashes->hashSha512, hash);
  6585. if (ret == 0)
  6586. ret = WC_SHA512_DIGEST_SIZE;
  6587. break;
  6588. #endif /* WOLFSSL_TLS13_SHA512 */
  6589. default:
  6590. break;
  6591. }
  6592. return ret;
  6593. }
  6594. /* The server certificate verification label. */
  6595. static const byte serverCertVfyLabel[CERT_VFY_LABEL_SZ] =
  6596. "TLS 1.3, server CertificateVerify";
  6597. /* The client certificate verification label. */
  6598. static const byte clientCertVfyLabel[CERT_VFY_LABEL_SZ] =
  6599. "TLS 1.3, client CertificateVerify";
  6600. /* The prefix byte in the signature data. */
  6601. #define SIGNING_DATA_PREFIX_BYTE 0x20
  6602. /* Create the signature data for TLS v1.3 certificate verification.
  6603. *
  6604. * ssl The SSL/TLS object.
  6605. * sigData The signature data.
  6606. * sigDataSz The length of the signature data.
  6607. * check Indicates this is a check not create.
  6608. */
  6609. int CreateSigData(WOLFSSL* ssl, byte* sigData, word16* sigDataSz,
  6610. int check)
  6611. {
  6612. word16 idx;
  6613. int side = ssl->options.side;
  6614. int ret;
  6615. /* Signature Data = Prefix | Label | Handshake Hash */
  6616. XMEMSET(sigData, SIGNING_DATA_PREFIX_BYTE, SIGNING_DATA_PREFIX_SZ);
  6617. idx = SIGNING_DATA_PREFIX_SZ;
  6618. if ((side == WOLFSSL_SERVER_END && check) ||
  6619. (side == WOLFSSL_CLIENT_END && !check)) {
  6620. XMEMCPY(&sigData[idx], clientCertVfyLabel, CERT_VFY_LABEL_SZ);
  6621. }
  6622. if ((side == WOLFSSL_CLIENT_END && check) ||
  6623. (side == WOLFSSL_SERVER_END && !check)) {
  6624. XMEMCPY(&sigData[idx], serverCertVfyLabel, CERT_VFY_LABEL_SZ);
  6625. }
  6626. idx += CERT_VFY_LABEL_SZ;
  6627. ret = GetMsgHash(ssl, &sigData[idx]);
  6628. if (ret < 0)
  6629. return ret;
  6630. *sigDataSz = (word16)(idx + ret);
  6631. ret = 0;
  6632. return ret;
  6633. }
  6634. #ifndef NO_RSA
  6635. /* Encode the PKCS #1.5 RSA signature.
  6636. *
  6637. * sig The buffer to place the encoded signature into.
  6638. * sigData The data to be signed.
  6639. * sigDataSz The size of the data to be signed.
  6640. * hashAlgo The hash algorithm to use when signing.
  6641. * returns the length of the encoded signature or negative on error.
  6642. */
  6643. int CreateRSAEncodedSig(byte* sig, byte* sigData, int sigDataSz,
  6644. int sigAlgo, int hashAlgo)
  6645. {
  6646. Digest digest;
  6647. int hashSz = 0;
  6648. int ret = BAD_FUNC_ARG;
  6649. byte* hash;
  6650. (void)sigAlgo;
  6651. hash = sig;
  6652. /* Digest the signature data. */
  6653. switch (hashAlgo) {
  6654. #ifndef NO_WOLFSSL_SHA256
  6655. case sha256_mac:
  6656. ret = wc_InitSha256(&digest.sha256);
  6657. if (ret == 0) {
  6658. ret = wc_Sha256Update(&digest.sha256, sigData, sigDataSz);
  6659. if (ret == 0)
  6660. ret = wc_Sha256Final(&digest.sha256, hash);
  6661. wc_Sha256Free(&digest.sha256);
  6662. }
  6663. hashSz = WC_SHA256_DIGEST_SIZE;
  6664. break;
  6665. #endif
  6666. #ifdef WOLFSSL_SHA384
  6667. case sha384_mac:
  6668. ret = wc_InitSha384(&digest.sha384);
  6669. if (ret == 0) {
  6670. ret = wc_Sha384Update(&digest.sha384, sigData, sigDataSz);
  6671. if (ret == 0)
  6672. ret = wc_Sha384Final(&digest.sha384, hash);
  6673. wc_Sha384Free(&digest.sha384);
  6674. }
  6675. hashSz = WC_SHA384_DIGEST_SIZE;
  6676. break;
  6677. #endif
  6678. #ifdef WOLFSSL_SHA512
  6679. case sha512_mac:
  6680. ret = wc_InitSha512(&digest.sha512);
  6681. if (ret == 0) {
  6682. ret = wc_Sha512Update(&digest.sha512, sigData, sigDataSz);
  6683. if (ret == 0)
  6684. ret = wc_Sha512Final(&digest.sha512, hash);
  6685. wc_Sha512Free(&digest.sha512);
  6686. }
  6687. hashSz = WC_SHA512_DIGEST_SIZE;
  6688. break;
  6689. #endif
  6690. }
  6691. if (ret != 0)
  6692. return ret;
  6693. return hashSz;
  6694. }
  6695. #endif /* !NO_RSA */
  6696. #ifdef HAVE_ECC
  6697. /* Encode the ECC signature.
  6698. *
  6699. * sigData The data to be signed.
  6700. * sigDataSz The size of the data to be signed.
  6701. * hashAlgo The hash algorithm to use when signing.
  6702. * returns the length of the encoded signature or negative on error.
  6703. */
  6704. static int CreateECCEncodedSig(byte* sigData, int sigDataSz, int hashAlgo)
  6705. {
  6706. Digest digest;
  6707. int hashSz = 0;
  6708. int ret = BAD_FUNC_ARG;
  6709. /* Digest the signature data. */
  6710. switch (hashAlgo) {
  6711. #ifndef NO_WOLFSSL_SHA256
  6712. case sha256_mac:
  6713. ret = wc_InitSha256(&digest.sha256);
  6714. if (ret == 0) {
  6715. ret = wc_Sha256Update(&digest.sha256, sigData, sigDataSz);
  6716. if (ret == 0)
  6717. ret = wc_Sha256Final(&digest.sha256, sigData);
  6718. wc_Sha256Free(&digest.sha256);
  6719. }
  6720. hashSz = WC_SHA256_DIGEST_SIZE;
  6721. break;
  6722. #endif
  6723. #ifdef WOLFSSL_SHA384
  6724. case sha384_mac:
  6725. ret = wc_InitSha384(&digest.sha384);
  6726. if (ret == 0) {
  6727. ret = wc_Sha384Update(&digest.sha384, sigData, sigDataSz);
  6728. if (ret == 0)
  6729. ret = wc_Sha384Final(&digest.sha384, sigData);
  6730. wc_Sha384Free(&digest.sha384);
  6731. }
  6732. hashSz = WC_SHA384_DIGEST_SIZE;
  6733. break;
  6734. #endif
  6735. #ifdef WOLFSSL_SHA512
  6736. case sha512_mac:
  6737. ret = wc_InitSha512(&digest.sha512);
  6738. if (ret == 0) {
  6739. ret = wc_Sha512Update(&digest.sha512, sigData, sigDataSz);
  6740. if (ret == 0)
  6741. ret = wc_Sha512Final(&digest.sha512, sigData);
  6742. wc_Sha512Free(&digest.sha512);
  6743. }
  6744. hashSz = WC_SHA512_DIGEST_SIZE;
  6745. break;
  6746. #endif
  6747. default:
  6748. break;
  6749. }
  6750. if (ret != 0)
  6751. return ret;
  6752. return hashSz;
  6753. }
  6754. #endif /* HAVE_ECC */
  6755. #if !defined(NO_RSA) && defined(WC_RSA_PSS)
  6756. /* Check that the decrypted signature matches the encoded signature
  6757. * based on the digest of the signature data.
  6758. *
  6759. * ssl The SSL/TLS object.
  6760. * sigAlgo The signature algorithm used to generate signature.
  6761. * hashAlgo The hash algorithm used to generate signature.
  6762. * decSig The decrypted signature.
  6763. * decSigSz The size of the decrypted signature.
  6764. * returns 0 on success, otherwise failure.
  6765. */
  6766. static int CheckRSASignature(WOLFSSL* ssl, int sigAlgo, int hashAlgo,
  6767. byte* decSig, word32 decSigSz)
  6768. {
  6769. int ret = 0;
  6770. byte sigData[MAX_SIG_DATA_SZ];
  6771. word16 sigDataSz;
  6772. word32 sigSz;
  6773. ret = CreateSigData(ssl, sigData, &sigDataSz, 1);
  6774. if (ret != 0)
  6775. return ret;
  6776. if (sigAlgo == rsa_pss_sa_algo) {
  6777. enum wc_HashType hashType = WC_HASH_TYPE_NONE;
  6778. ret = ConvertHashPss(hashAlgo, &hashType, NULL);
  6779. if (ret < 0)
  6780. return ret;
  6781. /* PSS signature can be done in-place */
  6782. ret = CreateRSAEncodedSig(sigData, sigData, sigDataSz,
  6783. sigAlgo, hashAlgo);
  6784. if (ret < 0)
  6785. return ret;
  6786. sigSz = ret;
  6787. ret = wc_RsaPSS_CheckPadding(sigData, sigSz, decSig, decSigSz,
  6788. hashType);
  6789. }
  6790. return ret;
  6791. }
  6792. #endif /* !NO_RSA && WC_RSA_PSS */
  6793. #endif /* !NO_RSA || HAVE_ECC */
  6794. #if !defined(NO_WOLFSSL_CLIENT) || !defined(NO_WOLFSSL_SERVER)
  6795. /* Get the next certificate from the list for writing into the TLS v1.3
  6796. * Certificate message.
  6797. *
  6798. * data The certificate list.
  6799. * length The length of the certificate data in the list.
  6800. * idx The index of the next certificate.
  6801. * returns the length of the certificate data. 0 indicates no more certificates
  6802. * in the list.
  6803. */
  6804. static word32 NextCert(byte* data, word32 length, word32* idx)
  6805. {
  6806. word32 len;
  6807. /* Is index at end of list. */
  6808. if (*idx == length)
  6809. return 0;
  6810. /* Length of the current ASN.1 encoded certificate. */
  6811. c24to32(data + *idx, &len);
  6812. /* Include the length field. */
  6813. len += 3;
  6814. /* Move index to next certificate and return the current certificate's
  6815. * length.
  6816. */
  6817. *idx += len;
  6818. return len;
  6819. }
  6820. /* Add certificate data and empty extension to output up to the fragment size.
  6821. *
  6822. * ssl SSL/TLS object.
  6823. * cert The certificate data to write out.
  6824. * len The length of the certificate data.
  6825. * extSz Length of the extension data with the certificate.
  6826. * idx The start of the certificate data to write out.
  6827. * fragSz The maximum size of this fragment.
  6828. * output The buffer to write to.
  6829. * returns the number of bytes written.
  6830. */
  6831. static word32 AddCertExt(WOLFSSL* ssl, byte* cert, word32 len, word16 extSz,
  6832. word32 idx, word32 fragSz, byte* output)
  6833. {
  6834. word32 i = 0;
  6835. word32 copySz = min(len - idx, fragSz);
  6836. if (idx < len) {
  6837. XMEMCPY(output, cert + idx, copySz);
  6838. i = copySz;
  6839. if (copySz == fragSz)
  6840. return i;
  6841. }
  6842. copySz = len + extSz - idx - i;
  6843. if (extSz == OPAQUE16_LEN) {
  6844. if (copySz <= fragSz) {
  6845. /* Empty extension */
  6846. output[i++] = 0;
  6847. output[i++] = 0;
  6848. }
  6849. }
  6850. else {
  6851. byte* certExts = ssl->buffers.certExts->buffer + idx + i - len;
  6852. /* Put out as much of the extensions' data as will fit in fragment. */
  6853. if (copySz > fragSz - i)
  6854. copySz = fragSz - i;
  6855. XMEMCPY(output + i, certExts, copySz);
  6856. i += copySz;
  6857. }
  6858. return i;
  6859. }
  6860. /* handle generation TLS v1.3 certificate (11) */
  6861. /* Send the certificate for this end and any CAs that help with validation.
  6862. * This message is always encrypted in TLS v1.3.
  6863. *
  6864. * ssl The SSL/TLS object.
  6865. * returns 0 on success, otherwise failure.
  6866. */
  6867. static int SendTls13Certificate(WOLFSSL* ssl)
  6868. {
  6869. int ret = 0;
  6870. word32 certSz, certChainSz, headerSz, listSz, payloadSz;
  6871. word16 extSz = 0;
  6872. word32 length, maxFragment;
  6873. word32 len = 0;
  6874. word32 idx = 0;
  6875. word32 offset = OPAQUE16_LEN;
  6876. byte* p = NULL;
  6877. byte certReqCtxLen = 0;
  6878. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  6879. byte* certReqCtx = NULL;
  6880. #endif
  6881. #ifdef OPENSSL_EXTRA
  6882. WOLFSSL_X509* x509 = NULL;
  6883. WOLFSSL_EVP_PKEY* pkey = NULL;
  6884. #endif
  6885. WOLFSSL_START(WC_FUNC_CERTIFICATE_SEND);
  6886. WOLFSSL_ENTER("SendTls13Certificate");
  6887. ssl->options.buildingMsg = 1;
  6888. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  6889. if (ssl->options.side == WOLFSSL_CLIENT_END && ssl->certReqCtx != NULL) {
  6890. certReqCtxLen = ssl->certReqCtx->len;
  6891. certReqCtx = &ssl->certReqCtx->ctx;
  6892. }
  6893. #endif
  6894. #ifdef OPENSSL_EXTRA
  6895. /* call client cert callback if no cert has been loaded */
  6896. if ((ssl->ctx->CBClientCert != NULL) &&
  6897. (!ssl->buffers.certificate || !ssl->buffers.certificate->buffer)) {
  6898. ret = ssl->ctx->CBClientCert(ssl, &x509, &pkey);
  6899. if (ret == 1) {
  6900. if ((wolfSSL_CTX_use_certificate(ssl->ctx, x509) == WOLFSSL_SUCCESS) &&
  6901. (wolfSSL_CTX_use_PrivateKey(ssl->ctx, pkey) == WOLFSSL_SUCCESS)) {
  6902. ssl->options.sendVerify = SEND_CERT;
  6903. }
  6904. wolfSSL_X509_free(x509);
  6905. wolfSSL_EVP_PKEY_free(pkey);
  6906. }
  6907. }
  6908. #endif
  6909. if (ssl->options.sendVerify == SEND_BLANK_CERT) {
  6910. certSz = 0;
  6911. certChainSz = 0;
  6912. headerSz = OPAQUE8_LEN + certReqCtxLen + CERT_HEADER_SZ;
  6913. length = headerSz;
  6914. listSz = 0;
  6915. }
  6916. else {
  6917. #ifdef OPENSSL_EXTRA
  6918. if ((ret = CertSetupCbWrapper(ssl)) != 0)
  6919. return ret;
  6920. #endif
  6921. if (!ssl->buffers.certificate) {
  6922. WOLFSSL_MSG("Send Cert missing certificate buffer");
  6923. return BUFFER_ERROR;
  6924. }
  6925. /* Certificate Data */
  6926. certSz = ssl->buffers.certificate->length;
  6927. /* Cert Req Ctx Len | Cert Req Ctx | Cert List Len | Cert Data Len */
  6928. headerSz = OPAQUE8_LEN + certReqCtxLen + CERT_HEADER_SZ +
  6929. CERT_HEADER_SZ;
  6930. ret = TLSX_GetResponseSize(ssl, certificate, &extSz);
  6931. if (ret < 0)
  6932. return ret;
  6933. /* Create extensions' data if none already present. */
  6934. if (extSz > OPAQUE16_LEN && ssl->buffers.certExts == NULL) {
  6935. ret = AllocDer(&ssl->buffers.certExts, extSz, CERT_TYPE, ssl->heap);
  6936. if (ret < 0)
  6937. return ret;
  6938. extSz = 0;
  6939. ret = TLSX_WriteResponse(ssl, ssl->buffers.certExts->buffer,
  6940. certificate, &extSz);
  6941. if (ret < 0)
  6942. return ret;
  6943. }
  6944. /* Length of message data with one certificate and extensions. */
  6945. length = headerSz + certSz + extSz;
  6946. /* Length of list data with one certificate and extensions. */
  6947. listSz = CERT_HEADER_SZ + certSz + extSz;
  6948. /* Send rest of chain if sending cert (chain has leading size/s). */
  6949. if (certSz > 0 && ssl->buffers.certChainCnt > 0) {
  6950. p = ssl->buffers.certChain->buffer;
  6951. /* Chain length including extensions. */
  6952. certChainSz = ssl->buffers.certChain->length +
  6953. OPAQUE16_LEN * ssl->buffers.certChainCnt;
  6954. length += certChainSz;
  6955. listSz += certChainSz;
  6956. }
  6957. else
  6958. certChainSz = 0;
  6959. }
  6960. payloadSz = length;
  6961. if (ssl->fragOffset != 0)
  6962. length -= (ssl->fragOffset + headerSz);
  6963. maxFragment = wolfSSL_GetMaxFragSize(ssl, MAX_RECORD_SIZE);
  6964. while (length > 0 && ret == 0) {
  6965. byte* output = NULL;
  6966. word32 fragSz = 0;
  6967. word32 i = RECORD_HEADER_SZ;
  6968. int sendSz = RECORD_HEADER_SZ;
  6969. #ifdef WOLFSSL_DTLS13
  6970. if (ssl->options.dtls) {
  6971. i = Dtls13GetRlHeaderLength(ssl, 1);
  6972. sendSz = (int)i;
  6973. }
  6974. #endif /* WOLFSSL_DTLS13 */
  6975. if (ssl->fragOffset == 0) {
  6976. if (headerSz + certSz + extSz + certChainSz <=
  6977. maxFragment - HANDSHAKE_HEADER_SZ) {
  6978. fragSz = headerSz + certSz + extSz + certChainSz;
  6979. }
  6980. #ifdef WOLFSSL_DTLS13
  6981. else if (ssl->options.dtls){
  6982. /* short-circuit the fragmentation logic here. DTLS
  6983. fragmentation will be done in dtls13HandshakeSend() */
  6984. fragSz = headerSz + certSz + extSz + certChainSz;
  6985. }
  6986. #endif /* WOLFSSL_DTLS13 */
  6987. else {
  6988. fragSz = maxFragment - HANDSHAKE_HEADER_SZ;
  6989. }
  6990. sendSz += fragSz + HANDSHAKE_HEADER_SZ;
  6991. i += HANDSHAKE_HEADER_SZ;
  6992. #ifdef WOLFSSL_DTLS13
  6993. if (ssl->options.dtls) {
  6994. sendSz += DTLS_HANDSHAKE_EXTRA;
  6995. i += DTLS_HANDSHAKE_EXTRA;
  6996. }
  6997. #endif /* WOLFSSL_DTLS13 */
  6998. }
  6999. else {
  7000. fragSz = min(length, maxFragment);
  7001. sendSz += fragSz;
  7002. }
  7003. sendSz += MAX_MSG_EXTRA;
  7004. /* Check buffers are big enough and grow if needed. */
  7005. if ((ret = CheckAvailableSize(ssl, sendSz)) != 0)
  7006. return ret;
  7007. /* Get position in output buffer to write new message to. */
  7008. output = ssl->buffers.outputBuffer.buffer +
  7009. ssl->buffers.outputBuffer.length;
  7010. if (ssl->fragOffset == 0) {
  7011. AddTls13FragHeaders(output, fragSz, 0, payloadSz, certificate, ssl);
  7012. /* Request context. */
  7013. output[i++] = certReqCtxLen;
  7014. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  7015. if (certReqCtxLen > 0) {
  7016. XMEMCPY(output + i, certReqCtx, certReqCtxLen);
  7017. i += certReqCtxLen;
  7018. }
  7019. #endif
  7020. length -= OPAQUE8_LEN + certReqCtxLen;
  7021. fragSz -= OPAQUE8_LEN + certReqCtxLen;
  7022. /* Certificate list length. */
  7023. c32to24(listSz, output + i);
  7024. i += CERT_HEADER_SZ;
  7025. length -= CERT_HEADER_SZ;
  7026. fragSz -= CERT_HEADER_SZ;
  7027. /* Leaf certificate data length. */
  7028. if (certSz > 0) {
  7029. c32to24(certSz, output + i);
  7030. i += CERT_HEADER_SZ;
  7031. length -= CERT_HEADER_SZ;
  7032. fragSz -= CERT_HEADER_SZ;
  7033. }
  7034. }
  7035. else
  7036. AddTls13RecordHeader(output, fragSz, handshake, ssl);
  7037. if (certSz > 0 && ssl->fragOffset < certSz + extSz) {
  7038. /* Put in the leaf certificate with extensions. */
  7039. word32 copySz = AddCertExt(ssl, ssl->buffers.certificate->buffer,
  7040. certSz, extSz, ssl->fragOffset, fragSz, output + i);
  7041. i += copySz;
  7042. ssl->fragOffset += copySz;
  7043. length -= copySz;
  7044. fragSz -= copySz;
  7045. if (ssl->fragOffset == certSz + extSz)
  7046. FreeDer(&ssl->buffers.certExts);
  7047. }
  7048. if (certChainSz > 0 && fragSz > 0) {
  7049. /* Put in the CA certificates with empty extensions. */
  7050. while (fragSz > 0) {
  7051. word32 l;
  7052. if (offset == len + OPAQUE16_LEN) {
  7053. /* Find next CA certificate to write out. */
  7054. offset = 0;
  7055. /* Point to the start of current cert in chain buffer. */
  7056. p = ssl->buffers.certChain->buffer + idx;
  7057. len = NextCert(ssl->buffers.certChain->buffer,
  7058. ssl->buffers.certChain->length, &idx);
  7059. if (len == 0)
  7060. break;
  7061. }
  7062. /* Write out certificate and empty extension. */
  7063. l = AddCertExt(ssl, p, len, OPAQUE16_LEN, offset, fragSz,
  7064. output + i);
  7065. i += l;
  7066. ssl->fragOffset += l;
  7067. length -= l;
  7068. fragSz -= l;
  7069. offset += l;
  7070. }
  7071. }
  7072. if ((int)i - RECORD_HEADER_SZ < 0) {
  7073. WOLFSSL_MSG("Send Cert bad inputSz");
  7074. return BUFFER_E;
  7075. }
  7076. #ifdef WOLFSSL_DTLS13
  7077. if (ssl->options.dtls) {
  7078. /* DTLS1.3 uses a separate variable and logic for fragments */
  7079. ssl->options.buildingMsg = 0;
  7080. ssl->fragOffset = 0;
  7081. ret = Dtls13HandshakeSend(ssl, output, (word16)sendSz, (word16)i,
  7082. certificate, 1);
  7083. }
  7084. else
  7085. #endif /* WOLFSSL_DTLS13 */
  7086. {
  7087. /* This message is always encrypted. */
  7088. sendSz = BuildTls13Message(ssl, output, sendSz,
  7089. output + RECORD_HEADER_SZ, i - RECORD_HEADER_SZ, handshake, 1,
  7090. 0, 0);
  7091. if (sendSz < 0)
  7092. return sendSz;
  7093. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  7094. if (ssl->hsInfoOn)
  7095. AddPacketName(ssl, "Certificate");
  7096. if (ssl->toInfoOn) {
  7097. ret = AddPacketInfo(ssl, "Certificate", handshake, output,
  7098. sendSz, WRITE_PROTO, 0, ssl->heap);
  7099. if (ret != 0)
  7100. return ret;
  7101. }
  7102. #endif
  7103. ssl->buffers.outputBuffer.length += sendSz;
  7104. ssl->options.buildingMsg = 0;
  7105. if (!ssl->options.groupMessages)
  7106. ret = SendBuffered(ssl);
  7107. }
  7108. }
  7109. if (ret != WANT_WRITE) {
  7110. /* Clean up the fragment offset. */
  7111. ssl->options.buildingMsg = 0;
  7112. ssl->fragOffset = 0;
  7113. if (ssl->options.side == WOLFSSL_SERVER_END)
  7114. ssl->options.serverState = SERVER_CERT_COMPLETE;
  7115. }
  7116. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  7117. if (ssl->options.side == WOLFSSL_CLIENT_END && ssl->certReqCtx != NULL) {
  7118. CertReqCtx* ctx = ssl->certReqCtx;
  7119. ssl->certReqCtx = ssl->certReqCtx->next;
  7120. XFREE(ctx, ssl->heap, DYNAMIC_TYPE_TMP_BUFFER);
  7121. }
  7122. #endif
  7123. WOLFSSL_LEAVE("SendTls13Certificate", ret);
  7124. WOLFSSL_END(WC_FUNC_CERTIFICATE_SEND);
  7125. return ret;
  7126. }
  7127. #if (!defined(NO_RSA) || defined(HAVE_ECC) || defined(HAVE_ED25519) || \
  7128. defined(HAVE_ED448) || defined(HAVE_PQC)) && \
  7129. (!defined(NO_WOLFSSL_SERVER) || !defined(WOLFSSL_NO_CLIENT_AUTH))
  7130. typedef struct Scv13Args {
  7131. byte* output; /* not allocated */
  7132. byte* verify; /* not allocated */
  7133. word32 idx;
  7134. word32 sigLen;
  7135. int sendSz;
  7136. word16 length;
  7137. byte sigAlgo;
  7138. byte* sigData;
  7139. word16 sigDataSz;
  7140. } Scv13Args;
  7141. static void FreeScv13Args(WOLFSSL* ssl, void* pArgs)
  7142. {
  7143. Scv13Args* args = (Scv13Args*)pArgs;
  7144. (void)ssl;
  7145. if (args && args->sigData) {
  7146. XFREE(args->sigData, ssl->heap, DYNAMIC_TYPE_SIGNATURE);
  7147. args->sigData = NULL;
  7148. }
  7149. }
  7150. /* handle generation TLS v1.3 certificate_verify (15) */
  7151. /* Send the TLS v1.3 CertificateVerify message.
  7152. * A hash of all the message so far is used.
  7153. * The signed data is:
  7154. * 0x20 * 64 | context string | 0x00 | hash of messages
  7155. * This message is always encrypted in TLS v1.3.
  7156. *
  7157. * ssl The SSL/TLS object.
  7158. * returns 0 on success, otherwise failure.
  7159. */
  7160. static int SendTls13CertificateVerify(WOLFSSL* ssl)
  7161. {
  7162. int ret = 0;
  7163. buffer* sig = &ssl->buffers.sig;
  7164. #ifdef WOLFSSL_ASYNC_CRYPT
  7165. Scv13Args* args = NULL;
  7166. WOLFSSL_ASSERT_SIZEOF_GE(ssl->async->args, *args);
  7167. #else
  7168. Scv13Args args[1];
  7169. #endif
  7170. #ifdef WOLFSSL_DTLS13
  7171. int recordLayerHdrExtra;
  7172. #endif /* WOLFSSL_DTLS13 */
  7173. WOLFSSL_START(WC_FUNC_CERTIFICATE_VERIFY_SEND);
  7174. WOLFSSL_ENTER("SendTls13CertificateVerify");
  7175. ssl->options.buildingMsg = 1;
  7176. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  7177. ret = tsip_Tls13SendCertVerify(ssl);
  7178. if (ret != CRYPTOCB_UNAVAILABLE) {
  7179. goto exit_scv;
  7180. }
  7181. ret = 0;
  7182. #endif /* WOLFSSL_RENESAS_TSIP_TLS && WOLFSSL_RENESAS_TSIP_VER >= 115 */
  7183. #ifdef WOLFSSL_DTLS13
  7184. /* can be negative */
  7185. if (ssl->options.dtls)
  7186. recordLayerHdrExtra = Dtls13GetRlHeaderLength(ssl, 1) - RECORD_HEADER_SZ;
  7187. else
  7188. recordLayerHdrExtra = 0;
  7189. #endif /* WOLFSSL_DTLS13 */
  7190. #ifdef WOLFSSL_ASYNC_CRYPT
  7191. if (ssl->async == NULL) {
  7192. ssl->async = (struct WOLFSSL_ASYNC*)
  7193. XMALLOC(sizeof(struct WOLFSSL_ASYNC), ssl->heap,
  7194. DYNAMIC_TYPE_ASYNC);
  7195. if (ssl->async == NULL)
  7196. ERROR_OUT(MEMORY_E, exit_scv);
  7197. }
  7198. args = (Scv13Args*)ssl->async->args;
  7199. ret = wolfSSL_AsyncPop(ssl, &ssl->options.asyncState);
  7200. if (ret != WC_NOT_PENDING_E) {
  7201. /* Check for error */
  7202. if (ret < 0)
  7203. goto exit_scv;
  7204. }
  7205. else
  7206. #endif
  7207. {
  7208. /* Reset state */
  7209. ret = 0;
  7210. ssl->options.asyncState = TLS_ASYNC_BEGIN;
  7211. XMEMSET(args, 0, sizeof(Scv13Args));
  7212. #ifdef WOLFSSL_ASYNC_CRYPT
  7213. ssl->async->freeArgs = FreeScv13Args;
  7214. #endif
  7215. }
  7216. switch(ssl->options.asyncState)
  7217. {
  7218. case TLS_ASYNC_BEGIN:
  7219. {
  7220. if (ssl->options.sendVerify == SEND_BLANK_CERT) {
  7221. return 0; /* sent blank cert, can't verify */
  7222. }
  7223. args->sendSz = MAX_CERT_VERIFY_SZ + MAX_MSG_EXTRA;
  7224. /* Always encrypted. */
  7225. args->sendSz += MAX_MSG_EXTRA;
  7226. /* check for available size */
  7227. if ((ret = CheckAvailableSize(ssl, args->sendSz)) != 0) {
  7228. goto exit_scv;
  7229. }
  7230. /* get output buffer */
  7231. args->output = ssl->buffers.outputBuffer.buffer +
  7232. ssl->buffers.outputBuffer.length;
  7233. /* Advance state and proceed */
  7234. ssl->options.asyncState = TLS_ASYNC_BUILD;
  7235. } /* case TLS_ASYNC_BEGIN */
  7236. FALL_THROUGH;
  7237. case TLS_ASYNC_BUILD:
  7238. {
  7239. int rem = ssl->buffers.outputBuffer.bufferSize
  7240. - ssl->buffers.outputBuffer.length
  7241. - RECORD_HEADER_SZ - HANDSHAKE_HEADER_SZ;
  7242. /* idx is used to track verify pointer offset to output */
  7243. args->idx = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  7244. args->verify =
  7245. &args->output[RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ];
  7246. #ifdef WOLFSSL_DTLS13
  7247. if (ssl->options.dtls) {
  7248. rem -= recordLayerHdrExtra + DTLS_HANDSHAKE_EXTRA;
  7249. args->idx += recordLayerHdrExtra + DTLS_HANDSHAKE_EXTRA;
  7250. args->verify += recordLayerHdrExtra + DTLS_HANDSHAKE_EXTRA;
  7251. }
  7252. #endif /* WOLFSSL_DTLS13 */
  7253. if (ssl->buffers.key == NULL) {
  7254. #ifdef HAVE_PK_CALLBACKS
  7255. if (wolfSSL_CTX_IsPrivatePkSet(ssl->ctx))
  7256. args->length = GetPrivateKeySigSize(ssl);
  7257. else
  7258. #endif
  7259. ERROR_OUT(NO_PRIVATE_KEY, exit_scv);
  7260. }
  7261. else {
  7262. ret = DecodePrivateKey(ssl, &args->length);
  7263. if (ret != 0)
  7264. goto exit_scv;
  7265. }
  7266. if (rem < 0 || args->length > rem) {
  7267. ERROR_OUT(BUFFER_E, exit_scv);
  7268. }
  7269. if (args->length == 0) {
  7270. ERROR_OUT(NO_PRIVATE_KEY, exit_scv);
  7271. }
  7272. /* Add signature algorithm. */
  7273. if (ssl->hsType == DYNAMIC_TYPE_RSA)
  7274. args->sigAlgo = rsa_pss_sa_algo;
  7275. #ifdef HAVE_ECC
  7276. else if (ssl->hsType == DYNAMIC_TYPE_ECC)
  7277. args->sigAlgo = ecc_dsa_sa_algo;
  7278. #endif
  7279. #ifdef HAVE_ED25519
  7280. else if (ssl->hsType == DYNAMIC_TYPE_ED25519)
  7281. args->sigAlgo = ed25519_sa_algo;
  7282. #endif
  7283. #ifdef HAVE_ED448
  7284. else if (ssl->hsType == DYNAMIC_TYPE_ED448)
  7285. args->sigAlgo = ed448_sa_algo;
  7286. #endif
  7287. #if defined(HAVE_PQC)
  7288. #if defined(HAVE_FALCON)
  7289. else if (ssl->hsType == DYNAMIC_TYPE_FALCON) {
  7290. falcon_key* fkey = (falcon_key*)ssl->hsKey;
  7291. byte level = 0;
  7292. if (wc_falcon_get_level(fkey, &level) != 0) {
  7293. ERROR_OUT(ALGO_ID_E, exit_scv);
  7294. }
  7295. if (level == 1) {
  7296. args->sigAlgo = falcon_level1_sa_algo;
  7297. }
  7298. else if (level == 5) {
  7299. args->sigAlgo = falcon_level5_sa_algo;
  7300. }
  7301. else {
  7302. ERROR_OUT(ALGO_ID_E, exit_scv);
  7303. }
  7304. }
  7305. #endif /* HAVE_FALCON */
  7306. #if defined(HAVE_DILITHIUM)
  7307. else if (ssl->hsType == DYNAMIC_TYPE_DILITHIUM) {
  7308. dilithium_key* fkey = (dilithium_key*)ssl->hsKey;
  7309. byte level = 0;
  7310. if (wc_dilithium_get_level(fkey, &level) != 0) {
  7311. ERROR_OUT(ALGO_ID_E, exit_scv);
  7312. }
  7313. if (level == 2) {
  7314. args->sigAlgo = dilithium_level2_sa_algo;
  7315. }
  7316. else if (level == 3) {
  7317. args->sigAlgo = dilithium_level3_sa_algo;
  7318. }
  7319. else if (level == 5) {
  7320. args->sigAlgo = dilithium_level5_sa_algo;
  7321. }
  7322. else {
  7323. ERROR_OUT(ALGO_ID_E, exit_scv);
  7324. }
  7325. }
  7326. #endif /* HAVE_DILITHIUM */
  7327. #endif /* HAVE_PQC */
  7328. else {
  7329. ERROR_OUT(ALGO_ID_E, exit_scv);
  7330. }
  7331. EncodeSigAlg(ssl->options.hashAlgo, args->sigAlgo, args->verify);
  7332. if (ssl->hsType == DYNAMIC_TYPE_RSA) {
  7333. int sigLen = MAX_SIG_DATA_SZ;
  7334. if (args->length > MAX_SIG_DATA_SZ)
  7335. sigLen = args->length;
  7336. args->sigData = (byte*)XMALLOC(sigLen, ssl->heap,
  7337. DYNAMIC_TYPE_SIGNATURE);
  7338. }
  7339. else {
  7340. args->sigData = (byte*)XMALLOC(MAX_SIG_DATA_SZ, ssl->heap,
  7341. DYNAMIC_TYPE_SIGNATURE);
  7342. }
  7343. if (args->sigData == NULL) {
  7344. ERROR_OUT(MEMORY_E, exit_scv);
  7345. }
  7346. /* Create the data to be signed. */
  7347. ret = CreateSigData(ssl, args->sigData, &args->sigDataSz, 0);
  7348. if (ret != 0)
  7349. goto exit_scv;
  7350. #ifndef NO_RSA
  7351. if (ssl->hsType == DYNAMIC_TYPE_RSA) {
  7352. /* build encoded signature buffer */
  7353. sig->length = WC_MAX_DIGEST_SIZE;
  7354. sig->buffer = (byte*)XMALLOC(sig->length, ssl->heap,
  7355. DYNAMIC_TYPE_SIGNATURE);
  7356. if (sig->buffer == NULL) {
  7357. ERROR_OUT(MEMORY_E, exit_scv);
  7358. }
  7359. ret = CreateRSAEncodedSig(sig->buffer, args->sigData,
  7360. args->sigDataSz, args->sigAlgo, ssl->options.hashAlgo);
  7361. if (ret < 0)
  7362. goto exit_scv;
  7363. sig->length = ret;
  7364. ret = 0;
  7365. /* Maximum size of RSA Signature. */
  7366. args->sigLen = args->length;
  7367. }
  7368. #endif /* !NO_RSA */
  7369. #ifdef HAVE_ECC
  7370. if (ssl->hsType == DYNAMIC_TYPE_ECC) {
  7371. sig->length = args->sendSz - args->idx - HASH_SIG_SIZE -
  7372. VERIFY_HEADER;
  7373. ret = CreateECCEncodedSig(args->sigData,
  7374. args->sigDataSz, ssl->options.hashAlgo);
  7375. if (ret < 0)
  7376. goto exit_scv;
  7377. args->sigDataSz = (word16)ret;
  7378. ret = 0;
  7379. }
  7380. #endif /* HAVE_ECC */
  7381. #ifdef HAVE_ED25519
  7382. if (ssl->hsType == DYNAMIC_TYPE_ED25519) {
  7383. ret = Ed25519CheckPubKey(ssl);
  7384. if (ret < 0) {
  7385. ERROR_OUT(ret, exit_scv);
  7386. }
  7387. sig->length = ED25519_SIG_SIZE;
  7388. }
  7389. #endif /* HAVE_ED25519 */
  7390. #ifdef HAVE_ED448
  7391. if (ssl->hsType == DYNAMIC_TYPE_ED448) {
  7392. ret = Ed448CheckPubKey(ssl);
  7393. if (ret < 0) {
  7394. ERROR_OUT(ret, exit_scv);
  7395. }
  7396. sig->length = ED448_SIG_SIZE;
  7397. }
  7398. #endif /* HAVE_ED448 */
  7399. #if defined(HAVE_PQC)
  7400. #if defined(HAVE_FALCON)
  7401. if (ssl->hsType == DYNAMIC_TYPE_FALCON) {
  7402. sig->length = FALCON_MAX_SIG_SIZE;
  7403. }
  7404. #endif
  7405. #if defined(HAVE_DILITHIUM)
  7406. if (ssl->hsType == DYNAMIC_TYPE_DILITHIUM) {
  7407. sig->length = DILITHIUM_MAX_SIG_SIZE;
  7408. }
  7409. #endif
  7410. #endif /* HAVE_PQC */
  7411. /* Advance state and proceed */
  7412. ssl->options.asyncState = TLS_ASYNC_DO;
  7413. } /* case TLS_ASYNC_BUILD */
  7414. FALL_THROUGH;
  7415. case TLS_ASYNC_DO:
  7416. {
  7417. #ifdef HAVE_ECC
  7418. if (ssl->hsType == DYNAMIC_TYPE_ECC) {
  7419. ret = EccSign(ssl, args->sigData, args->sigDataSz,
  7420. args->verify + HASH_SIG_SIZE + VERIFY_HEADER,
  7421. (word32*)&sig->length, (ecc_key*)ssl->hsKey,
  7422. #ifdef HAVE_PK_CALLBACKS
  7423. ssl->buffers.key
  7424. #else
  7425. NULL
  7426. #endif
  7427. );
  7428. args->length = (word16)sig->length;
  7429. }
  7430. #endif /* HAVE_ECC */
  7431. #ifdef HAVE_ED25519
  7432. if (ssl->hsType == DYNAMIC_TYPE_ED25519) {
  7433. ret = Ed25519Sign(ssl, args->sigData, args->sigDataSz,
  7434. args->verify + HASH_SIG_SIZE + VERIFY_HEADER,
  7435. (word32*)&sig->length, (ed25519_key*)ssl->hsKey,
  7436. #ifdef HAVE_PK_CALLBACKS
  7437. ssl->buffers.key
  7438. #else
  7439. NULL
  7440. #endif
  7441. );
  7442. args->length = (word16)sig->length;
  7443. }
  7444. #endif
  7445. #ifdef HAVE_ED448
  7446. if (ssl->hsType == DYNAMIC_TYPE_ED448) {
  7447. ret = Ed448Sign(ssl, args->sigData, args->sigDataSz,
  7448. args->verify + HASH_SIG_SIZE + VERIFY_HEADER,
  7449. (word32*)&sig->length, (ed448_key*)ssl->hsKey,
  7450. #ifdef HAVE_PK_CALLBACKS
  7451. ssl->buffers.key
  7452. #else
  7453. NULL
  7454. #endif
  7455. );
  7456. args->length = (word16)sig->length;
  7457. }
  7458. #endif
  7459. #if defined(HAVE_PQC)
  7460. #if defined(HAVE_FALCON)
  7461. if (ssl->hsType == DYNAMIC_TYPE_FALCON) {
  7462. ret = wc_falcon_sign_msg(args->sigData, args->sigDataSz,
  7463. args->verify + HASH_SIG_SIZE +
  7464. VERIFY_HEADER, (word32*)&sig->length,
  7465. (falcon_key*)ssl->hsKey);
  7466. args->length = (word16)sig->length;
  7467. }
  7468. #endif
  7469. #if defined(HAVE_DILITHIUM)
  7470. if (ssl->hsType == DYNAMIC_TYPE_DILITHIUM) {
  7471. ret = wc_dilithium_sign_msg(args->sigData, args->sigDataSz,
  7472. args->verify + HASH_SIG_SIZE +
  7473. VERIFY_HEADER, (word32*)&sig->length,
  7474. (dilithium_key*)ssl->hsKey);
  7475. args->length = (word16)sig->length;
  7476. }
  7477. #endif
  7478. #endif /* HAVE_PQC */
  7479. #ifndef NO_RSA
  7480. if (ssl->hsType == DYNAMIC_TYPE_RSA) {
  7481. ret = RsaSign(ssl, sig->buffer, (word32)sig->length,
  7482. args->verify + HASH_SIG_SIZE + VERIFY_HEADER, &args->sigLen,
  7483. args->sigAlgo, ssl->options.hashAlgo,
  7484. (RsaKey*)ssl->hsKey,
  7485. ssl->buffers.key
  7486. );
  7487. if (ret == 0) {
  7488. args->length = (word16)args->sigLen;
  7489. XMEMCPY(args->sigData,
  7490. args->verify + HASH_SIG_SIZE + VERIFY_HEADER,
  7491. args->sigLen);
  7492. }
  7493. }
  7494. #endif /* !NO_RSA */
  7495. /* Check for error */
  7496. if (ret != 0) {
  7497. goto exit_scv;
  7498. }
  7499. /* Add signature length. */
  7500. c16toa(args->length, args->verify + HASH_SIG_SIZE);
  7501. /* Advance state and proceed */
  7502. ssl->options.asyncState = TLS_ASYNC_VERIFY;
  7503. } /* case TLS_ASYNC_DO */
  7504. FALL_THROUGH;
  7505. case TLS_ASYNC_VERIFY:
  7506. {
  7507. #ifndef NO_RSA
  7508. if (ssl->hsType == DYNAMIC_TYPE_RSA) {
  7509. /* check for signature faults */
  7510. ret = VerifyRsaSign(ssl, args->sigData, args->sigLen,
  7511. sig->buffer, (word32)sig->length, args->sigAlgo,
  7512. ssl->options.hashAlgo, (RsaKey*)ssl->hsKey,
  7513. ssl->buffers.key
  7514. );
  7515. }
  7516. #endif /* !NO_RSA */
  7517. #if defined(HAVE_ECC) && defined(WOLFSSL_CHECK_SIG_FAULTS)
  7518. if (ssl->hsType == DYNAMIC_TYPE_ECC) {
  7519. ret = EccVerify(ssl,
  7520. args->verify + HASH_SIG_SIZE + VERIFY_HEADER,
  7521. sig->length, args->sigData, args->sigDataSz,
  7522. (ecc_key*)ssl->hsKey,
  7523. #ifdef HAVE_PK_CALLBACKS
  7524. ssl->buffers.key
  7525. #else
  7526. NULL
  7527. #endif
  7528. );
  7529. }
  7530. #endif
  7531. /* Check for error */
  7532. if (ret != 0) {
  7533. goto exit_scv;
  7534. }
  7535. /* Advance state and proceed */
  7536. ssl->options.asyncState = TLS_ASYNC_FINALIZE;
  7537. } /* case TLS_ASYNC_VERIFY */
  7538. FALL_THROUGH;
  7539. case TLS_ASYNC_FINALIZE:
  7540. {
  7541. /* Put the record and handshake headers on. */
  7542. AddTls13Headers(args->output, args->length + HASH_SIG_SIZE +
  7543. VERIFY_HEADER, certificate_verify, ssl);
  7544. args->sendSz = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ +
  7545. args->length + HASH_SIG_SIZE + VERIFY_HEADER;
  7546. #ifdef WOLFSSL_DTLS13
  7547. if (ssl->options.dtls)
  7548. args->sendSz += recordLayerHdrExtra + DTLS_HANDSHAKE_EXTRA;
  7549. #endif /* WOLFSSL_DTLS13 */
  7550. /* Advance state and proceed */
  7551. ssl->options.asyncState = TLS_ASYNC_END;
  7552. } /* case TLS_ASYNC_FINALIZE */
  7553. FALL_THROUGH;
  7554. case TLS_ASYNC_END:
  7555. {
  7556. #ifdef WOLFSSL_DTLS13
  7557. if (ssl->options.dtls) {
  7558. ssl->options.buildingMsg = 0;
  7559. ret = Dtls13HandshakeSend(ssl, args->output,
  7560. MAX_CERT_VERIFY_SZ + MAX_MSG_EXTRA + MAX_MSG_EXTRA,
  7561. (word16)args->sendSz, certificate_verify, 1);
  7562. if (ret != 0)
  7563. goto exit_scv;
  7564. break;
  7565. }
  7566. #endif /* WOLFSSL_DTLS13 */
  7567. /* This message is always encrypted. */
  7568. ret = BuildTls13Message(ssl, args->output,
  7569. MAX_CERT_VERIFY_SZ + MAX_MSG_EXTRA,
  7570. args->output + RECORD_HEADER_SZ,
  7571. args->sendSz - RECORD_HEADER_SZ, handshake,
  7572. 1, 0, 0);
  7573. if (ret < 0) {
  7574. goto exit_scv;
  7575. }
  7576. else {
  7577. args->sendSz = ret;
  7578. ret = 0;
  7579. }
  7580. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  7581. if (ssl->hsInfoOn)
  7582. AddPacketName(ssl, "CertificateVerify");
  7583. if (ssl->toInfoOn) {
  7584. ret = AddPacketInfo(ssl, "CertificateVerify", handshake,
  7585. args->output, args->sendSz, WRITE_PROTO, 0,
  7586. ssl->heap);
  7587. if (ret != 0)
  7588. goto exit_scv;
  7589. }
  7590. #endif
  7591. ssl->buffers.outputBuffer.length += args->sendSz;
  7592. ssl->options.buildingMsg = 0;
  7593. if (!ssl->options.groupMessages)
  7594. ret = SendBuffered(ssl);
  7595. break;
  7596. }
  7597. default:
  7598. ret = INPUT_CASE_ERROR;
  7599. } /* switch(ssl->options.asyncState) */
  7600. exit_scv:
  7601. WOLFSSL_LEAVE("SendTls13CertificateVerify", ret);
  7602. WOLFSSL_END(WC_FUNC_CERTIFICATE_VERIFY_SEND);
  7603. #ifdef WOLFSSL_ASYNC_CRYPT
  7604. /* Handle async operation */
  7605. if (ret == WC_PENDING_E) {
  7606. return ret;
  7607. }
  7608. #endif /* WOLFSSL_ASYNC_CRYPT */
  7609. /* Final cleanup */
  7610. FreeScv13Args(ssl, args);
  7611. FreeKeyExchange(ssl);
  7612. #ifdef WOLFSSL_ASYNC_IO
  7613. /* Cleanup async */
  7614. FreeAsyncCtx(ssl, 0);
  7615. #endif
  7616. if (ret != 0) {
  7617. WOLFSSL_ERROR_VERBOSE(ret);
  7618. }
  7619. return ret;
  7620. }
  7621. #endif
  7622. #endif /* !NO_WOLFSSL_CLIENT || !NO_WOLFSSL_SERVER */
  7623. #if !defined(NO_WOLFSSL_CLIENT) || !defined(WOLFSSL_NO_CLIENT_AUTH)
  7624. /* handle processing TLS v1.3 certificate (11) */
  7625. /* Parse and handle a TLS v1.3 Certificate message.
  7626. *
  7627. * ssl The SSL/TLS object.
  7628. * input The message buffer.
  7629. * inOutIdx On entry, the index into the message buffer of Certificate.
  7630. * On exit, the index of byte after the Certificate message.
  7631. * totalSz The length of the current handshake message.
  7632. * returns 0 on success and otherwise failure.
  7633. */
  7634. static int DoTls13Certificate(WOLFSSL* ssl, byte* input, word32* inOutIdx,
  7635. word32 totalSz)
  7636. {
  7637. int ret = 0;
  7638. WOLFSSL_START(WC_FUNC_CERTIFICATE_DO);
  7639. WOLFSSL_ENTER("DoTls13Certificate");
  7640. #ifdef WOLFSSL_DTLS13
  7641. if (ssl->options.dtls && ssl->options.handShakeDone) {
  7642. /* certificate needs some special care after the handshake */
  7643. ret = Dtls13RtxProcessingCertificate(
  7644. ssl, input + *inOutIdx, totalSz);
  7645. }
  7646. #endif /* WOLFSSL_DTLS13 */
  7647. if (ret == 0)
  7648. ret = ProcessPeerCerts(ssl, input, inOutIdx, totalSz);
  7649. if (ret == 0) {
  7650. #if !defined(NO_WOLFSSL_CLIENT)
  7651. if (ssl->options.side == WOLFSSL_CLIENT_END)
  7652. ssl->options.serverState = SERVER_CERT_COMPLETE;
  7653. #endif
  7654. #if !defined(NO_WOLFSSL_SERVER) && defined(WOLFSSL_POST_HANDSHAKE_AUTH)
  7655. if (ssl->options.side == WOLFSSL_SERVER_END &&
  7656. ssl->options.handShakeState == HANDSHAKE_DONE) {
  7657. /* reset handshake states */
  7658. ssl->options.serverState = SERVER_FINISHED_COMPLETE;
  7659. ssl->options.acceptState = TICKET_SENT;
  7660. ssl->options.handShakeState = SERVER_FINISHED_COMPLETE;
  7661. }
  7662. #endif
  7663. }
  7664. WOLFSSL_LEAVE("DoTls13Certificate", ret);
  7665. WOLFSSL_END(WC_FUNC_CERTIFICATE_DO);
  7666. return ret;
  7667. }
  7668. #endif
  7669. #if !defined(NO_RSA) || defined(HAVE_ECC) || defined(HAVE_ED25519) || \
  7670. defined(HAVE_ED448)
  7671. typedef struct Dcv13Args {
  7672. byte* output; /* not allocated */
  7673. word32 sendSz;
  7674. word16 sz;
  7675. word32 sigSz;
  7676. word32 idx;
  7677. word32 begin;
  7678. byte hashAlgo;
  7679. byte sigAlgo;
  7680. byte* sigData;
  7681. word16 sigDataSz;
  7682. } Dcv13Args;
  7683. static void FreeDcv13Args(WOLFSSL* ssl, void* pArgs)
  7684. {
  7685. Dcv13Args* args = (Dcv13Args*)pArgs;
  7686. if (args && args->sigData != NULL) {
  7687. XFREE(args->sigData, ssl->heap, DYNAMIC_TYPE_SIGNATURE);
  7688. args->sigData = NULL;
  7689. }
  7690. (void)ssl;
  7691. }
  7692. /* handle processing TLS v1.3 certificate_verify (15) */
  7693. /* Parse and handle a TLS v1.3 CertificateVerify message.
  7694. *
  7695. * ssl The SSL/TLS object.
  7696. * input The message buffer.
  7697. * inOutIdx On entry, the index into the message buffer of
  7698. * CertificateVerify.
  7699. * On exit, the index of byte after the CertificateVerify message.
  7700. * totalSz The length of the current handshake message.
  7701. * returns 0 on success and otherwise failure.
  7702. */
  7703. static int DoTls13CertificateVerify(WOLFSSL* ssl, byte* input,
  7704. word32* inOutIdx, word32 totalSz)
  7705. {
  7706. int ret = 0;
  7707. buffer* sig = &ssl->buffers.sig;
  7708. #ifdef WOLFSSL_ASYNC_CRYPT
  7709. Dcv13Args* args = NULL;
  7710. WOLFSSL_ASSERT_SIZEOF_GE(ssl->async->args, *args);
  7711. #else
  7712. Dcv13Args args[1];
  7713. #endif
  7714. WOLFSSL_START(WC_FUNC_CERTIFICATE_VERIFY_DO);
  7715. WOLFSSL_ENTER("DoTls13CertificateVerify");
  7716. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  7717. ret = tsip_Tls13CertificateVerify(ssl, input, inOutIdx, totalSz);
  7718. if (ret != CRYPTOCB_UNAVAILABLE) {
  7719. goto exit_dcv;
  7720. }
  7721. ret = 0;
  7722. #endif
  7723. #ifdef WOLFSSL_ASYNC_CRYPT
  7724. if (ssl->async == NULL) {
  7725. ssl->async = (struct WOLFSSL_ASYNC*)
  7726. XMALLOC(sizeof(struct WOLFSSL_ASYNC), ssl->heap,
  7727. DYNAMIC_TYPE_ASYNC);
  7728. if (ssl->async == NULL)
  7729. ERROR_OUT(MEMORY_E, exit_dcv);
  7730. }
  7731. args = (Dcv13Args*)ssl->async->args;
  7732. ret = wolfSSL_AsyncPop(ssl, &ssl->options.asyncState);
  7733. if (ret != WC_NOT_PENDING_E) {
  7734. /* Check for error */
  7735. if (ret < 0)
  7736. goto exit_dcv;
  7737. }
  7738. else
  7739. #endif
  7740. {
  7741. /* Reset state */
  7742. ret = 0;
  7743. ssl->options.asyncState = TLS_ASYNC_BEGIN;
  7744. XMEMSET(args, 0, sizeof(Dcv13Args));
  7745. args->hashAlgo = sha_mac;
  7746. args->sigAlgo = anonymous_sa_algo;
  7747. args->idx = *inOutIdx;
  7748. args->begin = *inOutIdx;
  7749. #ifdef WOLFSSL_ASYNC_CRYPT
  7750. ssl->async->freeArgs = FreeDcv13Args;
  7751. #endif
  7752. }
  7753. switch(ssl->options.asyncState)
  7754. {
  7755. case TLS_ASYNC_BEGIN:
  7756. {
  7757. #ifdef WOLFSSL_CALLBACKS
  7758. if (ssl->hsInfoOn) AddPacketName(ssl, "CertificateVerify");
  7759. if (ssl->toInfoOn) AddLateName("CertificateVerify",
  7760. &ssl->timeoutInfo);
  7761. #endif
  7762. /* Advance state and proceed */
  7763. ssl->options.asyncState = TLS_ASYNC_BUILD;
  7764. } /* case TLS_ASYNC_BEGIN */
  7765. FALL_THROUGH;
  7766. case TLS_ASYNC_BUILD:
  7767. {
  7768. int validSigAlgo;
  7769. /* Signature algorithm. */
  7770. if ((args->idx - args->begin) + ENUM_LEN + ENUM_LEN > totalSz) {
  7771. ERROR_OUT(BUFFER_ERROR, exit_dcv);
  7772. }
  7773. ret = DecodeTls13SigAlg(input + args->idx, &args->hashAlgo,
  7774. &args->sigAlgo);
  7775. if (ret < 0)
  7776. goto exit_dcv;
  7777. args->idx += OPAQUE16_LEN;
  7778. /* Signature length. */
  7779. if ((args->idx - args->begin) + OPAQUE16_LEN > totalSz) {
  7780. ERROR_OUT(BUFFER_ERROR, exit_dcv);
  7781. }
  7782. ato16(input + args->idx, &args->sz);
  7783. args->idx += OPAQUE16_LEN;
  7784. /* Signature data. */
  7785. if ((args->idx - args->begin) + args->sz > totalSz ||
  7786. args->sz > ENCRYPT_LEN) {
  7787. ERROR_OUT(BUFFER_ERROR, exit_dcv);
  7788. }
  7789. /* Check for public key of required type. */
  7790. /* Assume invalid unless signature algo matches the key provided */
  7791. validSigAlgo = 0;
  7792. #ifdef HAVE_ED25519
  7793. if (args->sigAlgo == ed25519_sa_algo) {
  7794. WOLFSSL_MSG("Peer sent ED25519 sig");
  7795. validSigAlgo = (ssl->peerEd25519Key != NULL) &&
  7796. ssl->peerEd25519KeyPresent;
  7797. }
  7798. #endif
  7799. #ifdef HAVE_ED448
  7800. if (args->sigAlgo == ed448_sa_algo) {
  7801. WOLFSSL_MSG("Peer sent ED448 sig");
  7802. validSigAlgo = (ssl->peerEd448Key != NULL) &&
  7803. ssl->peerEd448KeyPresent;
  7804. }
  7805. #endif
  7806. #ifdef HAVE_ECC
  7807. if (args->sigAlgo == ecc_dsa_sa_algo) {
  7808. WOLFSSL_MSG("Peer sent ECC sig");
  7809. validSigAlgo = (ssl->peerEccDsaKey != NULL) &&
  7810. ssl->peerEccDsaKeyPresent;
  7811. }
  7812. #endif
  7813. #ifdef HAVE_PQC
  7814. if (args->sigAlgo == falcon_level1_sa_algo) {
  7815. WOLFSSL_MSG("Peer sent Falcon Level 1 sig");
  7816. validSigAlgo = (ssl->peerFalconKey != NULL) &&
  7817. ssl->peerFalconKeyPresent;
  7818. }
  7819. if (args->sigAlgo == falcon_level5_sa_algo) {
  7820. WOLFSSL_MSG("Peer sent Falcon Level 5 sig");
  7821. validSigAlgo = (ssl->peerFalconKey != NULL) &&
  7822. ssl->peerFalconKeyPresent;
  7823. }
  7824. if (args->sigAlgo == dilithium_level2_sa_algo) {
  7825. WOLFSSL_MSG("Peer sent Dilithium Level 2 sig");
  7826. validSigAlgo = (ssl->peerDilithiumKey != NULL) &&
  7827. ssl->peerDilithiumKeyPresent;
  7828. }
  7829. if (args->sigAlgo == dilithium_level3_sa_algo) {
  7830. WOLFSSL_MSG("Peer sent Dilithium Level 3 sig");
  7831. validSigAlgo = (ssl->peerDilithiumKey != NULL) &&
  7832. ssl->peerDilithiumKeyPresent;
  7833. }
  7834. if (args->sigAlgo == dilithium_level5_sa_algo) {
  7835. WOLFSSL_MSG("Peer sent Dilithium Level 5 sig");
  7836. validSigAlgo = (ssl->peerDilithiumKey != NULL) &&
  7837. ssl->peerDilithiumKeyPresent;
  7838. }
  7839. #endif
  7840. #ifndef NO_RSA
  7841. if (args->sigAlgo == rsa_sa_algo) {
  7842. WOLFSSL_MSG("Peer sent PKCS#1.5 algo - not valid TLS 1.3");
  7843. ERROR_OUT(INVALID_PARAMETER, exit_dcv);
  7844. }
  7845. if (args->sigAlgo == rsa_pss_sa_algo) {
  7846. WOLFSSL_MSG("Peer sent RSA sig");
  7847. validSigAlgo = (ssl->peerRsaKey != NULL) &&
  7848. ssl->peerRsaKeyPresent;
  7849. }
  7850. #endif
  7851. if (!validSigAlgo) {
  7852. WOLFSSL_MSG("Sig algo doesn't correspond to certficate");
  7853. ERROR_OUT(SIG_VERIFY_E, exit_dcv);
  7854. }
  7855. sig->buffer = (byte*)XMALLOC(args->sz, ssl->heap,
  7856. DYNAMIC_TYPE_SIGNATURE);
  7857. if (sig->buffer == NULL) {
  7858. ERROR_OUT(MEMORY_E, exit_dcv);
  7859. }
  7860. sig->length = args->sz;
  7861. XMEMCPY(sig->buffer, input + args->idx, args->sz);
  7862. #ifdef HAVE_ECC
  7863. if (ssl->peerEccDsaKeyPresent) {
  7864. WOLFSSL_MSG("Doing ECC peer cert verify");
  7865. args->sigData = (byte*)XMALLOC(MAX_SIG_DATA_SZ, ssl->heap,
  7866. DYNAMIC_TYPE_SIGNATURE);
  7867. if (args->sigData == NULL) {
  7868. ERROR_OUT(MEMORY_E, exit_dcv);
  7869. }
  7870. ret = CreateSigData(ssl, args->sigData, &args->sigDataSz, 1);
  7871. if (ret != 0)
  7872. goto exit_dcv;
  7873. ret = CreateECCEncodedSig(args->sigData,
  7874. args->sigDataSz, args->hashAlgo);
  7875. if (ret < 0)
  7876. goto exit_dcv;
  7877. args->sigDataSz = (word16)ret;
  7878. ret = 0;
  7879. }
  7880. #endif
  7881. #ifdef HAVE_ED25519
  7882. if (ssl->peerEd25519KeyPresent) {
  7883. WOLFSSL_MSG("Doing ED25519 peer cert verify");
  7884. args->sigData = (byte*)XMALLOC(MAX_SIG_DATA_SZ, ssl->heap,
  7885. DYNAMIC_TYPE_SIGNATURE);
  7886. if (args->sigData == NULL) {
  7887. ERROR_OUT(MEMORY_E, exit_dcv);
  7888. }
  7889. CreateSigData(ssl, args->sigData, &args->sigDataSz, 1);
  7890. ret = 0;
  7891. }
  7892. #endif
  7893. #ifdef HAVE_ED448
  7894. if (ssl->peerEd448KeyPresent) {
  7895. WOLFSSL_MSG("Doing ED448 peer cert verify");
  7896. args->sigData = (byte*)XMALLOC(MAX_SIG_DATA_SZ, ssl->heap,
  7897. DYNAMIC_TYPE_SIGNATURE);
  7898. if (args->sigData == NULL) {
  7899. ERROR_OUT(MEMORY_E, exit_dcv);
  7900. }
  7901. CreateSigData(ssl, args->sigData, &args->sigDataSz, 1);
  7902. ret = 0;
  7903. }
  7904. #endif
  7905. #ifdef HAVE_PQC
  7906. if (ssl->peerFalconKeyPresent) {
  7907. WOLFSSL_MSG("Doing Falcon peer cert verify");
  7908. args->sigData = (byte*)XMALLOC(MAX_SIG_DATA_SZ, ssl->heap,
  7909. DYNAMIC_TYPE_SIGNATURE);
  7910. if (args->sigData == NULL) {
  7911. ERROR_OUT(MEMORY_E, exit_dcv);
  7912. }
  7913. CreateSigData(ssl, args->sigData, &args->sigDataSz, 1);
  7914. ret = 0;
  7915. }
  7916. if (ssl->peerDilithiumKeyPresent) {
  7917. WOLFSSL_MSG("Doing Dilithium peer cert verify");
  7918. args->sigData = (byte*)XMALLOC(MAX_SIG_DATA_SZ, ssl->heap,
  7919. DYNAMIC_TYPE_SIGNATURE);
  7920. if (args->sigData == NULL) {
  7921. ERROR_OUT(MEMORY_E, exit_dcv);
  7922. }
  7923. CreateSigData(ssl, args->sigData, &args->sigDataSz, 1);
  7924. ret = 0;
  7925. }
  7926. #endif
  7927. /* Advance state and proceed */
  7928. ssl->options.asyncState = TLS_ASYNC_DO;
  7929. } /* case TLS_ASYNC_BUILD */
  7930. FALL_THROUGH;
  7931. case TLS_ASYNC_DO:
  7932. {
  7933. #ifndef NO_RSA
  7934. if (ssl->peerRsaKey != NULL && ssl->peerRsaKeyPresent != 0) {
  7935. ret = RsaVerify(ssl, sig->buffer, (word32)sig->length, &args->output,
  7936. args->sigAlgo, args->hashAlgo, ssl->peerRsaKey,
  7937. #ifdef HAVE_PK_CALLBACKS
  7938. &ssl->buffers.peerRsaKey
  7939. #else
  7940. NULL
  7941. #endif
  7942. );
  7943. if (ret >= 0) {
  7944. args->sendSz = ret;
  7945. ret = 0;
  7946. }
  7947. }
  7948. #endif /* !NO_RSA */
  7949. #ifdef HAVE_ECC
  7950. if (ssl->peerEccDsaKeyPresent) {
  7951. ret = EccVerify(ssl, input + args->idx, args->sz,
  7952. args->sigData, args->sigDataSz,
  7953. ssl->peerEccDsaKey,
  7954. #ifdef HAVE_PK_CALLBACKS
  7955. &ssl->buffers.peerEccDsaKey
  7956. #else
  7957. NULL
  7958. #endif
  7959. );
  7960. if (ret >= 0) {
  7961. /* CLIENT/SERVER: data verified with public key from
  7962. * certificate. */
  7963. ssl->options.peerAuthGood = 1;
  7964. FreeKey(ssl, DYNAMIC_TYPE_ECC, (void**)&ssl->peerEccDsaKey);
  7965. ssl->peerEccDsaKeyPresent = 0;
  7966. }
  7967. }
  7968. #endif /* HAVE_ECC */
  7969. #ifdef HAVE_ED25519
  7970. if (ssl->peerEd25519KeyPresent) {
  7971. ret = Ed25519Verify(ssl, input + args->idx, args->sz,
  7972. args->sigData, args->sigDataSz,
  7973. ssl->peerEd25519Key,
  7974. #ifdef HAVE_PK_CALLBACKS
  7975. &ssl->buffers.peerEd25519Key
  7976. #else
  7977. NULL
  7978. #endif
  7979. );
  7980. if (ret >= 0) {
  7981. /* CLIENT/SERVER: data verified with public key from
  7982. * certificate. */
  7983. ssl->options.peerAuthGood = 1;
  7984. FreeKey(ssl, DYNAMIC_TYPE_ED25519,
  7985. (void**)&ssl->peerEd25519Key);
  7986. ssl->peerEd25519KeyPresent = 0;
  7987. }
  7988. }
  7989. #endif
  7990. #ifdef HAVE_ED448
  7991. if (ssl->peerEd448KeyPresent) {
  7992. ret = Ed448Verify(ssl, input + args->idx, args->sz,
  7993. args->sigData, args->sigDataSz,
  7994. ssl->peerEd448Key,
  7995. #ifdef HAVE_PK_CALLBACKS
  7996. &ssl->buffers.peerEd448Key
  7997. #else
  7998. NULL
  7999. #endif
  8000. );
  8001. if (ret >= 0) {
  8002. /* CLIENT/SERVER: data verified with public key from
  8003. * certificate. */
  8004. ssl->options.peerAuthGood = 1;
  8005. FreeKey(ssl, DYNAMIC_TYPE_ED448,
  8006. (void**)&ssl->peerEd448Key);
  8007. ssl->peerEd448KeyPresent = 0;
  8008. }
  8009. }
  8010. #endif
  8011. #if defined(HAVE_PQC) && defined(HAVE_FALCON)
  8012. if (ssl->peerFalconKeyPresent) {
  8013. int res = 0;
  8014. WOLFSSL_MSG("Doing Falcon peer cert verify");
  8015. ret = wc_falcon_verify_msg(input + args->idx, args->sz,
  8016. args->sigData, args->sigDataSz,
  8017. &res, ssl->peerFalconKey);
  8018. if ((ret >= 0) && (res == 1)) {
  8019. /* CLIENT/SERVER: data verified with public key from
  8020. * certificate. */
  8021. ssl->options.peerAuthGood = 1;
  8022. FreeKey(ssl, DYNAMIC_TYPE_FALCON,
  8023. (void**)&ssl->peerFalconKey);
  8024. ssl->peerFalconKeyPresent = 0;
  8025. }
  8026. }
  8027. #endif /* HAVE_PQC && HAVE_FALCON */
  8028. #if defined(HAVE_PQC) && defined(HAVE_DILITHIUM)
  8029. if (ssl->peerDilithiumKeyPresent) {
  8030. int res = 0;
  8031. WOLFSSL_MSG("Doing Dilithium peer cert verify");
  8032. ret = wc_dilithium_verify_msg(input + args->idx, args->sz,
  8033. args->sigData, args->sigDataSz,
  8034. &res, ssl->peerDilithiumKey);
  8035. if ((ret >= 0) && (res == 1)) {
  8036. /* CLIENT/SERVER: data verified with public key from
  8037. * certificate. */
  8038. ssl->options.peerAuthGood = 1;
  8039. FreeKey(ssl, DYNAMIC_TYPE_DILITHIUM,
  8040. (void**)&ssl->peerDilithiumKey);
  8041. ssl->peerDilithiumKeyPresent = 0;
  8042. }
  8043. }
  8044. #endif /* HAVE_PQC && HAVE_DILITHIUM */
  8045. /* Check for error */
  8046. if (ret != 0) {
  8047. goto exit_dcv;
  8048. }
  8049. /* Advance state and proceed */
  8050. ssl->options.asyncState = TLS_ASYNC_VERIFY;
  8051. } /* case TLS_ASYNC_DO */
  8052. FALL_THROUGH;
  8053. case TLS_ASYNC_VERIFY:
  8054. {
  8055. #if !defined(NO_RSA) && defined(WC_RSA_PSS)
  8056. if (ssl->peerRsaKey != NULL && ssl->peerRsaKeyPresent != 0) {
  8057. ret = CheckRSASignature(ssl, args->sigAlgo, args->hashAlgo,
  8058. args->output, args->sendSz);
  8059. if (ret != 0)
  8060. goto exit_dcv;
  8061. /* CLIENT/SERVER: data verified with public key from
  8062. * certificate. */
  8063. ssl->peerRsaKeyPresent = 0;
  8064. FreeKey(ssl, DYNAMIC_TYPE_RSA, (void**)&ssl->peerRsaKey);
  8065. ssl->options.peerAuthGood = 1;
  8066. }
  8067. #endif /* !NO_RSA && WC_RSA_PSS */
  8068. /* Advance state and proceed */
  8069. ssl->options.asyncState = TLS_ASYNC_FINALIZE;
  8070. } /* case TLS_ASYNC_VERIFY */
  8071. FALL_THROUGH;
  8072. case TLS_ASYNC_FINALIZE:
  8073. {
  8074. ssl->options.havePeerVerify = 1;
  8075. /* Set final index */
  8076. args->idx += args->sz;
  8077. *inOutIdx = args->idx;
  8078. /* Encryption is always on: add padding */
  8079. *inOutIdx += ssl->keys.padSz;
  8080. /* Advance state and proceed */
  8081. ssl->options.asyncState = TLS_ASYNC_END;
  8082. #if !defined(NO_WOLFSSL_CLIENT)
  8083. if (ssl->options.side == WOLFSSL_CLIENT_END)
  8084. ssl->options.serverState = SERVER_CERT_VERIFY_COMPLETE;
  8085. #endif
  8086. } /* case TLS_ASYNC_FINALIZE */
  8087. FALL_THROUGH;
  8088. case TLS_ASYNC_END:
  8089. {
  8090. break;
  8091. }
  8092. default:
  8093. ret = INPUT_CASE_ERROR;
  8094. } /* switch(ssl->options.asyncState) */
  8095. exit_dcv:
  8096. WOLFSSL_LEAVE("DoTls13CertificateVerify", ret);
  8097. WOLFSSL_END(WC_FUNC_CERTIFICATE_VERIFY_DO);
  8098. #ifdef WOLFSSL_ASYNC_CRYPT
  8099. /* Handle async operation */
  8100. if (ret == WC_PENDING_E) {
  8101. /* Mark message as not received so it can process again */
  8102. ssl->msgsReceived.got_certificate_verify = 0;
  8103. return ret;
  8104. }
  8105. else
  8106. #endif /* WOLFSSL_ASYNC_CRYPT */
  8107. if (ret != 0) {
  8108. WOLFSSL_ERROR_VERBOSE(ret);
  8109. if (ret != INVALID_PARAMETER) {
  8110. SendAlert(ssl, alert_fatal, decrypt_error);
  8111. }
  8112. }
  8113. /* Final cleanup */
  8114. FreeDcv13Args(ssl, args);
  8115. FreeKeyExchange(ssl);
  8116. #ifdef WOLFSSL_ASYNC_IO
  8117. /* Cleanup async */
  8118. FreeAsyncCtx(ssl, 0);
  8119. #endif
  8120. return ret;
  8121. }
  8122. #endif /* !NO_RSA || HAVE_ECC */
  8123. #endif /* !NO_CERTS */
  8124. /* Parse and handle a TLS v1.3 Finished message.
  8125. *
  8126. * ssl The SSL/TLS object.
  8127. * input The message buffer.
  8128. * inOutIdx On entry, the index into the message buffer of Finished.
  8129. * On exit, the index of byte after the Finished message and padding.
  8130. * size Length of message data.
  8131. * totalSz Length of remaining data in the message buffer.
  8132. * sniff Indicates whether we are sniffing packets.
  8133. * returns 0 on success and otherwise failure.
  8134. */
  8135. int DoTls13Finished(WOLFSSL* ssl, const byte* input, word32* inOutIdx,
  8136. word32 size, word32 totalSz, int sniff)
  8137. {
  8138. int ret;
  8139. word32 finishedSz = 0;
  8140. byte* secret;
  8141. byte mac[WC_MAX_DIGEST_SIZE];
  8142. WOLFSSL_START(WC_FUNC_FINISHED_DO);
  8143. WOLFSSL_ENTER("DoTls13Finished");
  8144. #if !defined(NO_CERTS) && !defined(WOLFSSL_NO_CLIENT_AUTH)
  8145. /* verify the client sent certificate if required */
  8146. if (ssl->options.side == WOLFSSL_SERVER_END && !ssl->options.resuming &&
  8147. (ssl->options.mutualAuth || ssl->options.failNoCert)) {
  8148. #ifdef OPENSSL_COMPATIBLE_DEFAULTS
  8149. if (ssl->options.isPSK) {
  8150. WOLFSSL_MSG("TLS v1.3 client used PSK but cert required. Allowing "
  8151. "for OpenSSL compatibility");
  8152. }
  8153. else
  8154. #endif
  8155. if (
  8156. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  8157. !ssl->options.verifyPostHandshake &&
  8158. #endif
  8159. (!ssl->options.havePeerCert || !ssl->options.havePeerVerify)) {
  8160. ret = NO_PEER_CERT; /* NO_PEER_VERIFY */
  8161. WOLFSSL_MSG("TLS v1.3 client did not present peer cert");
  8162. DoCertFatalAlert(ssl, ret);
  8163. return ret;
  8164. }
  8165. }
  8166. #endif
  8167. /* check against totalSz */
  8168. if (*inOutIdx + size > totalSz)
  8169. return BUFFER_E;
  8170. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  8171. ret = tsip_Tls13HandleFinished(ssl, input, inOutIdx, size, totalSz);
  8172. if (ret == 0) {
  8173. ssl->options.serverState = SERVER_FINISHED_COMPLETE;
  8174. return ret;
  8175. }
  8176. if (ret == VERIFY_FINISHED_ERROR) {
  8177. SendAlert(ssl, alert_fatal, decrypt_error);
  8178. return ret;
  8179. }
  8180. if (ret != CRYPTOCB_UNAVAILABLE) {
  8181. /* other errors */
  8182. return ret;
  8183. }
  8184. ret = 0;
  8185. #endif /* WOLFSSL_RENESAS_TSIP_TLS && WOLFSSL_RENESAS_TSIP_VER >= 115 */
  8186. if (ssl->options.handShakeDone) {
  8187. ret = DeriveFinishedSecret(ssl, ssl->clientSecret,
  8188. ssl->keys.client_write_MAC_secret,
  8189. WOLFSSL_CLIENT_END);
  8190. if (ret != 0)
  8191. return ret;
  8192. secret = ssl->keys.client_write_MAC_secret;
  8193. }
  8194. else if (ssl->options.side == WOLFSSL_CLIENT_END) {
  8195. /* All the handshake messages have been received to calculate
  8196. * client and server finished keys.
  8197. */
  8198. ret = DeriveFinishedSecret(ssl, ssl->clientSecret,
  8199. ssl->keys.client_write_MAC_secret,
  8200. WOLFSSL_CLIENT_END);
  8201. if (ret != 0)
  8202. return ret;
  8203. ret = DeriveFinishedSecret(ssl, ssl->serverSecret,
  8204. ssl->keys.server_write_MAC_secret,
  8205. WOLFSSL_SERVER_END);
  8206. if (ret != 0)
  8207. return ret;
  8208. secret = ssl->keys.server_write_MAC_secret;
  8209. }
  8210. else {
  8211. secret = ssl->keys.client_write_MAC_secret;
  8212. }
  8213. if (sniff == NO_SNIFF) {
  8214. ret = BuildTls13HandshakeHmac(ssl, secret, mac, &finishedSz);
  8215. #ifdef WOLFSSL_HAVE_TLS_UNIQUE
  8216. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  8217. XMEMCPY(ssl->serverFinished, mac, finishedSz);
  8218. ssl->serverFinished_len = finishedSz;
  8219. }
  8220. else {
  8221. XMEMCPY(ssl->clientFinished, mac, finishedSz);
  8222. ssl->clientFinished_len = finishedSz;
  8223. }
  8224. #endif /* WOLFSSL_HAVE_TLS_UNIQUE */
  8225. if (ret != 0)
  8226. return ret;
  8227. if (size != finishedSz)
  8228. return BUFFER_ERROR;
  8229. }
  8230. #ifdef WOLFSSL_CALLBACKS
  8231. if (ssl->hsInfoOn) AddPacketName(ssl, "Finished");
  8232. if (ssl->toInfoOn) AddLateName("Finished", &ssl->timeoutInfo);
  8233. #endif
  8234. if (sniff == NO_SNIFF) {
  8235. /* Actually check verify data. */
  8236. if (XMEMCMP(input + *inOutIdx, mac, size) != 0){
  8237. WOLFSSL_MSG("Verify finished error on hashes");
  8238. SendAlert(ssl, alert_fatal, decrypt_error);
  8239. WOLFSSL_ERROR_VERBOSE(VERIFY_FINISHED_ERROR);
  8240. return VERIFY_FINISHED_ERROR;
  8241. }
  8242. }
  8243. /* Force input exhaustion at ProcessReply by consuming padSz. */
  8244. *inOutIdx += size + ssl->keys.padSz;
  8245. if (ssl->options.side == WOLFSSL_SERVER_END &&
  8246. !ssl->options.handShakeDone) {
  8247. #ifdef WOLFSSL_EARLY_DATA
  8248. if (ssl->earlyData != no_early_data) {
  8249. if ((ret = DeriveTls13Keys(ssl, no_key, DECRYPT_SIDE_ONLY, 1)) != 0)
  8250. return ret;
  8251. }
  8252. #endif
  8253. /* Setup keys for application data messages from client. */
  8254. if ((ret = SetKeysSide(ssl, DECRYPT_SIDE_ONLY)) != 0)
  8255. return ret;
  8256. }
  8257. #ifndef NO_WOLFSSL_CLIENT
  8258. if (ssl->options.side == WOLFSSL_CLIENT_END)
  8259. ssl->options.serverState = SERVER_FINISHED_COMPLETE;
  8260. #endif
  8261. #ifndef NO_WOLFSSL_SERVER
  8262. if (ssl->options.side == WOLFSSL_SERVER_END) {
  8263. ssl->options.clientState = CLIENT_FINISHED_COMPLETE;
  8264. ssl->options.handShakeState = HANDSHAKE_DONE;
  8265. ssl->options.handShakeDone = 1;
  8266. }
  8267. #endif
  8268. #if defined(WOLFSSL_DTLS13) && defined(WOLFSSL_EARLY_DATA)
  8269. if (ssl->options.dtls && ssl->earlyData > early_data_ext) {
  8270. /* DTLSv1.3 has no EndOfearlydata messages. We stop processing EarlyData
  8271. as soon we receive the client's finished message */
  8272. ssl->earlyData = done_early_data;
  8273. }
  8274. #endif /* WOLFSSL_DTLS13 && WOLFSSL_EARLY_DATA */
  8275. #if defined(WOLFSSL_QUIC) && defined(WOLFSSL_EARLY_DATA)
  8276. if (WOLFSSL_IS_QUIC(ssl) && ssl->earlyData > early_data_ext) {
  8277. /* QUIC has no EndOfEarlyData messages. We stop processing EarlyData
  8278. as soon we receive the client's finished message */
  8279. ssl->earlyData = done_early_data;
  8280. }
  8281. #endif /* WOLFSSL_QUIC && WOLFSSL_EARLY_DATA */
  8282. WOLFSSL_LEAVE("DoTls13Finished", 0);
  8283. WOLFSSL_END(WC_FUNC_FINISHED_DO);
  8284. return 0;
  8285. }
  8286. #if !defined(NO_WOLFSSL_CLIENT) || !defined(NO_WOLFSSL_SERVER)
  8287. /* Send the TLS v1.3 Finished message.
  8288. *
  8289. * ssl The SSL/TLS object.
  8290. * returns 0 on success, otherwise failure.
  8291. */
  8292. static int SendTls13Finished(WOLFSSL* ssl)
  8293. {
  8294. int sendSz;
  8295. int finishedSz = ssl->specs.hash_size;
  8296. byte* input;
  8297. byte* output;
  8298. int ret;
  8299. int headerSz = HANDSHAKE_HEADER_SZ;
  8300. int outputSz;
  8301. byte* secret;
  8302. #ifdef WOLFSSL_DTLS13
  8303. int dtlsRet = 0, isDtls = 0;
  8304. #endif /* WOLFSSL_DTLS13 */
  8305. WOLFSSL_START(WC_FUNC_FINISHED_SEND);
  8306. WOLFSSL_ENTER("SendTls13Finished");
  8307. ssl->options.buildingMsg = 1;
  8308. #ifdef WOLFSSL_DTLS13
  8309. if (ssl->options.dtls) {
  8310. headerSz = DTLS_HANDSHAKE_HEADER_SZ;
  8311. /* using isDtls instead of ssl->options.dtls will abide clang static
  8312. analyzer on unsing an uninitialized value */
  8313. isDtls = 1;
  8314. }
  8315. #endif /* WOLFSSL_DTLS13 */
  8316. outputSz = WC_MAX_DIGEST_SIZE + DTLS_HANDSHAKE_HEADER_SZ + MAX_MSG_EXTRA;
  8317. /* Check buffers are big enough and grow if needed. */
  8318. if ((ret = CheckAvailableSize(ssl, outputSz)) != 0)
  8319. return ret;
  8320. /* get output buffer */
  8321. output = ssl->buffers.outputBuffer.buffer +
  8322. ssl->buffers.outputBuffer.length;
  8323. input = output + RECORD_HEADER_SZ;
  8324. #ifdef WOLFSSL_DTLS13
  8325. if (isDtls)
  8326. input = output + Dtls13GetRlHeaderLength(ssl, 1);
  8327. #endif /* WOLFSSL_DTLS13 */
  8328. AddTls13HandShakeHeader(input, finishedSz, 0, finishedSz, finished, ssl);
  8329. #if defined(WOLFSSL_RENESAS_TSIP_TLS) && (WOLFSSL_RENESAS_TSIP_VER >= 115)
  8330. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  8331. ret = tsip_Tls13SendFinished(ssl, output, outputSz, input, 1);
  8332. if (ret != CRYPTOCB_UNAVAILABLE) {
  8333. return ret;
  8334. }
  8335. ret = 0;
  8336. }
  8337. #endif /* WOLFSSL_RENESAS_TSIP_TLS && WOLFSSL_RENESAS_TSIP_VER >= 115 */
  8338. /* make finished hashes */
  8339. if (ssl->options.handShakeDone) {
  8340. ret = DeriveFinishedSecret(ssl, ssl->clientSecret,
  8341. ssl->keys.client_write_MAC_secret,
  8342. WOLFSSL_CLIENT_END);
  8343. if (ret != 0)
  8344. return ret;
  8345. secret = ssl->keys.client_write_MAC_secret;
  8346. }
  8347. else if (ssl->options.side == WOLFSSL_CLIENT_END)
  8348. secret = ssl->keys.client_write_MAC_secret;
  8349. else {
  8350. /* All the handshake messages have been done to calculate client and
  8351. * server finished keys.
  8352. */
  8353. ret = DeriveFinishedSecret(ssl, ssl->clientSecret,
  8354. ssl->keys.client_write_MAC_secret,
  8355. WOLFSSL_SERVER_END);
  8356. if (ret != 0)
  8357. return ret;
  8358. ret = DeriveFinishedSecret(ssl, ssl->serverSecret,
  8359. ssl->keys.server_write_MAC_secret,
  8360. WOLFSSL_CLIENT_END);
  8361. if (ret != 0)
  8362. return ret;
  8363. secret = ssl->keys.server_write_MAC_secret;
  8364. }
  8365. ret = BuildTls13HandshakeHmac(ssl, secret, &input[headerSz], NULL);
  8366. if (ret != 0)
  8367. return ret;
  8368. #ifdef WOLFSSL_HAVE_TLS_UNIQUE
  8369. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  8370. XMEMCPY(ssl->clientFinished, &input[headerSz], finishedSz);
  8371. ssl->clientFinished_len = finishedSz;
  8372. }
  8373. else {
  8374. XMEMCPY(ssl->serverFinished, &input[headerSz], finishedSz);
  8375. ssl->serverFinished_len = finishedSz;
  8376. }
  8377. #endif /* WOLFSSL_HAVE_TLS_UNIQUE */
  8378. #ifdef WOLFSSL_DTLS13
  8379. if (isDtls) {
  8380. dtlsRet = Dtls13HandshakeSend(ssl, output, (word16)outputSz,
  8381. (word16)(Dtls13GetRlHeaderLength(ssl, 1) + headerSz + finishedSz), finished,
  8382. 1);
  8383. if (dtlsRet != 0 && dtlsRet != WANT_WRITE)
  8384. return ret;
  8385. } else
  8386. #endif /* WOLFSSL_DTLS13 */
  8387. {
  8388. /* This message is always encrypted. */
  8389. sendSz = BuildTls13Message(ssl, output, outputSz, input,
  8390. headerSz + finishedSz, handshake, 1, 0, 0);
  8391. if (sendSz < 0) {
  8392. WOLFSSL_ERROR_VERBOSE(BUILD_MSG_ERROR);
  8393. return BUILD_MSG_ERROR;
  8394. }
  8395. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  8396. if (ssl->hsInfoOn) AddPacketName(ssl, "Finished");
  8397. if (ssl->toInfoOn) {
  8398. ret = AddPacketInfo(ssl, "Finished", handshake, output, sendSz,
  8399. WRITE_PROTO, 0, ssl->heap);
  8400. if (ret != 0)
  8401. return ret;
  8402. }
  8403. #endif
  8404. ssl->buffers.outputBuffer.length += sendSz;
  8405. ssl->options.buildingMsg = 0;
  8406. }
  8407. if (ssl->options.side == WOLFSSL_SERVER_END) {
  8408. #ifdef WOLFSSL_EARLY_DATA
  8409. byte storeTrafficDecKeys = ssl->earlyData == no_early_data;
  8410. #endif
  8411. /* Can send application data now. */
  8412. if ((ret = DeriveMasterSecret(ssl)) != 0)
  8413. return ret;
  8414. /* Last use of preMasterSecret - zeroize as soon as possible. */
  8415. ForceZero(ssl->arrays->preMasterSecret, ssl->arrays->preMasterSz);
  8416. #ifdef WOLFSSL_EARLY_DATA
  8417. #ifdef WOLFSSL_DTLS13
  8418. /* DTLS13 dynamically change keys and it needs all
  8419. the keys in ssl->keys to save the keying material */
  8420. if (isDtls)
  8421. storeTrafficDecKeys = 1;
  8422. #endif /* WOLFSSL_DTLS13 */
  8423. if ((ret = DeriveTls13Keys(ssl, traffic_key, ENCRYPT_SIDE_ONLY, 1))
  8424. != 0) {
  8425. return ret;
  8426. }
  8427. if ((ret = DeriveTls13Keys(ssl, traffic_key, DECRYPT_SIDE_ONLY,
  8428. storeTrafficDecKeys)) != 0) {
  8429. return ret;
  8430. }
  8431. #else
  8432. if ((ret = DeriveTls13Keys(ssl, traffic_key, ENCRYPT_AND_DECRYPT_SIDE,
  8433. 1)) != 0) {
  8434. return ret;
  8435. }
  8436. #endif
  8437. if ((ret = SetKeysSide(ssl, ENCRYPT_SIDE_ONLY)) != 0)
  8438. return ret;
  8439. #ifdef WOLFSSL_DTLS13
  8440. if (isDtls) {
  8441. w64wrapper epochTraffic0;
  8442. epochTraffic0 = w64From32(0, DTLS13_EPOCH_TRAFFIC0);
  8443. ssl->dtls13Epoch = epochTraffic0;
  8444. ssl->dtls13PeerEpoch = epochTraffic0;
  8445. ret = Dtls13NewEpoch(
  8446. ssl, epochTraffic0, ENCRYPT_AND_DECRYPT_SIDE);
  8447. if (ret != 0)
  8448. return ret;
  8449. ret = Dtls13SetEpochKeys(
  8450. ssl, epochTraffic0, ENCRYPT_AND_DECRYPT_SIDE);
  8451. if (ret != 0)
  8452. return ret;
  8453. }
  8454. #endif /* WOLFSSL_DTLS13 */
  8455. }
  8456. if (ssl->options.side == WOLFSSL_CLIENT_END &&
  8457. !ssl->options.handShakeDone) {
  8458. #ifdef WOLFSSL_EARLY_DATA
  8459. if (ssl->earlyData != no_early_data) {
  8460. if ((ret = DeriveTls13Keys(ssl, no_key, ENCRYPT_AND_DECRYPT_SIDE,
  8461. 1)) != 0) {
  8462. return ret;
  8463. }
  8464. }
  8465. #endif
  8466. /* Setup keys for application data messages. */
  8467. if ((ret = SetKeysSide(ssl, ENCRYPT_AND_DECRYPT_SIDE)) != 0)
  8468. return ret;
  8469. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  8470. ret = DeriveResumptionSecret(ssl, ssl->session->masterSecret);
  8471. if (ret != 0)
  8472. return ret;
  8473. #endif
  8474. #ifdef WOLFSSL_DTLS13
  8475. if (isDtls) {
  8476. w64wrapper epochTraffic0;
  8477. epochTraffic0 = w64From32(0, DTLS13_EPOCH_TRAFFIC0);
  8478. ssl->dtls13Epoch = epochTraffic0;
  8479. ssl->dtls13PeerEpoch = epochTraffic0;
  8480. ret = Dtls13NewEpoch(
  8481. ssl, epochTraffic0, ENCRYPT_AND_DECRYPT_SIDE);
  8482. if (ret != 0)
  8483. return ret;
  8484. ret = Dtls13SetEpochKeys(
  8485. ssl, epochTraffic0, ENCRYPT_AND_DECRYPT_SIDE);
  8486. if (ret != 0)
  8487. return ret;
  8488. }
  8489. #endif /* WOLFSSL_DTLS13 */
  8490. }
  8491. #ifndef NO_WOLFSSL_CLIENT
  8492. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  8493. ssl->options.clientState = CLIENT_FINISHED_COMPLETE;
  8494. ssl->options.handShakeState = HANDSHAKE_DONE;
  8495. ssl->options.handShakeDone = 1;
  8496. }
  8497. #endif
  8498. #ifndef NO_WOLFSSL_SERVER
  8499. if (ssl->options.side == WOLFSSL_SERVER_END) {
  8500. ssl->options.serverState = SERVER_FINISHED_COMPLETE;
  8501. }
  8502. #endif
  8503. #ifdef WOLFSSL_DTLS13
  8504. if (isDtls) {
  8505. WOLFSSL_LEAVE("SendTls13Finished", ret);
  8506. WOLFSSL_END(WC_FUNC_FINISHED_SEND);
  8507. return dtlsRet;
  8508. }
  8509. #endif /* WOLFSSL_DTLS13 */
  8510. if ((ret = SendBuffered(ssl)) != 0)
  8511. return ret;
  8512. WOLFSSL_LEAVE("SendTls13Finished", ret);
  8513. WOLFSSL_END(WC_FUNC_FINISHED_SEND);
  8514. return ret;
  8515. }
  8516. #endif /* !NO_WOLFSSL_CLIENT || !NO_WOLFSSL_SERVER */
  8517. /* handle generation TLS v1.3 key_update (24) */
  8518. /* Send the TLS v1.3 KeyUpdate message.
  8519. *
  8520. * ssl The SSL/TLS object.
  8521. * returns 0 on success, otherwise failure.
  8522. */
  8523. static int SendTls13KeyUpdate(WOLFSSL* ssl)
  8524. {
  8525. int sendSz;
  8526. byte* input;
  8527. byte* output;
  8528. int ret;
  8529. int headerSz = HANDSHAKE_HEADER_SZ;
  8530. int outputSz;
  8531. word32 i = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  8532. WOLFSSL_START(WC_FUNC_KEY_UPDATE_SEND);
  8533. WOLFSSL_ENTER("SendTls13KeyUpdate");
  8534. #ifdef WOLFSSL_DTLS13
  8535. if (ssl->options.dtls)
  8536. i = Dtls13GetRlHeaderLength(ssl, 1) + DTLS_HANDSHAKE_HEADER_SZ;
  8537. #endif /* WOLFSSL_DTLS13 */
  8538. outputSz = OPAQUE8_LEN + MAX_MSG_EXTRA;
  8539. /* Check buffers are big enough and grow if needed. */
  8540. if ((ret = CheckAvailableSize(ssl, outputSz)) != 0)
  8541. return ret;
  8542. /* get output buffer */
  8543. output = ssl->buffers.outputBuffer.buffer +
  8544. ssl->buffers.outputBuffer.length;
  8545. input = output + RECORD_HEADER_SZ;
  8546. #ifdef WOLFSSL_DTLS13
  8547. if (ssl->options.dtls)
  8548. input = output + Dtls13GetRlHeaderLength(ssl, 1);
  8549. #endif /* WOLFSSL_DTLS13 */
  8550. AddTls13Headers(output, OPAQUE8_LEN, key_update, ssl);
  8551. /* If:
  8552. * 1. I haven't sent a KeyUpdate requesting a response and
  8553. * 2. This isn't responding to peer KeyUpdate requiring a response then,
  8554. * I want a response.
  8555. */
  8556. ssl->keys.updateResponseReq = output[i++] =
  8557. !ssl->keys.updateResponseReq && !ssl->keys.keyUpdateRespond;
  8558. /* Sent response, no longer need to respond. */
  8559. ssl->keys.keyUpdateRespond = 0;
  8560. #ifdef WOLFSSL_DTLS13
  8561. if (ssl->options.dtls) {
  8562. ret = Dtls13HandshakeSend(ssl, output, (word16)outputSz,
  8563. OPAQUE8_LEN + Dtls13GetRlHeaderLength(ssl, 1) +
  8564. DTLS_HANDSHAKE_HEADER_SZ,
  8565. key_update, 0);
  8566. }
  8567. else
  8568. #endif /* WOLFSSL_DTLS13 */
  8569. {
  8570. /* This message is always encrypted. */
  8571. sendSz = BuildTls13Message(ssl, output, outputSz, input,
  8572. headerSz + OPAQUE8_LEN, handshake, 0, 0, 0);
  8573. if (sendSz < 0)
  8574. return BUILD_MSG_ERROR;
  8575. #if defined(WOLFSSL_CALLBACKS) || defined(OPENSSL_EXTRA)
  8576. if (ssl->hsInfoOn) AddPacketName(ssl, "KeyUpdate");
  8577. if (ssl->toInfoOn) {
  8578. ret = AddPacketInfo(ssl, "KeyUpdate", handshake, output, sendSz,
  8579. WRITE_PROTO, 0, ssl->heap);
  8580. if (ret != 0)
  8581. return ret;
  8582. }
  8583. #endif
  8584. ssl->buffers.outputBuffer.length += sendSz;
  8585. ret = SendBuffered(ssl);
  8586. if (ret != 0 && ret != WANT_WRITE)
  8587. return ret;
  8588. }
  8589. /* In DTLS we must wait for the ack before setting up the new keys */
  8590. if (!ssl->options.dtls) {
  8591. /* Future traffic uses new encryption keys. */
  8592. if ((ret = DeriveTls13Keys(
  8593. ssl, update_traffic_key, ENCRYPT_SIDE_ONLY, 1))
  8594. != 0)
  8595. return ret;
  8596. if ((ret = SetKeysSide(ssl, ENCRYPT_SIDE_ONLY)) != 0)
  8597. return ret;
  8598. }
  8599. WOLFSSL_LEAVE("SendTls13KeyUpdate", ret);
  8600. WOLFSSL_END(WC_FUNC_KEY_UPDATE_SEND);
  8601. return ret;
  8602. }
  8603. /* handle processing TLS v1.3 key_update (24) */
  8604. /* Parse and handle a TLS v1.3 KeyUpdate message.
  8605. *
  8606. * ssl The SSL/TLS object.
  8607. * input The message buffer.
  8608. * inOutIdx On entry, the index into the message buffer of Finished.
  8609. * On exit, the index of byte after the Finished message and padding.
  8610. * totalSz The length of the current handshake message.
  8611. * returns 0 on success and otherwise failure.
  8612. */
  8613. static int DoTls13KeyUpdate(WOLFSSL* ssl, const byte* input, word32* inOutIdx,
  8614. word32 totalSz)
  8615. {
  8616. int ret;
  8617. word32 i = *inOutIdx;
  8618. WOLFSSL_START(WC_FUNC_KEY_UPDATE_DO);
  8619. WOLFSSL_ENTER("DoTls13KeyUpdate");
  8620. /* check against totalSz */
  8621. if (OPAQUE8_LEN != totalSz)
  8622. return BUFFER_E;
  8623. switch (input[i]) {
  8624. case update_not_requested:
  8625. /* This message in response to any outstanding request. */
  8626. ssl->keys.keyUpdateRespond = 0;
  8627. ssl->keys.updateResponseReq = 0;
  8628. break;
  8629. case update_requested:
  8630. /* New key update requiring a response. */
  8631. ssl->keys.keyUpdateRespond = 1;
  8632. break;
  8633. default:
  8634. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  8635. return INVALID_PARAMETER;
  8636. }
  8637. /* Move index to byte after message. */
  8638. *inOutIdx += totalSz;
  8639. /* Always encrypted. */
  8640. *inOutIdx += ssl->keys.padSz;
  8641. /* Future traffic uses new decryption keys. */
  8642. if ((ret = DeriveTls13Keys(ssl, update_traffic_key, DECRYPT_SIDE_ONLY, 1))
  8643. != 0) {
  8644. return ret;
  8645. }
  8646. if ((ret = SetKeysSide(ssl, DECRYPT_SIDE_ONLY)) != 0)
  8647. return ret;
  8648. #ifdef WOLFSSL_DTLS13
  8649. if (ssl->options.dtls) {
  8650. w64Increment(&ssl->dtls13PeerEpoch);
  8651. ret = Dtls13NewEpoch(ssl, ssl->dtls13PeerEpoch, DECRYPT_SIDE_ONLY);
  8652. if (ret != 0)
  8653. return ret;
  8654. ret = Dtls13SetEpochKeys(ssl, ssl->dtls13PeerEpoch, DECRYPT_SIDE_ONLY);
  8655. if (ret != 0)
  8656. return ret;
  8657. }
  8658. #endif /* WOLFSSL_DTLS13 */
  8659. if (ssl->keys.keyUpdateRespond) {
  8660. #ifdef WOLFSSL_DTLS13
  8661. /* we already sent a keyUpdate (either in response to a previous
  8662. KeyUpdate or initiated by the application) and we are waiting for the
  8663. ack. We can't send a new KeyUpdate right away but to honor the RFC we
  8664. should send another KeyUpdate after the one in-flight is acked. We
  8665. don't do that as it looks redundant, it will make the code more
  8666. complex and I don't see a good use case for that. */
  8667. if (ssl->options.dtls && ssl->dtls13WaitKeyUpdateAck) {
  8668. ssl->keys.keyUpdateRespond = 0;
  8669. return 0;
  8670. }
  8671. #endif /* WOLFSSL_DTLS13 */
  8672. return SendTls13KeyUpdate(ssl);
  8673. }
  8674. WOLFSSL_LEAVE("DoTls13KeyUpdate", ret);
  8675. WOLFSSL_END(WC_FUNC_KEY_UPDATE_DO);
  8676. return 0;
  8677. }
  8678. #ifdef WOLFSSL_EARLY_DATA
  8679. #ifndef NO_WOLFSSL_CLIENT
  8680. /* Send the TLS v1.3 EndOfEarlyData message to indicate that there will be no
  8681. * more early application data.
  8682. * The encryption key now changes to the pre-calculated handshake key.
  8683. *
  8684. * ssl The SSL/TLS object.
  8685. * returns 0 on success and otherwise failure.
  8686. */
  8687. static int SendTls13EndOfEarlyData(WOLFSSL* ssl)
  8688. {
  8689. byte* output;
  8690. int ret;
  8691. int sendSz;
  8692. word32 length;
  8693. word32 idx = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  8694. WOLFSSL_START(WC_FUNC_END_OF_EARLY_DATA_SEND);
  8695. WOLFSSL_ENTER("SendTls13EndOfEarlyData");
  8696. length = 0;
  8697. sendSz = idx + length + MAX_MSG_EXTRA;
  8698. ssl->options.buildingMsg = 1;
  8699. /* Check buffers are big enough and grow if needed. */
  8700. if ((ret = CheckAvailableSize(ssl, sendSz)) != 0)
  8701. return ret;
  8702. /* Get position in output buffer to write new message to. */
  8703. output = ssl->buffers.outputBuffer.buffer +
  8704. ssl->buffers.outputBuffer.length;
  8705. /* Put the record and handshake headers on. */
  8706. AddTls13Headers(output, length, end_of_early_data, ssl);
  8707. /* This message is always encrypted. */
  8708. sendSz = BuildTls13Message(ssl, output, sendSz, output + RECORD_HEADER_SZ,
  8709. idx - RECORD_HEADER_SZ, handshake, 1, 0, 0);
  8710. if (sendSz < 0)
  8711. return sendSz;
  8712. ssl->buffers.outputBuffer.length += sendSz;
  8713. if ((ret = SetKeysSide(ssl, ENCRYPT_SIDE_ONLY)) != 0)
  8714. return ret;
  8715. ssl->options.buildingMsg = 0;
  8716. if (!ssl->options.groupMessages)
  8717. ret = SendBuffered(ssl);
  8718. WOLFSSL_LEAVE("SendTls13EndOfEarlyData", ret);
  8719. WOLFSSL_END(WC_FUNC_END_OF_EARLY_DATA_SEND);
  8720. return ret;
  8721. }
  8722. #endif /* !NO_WOLFSSL_CLIENT */
  8723. #ifndef NO_WOLFSSL_SERVER
  8724. /* handle processing of TLS 1.3 end_of_early_data (5) */
  8725. /* Parse the TLS v1.3 EndOfEarlyData message that indicates that there will be
  8726. * no more early application data.
  8727. * The decryption key now changes to the pre-calculated handshake key.
  8728. *
  8729. * ssl The SSL/TLS object.
  8730. * returns 0 on success and otherwise failure.
  8731. */
  8732. static int DoTls13EndOfEarlyData(WOLFSSL* ssl, const byte* input,
  8733. word32* inOutIdx, word32 size)
  8734. {
  8735. int ret;
  8736. word32 begin = *inOutIdx;
  8737. (void)input;
  8738. WOLFSSL_START(WC_FUNC_END_OF_EARLY_DATA_DO);
  8739. WOLFSSL_ENTER("DoTls13EndOfEarlyData");
  8740. if ((*inOutIdx - begin) != size)
  8741. return BUFFER_ERROR;
  8742. if (ssl->earlyData == no_early_data) {
  8743. WOLFSSL_MSG("EndOfEarlyData received unexpectedly");
  8744. SendAlert(ssl, alert_fatal, unexpected_message);
  8745. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  8746. return OUT_OF_ORDER_E;
  8747. }
  8748. ssl->earlyData = done_early_data;
  8749. /* Always encrypted. */
  8750. *inOutIdx += ssl->keys.padSz;
  8751. ret = SetKeysSide(ssl, DECRYPT_SIDE_ONLY);
  8752. WOLFSSL_LEAVE("DoTls13EndOfEarlyData", ret);
  8753. WOLFSSL_END(WC_FUNC_END_OF_EARLY_DATA_DO);
  8754. return ret;
  8755. }
  8756. #endif /* !NO_WOLFSSL_SERVER */
  8757. #endif /* WOLFSSL_EARLY_DATA */
  8758. #if defined(HAVE_SESSION_TICKET) && defined(WOLFSSL_TICKET_NONCE_MALLOC) && \
  8759. (!defined(HAVE_FIPS) || (defined(FIPS_VERSION_GE) && FIPS_VERSION_GE(5,3)))
  8760. int SessionTicketNoncePopulate(WOLFSSL_SESSION *session, const byte *nonce,
  8761. byte len)
  8762. {
  8763. if (session->ticketNonce.data
  8764. != session->ticketNonce.dataStatic) {
  8765. XFREE(session->ticketNonce.data, session->heap,
  8766. DYNAMIC_TYPE_SESSION_TICK);
  8767. session->ticketNonce.data = session->ticketNonce.dataStatic;
  8768. session->ticketNonce.len = 0;
  8769. }
  8770. if (len > MAX_TICKET_NONCE_STATIC_SZ) {
  8771. WOLFSSL_MSG("Using dynamic nonce buffer");
  8772. session->ticketNonce.data = (byte*)XMALLOC(len,
  8773. session->heap, DYNAMIC_TYPE_SESSION_TICK);
  8774. if (session->ticketNonce.data == NULL)
  8775. return MEMORY_ERROR;
  8776. }
  8777. XMEMCPY(session->ticketNonce.data, nonce, len);
  8778. session->ticketNonce.len = len;
  8779. return 0;
  8780. }
  8781. #endif
  8782. #ifndef NO_WOLFSSL_CLIENT
  8783. /* Handle a New Session Ticket handshake message.
  8784. * Message contains the information required to perform resumption.
  8785. *
  8786. * ssl The SSL/TLS object.
  8787. * input The message buffer.
  8788. * inOutIdx On entry, the index into the message buffer of Finished.
  8789. * On exit, the index of byte after the Finished message and padding.
  8790. * size The length of the current handshake message.
  8791. * returns 0 on success, otherwise failure.
  8792. */
  8793. static int DoTls13NewSessionTicket(WOLFSSL* ssl, const byte* input,
  8794. word32* inOutIdx, word32 size)
  8795. {
  8796. #ifdef HAVE_SESSION_TICKET
  8797. int ret;
  8798. word32 begin = *inOutIdx;
  8799. word32 lifetime;
  8800. word32 ageAdd;
  8801. word16 length;
  8802. #ifdef WOLFSSL_32BIT_MILLI_TIME
  8803. word32 now;
  8804. #else
  8805. sword64 now;
  8806. #endif
  8807. const byte* nonce;
  8808. byte nonceLength;
  8809. WOLFSSL_START(WC_FUNC_NEW_SESSION_TICKET_DO);
  8810. WOLFSSL_ENTER("DoTls13NewSessionTicket");
  8811. /* Lifetime hint. */
  8812. if ((*inOutIdx - begin) + SESSION_HINT_SZ > size)
  8813. return BUFFER_ERROR;
  8814. ato32(input + *inOutIdx, &lifetime);
  8815. *inOutIdx += SESSION_HINT_SZ;
  8816. if (lifetime > MAX_LIFETIME) {
  8817. WOLFSSL_ERROR_VERBOSE(SERVER_HINT_ERROR);
  8818. return SERVER_HINT_ERROR;
  8819. }
  8820. /* Age add. */
  8821. if ((*inOutIdx - begin) + SESSION_ADD_SZ > size)
  8822. return BUFFER_ERROR;
  8823. ato32(input + *inOutIdx, &ageAdd);
  8824. *inOutIdx += SESSION_ADD_SZ;
  8825. /* Ticket nonce. */
  8826. if ((*inOutIdx - begin) + 1 > size)
  8827. return BUFFER_ERROR;
  8828. nonceLength = input[*inOutIdx];
  8829. #if !defined(WOLFSSL_TICKET_NONCE_MALLOC) && \
  8830. (!defined(HAVE_FIPS) || FIPS_VERSION_GE(5,3))
  8831. if (nonceLength > MAX_TICKET_NONCE_STATIC_SZ) {
  8832. WOLFSSL_MSG("Nonce length not supported");
  8833. WOLFSSL_ERROR_VERBOSE(INVALID_PARAMETER);
  8834. return INVALID_PARAMETER;
  8835. }
  8836. #endif /* WOLFSSL_TICKET_NONCE_MALLOC && FIPS_VERSION_GE(5,3) */
  8837. *inOutIdx += 1;
  8838. if ((*inOutIdx - begin) + nonceLength > size)
  8839. return BUFFER_ERROR;
  8840. nonce = input + *inOutIdx;
  8841. *inOutIdx += nonceLength;
  8842. /* Ticket length. */
  8843. if ((*inOutIdx - begin) + LENGTH_SZ > size)
  8844. return BUFFER_ERROR;
  8845. ato16(input + *inOutIdx, &length);
  8846. *inOutIdx += LENGTH_SZ;
  8847. if ((*inOutIdx - begin) + length > size)
  8848. return BUFFER_ERROR;
  8849. if ((ret = SetTicket(ssl, input + *inOutIdx, length)) != 0)
  8850. return ret;
  8851. *inOutIdx += length;
  8852. now = TimeNowInMilliseconds();
  8853. if (now == 0)
  8854. return GETTIME_ERROR;
  8855. /* Copy in ticket data (server identity). */
  8856. ssl->timeout = lifetime;
  8857. ssl->session->timeout = lifetime;
  8858. ssl->session->cipherSuite0 = ssl->options.cipherSuite0;
  8859. ssl->session->cipherSuite = ssl->options.cipherSuite;
  8860. ssl->session->ticketSeen = now;
  8861. ssl->session->ticketAdd = ageAdd;
  8862. #ifdef WOLFSSL_EARLY_DATA
  8863. ssl->session->maxEarlyDataSz = ssl->options.maxEarlyDataSz;
  8864. #endif
  8865. #if defined(WOLFSSL_TICKET_NONCE_MALLOC) && \
  8866. (!defined(HAVE_FIPS) || (defined(FIPS_VERSION_GE) && FIPS_VERSION_GE(5,3)))
  8867. ret = SessionTicketNoncePopulate(ssl->session, nonce, nonceLength);
  8868. if (ret != 0)
  8869. return ret;
  8870. #else
  8871. ssl->session->ticketNonce.len = nonceLength;
  8872. if (nonceLength > MAX_TICKET_NONCE_STATIC_SZ) {
  8873. ret = BUFFER_ERROR;
  8874. return ret;
  8875. }
  8876. if (nonceLength > 0)
  8877. XMEMCPY(ssl->session->ticketNonce.data, nonce, nonceLength);
  8878. #endif /* defined(WOLFSSL_TICKET_NONCE_MALLOC) && FIPS_VERSION_GE(5,3) */
  8879. ssl->session->namedGroup = ssl->namedGroup;
  8880. if ((*inOutIdx - begin) + EXTS_SZ > size)
  8881. return BUFFER_ERROR;
  8882. ato16(input + *inOutIdx, &length);
  8883. *inOutIdx += EXTS_SZ;
  8884. if ((*inOutIdx - begin) + length != size)
  8885. return BUFFER_ERROR;
  8886. #ifdef WOLFSSL_EARLY_DATA
  8887. ret = TLSX_Parse(ssl, (byte *)input + (*inOutIdx), length, session_ticket,
  8888. NULL);
  8889. if (ret != 0)
  8890. return ret;
  8891. #endif
  8892. *inOutIdx += length;
  8893. #ifndef NO_SESSION_CACHE
  8894. AddSession(ssl);
  8895. #endif
  8896. /* Always encrypted. */
  8897. *inOutIdx += ssl->keys.padSz;
  8898. ssl->expect_session_ticket = 0;
  8899. #else
  8900. (void)ssl;
  8901. (void)input;
  8902. WOLFSSL_ENTER("DoTls13NewSessionTicket");
  8903. *inOutIdx += size + ssl->keys.padSz;
  8904. #endif /* HAVE_SESSION_TICKET */
  8905. WOLFSSL_LEAVE("DoTls13NewSessionTicket", 0);
  8906. WOLFSSL_END(WC_FUNC_NEW_SESSION_TICKET_DO);
  8907. return 0;
  8908. }
  8909. #endif /* NO_WOLFSSL_CLIENT */
  8910. #ifndef NO_WOLFSSL_SERVER
  8911. #ifdef HAVE_SESSION_TICKET
  8912. #ifdef WOLFSSL_TLS13_TICKET_BEFORE_FINISHED
  8913. /* Offset of the MAC size in the finished message. */
  8914. #define FINISHED_MSG_SIZE_OFFSET 3
  8915. /* Calculate the resumption secret which includes the unseen client finished
  8916. * message.
  8917. *
  8918. * ssl The SSL/TLS object.
  8919. * returns 0 on success, otherwise failure.
  8920. */
  8921. static int ExpectedResumptionSecret(WOLFSSL* ssl)
  8922. {
  8923. int ret;
  8924. word32 finishedSz = 0;
  8925. byte mac[WC_MAX_DIGEST_SIZE];
  8926. Digest digest;
  8927. static byte header[] = { 0x14, 0x00, 0x00, 0x00 };
  8928. /* Copy the running hash so we can restore it after. */
  8929. switch (ssl->specs.mac_algorithm) {
  8930. #ifndef NO_SHA256
  8931. case sha256_mac:
  8932. ret = wc_Sha256Copy(&ssl->hsHashes->hashSha256, &digest.sha256);
  8933. if (ret != 0)
  8934. return ret;
  8935. break;
  8936. #endif
  8937. #ifdef WOLFSSL_SHA384
  8938. case sha384_mac:
  8939. ret = wc_Sha384Copy(&ssl->hsHashes->hashSha384, &digest.sha384);
  8940. if (ret != 0)
  8941. return ret;
  8942. break;
  8943. #endif
  8944. #ifdef WOLFSSL_TLS13_SHA512
  8945. case sha512_mac:
  8946. ret = wc_Sha512Copy(&ssl->hsHashes->hashSha512, &digest.sha512);
  8947. if (ret != 0)
  8948. return ret;
  8949. break;
  8950. #endif
  8951. }
  8952. /* Generate the Client's Finished message and hash it. */
  8953. ret = BuildTls13HandshakeHmac(ssl, ssl->keys.client_write_MAC_secret, mac,
  8954. &finishedSz);
  8955. if (ret != 0)
  8956. return ret;
  8957. header[FINISHED_MSG_SIZE_OFFSET] = finishedSz;
  8958. #ifdef WOLFSSL_EARLY_DATA
  8959. if (ssl->earlyData != no_early_data) {
  8960. static byte endOfEarlyData[] = { 0x05, 0x00, 0x00, 0x00 };
  8961. ret = HashRaw(ssl, endOfEarlyData, sizeof(endOfEarlyData));
  8962. if (ret != 0)
  8963. return ret;
  8964. }
  8965. #endif
  8966. if ((ret = HashRaw(ssl, header, sizeof(header))) != 0)
  8967. return ret;
  8968. if ((ret = HashRaw(ssl, mac, finishedSz)) != 0)
  8969. return ret;
  8970. if ((ret = DeriveResumptionSecret(ssl, ssl->session->masterSecret)) != 0)
  8971. return ret;
  8972. /* Restore the hash inline with currently seen messages. */
  8973. switch (ssl->specs.mac_algorithm) {
  8974. #ifndef NO_SHA256
  8975. case sha256_mac:
  8976. wc_Sha256Free(&ssl->hsHashes->hashSha256);
  8977. ret = wc_Sha256Copy(&digest.sha256, &ssl->hsHashes->hashSha256);
  8978. wc_Sha256Free(&digest.sha256);
  8979. if (ret != 0)
  8980. return ret;
  8981. break;
  8982. #endif
  8983. #ifdef WOLFSSL_SHA384
  8984. case sha384_mac:
  8985. wc_Sha384Free(&ssl->hsHashes->hashSha384);
  8986. ret = wc_Sha384Copy(&digest.sha384, &ssl->hsHashes->hashSha384);
  8987. wc_Sha384Free(&digest.sha384);
  8988. if (ret != 0)
  8989. return ret;
  8990. break;
  8991. #endif
  8992. #ifdef WOLFSSL_TLS13_SHA512
  8993. case sha512_mac:
  8994. wc_Sha512Free(&ssl->hsHashes->hashSha512);
  8995. ret = wc_Sha512Copy(&digest.sha512, &ssl->hsHashes->hashSha512);
  8996. wc_Sha512Free(&digest.sha512);
  8997. if (ret != 0)
  8998. return ret;
  8999. break;
  9000. #endif
  9001. }
  9002. return ret;
  9003. }
  9004. #endif
  9005. /* Send New Session Ticket handshake message.
  9006. * Message contains the information required to perform resumption.
  9007. *
  9008. * ssl The SSL/TLS object.
  9009. * returns 0 on success, otherwise failure.
  9010. */
  9011. static int SendTls13NewSessionTicket(WOLFSSL* ssl)
  9012. {
  9013. byte* output;
  9014. int ret;
  9015. int sendSz;
  9016. word16 extSz;
  9017. word32 length;
  9018. word32 idx = RECORD_HEADER_SZ + HANDSHAKE_HEADER_SZ;
  9019. WOLFSSL_START(WC_FUNC_NEW_SESSION_TICKET_SEND);
  9020. WOLFSSL_ENTER("SendTls13NewSessionTicket");
  9021. #ifdef WOLFSSL_DTLS13
  9022. if (ssl->options.dtls)
  9023. idx = Dtls13GetRlHeaderLength(ssl, 1) + DTLS_HANDSHAKE_HEADER_SZ;
  9024. #endif /* WOLFSSL_DTLS13 */
  9025. #ifdef WOLFSSL_TLS13_TICKET_BEFORE_FINISHED
  9026. if (!ssl->msgsReceived.got_finished) {
  9027. if ((ret = ExpectedResumptionSecret(ssl)) != 0)
  9028. return ret;
  9029. }
  9030. #endif
  9031. /* Start ticket nonce at 0 and go up to 255. */
  9032. if (ssl->session->ticketNonce.len == 0) {
  9033. ssl->session->ticketNonce.len = DEF_TICKET_NONCE_SZ;
  9034. ssl->session->ticketNonce.data[0] = 0;
  9035. }
  9036. else
  9037. #ifdef WOLFSSL_ASYNC_CRYPT
  9038. if (ssl->error != WC_PENDING_E)
  9039. #endif
  9040. {
  9041. ssl->session->ticketNonce.data[0]++;
  9042. }
  9043. if (!ssl->options.noTicketTls13) {
  9044. if ((ret = CreateTicket(ssl)) != 0)
  9045. return ret;
  9046. }
  9047. #ifdef WOLFSSL_EARLY_DATA
  9048. ssl->session->maxEarlyDataSz = ssl->options.maxEarlyDataSz;
  9049. if (ssl->session->maxEarlyDataSz > 0)
  9050. TLSX_EarlyData_Use(ssl, ssl->session->maxEarlyDataSz, 1);
  9051. extSz = 0;
  9052. ret = TLSX_GetResponseSize(ssl, session_ticket, &extSz);
  9053. if (ret != 0)
  9054. return ret;
  9055. #else
  9056. extSz = EXTS_SZ;
  9057. #endif
  9058. /* Lifetime | Age Add | Ticket | Extensions */
  9059. length = SESSION_HINT_SZ + SESSION_ADD_SZ + LENGTH_SZ +
  9060. ssl->session->ticketLen + extSz;
  9061. /* Nonce */
  9062. length += TICKET_NONCE_LEN_SZ + DEF_TICKET_NONCE_SZ;
  9063. sendSz = idx + length + MAX_MSG_EXTRA;
  9064. /* Check buffers are big enough and grow if needed. */
  9065. if ((ret = CheckAvailableSize(ssl, sendSz)) != 0)
  9066. return ret;
  9067. /* Get position in output buffer to write new message to. */
  9068. output = ssl->buffers.outputBuffer.buffer +
  9069. ssl->buffers.outputBuffer.length;
  9070. /* Put the record and handshake headers on. */
  9071. AddTls13Headers(output, length, session_ticket, ssl);
  9072. /* Lifetime hint */
  9073. c32toa(ssl->ctx->ticketHint, output + idx);
  9074. idx += SESSION_HINT_SZ;
  9075. /* Age add - obfuscator */
  9076. c32toa(ssl->session->ticketAdd, output + idx);
  9077. idx += SESSION_ADD_SZ;
  9078. output[idx++] = ssl->session->ticketNonce.len;
  9079. output[idx++] = ssl->session->ticketNonce.data[0];
  9080. /* length */
  9081. c16toa(ssl->session->ticketLen, output + idx);
  9082. idx += LENGTH_SZ;
  9083. /* ticket */
  9084. XMEMCPY(output + idx, ssl->session->ticket, ssl->session->ticketLen);
  9085. idx += ssl->session->ticketLen;
  9086. #ifdef WOLFSSL_EARLY_DATA
  9087. extSz = 0;
  9088. ret = TLSX_WriteResponse(ssl, output + idx, session_ticket, &extSz);
  9089. if (ret != 0)
  9090. return ret;
  9091. idx += extSz;
  9092. #else
  9093. /* No extension support - empty extensions. */
  9094. c16toa(0, output + idx);
  9095. idx += EXTS_SZ;
  9096. #endif
  9097. ssl->options.haveSessionId = 1;
  9098. #ifndef NO_SESSION_CACHE
  9099. AddSession(ssl);
  9100. #endif
  9101. #ifdef WOLFSSL_DTLS13
  9102. if (ssl->options.dtls)
  9103. return Dtls13HandshakeSend(ssl, output, sendSz, idx, session_ticket, 0);
  9104. #endif /* WOLFSSL_DTLS13 */
  9105. /* This message is always encrypted. */
  9106. sendSz = BuildTls13Message(ssl, output, sendSz, output + RECORD_HEADER_SZ,
  9107. idx - RECORD_HEADER_SZ, handshake, 0, 0, 0);
  9108. if (sendSz < 0)
  9109. return sendSz;
  9110. ssl->buffers.outputBuffer.length += sendSz;
  9111. /* Always send as this is either directly after server's Finished or only
  9112. * message after client's Finished.
  9113. */
  9114. ret = SendBuffered(ssl);
  9115. WOLFSSL_LEAVE("SendTls13NewSessionTicket", 0);
  9116. WOLFSSL_END(WC_FUNC_NEW_SESSION_TICKET_SEND);
  9117. return ret;
  9118. }
  9119. #endif /* HAVE_SESSION_TICKET */
  9120. #endif /* NO_WOLFSSL_SERVER */
  9121. /* Make sure no duplicates, no fast forward, or other problems
  9122. *
  9123. * ssl The SSL/TLS object.
  9124. * type Type of handshake message received.
  9125. * returns 0 on success, otherwise failure.
  9126. */
  9127. static int SanityCheckTls13MsgReceived(WOLFSSL* ssl, byte type)
  9128. {
  9129. /* verify not a duplicate, mark received, check state */
  9130. switch (type) {
  9131. #ifndef NO_WOLFSSL_SERVER
  9132. case client_hello:
  9133. #ifndef NO_WOLFSSL_CLIENT
  9134. /* Only valid when received on SERVER side. */
  9135. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  9136. WOLFSSL_MSG("ClientHello received by client");
  9137. WOLFSSL_ERROR_VERBOSE(SIDE_ERROR);
  9138. return SIDE_ERROR;
  9139. }
  9140. #endif
  9141. /* Check state. */
  9142. if (ssl->options.clientState >= CLIENT_HELLO_COMPLETE) {
  9143. WOLFSSL_MSG("ClientHello received out of order");
  9144. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9145. return OUT_OF_ORDER_E;
  9146. }
  9147. /* Check previously seen. */
  9148. /* Initial and after HelloRetryRequest - no more than 2. */
  9149. if (ssl->msgsReceived.got_client_hello == 2) {
  9150. WOLFSSL_MSG("Too many ClientHello received");
  9151. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9152. return DUPLICATE_MSG_E;
  9153. }
  9154. /* Second only after HelloRetryRequest seen. */
  9155. if (ssl->msgsReceived.got_client_hello == 1 &&
  9156. ssl->options.serverState !=
  9157. SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  9158. WOLFSSL_MSG("Duplicate ClientHello received");
  9159. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9160. return DUPLICATE_MSG_E;
  9161. }
  9162. ssl->msgsReceived.got_client_hello++;
  9163. break;
  9164. #endif
  9165. #ifndef NO_WOLFSSL_CLIENT
  9166. case server_hello:
  9167. #ifndef NO_WOLFSSL_SERVER
  9168. /* Only valid when received on CLIENT side. */
  9169. if (ssl->options.side == WOLFSSL_SERVER_END) {
  9170. WOLFSSL_MSG("ServerHello received by server");
  9171. WOLFSSL_ERROR_VERBOSE(SIDE_ERROR);
  9172. return SIDE_ERROR;
  9173. }
  9174. #endif
  9175. /* Check state. */
  9176. if (ssl->options.serverState >= SERVER_HELLO_COMPLETE) {
  9177. WOLFSSL_MSG("ServerHello received out of order");
  9178. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9179. return OUT_OF_ORDER_E;
  9180. }
  9181. /* Check previously seen. */
  9182. /* Only once after ClientHello.
  9183. * HelloRetryRequest has ServerHello type but count fixed up later
  9184. * - see DoTls13ServerHello().
  9185. */
  9186. if (ssl->msgsReceived.got_server_hello) {
  9187. WOLFSSL_MSG("Duplicate ServerHello received");
  9188. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9189. return DUPLICATE_MSG_E;
  9190. }
  9191. ssl->msgsReceived.got_server_hello = 1;
  9192. break;
  9193. #endif
  9194. #ifndef NO_WOLFSSL_CLIENT
  9195. case session_ticket:
  9196. #ifndef NO_WOLFSSL_SERVER
  9197. /* Only valid when received on CLIENT side. */
  9198. if (ssl->options.side == WOLFSSL_SERVER_END) {
  9199. WOLFSSL_MSG("NewSessionTicket received by server");
  9200. WOLFSSL_ERROR_VERBOSE(SIDE_ERROR);
  9201. return SIDE_ERROR;
  9202. }
  9203. #endif
  9204. /* Check state. */
  9205. #ifdef WOLFSSL_TLS13_TICKET_BEFORE_FINISHED
  9206. /* Only allowed after server's Finished message. */
  9207. if (ssl->options.serverState < SERVER_FINISHED_COMPLETE) {
  9208. WOLFSSL_MSG("NewSessionTicket received out of order");
  9209. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9210. return OUT_OF_ORDER_E;
  9211. }
  9212. #else
  9213. /* Only allowed after client's Finished message. */
  9214. if (ssl->options.clientState < CLIENT_FINISHED_COMPLETE) {
  9215. WOLFSSL_MSG("NewSessionTicket received out of order");
  9216. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9217. return OUT_OF_ORDER_E;
  9218. }
  9219. #endif
  9220. /* Many SessionTickets can be sent. */
  9221. ssl->msgsReceived.got_session_ticket = 1;
  9222. break;
  9223. #endif
  9224. #ifndef NO_WOLFSSL_SERVER
  9225. #ifdef WOLFSSL_EARLY_DATA
  9226. case end_of_early_data:
  9227. #ifndef NO_WOLFSSL_CLIENT
  9228. /* Only valid when received on SERVER side. */
  9229. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  9230. WOLFSSL_MSG("EndOfEarlyData received by client");
  9231. WOLFSSL_ERROR_VERBOSE(SIDE_ERROR);
  9232. return SIDE_ERROR;
  9233. }
  9234. #endif
  9235. /* Check state. */
  9236. /* Only after server's Finished and before client's Finished. */
  9237. if (ssl->options.serverState < SERVER_FINISHED_COMPLETE) {
  9238. WOLFSSL_MSG("EndOfEarlyData received out of order");
  9239. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9240. return OUT_OF_ORDER_E;
  9241. }
  9242. if (ssl->options.clientState >= CLIENT_FINISHED_COMPLETE) {
  9243. WOLFSSL_MSG("EndOfEarlyData received out of order");
  9244. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9245. return OUT_OF_ORDER_E;
  9246. }
  9247. /* Check previously seen. */
  9248. if (ssl->msgsReceived.got_end_of_early_data) {
  9249. WOLFSSL_MSG("Too many EndOfEarlyData received");
  9250. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9251. return DUPLICATE_MSG_E;
  9252. }
  9253. ssl->msgsReceived.got_end_of_early_data = 1;
  9254. break;
  9255. #endif
  9256. #endif
  9257. #ifndef NO_WOLFSSL_CLIENT
  9258. case encrypted_extensions:
  9259. #ifndef NO_WOLFSSL_SERVER
  9260. /* Only valid when received on CLIENT side. */
  9261. if (ssl->options.side == WOLFSSL_SERVER_END) {
  9262. WOLFSSL_MSG("EncryptedExtensions received by server");
  9263. WOLFSSL_ERROR_VERBOSE(SIDE_ERROR);
  9264. return SIDE_ERROR;
  9265. }
  9266. #endif
  9267. /* Check state. */
  9268. /* Must be received directly after ServerHello.
  9269. * DoTls13EncryptedExtensions() changes state to:
  9270. * SERVER_ENCRYPTED_EXTENSIONS_COMPLETE.
  9271. */
  9272. if (ssl->options.serverState != SERVER_HELLO_COMPLETE) {
  9273. WOLFSSL_MSG("EncryptedExtensions received out of order");
  9274. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9275. return OUT_OF_ORDER_E;
  9276. }
  9277. /* Check previously seen. */
  9278. if (ssl->msgsReceived.got_encrypted_extensions) {
  9279. WOLFSSL_MSG("Duplicate EncryptedExtensions received");
  9280. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9281. return DUPLICATE_MSG_E;
  9282. }
  9283. ssl->msgsReceived.got_encrypted_extensions = 1;
  9284. break;
  9285. #endif
  9286. case certificate:
  9287. /* Valid on both sides. */
  9288. #ifndef NO_WOLFSSL_CLIENT
  9289. /* Check state. */
  9290. /* On client, seen after EncryptedExtension and CertificateRequest
  9291. * (if sent) and before CertificateVerify and Finished.
  9292. * DoTls13Certificate() sets serverState to SERVER_CERT_COMPLETE.
  9293. */
  9294. if (ssl->options.side == WOLFSSL_CLIENT_END &&
  9295. ssl->options.serverState !=
  9296. SERVER_ENCRYPTED_EXTENSIONS_COMPLETE) {
  9297. WOLFSSL_MSG("Certificate received out of order - Client");
  9298. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9299. return OUT_OF_ORDER_E;
  9300. }
  9301. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  9302. /* Server's authenticating with PSK must not send this. */
  9303. if (ssl->options.side == WOLFSSL_CLIENT_END &&
  9304. ssl->options.serverState == SERVER_CERT_COMPLETE &&
  9305. ssl->options.pskNegotiated) {
  9306. WOLFSSL_MSG("Certificate received while using PSK");
  9307. WOLFSSL_ERROR_VERBOSE(SANITY_MSG_E);
  9308. return SANITY_MSG_E;
  9309. }
  9310. #endif
  9311. #endif
  9312. #ifndef NO_WOLFSSL_SERVER
  9313. /* Check state. */
  9314. /* On Server, valid after ClientHello received and ServerFinished
  9315. * sent. */
  9316. if (ssl->options.side == WOLFSSL_SERVER_END &&
  9317. ssl->options.clientState != CLIENT_HELLO_COMPLETE &&
  9318. ssl->options.serverState < SERVER_FINISHED_COMPLETE) {
  9319. WOLFSSL_MSG("Certificate received out of order - Server");
  9320. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9321. return OUT_OF_ORDER_E;
  9322. }
  9323. #endif
  9324. /* Check previously seen. */
  9325. if (ssl->msgsReceived.got_certificate) {
  9326. WOLFSSL_MSG("Duplicate Certificate received");
  9327. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9328. return DUPLICATE_MSG_E;
  9329. }
  9330. ssl->msgsReceived.got_certificate = 1;
  9331. break;
  9332. #ifndef NO_WOLFSSL_CLIENT
  9333. case certificate_request:
  9334. #ifndef NO_WOLFSSL_SERVER
  9335. /* Only valid when received on CLIENT side. */
  9336. if (ssl->options.side == WOLFSSL_SERVER_END) {
  9337. WOLFSSL_MSG("CertificateRequest received by server");
  9338. WOLFSSL_ERROR_VERBOSE(SIDE_ERROR);
  9339. return SIDE_ERROR;
  9340. }
  9341. #endif
  9342. /* Check state. */
  9343. #ifndef WOLFSSL_POST_HANDSHAKE_AUTH
  9344. /* Only valid when sent after EncryptedExtensions and before
  9345. * Certificate. */
  9346. if (ssl->options.serverState !=
  9347. SERVER_ENCRYPTED_EXTENSIONS_COMPLETE) {
  9348. WOLFSSL_MSG("CertificateRequest received out of order");
  9349. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9350. return OUT_OF_ORDER_E;
  9351. }
  9352. #else
  9353. /* Valid when sent after EncryptedExtensions and before Certificate
  9354. * and after both client and server have sent Finished (Post
  9355. * Handshake Authentication). */
  9356. if (ssl->options.serverState !=
  9357. SERVER_ENCRYPTED_EXTENSIONS_COMPLETE &&
  9358. (ssl->options.serverState < SERVER_FINISHED_COMPLETE ||
  9359. ssl->options.clientState != CLIENT_FINISHED_COMPLETE)) {
  9360. WOLFSSL_MSG("CertificateRequest received out of order");
  9361. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9362. return OUT_OF_ORDER_E;
  9363. }
  9364. #endif
  9365. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  9366. /* Server's authenticating with PSK must not send this. */
  9367. if (ssl->options.pskNegotiated) {
  9368. WOLFSSL_MSG("CertificateRequest received while using PSK");
  9369. WOLFSSL_ERROR_VERBOSE(SANITY_MSG_E);
  9370. return SANITY_MSG_E;
  9371. }
  9372. #endif
  9373. /* Check previously seen. */
  9374. #ifndef WOLFSSL_POST_HANDSHAKE_AUTH
  9375. /* Only once during handshake. */
  9376. if (ssl->msgsReceived.got_certificate_request) {
  9377. WOLFSSL_MSG("Duplicate CertificateRequest received");
  9378. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9379. return DUPLICATE_MSG_E;
  9380. }
  9381. #else
  9382. /* Only once during handshake. */
  9383. if (ssl->msgsReceived.got_certificate_request &&
  9384. ssl->options.clientState != CLIENT_FINISHED_COMPLETE) {
  9385. WOLFSSL_MSG("Duplicate CertificateRequest received");
  9386. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9387. return DUPLICATE_MSG_E;
  9388. }
  9389. #endif
  9390. ssl->msgsReceived.got_certificate_request = 1;
  9391. break;
  9392. #endif
  9393. case certificate_verify:
  9394. /* Valid on both sides. */
  9395. #ifndef NO_WOLFSSL_CLIENT
  9396. /* Check state on client.
  9397. * Valid only directly after a Certificate message. */
  9398. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  9399. if (ssl->options.serverState != SERVER_CERT_COMPLETE) {
  9400. WOLFSSL_MSG("No Cert before CertVerify");
  9401. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9402. return OUT_OF_ORDER_E;
  9403. }
  9404. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  9405. /* Server's authenticating with PSK must not send this. */
  9406. if (ssl->options.pskNegotiated) {
  9407. WOLFSSL_MSG("CertificateVerify received while using PSK");
  9408. WOLFSSL_ERROR_VERBOSE(SANITY_MSG_E);
  9409. return SANITY_MSG_E;
  9410. }
  9411. #endif
  9412. }
  9413. #endif
  9414. #ifndef NO_WOLFSSL_SERVER
  9415. /* Check state on server. */
  9416. if (ssl->options.side == WOLFSSL_SERVER_END) {
  9417. /* Server must have sent Finished message. */
  9418. if (ssl->options.serverState < SERVER_FINISHED_COMPLETE) {
  9419. WOLFSSL_MSG("CertificateVerify received out of order");
  9420. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9421. return OUT_OF_ORDER_E;
  9422. }
  9423. /* Valid only directly after a Certificate message. */
  9424. if (ssl->options.clientState < CLIENT_HELLO_COMPLETE) {
  9425. WOLFSSL_MSG("CertificateVerify before ClientHello done");
  9426. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9427. return OUT_OF_ORDER_E;
  9428. }
  9429. if (!ssl->msgsReceived.got_certificate) {
  9430. WOLFSSL_MSG("No Cert before CertificateVerify");
  9431. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9432. return OUT_OF_ORDER_E;
  9433. }
  9434. }
  9435. #endif
  9436. /* Check previously seen. */
  9437. if (ssl->msgsReceived.got_certificate_verify) {
  9438. WOLFSSL_MSG("Duplicate CertificateVerify received");
  9439. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9440. return DUPLICATE_MSG_E;
  9441. }
  9442. ssl->msgsReceived.got_certificate_verify = 1;
  9443. break;
  9444. case finished:
  9445. /* Valid on both sides. */
  9446. #ifndef NO_WOLFSSL_CLIENT
  9447. /* Check state on client. */
  9448. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  9449. /* After sending ClientHello */
  9450. if (ssl->options.clientState < CLIENT_HELLO_COMPLETE) {
  9451. WOLFSSL_MSG("Finished received out of order - clientState");
  9452. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9453. return OUT_OF_ORDER_E;
  9454. }
  9455. /* Must have seen certificate and verify from server except when
  9456. * using PSK. */
  9457. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  9458. if (ssl->options.pskNegotiated) {
  9459. if (ssl->options.serverState !=
  9460. SERVER_ENCRYPTED_EXTENSIONS_COMPLETE) {
  9461. WOLFSSL_MSG("Finished received out of order - PSK");
  9462. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9463. return OUT_OF_ORDER_E;
  9464. }
  9465. }
  9466. else
  9467. #endif
  9468. if (ssl->options.serverState != SERVER_CERT_VERIFY_COMPLETE) {
  9469. WOLFSSL_MSG("Finished received out of order - serverState");
  9470. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9471. return OUT_OF_ORDER_E;
  9472. }
  9473. }
  9474. #endif
  9475. #ifndef NO_WOLFSSL_SERVER
  9476. /* Check state on server. */
  9477. if (ssl->options.side == WOLFSSL_SERVER_END) {
  9478. if (ssl->options.serverState < SERVER_FINISHED_COMPLETE) {
  9479. WOLFSSL_MSG("Finished received out of order - serverState");
  9480. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9481. return OUT_OF_ORDER_E;
  9482. }
  9483. if (ssl->options.clientState < CLIENT_HELLO_COMPLETE) {
  9484. WOLFSSL_MSG("Finished received out of order - clientState");
  9485. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9486. return OUT_OF_ORDER_E;
  9487. }
  9488. #ifdef WOLFSSL_EARLY_DATA
  9489. if (ssl->earlyData == process_early_data &&
  9490. /* early data may be lost when using DTLS */
  9491. !ssl->options.dtls
  9492. /* QUIC does not use EndOfEarlyData records */
  9493. && !WOLFSSL_IS_QUIC(ssl)) {
  9494. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9495. return OUT_OF_ORDER_E;
  9496. }
  9497. #endif
  9498. }
  9499. #endif
  9500. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  9501. if (!ssl->options.pskNegotiated)
  9502. #endif
  9503. {
  9504. /* Must have received a Certificate message from client if
  9505. * verifying the peer. Empty certificate message indicates
  9506. * no certificate available.
  9507. */
  9508. if (ssl->options.verifyPeer &&
  9509. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  9510. !ssl->options.verifyPostHandshake &&
  9511. #endif
  9512. !ssl->msgsReceived.got_certificate) {
  9513. WOLFSSL_MSG("Finished received out of order - "
  9514. "missing Certificate message");
  9515. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9516. return OUT_OF_ORDER_E;
  9517. }
  9518. /* Mutual authentication on server requires a certificate from
  9519. * peer. Verify peer set on client side requires a certificate
  9520. * from peer as not doing PSK.
  9521. */
  9522. if ((ssl->options.mutualAuth ||
  9523. (ssl->options.side == WOLFSSL_CLIENT_END &&
  9524. ssl->options.verifyPeer)) && !ssl->options.havePeerCert) {
  9525. WOLFSSL_MSG("Finished received out of order - "
  9526. "no valid certificate");
  9527. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9528. return OUT_OF_ORDER_E;
  9529. }
  9530. /* Must have received a valid CertificateVerify if verifying
  9531. * peer and got a peer certificate.
  9532. */
  9533. if ((ssl->options.mutualAuth || ssl->options.verifyPeer) &&
  9534. ssl->options.havePeerCert && !ssl->options.havePeerVerify) {
  9535. WOLFSSL_MSG("Finished received out of order - "
  9536. "Certificate message but no CertificateVerify");
  9537. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9538. return OUT_OF_ORDER_E;
  9539. }
  9540. }
  9541. /* Check previously seen. */
  9542. if (ssl->msgsReceived.got_finished) {
  9543. WOLFSSL_MSG("Duplicate Finished received");
  9544. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9545. return DUPLICATE_MSG_E;
  9546. }
  9547. ssl->msgsReceived.got_finished = 1;
  9548. break;
  9549. case key_update:
  9550. /* Valid on both sides. */
  9551. /* Check state.
  9552. * Client and server must have received finished message from other
  9553. * side.
  9554. */
  9555. if (!ssl->msgsReceived.got_finished) {
  9556. WOLFSSL_MSG("No KeyUpdate before Finished");
  9557. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9558. return OUT_OF_ORDER_E;
  9559. }
  9560. /* Multiple KeyUpdates can be sent. */
  9561. break;
  9562. #if defined(WOLFSSL_DTLS13) && !defined(WOLFSSL_NO_TLS12)
  9563. case hello_verify_request:
  9564. if (!ssl->options.dtls) {
  9565. WOLFSSL_MSG("HelloVerifyRequest when not in DTLS");
  9566. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9567. return OUT_OF_ORDER_E;
  9568. }
  9569. if (ssl->msgsReceived.got_hello_verify_request) {
  9570. WOLFSSL_MSG("Duplicate HelloVerifyRequest received");
  9571. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9572. return DUPLICATE_MSG_E;
  9573. }
  9574. ssl->msgsReceived.got_hello_verify_request = 1;
  9575. if (ssl->msgsReceived.got_hello_retry_request) {
  9576. WOLFSSL_MSG(
  9577. "Both HelloVerifyRequest and HelloRetryRequest received");
  9578. WOLFSSL_ERROR_VERBOSE(DUPLICATE_MSG_E);
  9579. return DUPLICATE_MSG_E;
  9580. }
  9581. if (ssl->options.serverState >=
  9582. SERVER_HELLO_RETRY_REQUEST_COMPLETE ||
  9583. ssl->options.connectState != CLIENT_HELLO_SENT) {
  9584. WOLFSSL_MSG("HelloVerifyRequest received out of order");
  9585. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9586. return OUT_OF_ORDER_E;
  9587. }
  9588. if (ssl->options.side == WOLFSSL_SERVER_END) {
  9589. WOLFSSL_MSG("HelloVerifyRequest recevied on the server");
  9590. WOLFSSL_ERROR_VERBOSE(SIDE_ERROR);
  9591. return SIDE_ERROR;
  9592. }
  9593. if (!ssl->options.downgrade ||
  9594. ssl->options.minDowngrade < DTLSv1_2_MINOR) {
  9595. WOLFSSL_MSG(
  9596. "HelloVerifyRequest recevied but not DTLSv1.2 allowed");
  9597. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  9598. return VERSION_ERROR;
  9599. }
  9600. break;
  9601. #endif /* WOLFSSL_DTLS13 && !WOLFSSL_NO_TLS12*/
  9602. default:
  9603. WOLFSSL_MSG("Unknown message type");
  9604. WOLFSSL_ERROR_VERBOSE(SANITY_MSG_E);
  9605. return SANITY_MSG_E;
  9606. }
  9607. return 0;
  9608. }
  9609. /* Handle a type of handshake message that has been received.
  9610. *
  9611. * ssl The SSL/TLS object.
  9612. * input The message buffer.
  9613. * inOutIdx On entry, the index into the buffer of the current message.
  9614. * On exit, the index into the buffer of the next message.
  9615. * size The length of the current handshake message.
  9616. * totalSz Length of remaining data in the message buffer.
  9617. * returns 0 on success and otherwise failure.
  9618. */
  9619. int DoTls13HandShakeMsgType(WOLFSSL* ssl, byte* input, word32* inOutIdx,
  9620. byte type, word32 size, word32 totalSz)
  9621. {
  9622. int ret = 0;
  9623. word32 inIdx = *inOutIdx;
  9624. #if defined(HAVE_ECH)
  9625. TLSX* echX = NULL;
  9626. word32 echInOutIdx;
  9627. #endif
  9628. (void)totalSz;
  9629. WOLFSSL_ENTER("DoTls13HandShakeMsgType");
  9630. /* make sure we can read the message */
  9631. if (*inOutIdx + size > totalSz)
  9632. return INCOMPLETE_DATA;
  9633. /* sanity check msg received */
  9634. if ((ret = SanityCheckTls13MsgReceived(ssl, type)) != 0) {
  9635. WOLFSSL_MSG("Sanity Check on handshake message type received failed");
  9636. if (ret == VERSION_ERROR)
  9637. SendAlert(ssl, alert_fatal, wolfssl_alert_protocol_version);
  9638. else
  9639. SendAlert(ssl, alert_fatal, unexpected_message);
  9640. return ret;
  9641. }
  9642. #if defined(WOLFSSL_CALLBACKS)
  9643. /* add name later, add on record and handshake header part back on */
  9644. if (ssl->toInfoOn) {
  9645. ret = AddPacketInfo(ssl, 0, handshake, input + *inOutIdx -
  9646. HANDSHAKE_HEADER_SZ, size + HANDSHAKE_HEADER_SZ, READ_PROTO,
  9647. RECORD_HEADER_SZ, ssl->heap);
  9648. if (ret != 0)
  9649. return ret;
  9650. AddLateRecordHeader(&ssl->curRL, &ssl->timeoutInfo);
  9651. }
  9652. #endif
  9653. if (ssl->options.handShakeState == HANDSHAKE_DONE &&
  9654. type != session_ticket && type != certificate_request &&
  9655. type != certificate && type != key_update && type != finished) {
  9656. WOLFSSL_MSG("HandShake message after handshake complete");
  9657. SendAlert(ssl, alert_fatal, unexpected_message);
  9658. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9659. return OUT_OF_ORDER_E;
  9660. }
  9661. if (ssl->options.side == WOLFSSL_CLIENT_END &&
  9662. ssl->options.serverState == NULL_STATE &&
  9663. type != server_hello && type != hello_retry_request
  9664. #if defined(WOLFSSL_DTLS13) && !defined(WOLFSSL_NO_TLS12)
  9665. && (!ssl->options.dtls || type != hello_verify_request)
  9666. #endif /* defined(WOLFSSL_DTLS13) && !defined(WOLFSSL_NO_TLS12) */
  9667. ) {
  9668. WOLFSSL_MSG("First server message not server hello");
  9669. SendAlert(ssl, alert_fatal, unexpected_message);
  9670. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9671. return OUT_OF_ORDER_E;
  9672. }
  9673. if (ssl->options.side == WOLFSSL_SERVER_END &&
  9674. ssl->options.clientState == NULL_STATE && type != client_hello) {
  9675. WOLFSSL_MSG("First client message not client hello");
  9676. SendAlert(ssl, alert_fatal, unexpected_message);
  9677. WOLFSSL_ERROR_VERBOSE(OUT_OF_ORDER_E);
  9678. return OUT_OF_ORDER_E;
  9679. }
  9680. /* above checks handshake state */
  9681. switch (type) {
  9682. #ifndef NO_WOLFSSL_CLIENT
  9683. /* Messages only received by client. */
  9684. case server_hello:
  9685. WOLFSSL_MSG("processing server hello");
  9686. ret = DoTls13ServerHello(ssl, input, inOutIdx, size, &type);
  9687. #if !defined(WOLFSSL_NO_CLIENT_AUTH) && \
  9688. ((defined(HAVE_ED25519) && !defined(NO_ED25519_CLIENT_AUTH)) || \
  9689. (defined(HAVE_ED448) && !defined(NO_ED448_CLIENT_AUTH)))
  9690. if (ssl->options.resuming || !IsAtLeastTLSv1_2(ssl) ||
  9691. IsAtLeastTLSv1_3(ssl->version)) {
  9692. ssl->options.cacheMessages = 0;
  9693. if ((ssl->hsHashes != NULL) && (ssl->hsHashes->messages != NULL)) {
  9694. ForceZero(ssl->hsHashes->messages, ssl->hsHashes->length);
  9695. XFREE(ssl->hsHashes->messages, ssl->heap, DYNAMIC_TYPE_HASHES);
  9696. ssl->hsHashes->messages = NULL;
  9697. }
  9698. }
  9699. #endif
  9700. break;
  9701. case encrypted_extensions:
  9702. WOLFSSL_MSG("processing encrypted extensions");
  9703. ret = DoTls13EncryptedExtensions(ssl, input, inOutIdx, size);
  9704. break;
  9705. #ifndef NO_CERTS
  9706. case certificate_request:
  9707. WOLFSSL_MSG("processing certificate request");
  9708. ret = DoTls13CertificateRequest(ssl, input, inOutIdx, size);
  9709. break;
  9710. #endif
  9711. case session_ticket:
  9712. WOLFSSL_MSG("processing new session ticket");
  9713. ret = DoTls13NewSessionTicket(ssl, input, inOutIdx, size);
  9714. break;
  9715. #endif /* !NO_WOLFSSL_CLIENT */
  9716. #ifndef NO_WOLFSSL_SERVER
  9717. /* Messages only received by server. */
  9718. case client_hello:
  9719. WOLFSSL_MSG("processing client hello");
  9720. #if defined(HAVE_ECH)
  9721. /* keep the start idx so we can restore it for the inner call */
  9722. echInOutIdx = *inOutIdx;
  9723. #endif
  9724. ret = DoTls13ClientHello(ssl, input, inOutIdx, size);
  9725. #if defined(HAVE_ECH)
  9726. if (ret == 0) {
  9727. echX = TLSX_Find(ssl->extensions, TLSX_ECH);
  9728. if (echX != NULL &&
  9729. ((WOLFSSL_ECH*)echX->data)->state == ECH_WRITE_NONE) {
  9730. /* reset the inOutIdx to the outer start */
  9731. *inOutIdx = echInOutIdx;
  9732. /* call again with the inner hello */
  9733. ret = DoTls13ClientHello(ssl,
  9734. ((WOLFSSL_ECH*)echX->data)->innerClientHello,
  9735. &echInOutIdx,
  9736. ((WOLFSSL_ECH*)echX->data)->innerClientHelloLen);
  9737. /* if the inner ech parsed successfully we have sucessfully
  9738. * handled the hello and can skip the whole message */
  9739. if (ret == 0)
  9740. *inOutIdx += size;
  9741. }
  9742. }
  9743. #endif /* HAVE_ECH */
  9744. break;
  9745. #ifdef WOLFSSL_EARLY_DATA
  9746. case end_of_early_data:
  9747. WOLFSSL_MSG("processing end of early data");
  9748. ret = DoTls13EndOfEarlyData(ssl, input, inOutIdx, size);
  9749. break;
  9750. #endif
  9751. #endif /* !NO_WOLFSSL_SERVER */
  9752. /* Messages received by both client and server. */
  9753. #if !defined(NO_CERTS) && (!defined(NO_WOLFSSL_CLIENT) || \
  9754. !defined(WOLFSSL_NO_CLIENT_AUTH))
  9755. case certificate:
  9756. WOLFSSL_MSG("processing certificate");
  9757. ret = DoTls13Certificate(ssl, input, inOutIdx, size);
  9758. break;
  9759. #endif
  9760. #if !defined(NO_RSA) || defined(HAVE_ECC) || defined(HAVE_ED25519) || \
  9761. defined(HAVE_ED448) || defined(HAVE_PQC)
  9762. case certificate_verify:
  9763. WOLFSSL_MSG("processing certificate verify");
  9764. ret = DoTls13CertificateVerify(ssl, input, inOutIdx, size);
  9765. break;
  9766. #endif
  9767. case finished:
  9768. WOLFSSL_MSG("processing finished");
  9769. ret = DoTls13Finished(ssl, input, inOutIdx, size, totalSz, NO_SNIFF);
  9770. break;
  9771. case key_update:
  9772. WOLFSSL_MSG("processing key update");
  9773. ret = DoTls13KeyUpdate(ssl, input, inOutIdx, size);
  9774. break;
  9775. #if defined(WOLFSSL_DTLS13) && !defined(WOLFSSL_NO_TLS12) && \
  9776. !defined(NO_WOLFSSL_CLIENT)
  9777. case hello_verify_request:
  9778. WOLFSSL_MSG("processing hello verify request");
  9779. ret = DoHelloVerifyRequest(ssl, input, inOutIdx, size);
  9780. break;
  9781. #endif
  9782. default:
  9783. WOLFSSL_MSG("Unknown handshake message type");
  9784. ret = UNKNOWN_HANDSHAKE_TYPE;
  9785. break;
  9786. }
  9787. #if defined(WOLFSSL_ASYNC_CRYPT) || defined(WOLFSSL_ASYNC_IO)
  9788. /* if async, offset index so this msg will be processed again */
  9789. /* NOTE: check this now before other calls can overwrite ret */
  9790. if ((ret == WC_PENDING_E || ret == OCSP_WANT_READ) && *inOutIdx > 0) {
  9791. /* DTLS always stores a message in a buffer when async is enable, so we
  9792. * don't need to adjust for the extra bytes here (*inOutIdx is always
  9793. * == 0) */
  9794. *inOutIdx -= HANDSHAKE_HEADER_SZ;
  9795. }
  9796. #endif
  9797. /* reset error */
  9798. if (ret == 0 && ssl->error == WC_PENDING_E)
  9799. ssl->error = 0;
  9800. if (ret == 0 && type != client_hello && type != session_ticket &&
  9801. type != key_update) {
  9802. ret = HashInput(ssl, input + inIdx, size);
  9803. }
  9804. if (ret == BUFFER_ERROR || ret == MISSING_HANDSHAKE_DATA)
  9805. SendAlert(ssl, alert_fatal, decode_error);
  9806. else if (ret == EXT_NOT_ALLOWED || ret == PEER_KEY_ERROR ||
  9807. ret == ECC_PEERKEY_ERROR || ret == BAD_KEY_SHARE_DATA ||
  9808. ret == PSK_KEY_ERROR || ret == INVALID_PARAMETER) {
  9809. SendAlert(ssl, alert_fatal, illegal_parameter);
  9810. }
  9811. if (ret == 0 && ssl->options.tls1_3) {
  9812. /* Need to hash input message before deriving secrets. */
  9813. #ifndef NO_WOLFSSL_CLIENT
  9814. if (ssl->options.side == WOLFSSL_CLIENT_END) {
  9815. if (type == server_hello) {
  9816. if ((ret = DeriveEarlySecret(ssl)) != 0)
  9817. return ret;
  9818. if ((ret = DeriveHandshakeSecret(ssl)) != 0)
  9819. return ret;
  9820. if ((ret = DeriveTls13Keys(ssl, handshake_key,
  9821. ENCRYPT_AND_DECRYPT_SIDE, 1)) != 0) {
  9822. return ret;
  9823. }
  9824. #ifdef WOLFSSL_EARLY_DATA
  9825. if (ssl->earlyData != no_early_data) {
  9826. if ((ret = SetKeysSide(ssl, DECRYPT_SIDE_ONLY)) != 0)
  9827. return ret;
  9828. }
  9829. else
  9830. #endif
  9831. if ((ret = SetKeysSide(ssl, ENCRYPT_AND_DECRYPT_SIDE)) != 0)
  9832. return ret;
  9833. #ifdef WOLFSSL_DTLS13
  9834. if (ssl->options.dtls) {
  9835. w64wrapper epochHandshake;
  9836. epochHandshake = w64From32(0, DTLS13_EPOCH_HANDSHAKE);
  9837. ssl->dtls13Epoch = epochHandshake;
  9838. ssl->dtls13PeerEpoch = epochHandshake;
  9839. ret = Dtls13NewEpoch(
  9840. ssl, epochHandshake, ENCRYPT_AND_DECRYPT_SIDE);
  9841. if (ret != 0)
  9842. return ret;
  9843. ret = Dtls13SetEpochKeys(
  9844. ssl, epochHandshake, ENCRYPT_AND_DECRYPT_SIDE);
  9845. if (ret != 0)
  9846. return ret;
  9847. }
  9848. #endif /* WOLFSSL_DTLS13 */
  9849. }
  9850. if (type == finished) {
  9851. if ((ret = DeriveMasterSecret(ssl)) != 0)
  9852. return ret;
  9853. /* Last use of preMasterSecret - zeroize as soon as possible. */
  9854. ForceZero(ssl->arrays->preMasterSecret,
  9855. ssl->arrays->preMasterSz);
  9856. #ifdef WOLFSSL_EARLY_DATA
  9857. #ifdef WOLFSSL_QUIC
  9858. if (WOLFSSL_IS_QUIC(ssl) && ssl->earlyData != no_early_data) {
  9859. /* QUIC never sends/receives EndOfEarlyData, but having
  9860. * early data means the last encrpytion keys had not been
  9861. * set yet. */
  9862. if ((ret = SetKeysSide(ssl, ENCRYPT_SIDE_ONLY)) != 0)
  9863. return ret;
  9864. }
  9865. #endif
  9866. if ((ret = DeriveTls13Keys(ssl, traffic_key,
  9867. ENCRYPT_AND_DECRYPT_SIDE,
  9868. ssl->earlyData == no_early_data)) != 0) {
  9869. return ret;
  9870. }
  9871. #else
  9872. if ((ret = DeriveTls13Keys(ssl, traffic_key,
  9873. ENCRYPT_AND_DECRYPT_SIDE, 1)) != 0) {
  9874. return ret;
  9875. }
  9876. #endif
  9877. }
  9878. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  9879. if (type == certificate_request &&
  9880. ssl->options.handShakeState == HANDSHAKE_DONE) {
  9881. /* reset handshake states */
  9882. ssl->options.clientState = CLIENT_HELLO_COMPLETE;
  9883. ssl->options.connectState = FIRST_REPLY_DONE;
  9884. ssl->options.handShakeState = CLIENT_HELLO_COMPLETE;
  9885. ssl->options.processReply = 0; /* doProcessInit */
  9886. /*
  9887. DTLSv1.3 note: We can't reset serverState to
  9888. SERVER_FINISHED_COMPLETE with the goal that this connect
  9889. blocks until the cert/cert_verify/finished flight gets ACKed
  9890. by the server. The problem is that we will invoke
  9891. ProcessReplyEx() in that case, but we came here from
  9892. ProcessReplyEx() and it is not re-entrant safe (the input
  9893. buffer would still have the certificate_request message). */
  9894. if (wolfSSL_connect_TLSv13(ssl) != WOLFSSL_SUCCESS) {
  9895. ret = ssl->error;
  9896. if (ret != WC_PENDING_E)
  9897. ret = POST_HAND_AUTH_ERROR;
  9898. }
  9899. }
  9900. #endif
  9901. }
  9902. #endif /* NO_WOLFSSL_CLIENT */
  9903. #ifndef NO_WOLFSSL_SERVER
  9904. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  9905. if (ssl->options.side == WOLFSSL_SERVER_END && type == finished) {
  9906. ret = DeriveResumptionSecret(ssl, ssl->session->masterSecret);
  9907. if (ret != 0)
  9908. return ret;
  9909. }
  9910. #endif
  9911. #endif /* NO_WOLFSSL_SERVER */
  9912. }
  9913. WOLFSSL_LEAVE("DoTls13HandShakeMsgType()", ret);
  9914. return ret;
  9915. }
  9916. /* Handle a handshake message that has been received.
  9917. *
  9918. * ssl The SSL/TLS object.
  9919. * input The message buffer.
  9920. * inOutIdx On entry, the index into the buffer of the current message.
  9921. * On exit, the index into the buffer of the next message.
  9922. * totalSz Length of remaining data in the message buffer.
  9923. * returns 0 on success and otherwise failure.
  9924. */
  9925. int DoTls13HandShakeMsg(WOLFSSL* ssl, byte* input, word32* inOutIdx,
  9926. word32 totalSz)
  9927. {
  9928. int ret = 0;
  9929. word32 inputLength;
  9930. byte type;
  9931. word32 size = 0;
  9932. WOLFSSL_ENTER("DoTls13HandShakeMsg()");
  9933. if (ssl->arrays == NULL) {
  9934. if (GetHandshakeHeader(ssl, input, inOutIdx, &type, &size,
  9935. totalSz) != 0) {
  9936. SendAlert(ssl, alert_fatal, unexpected_message);
  9937. WOLFSSL_ERROR_VERBOSE(PARSE_ERROR);
  9938. return PARSE_ERROR;
  9939. }
  9940. return DoTls13HandShakeMsgType(ssl, input, inOutIdx, type, size,
  9941. totalSz);
  9942. }
  9943. inputLength = ssl->buffers.inputBuffer.length - *inOutIdx - ssl->keys.padSz;
  9944. /* If there is a pending fragmented handshake message,
  9945. * pending message size will be non-zero. */
  9946. if (ssl->arrays->pendingMsgSz == 0) {
  9947. if (GetHandshakeHeader(ssl, input, inOutIdx, &type, &size,
  9948. totalSz) != 0) {
  9949. WOLFSSL_ERROR_VERBOSE(PARSE_ERROR);
  9950. return PARSE_ERROR;
  9951. }
  9952. /* Cap the maximum size of a handshake message to something reasonable.
  9953. * By default is the maximum size of a certificate message assuming
  9954. * nine 2048-bit RSA certificates in the chain. */
  9955. if (size > MAX_HANDSHAKE_SZ) {
  9956. WOLFSSL_MSG("Handshake message too large");
  9957. WOLFSSL_ERROR_VERBOSE(HANDSHAKE_SIZE_ERROR);
  9958. return HANDSHAKE_SIZE_ERROR;
  9959. }
  9960. /* size is the size of the certificate message payload */
  9961. if (inputLength - HANDSHAKE_HEADER_SZ < size) {
  9962. ssl->arrays->pendingMsgType = type;
  9963. ssl->arrays->pendingMsgSz = size + HANDSHAKE_HEADER_SZ;
  9964. ssl->arrays->pendingMsg = (byte*)XMALLOC(size + HANDSHAKE_HEADER_SZ,
  9965. ssl->heap,
  9966. DYNAMIC_TYPE_ARRAYS);
  9967. if (ssl->arrays->pendingMsg == NULL)
  9968. return MEMORY_E;
  9969. XMEMCPY(ssl->arrays->pendingMsg,
  9970. input + *inOutIdx - HANDSHAKE_HEADER_SZ,
  9971. inputLength);
  9972. ssl->arrays->pendingMsgOffset = inputLength;
  9973. *inOutIdx += inputLength + ssl->keys.padSz - HANDSHAKE_HEADER_SZ;
  9974. return 0;
  9975. }
  9976. ret = DoTls13HandShakeMsgType(ssl, input, inOutIdx, type, size,
  9977. totalSz);
  9978. }
  9979. else {
  9980. if (inputLength + ssl->arrays->pendingMsgOffset >
  9981. ssl->arrays->pendingMsgSz) {
  9982. inputLength = ssl->arrays->pendingMsgSz -
  9983. ssl->arrays->pendingMsgOffset;
  9984. }
  9985. XMEMCPY(ssl->arrays->pendingMsg + ssl->arrays->pendingMsgOffset,
  9986. input + *inOutIdx, inputLength);
  9987. ssl->arrays->pendingMsgOffset += inputLength;
  9988. *inOutIdx += inputLength + ssl->keys.padSz;
  9989. if (ssl->arrays->pendingMsgOffset == ssl->arrays->pendingMsgSz)
  9990. {
  9991. word32 idx = 0;
  9992. ret = DoTls13HandShakeMsgType(ssl,
  9993. ssl->arrays->pendingMsg + HANDSHAKE_HEADER_SZ,
  9994. &idx, ssl->arrays->pendingMsgType,
  9995. ssl->arrays->pendingMsgSz - HANDSHAKE_HEADER_SZ,
  9996. ssl->arrays->pendingMsgSz);
  9997. #ifdef WOLFSSL_ASYNC_CRYPT
  9998. if (ret == WC_PENDING_E) {
  9999. /* setup to process fragment again */
  10000. ssl->arrays->pendingMsgOffset -= inputLength;
  10001. *inOutIdx -= inputLength + ssl->keys.padSz;
  10002. }
  10003. else
  10004. #endif
  10005. {
  10006. XFREE(ssl->arrays->pendingMsg, ssl->heap, DYNAMIC_TYPE_ARRAYS);
  10007. ssl->arrays->pendingMsg = NULL;
  10008. ssl->arrays->pendingMsgSz = 0;
  10009. }
  10010. }
  10011. }
  10012. WOLFSSL_LEAVE("DoTls13HandShakeMsg()", ret);
  10013. return ret;
  10014. }
  10015. #ifndef NO_WOLFSSL_CLIENT
  10016. /* The client connecting to the server.
  10017. * The protocol version is expecting to be TLS v1.3.
  10018. * If the server downgrades, and older versions of the protocol are compiled
  10019. * in, the client will fallback to wolfSSL_connect().
  10020. * Please see note at top of README if you get an error from connect.
  10021. *
  10022. * ssl The SSL/TLS object.
  10023. * returns WOLFSSL_SUCCESS on successful handshake, WOLFSSL_FATAL_ERROR when
  10024. * unrecoverable error occurs and 0 otherwise.
  10025. * For more error information use wolfSSL_get_error().
  10026. */
  10027. int wolfSSL_connect_TLSv13(WOLFSSL* ssl)
  10028. {
  10029. int advanceState;
  10030. int ret = 0;
  10031. WOLFSSL_ENTER("wolfSSL_connect_TLSv13()");
  10032. #ifdef HAVE_ERRNO_H
  10033. errno = 0;
  10034. #endif
  10035. if (ssl == NULL)
  10036. return BAD_FUNC_ARG;
  10037. if (ssl->options.side != WOLFSSL_CLIENT_END) {
  10038. ssl->error = SIDE_ERROR;
  10039. WOLFSSL_ERROR(ssl->error);
  10040. return WOLFSSL_FATAL_ERROR;
  10041. }
  10042. /* make sure this wolfSSL object has arrays and rng setup. Protects
  10043. * case where the WOLFSSL object is re-used via wolfSSL_clear() */
  10044. if ((ret = ReinitSSL(ssl, ssl->ctx, 0)) != 0) {
  10045. return ret;
  10046. }
  10047. #ifdef WOLFSSL_WOLFSENTRY_HOOKS
  10048. if ((ssl->ConnectFilter != NULL) &&
  10049. (ssl->options.connectState == CONNECT_BEGIN))
  10050. {
  10051. wolfSSL_netfilter_decision_t res;
  10052. if ((ssl->ConnectFilter(ssl, ssl->ConnectFilter_arg, &res) ==
  10053. WOLFSSL_SUCCESS) &&
  10054. (res == WOLFSSL_NETFILTER_REJECT)) {
  10055. ssl->error = SOCKET_FILTERED_E;
  10056. WOLFSSL_ERROR(ssl->error);
  10057. return WOLFSSL_FATAL_ERROR;
  10058. }
  10059. }
  10060. #endif /* WOLFSSL_WOLFSENTRY_HOOKS */
  10061. /* fragOffset is non-zero when sending fragments. On the last
  10062. * fragment, fragOffset is zero again, and the state can be
  10063. * advanced. Also, only advance from states in which we send data */
  10064. advanceState = (ssl->options.connectState == CONNECT_BEGIN ||
  10065. ssl->options.connectState == HELLO_AGAIN ||
  10066. (ssl->options.connectState >= FIRST_REPLY_DONE &&
  10067. ssl->options.connectState <= FIRST_REPLY_FOURTH));
  10068. #ifdef WOLFSSL_DTLS13
  10069. if (ssl->options.dtls)
  10070. advanceState = advanceState && !ssl->dtls13SendingFragments
  10071. && !ssl->dtls13SendingAckOrRtx;
  10072. #endif /* WOLFSSL_DTLS13 */
  10073. if (ssl->buffers.outputBuffer.length > 0
  10074. #ifdef WOLFSSL_ASYNC_CRYPT
  10075. /* do not send buffered or advance state if last error was an
  10076. async pending operation */
  10077. && ssl->error != WC_PENDING_E
  10078. #endif
  10079. ) {
  10080. if ((ssl->error = SendBuffered(ssl)) == 0) {
  10081. if (ssl->fragOffset == 0 && !ssl->options.buildingMsg) {
  10082. if (advanceState) {
  10083. #ifdef WOLFSSL_DTLS13
  10084. if (ssl->options.dtls && IsAtLeastTLSv1_3(ssl->version) &&
  10085. ssl->options.connectState == FIRST_REPLY_FOURTH) {
  10086. /* WAIT_FINISHED_ACK is a state added afterwards, but it
  10087. can't follow FIRST_REPLY_FOURTH in the enum order. Indeed
  10088. the value of the enum ConnectState is stored in
  10089. serialized session. This would make importing serialized
  10090. session from other wolfSSL version incompatible */
  10091. ssl->options.connectState = WAIT_FINISHED_ACK;
  10092. }
  10093. else
  10094. #endif /* WOLFSSL_DTLS13 */
  10095. {
  10096. ssl->options.connectState++;
  10097. }
  10098. WOLFSSL_MSG("connect state: "
  10099. "Advanced from last buffered fragment send");
  10100. #ifdef WOLFSSL_ASYNC_IO
  10101. FreeAsyncCtx(ssl, 0);
  10102. #endif
  10103. }
  10104. }
  10105. else {
  10106. WOLFSSL_MSG("connect state: "
  10107. "Not advanced, more fragments to send");
  10108. }
  10109. #ifdef WOLFSSL_DTLS13
  10110. if (ssl->options.dtls)
  10111. ssl->dtls13SendingAckOrRtx = 0;
  10112. #endif /* WOLFSSL_DTLS13 */
  10113. }
  10114. else {
  10115. ssl->error = ret;
  10116. WOLFSSL_ERROR(ssl->error);
  10117. return WOLFSSL_FATAL_ERROR;
  10118. }
  10119. }
  10120. ret = RetrySendAlert(ssl);
  10121. if (ret != 0) {
  10122. ssl->error = ret;
  10123. WOLFSSL_ERROR(ssl->error);
  10124. return WOLFSSL_FATAL_ERROR;
  10125. }
  10126. #ifdef WOLFSSL_DTLS13
  10127. if (ssl->options.dtls && ssl->dtls13SendingFragments) {
  10128. if ((ssl->error = Dtls13FragmentsContinue(ssl)) != 0) {
  10129. WOLFSSL_ERROR(ssl->error);
  10130. return WOLFSSL_FATAL_ERROR;
  10131. }
  10132. /* we sent all the fragments. Advance state. */
  10133. ssl->options.connectState++;
  10134. }
  10135. #endif /* WOLFSSL_DTLS13 */
  10136. switch (ssl->options.connectState) {
  10137. case CONNECT_BEGIN:
  10138. /* Always send client hello first. */
  10139. if ((ssl->error = SendTls13ClientHello(ssl)) != 0) {
  10140. WOLFSSL_ERROR(ssl->error);
  10141. return WOLFSSL_FATAL_ERROR;
  10142. }
  10143. ssl->options.connectState = CLIENT_HELLO_SENT;
  10144. WOLFSSL_MSG("connect state: CLIENT_HELLO_SENT");
  10145. #ifdef WOLFSSL_EARLY_DATA
  10146. if (ssl->earlyData != no_early_data) {
  10147. #if defined(WOLFSSL_TLS13_MIDDLEBOX_COMPAT)
  10148. if (!ssl->options.dtls && ssl->options.tls13MiddleBoxCompat) {
  10149. if ((ssl->error = SendChangeCipher(ssl)) != 0) {
  10150. WOLFSSL_ERROR(ssl->error);
  10151. return WOLFSSL_FATAL_ERROR;
  10152. }
  10153. ssl->options.sentChangeCipher = 1;
  10154. }
  10155. #endif
  10156. ssl->options.handShakeState = CLIENT_HELLO_COMPLETE;
  10157. return WOLFSSL_SUCCESS;
  10158. }
  10159. #endif
  10160. FALL_THROUGH;
  10161. case CLIENT_HELLO_SENT:
  10162. /* Get the response/s from the server. */
  10163. while (ssl->options.serverState <
  10164. SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  10165. if ((ssl->error = ProcessReply(ssl)) < 0) {
  10166. WOLFSSL_ERROR(ssl->error);
  10167. return WOLFSSL_FATAL_ERROR;
  10168. }
  10169. #ifdef WOLFSSL_DTLS13
  10170. if (ssl->options.dtls) {
  10171. if ((ssl->error = Dtls13DoScheduledWork(ssl)) < 0) {
  10172. WOLFSSL_ERROR(ssl->error);
  10173. return WOLFSSL_FATAL_ERROR;
  10174. }
  10175. }
  10176. #endif /* WOLFSSL_DTLS13 */
  10177. }
  10178. if (!ssl->options.tls1_3) {
  10179. #ifndef WOLFSSL_NO_TLS12
  10180. if (ssl->options.downgrade)
  10181. return wolfSSL_connect(ssl);
  10182. #endif
  10183. WOLFSSL_MSG("Client using higher version, fatal error");
  10184. WOLFSSL_ERROR_VERBOSE(VERSION_ERROR);
  10185. return VERSION_ERROR;
  10186. }
  10187. ssl->options.connectState = HELLO_AGAIN;
  10188. WOLFSSL_MSG("connect state: HELLO_AGAIN");
  10189. FALL_THROUGH;
  10190. case HELLO_AGAIN:
  10191. if (ssl->options.serverState ==
  10192. SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  10193. #if defined(WOLFSSL_TLS13_MIDDLEBOX_COMPAT)
  10194. if (!ssl->options.dtls && !ssl->options.sentChangeCipher
  10195. && ssl->options.tls13MiddleBoxCompat) {
  10196. if ((ssl->error = SendChangeCipher(ssl)) != 0) {
  10197. WOLFSSL_ERROR(ssl->error);
  10198. return WOLFSSL_FATAL_ERROR;
  10199. }
  10200. ssl->options.sentChangeCipher = 1;
  10201. }
  10202. #endif
  10203. /* Try again with different security parameters. */
  10204. if ((ssl->error = SendTls13ClientHello(ssl)) != 0) {
  10205. WOLFSSL_ERROR(ssl->error);
  10206. return WOLFSSL_FATAL_ERROR;
  10207. }
  10208. }
  10209. ssl->options.connectState = HELLO_AGAIN_REPLY;
  10210. WOLFSSL_MSG("connect state: HELLO_AGAIN_REPLY");
  10211. FALL_THROUGH;
  10212. case HELLO_AGAIN_REPLY:
  10213. /* Get the response/s from the server. */
  10214. while (ssl->options.serverState < SERVER_FINISHED_COMPLETE) {
  10215. if ((ssl->error = ProcessReply(ssl)) < 0) {
  10216. WOLFSSL_ERROR(ssl->error);
  10217. return WOLFSSL_FATAL_ERROR;
  10218. }
  10219. #ifdef WOLFSSL_DTLS13
  10220. if (ssl->options.dtls) {
  10221. if ((ssl->error = Dtls13DoScheduledWork(ssl)) < 0) {
  10222. WOLFSSL_ERROR(ssl->error);
  10223. return WOLFSSL_FATAL_ERROR;
  10224. }
  10225. }
  10226. #endif /* WOLFSSL_DTLS13 */
  10227. }
  10228. ssl->options.connectState = FIRST_REPLY_DONE;
  10229. WOLFSSL_MSG("connect state: FIRST_REPLY_DONE");
  10230. FALL_THROUGH;
  10231. case FIRST_REPLY_DONE:
  10232. if (ssl->options.certOnly)
  10233. return WOLFSSL_SUCCESS;
  10234. #ifdef WOLFSSL_EARLY_DATA
  10235. if (!ssl->options.dtls && ssl->earlyData != no_early_data
  10236. && !WOLFSSL_IS_QUIC(ssl)) {
  10237. if ((ssl->error = SendTls13EndOfEarlyData(ssl)) != 0) {
  10238. WOLFSSL_ERROR(ssl->error);
  10239. return WOLFSSL_FATAL_ERROR;
  10240. }
  10241. WOLFSSL_MSG("sent: end_of_early_data");
  10242. }
  10243. #endif
  10244. ssl->options.connectState = FIRST_REPLY_FIRST;
  10245. WOLFSSL_MSG("connect state: FIRST_REPLY_FIRST");
  10246. FALL_THROUGH;
  10247. case FIRST_REPLY_FIRST:
  10248. #if defined(WOLFSSL_TLS13_MIDDLEBOX_COMPAT)
  10249. if (!ssl->options.sentChangeCipher && !ssl->options.dtls
  10250. && ssl->options.tls13MiddleBoxCompat) {
  10251. if ((ssl->error = SendChangeCipher(ssl)) != 0) {
  10252. WOLFSSL_ERROR(ssl->error);
  10253. return WOLFSSL_FATAL_ERROR;
  10254. }
  10255. ssl->options.sentChangeCipher = 1;
  10256. }
  10257. #endif
  10258. ssl->options.connectState = FIRST_REPLY_SECOND;
  10259. WOLFSSL_MSG("connect state: FIRST_REPLY_SECOND");
  10260. FALL_THROUGH;
  10261. case FIRST_REPLY_SECOND:
  10262. /* CLIENT: check peer authentication. */
  10263. if (!ssl->options.peerAuthGood) {
  10264. WOLFSSL_MSG("Server authentication did not happen");
  10265. WOLFSSL_ERROR_VERBOSE(WOLFSSL_FATAL_ERROR);
  10266. return WOLFSSL_FATAL_ERROR;
  10267. }
  10268. #ifndef NO_CERTS
  10269. if (!ssl->options.resuming && ssl->options.sendVerify) {
  10270. ssl->error = SendTls13Certificate(ssl);
  10271. if (ssl->error != 0) {
  10272. #ifdef WOLFSSL_CHECK_ALERT_ON_ERR
  10273. ProcessReplyEx(ssl, 1); /* See if an alert was sent. */
  10274. #endif
  10275. WOLFSSL_ERROR(ssl->error);
  10276. return WOLFSSL_FATAL_ERROR;
  10277. }
  10278. WOLFSSL_MSG("sent: certificate");
  10279. }
  10280. #endif
  10281. ssl->options.connectState = FIRST_REPLY_THIRD;
  10282. WOLFSSL_MSG("connect state: FIRST_REPLY_THIRD");
  10283. FALL_THROUGH;
  10284. case FIRST_REPLY_THIRD:
  10285. #if (!defined(NO_CERTS) && (!defined(NO_RSA) || defined(HAVE_ECC) || \
  10286. defined(HAVE_ED25519) || defined(HAVE_ED448) || \
  10287. defined(HAVE_PQC))) && (!defined(NO_WOLFSSL_SERVER) || \
  10288. !defined(WOLFSSL_NO_CLIENT_AUTH))
  10289. if (!ssl->options.resuming && ssl->options.sendVerify) {
  10290. ssl->error = SendTls13CertificateVerify(ssl);
  10291. if (ssl->error != 0) {
  10292. #ifdef WOLFSSL_CHECK_ALERT_ON_ERR
  10293. ProcessReplyEx(ssl, 1); /* See if an alert was sent. */
  10294. #endif
  10295. WOLFSSL_ERROR(ssl->error);
  10296. return WOLFSSL_FATAL_ERROR;
  10297. }
  10298. WOLFSSL_MSG("sent: certificate verify");
  10299. }
  10300. #endif
  10301. ssl->options.connectState = FIRST_REPLY_FOURTH;
  10302. WOLFSSL_MSG("connect state: FIRST_REPLY_FOURTH");
  10303. FALL_THROUGH;
  10304. case FIRST_REPLY_FOURTH:
  10305. if ((ssl->error = SendTls13Finished(ssl)) != 0) {
  10306. #ifdef WOLFSSL_CHECK_ALERT_ON_ERR
  10307. ProcessReplyEx(ssl, 1); /* See if an alert was sent. */
  10308. #endif
  10309. WOLFSSL_ERROR(ssl->error);
  10310. return WOLFSSL_FATAL_ERROR;
  10311. }
  10312. WOLFSSL_MSG("sent: finished");
  10313. #ifdef WOLFSSL_DTLS13
  10314. ssl->options.connectState = WAIT_FINISHED_ACK;
  10315. WOLFSSL_MSG("connect state: WAIT_FINISHED_ACK");
  10316. FALL_THROUGH;
  10317. case WAIT_FINISHED_ACK:
  10318. if (ssl->options.dtls) {
  10319. while (ssl->options.serverState != SERVER_FINISHED_ACKED) {
  10320. if ((ssl->error = ProcessReply(ssl)) < 0) {
  10321. WOLFSSL_ERROR(ssl->error);
  10322. return WOLFSSL_FATAL_ERROR;
  10323. }
  10324. if ((ssl->error = Dtls13DoScheduledWork(ssl)) < 0) {
  10325. WOLFSSL_ERROR(ssl->error);
  10326. return WOLFSSL_FATAL_ERROR;
  10327. }
  10328. }
  10329. }
  10330. #endif /* WOLFSSL_DTLS13 */
  10331. ssl->options.connectState = FINISHED_DONE;
  10332. WOLFSSL_MSG("connect state: FINISHED_DONE");
  10333. FALL_THROUGH;
  10334. case FINISHED_DONE:
  10335. #ifndef NO_HANDSHAKE_DONE_CB
  10336. if (ssl->hsDoneCb != NULL) {
  10337. int cbret = ssl->hsDoneCb(ssl, ssl->hsDoneCtx);
  10338. if (cbret < 0) {
  10339. ssl->error = cbret;
  10340. WOLFSSL_ERROR_VERBOSE(ssl->error);
  10341. WOLFSSL_MSG("HandShake Done Cb don't continue error");
  10342. return WOLFSSL_FATAL_ERROR;
  10343. }
  10344. }
  10345. #endif /* NO_HANDSHAKE_DONE_CB */
  10346. if (!ssl->options.keepResources) {
  10347. FreeHandshakeResources(ssl);
  10348. }
  10349. #if defined(WOLFSSL_ASYNC_IO) && !defined(WOLFSSL_ASYNC_CRYPT)
  10350. /* Free the remaining async context if not using it for crypto */
  10351. FreeAsyncCtx(ssl, 1);
  10352. #endif
  10353. ssl->error = 0; /* clear the error */
  10354. WOLFSSL_LEAVE("wolfSSL_connect_TLSv13()", WOLFSSL_SUCCESS);
  10355. return WOLFSSL_SUCCESS;
  10356. default:
  10357. WOLFSSL_MSG("Unknown connect state ERROR");
  10358. return WOLFSSL_FATAL_ERROR; /* unknown connect state */
  10359. }
  10360. }
  10361. #endif
  10362. #if defined(WOLFSSL_SEND_HRR_COOKIE)
  10363. /* Send a cookie with the HelloRetryRequest to avoid storing state.
  10364. *
  10365. * ssl SSL/TLS object.
  10366. * secret Secret to use when generating integrity check for cookie.
  10367. * A value of NULL indicates to generate a new random secret.
  10368. * secretSz Size of secret data in bytes.
  10369. * Use a value of 0 to indicate use of default size.
  10370. * returns BAD_FUNC_ARG when ssl is NULL or not using TLS v1.3, SIDE_ERROR when
  10371. * called on a client; WOLFSSL_SUCCESS on success and otherwise failure.
  10372. */
  10373. int wolfSSL_send_hrr_cookie(WOLFSSL* ssl, const unsigned char* secret,
  10374. unsigned int secretSz)
  10375. {
  10376. int ret;
  10377. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10378. return BAD_FUNC_ARG;
  10379. #ifndef NO_WOLFSSL_SERVER
  10380. if (ssl->options.side == WOLFSSL_CLIENT_END)
  10381. return SIDE_ERROR;
  10382. if (secretSz == 0) {
  10383. #if !defined(NO_SHA) && defined(NO_SHA256)
  10384. secretSz = WC_SHA_DIGEST_SIZE;
  10385. #endif /* NO_SHA */
  10386. #ifndef NO_SHA256
  10387. secretSz = WC_SHA256_DIGEST_SIZE;
  10388. #endif /* NO_SHA256 */
  10389. }
  10390. if (secretSz != ssl->buffers.tls13CookieSecret.length) {
  10391. byte* newSecret;
  10392. if (ssl->buffers.tls13CookieSecret.buffer != NULL) {
  10393. ForceZero(ssl->buffers.tls13CookieSecret.buffer,
  10394. ssl->buffers.tls13CookieSecret.length);
  10395. XFREE(ssl->buffers.tls13CookieSecret.buffer,
  10396. ssl->heap, DYNAMIC_TYPE_COOKIE_PWD);
  10397. }
  10398. newSecret = (byte*)XMALLOC(secretSz, ssl->heap,
  10399. DYNAMIC_TYPE_COOKIE_PWD);
  10400. if (newSecret == NULL) {
  10401. ssl->buffers.tls13CookieSecret.buffer = NULL;
  10402. ssl->buffers.tls13CookieSecret.length = 0;
  10403. WOLFSSL_MSG("couldn't allocate new cookie secret");
  10404. return MEMORY_ERROR;
  10405. }
  10406. ssl->buffers.tls13CookieSecret.buffer = newSecret;
  10407. ssl->buffers.tls13CookieSecret.length = secretSz;
  10408. #ifdef WOLFSSL_CHECK_MEM_ZERO
  10409. wc_MemZero_Add("wolfSSL_send_hrr_cookie secret",
  10410. ssl->buffers.tls13CookieSecret.buffer,
  10411. ssl->buffers.tls13CookieSecret.length);
  10412. #endif
  10413. }
  10414. /* If the supplied secret is NULL, randomly generate a new secret. */
  10415. if (secret == NULL) {
  10416. ret = wc_RNG_GenerateBlock(ssl->rng,
  10417. ssl->buffers.tls13CookieSecret.buffer, secretSz);
  10418. if (ret < 0)
  10419. return ret;
  10420. }
  10421. else
  10422. XMEMCPY(ssl->buffers.tls13CookieSecret.buffer, secret, secretSz);
  10423. ssl->options.sendCookie = 1;
  10424. ret = WOLFSSL_SUCCESS;
  10425. #else
  10426. (void)secret;
  10427. (void)secretSz;
  10428. ret = SIDE_ERROR;
  10429. #endif
  10430. return ret;
  10431. }
  10432. int wolfSSL_disable_hrr_cookie(WOLFSSL* ssl)
  10433. {
  10434. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10435. return BAD_FUNC_ARG;
  10436. #ifdef NO_WOLFSSL_SERVER
  10437. return SIDE_ERROR;
  10438. #else
  10439. if (ssl->options.side == WOLFSSL_CLIENT_END)
  10440. return SIDE_ERROR;
  10441. if (ssl->buffers.tls13CookieSecret.buffer != NULL) {
  10442. ForceZero(ssl->buffers.tls13CookieSecret.buffer,
  10443. ssl->buffers.tls13CookieSecret.length);
  10444. XFREE(ssl->buffers.tls13CookieSecret.buffer, ssl->heap,
  10445. DYNAMIC_TYPE_COOKIE_PWD);
  10446. ssl->buffers.tls13CookieSecret.buffer = NULL;
  10447. ssl->buffers.tls13CookieSecret.length = 0;
  10448. }
  10449. ssl->options.sendCookie = 0;
  10450. return WOLFSSL_SUCCESS;
  10451. #endif /* NO_WOLFSSL_SERVER */
  10452. }
  10453. #endif /* defined(WOLFSSL_SEND_HRR_COOKIE) */
  10454. #ifdef HAVE_SUPPORTED_CURVES
  10455. /* Create a key share entry from group.
  10456. * Generates a key pair.
  10457. *
  10458. * ssl The SSL/TLS object.
  10459. * group The named group.
  10460. * returns 0 on success, otherwise failure.
  10461. * for async can return WC_PENDING_E and should be called again
  10462. */
  10463. int wolfSSL_UseKeyShare(WOLFSSL* ssl, word16 group)
  10464. {
  10465. int ret;
  10466. if (ssl == NULL)
  10467. return BAD_FUNC_ARG;
  10468. #ifdef WOLFSSL_ASYNC_CRYPT
  10469. ret = wolfSSL_AsyncPop(ssl, NULL);
  10470. if (ret != WC_NOT_PENDING_E) {
  10471. /* Check for error */
  10472. if (ret < 0)
  10473. return ret;
  10474. }
  10475. #endif
  10476. #ifdef HAVE_PQC
  10477. if (WOLFSSL_NAMED_GROUP_IS_PQC(group)) {
  10478. if (ssl->ctx != NULL && ssl->ctx->method != NULL &&
  10479. !IsAtLeastTLSv1_3(ssl->version)) {
  10480. return BAD_FUNC_ARG;
  10481. }
  10482. if (ssl->options.side == WOLFSSL_SERVER_END) {
  10483. /* If I am the server of a KEM connection, do not do keygen because I'm
  10484. * going to encapsulate with the client's public key. Note that I might
  10485. * be the client and ssl->option.side has not been properly set yet. In
  10486. * that case the KeyGen operation will be deferred to connection time. */
  10487. return WOLFSSL_SUCCESS;
  10488. }
  10489. }
  10490. #endif
  10491. #if defined(NO_TLS)
  10492. (void)ret;
  10493. (void)group;
  10494. #else
  10495. ret = TLSX_KeyShare_Use(ssl, group, 0, NULL, NULL);
  10496. if (ret != 0)
  10497. return ret;
  10498. #endif /* NO_TLS */
  10499. return WOLFSSL_SUCCESS;
  10500. }
  10501. /* Send no key share entries - use HelloRetryRequest to negotiate shared group.
  10502. *
  10503. * ssl The SSL/TLS object.
  10504. * returns 0 on success, otherwise failure.
  10505. */
  10506. int wolfSSL_NoKeyShares(WOLFSSL* ssl)
  10507. {
  10508. int ret;
  10509. if (ssl == NULL)
  10510. return BAD_FUNC_ARG;
  10511. if (ssl->options.side == WOLFSSL_SERVER_END)
  10512. return SIDE_ERROR;
  10513. #if defined(NO_TLS)
  10514. (void)ret;
  10515. #else
  10516. ret = TLSX_KeyShare_Empty(ssl);
  10517. if (ret != 0)
  10518. return ret;
  10519. #endif /* NO_TLS */
  10520. return WOLFSSL_SUCCESS;
  10521. }
  10522. #endif
  10523. /* Do not send a ticket after TLS v1.3 handshake for resumption.
  10524. *
  10525. * ctx The SSL/TLS CTX object.
  10526. * returns BAD_FUNC_ARG when ctx is NULL and 0 on success.
  10527. */
  10528. int wolfSSL_CTX_no_ticket_TLSv13(WOLFSSL_CTX* ctx)
  10529. {
  10530. if (ctx == NULL || !IsAtLeastTLSv1_3(ctx->method->version))
  10531. return BAD_FUNC_ARG;
  10532. if (ctx->method->side == WOLFSSL_CLIENT_END)
  10533. return SIDE_ERROR;
  10534. #ifdef HAVE_SESSION_TICKET
  10535. ctx->noTicketTls13 = 1;
  10536. #endif
  10537. return 0;
  10538. }
  10539. /* Do not send a ticket after TLS v1.3 handshake for resumption.
  10540. *
  10541. * ssl The SSL/TLS object.
  10542. * returns BAD_FUNC_ARG when ssl is NULL, not using TLS v1.3, or called on
  10543. * a client and 0 on success.
  10544. */
  10545. int wolfSSL_no_ticket_TLSv13(WOLFSSL* ssl)
  10546. {
  10547. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10548. return BAD_FUNC_ARG;
  10549. if (ssl->options.side == WOLFSSL_CLIENT_END)
  10550. return SIDE_ERROR;
  10551. #ifdef HAVE_SESSION_TICKET
  10552. ssl->options.noTicketTls13 = 1;
  10553. #endif
  10554. return 0;
  10555. }
  10556. /* Disallow (EC)DHE key exchange when using pre-shared keys.
  10557. *
  10558. * ctx The SSL/TLS CTX object.
  10559. * returns BAD_FUNC_ARG when ctx is NULL and 0 on success.
  10560. */
  10561. int wolfSSL_CTX_no_dhe_psk(WOLFSSL_CTX* ctx)
  10562. {
  10563. if (ctx == NULL || !IsAtLeastTLSv1_3(ctx->method->version))
  10564. return BAD_FUNC_ARG;
  10565. ctx->noPskDheKe = 1;
  10566. return 0;
  10567. }
  10568. /* Disallow (EC)DHE key exchange when using pre-shared keys.
  10569. *
  10570. * ssl The SSL/TLS object.
  10571. * returns BAD_FUNC_ARG when ssl is NULL, or not using TLS v1.3 and 0 on
  10572. * success.
  10573. */
  10574. int wolfSSL_no_dhe_psk(WOLFSSL* ssl)
  10575. {
  10576. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10577. return BAD_FUNC_ARG;
  10578. ssl->options.noPskDheKe = 1;
  10579. return 0;
  10580. }
  10581. int Tls13UpdateKeys(WOLFSSL* ssl)
  10582. {
  10583. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10584. return BAD_FUNC_ARG;
  10585. #ifdef WOLFSSL_DTLS13
  10586. /* we are already waiting for the ack of a sent key update message. We can't
  10587. send another one before receiving its ack. Either wolfSSL_update_keys()
  10588. was invoked multiple times over a short period of time or we replied to a
  10589. KeyUpdate with update request. We'll just ignore sending this
  10590. KeyUpdate. */
  10591. /* TODO: add WOLFSSL_ERROR_ALREADY_IN_PROGRESS type of error here */
  10592. if (ssl->options.dtls && ssl->dtls13WaitKeyUpdateAck)
  10593. return 0;
  10594. #endif /* WOLFSSL_DTLS13 */
  10595. return SendTls13KeyUpdate(ssl);
  10596. }
  10597. /* Update the keys for encryption and decryption.
  10598. * If using non-blocking I/O and WOLFSSL_ERROR_WANT_WRITE is returned then
  10599. * calling wolfSSL_write() will have the message sent when ready.
  10600. *
  10601. * ssl The SSL/TLS object.
  10602. * returns BAD_FUNC_ARG when ssl is NULL, or not using TLS v1.3,
  10603. * WOLFSSL_ERROR_WANT_WRITE when non-blocking I/O is not ready to write,
  10604. * WOLFSSL_SUCCESS on success and otherwise failure.
  10605. */
  10606. int wolfSSL_update_keys(WOLFSSL* ssl)
  10607. {
  10608. int ret;
  10609. ret = Tls13UpdateKeys(ssl);
  10610. if (ret == WANT_WRITE)
  10611. ret = WOLFSSL_ERROR_WANT_WRITE;
  10612. else if (ret == 0)
  10613. ret = WOLFSSL_SUCCESS;
  10614. return ret;
  10615. }
  10616. /* Whether a response is waiting for key update request.
  10617. *
  10618. * ssl The SSL/TLS object.
  10619. * required 0 when no key update response required.
  10620. * 1 when no key update response required.
  10621. * return 0 on success.
  10622. * return BAD_FUNC_ARG when ssl is NULL or not using TLS v1.3
  10623. */
  10624. int wolfSSL_key_update_response(WOLFSSL* ssl, int* required)
  10625. {
  10626. if (required == NULL || ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10627. return BAD_FUNC_ARG;
  10628. *required = ssl->keys.updateResponseReq;
  10629. return 0;
  10630. }
  10631. #if !defined(NO_CERTS) && defined(WOLFSSL_POST_HANDSHAKE_AUTH)
  10632. /* Allow post-handshake authentication in TLS v1.3 connections.
  10633. *
  10634. * ctx The SSL/TLS CTX object.
  10635. * returns BAD_FUNC_ARG when ctx is NULL, SIDE_ERROR when not a client and
  10636. * 0 on success.
  10637. */
  10638. int wolfSSL_CTX_allow_post_handshake_auth(WOLFSSL_CTX* ctx)
  10639. {
  10640. if (ctx == NULL || !IsAtLeastTLSv1_3(ctx->method->version))
  10641. return BAD_FUNC_ARG;
  10642. if (ctx->method->side == WOLFSSL_SERVER_END)
  10643. return SIDE_ERROR;
  10644. ctx->postHandshakeAuth = 1;
  10645. return 0;
  10646. }
  10647. /* Allow post-handshake authentication in TLS v1.3 connection.
  10648. *
  10649. * ssl The SSL/TLS object.
  10650. * returns BAD_FUNC_ARG when ssl is NULL, or not using TLS v1.3,
  10651. * SIDE_ERROR when not a client and 0 on success.
  10652. */
  10653. int wolfSSL_allow_post_handshake_auth(WOLFSSL* ssl)
  10654. {
  10655. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10656. return BAD_FUNC_ARG;
  10657. if (ssl->options.side == WOLFSSL_SERVER_END)
  10658. return SIDE_ERROR;
  10659. ssl->options.postHandshakeAuth = 1;
  10660. return 0;
  10661. }
  10662. /* Request a certificate of the client.
  10663. * Can be called any time after handshake completion.
  10664. * A maximum of 256 requests can be sent on a connection.
  10665. *
  10666. * ssl SSL/TLS object.
  10667. */
  10668. int wolfSSL_request_certificate(WOLFSSL* ssl)
  10669. {
  10670. int ret;
  10671. #ifndef NO_WOLFSSL_SERVER
  10672. CertReqCtx* certReqCtx;
  10673. #endif
  10674. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10675. return BAD_FUNC_ARG;
  10676. #ifndef NO_WOLFSSL_SERVER
  10677. if (ssl->options.side == WOLFSSL_CLIENT_END)
  10678. return SIDE_ERROR;
  10679. if (ssl->options.handShakeState != HANDSHAKE_DONE)
  10680. return NOT_READY_ERROR;
  10681. if (!ssl->options.postHandshakeAuth)
  10682. return POST_HAND_AUTH_ERROR;
  10683. certReqCtx = (CertReqCtx*)XMALLOC(sizeof(CertReqCtx), ssl->heap,
  10684. DYNAMIC_TYPE_TMP_BUFFER);
  10685. if (certReqCtx == NULL)
  10686. return MEMORY_E;
  10687. XMEMSET(certReqCtx, 0, sizeof(CertReqCtx));
  10688. certReqCtx->next = ssl->certReqCtx;
  10689. certReqCtx->len = 1;
  10690. if (certReqCtx->next != NULL)
  10691. certReqCtx->ctx = certReqCtx->next->ctx + 1;
  10692. ssl->certReqCtx = certReqCtx;
  10693. ssl->msgsReceived.got_certificate = 0;
  10694. ssl->msgsReceived.got_certificate_verify = 0;
  10695. ssl->msgsReceived.got_finished = 0;
  10696. ret = SendTls13CertificateRequest(ssl, &certReqCtx->ctx, certReqCtx->len);
  10697. if (ret == WANT_WRITE)
  10698. ret = WOLFSSL_ERROR_WANT_WRITE;
  10699. else if (ret == 0)
  10700. ret = WOLFSSL_SUCCESS;
  10701. #else
  10702. ret = SIDE_ERROR;
  10703. #endif
  10704. return ret;
  10705. }
  10706. #endif /* !NO_CERTS && WOLFSSL_POST_HANDSHAKE_AUTH */
  10707. #if !defined(WOLFSSL_NO_SERVER_GROUPS_EXT)
  10708. /* Get the preferred key exchange group.
  10709. *
  10710. * ssl The SSL/TLS object.
  10711. * returns BAD_FUNC_ARG when ssl is NULL or not using TLS v1.3,
  10712. * SIDE_ERROR when not a client, NOT_READY_ERROR when handshake not complete
  10713. * and group number on success.
  10714. */
  10715. int wolfSSL_preferred_group(WOLFSSL* ssl)
  10716. {
  10717. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  10718. return BAD_FUNC_ARG;
  10719. #ifndef NO_WOLFSSL_CLIENT
  10720. if (ssl->options.side == WOLFSSL_SERVER_END)
  10721. return SIDE_ERROR;
  10722. if (ssl->options.handShakeState != HANDSHAKE_DONE)
  10723. return NOT_READY_ERROR;
  10724. #ifdef HAVE_SUPPORTED_CURVES
  10725. /* Return supported groups only. */
  10726. return TLSX_SupportedCurve_Preferred(ssl, 1);
  10727. #else
  10728. return 0;
  10729. #endif
  10730. #else
  10731. return SIDE_ERROR;
  10732. #endif
  10733. }
  10734. #endif
  10735. #if defined(HAVE_SUPPORTED_CURVES)
  10736. /* Sets the key exchange groups in rank order on a context.
  10737. *
  10738. * ctx SSL/TLS context object.
  10739. * groups Array of groups.
  10740. * count Number of groups in array.
  10741. * returns BAD_FUNC_ARG when ctx or groups is NULL, not using TLS v1.3 or
  10742. * count is greater than WOLFSSL_MAX_GROUP_COUNT and WOLFSSL_SUCCESS on success.
  10743. */
  10744. int wolfSSL_CTX_set_groups(WOLFSSL_CTX* ctx, int* groups, int count)
  10745. {
  10746. int ret, i;
  10747. WOLFSSL_ENTER("wolfSSL_CTX_set_groups");
  10748. if (ctx == NULL || groups == NULL || count > WOLFSSL_MAX_GROUP_COUNT)
  10749. return BAD_FUNC_ARG;
  10750. if (!IsAtLeastTLSv1_3(ctx->method->version))
  10751. return BAD_FUNC_ARG;
  10752. ctx->numGroups = 0;
  10753. #if !defined(NO_TLS)
  10754. TLSX_Remove(&ctx->extensions, TLSX_SUPPORTED_GROUPS, ctx->heap);
  10755. #endif /* !NO_TLS */
  10756. for (i = 0; i < count; i++) {
  10757. /* Call to wolfSSL_CTX_UseSupportedCurve also checks if input groups
  10758. * are valid */
  10759. if ((ret = wolfSSL_CTX_UseSupportedCurve(ctx, (word16)groups[i]))
  10760. != WOLFSSL_SUCCESS) {
  10761. #if !defined(NO_TLS)
  10762. TLSX_Remove(&ctx->extensions, TLSX_SUPPORTED_GROUPS, ctx->heap);
  10763. #endif /* !NO_TLS */
  10764. return ret;
  10765. }
  10766. ctx->group[i] = (word16)groups[i];
  10767. }
  10768. ctx->numGroups = (byte)count;
  10769. return WOLFSSL_SUCCESS;
  10770. }
  10771. /* Sets the key exchange groups in rank order.
  10772. *
  10773. * ssl SSL/TLS object.
  10774. * groups Array of groups.
  10775. * count Number of groups in array.
  10776. * returns BAD_FUNC_ARG when ssl or groups is NULL, not using TLS v1.3 or
  10777. * count is greater than WOLFSSL_MAX_GROUP_COUNT and WOLFSSL_SUCCESS on success.
  10778. */
  10779. int wolfSSL_set_groups(WOLFSSL* ssl, int* groups, int count)
  10780. {
  10781. int ret, i;
  10782. WOLFSSL_ENTER("wolfSSL_set_groups");
  10783. if (ssl == NULL || groups == NULL || count > WOLFSSL_MAX_GROUP_COUNT)
  10784. return BAD_FUNC_ARG;
  10785. if (!IsAtLeastTLSv1_3(ssl->version))
  10786. return BAD_FUNC_ARG;
  10787. ssl->numGroups = 0;
  10788. #if !defined(NO_TLS)
  10789. TLSX_Remove(&ssl->extensions, TLSX_SUPPORTED_GROUPS, ssl->heap);
  10790. #endif /* !NO_TLS */
  10791. for (i = 0; i < count; i++) {
  10792. /* Call to wolfSSL_UseSupportedCurve also checks if input groups
  10793. * are valid */
  10794. if ((ret = wolfSSL_UseSupportedCurve(ssl, (word16)groups[i]))
  10795. != WOLFSSL_SUCCESS) {
  10796. #if !defined(NO_TLS)
  10797. TLSX_Remove(&ssl->extensions, TLSX_SUPPORTED_GROUPS, ssl->heap);
  10798. #endif /* !NO_TLS */
  10799. return ret;
  10800. }
  10801. ssl->group[i] = (word16)groups[i];
  10802. }
  10803. ssl->numGroups = (byte)count;
  10804. return WOLFSSL_SUCCESS;
  10805. }
  10806. #endif /* HAVE_SUPPORTED_CURVES */
  10807. #ifndef NO_PSK
  10808. /* Set the PSK callback, that is passed the cipher suite, for a client to use
  10809. * against context object.
  10810. *
  10811. * @param [in, out] ctx SSL/TLS context object.
  10812. * @param [in] cb Client PSK callback passed a cipher suite.
  10813. */
  10814. void wolfSSL_CTX_set_psk_client_cs_callback(WOLFSSL_CTX* ctx,
  10815. wc_psk_client_cs_callback cb)
  10816. {
  10817. WOLFSSL_ENTER("SSL_CTX_set_psk_client_cs_callback");
  10818. if (ctx == NULL)
  10819. return;
  10820. ctx->havePSK = 1;
  10821. ctx->client_psk_cs_cb = cb;
  10822. }
  10823. /* Set the PSK callback, that is passed the cipher suite, for a client to use
  10824. * against SSL object.
  10825. *
  10826. * @param [in, out] ssl SSL/TLS object.
  10827. * @param [in] cb Client PSK callback passed a cipher suite.
  10828. */
  10829. void wolfSSL_set_psk_client_cs_callback(WOLFSSL* ssl,
  10830. wc_psk_client_cs_callback cb)
  10831. {
  10832. byte haveRSA = 1;
  10833. int keySz = 0;
  10834. WOLFSSL_ENTER("SSL_set_psk_client_cs_callback");
  10835. if (ssl == NULL)
  10836. return;
  10837. ssl->options.havePSK = 1;
  10838. ssl->options.client_psk_cs_cb = cb;
  10839. #ifdef NO_RSA
  10840. haveRSA = 0;
  10841. #endif
  10842. #ifndef NO_CERTS
  10843. keySz = ssl->buffers.keySz;
  10844. #endif
  10845. if (AllocateSuites(ssl) != 0)
  10846. return;
  10847. InitSuites(ssl->suites, ssl->version, keySz, haveRSA, TRUE,
  10848. ssl->options.haveDH, ssl->options.haveECDSAsig,
  10849. ssl->options.haveECC, TRUE, ssl->options.haveStaticECC,
  10850. ssl->options.haveFalconSig, ssl->options.haveDilithiumSig,
  10851. ssl->options.haveAnon, TRUE, ssl->options.side);
  10852. }
  10853. /* Set the PSK callback that returns the cipher suite for a client to use
  10854. * against context object.
  10855. *
  10856. * @param [in, out] ctx SSL/TLS context object.
  10857. * @param [in] cb Client PSK callback returning cipher suite.
  10858. */
  10859. void wolfSSL_CTX_set_psk_client_tls13_callback(WOLFSSL_CTX* ctx,
  10860. wc_psk_client_tls13_callback cb)
  10861. {
  10862. WOLFSSL_ENTER("SSL_CTX_set_psk_client_tls13_callback");
  10863. if (ctx == NULL)
  10864. return;
  10865. ctx->havePSK = 1;
  10866. ctx->client_psk_tls13_cb = cb;
  10867. }
  10868. /* Set the PSK callback that returns the cipher suite for a client to use
  10869. * against SSL object.
  10870. *
  10871. * @param [in, out] ssl SSL/TLS object.
  10872. * @param [in] cb Client PSK callback returning cipher suite.
  10873. */
  10874. void wolfSSL_set_psk_client_tls13_callback(WOLFSSL* ssl,
  10875. wc_psk_client_tls13_callback cb)
  10876. {
  10877. byte haveRSA = 1;
  10878. int keySz = 0;
  10879. WOLFSSL_ENTER("SSL_set_psk_client_tls13_callback");
  10880. if (ssl == NULL)
  10881. return;
  10882. ssl->options.havePSK = 1;
  10883. ssl->options.client_psk_tls13_cb = cb;
  10884. #ifdef NO_RSA
  10885. haveRSA = 0;
  10886. #endif
  10887. #ifndef NO_CERTS
  10888. keySz = ssl->buffers.keySz;
  10889. #endif
  10890. if (AllocateSuites(ssl) != 0)
  10891. return;
  10892. InitSuites(ssl->suites, ssl->version, keySz, haveRSA, TRUE,
  10893. ssl->options.haveDH, ssl->options.haveECDSAsig,
  10894. ssl->options.haveECC, TRUE, ssl->options.haveStaticECC,
  10895. ssl->options.haveFalconSig, ssl->options.haveDilithiumSig,
  10896. ssl->options.haveAnon, TRUE, ssl->options.side);
  10897. }
  10898. /* Set the PSK callback that returns the cipher suite for a server to use
  10899. * against context object.
  10900. *
  10901. * @param [in, out] ctx SSL/TLS context object.
  10902. * @param [in] cb Server PSK callback returning cipher suite.
  10903. */
  10904. void wolfSSL_CTX_set_psk_server_tls13_callback(WOLFSSL_CTX* ctx,
  10905. wc_psk_server_tls13_callback cb)
  10906. {
  10907. WOLFSSL_ENTER("SSL_CTX_set_psk_server_tls13_callback");
  10908. if (ctx == NULL)
  10909. return;
  10910. ctx->havePSK = 1;
  10911. ctx->server_psk_tls13_cb = cb;
  10912. }
  10913. /* Set the PSK callback that returns the cipher suite for a server to use
  10914. * against SSL object.
  10915. *
  10916. * @param [in, out] ssl SSL/TLS object.
  10917. * @param [in] cb Server PSK callback returning cipher suite.
  10918. */
  10919. void wolfSSL_set_psk_server_tls13_callback(WOLFSSL* ssl,
  10920. wc_psk_server_tls13_callback cb)
  10921. {
  10922. byte haveRSA = 1;
  10923. int keySz = 0;
  10924. WOLFSSL_ENTER("SSL_set_psk_server_tls13_callback");
  10925. if (ssl == NULL)
  10926. return;
  10927. ssl->options.havePSK = 1;
  10928. ssl->options.server_psk_tls13_cb = cb;
  10929. #ifdef NO_RSA
  10930. haveRSA = 0;
  10931. #endif
  10932. #ifndef NO_CERTS
  10933. keySz = ssl->buffers.keySz;
  10934. #endif
  10935. if (AllocateSuites(ssl) != 0)
  10936. return;
  10937. InitSuites(ssl->suites, ssl->version, keySz, haveRSA, TRUE,
  10938. ssl->options.haveDH, ssl->options.haveECDSAsig,
  10939. ssl->options.haveECC, TRUE, ssl->options.haveStaticECC,
  10940. ssl->options.haveFalconSig, ssl->options.haveDilithiumSig,
  10941. ssl->options.haveAnon, TRUE, ssl->options.side);
  10942. }
  10943. /* Get name of first supported cipher suite that uses the hash indicated.
  10944. *
  10945. * @param [in] ssl SSL/TLS object.
  10946. * @param [in] hash Name of hash algorithm. e.g. "SHA256", "SHA384"
  10947. * @return Name of cipher suite.
  10948. * @return NULL on failure.
  10949. */
  10950. const char* wolfSSL_get_cipher_name_by_hash(WOLFSSL* ssl, const char* hash)
  10951. {
  10952. const char* name = NULL;
  10953. byte mac = no_mac;
  10954. int i;
  10955. const Suites* suites = WOLFSSL_SUITES(ssl);
  10956. if (XSTRCMP(hash, "SHA256") == 0) {
  10957. mac = sha256_mac;
  10958. }
  10959. else if (XSTRCMP(hash, "SHA384") == 0) {
  10960. mac = sha384_mac;
  10961. }
  10962. if (mac != no_mac) {
  10963. for (i = 0; i < suites->suiteSz; i += 2) {
  10964. if (SuiteMac(suites->suites + i) == mac) {
  10965. name = GetCipherNameInternal(suites->suites[i + 0],
  10966. suites->suites[i + 1]);
  10967. break;
  10968. }
  10969. }
  10970. }
  10971. return name;
  10972. }
  10973. #endif /* !NO_PSK */
  10974. #ifndef NO_WOLFSSL_SERVER
  10975. #if defined(WOLFSSL_DTLS13) && defined(WOLFSSL_SEND_HRR_COOKIE)
  10976. static int DtlsAcceptStateless(WOLFSSL *ssl)
  10977. {
  10978. int ret;
  10979. if (!ssl->options.dtls)
  10980. return 0;
  10981. switch (ssl->options.acceptState) {
  10982. case TLS13_ACCEPT_BEGIN:
  10983. while (ssl->options.clientState < CLIENT_HELLO_COMPLETE) {
  10984. ret = ProcessReply(ssl);
  10985. if (ret != 0)
  10986. return ret;
  10987. }
  10988. if (!IsAtLeastTLSv1_3(ssl->version))
  10989. return wolfSSL_accept(ssl);
  10990. ssl->options.acceptState = TLS13_ACCEPT_CLIENT_HELLO_DONE;
  10991. WOLFSSL_MSG("accept state ACCEPT_CLIENT_HELLO_DONE");
  10992. FALL_THROUGH;
  10993. case TLS13_ACCEPT_CLIENT_HELLO_DONE:
  10994. if (ssl->options.serverState ==
  10995. SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  10996. ret = SendTls13ServerHello(ssl, hello_retry_request);
  10997. DtlsResetState(ssl);
  10998. return ret;
  10999. }
  11000. ssl->options.acceptState = TLS13_ACCEPT_HELLO_RETRY_REQUEST_DONE;
  11001. WOLFSSL_MSG("accept state ACCEPT_HELLO_RETRY_REQUEST_DONE");
  11002. FALL_THROUGH;
  11003. default:
  11004. return 0;
  11005. }
  11006. return 0;
  11007. }
  11008. #endif /* WOLFSSL_DTLS13 */
  11009. /* The server accepting a connection from a client.
  11010. * The protocol version is expecting to be TLS v1.3.
  11011. * If the client downgrades, and older versions of the protocol are compiled
  11012. * in, the server will fallback to wolfSSL_accept().
  11013. * Please see note at top of README if you get an error from accept.
  11014. *
  11015. * ssl The SSL/TLS object.
  11016. * returns WOLFSSL_SUCCESS on successful handshake, WOLFSSL_FATAL_ERROR when
  11017. * unrecoverable error occurs and 0 otherwise.
  11018. * For more error information use wolfSSL_get_error().
  11019. */
  11020. int wolfSSL_accept_TLSv13(WOLFSSL* ssl)
  11021. {
  11022. #if !defined(NO_CERTS) && (defined(HAVE_SESSION_TICKET) || !defined(NO_PSK))
  11023. word16 havePSK = 0;
  11024. #endif
  11025. int advanceState;
  11026. int ret = 0;
  11027. WOLFSSL_ENTER("SSL_accept_TLSv13()");
  11028. #ifdef HAVE_ERRNO_H
  11029. errno = 0;
  11030. #endif
  11031. if (ssl == NULL)
  11032. return WOLFSSL_FATAL_ERROR;
  11033. #if !defined(NO_CERTS) && (defined(HAVE_SESSION_TICKET) || !defined(NO_PSK))
  11034. havePSK = ssl->options.havePSK;
  11035. #endif
  11036. if (ssl->options.side != WOLFSSL_SERVER_END) {
  11037. ssl->error = SIDE_ERROR;
  11038. WOLFSSL_ERROR(ssl->error);
  11039. return WOLFSSL_FATAL_ERROR;
  11040. }
  11041. /* make sure this wolfSSL object has arrays and rng setup. Protects
  11042. * case where the WOLFSSL object is re-used via wolfSSL_clear() */
  11043. if ((ret = ReinitSSL(ssl, ssl->ctx, 0)) != 0) {
  11044. return ret;
  11045. }
  11046. #ifdef WOLFSSL_WOLFSENTRY_HOOKS
  11047. if ((ssl->AcceptFilter != NULL) &&
  11048. ((ssl->options.acceptState == TLS13_ACCEPT_BEGIN)
  11049. #ifdef HAVE_SECURE_RENEGOTIATION
  11050. || (ssl->options.acceptState == TLS13_ACCEPT_BEGIN_RENEG)
  11051. #endif
  11052. ))
  11053. {
  11054. wolfSSL_netfilter_decision_t res;
  11055. if ((ssl->AcceptFilter(ssl, ssl->AcceptFilter_arg, &res) ==
  11056. WOLFSSL_SUCCESS) &&
  11057. (res == WOLFSSL_NETFILTER_REJECT)) {
  11058. ssl->error = SOCKET_FILTERED_E;
  11059. WOLFSSL_ERROR(ssl->error);
  11060. return WOLFSSL_FATAL_ERROR;
  11061. }
  11062. }
  11063. #endif /* WOLFSSL_WOLFSENTRY_HOOKS */
  11064. #ifndef NO_CERTS
  11065. #if defined(HAVE_SESSION_TICKET) || !defined(NO_PSK)
  11066. if (!havePSK)
  11067. #endif
  11068. {
  11069. #if defined(OPENSSL_ALL) || defined(OPENSSL_EXTRA) || \
  11070. defined(WOLFSSL_NGINX) || defined (WOLFSSL_HAPROXY)
  11071. if (ssl->ctx->certSetupCb != NULL) {
  11072. WOLFSSL_MSG("CertSetupCb set. server cert and "
  11073. "key not checked");
  11074. }
  11075. else
  11076. #endif
  11077. {
  11078. if (!ssl->buffers.certificate ||
  11079. !ssl->buffers.certificate->buffer) {
  11080. WOLFSSL_MSG("accept error: server cert required");
  11081. ssl->error = NO_PRIVATE_KEY;
  11082. WOLFSSL_ERROR(ssl->error);
  11083. return WOLFSSL_FATAL_ERROR;
  11084. }
  11085. if (!ssl->buffers.key || !ssl->buffers.key->buffer) {
  11086. /* allow no private key if using existing key */
  11087. #ifdef WOLF_PRIVATE_KEY_ID
  11088. if (ssl->devId != INVALID_DEVID
  11089. #ifdef HAVE_PK_CALLBACKS
  11090. || wolfSSL_CTX_IsPrivatePkSet(ssl->ctx)
  11091. #endif
  11092. ) {
  11093. WOLFSSL_MSG("Allowing no server private key (external)");
  11094. }
  11095. else
  11096. #endif
  11097. {
  11098. WOLFSSL_MSG("accept error: server key required");
  11099. ssl->error = NO_PRIVATE_KEY;
  11100. WOLFSSL_ERROR(ssl->error);
  11101. return WOLFSSL_FATAL_ERROR;
  11102. }
  11103. }
  11104. }
  11105. }
  11106. #endif /* NO_CERTS */
  11107. if (ssl->buffers.outputBuffer.length > 0
  11108. #ifdef WOLFSSL_ASYNC_CRYPT
  11109. /* do not send buffered or advance state if last error was an
  11110. async pending operation */
  11111. && ssl->error != WC_PENDING_E
  11112. #endif
  11113. ) {
  11114. /* fragOffset is non-zero when sending fragments. On the last
  11115. * fragment, fragOffset is zero again, and the state can be
  11116. * advanced. */
  11117. advanceState =
  11118. (ssl->options.acceptState == TLS13_ACCEPT_CLIENT_HELLO_DONE ||
  11119. ssl->options.acceptState ==
  11120. TLS13_ACCEPT_HELLO_RETRY_REQUEST_DONE ||
  11121. ssl->options.acceptState == TLS13_ACCEPT_SECOND_REPLY_DONE ||
  11122. ssl->options.acceptState == TLS13_SERVER_HELLO_SENT ||
  11123. ssl->options.acceptState == TLS13_ACCEPT_THIRD_REPLY_DONE ||
  11124. ssl->options.acceptState == TLS13_SERVER_EXTENSIONS_SENT ||
  11125. ssl->options.acceptState == TLS13_CERT_REQ_SENT ||
  11126. ssl->options.acceptState == TLS13_CERT_SENT ||
  11127. ssl->options.acceptState == TLS13_CERT_VERIFY_SENT ||
  11128. ssl->options.acceptState == TLS13_ACCEPT_FINISHED_SENT ||
  11129. ssl->options.acceptState == TLS13_ACCEPT_FINISHED_DONE);
  11130. #ifdef WOLFSSL_DTLS13
  11131. if (ssl->options.dtls)
  11132. advanceState = advanceState && !ssl->dtls13SendingFragments
  11133. && !ssl->dtls13SendingAckOrRtx;
  11134. #endif /* WOLFSSL_DTLS13 */
  11135. if ((ssl->error = SendBuffered(ssl)) == 0) {
  11136. if (ssl->fragOffset == 0 && !ssl->options.buildingMsg) {
  11137. if (advanceState) {
  11138. ssl->options.acceptState++;
  11139. WOLFSSL_MSG("accept state: "
  11140. "Advanced from last buffered fragment send");
  11141. #ifdef WOLFSSL_ASYNC_IO
  11142. FreeAsyncCtx(ssl, 0);
  11143. #endif
  11144. }
  11145. }
  11146. else {
  11147. WOLFSSL_MSG("accept state: "
  11148. "Not advanced, more fragments to send");
  11149. }
  11150. #ifdef WOLFSSL_DTLS13
  11151. if (ssl->options.dtls)
  11152. ssl->dtls13SendingAckOrRtx = 0;
  11153. #endif /* WOLFSSL_DTLS13 */
  11154. }
  11155. else {
  11156. ssl->error = ret;
  11157. WOLFSSL_ERROR(ssl->error);
  11158. return WOLFSSL_FATAL_ERROR;
  11159. }
  11160. }
  11161. ret = RetrySendAlert(ssl);
  11162. if (ret != 0) {
  11163. ssl->error = ret;
  11164. WOLFSSL_ERROR(ssl->error);
  11165. return WOLFSSL_FATAL_ERROR;
  11166. }
  11167. #ifdef WOLFSSL_DTLS13
  11168. if (ssl->options.dtls && ssl->dtls13SendingFragments) {
  11169. if ((ssl->error = Dtls13FragmentsContinue(ssl)) != 0) {
  11170. WOLFSSL_ERROR(ssl->error);
  11171. return WOLFSSL_FATAL_ERROR;
  11172. }
  11173. /* we sent all the fragments. Advance state. */
  11174. ssl->options.acceptState++;
  11175. }
  11176. #endif /* WOLFSSL_DTLS13 */
  11177. #if defined(WOLFSSL_DTLS13) && defined(WOLFSSL_SEND_HRR_COOKIE)
  11178. if (ssl->options.dtls && ssl->options.sendCookie) {
  11179. while (ssl->options.serverState < SERVER_HELLO_COMPLETE) {
  11180. ret = DtlsAcceptStateless(ssl);
  11181. if (ret != 0) {
  11182. ssl->error = ret;
  11183. WOLFSSL_ERROR(ssl->error);
  11184. return WOLFSSL_FATAL_ERROR;
  11185. }
  11186. }
  11187. }
  11188. #endif /* defined(WOLFSSL_DTLS13) && defined(WOLFSSL_SEND_HRR_COOKIE) */
  11189. switch (ssl->options.acceptState) {
  11190. #ifdef HAVE_SECURE_RENEGOTIATION
  11191. case TLS13_ACCEPT_BEGIN_RENEG:
  11192. #endif
  11193. case TLS13_ACCEPT_BEGIN :
  11194. /* get client_hello */
  11195. while (ssl->options.clientState < CLIENT_HELLO_COMPLETE) {
  11196. if ((ssl->error = ProcessReply(ssl)) < 0) {
  11197. WOLFSSL_ERROR(ssl->error);
  11198. return WOLFSSL_FATAL_ERROR;
  11199. }
  11200. #ifdef WOLFSSL_DTLS13
  11201. if (ssl->options.dtls) {
  11202. if ((ssl->error = Dtls13DoScheduledWork(ssl)) < 0) {
  11203. WOLFSSL_ERROR(ssl->error);
  11204. return WOLFSSL_FATAL_ERROR;
  11205. }
  11206. }
  11207. #endif /* WOLFSSL_DTLS13 */
  11208. }
  11209. ssl->options.acceptState = TLS13_ACCEPT_CLIENT_HELLO_DONE;
  11210. WOLFSSL_MSG("accept state ACCEPT_CLIENT_HELLO_DONE");
  11211. if (!IsAtLeastTLSv1_3(ssl->version))
  11212. return wolfSSL_accept(ssl);
  11213. FALL_THROUGH;
  11214. case TLS13_ACCEPT_CLIENT_HELLO_DONE :
  11215. if (ssl->options.serverState ==
  11216. SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  11217. if ((ssl->error = SendTls13ServerHello(ssl,
  11218. hello_retry_request)) != 0) {
  11219. WOLFSSL_ERROR(ssl->error);
  11220. return WOLFSSL_FATAL_ERROR;
  11221. }
  11222. }
  11223. ssl->options.acceptState = TLS13_ACCEPT_HELLO_RETRY_REQUEST_DONE;
  11224. WOLFSSL_MSG("accept state ACCEPT_HELLO_RETRY_REQUEST_DONE");
  11225. FALL_THROUGH;
  11226. case TLS13_ACCEPT_HELLO_RETRY_REQUEST_DONE :
  11227. #ifdef WOLFSSL_TLS13_MIDDLEBOX_COMPAT
  11228. if (!ssl->options.dtls && ssl->options.tls13MiddleBoxCompat
  11229. && ssl->options.serverState ==
  11230. SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  11231. if ((ssl->error = SendChangeCipher(ssl)) != 0) {
  11232. WOLFSSL_ERROR(ssl->error);
  11233. return WOLFSSL_FATAL_ERROR;
  11234. }
  11235. ssl->options.sentChangeCipher = 1;
  11236. ssl->options.serverState = SERVER_HELLO_RETRY_REQUEST_COMPLETE;
  11237. }
  11238. #endif
  11239. ssl->options.acceptState = TLS13_ACCEPT_FIRST_REPLY_DONE;
  11240. WOLFSSL_MSG("accept state ACCEPT_FIRST_REPLY_DONE");
  11241. FALL_THROUGH;
  11242. case TLS13_ACCEPT_FIRST_REPLY_DONE :
  11243. if (ssl->options.serverState ==
  11244. SERVER_HELLO_RETRY_REQUEST_COMPLETE) {
  11245. ssl->options.clientState = CLIENT_HELLO_RETRY;
  11246. while (ssl->options.clientState < CLIENT_HELLO_COMPLETE) {
  11247. if ((ssl->error = ProcessReply(ssl)) < 0) {
  11248. WOLFSSL_ERROR(ssl->error);
  11249. return WOLFSSL_FATAL_ERROR;
  11250. }
  11251. #ifdef WOLFSSL_DTLS13
  11252. if (ssl->options.dtls) {
  11253. if ((ssl->error = Dtls13DoScheduledWork(ssl)) < 0) {
  11254. WOLFSSL_ERROR(ssl->error);
  11255. return WOLFSSL_FATAL_ERROR;
  11256. }
  11257. }
  11258. #endif /* WOLFSSL_DTLS13 */
  11259. }
  11260. }
  11261. ssl->options.acceptState = TLS13_ACCEPT_SECOND_REPLY_DONE;
  11262. WOLFSSL_MSG("accept state ACCEPT_SECOND_REPLY_DONE");
  11263. FALL_THROUGH;
  11264. case TLS13_ACCEPT_SECOND_REPLY_DONE :
  11265. #ifdef WOLFSSL_DTLS
  11266. if (ssl->chGoodCb != NULL) {
  11267. int cbret = ssl->chGoodCb(ssl, ssl->chGoodCtx);
  11268. if (cbret < 0) {
  11269. ssl->error = cbret;
  11270. WOLFSSL_MSG("ClientHello Good Cb don't continue error");
  11271. return WOLFSSL_FATAL_ERROR;
  11272. }
  11273. }
  11274. #endif
  11275. if ((ssl->error = SendTls13ServerHello(ssl, server_hello)) != 0) {
  11276. WOLFSSL_ERROR(ssl->error);
  11277. return WOLFSSL_FATAL_ERROR;
  11278. }
  11279. ssl->options.acceptState = TLS13_SERVER_HELLO_SENT;
  11280. WOLFSSL_MSG("accept state SERVER_HELLO_SENT");
  11281. FALL_THROUGH;
  11282. case TLS13_SERVER_HELLO_SENT :
  11283. #if defined(WOLFSSL_TLS13_MIDDLEBOX_COMPAT)
  11284. if (!ssl->options.dtls && ssl->options.tls13MiddleBoxCompat
  11285. && !ssl->options.sentChangeCipher && !ssl->options.dtls) {
  11286. if ((ssl->error = SendChangeCipher(ssl)) != 0) {
  11287. WOLFSSL_ERROR(ssl->error);
  11288. return WOLFSSL_FATAL_ERROR;
  11289. }
  11290. ssl->options.sentChangeCipher = 1;
  11291. }
  11292. #endif
  11293. ssl->options.acceptState = TLS13_ACCEPT_THIRD_REPLY_DONE;
  11294. WOLFSSL_MSG("accept state ACCEPT_THIRD_REPLY_DONE");
  11295. FALL_THROUGH;
  11296. case TLS13_ACCEPT_THIRD_REPLY_DONE :
  11297. #ifdef HAVE_SUPPORTED_CURVES
  11298. if (!ssl->options.noPskDheKe) {
  11299. ssl->error = TLSX_KeyShare_DeriveSecret(ssl);
  11300. if (ssl->error != 0)
  11301. return WOLFSSL_FATAL_ERROR;
  11302. }
  11303. #endif
  11304. if ((ssl->error = SendTls13EncryptedExtensions(ssl)) != 0) {
  11305. WOLFSSL_ERROR(ssl->error);
  11306. return WOLFSSL_FATAL_ERROR;
  11307. }
  11308. ssl->options.acceptState = TLS13_SERVER_EXTENSIONS_SENT;
  11309. WOLFSSL_MSG("accept state SERVER_EXTENSIONS_SENT");
  11310. FALL_THROUGH;
  11311. case TLS13_SERVER_EXTENSIONS_SENT :
  11312. #ifndef NO_CERTS
  11313. if (!ssl->options.resuming) {
  11314. if (ssl->options.verifyPeer
  11315. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  11316. && !ssl->options.verifyPostHandshake
  11317. #endif
  11318. ) {
  11319. ssl->error = SendTls13CertificateRequest(ssl, NULL, 0);
  11320. if (ssl->error != 0) {
  11321. WOLFSSL_ERROR(ssl->error);
  11322. return WOLFSSL_FATAL_ERROR;
  11323. }
  11324. }
  11325. else {
  11326. /* SERVER: Peer auth good if not verifying client. */
  11327. ssl->options.peerAuthGood = 1;
  11328. }
  11329. }
  11330. #endif
  11331. ssl->options.acceptState = TLS13_CERT_REQ_SENT;
  11332. WOLFSSL_MSG("accept state CERT_REQ_SENT");
  11333. FALL_THROUGH;
  11334. case TLS13_CERT_REQ_SENT :
  11335. #ifndef NO_CERTS
  11336. if (!ssl->options.resuming && ssl->options.sendVerify) {
  11337. if ((ssl->error = SendTls13Certificate(ssl)) != 0) {
  11338. WOLFSSL_ERROR(ssl->error);
  11339. return WOLFSSL_FATAL_ERROR;
  11340. }
  11341. }
  11342. #endif
  11343. ssl->options.acceptState = TLS13_CERT_SENT;
  11344. WOLFSSL_MSG("accept state CERT_SENT");
  11345. FALL_THROUGH;
  11346. case TLS13_CERT_SENT :
  11347. #if !defined(NO_CERTS) && (!defined(NO_RSA) || defined(HAVE_ECC) || \
  11348. defined(HAVE_ED25519) || defined(HAVE_ED448) || defined(HAVE_PQC))
  11349. if (!ssl->options.resuming && ssl->options.sendVerify) {
  11350. if ((ssl->error = SendTls13CertificateVerify(ssl)) != 0) {
  11351. WOLFSSL_ERROR(ssl->error);
  11352. return WOLFSSL_FATAL_ERROR;
  11353. }
  11354. }
  11355. #endif
  11356. ssl->options.acceptState = TLS13_CERT_VERIFY_SENT;
  11357. WOLFSSL_MSG("accept state CERT_VERIFY_SENT");
  11358. FALL_THROUGH;
  11359. case TLS13_CERT_VERIFY_SENT :
  11360. if ((ssl->error = SendTls13Finished(ssl)) != 0) {
  11361. WOLFSSL_ERROR(ssl->error);
  11362. return WOLFSSL_FATAL_ERROR;
  11363. }
  11364. ssl->options.acceptState = TLS13_ACCEPT_FINISHED_SENT;
  11365. WOLFSSL_MSG("accept state ACCEPT_FINISHED_SENT");
  11366. #ifdef WOLFSSL_EARLY_DATA
  11367. if (ssl->earlyData != no_early_data) {
  11368. ssl->options.handShakeState = SERVER_FINISHED_COMPLETE;
  11369. return WOLFSSL_SUCCESS;
  11370. }
  11371. #endif
  11372. FALL_THROUGH;
  11373. case TLS13_ACCEPT_FINISHED_SENT :
  11374. #ifdef HAVE_SESSION_TICKET
  11375. #ifdef WOLFSSL_TLS13_TICKET_BEFORE_FINISHED
  11376. if (!ssl->options.verifyPeer && !ssl->options.noTicketTls13 &&
  11377. ssl->ctx->ticketEncCb != NULL) {
  11378. if ((ssl->error = SendTls13NewSessionTicket(ssl)) != 0) {
  11379. WOLFSSL_ERROR(ssl->error);
  11380. return WOLFSSL_FATAL_ERROR;
  11381. }
  11382. ssl->options.ticketsSent = 1;
  11383. }
  11384. #endif
  11385. #endif /* HAVE_SESSION_TICKET */
  11386. ssl->options.acceptState = TLS13_PRE_TICKET_SENT;
  11387. WOLFSSL_MSG("accept state TICKET_SENT");
  11388. FALL_THROUGH;
  11389. case TLS13_PRE_TICKET_SENT :
  11390. while (ssl->options.clientState < CLIENT_FINISHED_COMPLETE) {
  11391. if ( (ssl->error = ProcessReply(ssl)) < 0) {
  11392. WOLFSSL_ERROR(ssl->error);
  11393. return WOLFSSL_FATAL_ERROR;
  11394. }
  11395. #ifdef WOLFSSL_DTLS13
  11396. if (ssl->options.dtls) {
  11397. if ((ssl->error = Dtls13DoScheduledWork(ssl)) < 0) {
  11398. WOLFSSL_ERROR(ssl->error);
  11399. return WOLFSSL_FATAL_ERROR;
  11400. }
  11401. }
  11402. #endif /* WOLFSSL_DTLS13 */
  11403. }
  11404. ssl->options.acceptState = TLS13_ACCEPT_FINISHED_DONE;
  11405. WOLFSSL_MSG("accept state ACCEPT_FINISHED_DONE");
  11406. FALL_THROUGH;
  11407. case TLS13_ACCEPT_FINISHED_DONE :
  11408. /* SERVER: When not resuming and verifying peer but no certificate
  11409. * received and not failing when not received then peer auth good.
  11410. */
  11411. if (!ssl->options.resuming && ssl->options.verifyPeer &&
  11412. #ifdef WOLFSSL_POST_HANDSHAKE_AUTH
  11413. !ssl->options.verifyPostHandshake &&
  11414. #endif
  11415. !ssl->options.havePeerCert && !ssl->options.failNoCert) {
  11416. ssl->options.peerAuthGood = 1;
  11417. }
  11418. /* SERVER: check peer authentication. */
  11419. if (!ssl->options.peerAuthGood) {
  11420. WOLFSSL_MSG("Client authentication did not happen");
  11421. return WOLFSSL_FATAL_ERROR;
  11422. }
  11423. #ifdef HAVE_SESSION_TICKET
  11424. while (ssl->options.ticketsSent < ssl->options.maxTicketTls13) {
  11425. if (!ssl->options.noTicketTls13 && ssl->ctx->ticketEncCb
  11426. != NULL) {
  11427. if ((ssl->error = SendTls13NewSessionTicket(ssl)) != 0) {
  11428. WOLFSSL_ERROR(ssl->error);
  11429. return WOLFSSL_FATAL_ERROR;
  11430. }
  11431. }
  11432. ssl->options.ticketsSent++;
  11433. /* only one session ticket is sent on session resumption */
  11434. if (ssl->options.resuming) {
  11435. break;
  11436. }
  11437. }
  11438. #endif /* HAVE_SESSION_TICKET */
  11439. ssl->options.acceptState = TLS13_TICKET_SENT;
  11440. WOLFSSL_MSG("accept state TICKET_SENT");
  11441. FALL_THROUGH;
  11442. case TLS13_TICKET_SENT :
  11443. #ifndef NO_HANDSHAKE_DONE_CB
  11444. if (ssl->hsDoneCb) {
  11445. int cbret = ssl->hsDoneCb(ssl, ssl->hsDoneCtx);
  11446. if (cbret < 0) {
  11447. ssl->error = cbret;
  11448. WOLFSSL_MSG("HandShake Done Cb don't continue error");
  11449. return WOLFSSL_FATAL_ERROR;
  11450. }
  11451. }
  11452. #endif /* NO_HANDSHAKE_DONE_CB */
  11453. if (!ssl->options.keepResources) {
  11454. FreeHandshakeResources(ssl);
  11455. }
  11456. #if defined(WOLFSSL_ASYNC_IO) && !defined(WOLFSSL_ASYNC_CRYPT)
  11457. /* Free the remaining async context if not using it for crypto */
  11458. FreeAsyncCtx(ssl, 1);
  11459. #endif
  11460. ssl->error = 0; /* clear the error */
  11461. WOLFSSL_LEAVE("SSL_accept()", WOLFSSL_SUCCESS);
  11462. return WOLFSSL_SUCCESS;
  11463. default :
  11464. WOLFSSL_MSG("Unknown accept state ERROR");
  11465. return WOLFSSL_FATAL_ERROR;
  11466. }
  11467. }
  11468. #endif
  11469. #if !defined(NO_WOLFSSL_SERVER) && defined(HAVE_SESSION_TICKET)
  11470. /* Server sends a session ticket to the peer.
  11471. *
  11472. * RFC 8446, section 4.6.1, para 1.
  11473. *
  11474. * ssl The SSL/TLS object.
  11475. * returns BAD_FUNC_ARG when ssl is NULL, or not using TLS v1.3,
  11476. * SIDE_ERROR when not a server,
  11477. * NOT_READY_ERROR when handshake not complete,
  11478. * WOLFSSL_FATAL_ERROR when creating or sending message fails, and
  11479. * WOLFSSL_SUCCESS on success.
  11480. */
  11481. int wolfSSL_send_SessionTicket(WOLFSSL* ssl)
  11482. {
  11483. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  11484. return BAD_FUNC_ARG;
  11485. if (ssl->options.side == WOLFSSL_CLIENT_END)
  11486. return SIDE_ERROR;
  11487. if (ssl->options.handShakeState != HANDSHAKE_DONE)
  11488. return NOT_READY_ERROR;
  11489. if ((ssl->error = SendTls13NewSessionTicket(ssl)) != 0) {
  11490. WOLFSSL_ERROR(ssl->error);
  11491. return WOLFSSL_FATAL_ERROR;
  11492. }
  11493. ssl->options.ticketsSent++;
  11494. return WOLFSSL_SUCCESS;
  11495. }
  11496. #endif
  11497. #ifdef WOLFSSL_EARLY_DATA
  11498. /* Sets the maximum amount of early data that can be seen by server when using
  11499. * session tickets for resumption.
  11500. * A value of zero indicates no early data is to be sent by client using session
  11501. * tickets.
  11502. *
  11503. * ctx The SSL/TLS CTX object.
  11504. * sz Maximum size of the early data.
  11505. * returns BAD_FUNC_ARG when ctx is NULL, SIDE_ERROR when not a server and
  11506. * 0 on success.
  11507. */
  11508. int wolfSSL_CTX_set_max_early_data(WOLFSSL_CTX* ctx, unsigned int sz)
  11509. {
  11510. if (ctx == NULL || !IsAtLeastTLSv1_3(ctx->method->version))
  11511. return BAD_FUNC_ARG;
  11512. if (ctx->method->side == WOLFSSL_CLIENT_END)
  11513. return SIDE_ERROR;
  11514. ctx->maxEarlyDataSz = sz;
  11515. #if defined(OPENSSL_EXTRA) || defined(WOLFSSL_ERROR_CODE_OPENSSL)
  11516. /* 1 on success in OpenSSL*/
  11517. return WOLFSSL_SUCCESS;
  11518. #else
  11519. return 0;
  11520. #endif
  11521. }
  11522. /* Sets the maximum amount of early data that a client or server would like
  11523. * to exchange. Servers will advertise this value in session tickets sent
  11524. * to a client.
  11525. * A value of zero indicates no early data will be sent by a client, or
  11526. * no early data is accepted by a server (and announced as such in send out
  11527. * session tickets).
  11528. *
  11529. * ssl The SSL/TLS object.
  11530. * sz Maximum size of the early data.
  11531. * returns BAD_FUNC_ARG when ssl is NULL, or not using TLS v1.3,
  11532. * and 0 on success.
  11533. */
  11534. int wolfSSL_set_max_early_data(WOLFSSL* ssl, unsigned int sz)
  11535. {
  11536. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  11537. return BAD_FUNC_ARG;
  11538. ssl->options.maxEarlyDataSz = sz;
  11539. #if defined(OPENSSL_EXTRA) || defined(WOLFSSL_ERROR_CODE_OPENSSL)
  11540. /* 1 on success in OpenSSL*/
  11541. return WOLFSSL_SUCCESS;
  11542. #else
  11543. return 0;
  11544. #endif
  11545. }
  11546. /* Gets the maximum amount of early data that can be seen by server when using
  11547. * session tickets for resumption.
  11548. * A value of zero indicates no early data is to be sent by client using session
  11549. * tickets.
  11550. *
  11551. * ctx The SSL/TLS CTX object.
  11552. * returns BAD_FUNC_ARG when ctx is NULL, SIDE_ERROR when not a server and
  11553. * returns the maximum amount of early data to be set
  11554. */
  11555. int wolfSSL_CTX_get_max_early_data(WOLFSSL_CTX* ctx)
  11556. {
  11557. if (ctx == NULL || !IsAtLeastTLSv1_3(ctx->method->version))
  11558. return BAD_FUNC_ARG;
  11559. if (ctx->method->side == WOLFSSL_CLIENT_END)
  11560. return SIDE_ERROR;
  11561. return ctx->maxEarlyDataSz;
  11562. }
  11563. /* Gets the maximum amount of early data that can be seen by server when using
  11564. * session tickets for resumption.
  11565. * A value of zero indicates no early data is to be sent by client using session
  11566. * tickets.
  11567. *
  11568. * ssl The SSL/TLS object.
  11569. * returns BAD_FUNC_ARG when ssl is NULL, or not using TLS v1.3,
  11570. * SIDE_ERROR when not a server and
  11571. * returns the maximum amount of early data to be set
  11572. */
  11573. int wolfSSL_get_max_early_data(WOLFSSL* ssl)
  11574. {
  11575. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  11576. return BAD_FUNC_ARG;
  11577. return ssl->options.maxEarlyDataSz;
  11578. }
  11579. /* Write early data to the server.
  11580. *
  11581. * ssl The SSL/TLS object.
  11582. * data Early data to write
  11583. * sz The size of the early data in bytes.
  11584. * outSz The number of early data bytes written.
  11585. * returns BAD_FUNC_ARG when: ssl, data or outSz is NULL; sz is negative;
  11586. * or not using TLS v1.3. SIDE ERROR when not a server. Otherwise the number of
  11587. * early data bytes written.
  11588. */
  11589. int wolfSSL_write_early_data(WOLFSSL* ssl, const void* data, int sz, int* outSz)
  11590. {
  11591. int ret = 0;
  11592. WOLFSSL_ENTER("SSL_write_early_data()");
  11593. if (ssl == NULL || data == NULL || sz < 0 || outSz == NULL)
  11594. return BAD_FUNC_ARG;
  11595. if (!IsAtLeastTLSv1_3(ssl->version))
  11596. return BAD_FUNC_ARG;
  11597. #ifndef NO_WOLFSSL_CLIENT
  11598. if (ssl->options.side == WOLFSSL_SERVER_END)
  11599. return SIDE_ERROR;
  11600. if (ssl->options.handShakeState == NULL_STATE) {
  11601. if (ssl->error != WC_PENDING_E)
  11602. ssl->earlyData = expecting_early_data;
  11603. ret = wolfSSL_connect_TLSv13(ssl);
  11604. if (ret != WOLFSSL_SUCCESS)
  11605. return WOLFSSL_FATAL_ERROR;
  11606. /* on client side, status is set to rejected */
  11607. /* until sever accepts the early data extension. */
  11608. ssl->earlyDataStatus = WOLFSSL_EARLY_DATA_REJECTED;
  11609. }
  11610. if (ssl->options.handShakeState == CLIENT_HELLO_COMPLETE) {
  11611. #ifdef OPENSSL_EXTRA
  11612. /* when processed early data exceeds max size */
  11613. if (ssl->session->maxEarlyDataSz > 0 &&
  11614. (ssl->earlyDataSz + sz > ssl->session->maxEarlyDataSz)) {
  11615. ssl->error = TOO_MUCH_EARLY_DATA;
  11616. return WOLFSSL_FATAL_ERROR;
  11617. }
  11618. #endif
  11619. ret = SendData(ssl, data, sz);
  11620. if (ret > 0) {
  11621. *outSz = ret;
  11622. /* store amount of processed early data from client */
  11623. ssl->earlyDataSz += ret;
  11624. }
  11625. }
  11626. #else
  11627. return SIDE_ERROR;
  11628. #endif
  11629. WOLFSSL_LEAVE("SSL_write_early_data()", ret);
  11630. if (ret < 0)
  11631. ret = WOLFSSL_FATAL_ERROR;
  11632. return ret;
  11633. }
  11634. /* Read the any early data from the client.
  11635. *
  11636. * ssl The SSL/TLS object.
  11637. * data Buffer to put the early data into.
  11638. * sz The size of the buffer in bytes.
  11639. * outSz The number of early data bytes read.
  11640. * returns BAD_FUNC_ARG when: ssl, data or outSz is NULL; sz is negative;
  11641. * or not using TLS v1.3. SIDE ERROR when not a server. Otherwise the number of
  11642. * early data bytes read.
  11643. */
  11644. int wolfSSL_read_early_data(WOLFSSL* ssl, void* data, int sz, int* outSz)
  11645. {
  11646. int ret = 0;
  11647. WOLFSSL_ENTER("wolfSSL_read_early_data()");
  11648. if (ssl == NULL || data == NULL || sz < 0 || outSz == NULL)
  11649. return BAD_FUNC_ARG;
  11650. if (!IsAtLeastTLSv1_3(ssl->version))
  11651. return BAD_FUNC_ARG;
  11652. #ifndef NO_WOLFSSL_SERVER
  11653. if (ssl->options.side == WOLFSSL_CLIENT_END)
  11654. return SIDE_ERROR;
  11655. if (ssl->options.handShakeState == NULL_STATE) {
  11656. if (ssl->error != WC_PENDING_E)
  11657. ssl->earlyData = expecting_early_data;
  11658. /* this used to be: ret = wolfSSL_accept_TLSv13(ssl);
  11659. * However, wolfSSL_accept_TLSv13() expects a certificate to
  11660. * be installed already, which is not the case in servers
  11661. * such as HAProxy. They do it after inspecting the ClientHello.
  11662. * The common wolfssl_accept() allows that. */
  11663. ret = wolfSSL_accept(ssl);
  11664. if (ret <= 0)
  11665. return WOLFSSL_FATAL_ERROR;
  11666. }
  11667. if (ssl->options.handShakeState == SERVER_FINISHED_COMPLETE) {
  11668. ret = ReceiveData(ssl, (byte*)data, sz, FALSE);
  11669. if (ret > 0)
  11670. *outSz = ret;
  11671. if (ssl->error == ZERO_RETURN) {
  11672. ssl->error = WOLFSSL_ERROR_NONE;
  11673. #ifdef WOLFSSL_DTLS13
  11674. if (ssl->options.dtls) {
  11675. ret = Dtls13DoScheduledWork(ssl);
  11676. if (ret < 0) {
  11677. ssl->error = ret;
  11678. WOLFSSL_ERROR(ssl->error);
  11679. return WOLFSSL_FATAL_ERROR;
  11680. }
  11681. }
  11682. #endif /* WOLFSSL_DTLS13 */
  11683. }
  11684. }
  11685. else
  11686. ret = 0;
  11687. #else
  11688. return SIDE_ERROR;
  11689. #endif
  11690. WOLFSSL_LEAVE("wolfSSL_read_early_data()", ret);
  11691. if (ret < 0)
  11692. ret = WOLFSSL_FATAL_ERROR;
  11693. return ret;
  11694. }
  11695. /* Returns early data status
  11696. *
  11697. * ssl The SSL/TLS object.
  11698. * returns WOLFSSL_EARLY_DATA_ACCEPTED if the data was accepted
  11699. * WOLFSSL_EARLY_DATA_REJECTED if the data was rejected
  11700. * WOLFSSL_EARLY_DATA_NOT_SENT if no early data was sent
  11701. */
  11702. int wolfSSL_get_early_data_status(const WOLFSSL* ssl)
  11703. {
  11704. if (ssl == NULL || !IsAtLeastTLSv1_3(ssl->version))
  11705. return BAD_FUNC_ARG;
  11706. return ssl->earlyDataStatus;
  11707. }
  11708. #endif
  11709. #ifdef HAVE_SECRET_CALLBACK
  11710. int wolfSSL_set_tls13_secret_cb(WOLFSSL* ssl, Tls13SecretCb cb, void* ctx)
  11711. {
  11712. WOLFSSL_ENTER("wolfSSL_set_tls13_secret_cb");
  11713. if (ssl == NULL)
  11714. return WOLFSSL_FATAL_ERROR;
  11715. ssl->tls13SecretCb = cb;
  11716. ssl->tls13SecretCtx = ctx;
  11717. return WOLFSSL_SUCCESS;
  11718. }
  11719. #endif
  11720. #undef ERROR_OUT
  11721. #endif /* !WOLFCRYPT_ONLY */
  11722. #endif /* WOLFSSL_TLS13 */