ssl_tls.c 320 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981
  1. /*
  2. * TLS shared functions
  3. *
  4. * Copyright The Mbed TLS Contributors
  5. * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
  6. */
  7. /*
  8. * http://www.ietf.org/rfc/rfc2246.txt
  9. * http://www.ietf.org/rfc/rfc4346.txt
  10. */
  11. #include "common.h"
  12. #if defined(MBEDTLS_SSL_TLS_C)
  13. #include "mbedtls/platform.h"
  14. #include "mbedtls/ssl.h"
  15. #include "ssl_client.h"
  16. #include "ssl_debug_helpers.h"
  17. #include "ssl_misc.h"
  18. #include "debug_internal.h"
  19. #include "mbedtls/error.h"
  20. #include "mbedtls/platform_util.h"
  21. #include "mbedtls/version.h"
  22. #include "mbedtls/constant_time.h"
  23. #include <string.h>
  24. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  25. #include "mbedtls/psa_util.h"
  26. #include "md_psa.h"
  27. #include "psa_util_internal.h"
  28. #include "psa/crypto.h"
  29. #endif
  30. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  31. #include "mbedtls/oid.h"
  32. #endif
  33. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  34. /* Define local translating functions to save code size by not using too many
  35. * arguments in each translating place. */
  36. static int local_err_translation(psa_status_t status)
  37. {
  38. return psa_status_to_mbedtls(status, psa_to_ssl_errors,
  39. ARRAY_LENGTH(psa_to_ssl_errors),
  40. psa_generic_status_to_mbedtls);
  41. }
  42. #define PSA_TO_MBEDTLS_ERR(status) local_err_translation(status)
  43. #endif
  44. #if defined(MBEDTLS_TEST_HOOKS)
  45. static mbedtls_ssl_chk_buf_ptr_args chk_buf_ptr_fail_args;
  46. void mbedtls_ssl_set_chk_buf_ptr_fail_args(
  47. const uint8_t *cur, const uint8_t *end, size_t need)
  48. {
  49. chk_buf_ptr_fail_args.cur = cur;
  50. chk_buf_ptr_fail_args.end = end;
  51. chk_buf_ptr_fail_args.need = need;
  52. }
  53. void mbedtls_ssl_reset_chk_buf_ptr_fail_args(void)
  54. {
  55. memset(&chk_buf_ptr_fail_args, 0, sizeof(chk_buf_ptr_fail_args));
  56. }
  57. int mbedtls_ssl_cmp_chk_buf_ptr_fail_args(mbedtls_ssl_chk_buf_ptr_args *args)
  58. {
  59. return (chk_buf_ptr_fail_args.cur != args->cur) ||
  60. (chk_buf_ptr_fail_args.end != args->end) ||
  61. (chk_buf_ptr_fail_args.need != args->need);
  62. }
  63. #endif /* MBEDTLS_TEST_HOOKS */
  64. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  65. #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
  66. /* Top-level Connection ID API */
  67. int mbedtls_ssl_conf_cid(mbedtls_ssl_config *conf,
  68. size_t len,
  69. int ignore_other_cid)
  70. {
  71. if (len > MBEDTLS_SSL_CID_IN_LEN_MAX) {
  72. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  73. }
  74. if (ignore_other_cid != MBEDTLS_SSL_UNEXPECTED_CID_FAIL &&
  75. ignore_other_cid != MBEDTLS_SSL_UNEXPECTED_CID_IGNORE) {
  76. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  77. }
  78. conf->ignore_unexpected_cid = ignore_other_cid;
  79. conf->cid_len = len;
  80. return 0;
  81. }
  82. int mbedtls_ssl_set_cid(mbedtls_ssl_context *ssl,
  83. int enable,
  84. unsigned char const *own_cid,
  85. size_t own_cid_len)
  86. {
  87. if (ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  88. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  89. }
  90. ssl->negotiate_cid = enable;
  91. if (enable == MBEDTLS_SSL_CID_DISABLED) {
  92. MBEDTLS_SSL_DEBUG_MSG(3, ("Disable use of CID extension."));
  93. return 0;
  94. }
  95. MBEDTLS_SSL_DEBUG_MSG(3, ("Enable use of CID extension."));
  96. MBEDTLS_SSL_DEBUG_BUF(3, "Own CID", own_cid, own_cid_len);
  97. if (own_cid_len != ssl->conf->cid_len) {
  98. MBEDTLS_SSL_DEBUG_MSG(3, ("CID length %u does not match CID length %u in config",
  99. (unsigned) own_cid_len,
  100. (unsigned) ssl->conf->cid_len));
  101. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  102. }
  103. memcpy(ssl->own_cid, own_cid, own_cid_len);
  104. /* Truncation is not an issue here because
  105. * MBEDTLS_SSL_CID_IN_LEN_MAX at most 255. */
  106. ssl->own_cid_len = (uint8_t) own_cid_len;
  107. return 0;
  108. }
  109. int mbedtls_ssl_get_own_cid(mbedtls_ssl_context *ssl,
  110. int *enabled,
  111. unsigned char own_cid[MBEDTLS_SSL_CID_IN_LEN_MAX],
  112. size_t *own_cid_len)
  113. {
  114. *enabled = MBEDTLS_SSL_CID_DISABLED;
  115. if (ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  116. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  117. }
  118. /* We report MBEDTLS_SSL_CID_DISABLED in case the CID length is
  119. * zero as this is indistinguishable from not requesting to use
  120. * the CID extension. */
  121. if (ssl->own_cid_len == 0 || ssl->negotiate_cid == MBEDTLS_SSL_CID_DISABLED) {
  122. return 0;
  123. }
  124. if (own_cid_len != NULL) {
  125. *own_cid_len = ssl->own_cid_len;
  126. if (own_cid != NULL) {
  127. memcpy(own_cid, ssl->own_cid, ssl->own_cid_len);
  128. }
  129. }
  130. *enabled = MBEDTLS_SSL_CID_ENABLED;
  131. return 0;
  132. }
  133. int mbedtls_ssl_get_peer_cid(mbedtls_ssl_context *ssl,
  134. int *enabled,
  135. unsigned char peer_cid[MBEDTLS_SSL_CID_OUT_LEN_MAX],
  136. size_t *peer_cid_len)
  137. {
  138. *enabled = MBEDTLS_SSL_CID_DISABLED;
  139. if (ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM ||
  140. mbedtls_ssl_is_handshake_over(ssl) == 0) {
  141. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  142. }
  143. /* We report MBEDTLS_SSL_CID_DISABLED in case the CID extensions
  144. * were used, but client and server requested the empty CID.
  145. * This is indistinguishable from not using the CID extension
  146. * in the first place. */
  147. if (ssl->transform_in->in_cid_len == 0 &&
  148. ssl->transform_in->out_cid_len == 0) {
  149. return 0;
  150. }
  151. if (peer_cid_len != NULL) {
  152. *peer_cid_len = ssl->transform_in->out_cid_len;
  153. if (peer_cid != NULL) {
  154. memcpy(peer_cid, ssl->transform_in->out_cid,
  155. ssl->transform_in->out_cid_len);
  156. }
  157. }
  158. *enabled = MBEDTLS_SSL_CID_ENABLED;
  159. return 0;
  160. }
  161. #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
  162. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  163. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  164. /*
  165. * Convert max_fragment_length codes to length.
  166. * RFC 6066 says:
  167. * enum{
  168. * 2^9(1), 2^10(2), 2^11(3), 2^12(4), (255)
  169. * } MaxFragmentLength;
  170. * and we add 0 -> extension unused
  171. */
  172. static unsigned int ssl_mfl_code_to_length(int mfl)
  173. {
  174. switch (mfl) {
  175. case MBEDTLS_SSL_MAX_FRAG_LEN_NONE:
  176. return MBEDTLS_TLS_EXT_ADV_CONTENT_LEN;
  177. case MBEDTLS_SSL_MAX_FRAG_LEN_512:
  178. return 512;
  179. case MBEDTLS_SSL_MAX_FRAG_LEN_1024:
  180. return 1024;
  181. case MBEDTLS_SSL_MAX_FRAG_LEN_2048:
  182. return 2048;
  183. case MBEDTLS_SSL_MAX_FRAG_LEN_4096:
  184. return 4096;
  185. default:
  186. return MBEDTLS_TLS_EXT_ADV_CONTENT_LEN;
  187. }
  188. }
  189. #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
  190. int mbedtls_ssl_session_copy(mbedtls_ssl_session *dst,
  191. const mbedtls_ssl_session *src)
  192. {
  193. mbedtls_ssl_session_free(dst);
  194. memcpy(dst, src, sizeof(mbedtls_ssl_session));
  195. #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
  196. dst->ticket = NULL;
  197. #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && \
  198. defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  199. dst->hostname = NULL;
  200. #endif
  201. #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
  202. #if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_ALPN) && \
  203. defined(MBEDTLS_SSL_EARLY_DATA)
  204. dst->ticket_alpn = NULL;
  205. #endif
  206. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  207. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  208. if (src->peer_cert != NULL) {
  209. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  210. dst->peer_cert = mbedtls_calloc(1, sizeof(mbedtls_x509_crt));
  211. if (dst->peer_cert == NULL) {
  212. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  213. }
  214. mbedtls_x509_crt_init(dst->peer_cert);
  215. if ((ret = mbedtls_x509_crt_parse_der(dst->peer_cert, src->peer_cert->raw.p,
  216. src->peer_cert->raw.len)) != 0) {
  217. mbedtls_free(dst->peer_cert);
  218. dst->peer_cert = NULL;
  219. return ret;
  220. }
  221. }
  222. #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  223. if (src->peer_cert_digest != NULL) {
  224. dst->peer_cert_digest =
  225. mbedtls_calloc(1, src->peer_cert_digest_len);
  226. if (dst->peer_cert_digest == NULL) {
  227. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  228. }
  229. memcpy(dst->peer_cert_digest, src->peer_cert_digest,
  230. src->peer_cert_digest_len);
  231. dst->peer_cert_digest_type = src->peer_cert_digest_type;
  232. dst->peer_cert_digest_len = src->peer_cert_digest_len;
  233. }
  234. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  235. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  236. #if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_ALPN) && \
  237. defined(MBEDTLS_SSL_EARLY_DATA)
  238. {
  239. int ret = mbedtls_ssl_session_set_ticket_alpn(dst, src->ticket_alpn);
  240. if (ret != 0) {
  241. return ret;
  242. }
  243. }
  244. #endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_ALPN && MBEDTLS_SSL_EARLY_DATA */
  245. #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
  246. if (src->ticket != NULL) {
  247. dst->ticket = mbedtls_calloc(1, src->ticket_len);
  248. if (dst->ticket == NULL) {
  249. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  250. }
  251. memcpy(dst->ticket, src->ticket, src->ticket_len);
  252. }
  253. #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && \
  254. defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  255. if (src->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  256. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  257. ret = mbedtls_ssl_session_set_hostname(dst, src->hostname);
  258. if (ret != 0) {
  259. return ret;
  260. }
  261. }
  262. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 &&
  263. MBEDTLS_SSL_SERVER_NAME_INDICATION */
  264. #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
  265. return 0;
  266. }
  267. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  268. MBEDTLS_CHECK_RETURN_CRITICAL
  269. static int resize_buffer(unsigned char **buffer, size_t len_new, size_t *len_old)
  270. {
  271. unsigned char *resized_buffer = mbedtls_calloc(1, len_new);
  272. if (resized_buffer == NULL) {
  273. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  274. }
  275. /* We want to copy len_new bytes when downsizing the buffer, and
  276. * len_old bytes when upsizing, so we choose the smaller of two sizes,
  277. * to fit one buffer into another. Size checks, ensuring that no data is
  278. * lost, are done outside of this function. */
  279. memcpy(resized_buffer, *buffer,
  280. (len_new < *len_old) ? len_new : *len_old);
  281. mbedtls_zeroize_and_free(*buffer, *len_old);
  282. *buffer = resized_buffer;
  283. *len_old = len_new;
  284. return 0;
  285. }
  286. static void handle_buffer_resizing(mbedtls_ssl_context *ssl, int downsizing,
  287. size_t in_buf_new_len,
  288. size_t out_buf_new_len)
  289. {
  290. int modified = 0;
  291. size_t written_in = 0, iv_offset_in = 0, len_offset_in = 0, hdr_in = 0;
  292. size_t written_out = 0, iv_offset_out = 0, len_offset_out = 0;
  293. if (ssl->in_buf != NULL) {
  294. written_in = ssl->in_msg - ssl->in_buf;
  295. iv_offset_in = ssl->in_iv - ssl->in_buf;
  296. len_offset_in = ssl->in_len - ssl->in_buf;
  297. hdr_in = ssl->in_hdr - ssl->in_buf;
  298. if (downsizing ?
  299. ssl->in_buf_len > in_buf_new_len && ssl->in_left < in_buf_new_len :
  300. ssl->in_buf_len < in_buf_new_len) {
  301. if (resize_buffer(&ssl->in_buf, in_buf_new_len, &ssl->in_buf_len) != 0) {
  302. MBEDTLS_SSL_DEBUG_MSG(1, ("input buffer resizing failed - out of memory"));
  303. } else {
  304. MBEDTLS_SSL_DEBUG_MSG(2, ("Reallocating in_buf to %" MBEDTLS_PRINTF_SIZET,
  305. in_buf_new_len));
  306. modified = 1;
  307. }
  308. }
  309. }
  310. if (ssl->out_buf != NULL) {
  311. written_out = ssl->out_msg - ssl->out_buf;
  312. iv_offset_out = ssl->out_iv - ssl->out_buf;
  313. len_offset_out = ssl->out_len - ssl->out_buf;
  314. if (downsizing ?
  315. ssl->out_buf_len > out_buf_new_len && ssl->out_left < out_buf_new_len :
  316. ssl->out_buf_len < out_buf_new_len) {
  317. if (resize_buffer(&ssl->out_buf, out_buf_new_len, &ssl->out_buf_len) != 0) {
  318. MBEDTLS_SSL_DEBUG_MSG(1, ("output buffer resizing failed - out of memory"));
  319. } else {
  320. MBEDTLS_SSL_DEBUG_MSG(2, ("Reallocating out_buf to %" MBEDTLS_PRINTF_SIZET,
  321. out_buf_new_len));
  322. modified = 1;
  323. }
  324. }
  325. }
  326. if (modified) {
  327. /* Update pointers here to avoid doing it twice. */
  328. ssl->in_hdr = ssl->in_buf + hdr_in;
  329. mbedtls_ssl_update_in_pointers(ssl);
  330. mbedtls_ssl_reset_out_pointers(ssl);
  331. /* Fields below might not be properly updated with record
  332. * splitting or with CID, so they are manually updated here. */
  333. ssl->out_msg = ssl->out_buf + written_out;
  334. ssl->out_len = ssl->out_buf + len_offset_out;
  335. ssl->out_iv = ssl->out_buf + iv_offset_out;
  336. ssl->in_msg = ssl->in_buf + written_in;
  337. ssl->in_len = ssl->in_buf + len_offset_in;
  338. ssl->in_iv = ssl->in_buf + iv_offset_in;
  339. }
  340. }
  341. #endif /* MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH */
  342. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  343. #if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
  344. typedef int (*tls_prf_fn)(const unsigned char *secret, size_t slen,
  345. const char *label,
  346. const unsigned char *random, size_t rlen,
  347. unsigned char *dstbuf, size_t dlen);
  348. static tls_prf_fn ssl_tls12prf_from_cs(int ciphersuite_id);
  349. #endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
  350. /* Type for the TLS PRF */
  351. typedef int ssl_tls_prf_t(const unsigned char *, size_t, const char *,
  352. const unsigned char *, size_t,
  353. unsigned char *, size_t);
  354. MBEDTLS_CHECK_RETURN_CRITICAL
  355. static int ssl_tls12_populate_transform(mbedtls_ssl_transform *transform,
  356. int ciphersuite,
  357. const unsigned char master[48],
  358. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  359. int encrypt_then_mac,
  360. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
  361. ssl_tls_prf_t tls_prf,
  362. const unsigned char randbytes[64],
  363. mbedtls_ssl_protocol_version tls_version,
  364. unsigned endpoint,
  365. const mbedtls_ssl_context *ssl);
  366. #if defined(MBEDTLS_MD_CAN_SHA256)
  367. MBEDTLS_CHECK_RETURN_CRITICAL
  368. static int tls_prf_sha256(const unsigned char *secret, size_t slen,
  369. const char *label,
  370. const unsigned char *random, size_t rlen,
  371. unsigned char *dstbuf, size_t dlen);
  372. static int ssl_calc_verify_tls_sha256(const mbedtls_ssl_context *, unsigned char *, size_t *);
  373. static int ssl_calc_finished_tls_sha256(mbedtls_ssl_context *, unsigned char *, int);
  374. #endif /* MBEDTLS_MD_CAN_SHA256*/
  375. #if defined(MBEDTLS_MD_CAN_SHA384)
  376. MBEDTLS_CHECK_RETURN_CRITICAL
  377. static int tls_prf_sha384(const unsigned char *secret, size_t slen,
  378. const char *label,
  379. const unsigned char *random, size_t rlen,
  380. unsigned char *dstbuf, size_t dlen);
  381. static int ssl_calc_verify_tls_sha384(const mbedtls_ssl_context *, unsigned char *, size_t *);
  382. static int ssl_calc_finished_tls_sha384(mbedtls_ssl_context *, unsigned char *, int);
  383. #endif /* MBEDTLS_MD_CAN_SHA384*/
  384. MBEDTLS_CHECK_RETURN_CRITICAL
  385. static int ssl_tls12_session_load(mbedtls_ssl_session *session,
  386. const unsigned char *buf,
  387. size_t len);
  388. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  389. static int ssl_update_checksum_start(mbedtls_ssl_context *, const unsigned char *, size_t);
  390. #if defined(MBEDTLS_MD_CAN_SHA256)
  391. static int ssl_update_checksum_sha256(mbedtls_ssl_context *, const unsigned char *, size_t);
  392. #endif /* MBEDTLS_MD_CAN_SHA256*/
  393. #if defined(MBEDTLS_MD_CAN_SHA384)
  394. static int ssl_update_checksum_sha384(mbedtls_ssl_context *, const unsigned char *, size_t);
  395. #endif /* MBEDTLS_MD_CAN_SHA384*/
  396. int mbedtls_ssl_tls_prf(const mbedtls_tls_prf_types prf,
  397. const unsigned char *secret, size_t slen,
  398. const char *label,
  399. const unsigned char *random, size_t rlen,
  400. unsigned char *dstbuf, size_t dlen)
  401. {
  402. mbedtls_ssl_tls_prf_cb *tls_prf = NULL;
  403. switch (prf) {
  404. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  405. #if defined(MBEDTLS_MD_CAN_SHA384)
  406. case MBEDTLS_SSL_TLS_PRF_SHA384:
  407. tls_prf = tls_prf_sha384;
  408. break;
  409. #endif /* MBEDTLS_MD_CAN_SHA384*/
  410. #if defined(MBEDTLS_MD_CAN_SHA256)
  411. case MBEDTLS_SSL_TLS_PRF_SHA256:
  412. tls_prf = tls_prf_sha256;
  413. break;
  414. #endif /* MBEDTLS_MD_CAN_SHA256*/
  415. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  416. default:
  417. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  418. }
  419. return tls_prf(secret, slen, label, random, rlen, dstbuf, dlen);
  420. }
  421. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  422. static void ssl_clear_peer_cert(mbedtls_ssl_session *session)
  423. {
  424. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  425. if (session->peer_cert != NULL) {
  426. mbedtls_x509_crt_free(session->peer_cert);
  427. mbedtls_free(session->peer_cert);
  428. session->peer_cert = NULL;
  429. }
  430. #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  431. if (session->peer_cert_digest != NULL) {
  432. /* Zeroization is not necessary. */
  433. mbedtls_free(session->peer_cert_digest);
  434. session->peer_cert_digest = NULL;
  435. session->peer_cert_digest_type = MBEDTLS_MD_NONE;
  436. session->peer_cert_digest_len = 0;
  437. }
  438. #endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  439. }
  440. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  441. uint32_t mbedtls_ssl_get_extension_id(unsigned int extension_type)
  442. {
  443. switch (extension_type) {
  444. case MBEDTLS_TLS_EXT_SERVERNAME:
  445. return MBEDTLS_SSL_EXT_ID_SERVERNAME;
  446. case MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH:
  447. return MBEDTLS_SSL_EXT_ID_MAX_FRAGMENT_LENGTH;
  448. case MBEDTLS_TLS_EXT_STATUS_REQUEST:
  449. return MBEDTLS_SSL_EXT_ID_STATUS_REQUEST;
  450. case MBEDTLS_TLS_EXT_SUPPORTED_GROUPS:
  451. return MBEDTLS_SSL_EXT_ID_SUPPORTED_GROUPS;
  452. case MBEDTLS_TLS_EXT_SIG_ALG:
  453. return MBEDTLS_SSL_EXT_ID_SIG_ALG;
  454. case MBEDTLS_TLS_EXT_USE_SRTP:
  455. return MBEDTLS_SSL_EXT_ID_USE_SRTP;
  456. case MBEDTLS_TLS_EXT_HEARTBEAT:
  457. return MBEDTLS_SSL_EXT_ID_HEARTBEAT;
  458. case MBEDTLS_TLS_EXT_ALPN:
  459. return MBEDTLS_SSL_EXT_ID_ALPN;
  460. case MBEDTLS_TLS_EXT_SCT:
  461. return MBEDTLS_SSL_EXT_ID_SCT;
  462. case MBEDTLS_TLS_EXT_CLI_CERT_TYPE:
  463. return MBEDTLS_SSL_EXT_ID_CLI_CERT_TYPE;
  464. case MBEDTLS_TLS_EXT_SERV_CERT_TYPE:
  465. return MBEDTLS_SSL_EXT_ID_SERV_CERT_TYPE;
  466. case MBEDTLS_TLS_EXT_PADDING:
  467. return MBEDTLS_SSL_EXT_ID_PADDING;
  468. case MBEDTLS_TLS_EXT_PRE_SHARED_KEY:
  469. return MBEDTLS_SSL_EXT_ID_PRE_SHARED_KEY;
  470. case MBEDTLS_TLS_EXT_EARLY_DATA:
  471. return MBEDTLS_SSL_EXT_ID_EARLY_DATA;
  472. case MBEDTLS_TLS_EXT_SUPPORTED_VERSIONS:
  473. return MBEDTLS_SSL_EXT_ID_SUPPORTED_VERSIONS;
  474. case MBEDTLS_TLS_EXT_COOKIE:
  475. return MBEDTLS_SSL_EXT_ID_COOKIE;
  476. case MBEDTLS_TLS_EXT_PSK_KEY_EXCHANGE_MODES:
  477. return MBEDTLS_SSL_EXT_ID_PSK_KEY_EXCHANGE_MODES;
  478. case MBEDTLS_TLS_EXT_CERT_AUTH:
  479. return MBEDTLS_SSL_EXT_ID_CERT_AUTH;
  480. case MBEDTLS_TLS_EXT_OID_FILTERS:
  481. return MBEDTLS_SSL_EXT_ID_OID_FILTERS;
  482. case MBEDTLS_TLS_EXT_POST_HANDSHAKE_AUTH:
  483. return MBEDTLS_SSL_EXT_ID_POST_HANDSHAKE_AUTH;
  484. case MBEDTLS_TLS_EXT_SIG_ALG_CERT:
  485. return MBEDTLS_SSL_EXT_ID_SIG_ALG_CERT;
  486. case MBEDTLS_TLS_EXT_KEY_SHARE:
  487. return MBEDTLS_SSL_EXT_ID_KEY_SHARE;
  488. case MBEDTLS_TLS_EXT_TRUNCATED_HMAC:
  489. return MBEDTLS_SSL_EXT_ID_TRUNCATED_HMAC;
  490. case MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS:
  491. return MBEDTLS_SSL_EXT_ID_SUPPORTED_POINT_FORMATS;
  492. case MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC:
  493. return MBEDTLS_SSL_EXT_ID_ENCRYPT_THEN_MAC;
  494. case MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET:
  495. return MBEDTLS_SSL_EXT_ID_EXTENDED_MASTER_SECRET;
  496. case MBEDTLS_TLS_EXT_RECORD_SIZE_LIMIT:
  497. return MBEDTLS_SSL_EXT_ID_RECORD_SIZE_LIMIT;
  498. case MBEDTLS_TLS_EXT_SESSION_TICKET:
  499. return MBEDTLS_SSL_EXT_ID_SESSION_TICKET;
  500. }
  501. return MBEDTLS_SSL_EXT_ID_UNRECOGNIZED;
  502. }
  503. uint32_t mbedtls_ssl_get_extension_mask(unsigned int extension_type)
  504. {
  505. return 1 << mbedtls_ssl_get_extension_id(extension_type);
  506. }
  507. #if defined(MBEDTLS_DEBUG_C)
  508. static const char *extension_name_table[] = {
  509. [MBEDTLS_SSL_EXT_ID_UNRECOGNIZED] = "unrecognized",
  510. [MBEDTLS_SSL_EXT_ID_SERVERNAME] = "server_name",
  511. [MBEDTLS_SSL_EXT_ID_MAX_FRAGMENT_LENGTH] = "max_fragment_length",
  512. [MBEDTLS_SSL_EXT_ID_STATUS_REQUEST] = "status_request",
  513. [MBEDTLS_SSL_EXT_ID_SUPPORTED_GROUPS] = "supported_groups",
  514. [MBEDTLS_SSL_EXT_ID_SIG_ALG] = "signature_algorithms",
  515. [MBEDTLS_SSL_EXT_ID_USE_SRTP] = "use_srtp",
  516. [MBEDTLS_SSL_EXT_ID_HEARTBEAT] = "heartbeat",
  517. [MBEDTLS_SSL_EXT_ID_ALPN] = "application_layer_protocol_negotiation",
  518. [MBEDTLS_SSL_EXT_ID_SCT] = "signed_certificate_timestamp",
  519. [MBEDTLS_SSL_EXT_ID_CLI_CERT_TYPE] = "client_certificate_type",
  520. [MBEDTLS_SSL_EXT_ID_SERV_CERT_TYPE] = "server_certificate_type",
  521. [MBEDTLS_SSL_EXT_ID_PADDING] = "padding",
  522. [MBEDTLS_SSL_EXT_ID_PRE_SHARED_KEY] = "pre_shared_key",
  523. [MBEDTLS_SSL_EXT_ID_EARLY_DATA] = "early_data",
  524. [MBEDTLS_SSL_EXT_ID_SUPPORTED_VERSIONS] = "supported_versions",
  525. [MBEDTLS_SSL_EXT_ID_COOKIE] = "cookie",
  526. [MBEDTLS_SSL_EXT_ID_PSK_KEY_EXCHANGE_MODES] = "psk_key_exchange_modes",
  527. [MBEDTLS_SSL_EXT_ID_CERT_AUTH] = "certificate_authorities",
  528. [MBEDTLS_SSL_EXT_ID_OID_FILTERS] = "oid_filters",
  529. [MBEDTLS_SSL_EXT_ID_POST_HANDSHAKE_AUTH] = "post_handshake_auth",
  530. [MBEDTLS_SSL_EXT_ID_SIG_ALG_CERT] = "signature_algorithms_cert",
  531. [MBEDTLS_SSL_EXT_ID_KEY_SHARE] = "key_share",
  532. [MBEDTLS_SSL_EXT_ID_TRUNCATED_HMAC] = "truncated_hmac",
  533. [MBEDTLS_SSL_EXT_ID_SUPPORTED_POINT_FORMATS] = "supported_point_formats",
  534. [MBEDTLS_SSL_EXT_ID_ENCRYPT_THEN_MAC] = "encrypt_then_mac",
  535. [MBEDTLS_SSL_EXT_ID_EXTENDED_MASTER_SECRET] = "extended_master_secret",
  536. [MBEDTLS_SSL_EXT_ID_SESSION_TICKET] = "session_ticket",
  537. [MBEDTLS_SSL_EXT_ID_RECORD_SIZE_LIMIT] = "record_size_limit"
  538. };
  539. static const unsigned int extension_type_table[] = {
  540. [MBEDTLS_SSL_EXT_ID_UNRECOGNIZED] = 0xff,
  541. [MBEDTLS_SSL_EXT_ID_SERVERNAME] = MBEDTLS_TLS_EXT_SERVERNAME,
  542. [MBEDTLS_SSL_EXT_ID_MAX_FRAGMENT_LENGTH] = MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH,
  543. [MBEDTLS_SSL_EXT_ID_STATUS_REQUEST] = MBEDTLS_TLS_EXT_STATUS_REQUEST,
  544. [MBEDTLS_SSL_EXT_ID_SUPPORTED_GROUPS] = MBEDTLS_TLS_EXT_SUPPORTED_GROUPS,
  545. [MBEDTLS_SSL_EXT_ID_SIG_ALG] = MBEDTLS_TLS_EXT_SIG_ALG,
  546. [MBEDTLS_SSL_EXT_ID_USE_SRTP] = MBEDTLS_TLS_EXT_USE_SRTP,
  547. [MBEDTLS_SSL_EXT_ID_HEARTBEAT] = MBEDTLS_TLS_EXT_HEARTBEAT,
  548. [MBEDTLS_SSL_EXT_ID_ALPN] = MBEDTLS_TLS_EXT_ALPN,
  549. [MBEDTLS_SSL_EXT_ID_SCT] = MBEDTLS_TLS_EXT_SCT,
  550. [MBEDTLS_SSL_EXT_ID_CLI_CERT_TYPE] = MBEDTLS_TLS_EXT_CLI_CERT_TYPE,
  551. [MBEDTLS_SSL_EXT_ID_SERV_CERT_TYPE] = MBEDTLS_TLS_EXT_SERV_CERT_TYPE,
  552. [MBEDTLS_SSL_EXT_ID_PADDING] = MBEDTLS_TLS_EXT_PADDING,
  553. [MBEDTLS_SSL_EXT_ID_PRE_SHARED_KEY] = MBEDTLS_TLS_EXT_PRE_SHARED_KEY,
  554. [MBEDTLS_SSL_EXT_ID_EARLY_DATA] = MBEDTLS_TLS_EXT_EARLY_DATA,
  555. [MBEDTLS_SSL_EXT_ID_SUPPORTED_VERSIONS] = MBEDTLS_TLS_EXT_SUPPORTED_VERSIONS,
  556. [MBEDTLS_SSL_EXT_ID_COOKIE] = MBEDTLS_TLS_EXT_COOKIE,
  557. [MBEDTLS_SSL_EXT_ID_PSK_KEY_EXCHANGE_MODES] = MBEDTLS_TLS_EXT_PSK_KEY_EXCHANGE_MODES,
  558. [MBEDTLS_SSL_EXT_ID_CERT_AUTH] = MBEDTLS_TLS_EXT_CERT_AUTH,
  559. [MBEDTLS_SSL_EXT_ID_OID_FILTERS] = MBEDTLS_TLS_EXT_OID_FILTERS,
  560. [MBEDTLS_SSL_EXT_ID_POST_HANDSHAKE_AUTH] = MBEDTLS_TLS_EXT_POST_HANDSHAKE_AUTH,
  561. [MBEDTLS_SSL_EXT_ID_SIG_ALG_CERT] = MBEDTLS_TLS_EXT_SIG_ALG_CERT,
  562. [MBEDTLS_SSL_EXT_ID_KEY_SHARE] = MBEDTLS_TLS_EXT_KEY_SHARE,
  563. [MBEDTLS_SSL_EXT_ID_TRUNCATED_HMAC] = MBEDTLS_TLS_EXT_TRUNCATED_HMAC,
  564. [MBEDTLS_SSL_EXT_ID_SUPPORTED_POINT_FORMATS] = MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS,
  565. [MBEDTLS_SSL_EXT_ID_ENCRYPT_THEN_MAC] = MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC,
  566. [MBEDTLS_SSL_EXT_ID_EXTENDED_MASTER_SECRET] = MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET,
  567. [MBEDTLS_SSL_EXT_ID_SESSION_TICKET] = MBEDTLS_TLS_EXT_SESSION_TICKET,
  568. [MBEDTLS_SSL_EXT_ID_RECORD_SIZE_LIMIT] = MBEDTLS_TLS_EXT_RECORD_SIZE_LIMIT
  569. };
  570. const char *mbedtls_ssl_get_extension_name(unsigned int extension_type)
  571. {
  572. return extension_name_table[
  573. mbedtls_ssl_get_extension_id(extension_type)];
  574. }
  575. static const char *ssl_tls13_get_hs_msg_name(int hs_msg_type)
  576. {
  577. switch (hs_msg_type) {
  578. case MBEDTLS_SSL_HS_CLIENT_HELLO:
  579. return "ClientHello";
  580. case MBEDTLS_SSL_HS_SERVER_HELLO:
  581. return "ServerHello";
  582. case MBEDTLS_SSL_TLS1_3_HS_HELLO_RETRY_REQUEST:
  583. return "HelloRetryRequest";
  584. case MBEDTLS_SSL_HS_NEW_SESSION_TICKET:
  585. return "NewSessionTicket";
  586. case MBEDTLS_SSL_HS_ENCRYPTED_EXTENSIONS:
  587. return "EncryptedExtensions";
  588. case MBEDTLS_SSL_HS_CERTIFICATE:
  589. return "Certificate";
  590. case MBEDTLS_SSL_HS_CERTIFICATE_REQUEST:
  591. return "CertificateRequest";
  592. }
  593. return "Unknown";
  594. }
  595. void mbedtls_ssl_print_extension(const mbedtls_ssl_context *ssl,
  596. int level, const char *file, int line,
  597. int hs_msg_type, unsigned int extension_type,
  598. const char *extra_msg0, const char *extra_msg1)
  599. {
  600. const char *extra_msg;
  601. if (extra_msg0 && extra_msg1) {
  602. mbedtls_debug_print_msg(
  603. ssl, level, file, line,
  604. "%s: %s(%u) extension %s %s.",
  605. ssl_tls13_get_hs_msg_name(hs_msg_type),
  606. mbedtls_ssl_get_extension_name(extension_type),
  607. extension_type,
  608. extra_msg0, extra_msg1);
  609. return;
  610. }
  611. extra_msg = extra_msg0 ? extra_msg0 : extra_msg1;
  612. if (extra_msg) {
  613. mbedtls_debug_print_msg(
  614. ssl, level, file, line,
  615. "%s: %s(%u) extension %s.", ssl_tls13_get_hs_msg_name(hs_msg_type),
  616. mbedtls_ssl_get_extension_name(extension_type), extension_type,
  617. extra_msg);
  618. return;
  619. }
  620. mbedtls_debug_print_msg(
  621. ssl, level, file, line,
  622. "%s: %s(%u) extension.", ssl_tls13_get_hs_msg_name(hs_msg_type),
  623. mbedtls_ssl_get_extension_name(extension_type), extension_type);
  624. }
  625. void mbedtls_ssl_print_extensions(const mbedtls_ssl_context *ssl,
  626. int level, const char *file, int line,
  627. int hs_msg_type, uint32_t extensions_mask,
  628. const char *extra)
  629. {
  630. for (unsigned i = 0;
  631. i < sizeof(extension_name_table) / sizeof(extension_name_table[0]);
  632. i++) {
  633. mbedtls_ssl_print_extension(
  634. ssl, level, file, line, hs_msg_type, extension_type_table[i],
  635. extensions_mask & (1 << i) ? "exists" : "does not exist", extra);
  636. }
  637. }
  638. #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && defined(MBEDTLS_SSL_SESSION_TICKETS)
  639. static const char *ticket_flag_name_table[] =
  640. {
  641. [0] = "ALLOW_PSK_RESUMPTION",
  642. [2] = "ALLOW_PSK_EPHEMERAL_RESUMPTION",
  643. [3] = "ALLOW_EARLY_DATA",
  644. };
  645. void mbedtls_ssl_print_ticket_flags(const mbedtls_ssl_context *ssl,
  646. int level, const char *file, int line,
  647. unsigned int flags)
  648. {
  649. size_t i;
  650. mbedtls_debug_print_msg(ssl, level, file, line,
  651. "print ticket_flags (0x%02x)", flags);
  652. flags = flags & MBEDTLS_SSL_TLS1_3_TICKET_FLAGS_MASK;
  653. for (i = 0; i < ARRAY_LENGTH(ticket_flag_name_table); i++) {
  654. if ((flags & (1 << i))) {
  655. mbedtls_debug_print_msg(ssl, level, file, line, "- %s is set.",
  656. ticket_flag_name_table[i]);
  657. }
  658. }
  659. }
  660. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 && MBEDTLS_SSL_SESSION_TICKETS */
  661. #endif /* MBEDTLS_DEBUG_C */
  662. void mbedtls_ssl_optimize_checksum(mbedtls_ssl_context *ssl,
  663. const mbedtls_ssl_ciphersuite_t *ciphersuite_info)
  664. {
  665. ((void) ciphersuite_info);
  666. #if defined(MBEDTLS_MD_CAN_SHA384)
  667. if (ciphersuite_info->mac == MBEDTLS_MD_SHA384) {
  668. ssl->handshake->update_checksum = ssl_update_checksum_sha384;
  669. } else
  670. #endif
  671. #if defined(MBEDTLS_MD_CAN_SHA256)
  672. if (ciphersuite_info->mac != MBEDTLS_MD_SHA384) {
  673. ssl->handshake->update_checksum = ssl_update_checksum_sha256;
  674. } else
  675. #endif
  676. {
  677. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  678. return;
  679. }
  680. }
  681. int mbedtls_ssl_add_hs_hdr_to_checksum(mbedtls_ssl_context *ssl,
  682. unsigned hs_type,
  683. size_t total_hs_len)
  684. {
  685. unsigned char hs_hdr[4];
  686. /* Build HS header for checksum update. */
  687. hs_hdr[0] = MBEDTLS_BYTE_0(hs_type);
  688. hs_hdr[1] = MBEDTLS_BYTE_2(total_hs_len);
  689. hs_hdr[2] = MBEDTLS_BYTE_1(total_hs_len);
  690. hs_hdr[3] = MBEDTLS_BYTE_0(total_hs_len);
  691. return ssl->handshake->update_checksum(ssl, hs_hdr, sizeof(hs_hdr));
  692. }
  693. int mbedtls_ssl_add_hs_msg_to_checksum(mbedtls_ssl_context *ssl,
  694. unsigned hs_type,
  695. unsigned char const *msg,
  696. size_t msg_len)
  697. {
  698. int ret;
  699. ret = mbedtls_ssl_add_hs_hdr_to_checksum(ssl, hs_type, msg_len);
  700. if (ret != 0) {
  701. return ret;
  702. }
  703. return ssl->handshake->update_checksum(ssl, msg, msg_len);
  704. }
  705. int mbedtls_ssl_reset_checksum(mbedtls_ssl_context *ssl)
  706. {
  707. #if defined(MBEDTLS_MD_CAN_SHA256) || \
  708. defined(MBEDTLS_MD_CAN_SHA384)
  709. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  710. psa_status_t status;
  711. #else
  712. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  713. #endif
  714. #else /* SHA-256 or SHA-384 */
  715. ((void) ssl);
  716. #endif /* SHA-256 or SHA-384 */
  717. #if defined(MBEDTLS_MD_CAN_SHA256)
  718. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  719. status = psa_hash_abort(&ssl->handshake->fin_sha256_psa);
  720. if (status != PSA_SUCCESS) {
  721. return mbedtls_md_error_from_psa(status);
  722. }
  723. status = psa_hash_setup(&ssl->handshake->fin_sha256_psa, PSA_ALG_SHA_256);
  724. if (status != PSA_SUCCESS) {
  725. return mbedtls_md_error_from_psa(status);
  726. }
  727. #else
  728. mbedtls_md_free(&ssl->handshake->fin_sha256);
  729. mbedtls_md_init(&ssl->handshake->fin_sha256);
  730. ret = mbedtls_md_setup(&ssl->handshake->fin_sha256,
  731. mbedtls_md_info_from_type(MBEDTLS_MD_SHA256),
  732. 0);
  733. if (ret != 0) {
  734. return ret;
  735. }
  736. ret = mbedtls_md_starts(&ssl->handshake->fin_sha256);
  737. if (ret != 0) {
  738. return ret;
  739. }
  740. #endif
  741. #endif
  742. #if defined(MBEDTLS_MD_CAN_SHA384)
  743. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  744. status = psa_hash_abort(&ssl->handshake->fin_sha384_psa);
  745. if (status != PSA_SUCCESS) {
  746. return mbedtls_md_error_from_psa(status);
  747. }
  748. status = psa_hash_setup(&ssl->handshake->fin_sha384_psa, PSA_ALG_SHA_384);
  749. if (status != PSA_SUCCESS) {
  750. return mbedtls_md_error_from_psa(status);
  751. }
  752. #else
  753. mbedtls_md_free(&ssl->handshake->fin_sha384);
  754. mbedtls_md_init(&ssl->handshake->fin_sha384);
  755. ret = mbedtls_md_setup(&ssl->handshake->fin_sha384,
  756. mbedtls_md_info_from_type(MBEDTLS_MD_SHA384), 0);
  757. if (ret != 0) {
  758. return ret;
  759. }
  760. ret = mbedtls_md_starts(&ssl->handshake->fin_sha384);
  761. if (ret != 0) {
  762. return ret;
  763. }
  764. #endif
  765. #endif
  766. return 0;
  767. }
  768. static int ssl_update_checksum_start(mbedtls_ssl_context *ssl,
  769. const unsigned char *buf, size_t len)
  770. {
  771. #if defined(MBEDTLS_MD_CAN_SHA256) || \
  772. defined(MBEDTLS_MD_CAN_SHA384)
  773. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  774. psa_status_t status;
  775. #else
  776. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  777. #endif
  778. #else /* SHA-256 or SHA-384 */
  779. ((void) ssl);
  780. (void) buf;
  781. (void) len;
  782. #endif /* SHA-256 or SHA-384 */
  783. #if defined(MBEDTLS_MD_CAN_SHA256)
  784. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  785. status = psa_hash_update(&ssl->handshake->fin_sha256_psa, buf, len);
  786. if (status != PSA_SUCCESS) {
  787. return mbedtls_md_error_from_psa(status);
  788. }
  789. #else
  790. ret = mbedtls_md_update(&ssl->handshake->fin_sha256, buf, len);
  791. if (ret != 0) {
  792. return ret;
  793. }
  794. #endif
  795. #endif
  796. #if defined(MBEDTLS_MD_CAN_SHA384)
  797. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  798. status = psa_hash_update(&ssl->handshake->fin_sha384_psa, buf, len);
  799. if (status != PSA_SUCCESS) {
  800. return mbedtls_md_error_from_psa(status);
  801. }
  802. #else
  803. ret = mbedtls_md_update(&ssl->handshake->fin_sha384, buf, len);
  804. if (ret != 0) {
  805. return ret;
  806. }
  807. #endif
  808. #endif
  809. return 0;
  810. }
  811. #if defined(MBEDTLS_MD_CAN_SHA256)
  812. static int ssl_update_checksum_sha256(mbedtls_ssl_context *ssl,
  813. const unsigned char *buf, size_t len)
  814. {
  815. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  816. return mbedtls_md_error_from_psa(psa_hash_update(
  817. &ssl->handshake->fin_sha256_psa, buf, len));
  818. #else
  819. return mbedtls_md_update(&ssl->handshake->fin_sha256, buf, len);
  820. #endif
  821. }
  822. #endif
  823. #if defined(MBEDTLS_MD_CAN_SHA384)
  824. static int ssl_update_checksum_sha384(mbedtls_ssl_context *ssl,
  825. const unsigned char *buf, size_t len)
  826. {
  827. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  828. return mbedtls_md_error_from_psa(psa_hash_update(
  829. &ssl->handshake->fin_sha384_psa, buf, len));
  830. #else
  831. return mbedtls_md_update(&ssl->handshake->fin_sha384, buf, len);
  832. #endif
  833. }
  834. #endif
  835. static void ssl_handshake_params_init(mbedtls_ssl_handshake_params *handshake)
  836. {
  837. memset(handshake, 0, sizeof(mbedtls_ssl_handshake_params));
  838. #if defined(MBEDTLS_MD_CAN_SHA256)
  839. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  840. handshake->fin_sha256_psa = psa_hash_operation_init();
  841. #else
  842. mbedtls_md_init(&handshake->fin_sha256);
  843. #endif
  844. #endif
  845. #if defined(MBEDTLS_MD_CAN_SHA384)
  846. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  847. handshake->fin_sha384_psa = psa_hash_operation_init();
  848. #else
  849. mbedtls_md_init(&handshake->fin_sha384);
  850. #endif
  851. #endif
  852. handshake->update_checksum = ssl_update_checksum_start;
  853. #if defined(MBEDTLS_DHM_C)
  854. mbedtls_dhm_init(&handshake->dhm_ctx);
  855. #endif
  856. #if !defined(MBEDTLS_USE_PSA_CRYPTO) && \
  857. defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED)
  858. mbedtls_ecdh_init(&handshake->ecdh_ctx);
  859. #endif
  860. #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
  861. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  862. handshake->psa_pake_ctx = psa_pake_operation_init();
  863. handshake->psa_pake_password = MBEDTLS_SVC_KEY_ID_INIT;
  864. #else
  865. mbedtls_ecjpake_init(&handshake->ecjpake_ctx);
  866. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  867. #if defined(MBEDTLS_SSL_CLI_C)
  868. handshake->ecjpake_cache = NULL;
  869. handshake->ecjpake_cache_len = 0;
  870. #endif
  871. #endif
  872. #if defined(MBEDTLS_SSL_ECP_RESTARTABLE_ENABLED)
  873. mbedtls_x509_crt_restart_init(&handshake->ecrs_ctx);
  874. #endif
  875. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  876. handshake->sni_authmode = MBEDTLS_SSL_VERIFY_UNSET;
  877. #endif
  878. #if defined(MBEDTLS_X509_CRT_PARSE_C) && \
  879. !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  880. mbedtls_pk_init(&handshake->peer_pubkey);
  881. #endif
  882. }
  883. void mbedtls_ssl_transform_init(mbedtls_ssl_transform *transform)
  884. {
  885. memset(transform, 0, sizeof(mbedtls_ssl_transform));
  886. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  887. transform->psa_key_enc = MBEDTLS_SVC_KEY_ID_INIT;
  888. transform->psa_key_dec = MBEDTLS_SVC_KEY_ID_INIT;
  889. #else
  890. mbedtls_cipher_init(&transform->cipher_ctx_enc);
  891. mbedtls_cipher_init(&transform->cipher_ctx_dec);
  892. #endif
  893. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_MAC)
  894. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  895. transform->psa_mac_enc = MBEDTLS_SVC_KEY_ID_INIT;
  896. transform->psa_mac_dec = MBEDTLS_SVC_KEY_ID_INIT;
  897. #else
  898. mbedtls_md_init(&transform->md_ctx_enc);
  899. mbedtls_md_init(&transform->md_ctx_dec);
  900. #endif
  901. #endif
  902. }
  903. void mbedtls_ssl_session_init(mbedtls_ssl_session *session)
  904. {
  905. memset(session, 0, sizeof(mbedtls_ssl_session));
  906. }
  907. MBEDTLS_CHECK_RETURN_CRITICAL
  908. static int ssl_handshake_init(mbedtls_ssl_context *ssl)
  909. {
  910. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  911. /* Clear old handshake information if present */
  912. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  913. if (ssl->transform_negotiate) {
  914. mbedtls_ssl_transform_free(ssl->transform_negotiate);
  915. }
  916. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  917. if (ssl->session_negotiate) {
  918. mbedtls_ssl_session_free(ssl->session_negotiate);
  919. }
  920. if (ssl->handshake) {
  921. mbedtls_ssl_handshake_free(ssl);
  922. }
  923. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  924. /*
  925. * Either the pointers are now NULL or cleared properly and can be freed.
  926. * Now allocate missing structures.
  927. */
  928. if (ssl->transform_negotiate == NULL) {
  929. ssl->transform_negotiate = mbedtls_calloc(1, sizeof(mbedtls_ssl_transform));
  930. }
  931. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  932. if (ssl->session_negotiate == NULL) {
  933. ssl->session_negotiate = mbedtls_calloc(1, sizeof(mbedtls_ssl_session));
  934. }
  935. if (ssl->handshake == NULL) {
  936. ssl->handshake = mbedtls_calloc(1, sizeof(mbedtls_ssl_handshake_params));
  937. }
  938. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  939. /* If the buffers are too small - reallocate */
  940. handle_buffer_resizing(ssl, 0, MBEDTLS_SSL_IN_BUFFER_LEN,
  941. MBEDTLS_SSL_OUT_BUFFER_LEN);
  942. #endif
  943. /* All pointers should exist and can be directly freed without issue */
  944. if (ssl->handshake == NULL ||
  945. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  946. ssl->transform_negotiate == NULL ||
  947. #endif
  948. ssl->session_negotiate == NULL) {
  949. MBEDTLS_SSL_DEBUG_MSG(1, ("alloc() of ssl sub-contexts failed"));
  950. mbedtls_free(ssl->handshake);
  951. ssl->handshake = NULL;
  952. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  953. mbedtls_free(ssl->transform_negotiate);
  954. ssl->transform_negotiate = NULL;
  955. #endif
  956. mbedtls_free(ssl->session_negotiate);
  957. ssl->session_negotiate = NULL;
  958. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  959. }
  960. #if defined(MBEDTLS_SSL_EARLY_DATA)
  961. #if defined(MBEDTLS_SSL_CLI_C)
  962. ssl->early_data_state = MBEDTLS_SSL_EARLY_DATA_STATE_IDLE;
  963. #endif
  964. #if defined(MBEDTLS_SSL_SRV_C)
  965. ssl->discard_early_data_record = MBEDTLS_SSL_EARLY_DATA_NO_DISCARD;
  966. #endif
  967. ssl->total_early_data_size = 0;
  968. #endif /* MBEDTLS_SSL_EARLY_DATA */
  969. /* Initialize structures */
  970. mbedtls_ssl_session_init(ssl->session_negotiate);
  971. ssl_handshake_params_init(ssl->handshake);
  972. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  973. mbedtls_ssl_transform_init(ssl->transform_negotiate);
  974. #endif
  975. /* Setup handshake checksums */
  976. ret = mbedtls_ssl_reset_checksum(ssl);
  977. if (ret != 0) {
  978. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_reset_checksum", ret);
  979. return ret;
  980. }
  981. #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && \
  982. defined(MBEDTLS_SSL_SRV_C) && \
  983. defined(MBEDTLS_SSL_SESSION_TICKETS)
  984. ssl->handshake->new_session_tickets_count =
  985. ssl->conf->new_session_tickets_count;
  986. #endif
  987. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  988. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  989. ssl->handshake->alt_transform_out = ssl->transform_out;
  990. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  991. ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_PREPARING;
  992. } else {
  993. ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_WAITING;
  994. }
  995. mbedtls_ssl_set_timer(ssl, 0);
  996. }
  997. #endif
  998. /*
  999. * curve_list is translated to IANA TLS group identifiers here because
  1000. * mbedtls_ssl_conf_curves returns void and so can't return
  1001. * any error codes.
  1002. */
  1003. #if defined(MBEDTLS_ECP_C)
  1004. #if !defined(MBEDTLS_DEPRECATED_REMOVED)
  1005. /* Heap allocate and translate curve_list from internal to IANA group ids */
  1006. if (ssl->conf->curve_list != NULL) {
  1007. size_t length;
  1008. const mbedtls_ecp_group_id *curve_list = ssl->conf->curve_list;
  1009. for (length = 0; (curve_list[length] != MBEDTLS_ECP_DP_NONE); length++) {
  1010. }
  1011. /* Leave room for zero termination */
  1012. uint16_t *group_list = mbedtls_calloc(length + 1, sizeof(uint16_t));
  1013. if (group_list == NULL) {
  1014. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1015. }
  1016. for (size_t i = 0; i < length; i++) {
  1017. uint16_t tls_id = mbedtls_ssl_get_tls_id_from_ecp_group_id(
  1018. curve_list[i]);
  1019. if (tls_id == 0) {
  1020. mbedtls_free(group_list);
  1021. return MBEDTLS_ERR_SSL_BAD_CONFIG;
  1022. }
  1023. group_list[i] = tls_id;
  1024. }
  1025. group_list[length] = 0;
  1026. ssl->handshake->group_list = group_list;
  1027. ssl->handshake->group_list_heap_allocated = 1;
  1028. } else {
  1029. ssl->handshake->group_list = ssl->conf->group_list;
  1030. ssl->handshake->group_list_heap_allocated = 0;
  1031. }
  1032. #endif /* MBEDTLS_DEPRECATED_REMOVED */
  1033. #endif /* MBEDTLS_ECP_C */
  1034. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  1035. #if !defined(MBEDTLS_DEPRECATED_REMOVED)
  1036. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  1037. /* Heap allocate and translate sig_hashes from internal hash identifiers to
  1038. signature algorithms IANA identifiers. */
  1039. if (mbedtls_ssl_conf_is_tls12_only(ssl->conf) &&
  1040. ssl->conf->sig_hashes != NULL) {
  1041. const int *md;
  1042. const int *sig_hashes = ssl->conf->sig_hashes;
  1043. size_t sig_algs_len = 0;
  1044. uint16_t *p;
  1045. MBEDTLS_STATIC_ASSERT(MBEDTLS_SSL_MAX_SIG_ALG_LIST_LEN
  1046. <= (SIZE_MAX - (2 * sizeof(uint16_t))),
  1047. "MBEDTLS_SSL_MAX_SIG_ALG_LIST_LEN too big");
  1048. for (md = sig_hashes; *md != MBEDTLS_MD_NONE; md++) {
  1049. if (mbedtls_ssl_hash_from_md_alg(*md) == MBEDTLS_SSL_HASH_NONE) {
  1050. continue;
  1051. }
  1052. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
  1053. sig_algs_len += sizeof(uint16_t);
  1054. #endif
  1055. #if defined(MBEDTLS_RSA_C)
  1056. sig_algs_len += sizeof(uint16_t);
  1057. #endif
  1058. if (sig_algs_len > MBEDTLS_SSL_MAX_SIG_ALG_LIST_LEN) {
  1059. return MBEDTLS_ERR_SSL_BAD_CONFIG;
  1060. }
  1061. }
  1062. if (sig_algs_len < MBEDTLS_SSL_MIN_SIG_ALG_LIST_LEN) {
  1063. return MBEDTLS_ERR_SSL_BAD_CONFIG;
  1064. }
  1065. ssl->handshake->sig_algs = mbedtls_calloc(1, sig_algs_len +
  1066. sizeof(uint16_t));
  1067. if (ssl->handshake->sig_algs == NULL) {
  1068. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1069. }
  1070. p = (uint16_t *) ssl->handshake->sig_algs;
  1071. for (md = sig_hashes; *md != MBEDTLS_MD_NONE; md++) {
  1072. unsigned char hash = mbedtls_ssl_hash_from_md_alg(*md);
  1073. if (hash == MBEDTLS_SSL_HASH_NONE) {
  1074. continue;
  1075. }
  1076. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
  1077. *p = ((hash << 8) | MBEDTLS_SSL_SIG_ECDSA);
  1078. p++;
  1079. #endif
  1080. #if defined(MBEDTLS_RSA_C)
  1081. *p = ((hash << 8) | MBEDTLS_SSL_SIG_RSA);
  1082. p++;
  1083. #endif
  1084. }
  1085. *p = MBEDTLS_TLS_SIG_NONE;
  1086. ssl->handshake->sig_algs_heap_allocated = 1;
  1087. } else
  1088. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  1089. {
  1090. ssl->handshake->sig_algs_heap_allocated = 0;
  1091. }
  1092. #endif /* !MBEDTLS_DEPRECATED_REMOVED */
  1093. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  1094. return 0;
  1095. }
  1096. #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
  1097. /* Dummy cookie callbacks for defaults */
  1098. MBEDTLS_CHECK_RETURN_CRITICAL
  1099. static int ssl_cookie_write_dummy(void *ctx,
  1100. unsigned char **p, unsigned char *end,
  1101. const unsigned char *cli_id, size_t cli_id_len)
  1102. {
  1103. ((void) ctx);
  1104. ((void) p);
  1105. ((void) end);
  1106. ((void) cli_id);
  1107. ((void) cli_id_len);
  1108. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  1109. }
  1110. MBEDTLS_CHECK_RETURN_CRITICAL
  1111. static int ssl_cookie_check_dummy(void *ctx,
  1112. const unsigned char *cookie, size_t cookie_len,
  1113. const unsigned char *cli_id, size_t cli_id_len)
  1114. {
  1115. ((void) ctx);
  1116. ((void) cookie);
  1117. ((void) cookie_len);
  1118. ((void) cli_id);
  1119. ((void) cli_id_len);
  1120. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  1121. }
  1122. #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
  1123. /*
  1124. * Initialize an SSL context
  1125. */
  1126. void mbedtls_ssl_init(mbedtls_ssl_context *ssl)
  1127. {
  1128. memset(ssl, 0, sizeof(mbedtls_ssl_context));
  1129. }
  1130. MBEDTLS_CHECK_RETURN_CRITICAL
  1131. static int ssl_conf_version_check(const mbedtls_ssl_context *ssl)
  1132. {
  1133. const mbedtls_ssl_config *conf = ssl->conf;
  1134. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  1135. if (mbedtls_ssl_conf_is_tls13_only(conf)) {
  1136. if (conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  1137. MBEDTLS_SSL_DEBUG_MSG(1, ("DTLS 1.3 is not yet supported."));
  1138. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  1139. }
  1140. MBEDTLS_SSL_DEBUG_MSG(4, ("The SSL configuration is tls13 only."));
  1141. return 0;
  1142. }
  1143. #endif
  1144. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  1145. if (mbedtls_ssl_conf_is_tls12_only(conf)) {
  1146. MBEDTLS_SSL_DEBUG_MSG(4, ("The SSL configuration is tls12 only."));
  1147. return 0;
  1148. }
  1149. #endif
  1150. #if defined(MBEDTLS_SSL_PROTO_TLS1_2) && defined(MBEDTLS_SSL_PROTO_TLS1_3)
  1151. if (mbedtls_ssl_conf_is_hybrid_tls12_tls13(conf)) {
  1152. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  1153. MBEDTLS_SSL_DEBUG_MSG(1, ("DTLS not yet supported in Hybrid TLS 1.3 + TLS 1.2"));
  1154. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  1155. }
  1156. MBEDTLS_SSL_DEBUG_MSG(4, ("The SSL configuration is TLS 1.3 or TLS 1.2."));
  1157. return 0;
  1158. }
  1159. #endif
  1160. MBEDTLS_SSL_DEBUG_MSG(1, ("The SSL configuration is invalid."));
  1161. return MBEDTLS_ERR_SSL_BAD_CONFIG;
  1162. }
  1163. MBEDTLS_CHECK_RETURN_CRITICAL
  1164. static int ssl_conf_check(const mbedtls_ssl_context *ssl)
  1165. {
  1166. int ret;
  1167. ret = ssl_conf_version_check(ssl);
  1168. if (ret != 0) {
  1169. return ret;
  1170. }
  1171. if (ssl->conf->f_rng == NULL) {
  1172. MBEDTLS_SSL_DEBUG_MSG(1, ("no RNG provided"));
  1173. return MBEDTLS_ERR_SSL_NO_RNG;
  1174. }
  1175. /* Space for further checks */
  1176. return 0;
  1177. }
  1178. /*
  1179. * Setup an SSL context
  1180. */
  1181. int mbedtls_ssl_setup(mbedtls_ssl_context *ssl,
  1182. const mbedtls_ssl_config *conf)
  1183. {
  1184. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  1185. size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
  1186. size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
  1187. ssl->conf = conf;
  1188. if ((ret = ssl_conf_check(ssl)) != 0) {
  1189. return ret;
  1190. }
  1191. ssl->tls_version = ssl->conf->max_tls_version;
  1192. /*
  1193. * Prepare base structures
  1194. */
  1195. /* Set to NULL in case of an error condition */
  1196. ssl->out_buf = NULL;
  1197. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  1198. ssl->in_buf_len = in_buf_len;
  1199. #endif
  1200. ssl->in_buf = mbedtls_calloc(1, in_buf_len);
  1201. if (ssl->in_buf == NULL) {
  1202. MBEDTLS_SSL_DEBUG_MSG(1, ("alloc(%" MBEDTLS_PRINTF_SIZET " bytes) failed", in_buf_len));
  1203. ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1204. goto error;
  1205. }
  1206. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  1207. ssl->out_buf_len = out_buf_len;
  1208. #endif
  1209. ssl->out_buf = mbedtls_calloc(1, out_buf_len);
  1210. if (ssl->out_buf == NULL) {
  1211. MBEDTLS_SSL_DEBUG_MSG(1, ("alloc(%" MBEDTLS_PRINTF_SIZET " bytes) failed", out_buf_len));
  1212. ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1213. goto error;
  1214. }
  1215. mbedtls_ssl_reset_in_pointers(ssl);
  1216. mbedtls_ssl_reset_out_pointers(ssl);
  1217. #if defined(MBEDTLS_SSL_DTLS_SRTP)
  1218. memset(&ssl->dtls_srtp_info, 0, sizeof(ssl->dtls_srtp_info));
  1219. #endif
  1220. if ((ret = ssl_handshake_init(ssl)) != 0) {
  1221. goto error;
  1222. }
  1223. return 0;
  1224. error:
  1225. mbedtls_free(ssl->in_buf);
  1226. mbedtls_free(ssl->out_buf);
  1227. ssl->conf = NULL;
  1228. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  1229. ssl->in_buf_len = 0;
  1230. ssl->out_buf_len = 0;
  1231. #endif
  1232. ssl->in_buf = NULL;
  1233. ssl->out_buf = NULL;
  1234. ssl->in_hdr = NULL;
  1235. ssl->in_ctr = NULL;
  1236. ssl->in_len = NULL;
  1237. ssl->in_iv = NULL;
  1238. ssl->in_msg = NULL;
  1239. ssl->out_hdr = NULL;
  1240. ssl->out_ctr = NULL;
  1241. ssl->out_len = NULL;
  1242. ssl->out_iv = NULL;
  1243. ssl->out_msg = NULL;
  1244. return ret;
  1245. }
  1246. /*
  1247. * Reset an initialized and used SSL context for re-use while retaining
  1248. * all application-set variables, function pointers and data.
  1249. *
  1250. * If partial is non-zero, keep data in the input buffer and client ID.
  1251. * (Use when a DTLS client reconnects from the same port.)
  1252. */
  1253. void mbedtls_ssl_session_reset_msg_layer(mbedtls_ssl_context *ssl,
  1254. int partial)
  1255. {
  1256. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  1257. size_t in_buf_len = ssl->in_buf_len;
  1258. size_t out_buf_len = ssl->out_buf_len;
  1259. #else
  1260. size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
  1261. size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
  1262. #endif
  1263. #if !defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) || !defined(MBEDTLS_SSL_SRV_C)
  1264. partial = 0;
  1265. #endif
  1266. /* Cancel any possibly running timer */
  1267. mbedtls_ssl_set_timer(ssl, 0);
  1268. mbedtls_ssl_reset_in_pointers(ssl);
  1269. mbedtls_ssl_reset_out_pointers(ssl);
  1270. /* Reset incoming message parsing */
  1271. ssl->in_offt = NULL;
  1272. ssl->nb_zero = 0;
  1273. ssl->in_msgtype = 0;
  1274. ssl->in_msglen = 0;
  1275. ssl->in_hslen = 0;
  1276. ssl->keep_current_message = 0;
  1277. ssl->transform_in = NULL;
  1278. /* TLS: reset in_hsfraglen, which is part of message parsing.
  1279. * DTLS: on a client reconnect, don't reset badmac_seen. */
  1280. if (!partial) {
  1281. ssl->badmac_seen_or_in_hsfraglen = 0;
  1282. }
  1283. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  1284. ssl->next_record_offset = 0;
  1285. ssl->in_epoch = 0;
  1286. #endif
  1287. /* Keep current datagram if partial == 1 */
  1288. if (partial == 0) {
  1289. ssl->in_left = 0;
  1290. memset(ssl->in_buf, 0, in_buf_len);
  1291. }
  1292. ssl->send_alert = 0;
  1293. /* Reset outgoing message writing */
  1294. ssl->out_msgtype = 0;
  1295. ssl->out_msglen = 0;
  1296. ssl->out_left = 0;
  1297. memset(ssl->out_buf, 0, out_buf_len);
  1298. memset(ssl->cur_out_ctr, 0, sizeof(ssl->cur_out_ctr));
  1299. ssl->transform_out = NULL;
  1300. #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
  1301. mbedtls_ssl_dtls_replay_reset(ssl);
  1302. #endif
  1303. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  1304. if (ssl->transform) {
  1305. mbedtls_ssl_transform_free(ssl->transform);
  1306. mbedtls_free(ssl->transform);
  1307. ssl->transform = NULL;
  1308. }
  1309. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  1310. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  1311. mbedtls_ssl_transform_free(ssl->transform_application);
  1312. mbedtls_free(ssl->transform_application);
  1313. ssl->transform_application = NULL;
  1314. if (ssl->handshake != NULL) {
  1315. #if defined(MBEDTLS_SSL_EARLY_DATA)
  1316. mbedtls_ssl_transform_free(ssl->handshake->transform_earlydata);
  1317. mbedtls_free(ssl->handshake->transform_earlydata);
  1318. ssl->handshake->transform_earlydata = NULL;
  1319. #endif
  1320. mbedtls_ssl_transform_free(ssl->handshake->transform_handshake);
  1321. mbedtls_free(ssl->handshake->transform_handshake);
  1322. ssl->handshake->transform_handshake = NULL;
  1323. }
  1324. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  1325. }
  1326. int mbedtls_ssl_session_reset_int(mbedtls_ssl_context *ssl, int partial)
  1327. {
  1328. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  1329. ssl->state = MBEDTLS_SSL_HELLO_REQUEST;
  1330. ssl->tls_version = ssl->conf->max_tls_version;
  1331. mbedtls_ssl_session_reset_msg_layer(ssl, partial);
  1332. /* Reset renegotiation state */
  1333. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  1334. ssl->renego_status = MBEDTLS_SSL_INITIAL_HANDSHAKE;
  1335. ssl->renego_records_seen = 0;
  1336. ssl->verify_data_len = 0;
  1337. memset(ssl->own_verify_data, 0, MBEDTLS_SSL_VERIFY_DATA_MAX_LEN);
  1338. memset(ssl->peer_verify_data, 0, MBEDTLS_SSL_VERIFY_DATA_MAX_LEN);
  1339. #endif
  1340. ssl->secure_renegotiation = MBEDTLS_SSL_LEGACY_RENEGOTIATION;
  1341. ssl->session_in = NULL;
  1342. ssl->session_out = NULL;
  1343. if (ssl->session) {
  1344. mbedtls_ssl_session_free(ssl->session);
  1345. mbedtls_free(ssl->session);
  1346. ssl->session = NULL;
  1347. }
  1348. #if defined(MBEDTLS_SSL_ALPN)
  1349. ssl->alpn_chosen = NULL;
  1350. #endif
  1351. #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
  1352. int free_cli_id = 1;
  1353. #if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE)
  1354. free_cli_id = (partial == 0);
  1355. #endif
  1356. if (free_cli_id) {
  1357. mbedtls_free(ssl->cli_id);
  1358. ssl->cli_id = NULL;
  1359. ssl->cli_id_len = 0;
  1360. }
  1361. #endif
  1362. if ((ret = ssl_handshake_init(ssl)) != 0) {
  1363. return ret;
  1364. }
  1365. return 0;
  1366. }
  1367. /*
  1368. * Reset an initialized and used SSL context for re-use while retaining
  1369. * all application-set variables, function pointers and data.
  1370. */
  1371. int mbedtls_ssl_session_reset(mbedtls_ssl_context *ssl)
  1372. {
  1373. return mbedtls_ssl_session_reset_int(ssl, 0);
  1374. }
  1375. /*
  1376. * SSL set accessors
  1377. */
  1378. void mbedtls_ssl_conf_endpoint(mbedtls_ssl_config *conf, int endpoint)
  1379. {
  1380. conf->endpoint = endpoint;
  1381. }
  1382. void mbedtls_ssl_conf_transport(mbedtls_ssl_config *conf, int transport)
  1383. {
  1384. conf->transport = transport;
  1385. }
  1386. #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
  1387. void mbedtls_ssl_conf_dtls_anti_replay(mbedtls_ssl_config *conf, char mode)
  1388. {
  1389. conf->anti_replay = mode;
  1390. }
  1391. #endif
  1392. void mbedtls_ssl_conf_dtls_badmac_limit(mbedtls_ssl_config *conf, unsigned limit)
  1393. {
  1394. conf->badmac_limit = limit;
  1395. }
  1396. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  1397. void mbedtls_ssl_set_datagram_packing(mbedtls_ssl_context *ssl,
  1398. unsigned allow_packing)
  1399. {
  1400. ssl->disable_datagram_packing = !allow_packing;
  1401. }
  1402. void mbedtls_ssl_conf_handshake_timeout(mbedtls_ssl_config *conf,
  1403. uint32_t min, uint32_t max)
  1404. {
  1405. conf->hs_timeout_min = min;
  1406. conf->hs_timeout_max = max;
  1407. }
  1408. #endif
  1409. void mbedtls_ssl_conf_authmode(mbedtls_ssl_config *conf, int authmode)
  1410. {
  1411. conf->authmode = authmode;
  1412. }
  1413. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  1414. void mbedtls_ssl_conf_verify(mbedtls_ssl_config *conf,
  1415. int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
  1416. void *p_vrfy)
  1417. {
  1418. conf->f_vrfy = f_vrfy;
  1419. conf->p_vrfy = p_vrfy;
  1420. }
  1421. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  1422. void mbedtls_ssl_conf_rng(mbedtls_ssl_config *conf,
  1423. int (*f_rng)(void *, unsigned char *, size_t),
  1424. void *p_rng)
  1425. {
  1426. conf->f_rng = f_rng;
  1427. conf->p_rng = p_rng;
  1428. }
  1429. void mbedtls_ssl_conf_dbg(mbedtls_ssl_config *conf,
  1430. void (*f_dbg)(void *, int, const char *, int, const char *),
  1431. void *p_dbg)
  1432. {
  1433. conf->f_dbg = f_dbg;
  1434. conf->p_dbg = p_dbg;
  1435. }
  1436. void mbedtls_ssl_set_bio(mbedtls_ssl_context *ssl,
  1437. void *p_bio,
  1438. mbedtls_ssl_send_t *f_send,
  1439. mbedtls_ssl_recv_t *f_recv,
  1440. mbedtls_ssl_recv_timeout_t *f_recv_timeout)
  1441. {
  1442. ssl->p_bio = p_bio;
  1443. ssl->f_send = f_send;
  1444. ssl->f_recv = f_recv;
  1445. ssl->f_recv_timeout = f_recv_timeout;
  1446. }
  1447. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  1448. void mbedtls_ssl_set_mtu(mbedtls_ssl_context *ssl, uint16_t mtu)
  1449. {
  1450. ssl->mtu = mtu;
  1451. }
  1452. #endif
  1453. void mbedtls_ssl_conf_read_timeout(mbedtls_ssl_config *conf, uint32_t timeout)
  1454. {
  1455. conf->read_timeout = timeout;
  1456. }
  1457. void mbedtls_ssl_set_timer_cb(mbedtls_ssl_context *ssl,
  1458. void *p_timer,
  1459. mbedtls_ssl_set_timer_t *f_set_timer,
  1460. mbedtls_ssl_get_timer_t *f_get_timer)
  1461. {
  1462. ssl->p_timer = p_timer;
  1463. ssl->f_set_timer = f_set_timer;
  1464. ssl->f_get_timer = f_get_timer;
  1465. /* Make sure we start with no timer running */
  1466. mbedtls_ssl_set_timer(ssl, 0);
  1467. }
  1468. #if defined(MBEDTLS_SSL_SRV_C)
  1469. void mbedtls_ssl_conf_session_cache(mbedtls_ssl_config *conf,
  1470. void *p_cache,
  1471. mbedtls_ssl_cache_get_t *f_get_cache,
  1472. mbedtls_ssl_cache_set_t *f_set_cache)
  1473. {
  1474. conf->p_cache = p_cache;
  1475. conf->f_get_cache = f_get_cache;
  1476. conf->f_set_cache = f_set_cache;
  1477. }
  1478. #endif /* MBEDTLS_SSL_SRV_C */
  1479. #if defined(MBEDTLS_SSL_CLI_C)
  1480. int mbedtls_ssl_set_session(mbedtls_ssl_context *ssl, const mbedtls_ssl_session *session)
  1481. {
  1482. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  1483. if (ssl == NULL ||
  1484. session == NULL ||
  1485. ssl->session_negotiate == NULL ||
  1486. ssl->conf->endpoint != MBEDTLS_SSL_IS_CLIENT) {
  1487. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1488. }
  1489. if (ssl->handshake->resume == 1) {
  1490. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  1491. }
  1492. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  1493. if (session->tls_version == MBEDTLS_SSL_VERSION_TLS1_3) {
  1494. #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  1495. const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
  1496. mbedtls_ssl_ciphersuite_from_id(session->ciphersuite);
  1497. if (mbedtls_ssl_validate_ciphersuite(
  1498. ssl, ciphersuite_info, MBEDTLS_SSL_VERSION_TLS1_3,
  1499. MBEDTLS_SSL_VERSION_TLS1_3) != 0) {
  1500. MBEDTLS_SSL_DEBUG_MSG(4, ("%d is not a valid TLS 1.3 ciphersuite.",
  1501. session->ciphersuite));
  1502. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1503. }
  1504. #else
  1505. /*
  1506. * If session tickets are not enabled, it is not possible to resume a
  1507. * TLS 1.3 session, thus do not make any change to the SSL context in
  1508. * the first place.
  1509. */
  1510. return 0;
  1511. #endif
  1512. }
  1513. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  1514. if ((ret = mbedtls_ssl_session_copy(ssl->session_negotiate,
  1515. session)) != 0) {
  1516. return ret;
  1517. }
  1518. ssl->handshake->resume = 1;
  1519. return 0;
  1520. }
  1521. #endif /* MBEDTLS_SSL_CLI_C */
  1522. void mbedtls_ssl_conf_ciphersuites(mbedtls_ssl_config *conf,
  1523. const int *ciphersuites)
  1524. {
  1525. conf->ciphersuite_list = ciphersuites;
  1526. }
  1527. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  1528. void mbedtls_ssl_conf_tls13_key_exchange_modes(mbedtls_ssl_config *conf,
  1529. const int kex_modes)
  1530. {
  1531. conf->tls13_kex_modes = kex_modes & MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_ALL;
  1532. }
  1533. #if defined(MBEDTLS_SSL_EARLY_DATA)
  1534. void mbedtls_ssl_conf_early_data(mbedtls_ssl_config *conf,
  1535. int early_data_enabled)
  1536. {
  1537. conf->early_data_enabled = early_data_enabled;
  1538. }
  1539. #if defined(MBEDTLS_SSL_SRV_C)
  1540. void mbedtls_ssl_conf_max_early_data_size(
  1541. mbedtls_ssl_config *conf, uint32_t max_early_data_size)
  1542. {
  1543. conf->max_early_data_size = max_early_data_size;
  1544. }
  1545. #endif /* MBEDTLS_SSL_SRV_C */
  1546. #endif /* MBEDTLS_SSL_EARLY_DATA */
  1547. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  1548. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  1549. void mbedtls_ssl_conf_cert_profile(mbedtls_ssl_config *conf,
  1550. const mbedtls_x509_crt_profile *profile)
  1551. {
  1552. conf->cert_profile = profile;
  1553. }
  1554. static void ssl_key_cert_free(mbedtls_ssl_key_cert *key_cert)
  1555. {
  1556. mbedtls_ssl_key_cert *cur = key_cert, *next;
  1557. while (cur != NULL) {
  1558. next = cur->next;
  1559. mbedtls_free(cur);
  1560. cur = next;
  1561. }
  1562. }
  1563. /* Append a new keycert entry to a (possibly empty) list */
  1564. MBEDTLS_CHECK_RETURN_CRITICAL
  1565. static int ssl_append_key_cert(mbedtls_ssl_key_cert **head,
  1566. mbedtls_x509_crt *cert,
  1567. mbedtls_pk_context *key)
  1568. {
  1569. mbedtls_ssl_key_cert *new_cert;
  1570. if (cert == NULL) {
  1571. /* Free list if cert is null */
  1572. ssl_key_cert_free(*head);
  1573. *head = NULL;
  1574. return 0;
  1575. }
  1576. new_cert = mbedtls_calloc(1, sizeof(mbedtls_ssl_key_cert));
  1577. if (new_cert == NULL) {
  1578. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1579. }
  1580. new_cert->cert = cert;
  1581. new_cert->key = key;
  1582. new_cert->next = NULL;
  1583. /* Update head if the list was null, else add to the end */
  1584. if (*head == NULL) {
  1585. *head = new_cert;
  1586. } else {
  1587. mbedtls_ssl_key_cert *cur = *head;
  1588. while (cur->next != NULL) {
  1589. cur = cur->next;
  1590. }
  1591. cur->next = new_cert;
  1592. }
  1593. return 0;
  1594. }
  1595. int mbedtls_ssl_conf_own_cert(mbedtls_ssl_config *conf,
  1596. mbedtls_x509_crt *own_cert,
  1597. mbedtls_pk_context *pk_key)
  1598. {
  1599. return ssl_append_key_cert(&conf->key_cert, own_cert, pk_key);
  1600. }
  1601. void mbedtls_ssl_conf_ca_chain(mbedtls_ssl_config *conf,
  1602. mbedtls_x509_crt *ca_chain,
  1603. mbedtls_x509_crl *ca_crl)
  1604. {
  1605. conf->ca_chain = ca_chain;
  1606. conf->ca_crl = ca_crl;
  1607. #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
  1608. /* mbedtls_ssl_conf_ca_chain() and mbedtls_ssl_conf_ca_cb()
  1609. * cannot be used together. */
  1610. conf->f_ca_cb = NULL;
  1611. conf->p_ca_cb = NULL;
  1612. #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
  1613. }
  1614. #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
  1615. void mbedtls_ssl_conf_ca_cb(mbedtls_ssl_config *conf,
  1616. mbedtls_x509_crt_ca_cb_t f_ca_cb,
  1617. void *p_ca_cb)
  1618. {
  1619. conf->f_ca_cb = f_ca_cb;
  1620. conf->p_ca_cb = p_ca_cb;
  1621. /* mbedtls_ssl_conf_ca_chain() and mbedtls_ssl_conf_ca_cb()
  1622. * cannot be used together. */
  1623. conf->ca_chain = NULL;
  1624. conf->ca_crl = NULL;
  1625. }
  1626. #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
  1627. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  1628. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  1629. const unsigned char *mbedtls_ssl_get_hs_sni(mbedtls_ssl_context *ssl,
  1630. size_t *name_len)
  1631. {
  1632. *name_len = ssl->handshake->sni_name_len;
  1633. return ssl->handshake->sni_name;
  1634. }
  1635. int mbedtls_ssl_set_hs_own_cert(mbedtls_ssl_context *ssl,
  1636. mbedtls_x509_crt *own_cert,
  1637. mbedtls_pk_context *pk_key)
  1638. {
  1639. return ssl_append_key_cert(&ssl->handshake->sni_key_cert,
  1640. own_cert, pk_key);
  1641. }
  1642. void mbedtls_ssl_set_hs_ca_chain(mbedtls_ssl_context *ssl,
  1643. mbedtls_x509_crt *ca_chain,
  1644. mbedtls_x509_crl *ca_crl)
  1645. {
  1646. ssl->handshake->sni_ca_chain = ca_chain;
  1647. ssl->handshake->sni_ca_crl = ca_crl;
  1648. }
  1649. #if defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED)
  1650. void mbedtls_ssl_set_hs_dn_hints(mbedtls_ssl_context *ssl,
  1651. const mbedtls_x509_crt *crt)
  1652. {
  1653. ssl->handshake->dn_hints = crt;
  1654. }
  1655. #endif /* MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
  1656. void mbedtls_ssl_set_hs_authmode(mbedtls_ssl_context *ssl,
  1657. int authmode)
  1658. {
  1659. ssl->handshake->sni_authmode = authmode;
  1660. }
  1661. #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
  1662. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  1663. void mbedtls_ssl_set_verify(mbedtls_ssl_context *ssl,
  1664. int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
  1665. void *p_vrfy)
  1666. {
  1667. ssl->f_vrfy = f_vrfy;
  1668. ssl->p_vrfy = p_vrfy;
  1669. }
  1670. #endif
  1671. #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
  1672. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  1673. static const uint8_t jpake_server_id[] = { 's', 'e', 'r', 'v', 'e', 'r' };
  1674. static const uint8_t jpake_client_id[] = { 'c', 'l', 'i', 'e', 'n', 't' };
  1675. static psa_status_t mbedtls_ssl_set_hs_ecjpake_password_common(
  1676. mbedtls_ssl_context *ssl,
  1677. mbedtls_svc_key_id_t pwd)
  1678. {
  1679. psa_status_t status;
  1680. psa_pake_cipher_suite_t cipher_suite = psa_pake_cipher_suite_init();
  1681. const uint8_t *user = NULL;
  1682. size_t user_len = 0;
  1683. const uint8_t *peer = NULL;
  1684. size_t peer_len = 0;
  1685. psa_pake_cs_set_algorithm(&cipher_suite, PSA_ALG_JPAKE);
  1686. psa_pake_cs_set_primitive(&cipher_suite,
  1687. PSA_PAKE_PRIMITIVE(PSA_PAKE_PRIMITIVE_TYPE_ECC,
  1688. PSA_ECC_FAMILY_SECP_R1,
  1689. 256));
  1690. psa_pake_cs_set_hash(&cipher_suite, PSA_ALG_SHA_256);
  1691. status = psa_pake_setup(&ssl->handshake->psa_pake_ctx, &cipher_suite);
  1692. if (status != PSA_SUCCESS) {
  1693. return status;
  1694. }
  1695. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  1696. user = jpake_server_id;
  1697. user_len = sizeof(jpake_server_id);
  1698. peer = jpake_client_id;
  1699. peer_len = sizeof(jpake_client_id);
  1700. } else {
  1701. user = jpake_client_id;
  1702. user_len = sizeof(jpake_client_id);
  1703. peer = jpake_server_id;
  1704. peer_len = sizeof(jpake_server_id);
  1705. }
  1706. status = psa_pake_set_user(&ssl->handshake->psa_pake_ctx, user, user_len);
  1707. if (status != PSA_SUCCESS) {
  1708. return status;
  1709. }
  1710. status = psa_pake_set_peer(&ssl->handshake->psa_pake_ctx, peer, peer_len);
  1711. if (status != PSA_SUCCESS) {
  1712. return status;
  1713. }
  1714. status = psa_pake_set_password_key(&ssl->handshake->psa_pake_ctx, pwd);
  1715. if (status != PSA_SUCCESS) {
  1716. return status;
  1717. }
  1718. ssl->handshake->psa_pake_ctx_is_ok = 1;
  1719. return PSA_SUCCESS;
  1720. }
  1721. int mbedtls_ssl_set_hs_ecjpake_password(mbedtls_ssl_context *ssl,
  1722. const unsigned char *pw,
  1723. size_t pw_len)
  1724. {
  1725. psa_key_attributes_t attributes = PSA_KEY_ATTRIBUTES_INIT;
  1726. psa_status_t status;
  1727. if (ssl->handshake == NULL || ssl->conf == NULL) {
  1728. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1729. }
  1730. /* Empty password is not valid */
  1731. if ((pw == NULL) || (pw_len == 0)) {
  1732. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1733. }
  1734. psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_DERIVE);
  1735. psa_set_key_algorithm(&attributes, PSA_ALG_JPAKE);
  1736. psa_set_key_type(&attributes, PSA_KEY_TYPE_PASSWORD);
  1737. status = psa_import_key(&attributes, pw, pw_len,
  1738. &ssl->handshake->psa_pake_password);
  1739. if (status != PSA_SUCCESS) {
  1740. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  1741. }
  1742. status = mbedtls_ssl_set_hs_ecjpake_password_common(ssl,
  1743. ssl->handshake->psa_pake_password);
  1744. if (status != PSA_SUCCESS) {
  1745. psa_destroy_key(ssl->handshake->psa_pake_password);
  1746. psa_pake_abort(&ssl->handshake->psa_pake_ctx);
  1747. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  1748. }
  1749. return 0;
  1750. }
  1751. int mbedtls_ssl_set_hs_ecjpake_password_opaque(mbedtls_ssl_context *ssl,
  1752. mbedtls_svc_key_id_t pwd)
  1753. {
  1754. psa_status_t status;
  1755. if (ssl->handshake == NULL || ssl->conf == NULL) {
  1756. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1757. }
  1758. if (mbedtls_svc_key_id_is_null(pwd)) {
  1759. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1760. }
  1761. status = mbedtls_ssl_set_hs_ecjpake_password_common(ssl, pwd);
  1762. if (status != PSA_SUCCESS) {
  1763. psa_pake_abort(&ssl->handshake->psa_pake_ctx);
  1764. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  1765. }
  1766. return 0;
  1767. }
  1768. #else /* MBEDTLS_USE_PSA_CRYPTO */
  1769. int mbedtls_ssl_set_hs_ecjpake_password(mbedtls_ssl_context *ssl,
  1770. const unsigned char *pw,
  1771. size_t pw_len)
  1772. {
  1773. mbedtls_ecjpake_role role;
  1774. if (ssl->handshake == NULL || ssl->conf == NULL) {
  1775. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1776. }
  1777. /* Empty password is not valid */
  1778. if ((pw == NULL) || (pw_len == 0)) {
  1779. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1780. }
  1781. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  1782. role = MBEDTLS_ECJPAKE_SERVER;
  1783. } else {
  1784. role = MBEDTLS_ECJPAKE_CLIENT;
  1785. }
  1786. return mbedtls_ecjpake_setup(&ssl->handshake->ecjpake_ctx,
  1787. role,
  1788. MBEDTLS_MD_SHA256,
  1789. MBEDTLS_ECP_DP_SECP256R1,
  1790. pw, pw_len);
  1791. }
  1792. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  1793. #endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
  1794. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_PSK_ENABLED)
  1795. int mbedtls_ssl_conf_has_static_psk(mbedtls_ssl_config const *conf)
  1796. {
  1797. if (conf->psk_identity == NULL ||
  1798. conf->psk_identity_len == 0) {
  1799. return 0;
  1800. }
  1801. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  1802. if (!mbedtls_svc_key_id_is_null(conf->psk_opaque)) {
  1803. return 1;
  1804. }
  1805. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  1806. if (conf->psk != NULL && conf->psk_len != 0) {
  1807. return 1;
  1808. }
  1809. return 0;
  1810. }
  1811. static void ssl_conf_remove_psk(mbedtls_ssl_config *conf)
  1812. {
  1813. /* Remove reference to existing PSK, if any. */
  1814. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  1815. if (!mbedtls_svc_key_id_is_null(conf->psk_opaque)) {
  1816. /* The maintenance of the PSK key slot is the
  1817. * user's responsibility. */
  1818. conf->psk_opaque = MBEDTLS_SVC_KEY_ID_INIT;
  1819. }
  1820. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  1821. if (conf->psk != NULL) {
  1822. mbedtls_zeroize_and_free(conf->psk, conf->psk_len);
  1823. conf->psk = NULL;
  1824. conf->psk_len = 0;
  1825. }
  1826. /* Remove reference to PSK identity, if any. */
  1827. if (conf->psk_identity != NULL) {
  1828. mbedtls_free(conf->psk_identity);
  1829. conf->psk_identity = NULL;
  1830. conf->psk_identity_len = 0;
  1831. }
  1832. }
  1833. /* This function assumes that PSK identity in the SSL config is unset.
  1834. * It checks that the provided identity is well-formed and attempts
  1835. * to make a copy of it in the SSL config.
  1836. * On failure, the PSK identity in the config remains unset. */
  1837. MBEDTLS_CHECK_RETURN_CRITICAL
  1838. static int ssl_conf_set_psk_identity(mbedtls_ssl_config *conf,
  1839. unsigned char const *psk_identity,
  1840. size_t psk_identity_len)
  1841. {
  1842. /* Identity len will be encoded on two bytes */
  1843. if (psk_identity == NULL ||
  1844. psk_identity_len == 0 ||
  1845. (psk_identity_len >> 16) != 0 ||
  1846. psk_identity_len > MBEDTLS_SSL_OUT_CONTENT_LEN) {
  1847. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1848. }
  1849. conf->psk_identity = mbedtls_calloc(1, psk_identity_len);
  1850. if (conf->psk_identity == NULL) {
  1851. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1852. }
  1853. conf->psk_identity_len = psk_identity_len;
  1854. memcpy(conf->psk_identity, psk_identity, conf->psk_identity_len);
  1855. return 0;
  1856. }
  1857. int mbedtls_ssl_conf_psk(mbedtls_ssl_config *conf,
  1858. const unsigned char *psk, size_t psk_len,
  1859. const unsigned char *psk_identity, size_t psk_identity_len)
  1860. {
  1861. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  1862. /* We currently only support one PSK, raw or opaque. */
  1863. if (mbedtls_ssl_conf_has_static_psk(conf)) {
  1864. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  1865. }
  1866. /* Check and set raw PSK */
  1867. if (psk == NULL) {
  1868. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1869. }
  1870. if (psk_len == 0) {
  1871. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1872. }
  1873. if (psk_len > MBEDTLS_PSK_MAX_LEN) {
  1874. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1875. }
  1876. if ((conf->psk = mbedtls_calloc(1, psk_len)) == NULL) {
  1877. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1878. }
  1879. conf->psk_len = psk_len;
  1880. memcpy(conf->psk, psk, conf->psk_len);
  1881. /* Check and set PSK Identity */
  1882. ret = ssl_conf_set_psk_identity(conf, psk_identity, psk_identity_len);
  1883. if (ret != 0) {
  1884. ssl_conf_remove_psk(conf);
  1885. }
  1886. return ret;
  1887. }
  1888. static void ssl_remove_psk(mbedtls_ssl_context *ssl)
  1889. {
  1890. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  1891. if (!mbedtls_svc_key_id_is_null(ssl->handshake->psk_opaque)) {
  1892. /* The maintenance of the external PSK key slot is the
  1893. * user's responsibility. */
  1894. if (ssl->handshake->psk_opaque_is_internal) {
  1895. psa_destroy_key(ssl->handshake->psk_opaque);
  1896. ssl->handshake->psk_opaque_is_internal = 0;
  1897. }
  1898. ssl->handshake->psk_opaque = MBEDTLS_SVC_KEY_ID_INIT;
  1899. }
  1900. #else
  1901. if (ssl->handshake->psk != NULL) {
  1902. mbedtls_zeroize_and_free(ssl->handshake->psk,
  1903. ssl->handshake->psk_len);
  1904. ssl->handshake->psk_len = 0;
  1905. ssl->handshake->psk = NULL;
  1906. }
  1907. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  1908. }
  1909. int mbedtls_ssl_set_hs_psk(mbedtls_ssl_context *ssl,
  1910. const unsigned char *psk, size_t psk_len)
  1911. {
  1912. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  1913. psa_key_attributes_t key_attributes = psa_key_attributes_init();
  1914. psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
  1915. psa_algorithm_t alg = PSA_ALG_NONE;
  1916. mbedtls_svc_key_id_t key = MBEDTLS_SVC_KEY_ID_INIT;
  1917. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  1918. if (psk == NULL || ssl->handshake == NULL) {
  1919. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1920. }
  1921. if (psk_len > MBEDTLS_PSK_MAX_LEN) {
  1922. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1923. }
  1924. ssl_remove_psk(ssl);
  1925. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  1926. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  1927. if (ssl->tls_version == MBEDTLS_SSL_VERSION_TLS1_2) {
  1928. if (ssl->handshake->ciphersuite_info->mac == MBEDTLS_MD_SHA384) {
  1929. alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_384);
  1930. } else {
  1931. alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_256);
  1932. }
  1933. psa_set_key_usage_flags(&key_attributes, PSA_KEY_USAGE_DERIVE);
  1934. }
  1935. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  1936. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  1937. if (ssl->tls_version == MBEDTLS_SSL_VERSION_TLS1_3) {
  1938. alg = PSA_ALG_HKDF_EXTRACT(PSA_ALG_ANY_HASH);
  1939. psa_set_key_usage_flags(&key_attributes,
  1940. PSA_KEY_USAGE_DERIVE | PSA_KEY_USAGE_EXPORT);
  1941. }
  1942. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  1943. psa_set_key_algorithm(&key_attributes, alg);
  1944. psa_set_key_type(&key_attributes, PSA_KEY_TYPE_DERIVE);
  1945. status = psa_import_key(&key_attributes, psk, psk_len, &key);
  1946. if (status != PSA_SUCCESS) {
  1947. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  1948. }
  1949. /* Allow calling psa_destroy_key() on psk remove */
  1950. ssl->handshake->psk_opaque_is_internal = 1;
  1951. return mbedtls_ssl_set_hs_psk_opaque(ssl, key);
  1952. #else
  1953. if ((ssl->handshake->psk = mbedtls_calloc(1, psk_len)) == NULL) {
  1954. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  1955. }
  1956. ssl->handshake->psk_len = psk_len;
  1957. memcpy(ssl->handshake->psk, psk, ssl->handshake->psk_len);
  1958. return 0;
  1959. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  1960. }
  1961. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  1962. int mbedtls_ssl_conf_psk_opaque(mbedtls_ssl_config *conf,
  1963. mbedtls_svc_key_id_t psk,
  1964. const unsigned char *psk_identity,
  1965. size_t psk_identity_len)
  1966. {
  1967. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  1968. /* We currently only support one PSK, raw or opaque. */
  1969. if (mbedtls_ssl_conf_has_static_psk(conf)) {
  1970. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  1971. }
  1972. /* Check and set opaque PSK */
  1973. if (mbedtls_svc_key_id_is_null(psk)) {
  1974. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1975. }
  1976. conf->psk_opaque = psk;
  1977. /* Check and set PSK Identity */
  1978. ret = ssl_conf_set_psk_identity(conf, psk_identity,
  1979. psk_identity_len);
  1980. if (ret != 0) {
  1981. ssl_conf_remove_psk(conf);
  1982. }
  1983. return ret;
  1984. }
  1985. int mbedtls_ssl_set_hs_psk_opaque(mbedtls_ssl_context *ssl,
  1986. mbedtls_svc_key_id_t psk)
  1987. {
  1988. if ((mbedtls_svc_key_id_is_null(psk)) ||
  1989. (ssl->handshake == NULL)) {
  1990. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  1991. }
  1992. ssl_remove_psk(ssl);
  1993. ssl->handshake->psk_opaque = psk;
  1994. return 0;
  1995. }
  1996. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  1997. #if defined(MBEDTLS_SSL_SRV_C)
  1998. void mbedtls_ssl_conf_psk_cb(mbedtls_ssl_config *conf,
  1999. int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
  2000. size_t),
  2001. void *p_psk)
  2002. {
  2003. conf->f_psk = f_psk;
  2004. conf->p_psk = p_psk;
  2005. }
  2006. #endif /* MBEDTLS_SSL_SRV_C */
  2007. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_PSK_ENABLED */
  2008. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  2009. static mbedtls_ssl_mode_t mbedtls_ssl_get_base_mode(
  2010. psa_algorithm_t alg)
  2011. {
  2012. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_MAC)
  2013. if (alg == PSA_ALG_CBC_NO_PADDING) {
  2014. return MBEDTLS_SSL_MODE_CBC;
  2015. }
  2016. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_MAC */
  2017. if (PSA_ALG_IS_AEAD(alg)) {
  2018. return MBEDTLS_SSL_MODE_AEAD;
  2019. }
  2020. return MBEDTLS_SSL_MODE_STREAM;
  2021. }
  2022. #else /* MBEDTLS_USE_PSA_CRYPTO */
  2023. static mbedtls_ssl_mode_t mbedtls_ssl_get_base_mode(
  2024. mbedtls_cipher_mode_t mode)
  2025. {
  2026. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_MAC)
  2027. if (mode == MBEDTLS_MODE_CBC) {
  2028. return MBEDTLS_SSL_MODE_CBC;
  2029. }
  2030. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_MAC */
  2031. #if defined(MBEDTLS_GCM_C) || \
  2032. defined(MBEDTLS_CCM_C) || \
  2033. defined(MBEDTLS_CHACHAPOLY_C)
  2034. if (mode == MBEDTLS_MODE_GCM ||
  2035. mode == MBEDTLS_MODE_CCM ||
  2036. mode == MBEDTLS_MODE_CHACHAPOLY) {
  2037. return MBEDTLS_SSL_MODE_AEAD;
  2038. }
  2039. #endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C || MBEDTLS_CHACHAPOLY_C */
  2040. return MBEDTLS_SSL_MODE_STREAM;
  2041. }
  2042. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  2043. static mbedtls_ssl_mode_t mbedtls_ssl_get_actual_mode(
  2044. mbedtls_ssl_mode_t base_mode,
  2045. int encrypt_then_mac)
  2046. {
  2047. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  2048. if (encrypt_then_mac == MBEDTLS_SSL_ETM_ENABLED &&
  2049. base_mode == MBEDTLS_SSL_MODE_CBC) {
  2050. return MBEDTLS_SSL_MODE_CBC_ETM;
  2051. }
  2052. #else
  2053. (void) encrypt_then_mac;
  2054. #endif
  2055. return base_mode;
  2056. }
  2057. mbedtls_ssl_mode_t mbedtls_ssl_get_mode_from_transform(
  2058. const mbedtls_ssl_transform *transform)
  2059. {
  2060. mbedtls_ssl_mode_t base_mode = mbedtls_ssl_get_base_mode(
  2061. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  2062. transform->psa_alg
  2063. #else
  2064. mbedtls_cipher_get_cipher_mode(&transform->cipher_ctx_enc)
  2065. #endif
  2066. );
  2067. int encrypt_then_mac = 0;
  2068. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  2069. encrypt_then_mac = transform->encrypt_then_mac;
  2070. #endif
  2071. return mbedtls_ssl_get_actual_mode(base_mode, encrypt_then_mac);
  2072. }
  2073. mbedtls_ssl_mode_t mbedtls_ssl_get_mode_from_ciphersuite(
  2074. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  2075. int encrypt_then_mac,
  2076. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
  2077. const mbedtls_ssl_ciphersuite_t *suite)
  2078. {
  2079. mbedtls_ssl_mode_t base_mode = MBEDTLS_SSL_MODE_STREAM;
  2080. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  2081. psa_status_t status;
  2082. psa_algorithm_t alg;
  2083. psa_key_type_t type;
  2084. size_t size;
  2085. status = mbedtls_ssl_cipher_to_psa((mbedtls_cipher_type_t) suite->cipher,
  2086. 0, &alg, &type, &size);
  2087. if (status == PSA_SUCCESS) {
  2088. base_mode = mbedtls_ssl_get_base_mode(alg);
  2089. }
  2090. #else
  2091. const mbedtls_cipher_info_t *cipher =
  2092. mbedtls_cipher_info_from_type((mbedtls_cipher_type_t) suite->cipher);
  2093. if (cipher != NULL) {
  2094. base_mode =
  2095. mbedtls_ssl_get_base_mode(
  2096. mbedtls_cipher_info_get_mode(cipher));
  2097. }
  2098. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  2099. #if !defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  2100. int encrypt_then_mac = 0;
  2101. #endif
  2102. return mbedtls_ssl_get_actual_mode(base_mode, encrypt_then_mac);
  2103. }
  2104. #if defined(MBEDTLS_USE_PSA_CRYPTO) || defined(MBEDTLS_SSL_PROTO_TLS1_3)
  2105. psa_status_t mbedtls_ssl_cipher_to_psa(mbedtls_cipher_type_t mbedtls_cipher_type,
  2106. size_t taglen,
  2107. psa_algorithm_t *alg,
  2108. psa_key_type_t *key_type,
  2109. size_t *key_size)
  2110. {
  2111. #if !defined(MBEDTLS_SSL_HAVE_CCM)
  2112. (void) taglen;
  2113. #endif
  2114. switch (mbedtls_cipher_type) {
  2115. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_CBC)
  2116. case MBEDTLS_CIPHER_AES_128_CBC:
  2117. *alg = PSA_ALG_CBC_NO_PADDING;
  2118. *key_type = PSA_KEY_TYPE_AES;
  2119. *key_size = 128;
  2120. break;
  2121. #endif
  2122. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_CCM)
  2123. case MBEDTLS_CIPHER_AES_128_CCM:
  2124. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2125. *key_type = PSA_KEY_TYPE_AES;
  2126. *key_size = 128;
  2127. break;
  2128. #endif
  2129. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_GCM)
  2130. case MBEDTLS_CIPHER_AES_128_GCM:
  2131. *alg = PSA_ALG_GCM;
  2132. *key_type = PSA_KEY_TYPE_AES;
  2133. *key_size = 128;
  2134. break;
  2135. #endif
  2136. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_CCM)
  2137. case MBEDTLS_CIPHER_AES_192_CCM:
  2138. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2139. *key_type = PSA_KEY_TYPE_AES;
  2140. *key_size = 192;
  2141. break;
  2142. #endif
  2143. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_GCM)
  2144. case MBEDTLS_CIPHER_AES_192_GCM:
  2145. *alg = PSA_ALG_GCM;
  2146. *key_type = PSA_KEY_TYPE_AES;
  2147. *key_size = 192;
  2148. break;
  2149. #endif
  2150. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_CBC)
  2151. case MBEDTLS_CIPHER_AES_256_CBC:
  2152. *alg = PSA_ALG_CBC_NO_PADDING;
  2153. *key_type = PSA_KEY_TYPE_AES;
  2154. *key_size = 256;
  2155. break;
  2156. #endif
  2157. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_CCM)
  2158. case MBEDTLS_CIPHER_AES_256_CCM:
  2159. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2160. *key_type = PSA_KEY_TYPE_AES;
  2161. *key_size = 256;
  2162. break;
  2163. #endif
  2164. #if defined(MBEDTLS_SSL_HAVE_AES) && defined(MBEDTLS_SSL_HAVE_GCM)
  2165. case MBEDTLS_CIPHER_AES_256_GCM:
  2166. *alg = PSA_ALG_GCM;
  2167. *key_type = PSA_KEY_TYPE_AES;
  2168. *key_size = 256;
  2169. break;
  2170. #endif
  2171. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_CBC)
  2172. case MBEDTLS_CIPHER_ARIA_128_CBC:
  2173. *alg = PSA_ALG_CBC_NO_PADDING;
  2174. *key_type = PSA_KEY_TYPE_ARIA;
  2175. *key_size = 128;
  2176. break;
  2177. #endif
  2178. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_CCM)
  2179. case MBEDTLS_CIPHER_ARIA_128_CCM:
  2180. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2181. *key_type = PSA_KEY_TYPE_ARIA;
  2182. *key_size = 128;
  2183. break;
  2184. #endif
  2185. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_GCM)
  2186. case MBEDTLS_CIPHER_ARIA_128_GCM:
  2187. *alg = PSA_ALG_GCM;
  2188. *key_type = PSA_KEY_TYPE_ARIA;
  2189. *key_size = 128;
  2190. break;
  2191. #endif
  2192. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_CCM)
  2193. case MBEDTLS_CIPHER_ARIA_192_CCM:
  2194. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2195. *key_type = PSA_KEY_TYPE_ARIA;
  2196. *key_size = 192;
  2197. break;
  2198. #endif
  2199. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_GCM)
  2200. case MBEDTLS_CIPHER_ARIA_192_GCM:
  2201. *alg = PSA_ALG_GCM;
  2202. *key_type = PSA_KEY_TYPE_ARIA;
  2203. *key_size = 192;
  2204. break;
  2205. #endif
  2206. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_CBC)
  2207. case MBEDTLS_CIPHER_ARIA_256_CBC:
  2208. *alg = PSA_ALG_CBC_NO_PADDING;
  2209. *key_type = PSA_KEY_TYPE_ARIA;
  2210. *key_size = 256;
  2211. break;
  2212. #endif
  2213. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_CCM)
  2214. case MBEDTLS_CIPHER_ARIA_256_CCM:
  2215. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2216. *key_type = PSA_KEY_TYPE_ARIA;
  2217. *key_size = 256;
  2218. break;
  2219. #endif
  2220. #if defined(MBEDTLS_SSL_HAVE_ARIA) && defined(MBEDTLS_SSL_HAVE_GCM)
  2221. case MBEDTLS_CIPHER_ARIA_256_GCM:
  2222. *alg = PSA_ALG_GCM;
  2223. *key_type = PSA_KEY_TYPE_ARIA;
  2224. *key_size = 256;
  2225. break;
  2226. #endif
  2227. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_CBC)
  2228. case MBEDTLS_CIPHER_CAMELLIA_128_CBC:
  2229. *alg = PSA_ALG_CBC_NO_PADDING;
  2230. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2231. *key_size = 128;
  2232. break;
  2233. #endif
  2234. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_CCM)
  2235. case MBEDTLS_CIPHER_CAMELLIA_128_CCM:
  2236. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2237. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2238. *key_size = 128;
  2239. break;
  2240. #endif
  2241. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_GCM)
  2242. case MBEDTLS_CIPHER_CAMELLIA_128_GCM:
  2243. *alg = PSA_ALG_GCM;
  2244. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2245. *key_size = 128;
  2246. break;
  2247. #endif
  2248. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_CCM)
  2249. case MBEDTLS_CIPHER_CAMELLIA_192_CCM:
  2250. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2251. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2252. *key_size = 192;
  2253. break;
  2254. #endif
  2255. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_GCM)
  2256. case MBEDTLS_CIPHER_CAMELLIA_192_GCM:
  2257. *alg = PSA_ALG_GCM;
  2258. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2259. *key_size = 192;
  2260. break;
  2261. #endif
  2262. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_CBC)
  2263. case MBEDTLS_CIPHER_CAMELLIA_256_CBC:
  2264. *alg = PSA_ALG_CBC_NO_PADDING;
  2265. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2266. *key_size = 256;
  2267. break;
  2268. #endif
  2269. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_CCM)
  2270. case MBEDTLS_CIPHER_CAMELLIA_256_CCM:
  2271. *alg = taglen ? PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, taglen) : PSA_ALG_CCM;
  2272. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2273. *key_size = 256;
  2274. break;
  2275. #endif
  2276. #if defined(MBEDTLS_SSL_HAVE_CAMELLIA) && defined(MBEDTLS_SSL_HAVE_GCM)
  2277. case MBEDTLS_CIPHER_CAMELLIA_256_GCM:
  2278. *alg = PSA_ALG_GCM;
  2279. *key_type = PSA_KEY_TYPE_CAMELLIA;
  2280. *key_size = 256;
  2281. break;
  2282. #endif
  2283. #if defined(MBEDTLS_SSL_HAVE_CHACHAPOLY)
  2284. case MBEDTLS_CIPHER_CHACHA20_POLY1305:
  2285. *alg = PSA_ALG_CHACHA20_POLY1305;
  2286. *key_type = PSA_KEY_TYPE_CHACHA20;
  2287. *key_size = 256;
  2288. break;
  2289. #endif
  2290. case MBEDTLS_CIPHER_NULL:
  2291. *alg = MBEDTLS_SSL_NULL_CIPHER;
  2292. *key_type = 0;
  2293. *key_size = 0;
  2294. break;
  2295. default:
  2296. return PSA_ERROR_NOT_SUPPORTED;
  2297. }
  2298. return PSA_SUCCESS;
  2299. }
  2300. #endif /* MBEDTLS_USE_PSA_CRYPTO || MBEDTLS_SSL_PROTO_TLS1_3 */
  2301. #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
  2302. int mbedtls_ssl_conf_dh_param_bin(mbedtls_ssl_config *conf,
  2303. const unsigned char *dhm_P, size_t P_len,
  2304. const unsigned char *dhm_G, size_t G_len)
  2305. {
  2306. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  2307. mbedtls_mpi_free(&conf->dhm_P);
  2308. mbedtls_mpi_free(&conf->dhm_G);
  2309. if ((ret = mbedtls_mpi_read_binary(&conf->dhm_P, dhm_P, P_len)) != 0 ||
  2310. (ret = mbedtls_mpi_read_binary(&conf->dhm_G, dhm_G, G_len)) != 0) {
  2311. mbedtls_mpi_free(&conf->dhm_P);
  2312. mbedtls_mpi_free(&conf->dhm_G);
  2313. return ret;
  2314. }
  2315. return 0;
  2316. }
  2317. int mbedtls_ssl_conf_dh_param_ctx(mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx)
  2318. {
  2319. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  2320. mbedtls_mpi_free(&conf->dhm_P);
  2321. mbedtls_mpi_free(&conf->dhm_G);
  2322. if ((ret = mbedtls_dhm_get_value(dhm_ctx, MBEDTLS_DHM_PARAM_P,
  2323. &conf->dhm_P)) != 0 ||
  2324. (ret = mbedtls_dhm_get_value(dhm_ctx, MBEDTLS_DHM_PARAM_G,
  2325. &conf->dhm_G)) != 0) {
  2326. mbedtls_mpi_free(&conf->dhm_P);
  2327. mbedtls_mpi_free(&conf->dhm_G);
  2328. return ret;
  2329. }
  2330. return 0;
  2331. }
  2332. #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_SRV_C */
  2333. #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
  2334. /*
  2335. * Set the minimum length for Diffie-Hellman parameters
  2336. */
  2337. void mbedtls_ssl_conf_dhm_min_bitlen(mbedtls_ssl_config *conf,
  2338. unsigned int bitlen)
  2339. {
  2340. conf->dhm_min_bitlen = bitlen;
  2341. }
  2342. #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
  2343. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  2344. #if !defined(MBEDTLS_DEPRECATED_REMOVED) && defined(MBEDTLS_SSL_PROTO_TLS1_2)
  2345. /*
  2346. * Set allowed/preferred hashes for handshake signatures
  2347. */
  2348. void mbedtls_ssl_conf_sig_hashes(mbedtls_ssl_config *conf,
  2349. const int *hashes)
  2350. {
  2351. conf->sig_hashes = hashes;
  2352. }
  2353. #endif /* !MBEDTLS_DEPRECATED_REMOVED && MBEDTLS_SSL_PROTO_TLS1_2 */
  2354. /* Configure allowed signature algorithms for handshake */
  2355. void mbedtls_ssl_conf_sig_algs(mbedtls_ssl_config *conf,
  2356. const uint16_t *sig_algs)
  2357. {
  2358. #if !defined(MBEDTLS_DEPRECATED_REMOVED)
  2359. conf->sig_hashes = NULL;
  2360. #endif /* !MBEDTLS_DEPRECATED_REMOVED */
  2361. conf->sig_algs = sig_algs;
  2362. }
  2363. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  2364. #if defined(MBEDTLS_ECP_C)
  2365. #if !defined(MBEDTLS_DEPRECATED_REMOVED)
  2366. /*
  2367. * Set the allowed elliptic curves
  2368. *
  2369. * mbedtls_ssl_setup() takes the provided list
  2370. * and translates it to a list of IANA TLS group identifiers,
  2371. * stored in ssl->handshake->group_list.
  2372. *
  2373. */
  2374. void mbedtls_ssl_conf_curves(mbedtls_ssl_config *conf,
  2375. const mbedtls_ecp_group_id *curve_list)
  2376. {
  2377. conf->curve_list = curve_list;
  2378. conf->group_list = NULL;
  2379. }
  2380. #endif /* MBEDTLS_DEPRECATED_REMOVED */
  2381. #endif /* MBEDTLS_ECP_C */
  2382. /*
  2383. * Set the allowed groups
  2384. */
  2385. void mbedtls_ssl_conf_groups(mbedtls_ssl_config *conf,
  2386. const uint16_t *group_list)
  2387. {
  2388. #if defined(MBEDTLS_ECP_C) && !defined(MBEDTLS_DEPRECATED_REMOVED)
  2389. conf->curve_list = NULL;
  2390. #endif
  2391. conf->group_list = group_list;
  2392. }
  2393. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  2394. int mbedtls_ssl_set_hostname(mbedtls_ssl_context *ssl, const char *hostname)
  2395. {
  2396. /* Initialize to suppress unnecessary compiler warning */
  2397. size_t hostname_len = 0;
  2398. /* Check if new hostname is valid before
  2399. * making any change to current one */
  2400. if (hostname != NULL) {
  2401. hostname_len = strlen(hostname);
  2402. if (hostname_len > MBEDTLS_SSL_MAX_HOST_NAME_LEN) {
  2403. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  2404. }
  2405. }
  2406. /* Now it's clear that we will overwrite the old hostname,
  2407. * so we can free it safely */
  2408. if (ssl->hostname != NULL) {
  2409. mbedtls_zeroize_and_free(ssl->hostname, strlen(ssl->hostname));
  2410. }
  2411. /* Passing NULL as hostname shall clear the old one */
  2412. if (hostname == NULL) {
  2413. ssl->hostname = NULL;
  2414. } else {
  2415. ssl->hostname = mbedtls_calloc(1, hostname_len + 1);
  2416. if (ssl->hostname == NULL) {
  2417. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  2418. }
  2419. memcpy(ssl->hostname, hostname, hostname_len);
  2420. ssl->hostname[hostname_len] = '\0';
  2421. }
  2422. return 0;
  2423. }
  2424. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  2425. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  2426. void mbedtls_ssl_conf_sni(mbedtls_ssl_config *conf,
  2427. int (*f_sni)(void *, mbedtls_ssl_context *,
  2428. const unsigned char *, size_t),
  2429. void *p_sni)
  2430. {
  2431. conf->f_sni = f_sni;
  2432. conf->p_sni = p_sni;
  2433. }
  2434. #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
  2435. #if defined(MBEDTLS_SSL_ALPN)
  2436. int mbedtls_ssl_conf_alpn_protocols(mbedtls_ssl_config *conf, const char **protos)
  2437. {
  2438. size_t cur_len, tot_len;
  2439. const char **p;
  2440. /*
  2441. * RFC 7301 3.1: "Empty strings MUST NOT be included and byte strings
  2442. * MUST NOT be truncated."
  2443. * We check lengths now rather than later.
  2444. */
  2445. tot_len = 0;
  2446. for (p = protos; *p != NULL; p++) {
  2447. cur_len = strlen(*p);
  2448. tot_len += cur_len;
  2449. if ((cur_len == 0) ||
  2450. (cur_len > MBEDTLS_SSL_MAX_ALPN_NAME_LEN) ||
  2451. (tot_len > MBEDTLS_SSL_MAX_ALPN_LIST_LEN)) {
  2452. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  2453. }
  2454. }
  2455. conf->alpn_list = protos;
  2456. return 0;
  2457. }
  2458. const char *mbedtls_ssl_get_alpn_protocol(const mbedtls_ssl_context *ssl)
  2459. {
  2460. return ssl->alpn_chosen;
  2461. }
  2462. #endif /* MBEDTLS_SSL_ALPN */
  2463. #if defined(MBEDTLS_SSL_DTLS_SRTP)
  2464. void mbedtls_ssl_conf_srtp_mki_value_supported(mbedtls_ssl_config *conf,
  2465. int support_mki_value)
  2466. {
  2467. conf->dtls_srtp_mki_support = support_mki_value;
  2468. }
  2469. int mbedtls_ssl_dtls_srtp_set_mki_value(mbedtls_ssl_context *ssl,
  2470. unsigned char *mki_value,
  2471. uint16_t mki_len)
  2472. {
  2473. if (mki_len > MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH) {
  2474. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  2475. }
  2476. if (ssl->conf->dtls_srtp_mki_support == MBEDTLS_SSL_DTLS_SRTP_MKI_UNSUPPORTED) {
  2477. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  2478. }
  2479. memcpy(ssl->dtls_srtp_info.mki_value, mki_value, mki_len);
  2480. ssl->dtls_srtp_info.mki_len = mki_len;
  2481. return 0;
  2482. }
  2483. int mbedtls_ssl_conf_dtls_srtp_protection_profiles(mbedtls_ssl_config *conf,
  2484. const mbedtls_ssl_srtp_profile *profiles)
  2485. {
  2486. const mbedtls_ssl_srtp_profile *p;
  2487. size_t list_size = 0;
  2488. /* check the profiles list: all entry must be valid,
  2489. * its size cannot be more than the total number of supported profiles, currently 4 */
  2490. for (p = profiles; *p != MBEDTLS_TLS_SRTP_UNSET &&
  2491. list_size <= MBEDTLS_TLS_SRTP_MAX_PROFILE_LIST_LENGTH;
  2492. p++) {
  2493. if (mbedtls_ssl_check_srtp_profile_value(*p) != MBEDTLS_TLS_SRTP_UNSET) {
  2494. list_size++;
  2495. } else {
  2496. /* unsupported value, stop parsing and set the size to an error value */
  2497. list_size = MBEDTLS_TLS_SRTP_MAX_PROFILE_LIST_LENGTH + 1;
  2498. }
  2499. }
  2500. if (list_size > MBEDTLS_TLS_SRTP_MAX_PROFILE_LIST_LENGTH) {
  2501. conf->dtls_srtp_profile_list = NULL;
  2502. conf->dtls_srtp_profile_list_len = 0;
  2503. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  2504. }
  2505. conf->dtls_srtp_profile_list = profiles;
  2506. conf->dtls_srtp_profile_list_len = list_size;
  2507. return 0;
  2508. }
  2509. void mbedtls_ssl_get_dtls_srtp_negotiation_result(const mbedtls_ssl_context *ssl,
  2510. mbedtls_dtls_srtp_info *dtls_srtp_info)
  2511. {
  2512. dtls_srtp_info->chosen_dtls_srtp_profile = ssl->dtls_srtp_info.chosen_dtls_srtp_profile;
  2513. /* do not copy the mki value if there is no chosen profile */
  2514. if (dtls_srtp_info->chosen_dtls_srtp_profile == MBEDTLS_TLS_SRTP_UNSET) {
  2515. dtls_srtp_info->mki_len = 0;
  2516. } else {
  2517. dtls_srtp_info->mki_len = ssl->dtls_srtp_info.mki_len;
  2518. memcpy(dtls_srtp_info->mki_value, ssl->dtls_srtp_info.mki_value,
  2519. ssl->dtls_srtp_info.mki_len);
  2520. }
  2521. }
  2522. #endif /* MBEDTLS_SSL_DTLS_SRTP */
  2523. #if !defined(MBEDTLS_DEPRECATED_REMOVED)
  2524. void mbedtls_ssl_conf_max_version(mbedtls_ssl_config *conf, int major, int minor)
  2525. {
  2526. conf->max_tls_version = (mbedtls_ssl_protocol_version) ((major << 8) | minor);
  2527. }
  2528. void mbedtls_ssl_conf_min_version(mbedtls_ssl_config *conf, int major, int minor)
  2529. {
  2530. conf->min_tls_version = (mbedtls_ssl_protocol_version) ((major << 8) | minor);
  2531. }
  2532. #endif /* MBEDTLS_DEPRECATED_REMOVED */
  2533. #if defined(MBEDTLS_SSL_SRV_C)
  2534. void mbedtls_ssl_conf_cert_req_ca_list(mbedtls_ssl_config *conf,
  2535. char cert_req_ca_list)
  2536. {
  2537. conf->cert_req_ca_list = cert_req_ca_list;
  2538. }
  2539. #endif
  2540. #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  2541. void mbedtls_ssl_conf_encrypt_then_mac(mbedtls_ssl_config *conf, char etm)
  2542. {
  2543. conf->encrypt_then_mac = etm;
  2544. }
  2545. #endif
  2546. #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
  2547. void mbedtls_ssl_conf_extended_master_secret(mbedtls_ssl_config *conf, char ems)
  2548. {
  2549. conf->extended_ms = ems;
  2550. }
  2551. #endif
  2552. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  2553. int mbedtls_ssl_conf_max_frag_len(mbedtls_ssl_config *conf, unsigned char mfl_code)
  2554. {
  2555. if (mfl_code >= MBEDTLS_SSL_MAX_FRAG_LEN_INVALID ||
  2556. ssl_mfl_code_to_length(mfl_code) > MBEDTLS_TLS_EXT_ADV_CONTENT_LEN) {
  2557. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  2558. }
  2559. conf->mfl_code = mfl_code;
  2560. return 0;
  2561. }
  2562. #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
  2563. void mbedtls_ssl_conf_legacy_renegotiation(mbedtls_ssl_config *conf, int allow_legacy)
  2564. {
  2565. conf->allow_legacy_renegotiation = allow_legacy;
  2566. }
  2567. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  2568. void mbedtls_ssl_conf_renegotiation(mbedtls_ssl_config *conf, int renegotiation)
  2569. {
  2570. conf->disable_renegotiation = renegotiation;
  2571. }
  2572. void mbedtls_ssl_conf_renegotiation_enforced(mbedtls_ssl_config *conf, int max_records)
  2573. {
  2574. conf->renego_max_records = max_records;
  2575. }
  2576. void mbedtls_ssl_conf_renegotiation_period(mbedtls_ssl_config *conf,
  2577. const unsigned char period[8])
  2578. {
  2579. memcpy(conf->renego_period, period, 8);
  2580. }
  2581. #endif /* MBEDTLS_SSL_RENEGOTIATION */
  2582. #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  2583. #if defined(MBEDTLS_SSL_CLI_C)
  2584. void mbedtls_ssl_conf_session_tickets(mbedtls_ssl_config *conf, int use_tickets)
  2585. {
  2586. conf->session_tickets &= ~MBEDTLS_SSL_SESSION_TICKETS_TLS1_2_MASK;
  2587. conf->session_tickets |= (use_tickets != 0) <<
  2588. MBEDTLS_SSL_SESSION_TICKETS_TLS1_2_BIT;
  2589. }
  2590. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  2591. void mbedtls_ssl_conf_tls13_enable_signal_new_session_tickets(
  2592. mbedtls_ssl_config *conf, int signal_new_session_tickets)
  2593. {
  2594. conf->session_tickets &= ~MBEDTLS_SSL_SESSION_TICKETS_TLS1_3_MASK;
  2595. conf->session_tickets |= (signal_new_session_tickets != 0) <<
  2596. MBEDTLS_SSL_SESSION_TICKETS_TLS1_3_BIT;
  2597. }
  2598. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  2599. #endif /* MBEDTLS_SSL_CLI_C */
  2600. #if defined(MBEDTLS_SSL_SRV_C)
  2601. #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && defined(MBEDTLS_SSL_SESSION_TICKETS)
  2602. void mbedtls_ssl_conf_new_session_tickets(mbedtls_ssl_config *conf,
  2603. uint16_t num_tickets)
  2604. {
  2605. conf->new_session_tickets_count = num_tickets;
  2606. }
  2607. #endif
  2608. void mbedtls_ssl_conf_session_tickets_cb(mbedtls_ssl_config *conf,
  2609. mbedtls_ssl_ticket_write_t *f_ticket_write,
  2610. mbedtls_ssl_ticket_parse_t *f_ticket_parse,
  2611. void *p_ticket)
  2612. {
  2613. conf->f_ticket_write = f_ticket_write;
  2614. conf->f_ticket_parse = f_ticket_parse;
  2615. conf->p_ticket = p_ticket;
  2616. }
  2617. #endif
  2618. #endif /* MBEDTLS_SSL_SESSION_TICKETS */
  2619. void mbedtls_ssl_set_export_keys_cb(mbedtls_ssl_context *ssl,
  2620. mbedtls_ssl_export_keys_t *f_export_keys,
  2621. void *p_export_keys)
  2622. {
  2623. ssl->f_export_keys = f_export_keys;
  2624. ssl->p_export_keys = p_export_keys;
  2625. }
  2626. #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
  2627. void mbedtls_ssl_conf_async_private_cb(
  2628. mbedtls_ssl_config *conf,
  2629. mbedtls_ssl_async_sign_t *f_async_sign,
  2630. mbedtls_ssl_async_decrypt_t *f_async_decrypt,
  2631. mbedtls_ssl_async_resume_t *f_async_resume,
  2632. mbedtls_ssl_async_cancel_t *f_async_cancel,
  2633. void *async_config_data)
  2634. {
  2635. conf->f_async_sign_start = f_async_sign;
  2636. conf->f_async_decrypt_start = f_async_decrypt;
  2637. conf->f_async_resume = f_async_resume;
  2638. conf->f_async_cancel = f_async_cancel;
  2639. conf->p_async_config_data = async_config_data;
  2640. }
  2641. void *mbedtls_ssl_conf_get_async_config_data(const mbedtls_ssl_config *conf)
  2642. {
  2643. return conf->p_async_config_data;
  2644. }
  2645. void *mbedtls_ssl_get_async_operation_data(const mbedtls_ssl_context *ssl)
  2646. {
  2647. if (ssl->handshake == NULL) {
  2648. return NULL;
  2649. } else {
  2650. return ssl->handshake->user_async_ctx;
  2651. }
  2652. }
  2653. void mbedtls_ssl_set_async_operation_data(mbedtls_ssl_context *ssl,
  2654. void *ctx)
  2655. {
  2656. if (ssl->handshake != NULL) {
  2657. ssl->handshake->user_async_ctx = ctx;
  2658. }
  2659. }
  2660. #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
  2661. /*
  2662. * SSL get accessors
  2663. */
  2664. uint32_t mbedtls_ssl_get_verify_result(const mbedtls_ssl_context *ssl)
  2665. {
  2666. if (ssl->session != NULL) {
  2667. return ssl->session->verify_result;
  2668. }
  2669. if (ssl->session_negotiate != NULL) {
  2670. return ssl->session_negotiate->verify_result;
  2671. }
  2672. return 0xFFFFFFFF;
  2673. }
  2674. int mbedtls_ssl_get_ciphersuite_id_from_ssl(const mbedtls_ssl_context *ssl)
  2675. {
  2676. if (ssl == NULL || ssl->session == NULL) {
  2677. return 0;
  2678. }
  2679. return ssl->session->ciphersuite;
  2680. }
  2681. const char *mbedtls_ssl_get_ciphersuite(const mbedtls_ssl_context *ssl)
  2682. {
  2683. if (ssl == NULL || ssl->session == NULL) {
  2684. return NULL;
  2685. }
  2686. return mbedtls_ssl_get_ciphersuite_name(ssl->session->ciphersuite);
  2687. }
  2688. const char *mbedtls_ssl_get_version(const mbedtls_ssl_context *ssl)
  2689. {
  2690. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  2691. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  2692. switch (ssl->tls_version) {
  2693. case MBEDTLS_SSL_VERSION_TLS1_2:
  2694. return "DTLSv1.2";
  2695. default:
  2696. return "unknown (DTLS)";
  2697. }
  2698. }
  2699. #endif
  2700. switch (ssl->tls_version) {
  2701. case MBEDTLS_SSL_VERSION_TLS1_2:
  2702. return "TLSv1.2";
  2703. case MBEDTLS_SSL_VERSION_TLS1_3:
  2704. return "TLSv1.3";
  2705. default:
  2706. return "unknown";
  2707. }
  2708. }
  2709. #if defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  2710. size_t mbedtls_ssl_get_output_record_size_limit(const mbedtls_ssl_context *ssl)
  2711. {
  2712. const size_t max_len = MBEDTLS_SSL_OUT_CONTENT_LEN;
  2713. size_t record_size_limit = max_len;
  2714. if (ssl->session != NULL &&
  2715. ssl->session->record_size_limit >= MBEDTLS_SSL_RECORD_SIZE_LIMIT_MIN &&
  2716. ssl->session->record_size_limit < max_len) {
  2717. record_size_limit = ssl->session->record_size_limit;
  2718. }
  2719. // TODO: this is currently untested
  2720. /* During a handshake, use the value being negotiated */
  2721. if (ssl->session_negotiate != NULL &&
  2722. ssl->session_negotiate->record_size_limit >= MBEDTLS_SSL_RECORD_SIZE_LIMIT_MIN &&
  2723. ssl->session_negotiate->record_size_limit < max_len) {
  2724. record_size_limit = ssl->session_negotiate->record_size_limit;
  2725. }
  2726. return record_size_limit;
  2727. }
  2728. #endif /* MBEDTLS_SSL_RECORD_SIZE_LIMIT */
  2729. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  2730. size_t mbedtls_ssl_get_input_max_frag_len(const mbedtls_ssl_context *ssl)
  2731. {
  2732. size_t max_len = MBEDTLS_SSL_IN_CONTENT_LEN;
  2733. size_t read_mfl;
  2734. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  2735. /* Use the configured MFL for the client if we're past SERVER_HELLO_DONE */
  2736. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
  2737. ssl->state >= MBEDTLS_SSL_SERVER_HELLO_DONE) {
  2738. return ssl_mfl_code_to_length(ssl->conf->mfl_code);
  2739. }
  2740. #endif
  2741. /* Check if a smaller max length was negotiated */
  2742. if (ssl->session_out != NULL) {
  2743. read_mfl = ssl_mfl_code_to_length(ssl->session_out->mfl_code);
  2744. if (read_mfl < max_len) {
  2745. max_len = read_mfl;
  2746. }
  2747. }
  2748. /* During a handshake, use the value being negotiated */
  2749. if (ssl->session_negotiate != NULL) {
  2750. read_mfl = ssl_mfl_code_to_length(ssl->session_negotiate->mfl_code);
  2751. if (read_mfl < max_len) {
  2752. max_len = read_mfl;
  2753. }
  2754. }
  2755. return max_len;
  2756. }
  2757. size_t mbedtls_ssl_get_output_max_frag_len(const mbedtls_ssl_context *ssl)
  2758. {
  2759. size_t max_len;
  2760. /*
  2761. * Assume mfl_code is correct since it was checked when set
  2762. */
  2763. max_len = ssl_mfl_code_to_length(ssl->conf->mfl_code);
  2764. /* Check if a smaller max length was negotiated */
  2765. if (ssl->session_out != NULL &&
  2766. ssl_mfl_code_to_length(ssl->session_out->mfl_code) < max_len) {
  2767. max_len = ssl_mfl_code_to_length(ssl->session_out->mfl_code);
  2768. }
  2769. /* During a handshake, use the value being negotiated */
  2770. if (ssl->session_negotiate != NULL &&
  2771. ssl_mfl_code_to_length(ssl->session_negotiate->mfl_code) < max_len) {
  2772. max_len = ssl_mfl_code_to_length(ssl->session_negotiate->mfl_code);
  2773. }
  2774. return max_len;
  2775. }
  2776. #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
  2777. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  2778. size_t mbedtls_ssl_get_current_mtu(const mbedtls_ssl_context *ssl)
  2779. {
  2780. /* Return unlimited mtu for client hello messages to avoid fragmentation. */
  2781. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
  2782. (ssl->state == MBEDTLS_SSL_CLIENT_HELLO ||
  2783. ssl->state == MBEDTLS_SSL_SERVER_HELLO)) {
  2784. return 0;
  2785. }
  2786. if (ssl->handshake == NULL || ssl->handshake->mtu == 0) {
  2787. return ssl->mtu;
  2788. }
  2789. if (ssl->mtu == 0) {
  2790. return ssl->handshake->mtu;
  2791. }
  2792. return ssl->mtu < ssl->handshake->mtu ?
  2793. ssl->mtu : ssl->handshake->mtu;
  2794. }
  2795. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  2796. int mbedtls_ssl_get_max_out_record_payload(const mbedtls_ssl_context *ssl)
  2797. {
  2798. size_t max_len = MBEDTLS_SSL_OUT_CONTENT_LEN;
  2799. #if !defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH) && \
  2800. !defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT) && \
  2801. !defined(MBEDTLS_SSL_PROTO_DTLS)
  2802. (void) ssl;
  2803. #endif
  2804. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  2805. const size_t mfl = mbedtls_ssl_get_output_max_frag_len(ssl);
  2806. if (max_len > mfl) {
  2807. max_len = mfl;
  2808. }
  2809. #endif
  2810. #if defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  2811. const size_t record_size_limit = mbedtls_ssl_get_output_record_size_limit(ssl);
  2812. if (max_len > record_size_limit) {
  2813. max_len = record_size_limit;
  2814. }
  2815. #endif
  2816. if (ssl->transform_out != NULL &&
  2817. ssl->transform_out->tls_version == MBEDTLS_SSL_VERSION_TLS1_3) {
  2818. /*
  2819. * In TLS 1.3 case, when records are protected, `max_len` as computed
  2820. * above is the maximum length of the TLSInnerPlaintext structure that
  2821. * along the plaintext payload contains the inner content type (one byte)
  2822. * and some zero padding. Given the algorithm used for padding
  2823. * in mbedtls_ssl_encrypt_buf(), compute the maximum length for
  2824. * the plaintext payload. Round down to a multiple of
  2825. * MBEDTLS_SSL_CID_TLS1_3_PADDING_GRANULARITY and
  2826. * subtract 1.
  2827. */
  2828. max_len = ((max_len / MBEDTLS_SSL_CID_TLS1_3_PADDING_GRANULARITY) *
  2829. MBEDTLS_SSL_CID_TLS1_3_PADDING_GRANULARITY) - 1;
  2830. }
  2831. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  2832. if (mbedtls_ssl_get_current_mtu(ssl) != 0) {
  2833. const size_t mtu = mbedtls_ssl_get_current_mtu(ssl);
  2834. const int ret = mbedtls_ssl_get_record_expansion(ssl);
  2835. const size_t overhead = (size_t) ret;
  2836. if (ret < 0) {
  2837. return ret;
  2838. }
  2839. if (mtu <= overhead) {
  2840. MBEDTLS_SSL_DEBUG_MSG(1, ("MTU too low for record expansion"));
  2841. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  2842. }
  2843. if (max_len > mtu - overhead) {
  2844. max_len = mtu - overhead;
  2845. }
  2846. }
  2847. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  2848. #if !defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH) && \
  2849. !defined(MBEDTLS_SSL_PROTO_DTLS) && \
  2850. !defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  2851. ((void) ssl);
  2852. #endif
  2853. return (int) max_len;
  2854. }
  2855. int mbedtls_ssl_get_max_in_record_payload(const mbedtls_ssl_context *ssl)
  2856. {
  2857. size_t max_len = MBEDTLS_SSL_IN_CONTENT_LEN;
  2858. #if !defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  2859. (void) ssl;
  2860. #endif
  2861. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  2862. const size_t mfl = mbedtls_ssl_get_input_max_frag_len(ssl);
  2863. if (max_len > mfl) {
  2864. max_len = mfl;
  2865. }
  2866. #endif
  2867. return (int) max_len;
  2868. }
  2869. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  2870. const mbedtls_x509_crt *mbedtls_ssl_get_peer_cert(const mbedtls_ssl_context *ssl)
  2871. {
  2872. if (ssl == NULL || ssl->session == NULL) {
  2873. return NULL;
  2874. }
  2875. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  2876. return ssl->session->peer_cert;
  2877. #else
  2878. return NULL;
  2879. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  2880. }
  2881. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  2882. #if defined(MBEDTLS_SSL_CLI_C)
  2883. int mbedtls_ssl_get_session(const mbedtls_ssl_context *ssl,
  2884. mbedtls_ssl_session *dst)
  2885. {
  2886. int ret;
  2887. if (ssl == NULL ||
  2888. dst == NULL ||
  2889. ssl->session == NULL ||
  2890. ssl->conf->endpoint != MBEDTLS_SSL_IS_CLIENT) {
  2891. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  2892. }
  2893. /* Since Mbed TLS 3.0, mbedtls_ssl_get_session() is no longer
  2894. * idempotent: Each session can only be exported once.
  2895. *
  2896. * (This is in preparation for TLS 1.3 support where we will
  2897. * need the ability to export multiple sessions (aka tickets),
  2898. * which will be achieved by calling mbedtls_ssl_get_session()
  2899. * multiple times until it fails.)
  2900. *
  2901. * Check whether we have already exported the current session,
  2902. * and fail if so.
  2903. */
  2904. if (ssl->session->exported == 1) {
  2905. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  2906. }
  2907. ret = mbedtls_ssl_session_copy(dst, ssl->session);
  2908. if (ret != 0) {
  2909. return ret;
  2910. }
  2911. /* Remember that we've exported the session. */
  2912. ssl->session->exported = 1;
  2913. return 0;
  2914. }
  2915. #endif /* MBEDTLS_SSL_CLI_C */
  2916. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  2917. /* Serialization of TLS 1.2 sessions
  2918. *
  2919. * For more detail, see the description of ssl_session_save().
  2920. */
  2921. static size_t ssl_tls12_session_save(const mbedtls_ssl_session *session,
  2922. unsigned char *buf,
  2923. size_t buf_len)
  2924. {
  2925. unsigned char *p = buf;
  2926. size_t used = 0;
  2927. #if defined(MBEDTLS_HAVE_TIME)
  2928. uint64_t start;
  2929. #endif
  2930. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  2931. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  2932. size_t cert_len;
  2933. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  2934. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  2935. /*
  2936. * Time
  2937. */
  2938. #if defined(MBEDTLS_HAVE_TIME)
  2939. used += 8;
  2940. if (used <= buf_len) {
  2941. start = (uint64_t) session->start;
  2942. MBEDTLS_PUT_UINT64_BE(start, p, 0);
  2943. p += 8;
  2944. }
  2945. #endif /* MBEDTLS_HAVE_TIME */
  2946. /*
  2947. * Basic mandatory fields
  2948. */
  2949. used += 1 /* id_len */
  2950. + sizeof(session->id)
  2951. + sizeof(session->master)
  2952. + 4; /* verify_result */
  2953. if (used <= buf_len) {
  2954. *p++ = MBEDTLS_BYTE_0(session->id_len);
  2955. memcpy(p, session->id, 32);
  2956. p += 32;
  2957. memcpy(p, session->master, 48);
  2958. p += 48;
  2959. MBEDTLS_PUT_UINT32_BE(session->verify_result, p, 0);
  2960. p += 4;
  2961. }
  2962. /*
  2963. * Peer's end-entity certificate
  2964. */
  2965. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  2966. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  2967. if (session->peer_cert == NULL) {
  2968. cert_len = 0;
  2969. } else {
  2970. cert_len = session->peer_cert->raw.len;
  2971. }
  2972. used += 3 + cert_len;
  2973. if (used <= buf_len) {
  2974. *p++ = MBEDTLS_BYTE_2(cert_len);
  2975. *p++ = MBEDTLS_BYTE_1(cert_len);
  2976. *p++ = MBEDTLS_BYTE_0(cert_len);
  2977. if (session->peer_cert != NULL) {
  2978. memcpy(p, session->peer_cert->raw.p, cert_len);
  2979. p += cert_len;
  2980. }
  2981. }
  2982. #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  2983. if (session->peer_cert_digest != NULL) {
  2984. used += 1 /* type */ + 1 /* length */ + session->peer_cert_digest_len;
  2985. if (used <= buf_len) {
  2986. *p++ = (unsigned char) session->peer_cert_digest_type;
  2987. *p++ = (unsigned char) session->peer_cert_digest_len;
  2988. memcpy(p, session->peer_cert_digest,
  2989. session->peer_cert_digest_len);
  2990. p += session->peer_cert_digest_len;
  2991. }
  2992. } else {
  2993. used += 2;
  2994. if (used <= buf_len) {
  2995. *p++ = (unsigned char) MBEDTLS_MD_NONE;
  2996. *p++ = 0;
  2997. }
  2998. }
  2999. #endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  3000. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  3001. /*
  3002. * Session ticket if any, plus associated data
  3003. */
  3004. #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  3005. #if defined(MBEDTLS_SSL_CLI_C)
  3006. if (session->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  3007. used += 3 + session->ticket_len + 4; /* len + ticket + lifetime */
  3008. if (used <= buf_len) {
  3009. *p++ = MBEDTLS_BYTE_2(session->ticket_len);
  3010. *p++ = MBEDTLS_BYTE_1(session->ticket_len);
  3011. *p++ = MBEDTLS_BYTE_0(session->ticket_len);
  3012. if (session->ticket != NULL) {
  3013. memcpy(p, session->ticket, session->ticket_len);
  3014. p += session->ticket_len;
  3015. }
  3016. MBEDTLS_PUT_UINT32_BE(session->ticket_lifetime, p, 0);
  3017. p += 4;
  3018. }
  3019. }
  3020. #endif /* MBEDTLS_SSL_CLI_C */
  3021. #if defined(MBEDTLS_HAVE_TIME) && defined(MBEDTLS_SSL_SRV_C)
  3022. if (session->endpoint == MBEDTLS_SSL_IS_SERVER) {
  3023. used += 8;
  3024. if (used <= buf_len) {
  3025. MBEDTLS_PUT_UINT64_BE((uint64_t) session->ticket_creation_time, p, 0);
  3026. p += 8;
  3027. }
  3028. }
  3029. #endif /* MBEDTLS_HAVE_TIME && MBEDTLS_SSL_SRV_C */
  3030. #endif /* MBEDTLS_SSL_SESSION_TICKETS */
  3031. /*
  3032. * Misc extension-related info
  3033. */
  3034. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  3035. used += 1;
  3036. if (used <= buf_len) {
  3037. *p++ = session->mfl_code;
  3038. }
  3039. #endif
  3040. #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  3041. used += 1;
  3042. if (used <= buf_len) {
  3043. *p++ = MBEDTLS_BYTE_0(session->encrypt_then_mac);
  3044. }
  3045. #endif
  3046. return used;
  3047. }
  3048. MBEDTLS_CHECK_RETURN_CRITICAL
  3049. static int ssl_tls12_session_load(mbedtls_ssl_session *session,
  3050. const unsigned char *buf,
  3051. size_t len)
  3052. {
  3053. #if defined(MBEDTLS_HAVE_TIME)
  3054. uint64_t start;
  3055. #endif
  3056. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  3057. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  3058. size_t cert_len;
  3059. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  3060. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  3061. const unsigned char *p = buf;
  3062. const unsigned char * const end = buf + len;
  3063. /*
  3064. * Time
  3065. */
  3066. #if defined(MBEDTLS_HAVE_TIME)
  3067. if (8 > (size_t) (end - p)) {
  3068. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3069. }
  3070. start = MBEDTLS_GET_UINT64_BE(p, 0);
  3071. p += 8;
  3072. session->start = (time_t) start;
  3073. #endif /* MBEDTLS_HAVE_TIME */
  3074. /*
  3075. * Basic mandatory fields
  3076. */
  3077. if (1 + 32 + 48 + 4 > (size_t) (end - p)) {
  3078. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3079. }
  3080. session->id_len = *p++;
  3081. memcpy(session->id, p, 32);
  3082. p += 32;
  3083. memcpy(session->master, p, 48);
  3084. p += 48;
  3085. session->verify_result = MBEDTLS_GET_UINT32_BE(p, 0);
  3086. p += 4;
  3087. /* Immediately clear invalid pointer values that have been read, in case
  3088. * we exit early before we replaced them with valid ones. */
  3089. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  3090. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  3091. session->peer_cert = NULL;
  3092. #else
  3093. session->peer_cert_digest = NULL;
  3094. #endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  3095. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  3096. #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
  3097. session->ticket = NULL;
  3098. #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
  3099. /*
  3100. * Peer certificate
  3101. */
  3102. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  3103. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  3104. /* Deserialize CRT from the end of the ticket. */
  3105. if (3 > (size_t) (end - p)) {
  3106. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3107. }
  3108. cert_len = MBEDTLS_GET_UINT24_BE(p, 0);
  3109. p += 3;
  3110. if (cert_len != 0) {
  3111. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  3112. if (cert_len > (size_t) (end - p)) {
  3113. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3114. }
  3115. session->peer_cert = mbedtls_calloc(1, sizeof(mbedtls_x509_crt));
  3116. if (session->peer_cert == NULL) {
  3117. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  3118. }
  3119. mbedtls_x509_crt_init(session->peer_cert);
  3120. if ((ret = mbedtls_x509_crt_parse_der(session->peer_cert,
  3121. p, cert_len)) != 0) {
  3122. mbedtls_x509_crt_free(session->peer_cert);
  3123. mbedtls_free(session->peer_cert);
  3124. session->peer_cert = NULL;
  3125. return ret;
  3126. }
  3127. p += cert_len;
  3128. }
  3129. #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  3130. /* Deserialize CRT digest from the end of the ticket. */
  3131. if (2 > (size_t) (end - p)) {
  3132. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3133. }
  3134. session->peer_cert_digest_type = (mbedtls_md_type_t) *p++;
  3135. session->peer_cert_digest_len = (size_t) *p++;
  3136. if (session->peer_cert_digest_len != 0) {
  3137. const mbedtls_md_info_t *md_info =
  3138. mbedtls_md_info_from_type(session->peer_cert_digest_type);
  3139. if (md_info == NULL) {
  3140. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3141. }
  3142. if (session->peer_cert_digest_len != mbedtls_md_get_size(md_info)) {
  3143. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3144. }
  3145. if (session->peer_cert_digest_len > (size_t) (end - p)) {
  3146. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3147. }
  3148. session->peer_cert_digest =
  3149. mbedtls_calloc(1, session->peer_cert_digest_len);
  3150. if (session->peer_cert_digest == NULL) {
  3151. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  3152. }
  3153. memcpy(session->peer_cert_digest, p,
  3154. session->peer_cert_digest_len);
  3155. p += session->peer_cert_digest_len;
  3156. }
  3157. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  3158. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  3159. /*
  3160. * Session ticket and associated data
  3161. */
  3162. #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  3163. #if defined(MBEDTLS_SSL_CLI_C)
  3164. if (session->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  3165. if (3 > (size_t) (end - p)) {
  3166. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3167. }
  3168. session->ticket_len = MBEDTLS_GET_UINT24_BE(p, 0);
  3169. p += 3;
  3170. if (session->ticket_len != 0) {
  3171. if (session->ticket_len > (size_t) (end - p)) {
  3172. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3173. }
  3174. session->ticket = mbedtls_calloc(1, session->ticket_len);
  3175. if (session->ticket == NULL) {
  3176. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  3177. }
  3178. memcpy(session->ticket, p, session->ticket_len);
  3179. p += session->ticket_len;
  3180. }
  3181. if (4 > (size_t) (end - p)) {
  3182. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3183. }
  3184. session->ticket_lifetime = MBEDTLS_GET_UINT32_BE(p, 0);
  3185. p += 4;
  3186. }
  3187. #endif /* MBEDTLS_SSL_CLI_C */
  3188. #if defined(MBEDTLS_HAVE_TIME) && defined(MBEDTLS_SSL_SRV_C)
  3189. if (session->endpoint == MBEDTLS_SSL_IS_SERVER) {
  3190. if (8 > (size_t) (end - p)) {
  3191. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3192. }
  3193. session->ticket_creation_time = MBEDTLS_GET_UINT64_BE(p, 0);
  3194. p += 8;
  3195. }
  3196. #endif /* MBEDTLS_HAVE_TIME && MBEDTLS_SSL_SRV_C */
  3197. #endif /* MBEDTLS_SSL_SESSION_TICKETS */
  3198. /*
  3199. * Misc extension-related info
  3200. */
  3201. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  3202. if (1 > (size_t) (end - p)) {
  3203. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3204. }
  3205. session->mfl_code = *p++;
  3206. #endif
  3207. #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  3208. if (1 > (size_t) (end - p)) {
  3209. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3210. }
  3211. session->encrypt_then_mac = *p++;
  3212. #endif
  3213. /* Done, should have consumed entire buffer */
  3214. if (p != end) {
  3215. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3216. }
  3217. return 0;
  3218. }
  3219. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  3220. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  3221. /* Serialization of TLS 1.3 sessions:
  3222. *
  3223. * For more detail, see the description of ssl_session_save().
  3224. */
  3225. #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  3226. MBEDTLS_CHECK_RETURN_CRITICAL
  3227. static int ssl_tls13_session_save(const mbedtls_ssl_session *session,
  3228. unsigned char *buf,
  3229. size_t buf_len,
  3230. size_t *olen)
  3231. {
  3232. unsigned char *p = buf;
  3233. #if defined(MBEDTLS_SSL_CLI_C) && \
  3234. defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  3235. size_t hostname_len = (session->hostname == NULL) ?
  3236. 0 : strlen(session->hostname) + 1;
  3237. #endif
  3238. #if defined(MBEDTLS_SSL_SRV_C) && \
  3239. defined(MBEDTLS_SSL_EARLY_DATA) && defined(MBEDTLS_SSL_ALPN)
  3240. const size_t alpn_len = (session->ticket_alpn == NULL) ?
  3241. 0 : strlen(session->ticket_alpn) + 1;
  3242. #endif
  3243. size_t needed = 4 /* ticket_age_add */
  3244. + 1 /* ticket_flags */
  3245. + 1; /* resumption_key length */
  3246. *olen = 0;
  3247. if (session->resumption_key_len > MBEDTLS_SSL_TLS1_3_TICKET_RESUMPTION_KEY_LEN) {
  3248. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3249. }
  3250. needed += session->resumption_key_len; /* resumption_key */
  3251. #if defined(MBEDTLS_SSL_EARLY_DATA)
  3252. needed += 4; /* max_early_data_size */
  3253. #endif
  3254. #if defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  3255. needed += 2; /* record_size_limit */
  3256. #endif /* MBEDTLS_SSL_RECORD_SIZE_LIMIT */
  3257. #if defined(MBEDTLS_HAVE_TIME)
  3258. needed += 8; /* ticket_creation_time or ticket_reception_time */
  3259. #endif
  3260. #if defined(MBEDTLS_SSL_SRV_C)
  3261. if (session->endpoint == MBEDTLS_SSL_IS_SERVER) {
  3262. #if defined(MBEDTLS_SSL_EARLY_DATA) && defined(MBEDTLS_SSL_ALPN)
  3263. needed += 2 /* alpn_len */
  3264. + alpn_len; /* alpn */
  3265. #endif
  3266. }
  3267. #endif /* MBEDTLS_SSL_SRV_C */
  3268. #if defined(MBEDTLS_SSL_CLI_C)
  3269. if (session->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  3270. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  3271. needed += 2 /* hostname_len */
  3272. + hostname_len; /* hostname */
  3273. #endif
  3274. needed += 4 /* ticket_lifetime */
  3275. + 2; /* ticket_len */
  3276. /* Check size_t overflow */
  3277. if (session->ticket_len > SIZE_MAX - needed) {
  3278. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3279. }
  3280. needed += session->ticket_len; /* ticket */
  3281. }
  3282. #endif /* MBEDTLS_SSL_CLI_C */
  3283. *olen = needed;
  3284. if (needed > buf_len) {
  3285. return MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL;
  3286. }
  3287. MBEDTLS_PUT_UINT32_BE(session->ticket_age_add, p, 0);
  3288. p[4] = session->ticket_flags;
  3289. /* save resumption_key */
  3290. p[5] = session->resumption_key_len;
  3291. p += 6;
  3292. memcpy(p, session->resumption_key, session->resumption_key_len);
  3293. p += session->resumption_key_len;
  3294. #if defined(MBEDTLS_SSL_EARLY_DATA)
  3295. MBEDTLS_PUT_UINT32_BE(session->max_early_data_size, p, 0);
  3296. p += 4;
  3297. #endif
  3298. #if defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  3299. MBEDTLS_PUT_UINT16_BE(session->record_size_limit, p, 0);
  3300. p += 2;
  3301. #endif /* MBEDTLS_SSL_RECORD_SIZE_LIMIT */
  3302. #if defined(MBEDTLS_SSL_SRV_C)
  3303. if (session->endpoint == MBEDTLS_SSL_IS_SERVER) {
  3304. #if defined(MBEDTLS_HAVE_TIME)
  3305. MBEDTLS_PUT_UINT64_BE((uint64_t) session->ticket_creation_time, p, 0);
  3306. p += 8;
  3307. #endif /* MBEDTLS_HAVE_TIME */
  3308. #if defined(MBEDTLS_SSL_EARLY_DATA) && defined(MBEDTLS_SSL_ALPN)
  3309. MBEDTLS_PUT_UINT16_BE(alpn_len, p, 0);
  3310. p += 2;
  3311. if (alpn_len > 0) {
  3312. /* save chosen alpn */
  3313. memcpy(p, session->ticket_alpn, alpn_len);
  3314. p += alpn_len;
  3315. }
  3316. #endif /* MBEDTLS_SSL_EARLY_DATA && MBEDTLS_SSL_ALPN */
  3317. }
  3318. #endif /* MBEDTLS_SSL_SRV_C */
  3319. #if defined(MBEDTLS_SSL_CLI_C)
  3320. if (session->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  3321. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  3322. MBEDTLS_PUT_UINT16_BE(hostname_len, p, 0);
  3323. p += 2;
  3324. if (hostname_len > 0) {
  3325. /* save host name */
  3326. memcpy(p, session->hostname, hostname_len);
  3327. p += hostname_len;
  3328. }
  3329. #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
  3330. #if defined(MBEDTLS_HAVE_TIME)
  3331. MBEDTLS_PUT_UINT64_BE((uint64_t) session->ticket_reception_time, p, 0);
  3332. p += 8;
  3333. #endif
  3334. MBEDTLS_PUT_UINT32_BE(session->ticket_lifetime, p, 0);
  3335. p += 4;
  3336. MBEDTLS_PUT_UINT16_BE(session->ticket_len, p, 0);
  3337. p += 2;
  3338. if (session->ticket != NULL && session->ticket_len > 0) {
  3339. memcpy(p, session->ticket, session->ticket_len);
  3340. p += session->ticket_len;
  3341. }
  3342. }
  3343. #endif /* MBEDTLS_SSL_CLI_C */
  3344. return 0;
  3345. }
  3346. MBEDTLS_CHECK_RETURN_CRITICAL
  3347. static int ssl_tls13_session_load(mbedtls_ssl_session *session,
  3348. const unsigned char *buf,
  3349. size_t len)
  3350. {
  3351. const unsigned char *p = buf;
  3352. const unsigned char *end = buf + len;
  3353. if (end - p < 6) {
  3354. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3355. }
  3356. session->ticket_age_add = MBEDTLS_GET_UINT32_BE(p, 0);
  3357. session->ticket_flags = p[4];
  3358. /* load resumption_key */
  3359. session->resumption_key_len = p[5];
  3360. p += 6;
  3361. if (end - p < session->resumption_key_len) {
  3362. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3363. }
  3364. if (sizeof(session->resumption_key) < session->resumption_key_len) {
  3365. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3366. }
  3367. memcpy(session->resumption_key, p, session->resumption_key_len);
  3368. p += session->resumption_key_len;
  3369. #if defined(MBEDTLS_SSL_EARLY_DATA)
  3370. if (end - p < 4) {
  3371. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3372. }
  3373. session->max_early_data_size = MBEDTLS_GET_UINT32_BE(p, 0);
  3374. p += 4;
  3375. #endif
  3376. #if defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  3377. if (end - p < 2) {
  3378. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3379. }
  3380. session->record_size_limit = MBEDTLS_GET_UINT16_BE(p, 0);
  3381. p += 2;
  3382. #endif /* MBEDTLS_SSL_RECORD_SIZE_LIMIT */
  3383. #if defined(MBEDTLS_SSL_SRV_C)
  3384. if (session->endpoint == MBEDTLS_SSL_IS_SERVER) {
  3385. #if defined(MBEDTLS_HAVE_TIME)
  3386. if (end - p < 8) {
  3387. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3388. }
  3389. session->ticket_creation_time = MBEDTLS_GET_UINT64_BE(p, 0);
  3390. p += 8;
  3391. #endif /* MBEDTLS_HAVE_TIME */
  3392. #if defined(MBEDTLS_SSL_EARLY_DATA) && defined(MBEDTLS_SSL_ALPN)
  3393. size_t alpn_len;
  3394. if (end - p < 2) {
  3395. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3396. }
  3397. alpn_len = MBEDTLS_GET_UINT16_BE(p, 0);
  3398. p += 2;
  3399. if (end - p < (long int) alpn_len) {
  3400. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3401. }
  3402. if (alpn_len > 0) {
  3403. int ret = mbedtls_ssl_session_set_ticket_alpn(session, (char *) p);
  3404. if (ret != 0) {
  3405. return ret;
  3406. }
  3407. p += alpn_len;
  3408. }
  3409. #endif /* MBEDTLS_SSL_EARLY_DATA && MBEDTLS_SSL_ALPN */
  3410. }
  3411. #endif /* MBEDTLS_SSL_SRV_C */
  3412. #if defined(MBEDTLS_SSL_CLI_C)
  3413. if (session->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  3414. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  3415. size_t hostname_len;
  3416. /* load host name */
  3417. if (end - p < 2) {
  3418. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3419. }
  3420. hostname_len = MBEDTLS_GET_UINT16_BE(p, 0);
  3421. p += 2;
  3422. if (end - p < (long int) hostname_len) {
  3423. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3424. }
  3425. if (hostname_len > 0) {
  3426. session->hostname = mbedtls_calloc(1, hostname_len);
  3427. if (session->hostname == NULL) {
  3428. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  3429. }
  3430. memcpy(session->hostname, p, hostname_len);
  3431. p += hostname_len;
  3432. }
  3433. #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
  3434. #if defined(MBEDTLS_HAVE_TIME)
  3435. if (end - p < 8) {
  3436. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3437. }
  3438. session->ticket_reception_time = MBEDTLS_GET_UINT64_BE(p, 0);
  3439. p += 8;
  3440. #endif
  3441. if (end - p < 4) {
  3442. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3443. }
  3444. session->ticket_lifetime = MBEDTLS_GET_UINT32_BE(p, 0);
  3445. p += 4;
  3446. if (end - p < 2) {
  3447. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3448. }
  3449. session->ticket_len = MBEDTLS_GET_UINT16_BE(p, 0);
  3450. p += 2;
  3451. if (end - p < (long int) session->ticket_len) {
  3452. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3453. }
  3454. if (session->ticket_len > 0) {
  3455. session->ticket = mbedtls_calloc(1, session->ticket_len);
  3456. if (session->ticket == NULL) {
  3457. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  3458. }
  3459. memcpy(session->ticket, p, session->ticket_len);
  3460. p += session->ticket_len;
  3461. }
  3462. }
  3463. #endif /* MBEDTLS_SSL_CLI_C */
  3464. return 0;
  3465. }
  3466. #else /* MBEDTLS_SSL_SESSION_TICKETS */
  3467. MBEDTLS_CHECK_RETURN_CRITICAL
  3468. static int ssl_tls13_session_save(const mbedtls_ssl_session *session,
  3469. unsigned char *buf,
  3470. size_t buf_len,
  3471. size_t *olen)
  3472. {
  3473. ((void) session);
  3474. ((void) buf);
  3475. ((void) buf_len);
  3476. *olen = 0;
  3477. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  3478. }
  3479. static int ssl_tls13_session_load(const mbedtls_ssl_session *session,
  3480. const unsigned char *buf,
  3481. size_t buf_len)
  3482. {
  3483. ((void) session);
  3484. ((void) buf);
  3485. ((void) buf_len);
  3486. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  3487. }
  3488. #endif /* !MBEDTLS_SSL_SESSION_TICKETS */
  3489. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  3490. /*
  3491. * Define ticket header determining Mbed TLS version
  3492. * and structure of the ticket.
  3493. */
  3494. /*
  3495. * Define bitflag determining compile-time settings influencing
  3496. * structure of serialized SSL sessions.
  3497. */
  3498. #if defined(MBEDTLS_HAVE_TIME)
  3499. #define SSL_SERIALIZED_SESSION_CONFIG_TIME 1
  3500. #else
  3501. #define SSL_SERIALIZED_SESSION_CONFIG_TIME 0
  3502. #endif /* MBEDTLS_HAVE_TIME */
  3503. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  3504. #define SSL_SERIALIZED_SESSION_CONFIG_CRT 1
  3505. #else
  3506. #define SSL_SERIALIZED_SESSION_CONFIG_CRT 0
  3507. #endif /* MBEDTLS_X509_CRT_PARSE_C */
  3508. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  3509. #define SSL_SERIALIZED_SESSION_CONFIG_KEEP_PEER_CRT 1
  3510. #else
  3511. #define SSL_SERIALIZED_SESSION_CONFIG_KEEP_PEER_CRT 0
  3512. #endif /* MBEDTLS_SSL_SESSION_TICKETS */
  3513. #if defined(MBEDTLS_SSL_CLI_C) && defined(MBEDTLS_SSL_SESSION_TICKETS)
  3514. #define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET 1
  3515. #else
  3516. #define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET 0
  3517. #endif /* MBEDTLS_SSL_CLI_C && MBEDTLS_SSL_SESSION_TICKETS */
  3518. #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  3519. #define SSL_SERIALIZED_SESSION_CONFIG_MFL 1
  3520. #else
  3521. #define SSL_SERIALIZED_SESSION_CONFIG_MFL 0
  3522. #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
  3523. #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  3524. #define SSL_SERIALIZED_SESSION_CONFIG_ETM 1
  3525. #else
  3526. #define SSL_SERIALIZED_SESSION_CONFIG_ETM 0
  3527. #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
  3528. #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  3529. #define SSL_SERIALIZED_SESSION_CONFIG_TICKET 1
  3530. #else
  3531. #define SSL_SERIALIZED_SESSION_CONFIG_TICKET 0
  3532. #endif /* MBEDTLS_SSL_SESSION_TICKETS */
  3533. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  3534. #define SSL_SERIALIZED_SESSION_CONFIG_SNI 1
  3535. #else
  3536. #define SSL_SERIALIZED_SESSION_CONFIG_SNI 0
  3537. #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
  3538. #if defined(MBEDTLS_SSL_EARLY_DATA)
  3539. #define SSL_SERIALIZED_SESSION_CONFIG_EARLY_DATA 1
  3540. #else
  3541. #define SSL_SERIALIZED_SESSION_CONFIG_EARLY_DATA 0
  3542. #endif /* MBEDTLS_SSL_EARLY_DATA */
  3543. #if defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  3544. #define SSL_SERIALIZED_SESSION_CONFIG_RECORD_SIZE 1
  3545. #else
  3546. #define SSL_SERIALIZED_SESSION_CONFIG_RECORD_SIZE 0
  3547. #endif /* MBEDTLS_SSL_RECORD_SIZE_LIMIT */
  3548. #if defined(MBEDTLS_SSL_ALPN) && defined(MBEDTLS_SSL_SRV_C) && \
  3549. defined(MBEDTLS_SSL_EARLY_DATA)
  3550. #define SSL_SERIALIZED_SESSION_CONFIG_ALPN 1
  3551. #else
  3552. #define SSL_SERIALIZED_SESSION_CONFIG_ALPN 0
  3553. #endif /* MBEDTLS_SSL_ALPN */
  3554. #define SSL_SERIALIZED_SESSION_CONFIG_TIME_BIT 0
  3555. #define SSL_SERIALIZED_SESSION_CONFIG_CRT_BIT 1
  3556. #define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET_BIT 2
  3557. #define SSL_SERIALIZED_SESSION_CONFIG_MFL_BIT 3
  3558. #define SSL_SERIALIZED_SESSION_CONFIG_ETM_BIT 4
  3559. #define SSL_SERIALIZED_SESSION_CONFIG_TICKET_BIT 5
  3560. #define SSL_SERIALIZED_SESSION_CONFIG_KEEP_PEER_CRT_BIT 6
  3561. #define SSL_SERIALIZED_SESSION_CONFIG_SNI_BIT 7
  3562. #define SSL_SERIALIZED_SESSION_CONFIG_EARLY_DATA_BIT 8
  3563. #define SSL_SERIALIZED_SESSION_CONFIG_RECORD_SIZE_BIT 9
  3564. #define SSL_SERIALIZED_SESSION_CONFIG_ALPN_BIT 10
  3565. #define SSL_SERIALIZED_SESSION_CONFIG_BITFLAG \
  3566. ((uint16_t) ( \
  3567. (SSL_SERIALIZED_SESSION_CONFIG_TIME << SSL_SERIALIZED_SESSION_CONFIG_TIME_BIT) | \
  3568. (SSL_SERIALIZED_SESSION_CONFIG_CRT << SSL_SERIALIZED_SESSION_CONFIG_CRT_BIT) | \
  3569. (SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET << \
  3570. SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET_BIT) | \
  3571. (SSL_SERIALIZED_SESSION_CONFIG_MFL << SSL_SERIALIZED_SESSION_CONFIG_MFL_BIT) | \
  3572. (SSL_SERIALIZED_SESSION_CONFIG_ETM << SSL_SERIALIZED_SESSION_CONFIG_ETM_BIT) | \
  3573. (SSL_SERIALIZED_SESSION_CONFIG_TICKET << SSL_SERIALIZED_SESSION_CONFIG_TICKET_BIT) | \
  3574. (SSL_SERIALIZED_SESSION_CONFIG_KEEP_PEER_CRT << \
  3575. SSL_SERIALIZED_SESSION_CONFIG_KEEP_PEER_CRT_BIT) | \
  3576. (SSL_SERIALIZED_SESSION_CONFIG_SNI << SSL_SERIALIZED_SESSION_CONFIG_SNI_BIT) | \
  3577. (SSL_SERIALIZED_SESSION_CONFIG_EARLY_DATA << \
  3578. SSL_SERIALIZED_SESSION_CONFIG_EARLY_DATA_BIT) | \
  3579. (SSL_SERIALIZED_SESSION_CONFIG_RECORD_SIZE << \
  3580. SSL_SERIALIZED_SESSION_CONFIG_RECORD_SIZE_BIT) | \
  3581. (SSL_SERIALIZED_SESSION_CONFIG_ALPN << \
  3582. SSL_SERIALIZED_SESSION_CONFIG_ALPN_BIT)))
  3583. static const unsigned char ssl_serialized_session_header[] = {
  3584. MBEDTLS_VERSION_MAJOR,
  3585. MBEDTLS_VERSION_MINOR,
  3586. MBEDTLS_VERSION_PATCH,
  3587. MBEDTLS_BYTE_1(SSL_SERIALIZED_SESSION_CONFIG_BITFLAG),
  3588. MBEDTLS_BYTE_0(SSL_SERIALIZED_SESSION_CONFIG_BITFLAG),
  3589. };
  3590. /*
  3591. * Serialize a session in the following format:
  3592. * (in the presentation language of TLS, RFC 8446 section 3)
  3593. *
  3594. * TLS 1.2 session:
  3595. *
  3596. * struct {
  3597. * #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  3598. * opaque ticket<0..2^24-1>; // length 0 means no ticket
  3599. * uint32 ticket_lifetime;
  3600. * #endif
  3601. * } ClientOnlyData;
  3602. *
  3603. * struct {
  3604. * #if defined(MBEDTLS_HAVE_TIME)
  3605. * uint64 start_time;
  3606. * #endif
  3607. * uint8 session_id_len; // at most 32
  3608. * opaque session_id[32];
  3609. * opaque master[48]; // fixed length in the standard
  3610. * uint32 verify_result;
  3611. * #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE
  3612. * opaque peer_cert<0..2^24-1>; // length 0 means no peer cert
  3613. * #else
  3614. * uint8 peer_cert_digest_type;
  3615. * opaque peer_cert_digest<0..2^8-1>
  3616. * #endif
  3617. * select (endpoint) {
  3618. * case client: ClientOnlyData;
  3619. * case server: uint64 ticket_creation_time;
  3620. * };
  3621. * #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
  3622. * uint8 mfl_code; // up to 255 according to standard
  3623. * #endif
  3624. * #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  3625. * uint8 encrypt_then_mac; // 0 or 1
  3626. * #endif
  3627. * } serialized_session_tls12;
  3628. *
  3629. *
  3630. * TLS 1.3 Session:
  3631. *
  3632. * struct {
  3633. * #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  3634. * opaque hostname<0..2^16-1>;
  3635. * #endif
  3636. * #if defined(MBEDTLS_HAVE_TIME)
  3637. * uint64 ticket_reception_time;
  3638. * #endif
  3639. * uint32 ticket_lifetime;
  3640. * opaque ticket<1..2^16-1>;
  3641. * } ClientOnlyData;
  3642. *
  3643. * struct {
  3644. * uint32 ticket_age_add;
  3645. * uint8 ticket_flags;
  3646. * opaque resumption_key<0..255>;
  3647. * #if defined(MBEDTLS_SSL_EARLY_DATA)
  3648. * uint32 max_early_data_size;
  3649. * #endif
  3650. * #if defined(MBEDTLS_SSL_RECORD_SIZE_LIMIT)
  3651. * uint16 record_size_limit;
  3652. * #endif
  3653. * select ( endpoint ) {
  3654. * case client: ClientOnlyData;
  3655. * case server:
  3656. * #if defined(MBEDTLS_HAVE_TIME)
  3657. * uint64 ticket_creation_time;
  3658. * #endif
  3659. * #if defined(MBEDTLS_SSL_EARLY_DATA) && defined(MBEDTLS_SSL_ALPN)
  3660. * opaque ticket_alpn<0..256>;
  3661. * #endif
  3662. * };
  3663. * } serialized_session_tls13;
  3664. *
  3665. *
  3666. * SSL session:
  3667. *
  3668. * struct {
  3669. *
  3670. * opaque mbedtls_version[3]; // library version: major, minor, patch
  3671. * opaque session_format[2]; // library-version specific 16-bit field
  3672. * // determining the format of the remaining
  3673. * // serialized data.
  3674. *
  3675. * Note: When updating the format, remember to keep
  3676. * these version+format bytes.
  3677. *
  3678. * // In this version, `session_format` determines
  3679. * // the setting of those compile-time
  3680. * // configuration options which influence
  3681. * // the structure of mbedtls_ssl_session.
  3682. *
  3683. * uint8_t minor_ver; // Protocol minor version. Possible values:
  3684. * // - TLS 1.2 (0x0303)
  3685. * // - TLS 1.3 (0x0304)
  3686. * uint8_t endpoint;
  3687. * uint16_t ciphersuite;
  3688. *
  3689. * select (serialized_session.tls_version) {
  3690. *
  3691. * case MBEDTLS_SSL_VERSION_TLS1_2:
  3692. * serialized_session_tls12 data;
  3693. * case MBEDTLS_SSL_VERSION_TLS1_3:
  3694. * serialized_session_tls13 data;
  3695. *
  3696. * };
  3697. *
  3698. * } serialized_session;
  3699. *
  3700. */
  3701. MBEDTLS_CHECK_RETURN_CRITICAL
  3702. static int ssl_session_save(const mbedtls_ssl_session *session,
  3703. unsigned char omit_header,
  3704. unsigned char *buf,
  3705. size_t buf_len,
  3706. size_t *olen)
  3707. {
  3708. unsigned char *p = buf;
  3709. size_t used = 0;
  3710. size_t remaining_len;
  3711. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  3712. size_t out_len;
  3713. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  3714. #endif
  3715. if (session == NULL) {
  3716. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  3717. }
  3718. if (!omit_header) {
  3719. /*
  3720. * Add Mbed TLS version identifier
  3721. */
  3722. used += sizeof(ssl_serialized_session_header);
  3723. if (used <= buf_len) {
  3724. memcpy(p, ssl_serialized_session_header,
  3725. sizeof(ssl_serialized_session_header));
  3726. p += sizeof(ssl_serialized_session_header);
  3727. }
  3728. }
  3729. /*
  3730. * TLS version identifier, endpoint, ciphersuite
  3731. */
  3732. used += 1 /* TLS version */
  3733. + 1 /* endpoint */
  3734. + 2; /* ciphersuite */
  3735. if (used <= buf_len) {
  3736. *p++ = MBEDTLS_BYTE_0(session->tls_version);
  3737. *p++ = session->endpoint;
  3738. MBEDTLS_PUT_UINT16_BE(session->ciphersuite, p, 0);
  3739. p += 2;
  3740. }
  3741. /* Forward to version-specific serialization routine. */
  3742. remaining_len = (buf_len >= used) ? buf_len - used : 0;
  3743. switch (session->tls_version) {
  3744. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  3745. case MBEDTLS_SSL_VERSION_TLS1_2:
  3746. used += ssl_tls12_session_save(session, p, remaining_len);
  3747. break;
  3748. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  3749. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  3750. case MBEDTLS_SSL_VERSION_TLS1_3:
  3751. ret = ssl_tls13_session_save(session, p, remaining_len, &out_len);
  3752. if (ret != 0 && ret != MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL) {
  3753. return ret;
  3754. }
  3755. used += out_len;
  3756. break;
  3757. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  3758. default:
  3759. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  3760. }
  3761. *olen = used;
  3762. if (used > buf_len) {
  3763. return MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL;
  3764. }
  3765. return 0;
  3766. }
  3767. /*
  3768. * Public wrapper for ssl_session_save()
  3769. */
  3770. int mbedtls_ssl_session_save(const mbedtls_ssl_session *session,
  3771. unsigned char *buf,
  3772. size_t buf_len,
  3773. size_t *olen)
  3774. {
  3775. return ssl_session_save(session, 0, buf, buf_len, olen);
  3776. }
  3777. /*
  3778. * Deserialize session, see mbedtls_ssl_session_save() for format.
  3779. *
  3780. * This internal version is wrapped by a public function that cleans up in
  3781. * case of error, and has an extra option omit_header.
  3782. */
  3783. MBEDTLS_CHECK_RETURN_CRITICAL
  3784. static int ssl_session_load(mbedtls_ssl_session *session,
  3785. unsigned char omit_header,
  3786. const unsigned char *buf,
  3787. size_t len)
  3788. {
  3789. const unsigned char *p = buf;
  3790. const unsigned char * const end = buf + len;
  3791. size_t remaining_len;
  3792. if (session == NULL) {
  3793. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  3794. }
  3795. if (!omit_header) {
  3796. /*
  3797. * Check Mbed TLS version identifier
  3798. */
  3799. if ((size_t) (end - p) < sizeof(ssl_serialized_session_header)) {
  3800. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3801. }
  3802. if (memcmp(p, ssl_serialized_session_header,
  3803. sizeof(ssl_serialized_session_header)) != 0) {
  3804. return MBEDTLS_ERR_SSL_VERSION_MISMATCH;
  3805. }
  3806. p += sizeof(ssl_serialized_session_header);
  3807. }
  3808. /*
  3809. * TLS version identifier, endpoint, ciphersuite
  3810. */
  3811. if (4 > (size_t) (end - p)) {
  3812. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3813. }
  3814. session->tls_version = (mbedtls_ssl_protocol_version) (0x0300 | *p++);
  3815. session->endpoint = *p++;
  3816. session->ciphersuite = MBEDTLS_GET_UINT16_BE(p, 0);
  3817. p += 2;
  3818. /* Dispatch according to TLS version. */
  3819. remaining_len = (size_t) (end - p);
  3820. switch (session->tls_version) {
  3821. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  3822. case MBEDTLS_SSL_VERSION_TLS1_2:
  3823. return ssl_tls12_session_load(session, p, remaining_len);
  3824. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  3825. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  3826. case MBEDTLS_SSL_VERSION_TLS1_3:
  3827. return ssl_tls13_session_load(session, p, remaining_len);
  3828. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  3829. default:
  3830. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3831. }
  3832. }
  3833. /*
  3834. * Deserialize session: public wrapper for error cleaning
  3835. */
  3836. int mbedtls_ssl_session_load(mbedtls_ssl_session *session,
  3837. const unsigned char *buf,
  3838. size_t len)
  3839. {
  3840. int ret = ssl_session_load(session, 0, buf, len);
  3841. if (ret != 0) {
  3842. mbedtls_ssl_session_free(session);
  3843. }
  3844. return ret;
  3845. }
  3846. /*
  3847. * Perform a single step of the SSL handshake
  3848. */
  3849. MBEDTLS_CHECK_RETURN_CRITICAL
  3850. static int ssl_prepare_handshake_step(mbedtls_ssl_context *ssl)
  3851. {
  3852. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  3853. /*
  3854. * We may have not been able to send to the peer all the handshake data
  3855. * that were written into the output buffer by the previous handshake step,
  3856. * if the write to the network callback returned with the
  3857. * #MBEDTLS_ERR_SSL_WANT_WRITE error code.
  3858. * We proceed to the next handshake step only when all data from the
  3859. * previous one have been sent to the peer, thus we make sure that this is
  3860. * the case here by calling `mbedtls_ssl_flush_output()`. The function may
  3861. * return with the #MBEDTLS_ERR_SSL_WANT_WRITE error code in which case
  3862. * we have to wait before to go ahead.
  3863. * In the case of TLS 1.3, handshake step handlers do not send data to the
  3864. * peer. Data are only sent here and through
  3865. * `mbedtls_ssl_handle_pending_alert` in case an error that triggered an
  3866. * alert occurred.
  3867. */
  3868. if ((ret = mbedtls_ssl_flush_output(ssl)) != 0) {
  3869. return ret;
  3870. }
  3871. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  3872. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
  3873. ssl->handshake->retransmit_state == MBEDTLS_SSL_RETRANS_SENDING) {
  3874. if ((ret = mbedtls_ssl_flight_transmit(ssl)) != 0) {
  3875. return ret;
  3876. }
  3877. }
  3878. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  3879. return ret;
  3880. }
  3881. int mbedtls_ssl_handshake_step(mbedtls_ssl_context *ssl)
  3882. {
  3883. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  3884. if (ssl == NULL ||
  3885. ssl->conf == NULL ||
  3886. ssl->handshake == NULL ||
  3887. ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER) {
  3888. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3889. }
  3890. ret = ssl_prepare_handshake_step(ssl);
  3891. if (ret != 0) {
  3892. return ret;
  3893. }
  3894. ret = mbedtls_ssl_handle_pending_alert(ssl);
  3895. if (ret != 0) {
  3896. goto cleanup;
  3897. }
  3898. /* If ssl->conf->endpoint is not one of MBEDTLS_SSL_IS_CLIENT or
  3899. * MBEDTLS_SSL_IS_SERVER, this is the return code we give */
  3900. ret = MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3901. #if defined(MBEDTLS_SSL_CLI_C)
  3902. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  3903. MBEDTLS_SSL_DEBUG_MSG(2, ("client state: %s",
  3904. mbedtls_ssl_states_str((mbedtls_ssl_states) ssl->state)));
  3905. switch (ssl->state) {
  3906. case MBEDTLS_SSL_HELLO_REQUEST:
  3907. ssl->state = MBEDTLS_SSL_CLIENT_HELLO;
  3908. ret = 0;
  3909. break;
  3910. case MBEDTLS_SSL_CLIENT_HELLO:
  3911. ret = mbedtls_ssl_write_client_hello(ssl);
  3912. break;
  3913. default:
  3914. #if defined(MBEDTLS_SSL_PROTO_TLS1_2) && defined(MBEDTLS_SSL_PROTO_TLS1_3)
  3915. if (ssl->tls_version == MBEDTLS_SSL_VERSION_TLS1_3) {
  3916. ret = mbedtls_ssl_tls13_handshake_client_step(ssl);
  3917. } else {
  3918. ret = mbedtls_ssl_handshake_client_step(ssl);
  3919. }
  3920. #elif defined(MBEDTLS_SSL_PROTO_TLS1_2)
  3921. ret = mbedtls_ssl_handshake_client_step(ssl);
  3922. #else
  3923. ret = mbedtls_ssl_tls13_handshake_client_step(ssl);
  3924. #endif
  3925. }
  3926. }
  3927. #endif /* MBEDTLS_SSL_CLI_C */
  3928. #if defined(MBEDTLS_SSL_SRV_C)
  3929. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  3930. #if defined(MBEDTLS_SSL_PROTO_TLS1_2) && defined(MBEDTLS_SSL_PROTO_TLS1_3)
  3931. if (ssl->tls_version == MBEDTLS_SSL_VERSION_TLS1_3) {
  3932. ret = mbedtls_ssl_tls13_handshake_server_step(ssl);
  3933. } else {
  3934. ret = mbedtls_ssl_handshake_server_step(ssl);
  3935. }
  3936. #elif defined(MBEDTLS_SSL_PROTO_TLS1_2)
  3937. ret = mbedtls_ssl_handshake_server_step(ssl);
  3938. #else
  3939. ret = mbedtls_ssl_tls13_handshake_server_step(ssl);
  3940. #endif
  3941. }
  3942. #endif /* MBEDTLS_SSL_SRV_C */
  3943. if (ret != 0) {
  3944. /* handshake_step return error. And it is same
  3945. * with alert_reason.
  3946. */
  3947. if (ssl->send_alert) {
  3948. ret = mbedtls_ssl_handle_pending_alert(ssl);
  3949. goto cleanup;
  3950. }
  3951. }
  3952. cleanup:
  3953. return ret;
  3954. }
  3955. /*
  3956. * Perform the SSL handshake
  3957. */
  3958. int mbedtls_ssl_handshake(mbedtls_ssl_context *ssl)
  3959. {
  3960. int ret = 0;
  3961. /* Sanity checks */
  3962. if (ssl == NULL || ssl->conf == NULL) {
  3963. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3964. }
  3965. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  3966. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
  3967. (ssl->f_set_timer == NULL || ssl->f_get_timer == NULL)) {
  3968. MBEDTLS_SSL_DEBUG_MSG(1, ("You must use "
  3969. "mbedtls_ssl_set_timer_cb() for DTLS"));
  3970. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  3971. }
  3972. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  3973. MBEDTLS_SSL_DEBUG_MSG(2, ("=> handshake"));
  3974. /* Main handshake loop */
  3975. while (ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER) {
  3976. ret = mbedtls_ssl_handshake_step(ssl);
  3977. if (ret != 0) {
  3978. break;
  3979. }
  3980. }
  3981. MBEDTLS_SSL_DEBUG_MSG(2, ("<= handshake"));
  3982. return ret;
  3983. }
  3984. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  3985. #if defined(MBEDTLS_SSL_SRV_C)
  3986. /*
  3987. * Write HelloRequest to request renegotiation on server
  3988. */
  3989. MBEDTLS_CHECK_RETURN_CRITICAL
  3990. static int ssl_write_hello_request(mbedtls_ssl_context *ssl)
  3991. {
  3992. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  3993. MBEDTLS_SSL_DEBUG_MSG(2, ("=> write hello request"));
  3994. ssl->out_msglen = 4;
  3995. ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
  3996. ssl->out_msg[0] = MBEDTLS_SSL_HS_HELLO_REQUEST;
  3997. if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
  3998. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
  3999. return ret;
  4000. }
  4001. MBEDTLS_SSL_DEBUG_MSG(2, ("<= write hello request"));
  4002. return 0;
  4003. }
  4004. #endif /* MBEDTLS_SSL_SRV_C */
  4005. /*
  4006. * Actually renegotiate current connection, triggered by either:
  4007. * - any side: calling mbedtls_ssl_renegotiate(),
  4008. * - client: receiving a HelloRequest during mbedtls_ssl_read(),
  4009. * - server: receiving any handshake message on server during mbedtls_ssl_read() after
  4010. * the initial handshake is completed.
  4011. * If the handshake doesn't complete due to waiting for I/O, it will continue
  4012. * during the next calls to mbedtls_ssl_renegotiate() or mbedtls_ssl_read() respectively.
  4013. */
  4014. int mbedtls_ssl_start_renegotiation(mbedtls_ssl_context *ssl)
  4015. {
  4016. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  4017. MBEDTLS_SSL_DEBUG_MSG(2, ("=> renegotiate"));
  4018. if ((ret = ssl_handshake_init(ssl)) != 0) {
  4019. return ret;
  4020. }
  4021. /* RFC 6347 4.2.2: "[...] the HelloRequest will have message_seq = 0 and
  4022. * the ServerHello will have message_seq = 1" */
  4023. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  4024. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
  4025. ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING) {
  4026. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  4027. ssl->handshake->out_msg_seq = 1;
  4028. } else {
  4029. ssl->handshake->in_msg_seq = 1;
  4030. }
  4031. }
  4032. #endif
  4033. ssl->state = MBEDTLS_SSL_HELLO_REQUEST;
  4034. ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS;
  4035. if ((ret = mbedtls_ssl_handshake(ssl)) != 0) {
  4036. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_handshake", ret);
  4037. return ret;
  4038. }
  4039. MBEDTLS_SSL_DEBUG_MSG(2, ("<= renegotiate"));
  4040. return 0;
  4041. }
  4042. /*
  4043. * Renegotiate current connection on client,
  4044. * or request renegotiation on server
  4045. */
  4046. int mbedtls_ssl_renegotiate(mbedtls_ssl_context *ssl)
  4047. {
  4048. int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  4049. if (ssl == NULL || ssl->conf == NULL) {
  4050. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4051. }
  4052. #if defined(MBEDTLS_SSL_SRV_C)
  4053. /* On server, just send the request */
  4054. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  4055. if (mbedtls_ssl_is_handshake_over(ssl) == 0) {
  4056. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4057. }
  4058. ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_PENDING;
  4059. /* Did we already try/start sending HelloRequest? */
  4060. if (ssl->out_left != 0) {
  4061. return mbedtls_ssl_flush_output(ssl);
  4062. }
  4063. return ssl_write_hello_request(ssl);
  4064. }
  4065. #endif /* MBEDTLS_SSL_SRV_C */
  4066. #if defined(MBEDTLS_SSL_CLI_C)
  4067. /*
  4068. * On client, either start the renegotiation process or,
  4069. * if already in progress, continue the handshake
  4070. */
  4071. if (ssl->renego_status != MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS) {
  4072. if (mbedtls_ssl_is_handshake_over(ssl) == 0) {
  4073. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4074. }
  4075. if ((ret = mbedtls_ssl_start_renegotiation(ssl)) != 0) {
  4076. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_start_renegotiation", ret);
  4077. return ret;
  4078. }
  4079. } else {
  4080. if ((ret = mbedtls_ssl_handshake(ssl)) != 0) {
  4081. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_handshake", ret);
  4082. return ret;
  4083. }
  4084. }
  4085. #endif /* MBEDTLS_SSL_CLI_C */
  4086. return ret;
  4087. }
  4088. #endif /* MBEDTLS_SSL_RENEGOTIATION */
  4089. void mbedtls_ssl_handshake_free(mbedtls_ssl_context *ssl)
  4090. {
  4091. mbedtls_ssl_handshake_params *handshake = ssl->handshake;
  4092. if (handshake == NULL) {
  4093. return;
  4094. }
  4095. #if defined(MBEDTLS_PK_HAVE_ECC_KEYS)
  4096. #if !defined(MBEDTLS_DEPRECATED_REMOVED)
  4097. if (ssl->handshake->group_list_heap_allocated) {
  4098. mbedtls_free((void *) handshake->group_list);
  4099. }
  4100. handshake->group_list = NULL;
  4101. #endif /* MBEDTLS_DEPRECATED_REMOVED */
  4102. #endif /* MBEDTLS_PK_HAVE_ECC_KEYS */
  4103. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  4104. #if !defined(MBEDTLS_DEPRECATED_REMOVED)
  4105. if (ssl->handshake->sig_algs_heap_allocated) {
  4106. mbedtls_free((void *) handshake->sig_algs);
  4107. }
  4108. handshake->sig_algs = NULL;
  4109. #endif /* MBEDTLS_DEPRECATED_REMOVED */
  4110. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  4111. if (ssl->handshake->certificate_request_context) {
  4112. mbedtls_free((void *) handshake->certificate_request_context);
  4113. }
  4114. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  4115. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  4116. #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
  4117. if (ssl->conf->f_async_cancel != NULL && handshake->async_in_progress != 0) {
  4118. ssl->conf->f_async_cancel(ssl);
  4119. handshake->async_in_progress = 0;
  4120. }
  4121. #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
  4122. #if defined(MBEDTLS_MD_CAN_SHA256)
  4123. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  4124. psa_hash_abort(&handshake->fin_sha256_psa);
  4125. #else
  4126. mbedtls_md_free(&handshake->fin_sha256);
  4127. #endif
  4128. #endif
  4129. #if defined(MBEDTLS_MD_CAN_SHA384)
  4130. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  4131. psa_hash_abort(&handshake->fin_sha384_psa);
  4132. #else
  4133. mbedtls_md_free(&handshake->fin_sha384);
  4134. #endif
  4135. #endif
  4136. #if defined(MBEDTLS_DHM_C)
  4137. mbedtls_dhm_free(&handshake->dhm_ctx);
  4138. #endif
  4139. #if !defined(MBEDTLS_USE_PSA_CRYPTO) && \
  4140. defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED)
  4141. mbedtls_ecdh_free(&handshake->ecdh_ctx);
  4142. #endif
  4143. #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
  4144. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  4145. psa_pake_abort(&handshake->psa_pake_ctx);
  4146. /*
  4147. * Opaque keys are not stored in the handshake's data and it's the user
  4148. * responsibility to destroy them. Clear ones, instead, are created by
  4149. * the TLS library and should be destroyed at the same level
  4150. */
  4151. if (!mbedtls_svc_key_id_is_null(handshake->psa_pake_password)) {
  4152. psa_destroy_key(handshake->psa_pake_password);
  4153. }
  4154. handshake->psa_pake_password = MBEDTLS_SVC_KEY_ID_INIT;
  4155. #else
  4156. mbedtls_ecjpake_free(&handshake->ecjpake_ctx);
  4157. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  4158. #if defined(MBEDTLS_SSL_CLI_C)
  4159. mbedtls_free(handshake->ecjpake_cache);
  4160. handshake->ecjpake_cache = NULL;
  4161. handshake->ecjpake_cache_len = 0;
  4162. #endif
  4163. #endif
  4164. #if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_ANY_ENABLED) || \
  4165. defined(MBEDTLS_KEY_EXCHANGE_WITH_ECDSA_ANY_ENABLED) || \
  4166. defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
  4167. /* explicit void pointer cast for buggy MS compiler */
  4168. mbedtls_free((void *) handshake->curves_tls_id);
  4169. #endif
  4170. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_PSK_ENABLED)
  4171. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  4172. if (!mbedtls_svc_key_id_is_null(ssl->handshake->psk_opaque)) {
  4173. /* The maintenance of the external PSK key slot is the
  4174. * user's responsibility. */
  4175. if (ssl->handshake->psk_opaque_is_internal) {
  4176. psa_destroy_key(ssl->handshake->psk_opaque);
  4177. ssl->handshake->psk_opaque_is_internal = 0;
  4178. }
  4179. ssl->handshake->psk_opaque = MBEDTLS_SVC_KEY_ID_INIT;
  4180. }
  4181. #else
  4182. if (handshake->psk != NULL) {
  4183. mbedtls_zeroize_and_free(handshake->psk, handshake->psk_len);
  4184. }
  4185. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  4186. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_PSK_ENABLED */
  4187. #if defined(MBEDTLS_X509_CRT_PARSE_C) && \
  4188. defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  4189. /*
  4190. * Free only the linked list wrapper, not the keys themselves
  4191. * since the belong to the SNI callback
  4192. */
  4193. ssl_key_cert_free(handshake->sni_key_cert);
  4194. #endif /* MBEDTLS_X509_CRT_PARSE_C && MBEDTLS_SSL_SERVER_NAME_INDICATION */
  4195. #if defined(MBEDTLS_SSL_ECP_RESTARTABLE_ENABLED)
  4196. mbedtls_x509_crt_restart_free(&handshake->ecrs_ctx);
  4197. if (handshake->ecrs_peer_cert != NULL) {
  4198. mbedtls_x509_crt_free(handshake->ecrs_peer_cert);
  4199. mbedtls_free(handshake->ecrs_peer_cert);
  4200. }
  4201. #endif
  4202. #if defined(MBEDTLS_X509_CRT_PARSE_C) && \
  4203. !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  4204. mbedtls_pk_free(&handshake->peer_pubkey);
  4205. #endif /* MBEDTLS_X509_CRT_PARSE_C && !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  4206. #if defined(MBEDTLS_SSL_CLI_C) && \
  4207. (defined(MBEDTLS_SSL_PROTO_DTLS) || defined(MBEDTLS_SSL_PROTO_TLS1_3))
  4208. mbedtls_free(handshake->cookie);
  4209. #endif /* MBEDTLS_SSL_CLI_C &&
  4210. ( MBEDTLS_SSL_PROTO_DTLS || MBEDTLS_SSL_PROTO_TLS1_3 ) */
  4211. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  4212. mbedtls_ssl_flight_free(handshake->flight);
  4213. mbedtls_ssl_buffering_free(ssl);
  4214. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  4215. #if defined(MBEDTLS_KEY_EXCHANGE_SOME_XXDH_PSA_ANY_ENABLED)
  4216. if (handshake->xxdh_psa_privkey_is_external == 0) {
  4217. psa_destroy_key(handshake->xxdh_psa_privkey);
  4218. }
  4219. #endif /* MBEDTLS_KEY_EXCHANGE_SOME_XXDH_PSA_ANY_ENABLED */
  4220. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  4221. mbedtls_ssl_transform_free(handshake->transform_handshake);
  4222. mbedtls_free(handshake->transform_handshake);
  4223. #if defined(MBEDTLS_SSL_EARLY_DATA)
  4224. mbedtls_ssl_transform_free(handshake->transform_earlydata);
  4225. mbedtls_free(handshake->transform_earlydata);
  4226. #endif
  4227. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  4228. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  4229. /* If the buffers are too big - reallocate. Because of the way Mbed TLS
  4230. * processes datagrams and the fact that a datagram is allowed to have
  4231. * several records in it, it is possible that the I/O buffers are not
  4232. * empty at this stage */
  4233. handle_buffer_resizing(ssl, 1, mbedtls_ssl_get_input_buflen(ssl),
  4234. mbedtls_ssl_get_output_buflen(ssl));
  4235. #endif
  4236. /* mbedtls_platform_zeroize MUST be last one in this function */
  4237. mbedtls_platform_zeroize(handshake,
  4238. sizeof(mbedtls_ssl_handshake_params));
  4239. }
  4240. void mbedtls_ssl_session_free(mbedtls_ssl_session *session)
  4241. {
  4242. if (session == NULL) {
  4243. return;
  4244. }
  4245. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  4246. ssl_clear_peer_cert(session);
  4247. #endif
  4248. #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
  4249. #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && \
  4250. defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  4251. mbedtls_free(session->hostname);
  4252. #endif
  4253. mbedtls_free(session->ticket);
  4254. #endif
  4255. #if defined(MBEDTLS_SSL_EARLY_DATA) && defined(MBEDTLS_SSL_ALPN) && \
  4256. defined(MBEDTLS_SSL_SRV_C)
  4257. mbedtls_free(session->ticket_alpn);
  4258. #endif
  4259. mbedtls_platform_zeroize(session, sizeof(mbedtls_ssl_session));
  4260. }
  4261. #if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
  4262. #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
  4263. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID 1u
  4264. #else
  4265. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID 0u
  4266. #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
  4267. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT 1u
  4268. #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
  4269. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY 1u
  4270. #else
  4271. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY 0u
  4272. #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
  4273. #if defined(MBEDTLS_SSL_ALPN)
  4274. #define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN 1u
  4275. #else
  4276. #define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN 0u
  4277. #endif /* MBEDTLS_SSL_ALPN */
  4278. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID_BIT 0
  4279. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT_BIT 1
  4280. #define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY_BIT 2
  4281. #define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN_BIT 3
  4282. #define SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG \
  4283. ((uint32_t) ( \
  4284. (SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID << \
  4285. SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID_BIT) | \
  4286. (SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT << \
  4287. SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT_BIT) | \
  4288. (SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY << \
  4289. SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY_BIT) | \
  4290. (SSL_SERIALIZED_CONTEXT_CONFIG_ALPN << SSL_SERIALIZED_CONTEXT_CONFIG_ALPN_BIT) | \
  4291. 0u))
  4292. static const unsigned char ssl_serialized_context_header[] = {
  4293. MBEDTLS_VERSION_MAJOR,
  4294. MBEDTLS_VERSION_MINOR,
  4295. MBEDTLS_VERSION_PATCH,
  4296. MBEDTLS_BYTE_1(SSL_SERIALIZED_SESSION_CONFIG_BITFLAG),
  4297. MBEDTLS_BYTE_0(SSL_SERIALIZED_SESSION_CONFIG_BITFLAG),
  4298. MBEDTLS_BYTE_2(SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG),
  4299. MBEDTLS_BYTE_1(SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG),
  4300. MBEDTLS_BYTE_0(SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG),
  4301. };
  4302. /*
  4303. * Serialize a full SSL context
  4304. *
  4305. * The format of the serialized data is:
  4306. * (in the presentation language of TLS, RFC 8446 section 3)
  4307. *
  4308. * // header
  4309. * opaque mbedtls_version[3]; // major, minor, patch
  4310. * opaque context_format[5]; // version-specific field determining
  4311. * // the format of the remaining
  4312. * // serialized data.
  4313. * Note: When updating the format, remember to keep these
  4314. * version+format bytes. (We may make their size part of the API.)
  4315. *
  4316. * // session sub-structure
  4317. * opaque session<1..2^32-1>; // see mbedtls_ssl_session_save()
  4318. * // transform sub-structure
  4319. * uint8 random[64]; // ServerHello.random+ClientHello.random
  4320. * uint8 in_cid<0..2^8-1> // Connection ID: expected incoming value
  4321. * uint8 out_cid<0..2^8-1> // Connection ID: outgoing value to use
  4322. * // fields from ssl_context
  4323. * uint32 badmac_seen_or_in_hsfraglen; // DTLS: number of records with failing MAC
  4324. * uint64 in_window_top; // DTLS: last validated record seq_num
  4325. * uint64 in_window; // DTLS: bitmask for replay protection
  4326. * uint8 disable_datagram_packing; // DTLS: only one record per datagram
  4327. * uint64 cur_out_ctr; // Record layer: outgoing sequence number
  4328. * uint16 mtu; // DTLS: path mtu (max outgoing fragment size)
  4329. * uint8 alpn_chosen<0..2^8-1> // ALPN: negotiated application protocol
  4330. *
  4331. * Note that many fields of the ssl_context or sub-structures are not
  4332. * serialized, as they fall in one of the following categories:
  4333. *
  4334. * 1. forced value (eg in_left must be 0)
  4335. * 2. pointer to dynamically-allocated memory (eg session, transform)
  4336. * 3. value can be re-derived from other data (eg session keys from MS)
  4337. * 4. value was temporary (eg content of input buffer)
  4338. * 5. value will be provided by the user again (eg I/O callbacks and context)
  4339. */
  4340. int mbedtls_ssl_context_save(mbedtls_ssl_context *ssl,
  4341. unsigned char *buf,
  4342. size_t buf_len,
  4343. size_t *olen)
  4344. {
  4345. unsigned char *p = buf;
  4346. size_t used = 0;
  4347. size_t session_len;
  4348. int ret = 0;
  4349. /*
  4350. * Enforce usage restrictions, see "return BAD_INPUT_DATA" in
  4351. * this function's documentation.
  4352. *
  4353. * These are due to assumptions/limitations in the implementation. Some of
  4354. * them are likely to stay (no handshake in progress) some might go away
  4355. * (only DTLS) but are currently used to simplify the implementation.
  4356. */
  4357. /* The initial handshake must be over */
  4358. if (mbedtls_ssl_is_handshake_over(ssl) == 0) {
  4359. MBEDTLS_SSL_DEBUG_MSG(1, ("Initial handshake isn't over"));
  4360. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4361. }
  4362. if (ssl->handshake != NULL) {
  4363. MBEDTLS_SSL_DEBUG_MSG(1, ("Handshake isn't completed"));
  4364. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4365. }
  4366. /* Double-check that sub-structures are indeed ready */
  4367. if (ssl->transform == NULL || ssl->session == NULL) {
  4368. MBEDTLS_SSL_DEBUG_MSG(1, ("Serialised structures aren't ready"));
  4369. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4370. }
  4371. /* There must be no pending incoming or outgoing data */
  4372. if (mbedtls_ssl_check_pending(ssl) != 0) {
  4373. MBEDTLS_SSL_DEBUG_MSG(1, ("There is pending incoming data"));
  4374. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4375. }
  4376. if (ssl->out_left != 0) {
  4377. MBEDTLS_SSL_DEBUG_MSG(1, ("There is pending outgoing data"));
  4378. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4379. }
  4380. /* Protocol must be DTLS, not TLS */
  4381. if (ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  4382. MBEDTLS_SSL_DEBUG_MSG(1, ("Only DTLS is supported"));
  4383. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4384. }
  4385. /* Version must be 1.2 */
  4386. if (ssl->tls_version != MBEDTLS_SSL_VERSION_TLS1_2) {
  4387. MBEDTLS_SSL_DEBUG_MSG(1, ("Only version 1.2 supported"));
  4388. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4389. }
  4390. /* We must be using an AEAD ciphersuite */
  4391. if (mbedtls_ssl_transform_uses_aead(ssl->transform) != 1) {
  4392. MBEDTLS_SSL_DEBUG_MSG(1, ("Only AEAD ciphersuites supported"));
  4393. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4394. }
  4395. /* Renegotiation must not be enabled */
  4396. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  4397. if (ssl->conf->disable_renegotiation != MBEDTLS_SSL_RENEGOTIATION_DISABLED) {
  4398. MBEDTLS_SSL_DEBUG_MSG(1, ("Renegotiation must not be enabled"));
  4399. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4400. }
  4401. #endif
  4402. /*
  4403. * Version and format identifier
  4404. */
  4405. used += sizeof(ssl_serialized_context_header);
  4406. if (used <= buf_len) {
  4407. memcpy(p, ssl_serialized_context_header,
  4408. sizeof(ssl_serialized_context_header));
  4409. p += sizeof(ssl_serialized_context_header);
  4410. }
  4411. /*
  4412. * Session (length + data)
  4413. */
  4414. ret = ssl_session_save(ssl->session, 1, NULL, 0, &session_len);
  4415. if (ret != MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL) {
  4416. return ret;
  4417. }
  4418. used += 4 + session_len;
  4419. if (used <= buf_len) {
  4420. MBEDTLS_PUT_UINT32_BE(session_len, p, 0);
  4421. p += 4;
  4422. ret = ssl_session_save(ssl->session, 1,
  4423. p, session_len, &session_len);
  4424. if (ret != 0) {
  4425. return ret;
  4426. }
  4427. p += session_len;
  4428. }
  4429. /*
  4430. * Transform
  4431. */
  4432. used += sizeof(ssl->transform->randbytes);
  4433. if (used <= buf_len) {
  4434. memcpy(p, ssl->transform->randbytes,
  4435. sizeof(ssl->transform->randbytes));
  4436. p += sizeof(ssl->transform->randbytes);
  4437. }
  4438. #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
  4439. used += 2U + ssl->transform->in_cid_len + ssl->transform->out_cid_len;
  4440. if (used <= buf_len) {
  4441. *p++ = ssl->transform->in_cid_len;
  4442. memcpy(p, ssl->transform->in_cid, ssl->transform->in_cid_len);
  4443. p += ssl->transform->in_cid_len;
  4444. *p++ = ssl->transform->out_cid_len;
  4445. memcpy(p, ssl->transform->out_cid, ssl->transform->out_cid_len);
  4446. p += ssl->transform->out_cid_len;
  4447. }
  4448. #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
  4449. /*
  4450. * Saved fields from top-level ssl_context structure
  4451. */
  4452. used += 4;
  4453. if (used <= buf_len) {
  4454. MBEDTLS_PUT_UINT32_BE(ssl->badmac_seen_or_in_hsfraglen, p, 0);
  4455. p += 4;
  4456. }
  4457. #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
  4458. used += 16;
  4459. if (used <= buf_len) {
  4460. MBEDTLS_PUT_UINT64_BE(ssl->in_window_top, p, 0);
  4461. p += 8;
  4462. MBEDTLS_PUT_UINT64_BE(ssl->in_window, p, 0);
  4463. p += 8;
  4464. }
  4465. #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
  4466. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  4467. used += 1;
  4468. if (used <= buf_len) {
  4469. *p++ = ssl->disable_datagram_packing;
  4470. }
  4471. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  4472. used += MBEDTLS_SSL_SEQUENCE_NUMBER_LEN;
  4473. if (used <= buf_len) {
  4474. memcpy(p, ssl->cur_out_ctr, MBEDTLS_SSL_SEQUENCE_NUMBER_LEN);
  4475. p += MBEDTLS_SSL_SEQUENCE_NUMBER_LEN;
  4476. }
  4477. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  4478. used += 2;
  4479. if (used <= buf_len) {
  4480. MBEDTLS_PUT_UINT16_BE(ssl->mtu, p, 0);
  4481. p += 2;
  4482. }
  4483. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  4484. #if defined(MBEDTLS_SSL_ALPN)
  4485. {
  4486. const uint8_t alpn_len = ssl->alpn_chosen
  4487. ? (uint8_t) strlen(ssl->alpn_chosen)
  4488. : 0;
  4489. used += 1 + alpn_len;
  4490. if (used <= buf_len) {
  4491. *p++ = alpn_len;
  4492. if (ssl->alpn_chosen != NULL) {
  4493. memcpy(p, ssl->alpn_chosen, alpn_len);
  4494. p += alpn_len;
  4495. }
  4496. }
  4497. }
  4498. #endif /* MBEDTLS_SSL_ALPN */
  4499. /*
  4500. * Done
  4501. */
  4502. *olen = used;
  4503. if (used > buf_len) {
  4504. return MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL;
  4505. }
  4506. MBEDTLS_SSL_DEBUG_BUF(4, "saved context", buf, used);
  4507. return mbedtls_ssl_session_reset_int(ssl, 0);
  4508. }
  4509. /*
  4510. * Deserialize context, see mbedtls_ssl_context_save() for format.
  4511. *
  4512. * This internal version is wrapped by a public function that cleans up in
  4513. * case of error.
  4514. */
  4515. MBEDTLS_CHECK_RETURN_CRITICAL
  4516. static int ssl_context_load(mbedtls_ssl_context *ssl,
  4517. const unsigned char *buf,
  4518. size_t len)
  4519. {
  4520. const unsigned char *p = buf;
  4521. const unsigned char * const end = buf + len;
  4522. size_t session_len;
  4523. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  4524. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  4525. tls_prf_fn prf_func = NULL;
  4526. #endif
  4527. /*
  4528. * The context should have been freshly setup or reset.
  4529. * Give the user an error in case of obvious misuse.
  4530. * (Checking session is useful because it won't be NULL if we're
  4531. * renegotiating, or if the user mistakenly loaded a session first.)
  4532. */
  4533. if (ssl->state != MBEDTLS_SSL_HELLO_REQUEST ||
  4534. ssl->session != NULL) {
  4535. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4536. }
  4537. /*
  4538. * We can't check that the config matches the initial one, but we can at
  4539. * least check it matches the requirements for serializing.
  4540. */
  4541. if (
  4542. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  4543. ssl->conf->disable_renegotiation != MBEDTLS_SSL_RENEGOTIATION_DISABLED ||
  4544. #endif
  4545. ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM ||
  4546. ssl->conf->max_tls_version < MBEDTLS_SSL_VERSION_TLS1_2 ||
  4547. ssl->conf->min_tls_version > MBEDTLS_SSL_VERSION_TLS1_2
  4548. ) {
  4549. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4550. }
  4551. MBEDTLS_SSL_DEBUG_BUF(4, "context to load", buf, len);
  4552. /*
  4553. * Check version identifier
  4554. */
  4555. if ((size_t) (end - p) < sizeof(ssl_serialized_context_header)) {
  4556. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4557. }
  4558. if (memcmp(p, ssl_serialized_context_header,
  4559. sizeof(ssl_serialized_context_header)) != 0) {
  4560. return MBEDTLS_ERR_SSL_VERSION_MISMATCH;
  4561. }
  4562. p += sizeof(ssl_serialized_context_header);
  4563. /*
  4564. * Session
  4565. */
  4566. if ((size_t) (end - p) < 4) {
  4567. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4568. }
  4569. session_len = MBEDTLS_GET_UINT32_BE(p, 0);
  4570. p += 4;
  4571. /* This has been allocated by ssl_handshake_init(), called by
  4572. * by either mbedtls_ssl_session_reset_int() or mbedtls_ssl_setup(). */
  4573. ssl->session = ssl->session_negotiate;
  4574. ssl->session_in = ssl->session;
  4575. ssl->session_out = ssl->session;
  4576. ssl->session_negotiate = NULL;
  4577. if ((size_t) (end - p) < session_len) {
  4578. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4579. }
  4580. ret = ssl_session_load(ssl->session, 1, p, session_len);
  4581. if (ret != 0) {
  4582. mbedtls_ssl_session_free(ssl->session);
  4583. return ret;
  4584. }
  4585. p += session_len;
  4586. /*
  4587. * Transform
  4588. */
  4589. /* This has been allocated by ssl_handshake_init(), called by
  4590. * by either mbedtls_ssl_session_reset_int() or mbedtls_ssl_setup(). */
  4591. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  4592. ssl->transform = ssl->transform_negotiate;
  4593. ssl->transform_in = ssl->transform;
  4594. ssl->transform_out = ssl->transform;
  4595. ssl->transform_negotiate = NULL;
  4596. #endif
  4597. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  4598. prf_func = ssl_tls12prf_from_cs(ssl->session->ciphersuite);
  4599. if (prf_func == NULL) {
  4600. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4601. }
  4602. /* Read random bytes and populate structure */
  4603. if ((size_t) (end - p) < sizeof(ssl->transform->randbytes)) {
  4604. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4605. }
  4606. ret = ssl_tls12_populate_transform(ssl->transform,
  4607. ssl->session->ciphersuite,
  4608. ssl->session->master,
  4609. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  4610. ssl->session->encrypt_then_mac,
  4611. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
  4612. prf_func,
  4613. p, /* currently pointing to randbytes */
  4614. MBEDTLS_SSL_VERSION_TLS1_2, /* (D)TLS 1.2 is forced */
  4615. ssl->conf->endpoint,
  4616. ssl);
  4617. if (ret != 0) {
  4618. return ret;
  4619. }
  4620. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  4621. p += sizeof(ssl->transform->randbytes);
  4622. #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
  4623. /* Read connection IDs and store them */
  4624. if ((size_t) (end - p) < 1) {
  4625. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4626. }
  4627. ssl->transform->in_cid_len = *p++;
  4628. if ((size_t) (end - p) < ssl->transform->in_cid_len + 1u) {
  4629. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4630. }
  4631. memcpy(ssl->transform->in_cid, p, ssl->transform->in_cid_len);
  4632. p += ssl->transform->in_cid_len;
  4633. ssl->transform->out_cid_len = *p++;
  4634. if ((size_t) (end - p) < ssl->transform->out_cid_len) {
  4635. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4636. }
  4637. memcpy(ssl->transform->out_cid, p, ssl->transform->out_cid_len);
  4638. p += ssl->transform->out_cid_len;
  4639. #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
  4640. /*
  4641. * Saved fields from top-level ssl_context structure
  4642. */
  4643. if ((size_t) (end - p) < 4) {
  4644. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4645. }
  4646. ssl->badmac_seen_or_in_hsfraglen = MBEDTLS_GET_UINT32_BE(p, 0);
  4647. p += 4;
  4648. #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
  4649. if ((size_t) (end - p) < 16) {
  4650. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4651. }
  4652. ssl->in_window_top = MBEDTLS_GET_UINT64_BE(p, 0);
  4653. p += 8;
  4654. ssl->in_window = MBEDTLS_GET_UINT64_BE(p, 0);
  4655. p += 8;
  4656. #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
  4657. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  4658. if ((size_t) (end - p) < 1) {
  4659. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4660. }
  4661. ssl->disable_datagram_packing = *p++;
  4662. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  4663. if ((size_t) (end - p) < sizeof(ssl->cur_out_ctr)) {
  4664. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4665. }
  4666. memcpy(ssl->cur_out_ctr, p, sizeof(ssl->cur_out_ctr));
  4667. p += sizeof(ssl->cur_out_ctr);
  4668. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  4669. if ((size_t) (end - p) < 2) {
  4670. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4671. }
  4672. ssl->mtu = MBEDTLS_GET_UINT16_BE(p, 0);
  4673. p += 2;
  4674. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  4675. #if defined(MBEDTLS_SSL_ALPN)
  4676. {
  4677. uint8_t alpn_len;
  4678. const char **cur;
  4679. if ((size_t) (end - p) < 1) {
  4680. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4681. }
  4682. alpn_len = *p++;
  4683. if (alpn_len != 0 && ssl->conf->alpn_list != NULL) {
  4684. /* alpn_chosen should point to an item in the configured list */
  4685. for (cur = ssl->conf->alpn_list; *cur != NULL; cur++) {
  4686. if (strlen(*cur) == alpn_len &&
  4687. memcmp(p, *cur, alpn_len) == 0) {
  4688. ssl->alpn_chosen = *cur;
  4689. break;
  4690. }
  4691. }
  4692. }
  4693. /* can only happen on conf mismatch */
  4694. if (alpn_len != 0 && ssl->alpn_chosen == NULL) {
  4695. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4696. }
  4697. p += alpn_len;
  4698. }
  4699. #endif /* MBEDTLS_SSL_ALPN */
  4700. /*
  4701. * Forced fields from top-level ssl_context structure
  4702. *
  4703. * Most of them already set to the correct value by mbedtls_ssl_init() and
  4704. * mbedtls_ssl_reset(), so we only need to set the remaining ones.
  4705. */
  4706. ssl->state = MBEDTLS_SSL_HANDSHAKE_OVER;
  4707. ssl->tls_version = MBEDTLS_SSL_VERSION_TLS1_2;
  4708. /* Adjust pointers for header fields of outgoing records to
  4709. * the given transform, accounting for explicit IV and CID. */
  4710. mbedtls_ssl_update_out_pointers(ssl, ssl->transform);
  4711. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  4712. ssl->in_epoch = 1;
  4713. #endif
  4714. /* mbedtls_ssl_reset() leaves the handshake sub-structure allocated,
  4715. * which we don't want - otherwise we'd end up freeing the wrong transform
  4716. * by calling mbedtls_ssl_handshake_wrapup_free_hs_transform()
  4717. * inappropriately. */
  4718. if (ssl->handshake != NULL) {
  4719. mbedtls_ssl_handshake_free(ssl);
  4720. mbedtls_free(ssl->handshake);
  4721. ssl->handshake = NULL;
  4722. }
  4723. /*
  4724. * Done - should have consumed entire buffer
  4725. */
  4726. if (p != end) {
  4727. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  4728. }
  4729. return 0;
  4730. }
  4731. /*
  4732. * Deserialize context: public wrapper for error cleaning
  4733. */
  4734. int mbedtls_ssl_context_load(mbedtls_ssl_context *context,
  4735. const unsigned char *buf,
  4736. size_t len)
  4737. {
  4738. int ret = ssl_context_load(context, buf, len);
  4739. if (ret != 0) {
  4740. mbedtls_ssl_free(context);
  4741. }
  4742. return ret;
  4743. }
  4744. #endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
  4745. /*
  4746. * Free an SSL context
  4747. */
  4748. void mbedtls_ssl_free(mbedtls_ssl_context *ssl)
  4749. {
  4750. if (ssl == NULL) {
  4751. return;
  4752. }
  4753. MBEDTLS_SSL_DEBUG_MSG(2, ("=> free"));
  4754. if (ssl->out_buf != NULL) {
  4755. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  4756. size_t out_buf_len = ssl->out_buf_len;
  4757. #else
  4758. size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
  4759. #endif
  4760. mbedtls_zeroize_and_free(ssl->out_buf, out_buf_len);
  4761. ssl->out_buf = NULL;
  4762. }
  4763. if (ssl->in_buf != NULL) {
  4764. #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
  4765. size_t in_buf_len = ssl->in_buf_len;
  4766. #else
  4767. size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
  4768. #endif
  4769. mbedtls_zeroize_and_free(ssl->in_buf, in_buf_len);
  4770. ssl->in_buf = NULL;
  4771. }
  4772. if (ssl->transform) {
  4773. mbedtls_ssl_transform_free(ssl->transform);
  4774. mbedtls_free(ssl->transform);
  4775. }
  4776. if (ssl->handshake) {
  4777. mbedtls_ssl_handshake_free(ssl);
  4778. mbedtls_free(ssl->handshake);
  4779. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  4780. mbedtls_ssl_transform_free(ssl->transform_negotiate);
  4781. mbedtls_free(ssl->transform_negotiate);
  4782. #endif
  4783. mbedtls_ssl_session_free(ssl->session_negotiate);
  4784. mbedtls_free(ssl->session_negotiate);
  4785. }
  4786. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  4787. mbedtls_ssl_transform_free(ssl->transform_application);
  4788. mbedtls_free(ssl->transform_application);
  4789. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  4790. if (ssl->session) {
  4791. mbedtls_ssl_session_free(ssl->session);
  4792. mbedtls_free(ssl->session);
  4793. }
  4794. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  4795. if (ssl->hostname != NULL) {
  4796. mbedtls_zeroize_and_free(ssl->hostname, strlen(ssl->hostname));
  4797. }
  4798. #endif
  4799. #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
  4800. mbedtls_free(ssl->cli_id);
  4801. #endif
  4802. MBEDTLS_SSL_DEBUG_MSG(2, ("<= free"));
  4803. /* Actually clear after last debug message */
  4804. mbedtls_platform_zeroize(ssl, sizeof(mbedtls_ssl_context));
  4805. }
  4806. /*
  4807. * Initialize mbedtls_ssl_config
  4808. */
  4809. void mbedtls_ssl_config_init(mbedtls_ssl_config *conf)
  4810. {
  4811. memset(conf, 0, sizeof(mbedtls_ssl_config));
  4812. }
  4813. /* The selection should be the same as mbedtls_x509_crt_profile_default in
  4814. * x509_crt.c, plus Montgomery curves for ECDHE. Here, the order matters:
  4815. * curves with a lower resource usage come first.
  4816. * See the documentation of mbedtls_ssl_conf_curves() for what we promise
  4817. * about this list.
  4818. */
  4819. static const uint16_t ssl_preset_default_groups[] = {
  4820. #if defined(MBEDTLS_ECP_HAVE_CURVE25519)
  4821. MBEDTLS_SSL_IANA_TLS_GROUP_X25519,
  4822. #endif
  4823. #if defined(MBEDTLS_ECP_HAVE_SECP256R1)
  4824. MBEDTLS_SSL_IANA_TLS_GROUP_SECP256R1,
  4825. #endif
  4826. #if defined(MBEDTLS_ECP_HAVE_SECP384R1)
  4827. MBEDTLS_SSL_IANA_TLS_GROUP_SECP384R1,
  4828. #endif
  4829. #if defined(MBEDTLS_ECP_HAVE_CURVE448)
  4830. MBEDTLS_SSL_IANA_TLS_GROUP_X448,
  4831. #endif
  4832. #if defined(MBEDTLS_ECP_HAVE_SECP521R1)
  4833. MBEDTLS_SSL_IANA_TLS_GROUP_SECP521R1,
  4834. #endif
  4835. #if defined(MBEDTLS_ECP_HAVE_BP256R1)
  4836. MBEDTLS_SSL_IANA_TLS_GROUP_BP256R1,
  4837. #endif
  4838. #if defined(MBEDTLS_ECP_HAVE_BP384R1)
  4839. MBEDTLS_SSL_IANA_TLS_GROUP_BP384R1,
  4840. #endif
  4841. #if defined(MBEDTLS_ECP_HAVE_BP512R1)
  4842. MBEDTLS_SSL_IANA_TLS_GROUP_BP512R1,
  4843. #endif
  4844. #if defined(PSA_WANT_ALG_FFDH)
  4845. MBEDTLS_SSL_IANA_TLS_GROUP_FFDHE2048,
  4846. MBEDTLS_SSL_IANA_TLS_GROUP_FFDHE3072,
  4847. MBEDTLS_SSL_IANA_TLS_GROUP_FFDHE4096,
  4848. MBEDTLS_SSL_IANA_TLS_GROUP_FFDHE6144,
  4849. MBEDTLS_SSL_IANA_TLS_GROUP_FFDHE8192,
  4850. #endif
  4851. MBEDTLS_SSL_IANA_TLS_GROUP_NONE
  4852. };
  4853. static const int ssl_preset_suiteb_ciphersuites[] = {
  4854. MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
  4855. MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
  4856. 0
  4857. };
  4858. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  4859. /* NOTICE:
  4860. * For ssl_preset_*_sig_algs and ssl_tls12_preset_*_sig_algs, the following
  4861. * rules SHOULD be upheld.
  4862. * - No duplicate entries.
  4863. * - But if there is a good reason, do not change the order of the algorithms.
  4864. * - ssl_tls12_preset* is for TLS 1.2 use only.
  4865. * - ssl_preset_* is for TLS 1.3 only or hybrid TLS 1.3/1.2 handshakes.
  4866. */
  4867. static const uint16_t ssl_preset_default_sig_algs[] = {
  4868. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED) && \
  4869. defined(MBEDTLS_MD_CAN_SHA256) && \
  4870. defined(PSA_WANT_ECC_SECP_R1_256)
  4871. MBEDTLS_TLS1_3_SIG_ECDSA_SECP256R1_SHA256,
  4872. // == MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA256)
  4873. #endif
  4874. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED) && \
  4875. defined(MBEDTLS_MD_CAN_SHA384) && \
  4876. defined(PSA_WANT_ECC_SECP_R1_384)
  4877. MBEDTLS_TLS1_3_SIG_ECDSA_SECP384R1_SHA384,
  4878. // == MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA384)
  4879. #endif
  4880. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED) && \
  4881. defined(MBEDTLS_MD_CAN_SHA512) && \
  4882. defined(PSA_WANT_ECC_SECP_R1_521)
  4883. MBEDTLS_TLS1_3_SIG_ECDSA_SECP521R1_SHA512,
  4884. // == MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA512)
  4885. #endif
  4886. #if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT) && defined(MBEDTLS_MD_CAN_SHA512)
  4887. MBEDTLS_TLS1_3_SIG_RSA_PSS_RSAE_SHA512,
  4888. #endif
  4889. #if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT) && defined(MBEDTLS_MD_CAN_SHA384)
  4890. MBEDTLS_TLS1_3_SIG_RSA_PSS_RSAE_SHA384,
  4891. #endif
  4892. #if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT) && defined(MBEDTLS_MD_CAN_SHA256)
  4893. MBEDTLS_TLS1_3_SIG_RSA_PSS_RSAE_SHA256,
  4894. #endif
  4895. #if defined(MBEDTLS_RSA_C) && defined(MBEDTLS_MD_CAN_SHA512)
  4896. MBEDTLS_TLS1_3_SIG_RSA_PKCS1_SHA512,
  4897. #endif /* MBEDTLS_RSA_C && MBEDTLS_MD_CAN_SHA512 */
  4898. #if defined(MBEDTLS_RSA_C) && defined(MBEDTLS_MD_CAN_SHA384)
  4899. MBEDTLS_TLS1_3_SIG_RSA_PKCS1_SHA384,
  4900. #endif /* MBEDTLS_RSA_C && MBEDTLS_MD_CAN_SHA384 */
  4901. #if defined(MBEDTLS_RSA_C) && defined(MBEDTLS_MD_CAN_SHA256)
  4902. MBEDTLS_TLS1_3_SIG_RSA_PKCS1_SHA256,
  4903. #endif /* MBEDTLS_RSA_C && MBEDTLS_MD_CAN_SHA256 */
  4904. MBEDTLS_TLS_SIG_NONE
  4905. };
  4906. /* NOTICE: see above */
  4907. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  4908. static uint16_t ssl_tls12_preset_default_sig_algs[] = {
  4909. #if defined(MBEDTLS_MD_CAN_SHA512)
  4910. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
  4911. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA512),
  4912. #endif
  4913. #if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT)
  4914. MBEDTLS_TLS1_3_SIG_RSA_PSS_RSAE_SHA512,
  4915. #endif
  4916. #if defined(MBEDTLS_RSA_C)
  4917. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_RSA, MBEDTLS_SSL_HASH_SHA512),
  4918. #endif
  4919. #endif /* MBEDTLS_MD_CAN_SHA512 */
  4920. #if defined(MBEDTLS_MD_CAN_SHA384)
  4921. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
  4922. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA384),
  4923. #endif
  4924. #if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT)
  4925. MBEDTLS_TLS1_3_SIG_RSA_PSS_RSAE_SHA384,
  4926. #endif
  4927. #if defined(MBEDTLS_RSA_C)
  4928. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_RSA, MBEDTLS_SSL_HASH_SHA384),
  4929. #endif
  4930. #endif /* MBEDTLS_MD_CAN_SHA384 */
  4931. #if defined(MBEDTLS_MD_CAN_SHA256)
  4932. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
  4933. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA256),
  4934. #endif
  4935. #if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT)
  4936. MBEDTLS_TLS1_3_SIG_RSA_PSS_RSAE_SHA256,
  4937. #endif
  4938. #if defined(MBEDTLS_RSA_C)
  4939. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_RSA, MBEDTLS_SSL_HASH_SHA256),
  4940. #endif
  4941. #endif /* MBEDTLS_MD_CAN_SHA256 */
  4942. MBEDTLS_TLS_SIG_NONE
  4943. };
  4944. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  4945. /* NOTICE: see above */
  4946. static const uint16_t ssl_preset_suiteb_sig_algs[] = {
  4947. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED) && \
  4948. defined(MBEDTLS_MD_CAN_SHA256) && \
  4949. defined(MBEDTLS_ECP_HAVE_SECP256R1)
  4950. MBEDTLS_TLS1_3_SIG_ECDSA_SECP256R1_SHA256,
  4951. // == MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA256)
  4952. #endif
  4953. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED) && \
  4954. defined(MBEDTLS_MD_CAN_SHA384) && \
  4955. defined(MBEDTLS_ECP_HAVE_SECP384R1)
  4956. MBEDTLS_TLS1_3_SIG_ECDSA_SECP384R1_SHA384,
  4957. // == MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA384)
  4958. #endif
  4959. MBEDTLS_TLS_SIG_NONE
  4960. };
  4961. /* NOTICE: see above */
  4962. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  4963. static uint16_t ssl_tls12_preset_suiteb_sig_algs[] = {
  4964. #if defined(MBEDTLS_MD_CAN_SHA256)
  4965. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
  4966. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA256),
  4967. #endif
  4968. #endif /* MBEDTLS_MD_CAN_SHA256 */
  4969. #if defined(MBEDTLS_MD_CAN_SHA384)
  4970. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
  4971. MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA, MBEDTLS_SSL_HASH_SHA384),
  4972. #endif
  4973. #endif /* MBEDTLS_MD_CAN_SHA384 */
  4974. MBEDTLS_TLS_SIG_NONE
  4975. };
  4976. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  4977. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  4978. static const uint16_t ssl_preset_suiteb_groups[] = {
  4979. #if defined(MBEDTLS_ECP_HAVE_SECP256R1)
  4980. MBEDTLS_SSL_IANA_TLS_GROUP_SECP256R1,
  4981. #endif
  4982. #if defined(MBEDTLS_ECP_HAVE_SECP384R1)
  4983. MBEDTLS_SSL_IANA_TLS_GROUP_SECP384R1,
  4984. #endif
  4985. MBEDTLS_SSL_IANA_TLS_GROUP_NONE
  4986. };
  4987. #if defined(MBEDTLS_DEBUG_C) && defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  4988. /* Function for checking `ssl_preset_*_sig_algs` and `ssl_tls12_preset_*_sig_algs`
  4989. * to make sure there are no duplicated signature algorithm entries. */
  4990. MBEDTLS_CHECK_RETURN_CRITICAL
  4991. static int ssl_check_no_sig_alg_duplication(const uint16_t *sig_algs)
  4992. {
  4993. size_t i, j;
  4994. int ret = 0;
  4995. for (i = 0; sig_algs[i] != MBEDTLS_TLS_SIG_NONE; i++) {
  4996. for (j = 0; j < i; j++) {
  4997. if (sig_algs[i] != sig_algs[j]) {
  4998. continue;
  4999. }
  5000. mbedtls_printf(" entry(%04x,%" MBEDTLS_PRINTF_SIZET
  5001. ") is duplicated at %" MBEDTLS_PRINTF_SIZET "\n",
  5002. sig_algs[i], j, i);
  5003. ret = -1;
  5004. }
  5005. }
  5006. return ret;
  5007. }
  5008. #endif /* MBEDTLS_DEBUG_C && MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  5009. /*
  5010. * Load default in mbedtls_ssl_config
  5011. */
  5012. int mbedtls_ssl_config_defaults(mbedtls_ssl_config *conf,
  5013. int endpoint, int transport, int preset)
  5014. {
  5015. #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
  5016. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  5017. #endif
  5018. #if defined(MBEDTLS_DEBUG_C) && defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  5019. if (ssl_check_no_sig_alg_duplication(ssl_preset_suiteb_sig_algs)) {
  5020. mbedtls_printf("ssl_preset_suiteb_sig_algs has duplicated entries\n");
  5021. return MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  5022. }
  5023. if (ssl_check_no_sig_alg_duplication(ssl_preset_default_sig_algs)) {
  5024. mbedtls_printf("ssl_preset_default_sig_algs has duplicated entries\n");
  5025. return MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  5026. }
  5027. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  5028. if (ssl_check_no_sig_alg_duplication(ssl_tls12_preset_suiteb_sig_algs)) {
  5029. mbedtls_printf("ssl_tls12_preset_suiteb_sig_algs has duplicated entries\n");
  5030. return MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  5031. }
  5032. if (ssl_check_no_sig_alg_duplication(ssl_tls12_preset_default_sig_algs)) {
  5033. mbedtls_printf("ssl_tls12_preset_default_sig_algs has duplicated entries\n");
  5034. return MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  5035. }
  5036. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  5037. #endif /* MBEDTLS_DEBUG_C && MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  5038. /* Use the functions here so that they are covered in tests,
  5039. * but otherwise access member directly for efficiency */
  5040. mbedtls_ssl_conf_endpoint(conf, endpoint);
  5041. mbedtls_ssl_conf_transport(conf, transport);
  5042. /*
  5043. * Things that are common to all presets
  5044. */
  5045. #if defined(MBEDTLS_SSL_CLI_C)
  5046. if (endpoint == MBEDTLS_SSL_IS_CLIENT) {
  5047. conf->authmode = MBEDTLS_SSL_VERIFY_REQUIRED;
  5048. #if defined(MBEDTLS_SSL_SESSION_TICKETS)
  5049. mbedtls_ssl_conf_session_tickets(conf, MBEDTLS_SSL_SESSION_TICKETS_ENABLED);
  5050. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  5051. /* Contrary to TLS 1.2 tickets, TLS 1.3 NewSessionTicket message
  5052. * handling is disabled by default in Mbed TLS 3.6.x for backward
  5053. * compatibility with client applications developed using Mbed TLS 3.5
  5054. * or earlier with the default configuration.
  5055. *
  5056. * Up to Mbed TLS 3.5, in the default configuration TLS 1.3 was
  5057. * disabled, and a Mbed TLS client with the default configuration would
  5058. * establish a TLS 1.2 connection with a TLS 1.2 and TLS 1.3 capable
  5059. * server.
  5060. *
  5061. * Starting with Mbed TLS 3.6.0, TLS 1.3 is enabled by default, and thus
  5062. * an Mbed TLS client with the default configuration establishes a
  5063. * TLS 1.3 connection with a TLS 1.2 and TLS 1.3 capable server. If
  5064. * following the handshake the TLS 1.3 server sends NewSessionTicket
  5065. * messages and the Mbed TLS client processes them, this results in
  5066. * Mbed TLS high level APIs (mbedtls_ssl_read(),
  5067. * mbedtls_ssl_handshake(), ...) to eventually return an
  5068. * #MBEDTLS_ERR_SSL_RECEIVED_NEW_SESSION_TICKET non fatal error code
  5069. * (see the documentation of mbedtls_ssl_read() for more information on
  5070. * that error code). Applications unaware of that TLS 1.3 specific non
  5071. * fatal error code are then failing.
  5072. */
  5073. mbedtls_ssl_conf_tls13_enable_signal_new_session_tickets(
  5074. conf, MBEDTLS_SSL_TLS1_3_SIGNAL_NEW_SESSION_TICKETS_DISABLED);
  5075. #endif
  5076. #endif
  5077. }
  5078. #endif
  5079. #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  5080. conf->encrypt_then_mac = MBEDTLS_SSL_ETM_ENABLED;
  5081. #endif
  5082. #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
  5083. conf->extended_ms = MBEDTLS_SSL_EXTENDED_MS_ENABLED;
  5084. #endif
  5085. #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
  5086. conf->f_cookie_write = ssl_cookie_write_dummy;
  5087. conf->f_cookie_check = ssl_cookie_check_dummy;
  5088. #endif
  5089. #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
  5090. conf->anti_replay = MBEDTLS_SSL_ANTI_REPLAY_ENABLED;
  5091. #endif
  5092. #if defined(MBEDTLS_SSL_SRV_C)
  5093. conf->cert_req_ca_list = MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED;
  5094. conf->respect_cli_pref = MBEDTLS_SSL_SRV_CIPHERSUITE_ORDER_SERVER;
  5095. #endif
  5096. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  5097. conf->hs_timeout_min = MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN;
  5098. conf->hs_timeout_max = MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX;
  5099. #endif
  5100. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  5101. conf->renego_max_records = MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT;
  5102. memset(conf->renego_period, 0x00, 2);
  5103. memset(conf->renego_period + 2, 0xFF, 6);
  5104. #endif
  5105. #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
  5106. if (endpoint == MBEDTLS_SSL_IS_SERVER) {
  5107. const unsigned char dhm_p[] =
  5108. MBEDTLS_DHM_RFC3526_MODP_2048_P_BIN;
  5109. const unsigned char dhm_g[] =
  5110. MBEDTLS_DHM_RFC3526_MODP_2048_G_BIN;
  5111. if ((ret = mbedtls_ssl_conf_dh_param_bin(conf,
  5112. dhm_p, sizeof(dhm_p),
  5113. dhm_g, sizeof(dhm_g))) != 0) {
  5114. return ret;
  5115. }
  5116. }
  5117. #endif
  5118. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  5119. #if defined(MBEDTLS_SSL_EARLY_DATA)
  5120. mbedtls_ssl_conf_early_data(conf, MBEDTLS_SSL_EARLY_DATA_DISABLED);
  5121. #if defined(MBEDTLS_SSL_SRV_C)
  5122. mbedtls_ssl_conf_max_early_data_size(conf, MBEDTLS_SSL_MAX_EARLY_DATA_SIZE);
  5123. #endif
  5124. #endif /* MBEDTLS_SSL_EARLY_DATA */
  5125. #if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_SESSION_TICKETS)
  5126. mbedtls_ssl_conf_new_session_tickets(
  5127. conf, MBEDTLS_SSL_TLS1_3_DEFAULT_NEW_SESSION_TICKETS);
  5128. #endif
  5129. /*
  5130. * Allow all TLS 1.3 key exchange modes by default.
  5131. */
  5132. conf->tls13_kex_modes = MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_ALL;
  5133. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  5134. if (transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  5135. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  5136. conf->min_tls_version = MBEDTLS_SSL_VERSION_TLS1_2;
  5137. conf->max_tls_version = MBEDTLS_SSL_VERSION_TLS1_2;
  5138. #else
  5139. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  5140. #endif
  5141. } else {
  5142. #if defined(MBEDTLS_SSL_PROTO_TLS1_2) && defined(MBEDTLS_SSL_PROTO_TLS1_3)
  5143. conf->min_tls_version = MBEDTLS_SSL_VERSION_TLS1_2;
  5144. conf->max_tls_version = MBEDTLS_SSL_VERSION_TLS1_3;
  5145. #elif defined(MBEDTLS_SSL_PROTO_TLS1_3)
  5146. conf->min_tls_version = MBEDTLS_SSL_VERSION_TLS1_3;
  5147. conf->max_tls_version = MBEDTLS_SSL_VERSION_TLS1_3;
  5148. #elif defined(MBEDTLS_SSL_PROTO_TLS1_2)
  5149. conf->min_tls_version = MBEDTLS_SSL_VERSION_TLS1_2;
  5150. conf->max_tls_version = MBEDTLS_SSL_VERSION_TLS1_2;
  5151. #else
  5152. return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  5153. #endif
  5154. }
  5155. /*
  5156. * Preset-specific defaults
  5157. */
  5158. switch (preset) {
  5159. /*
  5160. * NSA Suite B
  5161. */
  5162. case MBEDTLS_SSL_PRESET_SUITEB:
  5163. conf->ciphersuite_list = ssl_preset_suiteb_ciphersuites;
  5164. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  5165. conf->cert_profile = &mbedtls_x509_crt_profile_suiteb;
  5166. #endif
  5167. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  5168. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  5169. if (mbedtls_ssl_conf_is_tls12_only(conf)) {
  5170. conf->sig_algs = ssl_tls12_preset_suiteb_sig_algs;
  5171. } else
  5172. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  5173. conf->sig_algs = ssl_preset_suiteb_sig_algs;
  5174. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  5175. #if defined(MBEDTLS_ECP_C) && !defined(MBEDTLS_DEPRECATED_REMOVED)
  5176. conf->curve_list = NULL;
  5177. #endif
  5178. conf->group_list = ssl_preset_suiteb_groups;
  5179. break;
  5180. /*
  5181. * Default
  5182. */
  5183. default:
  5184. conf->ciphersuite_list = mbedtls_ssl_list_ciphersuites();
  5185. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  5186. conf->cert_profile = &mbedtls_x509_crt_profile_default;
  5187. #endif
  5188. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  5189. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  5190. if (mbedtls_ssl_conf_is_tls12_only(conf)) {
  5191. conf->sig_algs = ssl_tls12_preset_default_sig_algs;
  5192. } else
  5193. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  5194. conf->sig_algs = ssl_preset_default_sig_algs;
  5195. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  5196. #if defined(MBEDTLS_ECP_C) && !defined(MBEDTLS_DEPRECATED_REMOVED)
  5197. conf->curve_list = NULL;
  5198. #endif
  5199. conf->group_list = ssl_preset_default_groups;
  5200. #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
  5201. conf->dhm_min_bitlen = 1024;
  5202. #endif
  5203. }
  5204. return 0;
  5205. }
  5206. /*
  5207. * Free mbedtls_ssl_config
  5208. */
  5209. void mbedtls_ssl_config_free(mbedtls_ssl_config *conf)
  5210. {
  5211. if (conf == NULL) {
  5212. return;
  5213. }
  5214. #if defined(MBEDTLS_DHM_C)
  5215. mbedtls_mpi_free(&conf->dhm_P);
  5216. mbedtls_mpi_free(&conf->dhm_G);
  5217. #endif
  5218. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_PSK_ENABLED)
  5219. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  5220. if (!mbedtls_svc_key_id_is_null(conf->psk_opaque)) {
  5221. conf->psk_opaque = MBEDTLS_SVC_KEY_ID_INIT;
  5222. }
  5223. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  5224. if (conf->psk != NULL) {
  5225. mbedtls_zeroize_and_free(conf->psk, conf->psk_len);
  5226. conf->psk = NULL;
  5227. conf->psk_len = 0;
  5228. }
  5229. if (conf->psk_identity != NULL) {
  5230. mbedtls_zeroize_and_free(conf->psk_identity, conf->psk_identity_len);
  5231. conf->psk_identity = NULL;
  5232. conf->psk_identity_len = 0;
  5233. }
  5234. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_PSK_ENABLED */
  5235. #if defined(MBEDTLS_X509_CRT_PARSE_C)
  5236. ssl_key_cert_free(conf->key_cert);
  5237. #endif
  5238. mbedtls_platform_zeroize(conf, sizeof(mbedtls_ssl_config));
  5239. }
  5240. #if defined(MBEDTLS_PK_C) && \
  5241. (defined(MBEDTLS_RSA_C) || defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED))
  5242. /*
  5243. * Convert between MBEDTLS_PK_XXX and SSL_SIG_XXX
  5244. */
  5245. unsigned char mbedtls_ssl_sig_from_pk(mbedtls_pk_context *pk)
  5246. {
  5247. #if defined(MBEDTLS_RSA_C)
  5248. if (mbedtls_pk_can_do(pk, MBEDTLS_PK_RSA)) {
  5249. return MBEDTLS_SSL_SIG_RSA;
  5250. }
  5251. #endif
  5252. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED)
  5253. if (mbedtls_pk_can_do(pk, MBEDTLS_PK_ECDSA)) {
  5254. return MBEDTLS_SSL_SIG_ECDSA;
  5255. }
  5256. #endif
  5257. return MBEDTLS_SSL_SIG_ANON;
  5258. }
  5259. unsigned char mbedtls_ssl_sig_from_pk_alg(mbedtls_pk_type_t type)
  5260. {
  5261. switch (type) {
  5262. case MBEDTLS_PK_RSA:
  5263. return MBEDTLS_SSL_SIG_RSA;
  5264. case MBEDTLS_PK_ECDSA:
  5265. case MBEDTLS_PK_ECKEY:
  5266. return MBEDTLS_SSL_SIG_ECDSA;
  5267. default:
  5268. return MBEDTLS_SSL_SIG_ANON;
  5269. }
  5270. }
  5271. mbedtls_pk_type_t mbedtls_ssl_pk_alg_from_sig(unsigned char sig)
  5272. {
  5273. switch (sig) {
  5274. #if defined(MBEDTLS_RSA_C)
  5275. case MBEDTLS_SSL_SIG_RSA:
  5276. return MBEDTLS_PK_RSA;
  5277. #endif
  5278. #if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED)
  5279. case MBEDTLS_SSL_SIG_ECDSA:
  5280. return MBEDTLS_PK_ECDSA;
  5281. #endif
  5282. default:
  5283. return MBEDTLS_PK_NONE;
  5284. }
  5285. }
  5286. #endif /* MBEDTLS_PK_C &&
  5287. ( MBEDTLS_RSA_C || MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED ) */
  5288. /*
  5289. * Convert from MBEDTLS_SSL_HASH_XXX to MBEDTLS_MD_XXX
  5290. */
  5291. mbedtls_md_type_t mbedtls_ssl_md_alg_from_hash(unsigned char hash)
  5292. {
  5293. switch (hash) {
  5294. #if defined(MBEDTLS_MD_CAN_MD5)
  5295. case MBEDTLS_SSL_HASH_MD5:
  5296. return MBEDTLS_MD_MD5;
  5297. #endif
  5298. #if defined(MBEDTLS_MD_CAN_SHA1)
  5299. case MBEDTLS_SSL_HASH_SHA1:
  5300. return MBEDTLS_MD_SHA1;
  5301. #endif
  5302. #if defined(MBEDTLS_MD_CAN_SHA224)
  5303. case MBEDTLS_SSL_HASH_SHA224:
  5304. return MBEDTLS_MD_SHA224;
  5305. #endif
  5306. #if defined(MBEDTLS_MD_CAN_SHA256)
  5307. case MBEDTLS_SSL_HASH_SHA256:
  5308. return MBEDTLS_MD_SHA256;
  5309. #endif
  5310. #if defined(MBEDTLS_MD_CAN_SHA384)
  5311. case MBEDTLS_SSL_HASH_SHA384:
  5312. return MBEDTLS_MD_SHA384;
  5313. #endif
  5314. #if defined(MBEDTLS_MD_CAN_SHA512)
  5315. case MBEDTLS_SSL_HASH_SHA512:
  5316. return MBEDTLS_MD_SHA512;
  5317. #endif
  5318. default:
  5319. return MBEDTLS_MD_NONE;
  5320. }
  5321. }
  5322. /*
  5323. * Convert from MBEDTLS_MD_XXX to MBEDTLS_SSL_HASH_XXX
  5324. */
  5325. unsigned char mbedtls_ssl_hash_from_md_alg(int md)
  5326. {
  5327. switch (md) {
  5328. #if defined(MBEDTLS_MD_CAN_MD5)
  5329. case MBEDTLS_MD_MD5:
  5330. return MBEDTLS_SSL_HASH_MD5;
  5331. #endif
  5332. #if defined(MBEDTLS_MD_CAN_SHA1)
  5333. case MBEDTLS_MD_SHA1:
  5334. return MBEDTLS_SSL_HASH_SHA1;
  5335. #endif
  5336. #if defined(MBEDTLS_MD_CAN_SHA224)
  5337. case MBEDTLS_MD_SHA224:
  5338. return MBEDTLS_SSL_HASH_SHA224;
  5339. #endif
  5340. #if defined(MBEDTLS_MD_CAN_SHA256)
  5341. case MBEDTLS_MD_SHA256:
  5342. return MBEDTLS_SSL_HASH_SHA256;
  5343. #endif
  5344. #if defined(MBEDTLS_MD_CAN_SHA384)
  5345. case MBEDTLS_MD_SHA384:
  5346. return MBEDTLS_SSL_HASH_SHA384;
  5347. #endif
  5348. #if defined(MBEDTLS_MD_CAN_SHA512)
  5349. case MBEDTLS_MD_SHA512:
  5350. return MBEDTLS_SSL_HASH_SHA512;
  5351. #endif
  5352. default:
  5353. return MBEDTLS_SSL_HASH_NONE;
  5354. }
  5355. }
  5356. /*
  5357. * Check if a curve proposed by the peer is in our list.
  5358. * Return 0 if we're willing to use it, -1 otherwise.
  5359. */
  5360. int mbedtls_ssl_check_curve_tls_id(const mbedtls_ssl_context *ssl, uint16_t tls_id)
  5361. {
  5362. const uint16_t *group_list = mbedtls_ssl_get_groups(ssl);
  5363. if (group_list == NULL) {
  5364. return -1;
  5365. }
  5366. for (; *group_list != 0; group_list++) {
  5367. if (*group_list == tls_id) {
  5368. return 0;
  5369. }
  5370. }
  5371. return -1;
  5372. }
  5373. #if defined(MBEDTLS_PK_HAVE_ECC_KEYS)
  5374. /*
  5375. * Same as mbedtls_ssl_check_curve_tls_id() but with a mbedtls_ecp_group_id.
  5376. */
  5377. int mbedtls_ssl_check_curve(const mbedtls_ssl_context *ssl, mbedtls_ecp_group_id grp_id)
  5378. {
  5379. uint16_t tls_id = mbedtls_ssl_get_tls_id_from_ecp_group_id(grp_id);
  5380. if (tls_id == 0) {
  5381. return -1;
  5382. }
  5383. return mbedtls_ssl_check_curve_tls_id(ssl, tls_id);
  5384. }
  5385. #endif /* MBEDTLS_PK_HAVE_ECC_KEYS */
  5386. static const struct {
  5387. uint16_t tls_id;
  5388. mbedtls_ecp_group_id ecp_group_id;
  5389. psa_ecc_family_t psa_family;
  5390. uint16_t bits;
  5391. } tls_id_match_table[] =
  5392. {
  5393. #if defined(MBEDTLS_ECP_HAVE_SECP521R1)
  5394. { 25, MBEDTLS_ECP_DP_SECP521R1, PSA_ECC_FAMILY_SECP_R1, 521 },
  5395. #endif
  5396. #if defined(MBEDTLS_ECP_HAVE_BP512R1)
  5397. { 28, MBEDTLS_ECP_DP_BP512R1, PSA_ECC_FAMILY_BRAINPOOL_P_R1, 512 },
  5398. #endif
  5399. #if defined(MBEDTLS_ECP_HAVE_SECP384R1)
  5400. { 24, MBEDTLS_ECP_DP_SECP384R1, PSA_ECC_FAMILY_SECP_R1, 384 },
  5401. #endif
  5402. #if defined(MBEDTLS_ECP_HAVE_BP384R1)
  5403. { 27, MBEDTLS_ECP_DP_BP384R1, PSA_ECC_FAMILY_BRAINPOOL_P_R1, 384 },
  5404. #endif
  5405. #if defined(MBEDTLS_ECP_HAVE_SECP256R1)
  5406. { 23, MBEDTLS_ECP_DP_SECP256R1, PSA_ECC_FAMILY_SECP_R1, 256 },
  5407. #endif
  5408. #if defined(MBEDTLS_ECP_HAVE_SECP256K1)
  5409. { 22, MBEDTLS_ECP_DP_SECP256K1, PSA_ECC_FAMILY_SECP_K1, 256 },
  5410. #endif
  5411. #if defined(MBEDTLS_ECP_HAVE_BP256R1)
  5412. { 26, MBEDTLS_ECP_DP_BP256R1, PSA_ECC_FAMILY_BRAINPOOL_P_R1, 256 },
  5413. #endif
  5414. #if defined(MBEDTLS_ECP_HAVE_SECP224R1)
  5415. { 21, MBEDTLS_ECP_DP_SECP224R1, PSA_ECC_FAMILY_SECP_R1, 224 },
  5416. #endif
  5417. #if defined(MBEDTLS_ECP_HAVE_SECP224K1)
  5418. { 20, MBEDTLS_ECP_DP_SECP224K1, PSA_ECC_FAMILY_SECP_K1, 224 },
  5419. #endif
  5420. #if defined(MBEDTLS_ECP_HAVE_SECP192R1)
  5421. { 19, MBEDTLS_ECP_DP_SECP192R1, PSA_ECC_FAMILY_SECP_R1, 192 },
  5422. #endif
  5423. #if defined(MBEDTLS_ECP_HAVE_SECP192K1)
  5424. { 18, MBEDTLS_ECP_DP_SECP192K1, PSA_ECC_FAMILY_SECP_K1, 192 },
  5425. #endif
  5426. #if defined(MBEDTLS_ECP_HAVE_CURVE25519)
  5427. { 29, MBEDTLS_ECP_DP_CURVE25519, PSA_ECC_FAMILY_MONTGOMERY, 255 },
  5428. #endif
  5429. #if defined(MBEDTLS_ECP_HAVE_CURVE448)
  5430. { 30, MBEDTLS_ECP_DP_CURVE448, PSA_ECC_FAMILY_MONTGOMERY, 448 },
  5431. #endif
  5432. { 0, MBEDTLS_ECP_DP_NONE, 0, 0 },
  5433. };
  5434. int mbedtls_ssl_get_psa_curve_info_from_tls_id(uint16_t tls_id,
  5435. psa_key_type_t *type,
  5436. size_t *bits)
  5437. {
  5438. for (int i = 0; tls_id_match_table[i].tls_id != 0; i++) {
  5439. if (tls_id_match_table[i].tls_id == tls_id) {
  5440. if (type != NULL) {
  5441. *type = PSA_KEY_TYPE_ECC_KEY_PAIR(tls_id_match_table[i].psa_family);
  5442. }
  5443. if (bits != NULL) {
  5444. *bits = tls_id_match_table[i].bits;
  5445. }
  5446. return PSA_SUCCESS;
  5447. }
  5448. }
  5449. return PSA_ERROR_NOT_SUPPORTED;
  5450. }
  5451. mbedtls_ecp_group_id mbedtls_ssl_get_ecp_group_id_from_tls_id(uint16_t tls_id)
  5452. {
  5453. for (int i = 0; tls_id_match_table[i].tls_id != 0; i++) {
  5454. if (tls_id_match_table[i].tls_id == tls_id) {
  5455. return tls_id_match_table[i].ecp_group_id;
  5456. }
  5457. }
  5458. return MBEDTLS_ECP_DP_NONE;
  5459. }
  5460. uint16_t mbedtls_ssl_get_tls_id_from_ecp_group_id(mbedtls_ecp_group_id grp_id)
  5461. {
  5462. for (int i = 0; tls_id_match_table[i].ecp_group_id != MBEDTLS_ECP_DP_NONE;
  5463. i++) {
  5464. if (tls_id_match_table[i].ecp_group_id == grp_id) {
  5465. return tls_id_match_table[i].tls_id;
  5466. }
  5467. }
  5468. return 0;
  5469. }
  5470. #if defined(MBEDTLS_DEBUG_C)
  5471. static const struct {
  5472. uint16_t tls_id;
  5473. const char *name;
  5474. } tls_id_curve_name_table[] =
  5475. {
  5476. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP521R1, "secp521r1" },
  5477. { MBEDTLS_SSL_IANA_TLS_GROUP_BP512R1, "brainpoolP512r1" },
  5478. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP384R1, "secp384r1" },
  5479. { MBEDTLS_SSL_IANA_TLS_GROUP_BP384R1, "brainpoolP384r1" },
  5480. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP256R1, "secp256r1" },
  5481. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP256K1, "secp256k1" },
  5482. { MBEDTLS_SSL_IANA_TLS_GROUP_BP256R1, "brainpoolP256r1" },
  5483. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP224R1, "secp224r1" },
  5484. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP224K1, "secp224k1" },
  5485. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP192R1, "secp192r1" },
  5486. { MBEDTLS_SSL_IANA_TLS_GROUP_SECP192K1, "secp192k1" },
  5487. { MBEDTLS_SSL_IANA_TLS_GROUP_X25519, "x25519" },
  5488. { MBEDTLS_SSL_IANA_TLS_GROUP_X448, "x448" },
  5489. { 0, NULL },
  5490. };
  5491. const char *mbedtls_ssl_get_curve_name_from_tls_id(uint16_t tls_id)
  5492. {
  5493. for (int i = 0; tls_id_curve_name_table[i].tls_id != 0; i++) {
  5494. if (tls_id_curve_name_table[i].tls_id == tls_id) {
  5495. return tls_id_curve_name_table[i].name;
  5496. }
  5497. }
  5498. return NULL;
  5499. }
  5500. #endif
  5501. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  5502. int mbedtls_ssl_get_handshake_transcript(mbedtls_ssl_context *ssl,
  5503. const mbedtls_md_type_t md,
  5504. unsigned char *dst,
  5505. size_t dst_len,
  5506. size_t *olen)
  5507. {
  5508. psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
  5509. psa_hash_operation_t *hash_operation_to_clone;
  5510. psa_hash_operation_t hash_operation = psa_hash_operation_init();
  5511. *olen = 0;
  5512. switch (md) {
  5513. #if defined(MBEDTLS_MD_CAN_SHA384)
  5514. case MBEDTLS_MD_SHA384:
  5515. hash_operation_to_clone = &ssl->handshake->fin_sha384_psa;
  5516. break;
  5517. #endif
  5518. #if defined(MBEDTLS_MD_CAN_SHA256)
  5519. case MBEDTLS_MD_SHA256:
  5520. hash_operation_to_clone = &ssl->handshake->fin_sha256_psa;
  5521. break;
  5522. #endif
  5523. default:
  5524. goto exit;
  5525. }
  5526. status = psa_hash_clone(hash_operation_to_clone, &hash_operation);
  5527. if (status != PSA_SUCCESS) {
  5528. goto exit;
  5529. }
  5530. status = psa_hash_finish(&hash_operation, dst, dst_len, olen);
  5531. if (status != PSA_SUCCESS) {
  5532. goto exit;
  5533. }
  5534. exit:
  5535. #if !defined(MBEDTLS_MD_CAN_SHA384) && \
  5536. !defined(MBEDTLS_MD_CAN_SHA256)
  5537. (void) ssl;
  5538. #endif
  5539. return PSA_TO_MBEDTLS_ERR(status);
  5540. }
  5541. #else /* MBEDTLS_USE_PSA_CRYPTO */
  5542. #if defined(MBEDTLS_MD_CAN_SHA384)
  5543. MBEDTLS_CHECK_RETURN_CRITICAL
  5544. static int ssl_get_handshake_transcript_sha384(mbedtls_ssl_context *ssl,
  5545. unsigned char *dst,
  5546. size_t dst_len,
  5547. size_t *olen)
  5548. {
  5549. int ret;
  5550. mbedtls_md_context_t sha384;
  5551. if (dst_len < 48) {
  5552. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  5553. }
  5554. mbedtls_md_init(&sha384);
  5555. ret = mbedtls_md_setup(&sha384, mbedtls_md_info_from_type(MBEDTLS_MD_SHA384), 0);
  5556. if (ret != 0) {
  5557. goto exit;
  5558. }
  5559. ret = mbedtls_md_clone(&sha384, &ssl->handshake->fin_sha384);
  5560. if (ret != 0) {
  5561. goto exit;
  5562. }
  5563. if ((ret = mbedtls_md_finish(&sha384, dst)) != 0) {
  5564. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_finish", ret);
  5565. goto exit;
  5566. }
  5567. *olen = 48;
  5568. exit:
  5569. mbedtls_md_free(&sha384);
  5570. return ret;
  5571. }
  5572. #endif /* MBEDTLS_MD_CAN_SHA384 */
  5573. #if defined(MBEDTLS_MD_CAN_SHA256)
  5574. MBEDTLS_CHECK_RETURN_CRITICAL
  5575. static int ssl_get_handshake_transcript_sha256(mbedtls_ssl_context *ssl,
  5576. unsigned char *dst,
  5577. size_t dst_len,
  5578. size_t *olen)
  5579. {
  5580. int ret;
  5581. mbedtls_md_context_t sha256;
  5582. if (dst_len < 32) {
  5583. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  5584. }
  5585. mbedtls_md_init(&sha256);
  5586. ret = mbedtls_md_setup(&sha256, mbedtls_md_info_from_type(MBEDTLS_MD_SHA256), 0);
  5587. if (ret != 0) {
  5588. goto exit;
  5589. }
  5590. ret = mbedtls_md_clone(&sha256, &ssl->handshake->fin_sha256);
  5591. if (ret != 0) {
  5592. goto exit;
  5593. }
  5594. if ((ret = mbedtls_md_finish(&sha256, dst)) != 0) {
  5595. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_finish", ret);
  5596. goto exit;
  5597. }
  5598. *olen = 32;
  5599. exit:
  5600. mbedtls_md_free(&sha256);
  5601. return ret;
  5602. }
  5603. #endif /* MBEDTLS_MD_CAN_SHA256 */
  5604. int mbedtls_ssl_get_handshake_transcript(mbedtls_ssl_context *ssl,
  5605. const mbedtls_md_type_t md,
  5606. unsigned char *dst,
  5607. size_t dst_len,
  5608. size_t *olen)
  5609. {
  5610. switch (md) {
  5611. #if defined(MBEDTLS_MD_CAN_SHA384)
  5612. case MBEDTLS_MD_SHA384:
  5613. return ssl_get_handshake_transcript_sha384(ssl, dst, dst_len, olen);
  5614. #endif /* MBEDTLS_MD_CAN_SHA384*/
  5615. #if defined(MBEDTLS_MD_CAN_SHA256)
  5616. case MBEDTLS_MD_SHA256:
  5617. return ssl_get_handshake_transcript_sha256(ssl, dst, dst_len, olen);
  5618. #endif /* MBEDTLS_MD_CAN_SHA256*/
  5619. default:
  5620. #if !defined(MBEDTLS_MD_CAN_SHA384) && \
  5621. !defined(MBEDTLS_MD_CAN_SHA256)
  5622. (void) ssl;
  5623. (void) dst;
  5624. (void) dst_len;
  5625. (void) olen;
  5626. #endif
  5627. break;
  5628. }
  5629. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  5630. }
  5631. #endif /* !MBEDTLS_USE_PSA_CRYPTO */
  5632. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  5633. /* mbedtls_ssl_parse_sig_alg_ext()
  5634. *
  5635. * The `extension_data` field of signature algorithm contains a `SignatureSchemeList`
  5636. * value (TLS 1.3 RFC8446):
  5637. * enum {
  5638. * ....
  5639. * ecdsa_secp256r1_sha256( 0x0403 ),
  5640. * ecdsa_secp384r1_sha384( 0x0503 ),
  5641. * ecdsa_secp521r1_sha512( 0x0603 ),
  5642. * ....
  5643. * } SignatureScheme;
  5644. *
  5645. * struct {
  5646. * SignatureScheme supported_signature_algorithms<2..2^16-2>;
  5647. * } SignatureSchemeList;
  5648. *
  5649. * The `extension_data` field of signature algorithm contains a `SignatureAndHashAlgorithm`
  5650. * value (TLS 1.2 RFC5246):
  5651. * enum {
  5652. * none(0), md5(1), sha1(2), sha224(3), sha256(4), sha384(5),
  5653. * sha512(6), (255)
  5654. * } HashAlgorithm;
  5655. *
  5656. * enum { anonymous(0), rsa(1), dsa(2), ecdsa(3), (255) }
  5657. * SignatureAlgorithm;
  5658. *
  5659. * struct {
  5660. * HashAlgorithm hash;
  5661. * SignatureAlgorithm signature;
  5662. * } SignatureAndHashAlgorithm;
  5663. *
  5664. * SignatureAndHashAlgorithm
  5665. * supported_signature_algorithms<2..2^16-2>;
  5666. *
  5667. * The TLS 1.3 signature algorithm extension was defined to be a compatible
  5668. * generalization of the TLS 1.2 signature algorithm extension.
  5669. * `SignatureAndHashAlgorithm` field of TLS 1.2 can be represented by
  5670. * `SignatureScheme` field of TLS 1.3
  5671. *
  5672. */
  5673. int mbedtls_ssl_parse_sig_alg_ext(mbedtls_ssl_context *ssl,
  5674. const unsigned char *buf,
  5675. const unsigned char *end)
  5676. {
  5677. const unsigned char *p = buf;
  5678. size_t supported_sig_algs_len = 0;
  5679. const unsigned char *supported_sig_algs_end;
  5680. uint16_t sig_alg;
  5681. uint32_t common_idx = 0;
  5682. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, end, 2);
  5683. supported_sig_algs_len = MBEDTLS_GET_UINT16_BE(p, 0);
  5684. p += 2;
  5685. memset(ssl->handshake->received_sig_algs, 0,
  5686. sizeof(ssl->handshake->received_sig_algs));
  5687. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, end, supported_sig_algs_len);
  5688. supported_sig_algs_end = p + supported_sig_algs_len;
  5689. while (p < supported_sig_algs_end) {
  5690. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, supported_sig_algs_end, 2);
  5691. sig_alg = MBEDTLS_GET_UINT16_BE(p, 0);
  5692. p += 2;
  5693. MBEDTLS_SSL_DEBUG_MSG(4, ("received signature algorithm: 0x%x %s",
  5694. sig_alg,
  5695. mbedtls_ssl_sig_alg_to_str(sig_alg)));
  5696. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  5697. if (ssl->tls_version == MBEDTLS_SSL_VERSION_TLS1_2 &&
  5698. (!(mbedtls_ssl_sig_alg_is_supported(ssl, sig_alg) &&
  5699. mbedtls_ssl_sig_alg_is_offered(ssl, sig_alg)))) {
  5700. continue;
  5701. }
  5702. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  5703. MBEDTLS_SSL_DEBUG_MSG(4, ("valid signature algorithm: %s",
  5704. mbedtls_ssl_sig_alg_to_str(sig_alg)));
  5705. if (common_idx + 1 < MBEDTLS_RECEIVED_SIG_ALGS_SIZE) {
  5706. ssl->handshake->received_sig_algs[common_idx] = sig_alg;
  5707. common_idx += 1;
  5708. }
  5709. }
  5710. /* Check that we consumed all the message. */
  5711. if (p != end) {
  5712. MBEDTLS_SSL_DEBUG_MSG(1,
  5713. ("Signature algorithms extension length misaligned"));
  5714. MBEDTLS_SSL_PEND_FATAL_ALERT(MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR,
  5715. MBEDTLS_ERR_SSL_DECODE_ERROR);
  5716. return MBEDTLS_ERR_SSL_DECODE_ERROR;
  5717. }
  5718. if (common_idx == 0) {
  5719. MBEDTLS_SSL_DEBUG_MSG(3, ("no signature algorithm in common"));
  5720. MBEDTLS_SSL_PEND_FATAL_ALERT(MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE,
  5721. MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE);
  5722. return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
  5723. }
  5724. ssl->handshake->received_sig_algs[common_idx] = MBEDTLS_TLS_SIG_NONE;
  5725. return 0;
  5726. }
  5727. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  5728. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  5729. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  5730. static psa_status_t setup_psa_key_derivation(psa_key_derivation_operation_t *derivation,
  5731. mbedtls_svc_key_id_t key,
  5732. psa_algorithm_t alg,
  5733. const unsigned char *raw_psk, size_t raw_psk_length,
  5734. const unsigned char *seed, size_t seed_length,
  5735. const unsigned char *label, size_t label_length,
  5736. const unsigned char *other_secret,
  5737. size_t other_secret_length,
  5738. size_t capacity)
  5739. {
  5740. psa_status_t status;
  5741. status = psa_key_derivation_setup(derivation, alg);
  5742. if (status != PSA_SUCCESS) {
  5743. return status;
  5744. }
  5745. if (PSA_ALG_IS_TLS12_PRF(alg) || PSA_ALG_IS_TLS12_PSK_TO_MS(alg)) {
  5746. status = psa_key_derivation_input_bytes(derivation,
  5747. PSA_KEY_DERIVATION_INPUT_SEED,
  5748. seed, seed_length);
  5749. if (status != PSA_SUCCESS) {
  5750. return status;
  5751. }
  5752. if (other_secret != NULL) {
  5753. status = psa_key_derivation_input_bytes(derivation,
  5754. PSA_KEY_DERIVATION_INPUT_OTHER_SECRET,
  5755. other_secret, other_secret_length);
  5756. if (status != PSA_SUCCESS) {
  5757. return status;
  5758. }
  5759. }
  5760. if (mbedtls_svc_key_id_is_null(key)) {
  5761. status = psa_key_derivation_input_bytes(
  5762. derivation, PSA_KEY_DERIVATION_INPUT_SECRET,
  5763. raw_psk, raw_psk_length);
  5764. } else {
  5765. status = psa_key_derivation_input_key(
  5766. derivation, PSA_KEY_DERIVATION_INPUT_SECRET, key);
  5767. }
  5768. if (status != PSA_SUCCESS) {
  5769. return status;
  5770. }
  5771. status = psa_key_derivation_input_bytes(derivation,
  5772. PSA_KEY_DERIVATION_INPUT_LABEL,
  5773. label, label_length);
  5774. if (status != PSA_SUCCESS) {
  5775. return status;
  5776. }
  5777. } else {
  5778. return PSA_ERROR_NOT_SUPPORTED;
  5779. }
  5780. status = psa_key_derivation_set_capacity(derivation, capacity);
  5781. if (status != PSA_SUCCESS) {
  5782. return status;
  5783. }
  5784. return PSA_SUCCESS;
  5785. }
  5786. #if defined(PSA_WANT_ALG_SHA_384) || \
  5787. defined(PSA_WANT_ALG_SHA_256)
  5788. MBEDTLS_CHECK_RETURN_CRITICAL
  5789. static int tls_prf_generic(mbedtls_md_type_t md_type,
  5790. const unsigned char *secret, size_t slen,
  5791. const char *label,
  5792. const unsigned char *random, size_t rlen,
  5793. unsigned char *dstbuf, size_t dlen)
  5794. {
  5795. psa_status_t status;
  5796. psa_algorithm_t alg;
  5797. mbedtls_svc_key_id_t master_key = MBEDTLS_SVC_KEY_ID_INIT;
  5798. psa_key_derivation_operation_t derivation =
  5799. PSA_KEY_DERIVATION_OPERATION_INIT;
  5800. if (md_type == MBEDTLS_MD_SHA384) {
  5801. alg = PSA_ALG_TLS12_PRF(PSA_ALG_SHA_384);
  5802. } else {
  5803. alg = PSA_ALG_TLS12_PRF(PSA_ALG_SHA_256);
  5804. }
  5805. /* Normally a "secret" should be long enough to be impossible to
  5806. * find by brute force, and in particular should not be empty. But
  5807. * this PRF is also used to derive an IV, in particular in EAP-TLS,
  5808. * and for this use case it makes sense to have a 0-length "secret".
  5809. * Since the key API doesn't allow importing a key of length 0,
  5810. * keep master_key=0, which setup_psa_key_derivation() understands
  5811. * to mean a 0-length "secret" input. */
  5812. if (slen != 0) {
  5813. psa_key_attributes_t key_attributes = psa_key_attributes_init();
  5814. psa_set_key_usage_flags(&key_attributes, PSA_KEY_USAGE_DERIVE);
  5815. psa_set_key_algorithm(&key_attributes, alg);
  5816. psa_set_key_type(&key_attributes, PSA_KEY_TYPE_DERIVE);
  5817. status = psa_import_key(&key_attributes, secret, slen, &master_key);
  5818. if (status != PSA_SUCCESS) {
  5819. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  5820. }
  5821. }
  5822. status = setup_psa_key_derivation(&derivation,
  5823. master_key, alg,
  5824. NULL, 0,
  5825. random, rlen,
  5826. (unsigned char const *) label,
  5827. (size_t) strlen(label),
  5828. NULL, 0,
  5829. dlen);
  5830. if (status != PSA_SUCCESS) {
  5831. psa_key_derivation_abort(&derivation);
  5832. psa_destroy_key(master_key);
  5833. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  5834. }
  5835. status = psa_key_derivation_output_bytes(&derivation, dstbuf, dlen);
  5836. if (status != PSA_SUCCESS) {
  5837. psa_key_derivation_abort(&derivation);
  5838. psa_destroy_key(master_key);
  5839. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  5840. }
  5841. status = psa_key_derivation_abort(&derivation);
  5842. if (status != PSA_SUCCESS) {
  5843. psa_destroy_key(master_key);
  5844. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  5845. }
  5846. if (!mbedtls_svc_key_id_is_null(master_key)) {
  5847. status = psa_destroy_key(master_key);
  5848. }
  5849. if (status != PSA_SUCCESS) {
  5850. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  5851. }
  5852. return 0;
  5853. }
  5854. #endif /* PSA_WANT_ALG_SHA_256 || PSA_WANT_ALG_SHA_384 */
  5855. #else /* MBEDTLS_USE_PSA_CRYPTO */
  5856. #if defined(MBEDTLS_MD_C) && \
  5857. (defined(MBEDTLS_MD_CAN_SHA256) || \
  5858. defined(MBEDTLS_MD_CAN_SHA384))
  5859. MBEDTLS_CHECK_RETURN_CRITICAL
  5860. static int tls_prf_generic(mbedtls_md_type_t md_type,
  5861. const unsigned char *secret, size_t slen,
  5862. const char *label,
  5863. const unsigned char *random, size_t rlen,
  5864. unsigned char *dstbuf, size_t dlen)
  5865. {
  5866. size_t nb;
  5867. size_t i, j, k, md_len;
  5868. unsigned char *tmp;
  5869. size_t tmp_len = 0;
  5870. unsigned char h_i[MBEDTLS_MD_MAX_SIZE];
  5871. const mbedtls_md_info_t *md_info;
  5872. mbedtls_md_context_t md_ctx;
  5873. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  5874. mbedtls_md_init(&md_ctx);
  5875. if ((md_info = mbedtls_md_info_from_type(md_type)) == NULL) {
  5876. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  5877. }
  5878. md_len = mbedtls_md_get_size(md_info);
  5879. tmp_len = md_len + strlen(label) + rlen;
  5880. tmp = mbedtls_calloc(1, tmp_len);
  5881. if (tmp == NULL) {
  5882. ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
  5883. goto exit;
  5884. }
  5885. nb = strlen(label);
  5886. memcpy(tmp + md_len, label, nb);
  5887. memcpy(tmp + md_len + nb, random, rlen);
  5888. nb += rlen;
  5889. /*
  5890. * Compute P_<hash>(secret, label + random)[0..dlen]
  5891. */
  5892. if ((ret = mbedtls_md_setup(&md_ctx, md_info, 1)) != 0) {
  5893. goto exit;
  5894. }
  5895. ret = mbedtls_md_hmac_starts(&md_ctx, secret, slen);
  5896. if (ret != 0) {
  5897. goto exit;
  5898. }
  5899. ret = mbedtls_md_hmac_update(&md_ctx, tmp + md_len, nb);
  5900. if (ret != 0) {
  5901. goto exit;
  5902. }
  5903. ret = mbedtls_md_hmac_finish(&md_ctx, tmp);
  5904. if (ret != 0) {
  5905. goto exit;
  5906. }
  5907. for (i = 0; i < dlen; i += md_len) {
  5908. ret = mbedtls_md_hmac_reset(&md_ctx);
  5909. if (ret != 0) {
  5910. goto exit;
  5911. }
  5912. ret = mbedtls_md_hmac_update(&md_ctx, tmp, md_len + nb);
  5913. if (ret != 0) {
  5914. goto exit;
  5915. }
  5916. ret = mbedtls_md_hmac_finish(&md_ctx, h_i);
  5917. if (ret != 0) {
  5918. goto exit;
  5919. }
  5920. ret = mbedtls_md_hmac_reset(&md_ctx);
  5921. if (ret != 0) {
  5922. goto exit;
  5923. }
  5924. ret = mbedtls_md_hmac_update(&md_ctx, tmp, md_len);
  5925. if (ret != 0) {
  5926. goto exit;
  5927. }
  5928. ret = mbedtls_md_hmac_finish(&md_ctx, tmp);
  5929. if (ret != 0) {
  5930. goto exit;
  5931. }
  5932. k = (i + md_len > dlen) ? dlen % md_len : md_len;
  5933. for (j = 0; j < k; j++) {
  5934. dstbuf[i + j] = h_i[j];
  5935. }
  5936. }
  5937. exit:
  5938. mbedtls_md_free(&md_ctx);
  5939. if (tmp != NULL) {
  5940. mbedtls_platform_zeroize(tmp, tmp_len);
  5941. }
  5942. mbedtls_platform_zeroize(h_i, sizeof(h_i));
  5943. mbedtls_free(tmp);
  5944. return ret;
  5945. }
  5946. #endif /* MBEDTLS_MD_C && ( MBEDTLS_MD_CAN_SHA256 || MBEDTLS_MD_CAN_SHA384 ) */
  5947. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  5948. #if defined(MBEDTLS_MD_CAN_SHA256)
  5949. MBEDTLS_CHECK_RETURN_CRITICAL
  5950. static int tls_prf_sha256(const unsigned char *secret, size_t slen,
  5951. const char *label,
  5952. const unsigned char *random, size_t rlen,
  5953. unsigned char *dstbuf, size_t dlen)
  5954. {
  5955. return tls_prf_generic(MBEDTLS_MD_SHA256, secret, slen,
  5956. label, random, rlen, dstbuf, dlen);
  5957. }
  5958. #endif /* MBEDTLS_MD_CAN_SHA256*/
  5959. #if defined(MBEDTLS_MD_CAN_SHA384)
  5960. MBEDTLS_CHECK_RETURN_CRITICAL
  5961. static int tls_prf_sha384(const unsigned char *secret, size_t slen,
  5962. const char *label,
  5963. const unsigned char *random, size_t rlen,
  5964. unsigned char *dstbuf, size_t dlen)
  5965. {
  5966. return tls_prf_generic(MBEDTLS_MD_SHA384, secret, slen,
  5967. label, random, rlen, dstbuf, dlen);
  5968. }
  5969. #endif /* MBEDTLS_MD_CAN_SHA384*/
  5970. /*
  5971. * Set appropriate PRF function and other SSL / TLS1.2 functions
  5972. *
  5973. * Inputs:
  5974. * - hash associated with the ciphersuite (only used by TLS 1.2)
  5975. *
  5976. * Outputs:
  5977. * - the tls_prf, calc_verify and calc_finished members of handshake structure
  5978. */
  5979. MBEDTLS_CHECK_RETURN_CRITICAL
  5980. static int ssl_set_handshake_prfs(mbedtls_ssl_handshake_params *handshake,
  5981. mbedtls_md_type_t hash)
  5982. {
  5983. #if defined(MBEDTLS_MD_CAN_SHA384)
  5984. if (hash == MBEDTLS_MD_SHA384) {
  5985. handshake->tls_prf = tls_prf_sha384;
  5986. handshake->calc_verify = ssl_calc_verify_tls_sha384;
  5987. handshake->calc_finished = ssl_calc_finished_tls_sha384;
  5988. } else
  5989. #endif
  5990. #if defined(MBEDTLS_MD_CAN_SHA256)
  5991. {
  5992. (void) hash;
  5993. handshake->tls_prf = tls_prf_sha256;
  5994. handshake->calc_verify = ssl_calc_verify_tls_sha256;
  5995. handshake->calc_finished = ssl_calc_finished_tls_sha256;
  5996. }
  5997. #else
  5998. {
  5999. (void) handshake;
  6000. (void) hash;
  6001. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  6002. }
  6003. #endif
  6004. return 0;
  6005. }
  6006. /*
  6007. * Compute master secret if needed
  6008. *
  6009. * Parameters:
  6010. * [in/out] handshake
  6011. * [in] resume, premaster, extended_ms, calc_verify, tls_prf
  6012. * (PSA-PSK) ciphersuite_info, psk_opaque
  6013. * [out] premaster (cleared)
  6014. * [out] master
  6015. * [in] ssl: optionally used for debugging, EMS and PSA-PSK
  6016. * debug: conf->f_dbg, conf->p_dbg
  6017. * EMS: passed to calc_verify (debug + session_negotiate)
  6018. * PSA-PSA: conf
  6019. */
  6020. MBEDTLS_CHECK_RETURN_CRITICAL
  6021. static int ssl_compute_master(mbedtls_ssl_handshake_params *handshake,
  6022. unsigned char *master,
  6023. const mbedtls_ssl_context *ssl)
  6024. {
  6025. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6026. /* cf. RFC 5246, Section 8.1:
  6027. * "The master secret is always exactly 48 bytes in length." */
  6028. size_t const master_secret_len = 48;
  6029. #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
  6030. unsigned char session_hash[48];
  6031. #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
  6032. /* The label for the KDF used for key expansion.
  6033. * This is either "master secret" or "extended master secret"
  6034. * depending on whether the Extended Master Secret extension
  6035. * is used. */
  6036. char const *lbl = "master secret";
  6037. /* The seed for the KDF used for key expansion.
  6038. * - If the Extended Master Secret extension is not used,
  6039. * this is ClientHello.Random + ServerHello.Random
  6040. * (see Sect. 8.1 in RFC 5246).
  6041. * - If the Extended Master Secret extension is used,
  6042. * this is the transcript of the handshake so far.
  6043. * (see Sect. 4 in RFC 7627). */
  6044. unsigned char const *seed = handshake->randbytes;
  6045. size_t seed_len = 64;
  6046. #if !defined(MBEDTLS_DEBUG_C) && \
  6047. !defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET) && \
  6048. !(defined(MBEDTLS_USE_PSA_CRYPTO) && \
  6049. defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED))
  6050. ssl = NULL; /* make sure we don't use it except for those cases */
  6051. (void) ssl;
  6052. #endif
  6053. if (handshake->resume != 0) {
  6054. MBEDTLS_SSL_DEBUG_MSG(3, ("no premaster (session resumed)"));
  6055. return 0;
  6056. }
  6057. #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
  6058. if (handshake->extended_ms == MBEDTLS_SSL_EXTENDED_MS_ENABLED) {
  6059. lbl = "extended master secret";
  6060. seed = session_hash;
  6061. ret = handshake->calc_verify(ssl, session_hash, &seed_len);
  6062. if (ret != 0) {
  6063. MBEDTLS_SSL_DEBUG_RET(1, "calc_verify", ret);
  6064. }
  6065. MBEDTLS_SSL_DEBUG_BUF(3, "session hash for extended master secret",
  6066. session_hash, seed_len);
  6067. }
  6068. #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
  6069. #if defined(MBEDTLS_USE_PSA_CRYPTO) && \
  6070. defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
  6071. if (mbedtls_ssl_ciphersuite_uses_psk(handshake->ciphersuite_info) == 1) {
  6072. /* Perform PSK-to-MS expansion in a single step. */
  6073. psa_status_t status;
  6074. psa_algorithm_t alg;
  6075. mbedtls_svc_key_id_t psk;
  6076. psa_key_derivation_operation_t derivation =
  6077. PSA_KEY_DERIVATION_OPERATION_INIT;
  6078. mbedtls_md_type_t hash_alg = (mbedtls_md_type_t) handshake->ciphersuite_info->mac;
  6079. MBEDTLS_SSL_DEBUG_MSG(2, ("perform PSA-based PSK-to-MS expansion"));
  6080. psk = mbedtls_ssl_get_opaque_psk(ssl);
  6081. if (hash_alg == MBEDTLS_MD_SHA384) {
  6082. alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_384);
  6083. } else {
  6084. alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_256);
  6085. }
  6086. size_t other_secret_len = 0;
  6087. unsigned char *other_secret = NULL;
  6088. switch (handshake->ciphersuite_info->key_exchange) {
  6089. /* Provide other secret.
  6090. * Other secret is stored in premaster, where first 2 bytes hold the
  6091. * length of the other key.
  6092. */
  6093. case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
  6094. /* For RSA-PSK other key length is always 48 bytes. */
  6095. other_secret_len = 48;
  6096. other_secret = handshake->premaster + 2;
  6097. break;
  6098. case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
  6099. case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
  6100. other_secret_len = MBEDTLS_GET_UINT16_BE(handshake->premaster, 0);
  6101. other_secret = handshake->premaster + 2;
  6102. break;
  6103. default:
  6104. break;
  6105. }
  6106. status = setup_psa_key_derivation(&derivation, psk, alg,
  6107. ssl->conf->psk, ssl->conf->psk_len,
  6108. seed, seed_len,
  6109. (unsigned char const *) lbl,
  6110. (size_t) strlen(lbl),
  6111. other_secret, other_secret_len,
  6112. master_secret_len);
  6113. if (status != PSA_SUCCESS) {
  6114. psa_key_derivation_abort(&derivation);
  6115. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6116. }
  6117. status = psa_key_derivation_output_bytes(&derivation,
  6118. master,
  6119. master_secret_len);
  6120. if (status != PSA_SUCCESS) {
  6121. psa_key_derivation_abort(&derivation);
  6122. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6123. }
  6124. status = psa_key_derivation_abort(&derivation);
  6125. if (status != PSA_SUCCESS) {
  6126. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6127. }
  6128. } else
  6129. #endif
  6130. {
  6131. #if defined(MBEDTLS_USE_PSA_CRYPTO) && \
  6132. defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
  6133. if (handshake->ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
  6134. psa_status_t status;
  6135. psa_algorithm_t alg = PSA_ALG_TLS12_ECJPAKE_TO_PMS;
  6136. psa_key_derivation_operation_t derivation =
  6137. PSA_KEY_DERIVATION_OPERATION_INIT;
  6138. MBEDTLS_SSL_DEBUG_MSG(2, ("perform PSA-based PMS KDF for ECJPAKE"));
  6139. handshake->pmslen = PSA_TLS12_ECJPAKE_TO_PMS_DATA_SIZE;
  6140. status = psa_key_derivation_setup(&derivation, alg);
  6141. if (status != PSA_SUCCESS) {
  6142. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6143. }
  6144. status = psa_key_derivation_set_capacity(&derivation,
  6145. PSA_TLS12_ECJPAKE_TO_PMS_DATA_SIZE);
  6146. if (status != PSA_SUCCESS) {
  6147. psa_key_derivation_abort(&derivation);
  6148. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6149. }
  6150. status = psa_pake_get_implicit_key(&handshake->psa_pake_ctx,
  6151. &derivation);
  6152. if (status != PSA_SUCCESS) {
  6153. psa_key_derivation_abort(&derivation);
  6154. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6155. }
  6156. status = psa_key_derivation_output_bytes(&derivation,
  6157. handshake->premaster,
  6158. handshake->pmslen);
  6159. if (status != PSA_SUCCESS) {
  6160. psa_key_derivation_abort(&derivation);
  6161. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6162. }
  6163. status = psa_key_derivation_abort(&derivation);
  6164. if (status != PSA_SUCCESS) {
  6165. return MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
  6166. }
  6167. }
  6168. #endif
  6169. ret = handshake->tls_prf(handshake->premaster, handshake->pmslen,
  6170. lbl, seed, seed_len,
  6171. master,
  6172. master_secret_len);
  6173. if (ret != 0) {
  6174. MBEDTLS_SSL_DEBUG_RET(1, "prf", ret);
  6175. return ret;
  6176. }
  6177. MBEDTLS_SSL_DEBUG_BUF(3, "premaster secret",
  6178. handshake->premaster,
  6179. handshake->pmslen);
  6180. mbedtls_platform_zeroize(handshake->premaster,
  6181. sizeof(handshake->premaster));
  6182. }
  6183. return 0;
  6184. }
  6185. int mbedtls_ssl_derive_keys(mbedtls_ssl_context *ssl)
  6186. {
  6187. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6188. const mbedtls_ssl_ciphersuite_t * const ciphersuite_info =
  6189. ssl->handshake->ciphersuite_info;
  6190. MBEDTLS_SSL_DEBUG_MSG(2, ("=> derive keys"));
  6191. /* Set PRF, calc_verify and calc_finished function pointers */
  6192. ret = ssl_set_handshake_prfs(ssl->handshake,
  6193. (mbedtls_md_type_t) ciphersuite_info->mac);
  6194. if (ret != 0) {
  6195. MBEDTLS_SSL_DEBUG_RET(1, "ssl_set_handshake_prfs", ret);
  6196. return ret;
  6197. }
  6198. /* Compute master secret if needed */
  6199. ret = ssl_compute_master(ssl->handshake,
  6200. ssl->session_negotiate->master,
  6201. ssl);
  6202. if (ret != 0) {
  6203. MBEDTLS_SSL_DEBUG_RET(1, "ssl_compute_master", ret);
  6204. return ret;
  6205. }
  6206. /* Swap the client and server random values:
  6207. * - MS derivation wanted client+server (RFC 5246 8.1)
  6208. * - key derivation wants server+client (RFC 5246 6.3) */
  6209. {
  6210. unsigned char tmp[64];
  6211. memcpy(tmp, ssl->handshake->randbytes, 64);
  6212. memcpy(ssl->handshake->randbytes, tmp + 32, 32);
  6213. memcpy(ssl->handshake->randbytes + 32, tmp, 32);
  6214. mbedtls_platform_zeroize(tmp, sizeof(tmp));
  6215. }
  6216. /* Populate transform structure */
  6217. ret = ssl_tls12_populate_transform(ssl->transform_negotiate,
  6218. ssl->session_negotiate->ciphersuite,
  6219. ssl->session_negotiate->master,
  6220. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  6221. ssl->session_negotiate->encrypt_then_mac,
  6222. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
  6223. ssl->handshake->tls_prf,
  6224. ssl->handshake->randbytes,
  6225. ssl->tls_version,
  6226. ssl->conf->endpoint,
  6227. ssl);
  6228. if (ret != 0) {
  6229. MBEDTLS_SSL_DEBUG_RET(1, "ssl_tls12_populate_transform", ret);
  6230. return ret;
  6231. }
  6232. /* We no longer need Server/ClientHello.random values */
  6233. mbedtls_platform_zeroize(ssl->handshake->randbytes,
  6234. sizeof(ssl->handshake->randbytes));
  6235. MBEDTLS_SSL_DEBUG_MSG(2, ("<= derive keys"));
  6236. return 0;
  6237. }
  6238. int mbedtls_ssl_set_calc_verify_md(mbedtls_ssl_context *ssl, int md)
  6239. {
  6240. switch (md) {
  6241. #if defined(MBEDTLS_MD_CAN_SHA384)
  6242. case MBEDTLS_SSL_HASH_SHA384:
  6243. ssl->handshake->calc_verify = ssl_calc_verify_tls_sha384;
  6244. break;
  6245. #endif
  6246. #if defined(MBEDTLS_MD_CAN_SHA256)
  6247. case MBEDTLS_SSL_HASH_SHA256:
  6248. ssl->handshake->calc_verify = ssl_calc_verify_tls_sha256;
  6249. break;
  6250. #endif
  6251. default:
  6252. return -1;
  6253. }
  6254. #if !defined(MBEDTLS_MD_CAN_SHA384) && \
  6255. !defined(MBEDTLS_MD_CAN_SHA256)
  6256. (void) ssl;
  6257. #endif
  6258. return 0;
  6259. }
  6260. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  6261. static int ssl_calc_verify_tls_psa(const mbedtls_ssl_context *ssl,
  6262. const psa_hash_operation_t *hs_op,
  6263. size_t buffer_size,
  6264. unsigned char *hash,
  6265. size_t *hlen)
  6266. {
  6267. psa_status_t status;
  6268. psa_hash_operation_t cloned_op = psa_hash_operation_init();
  6269. #if !defined(MBEDTLS_DEBUG_C)
  6270. (void) ssl;
  6271. #endif
  6272. MBEDTLS_SSL_DEBUG_MSG(2, ("=> PSA calc verify"));
  6273. status = psa_hash_clone(hs_op, &cloned_op);
  6274. if (status != PSA_SUCCESS) {
  6275. goto exit;
  6276. }
  6277. status = psa_hash_finish(&cloned_op, hash, buffer_size, hlen);
  6278. if (status != PSA_SUCCESS) {
  6279. goto exit;
  6280. }
  6281. MBEDTLS_SSL_DEBUG_BUF(3, "PSA calculated verify result", hash, *hlen);
  6282. MBEDTLS_SSL_DEBUG_MSG(2, ("<= PSA calc verify"));
  6283. exit:
  6284. psa_hash_abort(&cloned_op);
  6285. return mbedtls_md_error_from_psa(status);
  6286. }
  6287. #else
  6288. static int ssl_calc_verify_tls_legacy(const mbedtls_ssl_context *ssl,
  6289. const mbedtls_md_context_t *hs_ctx,
  6290. unsigned char *hash,
  6291. size_t *hlen)
  6292. {
  6293. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6294. mbedtls_md_context_t cloned_ctx;
  6295. mbedtls_md_init(&cloned_ctx);
  6296. #if !defined(MBEDTLS_DEBUG_C)
  6297. (void) ssl;
  6298. #endif
  6299. MBEDTLS_SSL_DEBUG_MSG(2, ("=> calc verify"));
  6300. ret = mbedtls_md_setup(&cloned_ctx, mbedtls_md_info_from_ctx(hs_ctx), 0);
  6301. if (ret != 0) {
  6302. goto exit;
  6303. }
  6304. ret = mbedtls_md_clone(&cloned_ctx, hs_ctx);
  6305. if (ret != 0) {
  6306. goto exit;
  6307. }
  6308. ret = mbedtls_md_finish(&cloned_ctx, hash);
  6309. if (ret != 0) {
  6310. goto exit;
  6311. }
  6312. *hlen = mbedtls_md_get_size(mbedtls_md_info_from_ctx(hs_ctx));
  6313. MBEDTLS_SSL_DEBUG_BUF(3, "calculated verify result", hash, *hlen);
  6314. MBEDTLS_SSL_DEBUG_MSG(2, ("<= calc verify"));
  6315. exit:
  6316. mbedtls_md_free(&cloned_ctx);
  6317. return ret;
  6318. }
  6319. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  6320. #if defined(MBEDTLS_MD_CAN_SHA256)
  6321. int ssl_calc_verify_tls_sha256(const mbedtls_ssl_context *ssl,
  6322. unsigned char *hash,
  6323. size_t *hlen)
  6324. {
  6325. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  6326. return ssl_calc_verify_tls_psa(ssl, &ssl->handshake->fin_sha256_psa, 32,
  6327. hash, hlen);
  6328. #else
  6329. return ssl_calc_verify_tls_legacy(ssl, &ssl->handshake->fin_sha256,
  6330. hash, hlen);
  6331. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  6332. }
  6333. #endif /* MBEDTLS_MD_CAN_SHA256 */
  6334. #if defined(MBEDTLS_MD_CAN_SHA384)
  6335. int ssl_calc_verify_tls_sha384(const mbedtls_ssl_context *ssl,
  6336. unsigned char *hash,
  6337. size_t *hlen)
  6338. {
  6339. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  6340. return ssl_calc_verify_tls_psa(ssl, &ssl->handshake->fin_sha384_psa, 48,
  6341. hash, hlen);
  6342. #else
  6343. return ssl_calc_verify_tls_legacy(ssl, &ssl->handshake->fin_sha384,
  6344. hash, hlen);
  6345. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  6346. }
  6347. #endif /* MBEDTLS_MD_CAN_SHA384 */
  6348. #if !defined(MBEDTLS_USE_PSA_CRYPTO) && \
  6349. defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
  6350. int mbedtls_ssl_psk_derive_premaster(mbedtls_ssl_context *ssl, mbedtls_key_exchange_type_t key_ex)
  6351. {
  6352. unsigned char *p = ssl->handshake->premaster;
  6353. unsigned char *end = p + sizeof(ssl->handshake->premaster);
  6354. const unsigned char *psk = NULL;
  6355. size_t psk_len = 0;
  6356. int psk_ret = mbedtls_ssl_get_psk(ssl, &psk, &psk_len);
  6357. if (psk_ret == MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED) {
  6358. /*
  6359. * This should never happen because the existence of a PSK is always
  6360. * checked before calling this function.
  6361. *
  6362. * The exception is opaque DHE-PSK. For DHE-PSK fill premaster with
  6363. * the shared secret without PSK.
  6364. */
  6365. if (key_ex != MBEDTLS_KEY_EXCHANGE_DHE_PSK) {
  6366. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  6367. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  6368. }
  6369. }
  6370. /*
  6371. * PMS = struct {
  6372. * opaque other_secret<0..2^16-1>;
  6373. * opaque psk<0..2^16-1>;
  6374. * };
  6375. * with "other_secret" depending on the particular key exchange
  6376. */
  6377. #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
  6378. if (key_ex == MBEDTLS_KEY_EXCHANGE_PSK) {
  6379. if (end - p < 2) {
  6380. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  6381. }
  6382. MBEDTLS_PUT_UINT16_BE(psk_len, p, 0);
  6383. p += 2;
  6384. if (end < p || (size_t) (end - p) < psk_len) {
  6385. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  6386. }
  6387. memset(p, 0, psk_len);
  6388. p += psk_len;
  6389. } else
  6390. #endif /* MBEDTLS_KEY_EXCHANGE_PSK_ENABLED */
  6391. #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
  6392. if (key_ex == MBEDTLS_KEY_EXCHANGE_RSA_PSK) {
  6393. /*
  6394. * other_secret already set by the ClientKeyExchange message,
  6395. * and is 48 bytes long
  6396. */
  6397. if (end - p < 2) {
  6398. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  6399. }
  6400. *p++ = 0;
  6401. *p++ = 48;
  6402. p += 48;
  6403. } else
  6404. #endif /* MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED */
  6405. #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
  6406. if (key_ex == MBEDTLS_KEY_EXCHANGE_DHE_PSK) {
  6407. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6408. size_t len;
  6409. /* Write length only when we know the actual value */
  6410. if ((ret = mbedtls_dhm_calc_secret(&ssl->handshake->dhm_ctx,
  6411. p + 2, (size_t) (end - (p + 2)), &len,
  6412. ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
  6413. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_calc_secret", ret);
  6414. return ret;
  6415. }
  6416. MBEDTLS_PUT_UINT16_BE(len, p, 0);
  6417. p += 2 + len;
  6418. MBEDTLS_SSL_DEBUG_MPI(3, "DHM: K ", &ssl->handshake->dhm_ctx.K);
  6419. } else
  6420. #endif /* MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED */
  6421. #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
  6422. if (key_ex == MBEDTLS_KEY_EXCHANGE_ECDHE_PSK) {
  6423. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6424. size_t zlen;
  6425. if ((ret = mbedtls_ecdh_calc_secret(&ssl->handshake->ecdh_ctx, &zlen,
  6426. p + 2, (size_t) (end - (p + 2)),
  6427. ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
  6428. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_calc_secret", ret);
  6429. return ret;
  6430. }
  6431. MBEDTLS_PUT_UINT16_BE(zlen, p, 0);
  6432. p += 2 + zlen;
  6433. MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
  6434. MBEDTLS_DEBUG_ECDH_Z);
  6435. } else
  6436. #endif /* MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED */
  6437. {
  6438. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  6439. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  6440. }
  6441. /* opaque psk<0..2^16-1>; */
  6442. if (end - p < 2) {
  6443. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  6444. }
  6445. MBEDTLS_PUT_UINT16_BE(psk_len, p, 0);
  6446. p += 2;
  6447. if (end < p || (size_t) (end - p) < psk_len) {
  6448. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  6449. }
  6450. memcpy(p, psk, psk_len);
  6451. p += psk_len;
  6452. ssl->handshake->pmslen = (size_t) (p - ssl->handshake->premaster);
  6453. return 0;
  6454. }
  6455. #endif /* !MBEDTLS_USE_PSA_CRYPTO && MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
  6456. #if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_RENEGOTIATION)
  6457. MBEDTLS_CHECK_RETURN_CRITICAL
  6458. static int ssl_write_hello_request(mbedtls_ssl_context *ssl);
  6459. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  6460. int mbedtls_ssl_resend_hello_request(mbedtls_ssl_context *ssl)
  6461. {
  6462. /* If renegotiation is not enforced, retransmit until we would reach max
  6463. * timeout if we were using the usual handshake doubling scheme */
  6464. if (ssl->conf->renego_max_records < 0) {
  6465. uint32_t ratio = ssl->conf->hs_timeout_max / ssl->conf->hs_timeout_min + 1;
  6466. unsigned char doublings = 1;
  6467. while (ratio != 0) {
  6468. ++doublings;
  6469. ratio >>= 1;
  6470. }
  6471. if (++ssl->renego_records_seen > doublings) {
  6472. MBEDTLS_SSL_DEBUG_MSG(2, ("no longer retransmitting hello request"));
  6473. return 0;
  6474. }
  6475. }
  6476. return ssl_write_hello_request(ssl);
  6477. }
  6478. #endif
  6479. #endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_RENEGOTIATION */
  6480. /*
  6481. * Handshake functions
  6482. */
  6483. #if !defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
  6484. /* No certificate support -> dummy functions */
  6485. int mbedtls_ssl_write_certificate(mbedtls_ssl_context *ssl)
  6486. {
  6487. const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
  6488. ssl->handshake->ciphersuite_info;
  6489. MBEDTLS_SSL_DEBUG_MSG(2, ("=> write certificate"));
  6490. if (!mbedtls_ssl_ciphersuite_uses_srv_cert(ciphersuite_info)) {
  6491. MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write certificate"));
  6492. ssl->state++;
  6493. return 0;
  6494. }
  6495. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  6496. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  6497. }
  6498. int mbedtls_ssl_parse_certificate(mbedtls_ssl_context *ssl)
  6499. {
  6500. const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
  6501. ssl->handshake->ciphersuite_info;
  6502. MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse certificate"));
  6503. if (!mbedtls_ssl_ciphersuite_uses_srv_cert(ciphersuite_info)) {
  6504. MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate"));
  6505. ssl->state++;
  6506. return 0;
  6507. }
  6508. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  6509. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  6510. }
  6511. #else /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
  6512. /* Some certificate support -> implement write and parse */
  6513. int mbedtls_ssl_write_certificate(mbedtls_ssl_context *ssl)
  6514. {
  6515. int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
  6516. size_t i, n;
  6517. const mbedtls_x509_crt *crt;
  6518. const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
  6519. ssl->handshake->ciphersuite_info;
  6520. MBEDTLS_SSL_DEBUG_MSG(2, ("=> write certificate"));
  6521. if (!mbedtls_ssl_ciphersuite_uses_srv_cert(ciphersuite_info)) {
  6522. MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write certificate"));
  6523. ssl->state++;
  6524. return 0;
  6525. }
  6526. #if defined(MBEDTLS_SSL_CLI_C)
  6527. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  6528. if (ssl->handshake->client_auth == 0) {
  6529. MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write certificate"));
  6530. ssl->state++;
  6531. return 0;
  6532. }
  6533. }
  6534. #endif /* MBEDTLS_SSL_CLI_C */
  6535. #if defined(MBEDTLS_SSL_SRV_C)
  6536. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  6537. if (mbedtls_ssl_own_cert(ssl) == NULL) {
  6538. /* Should never happen because we shouldn't have picked the
  6539. * ciphersuite if we don't have a certificate. */
  6540. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  6541. }
  6542. }
  6543. #endif
  6544. MBEDTLS_SSL_DEBUG_CRT(3, "own certificate", mbedtls_ssl_own_cert(ssl));
  6545. /*
  6546. * 0 . 0 handshake type
  6547. * 1 . 3 handshake length
  6548. * 4 . 6 length of all certs
  6549. * 7 . 9 length of cert. 1
  6550. * 10 . n-1 peer certificate
  6551. * n . n+2 length of cert. 2
  6552. * n+3 . ... upper level cert, etc.
  6553. */
  6554. i = 7;
  6555. crt = mbedtls_ssl_own_cert(ssl);
  6556. while (crt != NULL) {
  6557. n = crt->raw.len;
  6558. if (n > MBEDTLS_SSL_OUT_CONTENT_LEN - 3 - i) {
  6559. MBEDTLS_SSL_DEBUG_MSG(1, ("certificate too large, %" MBEDTLS_PRINTF_SIZET
  6560. " > %" MBEDTLS_PRINTF_SIZET,
  6561. i + 3 + n, (size_t) MBEDTLS_SSL_OUT_CONTENT_LEN));
  6562. return MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL;
  6563. }
  6564. ssl->out_msg[i] = MBEDTLS_BYTE_2(n);
  6565. ssl->out_msg[i + 1] = MBEDTLS_BYTE_1(n);
  6566. ssl->out_msg[i + 2] = MBEDTLS_BYTE_0(n);
  6567. i += 3; memcpy(ssl->out_msg + i, crt->raw.p, n);
  6568. i += n; crt = crt->next;
  6569. }
  6570. ssl->out_msg[4] = MBEDTLS_BYTE_2(i - 7);
  6571. ssl->out_msg[5] = MBEDTLS_BYTE_1(i - 7);
  6572. ssl->out_msg[6] = MBEDTLS_BYTE_0(i - 7);
  6573. ssl->out_msglen = i;
  6574. ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
  6575. ssl->out_msg[0] = MBEDTLS_SSL_HS_CERTIFICATE;
  6576. ssl->state++;
  6577. if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
  6578. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
  6579. return ret;
  6580. }
  6581. MBEDTLS_SSL_DEBUG_MSG(2, ("<= write certificate"));
  6582. return ret;
  6583. }
  6584. #if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
  6585. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  6586. MBEDTLS_CHECK_RETURN_CRITICAL
  6587. static int ssl_check_peer_crt_unchanged(mbedtls_ssl_context *ssl,
  6588. unsigned char *crt_buf,
  6589. size_t crt_buf_len)
  6590. {
  6591. mbedtls_x509_crt const * const peer_crt = ssl->session->peer_cert;
  6592. if (peer_crt == NULL) {
  6593. return -1;
  6594. }
  6595. if (peer_crt->raw.len != crt_buf_len) {
  6596. return -1;
  6597. }
  6598. return memcmp(peer_crt->raw.p, crt_buf, peer_crt->raw.len);
  6599. }
  6600. #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  6601. MBEDTLS_CHECK_RETURN_CRITICAL
  6602. static int ssl_check_peer_crt_unchanged(mbedtls_ssl_context *ssl,
  6603. unsigned char *crt_buf,
  6604. size_t crt_buf_len)
  6605. {
  6606. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6607. unsigned char const * const peer_cert_digest =
  6608. ssl->session->peer_cert_digest;
  6609. mbedtls_md_type_t const peer_cert_digest_type =
  6610. ssl->session->peer_cert_digest_type;
  6611. mbedtls_md_info_t const * const digest_info =
  6612. mbedtls_md_info_from_type(peer_cert_digest_type);
  6613. unsigned char tmp_digest[MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN];
  6614. size_t digest_len;
  6615. if (peer_cert_digest == NULL || digest_info == NULL) {
  6616. return -1;
  6617. }
  6618. digest_len = mbedtls_md_get_size(digest_info);
  6619. if (digest_len > MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN) {
  6620. return -1;
  6621. }
  6622. ret = mbedtls_md(digest_info, crt_buf, crt_buf_len, tmp_digest);
  6623. if (ret != 0) {
  6624. return -1;
  6625. }
  6626. return memcmp(tmp_digest, peer_cert_digest, digest_len);
  6627. }
  6628. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  6629. #endif /* MBEDTLS_SSL_RENEGOTIATION && MBEDTLS_SSL_CLI_C */
  6630. /*
  6631. * Once the certificate message is read, parse it into a cert chain and
  6632. * perform basic checks, but leave actual verification to the caller
  6633. */
  6634. MBEDTLS_CHECK_RETURN_CRITICAL
  6635. static int ssl_parse_certificate_chain(mbedtls_ssl_context *ssl,
  6636. mbedtls_x509_crt *chain)
  6637. {
  6638. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6639. #if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
  6640. int crt_cnt = 0;
  6641. #endif
  6642. size_t i, n;
  6643. uint8_t alert;
  6644. if (ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE) {
  6645. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate message"));
  6646. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6647. MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE);
  6648. return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
  6649. }
  6650. if (ssl->in_msg[0] != MBEDTLS_SSL_HS_CERTIFICATE) {
  6651. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6652. MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE);
  6653. return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
  6654. }
  6655. if (ssl->in_hslen < mbedtls_ssl_hs_hdr_len(ssl) + 3 + 3) {
  6656. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate message"));
  6657. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6658. MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
  6659. return MBEDTLS_ERR_SSL_DECODE_ERROR;
  6660. }
  6661. i = mbedtls_ssl_hs_hdr_len(ssl);
  6662. /*
  6663. * Same message structure as in mbedtls_ssl_write_certificate()
  6664. */
  6665. n = MBEDTLS_GET_UINT16_BE(ssl->in_msg, i + 1);
  6666. if (ssl->in_msg[i] != 0 ||
  6667. ssl->in_hslen != n + 3 + mbedtls_ssl_hs_hdr_len(ssl)) {
  6668. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate message"));
  6669. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6670. MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
  6671. return MBEDTLS_ERR_SSL_DECODE_ERROR;
  6672. }
  6673. /* Make &ssl->in_msg[i] point to the beginning of the CRT chain. */
  6674. i += 3;
  6675. /* Iterate through and parse the CRTs in the provided chain. */
  6676. while (i < ssl->in_hslen) {
  6677. /* Check that there's room for the next CRT's length fields. */
  6678. if (i + 3 > ssl->in_hslen) {
  6679. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate message"));
  6680. mbedtls_ssl_send_alert_message(ssl,
  6681. MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6682. MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
  6683. return MBEDTLS_ERR_SSL_DECODE_ERROR;
  6684. }
  6685. /* In theory, the CRT can be up to 2**24 Bytes, but we don't support
  6686. * anything beyond 2**16 ~ 64K. */
  6687. if (ssl->in_msg[i] != 0) {
  6688. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate message"));
  6689. mbedtls_ssl_send_alert_message(ssl,
  6690. MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6691. MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT);
  6692. return MBEDTLS_ERR_SSL_BAD_CERTIFICATE;
  6693. }
  6694. /* Read length of the next CRT in the chain. */
  6695. n = MBEDTLS_GET_UINT16_BE(ssl->in_msg, i + 1);
  6696. i += 3;
  6697. if (n < 128 || i + n > ssl->in_hslen) {
  6698. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate message"));
  6699. mbedtls_ssl_send_alert_message(ssl,
  6700. MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6701. MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
  6702. return MBEDTLS_ERR_SSL_DECODE_ERROR;
  6703. }
  6704. /* Check if we're handling the first CRT in the chain. */
  6705. #if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
  6706. if (crt_cnt++ == 0 &&
  6707. ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
  6708. ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS) {
  6709. /* During client-side renegotiation, check that the server's
  6710. * end-CRTs hasn't changed compared to the initial handshake,
  6711. * mitigating the triple handshake attack. On success, reuse
  6712. * the original end-CRT instead of parsing it again. */
  6713. MBEDTLS_SSL_DEBUG_MSG(3, ("Check that peer CRT hasn't changed during renegotiation"));
  6714. if (ssl_check_peer_crt_unchanged(ssl,
  6715. &ssl->in_msg[i],
  6716. n) != 0) {
  6717. MBEDTLS_SSL_DEBUG_MSG(1, ("new server cert during renegotiation"));
  6718. mbedtls_ssl_send_alert_message(ssl,
  6719. MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6720. MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED);
  6721. return MBEDTLS_ERR_SSL_BAD_CERTIFICATE;
  6722. }
  6723. /* Now we can safely free the original chain. */
  6724. ssl_clear_peer_cert(ssl->session);
  6725. }
  6726. #endif /* MBEDTLS_SSL_RENEGOTIATION && MBEDTLS_SSL_CLI_C */
  6727. /* Parse the next certificate in the chain. */
  6728. #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  6729. ret = mbedtls_x509_crt_parse_der(chain, ssl->in_msg + i, n);
  6730. #else
  6731. /* If we don't need to store the CRT chain permanently, parse
  6732. * it in-place from the input buffer instead of making a copy. */
  6733. ret = mbedtls_x509_crt_parse_der_nocopy(chain, ssl->in_msg + i, n);
  6734. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  6735. switch (ret) {
  6736. case 0: /*ok*/
  6737. case MBEDTLS_ERR_X509_UNKNOWN_SIG_ALG + MBEDTLS_ERR_OID_NOT_FOUND:
  6738. /* Ignore certificate with an unknown algorithm: maybe a
  6739. prior certificate was already trusted. */
  6740. break;
  6741. case MBEDTLS_ERR_X509_ALLOC_FAILED:
  6742. alert = MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR;
  6743. goto crt_parse_der_failed;
  6744. case MBEDTLS_ERR_X509_UNKNOWN_VERSION:
  6745. alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
  6746. goto crt_parse_der_failed;
  6747. default:
  6748. alert = MBEDTLS_SSL_ALERT_MSG_BAD_CERT;
  6749. crt_parse_der_failed:
  6750. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL, alert);
  6751. MBEDTLS_SSL_DEBUG_RET(1, " mbedtls_x509_crt_parse_der", ret);
  6752. return ret;
  6753. }
  6754. i += n;
  6755. }
  6756. MBEDTLS_SSL_DEBUG_CRT(3, "peer certificate", chain);
  6757. return 0;
  6758. }
  6759. #if defined(MBEDTLS_SSL_SRV_C)
  6760. MBEDTLS_CHECK_RETURN_CRITICAL
  6761. static int ssl_srv_check_client_no_crt_notification(mbedtls_ssl_context *ssl)
  6762. {
  6763. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  6764. return -1;
  6765. }
  6766. if (ssl->in_hslen == 3 + mbedtls_ssl_hs_hdr_len(ssl) &&
  6767. ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
  6768. ssl->in_msg[0] == MBEDTLS_SSL_HS_CERTIFICATE &&
  6769. memcmp(ssl->in_msg + mbedtls_ssl_hs_hdr_len(ssl), "\0\0\0", 3) == 0) {
  6770. MBEDTLS_SSL_DEBUG_MSG(1, ("peer has no certificate"));
  6771. return 0;
  6772. }
  6773. return -1;
  6774. }
  6775. #endif /* MBEDTLS_SSL_SRV_C */
  6776. /* Check if a certificate message is expected.
  6777. * Return either
  6778. * - SSL_CERTIFICATE_EXPECTED, or
  6779. * - SSL_CERTIFICATE_SKIP
  6780. * indicating whether a Certificate message is expected or not.
  6781. */
  6782. #define SSL_CERTIFICATE_EXPECTED 0
  6783. #define SSL_CERTIFICATE_SKIP 1
  6784. MBEDTLS_CHECK_RETURN_CRITICAL
  6785. static int ssl_parse_certificate_coordinate(mbedtls_ssl_context *ssl,
  6786. int authmode)
  6787. {
  6788. const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
  6789. ssl->handshake->ciphersuite_info;
  6790. if (!mbedtls_ssl_ciphersuite_uses_srv_cert(ciphersuite_info)) {
  6791. return SSL_CERTIFICATE_SKIP;
  6792. }
  6793. #if defined(MBEDTLS_SSL_SRV_C)
  6794. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  6795. if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA_PSK) {
  6796. return SSL_CERTIFICATE_SKIP;
  6797. }
  6798. if (authmode == MBEDTLS_SSL_VERIFY_NONE) {
  6799. ssl->session_negotiate->verify_result =
  6800. MBEDTLS_X509_BADCERT_SKIP_VERIFY;
  6801. return SSL_CERTIFICATE_SKIP;
  6802. }
  6803. }
  6804. #else
  6805. ((void) authmode);
  6806. #endif /* MBEDTLS_SSL_SRV_C */
  6807. return SSL_CERTIFICATE_EXPECTED;
  6808. }
  6809. #if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  6810. MBEDTLS_CHECK_RETURN_CRITICAL
  6811. static int ssl_remember_peer_crt_digest(mbedtls_ssl_context *ssl,
  6812. unsigned char *start, size_t len)
  6813. {
  6814. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6815. /* Remember digest of the peer's end-CRT. */
  6816. ssl->session_negotiate->peer_cert_digest =
  6817. mbedtls_calloc(1, MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN);
  6818. if (ssl->session_negotiate->peer_cert_digest == NULL) {
  6819. MBEDTLS_SSL_DEBUG_MSG(1, ("alloc(%d bytes) failed",
  6820. MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN));
  6821. mbedtls_ssl_send_alert_message(ssl,
  6822. MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6823. MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR);
  6824. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  6825. }
  6826. ret = mbedtls_md(mbedtls_md_info_from_type(
  6827. MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE),
  6828. start, len,
  6829. ssl->session_negotiate->peer_cert_digest);
  6830. ssl->session_negotiate->peer_cert_digest_type =
  6831. MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE;
  6832. ssl->session_negotiate->peer_cert_digest_len =
  6833. MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN;
  6834. return ret;
  6835. }
  6836. MBEDTLS_CHECK_RETURN_CRITICAL
  6837. static int ssl_remember_peer_pubkey(mbedtls_ssl_context *ssl,
  6838. unsigned char *start, size_t len)
  6839. {
  6840. unsigned char *end = start + len;
  6841. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6842. /* Make a copy of the peer's raw public key. */
  6843. mbedtls_pk_init(&ssl->handshake->peer_pubkey);
  6844. ret = mbedtls_pk_parse_subpubkey(&start, end,
  6845. &ssl->handshake->peer_pubkey);
  6846. if (ret != 0) {
  6847. /* We should have parsed the public key before. */
  6848. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  6849. }
  6850. return 0;
  6851. }
  6852. #endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  6853. int mbedtls_ssl_parse_certificate(mbedtls_ssl_context *ssl)
  6854. {
  6855. int ret = 0;
  6856. int crt_expected;
  6857. /* Authmode: precedence order is SNI if used else configuration */
  6858. #if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  6859. const int authmode = ssl->handshake->sni_authmode != MBEDTLS_SSL_VERIFY_UNSET
  6860. ? ssl->handshake->sni_authmode
  6861. : ssl->conf->authmode;
  6862. #else
  6863. const int authmode = ssl->conf->authmode;
  6864. #endif
  6865. void *rs_ctx = NULL;
  6866. mbedtls_x509_crt *chain = NULL;
  6867. MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse certificate"));
  6868. crt_expected = ssl_parse_certificate_coordinate(ssl, authmode);
  6869. if (crt_expected == SSL_CERTIFICATE_SKIP) {
  6870. MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate"));
  6871. goto exit;
  6872. }
  6873. #if defined(MBEDTLS_SSL_ECP_RESTARTABLE_ENABLED)
  6874. if (ssl->handshake->ecrs_enabled &&
  6875. ssl->handshake->ecrs_state == ssl_ecrs_crt_verify) {
  6876. chain = ssl->handshake->ecrs_peer_cert;
  6877. ssl->handshake->ecrs_peer_cert = NULL;
  6878. goto crt_verify;
  6879. }
  6880. #endif
  6881. if ((ret = mbedtls_ssl_read_record(ssl, 1)) != 0) {
  6882. /* mbedtls_ssl_read_record may have sent an alert already. We
  6883. let it decide whether to alert. */
  6884. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_read_record", ret);
  6885. goto exit;
  6886. }
  6887. #if defined(MBEDTLS_SSL_SRV_C)
  6888. if (ssl_srv_check_client_no_crt_notification(ssl) == 0) {
  6889. ssl->session_negotiate->verify_result = MBEDTLS_X509_BADCERT_MISSING;
  6890. if (authmode != MBEDTLS_SSL_VERIFY_OPTIONAL) {
  6891. ret = MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE;
  6892. }
  6893. goto exit;
  6894. }
  6895. #endif /* MBEDTLS_SSL_SRV_C */
  6896. /* Clear existing peer CRT structure in case we tried to
  6897. * reuse a session but it failed, and allocate a new one. */
  6898. ssl_clear_peer_cert(ssl->session_negotiate);
  6899. chain = mbedtls_calloc(1, sizeof(mbedtls_x509_crt));
  6900. if (chain == NULL) {
  6901. MBEDTLS_SSL_DEBUG_MSG(1, ("alloc(%" MBEDTLS_PRINTF_SIZET " bytes) failed",
  6902. sizeof(mbedtls_x509_crt)));
  6903. mbedtls_ssl_send_alert_message(ssl,
  6904. MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  6905. MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR);
  6906. ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
  6907. goto exit;
  6908. }
  6909. mbedtls_x509_crt_init(chain);
  6910. ret = ssl_parse_certificate_chain(ssl, chain);
  6911. if (ret != 0) {
  6912. goto exit;
  6913. }
  6914. #if defined(MBEDTLS_SSL_ECP_RESTARTABLE_ENABLED)
  6915. if (ssl->handshake->ecrs_enabled) {
  6916. ssl->handshake->ecrs_state = ssl_ecrs_crt_verify;
  6917. }
  6918. crt_verify:
  6919. if (ssl->handshake->ecrs_enabled) {
  6920. rs_ctx = &ssl->handshake->ecrs_ctx;
  6921. }
  6922. #endif
  6923. ret = mbedtls_ssl_verify_certificate(ssl, authmode, chain,
  6924. ssl->handshake->ciphersuite_info,
  6925. rs_ctx);
  6926. if (ret != 0) {
  6927. goto exit;
  6928. }
  6929. #if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
  6930. {
  6931. unsigned char *crt_start, *pk_start;
  6932. size_t crt_len, pk_len;
  6933. /* We parse the CRT chain without copying, so
  6934. * these pointers point into the input buffer,
  6935. * and are hence still valid after freeing the
  6936. * CRT chain. */
  6937. crt_start = chain->raw.p;
  6938. crt_len = chain->raw.len;
  6939. pk_start = chain->pk_raw.p;
  6940. pk_len = chain->pk_raw.len;
  6941. /* Free the CRT structures before computing
  6942. * digest and copying the peer's public key. */
  6943. mbedtls_x509_crt_free(chain);
  6944. mbedtls_free(chain);
  6945. chain = NULL;
  6946. ret = ssl_remember_peer_crt_digest(ssl, crt_start, crt_len);
  6947. if (ret != 0) {
  6948. goto exit;
  6949. }
  6950. ret = ssl_remember_peer_pubkey(ssl, pk_start, pk_len);
  6951. if (ret != 0) {
  6952. goto exit;
  6953. }
  6954. }
  6955. #else /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  6956. /* Pass ownership to session structure. */
  6957. ssl->session_negotiate->peer_cert = chain;
  6958. chain = NULL;
  6959. #endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
  6960. MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse certificate"));
  6961. exit:
  6962. if (ret == 0) {
  6963. ssl->state++;
  6964. }
  6965. #if defined(MBEDTLS_SSL_ECP_RESTARTABLE_ENABLED)
  6966. if (ret == MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS) {
  6967. ssl->handshake->ecrs_peer_cert = chain;
  6968. chain = NULL;
  6969. }
  6970. #endif
  6971. if (chain != NULL) {
  6972. mbedtls_x509_crt_free(chain);
  6973. mbedtls_free(chain);
  6974. }
  6975. return ret;
  6976. }
  6977. #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
  6978. static int ssl_calc_finished_tls_generic(mbedtls_ssl_context *ssl, void *ctx,
  6979. unsigned char *padbuf, size_t hlen,
  6980. unsigned char *buf, int from)
  6981. {
  6982. unsigned int len = 12;
  6983. const char *sender;
  6984. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  6985. psa_status_t status;
  6986. psa_hash_operation_t *hs_op = ctx;
  6987. psa_hash_operation_t cloned_op = PSA_HASH_OPERATION_INIT;
  6988. size_t hash_size;
  6989. #else
  6990. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  6991. mbedtls_md_context_t *hs_ctx = ctx;
  6992. mbedtls_md_context_t cloned_ctx;
  6993. mbedtls_md_init(&cloned_ctx);
  6994. #endif
  6995. mbedtls_ssl_session *session = ssl->session_negotiate;
  6996. if (!session) {
  6997. session = ssl->session;
  6998. }
  6999. sender = (from == MBEDTLS_SSL_IS_CLIENT)
  7000. ? "client finished"
  7001. : "server finished";
  7002. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7003. MBEDTLS_SSL_DEBUG_MSG(2, ("=> calc PSA finished tls"));
  7004. status = psa_hash_clone(hs_op, &cloned_op);
  7005. if (status != PSA_SUCCESS) {
  7006. goto exit;
  7007. }
  7008. status = psa_hash_finish(&cloned_op, padbuf, hlen, &hash_size);
  7009. if (status != PSA_SUCCESS) {
  7010. goto exit;
  7011. }
  7012. MBEDTLS_SSL_DEBUG_BUF(3, "PSA calculated padbuf", padbuf, hlen);
  7013. #else
  7014. MBEDTLS_SSL_DEBUG_MSG(2, ("=> calc finished tls"));
  7015. ret = mbedtls_md_setup(&cloned_ctx, mbedtls_md_info_from_ctx(hs_ctx), 0);
  7016. if (ret != 0) {
  7017. goto exit;
  7018. }
  7019. ret = mbedtls_md_clone(&cloned_ctx, hs_ctx);
  7020. if (ret != 0) {
  7021. goto exit;
  7022. }
  7023. ret = mbedtls_md_finish(&cloned_ctx, padbuf);
  7024. if (ret != 0) {
  7025. goto exit;
  7026. }
  7027. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7028. MBEDTLS_SSL_DEBUG_BUF(4, "finished output", padbuf, hlen);
  7029. /*
  7030. * TLSv1.2:
  7031. * hash = PRF( master, finished_label,
  7032. * Hash( handshake ) )[0.11]
  7033. */
  7034. ssl->handshake->tls_prf(session->master, 48, sender,
  7035. padbuf, hlen, buf, len);
  7036. MBEDTLS_SSL_DEBUG_BUF(3, "calc finished result", buf, len);
  7037. mbedtls_platform_zeroize(padbuf, hlen);
  7038. MBEDTLS_SSL_DEBUG_MSG(2, ("<= calc finished"));
  7039. exit:
  7040. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7041. psa_hash_abort(&cloned_op);
  7042. return mbedtls_md_error_from_psa(status);
  7043. #else
  7044. mbedtls_md_free(&cloned_ctx);
  7045. return ret;
  7046. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7047. }
  7048. #if defined(MBEDTLS_MD_CAN_SHA256)
  7049. static int ssl_calc_finished_tls_sha256(
  7050. mbedtls_ssl_context *ssl, unsigned char *buf, int from)
  7051. {
  7052. unsigned char padbuf[32];
  7053. return ssl_calc_finished_tls_generic(ssl,
  7054. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7055. &ssl->handshake->fin_sha256_psa,
  7056. #else
  7057. &ssl->handshake->fin_sha256,
  7058. #endif
  7059. padbuf, sizeof(padbuf),
  7060. buf, from);
  7061. }
  7062. #endif /* MBEDTLS_MD_CAN_SHA256*/
  7063. #if defined(MBEDTLS_MD_CAN_SHA384)
  7064. static int ssl_calc_finished_tls_sha384(
  7065. mbedtls_ssl_context *ssl, unsigned char *buf, int from)
  7066. {
  7067. unsigned char padbuf[48];
  7068. return ssl_calc_finished_tls_generic(ssl,
  7069. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7070. &ssl->handshake->fin_sha384_psa,
  7071. #else
  7072. &ssl->handshake->fin_sha384,
  7073. #endif
  7074. padbuf, sizeof(padbuf),
  7075. buf, from);
  7076. }
  7077. #endif /* MBEDTLS_MD_CAN_SHA384*/
  7078. void mbedtls_ssl_handshake_wrapup_free_hs_transform(mbedtls_ssl_context *ssl)
  7079. {
  7080. MBEDTLS_SSL_DEBUG_MSG(3, ("=> handshake wrapup: final free"));
  7081. /*
  7082. * Free our handshake params
  7083. */
  7084. mbedtls_ssl_handshake_free(ssl);
  7085. mbedtls_free(ssl->handshake);
  7086. ssl->handshake = NULL;
  7087. /*
  7088. * Free the previous transform and switch in the current one
  7089. */
  7090. if (ssl->transform) {
  7091. mbedtls_ssl_transform_free(ssl->transform);
  7092. mbedtls_free(ssl->transform);
  7093. }
  7094. ssl->transform = ssl->transform_negotiate;
  7095. ssl->transform_negotiate = NULL;
  7096. MBEDTLS_SSL_DEBUG_MSG(3, ("<= handshake wrapup: final free"));
  7097. }
  7098. void mbedtls_ssl_handshake_wrapup(mbedtls_ssl_context *ssl)
  7099. {
  7100. int resume = ssl->handshake->resume;
  7101. MBEDTLS_SSL_DEBUG_MSG(3, ("=> handshake wrapup"));
  7102. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  7103. if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS) {
  7104. ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_DONE;
  7105. ssl->renego_records_seen = 0;
  7106. }
  7107. #endif
  7108. /*
  7109. * Free the previous session and switch in the current one
  7110. */
  7111. if (ssl->session) {
  7112. #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  7113. /* RFC 7366 3.1: keep the EtM state */
  7114. ssl->session_negotiate->encrypt_then_mac =
  7115. ssl->session->encrypt_then_mac;
  7116. #endif
  7117. mbedtls_ssl_session_free(ssl->session);
  7118. mbedtls_free(ssl->session);
  7119. }
  7120. ssl->session = ssl->session_negotiate;
  7121. ssl->session_negotiate = NULL;
  7122. /*
  7123. * Add cache entry
  7124. */
  7125. if (ssl->conf->f_set_cache != NULL &&
  7126. ssl->session->id_len != 0 &&
  7127. resume == 0) {
  7128. if (ssl->conf->f_set_cache(ssl->conf->p_cache,
  7129. ssl->session->id,
  7130. ssl->session->id_len,
  7131. ssl->session) != 0) {
  7132. MBEDTLS_SSL_DEBUG_MSG(1, ("cache did not store session"));
  7133. }
  7134. }
  7135. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  7136. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
  7137. ssl->handshake->flight != NULL) {
  7138. /* Cancel handshake timer */
  7139. mbedtls_ssl_set_timer(ssl, 0);
  7140. /* Keep last flight around in case we need to resend it:
  7141. * we need the handshake and transform structures for that */
  7142. MBEDTLS_SSL_DEBUG_MSG(3, ("skip freeing handshake and transform"));
  7143. } else
  7144. #endif
  7145. mbedtls_ssl_handshake_wrapup_free_hs_transform(ssl);
  7146. ssl->state = MBEDTLS_SSL_HANDSHAKE_OVER;
  7147. MBEDTLS_SSL_DEBUG_MSG(3, ("<= handshake wrapup"));
  7148. }
  7149. int mbedtls_ssl_write_finished(mbedtls_ssl_context *ssl)
  7150. {
  7151. int ret;
  7152. unsigned int hash_len;
  7153. MBEDTLS_SSL_DEBUG_MSG(2, ("=> write finished"));
  7154. mbedtls_ssl_update_out_pointers(ssl, ssl->transform_negotiate);
  7155. ret = ssl->handshake->calc_finished(ssl, ssl->out_msg + 4, ssl->conf->endpoint);
  7156. if (ret != 0) {
  7157. MBEDTLS_SSL_DEBUG_RET(1, "calc_finished", ret);
  7158. }
  7159. /*
  7160. * RFC 5246 7.4.9 (Page 63) says 12 is the default length and ciphersuites
  7161. * may define some other value. Currently (early 2016), no defined
  7162. * ciphersuite does this (and this is unlikely to change as activity has
  7163. * moved to TLS 1.3 now) so we can keep the hardcoded 12 here.
  7164. */
  7165. hash_len = 12;
  7166. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  7167. ssl->verify_data_len = hash_len;
  7168. memcpy(ssl->own_verify_data, ssl->out_msg + 4, hash_len);
  7169. #endif
  7170. ssl->out_msglen = 4 + hash_len;
  7171. ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
  7172. ssl->out_msg[0] = MBEDTLS_SSL_HS_FINISHED;
  7173. /*
  7174. * In case of session resuming, invert the client and server
  7175. * ChangeCipherSpec messages order.
  7176. */
  7177. if (ssl->handshake->resume != 0) {
  7178. #if defined(MBEDTLS_SSL_CLI_C)
  7179. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  7180. ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
  7181. }
  7182. #endif
  7183. #if defined(MBEDTLS_SSL_SRV_C)
  7184. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  7185. ssl->state = MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC;
  7186. }
  7187. #endif
  7188. } else {
  7189. ssl->state++;
  7190. }
  7191. /*
  7192. * Switch to our negotiated transform and session parameters for outbound
  7193. * data.
  7194. */
  7195. MBEDTLS_SSL_DEBUG_MSG(3, ("switching to new transform spec for outbound data"));
  7196. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  7197. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  7198. unsigned char i;
  7199. /* Remember current epoch settings for resending */
  7200. ssl->handshake->alt_transform_out = ssl->transform_out;
  7201. memcpy(ssl->handshake->alt_out_ctr, ssl->cur_out_ctr,
  7202. sizeof(ssl->handshake->alt_out_ctr));
  7203. /* Set sequence_number to zero */
  7204. memset(&ssl->cur_out_ctr[2], 0, sizeof(ssl->cur_out_ctr) - 2);
  7205. /* Increment epoch */
  7206. for (i = 2; i > 0; i--) {
  7207. if (++ssl->cur_out_ctr[i - 1] != 0) {
  7208. break;
  7209. }
  7210. }
  7211. /* The loop goes to its end iff the counter is wrapping */
  7212. if (i == 0) {
  7213. MBEDTLS_SSL_DEBUG_MSG(1, ("DTLS epoch would wrap"));
  7214. return MBEDTLS_ERR_SSL_COUNTER_WRAPPING;
  7215. }
  7216. } else
  7217. #endif /* MBEDTLS_SSL_PROTO_DTLS */
  7218. memset(ssl->cur_out_ctr, 0, sizeof(ssl->cur_out_ctr));
  7219. ssl->transform_out = ssl->transform_negotiate;
  7220. ssl->session_out = ssl->session_negotiate;
  7221. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  7222. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  7223. mbedtls_ssl_send_flight_completed(ssl);
  7224. }
  7225. #endif
  7226. if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
  7227. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
  7228. return ret;
  7229. }
  7230. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  7231. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
  7232. (ret = mbedtls_ssl_flight_transmit(ssl)) != 0) {
  7233. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_flight_transmit", ret);
  7234. return ret;
  7235. }
  7236. #endif
  7237. MBEDTLS_SSL_DEBUG_MSG(2, ("<= write finished"));
  7238. return 0;
  7239. }
  7240. #define SSL_MAX_HASH_LEN 12
  7241. int mbedtls_ssl_parse_finished(mbedtls_ssl_context *ssl)
  7242. {
  7243. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  7244. unsigned int hash_len = 12;
  7245. unsigned char buf[SSL_MAX_HASH_LEN];
  7246. MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse finished"));
  7247. ret = ssl->handshake->calc_finished(ssl, buf, ssl->conf->endpoint ^ 1);
  7248. if (ret != 0) {
  7249. MBEDTLS_SSL_DEBUG_RET(1, "calc_finished", ret);
  7250. }
  7251. if ((ret = mbedtls_ssl_read_record(ssl, 1)) != 0) {
  7252. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_read_record", ret);
  7253. goto exit;
  7254. }
  7255. if (ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE) {
  7256. MBEDTLS_SSL_DEBUG_MSG(1, ("bad finished message"));
  7257. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  7258. MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE);
  7259. ret = MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
  7260. goto exit;
  7261. }
  7262. if (ssl->in_msg[0] != MBEDTLS_SSL_HS_FINISHED) {
  7263. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  7264. MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE);
  7265. ret = MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
  7266. goto exit;
  7267. }
  7268. if (ssl->in_hslen != mbedtls_ssl_hs_hdr_len(ssl) + hash_len) {
  7269. MBEDTLS_SSL_DEBUG_MSG(1, ("bad finished message"));
  7270. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  7271. MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
  7272. ret = MBEDTLS_ERR_SSL_DECODE_ERROR;
  7273. goto exit;
  7274. }
  7275. if (mbedtls_ct_memcmp(ssl->in_msg + mbedtls_ssl_hs_hdr_len(ssl),
  7276. buf, hash_len) != 0) {
  7277. MBEDTLS_SSL_DEBUG_MSG(1, ("bad finished message"));
  7278. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  7279. MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR);
  7280. ret = MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
  7281. goto exit;
  7282. }
  7283. #if defined(MBEDTLS_SSL_RENEGOTIATION)
  7284. ssl->verify_data_len = hash_len;
  7285. memcpy(ssl->peer_verify_data, buf, hash_len);
  7286. #endif
  7287. if (ssl->handshake->resume != 0) {
  7288. #if defined(MBEDTLS_SSL_CLI_C)
  7289. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT) {
  7290. ssl->state = MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC;
  7291. }
  7292. #endif
  7293. #if defined(MBEDTLS_SSL_SRV_C)
  7294. if (ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER) {
  7295. ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
  7296. }
  7297. #endif
  7298. } else {
  7299. ssl->state++;
  7300. }
  7301. #if defined(MBEDTLS_SSL_PROTO_DTLS)
  7302. if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
  7303. mbedtls_ssl_recv_flight_completed(ssl);
  7304. }
  7305. #endif
  7306. MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse finished"));
  7307. exit:
  7308. mbedtls_platform_zeroize(buf, hash_len);
  7309. return ret;
  7310. }
  7311. #if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
  7312. /*
  7313. * Helper to get TLS 1.2 PRF from ciphersuite
  7314. * (Duplicates bits of logic from ssl_set_handshake_prfs().)
  7315. */
  7316. static tls_prf_fn ssl_tls12prf_from_cs(int ciphersuite_id)
  7317. {
  7318. const mbedtls_ssl_ciphersuite_t * const ciphersuite_info =
  7319. mbedtls_ssl_ciphersuite_from_id(ciphersuite_id);
  7320. #if defined(MBEDTLS_MD_CAN_SHA384)
  7321. if (ciphersuite_info != NULL && ciphersuite_info->mac == MBEDTLS_MD_SHA384) {
  7322. return tls_prf_sha384;
  7323. } else
  7324. #endif
  7325. #if defined(MBEDTLS_MD_CAN_SHA256)
  7326. {
  7327. if (ciphersuite_info != NULL && ciphersuite_info->mac == MBEDTLS_MD_SHA256) {
  7328. return tls_prf_sha256;
  7329. }
  7330. }
  7331. #endif
  7332. #if !defined(MBEDTLS_MD_CAN_SHA384) && \
  7333. !defined(MBEDTLS_MD_CAN_SHA256)
  7334. (void) ciphersuite_info;
  7335. #endif
  7336. return NULL;
  7337. }
  7338. #endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
  7339. static mbedtls_tls_prf_types tls_prf_get_type(mbedtls_ssl_tls_prf_cb *tls_prf)
  7340. {
  7341. ((void) tls_prf);
  7342. #if defined(MBEDTLS_MD_CAN_SHA384)
  7343. if (tls_prf == tls_prf_sha384) {
  7344. return MBEDTLS_SSL_TLS_PRF_SHA384;
  7345. } else
  7346. #endif
  7347. #if defined(MBEDTLS_MD_CAN_SHA256)
  7348. if (tls_prf == tls_prf_sha256) {
  7349. return MBEDTLS_SSL_TLS_PRF_SHA256;
  7350. } else
  7351. #endif
  7352. return MBEDTLS_SSL_TLS_PRF_NONE;
  7353. }
  7354. /*
  7355. * Populate a transform structure with session keys and all the other
  7356. * necessary information.
  7357. *
  7358. * Parameters:
  7359. * - [in/out]: transform: structure to populate
  7360. * [in] must be just initialised with mbedtls_ssl_transform_init()
  7361. * [out] fully populated, ready for use by mbedtls_ssl_{en,de}crypt_buf()
  7362. * - [in] ciphersuite
  7363. * - [in] master
  7364. * - [in] encrypt_then_mac
  7365. * - [in] tls_prf: pointer to PRF to use for key derivation
  7366. * - [in] randbytes: buffer holding ServerHello.random + ClientHello.random
  7367. * - [in] tls_version: TLS version
  7368. * - [in] endpoint: client or server
  7369. * - [in] ssl: used for:
  7370. * - ssl->conf->{f,p}_export_keys
  7371. * [in] optionally used for:
  7372. * - MBEDTLS_DEBUG_C: ssl->conf->{f,p}_dbg
  7373. */
  7374. MBEDTLS_CHECK_RETURN_CRITICAL
  7375. static int ssl_tls12_populate_transform(mbedtls_ssl_transform *transform,
  7376. int ciphersuite,
  7377. const unsigned char master[48],
  7378. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  7379. int encrypt_then_mac,
  7380. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
  7381. ssl_tls_prf_t tls_prf,
  7382. const unsigned char randbytes[64],
  7383. mbedtls_ssl_protocol_version tls_version,
  7384. unsigned endpoint,
  7385. const mbedtls_ssl_context *ssl)
  7386. {
  7387. int ret = 0;
  7388. unsigned char keyblk[256];
  7389. unsigned char *key1;
  7390. unsigned char *key2;
  7391. unsigned char *mac_enc;
  7392. unsigned char *mac_dec;
  7393. size_t mac_key_len = 0;
  7394. size_t iv_copy_len;
  7395. size_t keylen;
  7396. const mbedtls_ssl_ciphersuite_t *ciphersuite_info;
  7397. mbedtls_ssl_mode_t ssl_mode;
  7398. #if !defined(MBEDTLS_USE_PSA_CRYPTO)
  7399. const mbedtls_cipher_info_t *cipher_info;
  7400. const mbedtls_md_info_t *md_info;
  7401. #endif /* !MBEDTLS_USE_PSA_CRYPTO */
  7402. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7403. psa_key_type_t key_type;
  7404. psa_key_attributes_t attributes = PSA_KEY_ATTRIBUTES_INIT;
  7405. psa_algorithm_t alg;
  7406. psa_algorithm_t mac_alg = 0;
  7407. size_t key_bits;
  7408. psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
  7409. #endif
  7410. /*
  7411. * Some data just needs copying into the structure
  7412. */
  7413. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  7414. transform->encrypt_then_mac = encrypt_then_mac;
  7415. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
  7416. transform->tls_version = tls_version;
  7417. #if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
  7418. memcpy(transform->randbytes, randbytes, sizeof(transform->randbytes));
  7419. #endif
  7420. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  7421. if (tls_version == MBEDTLS_SSL_VERSION_TLS1_3) {
  7422. /* At the moment, we keep TLS <= 1.2 and TLS 1.3 transform
  7423. * generation separate. This should never happen. */
  7424. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  7425. }
  7426. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  7427. /*
  7428. * Get various info structures
  7429. */
  7430. ciphersuite_info = mbedtls_ssl_ciphersuite_from_id(ciphersuite);
  7431. if (ciphersuite_info == NULL) {
  7432. MBEDTLS_SSL_DEBUG_MSG(1, ("ciphersuite info for %d not found",
  7433. ciphersuite));
  7434. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  7435. }
  7436. ssl_mode = mbedtls_ssl_get_mode_from_ciphersuite(
  7437. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  7438. encrypt_then_mac,
  7439. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
  7440. ciphersuite_info);
  7441. if (ssl_mode == MBEDTLS_SSL_MODE_AEAD) {
  7442. transform->taglen =
  7443. ciphersuite_info->flags & MBEDTLS_CIPHERSUITE_SHORT_TAG ? 8 : 16;
  7444. }
  7445. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7446. if ((status = mbedtls_ssl_cipher_to_psa((mbedtls_cipher_type_t) ciphersuite_info->cipher,
  7447. transform->taglen,
  7448. &alg,
  7449. &key_type,
  7450. &key_bits)) != PSA_SUCCESS) {
  7451. ret = PSA_TO_MBEDTLS_ERR(status);
  7452. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_cipher_to_psa", ret);
  7453. goto end;
  7454. }
  7455. #else
  7456. cipher_info = mbedtls_cipher_info_from_type((mbedtls_cipher_type_t) ciphersuite_info->cipher);
  7457. if (cipher_info == NULL) {
  7458. MBEDTLS_SSL_DEBUG_MSG(1, ("cipher info for %u not found",
  7459. ciphersuite_info->cipher));
  7460. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  7461. }
  7462. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7463. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7464. mac_alg = mbedtls_md_psa_alg_from_type((mbedtls_md_type_t) ciphersuite_info->mac);
  7465. if (mac_alg == 0) {
  7466. MBEDTLS_SSL_DEBUG_MSG(1, ("mbedtls_md_psa_alg_from_type for %u not found",
  7467. (unsigned) ciphersuite_info->mac));
  7468. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  7469. }
  7470. #else
  7471. md_info = mbedtls_md_info_from_type((mbedtls_md_type_t) ciphersuite_info->mac);
  7472. if (md_info == NULL) {
  7473. MBEDTLS_SSL_DEBUG_MSG(1, ("mbedtls_md info for %u not found",
  7474. (unsigned) ciphersuite_info->mac));
  7475. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  7476. }
  7477. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7478. #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
  7479. /* Copy own and peer's CID if the use of the CID
  7480. * extension has been negotiated. */
  7481. if (ssl->handshake->cid_in_use == MBEDTLS_SSL_CID_ENABLED) {
  7482. MBEDTLS_SSL_DEBUG_MSG(3, ("Copy CIDs into SSL transform"));
  7483. transform->in_cid_len = ssl->own_cid_len;
  7484. memcpy(transform->in_cid, ssl->own_cid, ssl->own_cid_len);
  7485. MBEDTLS_SSL_DEBUG_BUF(3, "Incoming CID", transform->in_cid,
  7486. transform->in_cid_len);
  7487. transform->out_cid_len = ssl->handshake->peer_cid_len;
  7488. memcpy(transform->out_cid, ssl->handshake->peer_cid,
  7489. ssl->handshake->peer_cid_len);
  7490. MBEDTLS_SSL_DEBUG_BUF(3, "Outgoing CID", transform->out_cid,
  7491. transform->out_cid_len);
  7492. }
  7493. #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
  7494. /*
  7495. * Compute key block using the PRF
  7496. */
  7497. ret = tls_prf(master, 48, "key expansion", randbytes, 64, keyblk, 256);
  7498. if (ret != 0) {
  7499. MBEDTLS_SSL_DEBUG_RET(1, "prf", ret);
  7500. return ret;
  7501. }
  7502. MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite = %s",
  7503. mbedtls_ssl_get_ciphersuite_name(ciphersuite)));
  7504. MBEDTLS_SSL_DEBUG_BUF(3, "master secret", master, 48);
  7505. MBEDTLS_SSL_DEBUG_BUF(4, "random bytes", randbytes, 64);
  7506. MBEDTLS_SSL_DEBUG_BUF(4, "key block", keyblk, 256);
  7507. /*
  7508. * Determine the appropriate key, IV and MAC length.
  7509. */
  7510. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7511. keylen = PSA_BITS_TO_BYTES(key_bits);
  7512. #else
  7513. keylen = mbedtls_cipher_info_get_key_bitlen(cipher_info) / 8;
  7514. #endif
  7515. #if defined(MBEDTLS_SSL_HAVE_AEAD)
  7516. if (ssl_mode == MBEDTLS_SSL_MODE_AEAD) {
  7517. size_t explicit_ivlen;
  7518. transform->maclen = 0;
  7519. mac_key_len = 0;
  7520. /* All modes haves 96-bit IVs, but the length of the static parts vary
  7521. * with mode and version:
  7522. * - For GCM and CCM in TLS 1.2, there's a static IV of 4 Bytes
  7523. * (to be concatenated with a dynamically chosen IV of 8 Bytes)
  7524. * - For ChaChaPoly in TLS 1.2, and all modes in TLS 1.3, there's
  7525. * a static IV of 12 Bytes (to be XOR'ed with the 8 Byte record
  7526. * sequence number).
  7527. */
  7528. transform->ivlen = 12;
  7529. int is_chachapoly = 0;
  7530. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7531. is_chachapoly = (key_type == PSA_KEY_TYPE_CHACHA20);
  7532. #else
  7533. is_chachapoly = (mbedtls_cipher_info_get_mode(cipher_info)
  7534. == MBEDTLS_MODE_CHACHAPOLY);
  7535. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7536. if (is_chachapoly) {
  7537. transform->fixed_ivlen = 12;
  7538. } else {
  7539. transform->fixed_ivlen = 4;
  7540. }
  7541. /* Minimum length of encrypted record */
  7542. explicit_ivlen = transform->ivlen - transform->fixed_ivlen;
  7543. transform->minlen = explicit_ivlen + transform->taglen;
  7544. } else
  7545. #endif /* MBEDTLS_SSL_HAVE_AEAD */
  7546. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_MAC)
  7547. if (ssl_mode == MBEDTLS_SSL_MODE_STREAM ||
  7548. ssl_mode == MBEDTLS_SSL_MODE_CBC ||
  7549. ssl_mode == MBEDTLS_SSL_MODE_CBC_ETM) {
  7550. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7551. size_t block_size = PSA_BLOCK_CIPHER_BLOCK_LENGTH(key_type);
  7552. #else
  7553. size_t block_size = mbedtls_cipher_info_get_block_size(cipher_info);
  7554. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7555. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7556. /* Get MAC length */
  7557. mac_key_len = PSA_HASH_LENGTH(mac_alg);
  7558. #else
  7559. /* Initialize HMAC contexts */
  7560. if ((ret = mbedtls_md_setup(&transform->md_ctx_enc, md_info, 1)) != 0 ||
  7561. (ret = mbedtls_md_setup(&transform->md_ctx_dec, md_info, 1)) != 0) {
  7562. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_setup", ret);
  7563. goto end;
  7564. }
  7565. /* Get MAC length */
  7566. mac_key_len = mbedtls_md_get_size(md_info);
  7567. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7568. transform->maclen = mac_key_len;
  7569. /* IV length */
  7570. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7571. transform->ivlen = PSA_CIPHER_IV_LENGTH(key_type, alg);
  7572. #else
  7573. transform->ivlen = mbedtls_cipher_info_get_iv_size(cipher_info);
  7574. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7575. /* Minimum length */
  7576. if (ssl_mode == MBEDTLS_SSL_MODE_STREAM) {
  7577. transform->minlen = transform->maclen;
  7578. } else {
  7579. /*
  7580. * GenericBlockCipher:
  7581. * 1. if EtM is in use: one block plus MAC
  7582. * otherwise: * first multiple of blocklen greater than maclen
  7583. * 2. IV
  7584. */
  7585. #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
  7586. if (ssl_mode == MBEDTLS_SSL_MODE_CBC_ETM) {
  7587. transform->minlen = transform->maclen
  7588. + block_size;
  7589. } else
  7590. #endif
  7591. {
  7592. transform->minlen = transform->maclen
  7593. + block_size
  7594. - transform->maclen % block_size;
  7595. }
  7596. if (tls_version == MBEDTLS_SSL_VERSION_TLS1_2) {
  7597. transform->minlen += transform->ivlen;
  7598. } else {
  7599. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  7600. ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  7601. goto end;
  7602. }
  7603. }
  7604. } else
  7605. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_MAC */
  7606. {
  7607. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  7608. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  7609. }
  7610. MBEDTLS_SSL_DEBUG_MSG(3, ("keylen: %u, minlen: %u, ivlen: %u, maclen: %u",
  7611. (unsigned) keylen,
  7612. (unsigned) transform->minlen,
  7613. (unsigned) transform->ivlen,
  7614. (unsigned) transform->maclen));
  7615. /*
  7616. * Finally setup the cipher contexts, IVs and MAC secrets.
  7617. */
  7618. #if defined(MBEDTLS_SSL_CLI_C)
  7619. if (endpoint == MBEDTLS_SSL_IS_CLIENT) {
  7620. key1 = keyblk + mac_key_len * 2;
  7621. key2 = keyblk + mac_key_len * 2 + keylen;
  7622. mac_enc = keyblk;
  7623. mac_dec = keyblk + mac_key_len;
  7624. iv_copy_len = (transform->fixed_ivlen) ?
  7625. transform->fixed_ivlen : transform->ivlen;
  7626. memcpy(transform->iv_enc, key2 + keylen, iv_copy_len);
  7627. memcpy(transform->iv_dec, key2 + keylen + iv_copy_len,
  7628. iv_copy_len);
  7629. } else
  7630. #endif /* MBEDTLS_SSL_CLI_C */
  7631. #if defined(MBEDTLS_SSL_SRV_C)
  7632. if (endpoint == MBEDTLS_SSL_IS_SERVER) {
  7633. key1 = keyblk + mac_key_len * 2 + keylen;
  7634. key2 = keyblk + mac_key_len * 2;
  7635. mac_enc = keyblk + mac_key_len;
  7636. mac_dec = keyblk;
  7637. iv_copy_len = (transform->fixed_ivlen) ?
  7638. transform->fixed_ivlen : transform->ivlen;
  7639. memcpy(transform->iv_dec, key1 + keylen, iv_copy_len);
  7640. memcpy(transform->iv_enc, key1 + keylen + iv_copy_len,
  7641. iv_copy_len);
  7642. } else
  7643. #endif /* MBEDTLS_SSL_SRV_C */
  7644. {
  7645. MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
  7646. ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  7647. goto end;
  7648. }
  7649. if (ssl->f_export_keys != NULL) {
  7650. ssl->f_export_keys(ssl->p_export_keys,
  7651. MBEDTLS_SSL_KEY_EXPORT_TLS12_MASTER_SECRET,
  7652. master, 48,
  7653. randbytes + 32,
  7654. randbytes,
  7655. tls_prf_get_type(tls_prf));
  7656. }
  7657. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7658. transform->psa_alg = alg;
  7659. if (alg != MBEDTLS_SSL_NULL_CIPHER) {
  7660. psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_ENCRYPT);
  7661. psa_set_key_algorithm(&attributes, alg);
  7662. psa_set_key_type(&attributes, key_type);
  7663. if ((status = psa_import_key(&attributes,
  7664. key1,
  7665. PSA_BITS_TO_BYTES(key_bits),
  7666. &transform->psa_key_enc)) != PSA_SUCCESS) {
  7667. MBEDTLS_SSL_DEBUG_RET(3, "psa_import_key", (int) status);
  7668. ret = PSA_TO_MBEDTLS_ERR(status);
  7669. MBEDTLS_SSL_DEBUG_RET(1, "psa_import_key", ret);
  7670. goto end;
  7671. }
  7672. psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_DECRYPT);
  7673. if ((status = psa_import_key(&attributes,
  7674. key2,
  7675. PSA_BITS_TO_BYTES(key_bits),
  7676. &transform->psa_key_dec)) != PSA_SUCCESS) {
  7677. ret = PSA_TO_MBEDTLS_ERR(status);
  7678. MBEDTLS_SSL_DEBUG_RET(1, "psa_import_key", ret);
  7679. goto end;
  7680. }
  7681. }
  7682. #else
  7683. if ((ret = mbedtls_cipher_setup(&transform->cipher_ctx_enc,
  7684. cipher_info)) != 0) {
  7685. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_cipher_setup", ret);
  7686. goto end;
  7687. }
  7688. if ((ret = mbedtls_cipher_setup(&transform->cipher_ctx_dec,
  7689. cipher_info)) != 0) {
  7690. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_cipher_setup", ret);
  7691. goto end;
  7692. }
  7693. if ((ret = mbedtls_cipher_setkey(&transform->cipher_ctx_enc, key1,
  7694. (int) mbedtls_cipher_info_get_key_bitlen(cipher_info),
  7695. MBEDTLS_ENCRYPT)) != 0) {
  7696. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_cipher_setkey", ret);
  7697. goto end;
  7698. }
  7699. if ((ret = mbedtls_cipher_setkey(&transform->cipher_ctx_dec, key2,
  7700. (int) mbedtls_cipher_info_get_key_bitlen(cipher_info),
  7701. MBEDTLS_DECRYPT)) != 0) {
  7702. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_cipher_setkey", ret);
  7703. goto end;
  7704. }
  7705. #if defined(MBEDTLS_CIPHER_MODE_CBC)
  7706. if (mbedtls_cipher_info_get_mode(cipher_info) == MBEDTLS_MODE_CBC) {
  7707. if ((ret = mbedtls_cipher_set_padding_mode(&transform->cipher_ctx_enc,
  7708. MBEDTLS_PADDING_NONE)) != 0) {
  7709. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_cipher_set_padding_mode", ret);
  7710. goto end;
  7711. }
  7712. if ((ret = mbedtls_cipher_set_padding_mode(&transform->cipher_ctx_dec,
  7713. MBEDTLS_PADDING_NONE)) != 0) {
  7714. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_cipher_set_padding_mode", ret);
  7715. goto end;
  7716. }
  7717. }
  7718. #endif /* MBEDTLS_CIPHER_MODE_CBC */
  7719. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7720. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_MAC)
  7721. /* For HMAC-based ciphersuites, initialize the HMAC transforms.
  7722. For AEAD-based ciphersuites, there is nothing to do here. */
  7723. if (mac_key_len != 0) {
  7724. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7725. transform->psa_mac_alg = PSA_ALG_HMAC(mac_alg);
  7726. psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_SIGN_MESSAGE);
  7727. psa_set_key_algorithm(&attributes, PSA_ALG_HMAC(mac_alg));
  7728. psa_set_key_type(&attributes, PSA_KEY_TYPE_HMAC);
  7729. if ((status = psa_import_key(&attributes,
  7730. mac_enc, mac_key_len,
  7731. &transform->psa_mac_enc)) != PSA_SUCCESS) {
  7732. ret = PSA_TO_MBEDTLS_ERR(status);
  7733. MBEDTLS_SSL_DEBUG_RET(1, "psa_import_mac_key", ret);
  7734. goto end;
  7735. }
  7736. if ((transform->psa_alg == MBEDTLS_SSL_NULL_CIPHER) ||
  7737. ((transform->psa_alg == PSA_ALG_CBC_NO_PADDING)
  7738. #if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
  7739. && (transform->encrypt_then_mac == MBEDTLS_SSL_ETM_DISABLED)
  7740. #endif
  7741. )) {
  7742. /* mbedtls_ct_hmac() requires the key to be exportable */
  7743. psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_EXPORT |
  7744. PSA_KEY_USAGE_VERIFY_HASH);
  7745. } else {
  7746. psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_VERIFY_HASH);
  7747. }
  7748. if ((status = psa_import_key(&attributes,
  7749. mac_dec, mac_key_len,
  7750. &transform->psa_mac_dec)) != PSA_SUCCESS) {
  7751. ret = PSA_TO_MBEDTLS_ERR(status);
  7752. MBEDTLS_SSL_DEBUG_RET(1, "psa_import_mac_key", ret);
  7753. goto end;
  7754. }
  7755. #else
  7756. ret = mbedtls_md_hmac_starts(&transform->md_ctx_enc, mac_enc, mac_key_len);
  7757. if (ret != 0) {
  7758. goto end;
  7759. }
  7760. ret = mbedtls_md_hmac_starts(&transform->md_ctx_dec, mac_dec, mac_key_len);
  7761. if (ret != 0) {
  7762. goto end;
  7763. }
  7764. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7765. }
  7766. #endif /* MBEDTLS_SSL_SOME_SUITES_USE_MAC */
  7767. ((void) mac_dec);
  7768. ((void) mac_enc);
  7769. end:
  7770. mbedtls_platform_zeroize(keyblk, sizeof(keyblk));
  7771. return ret;
  7772. }
  7773. #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED) && \
  7774. defined(MBEDTLS_USE_PSA_CRYPTO)
  7775. int mbedtls_psa_ecjpake_read_round(
  7776. psa_pake_operation_t *pake_ctx,
  7777. const unsigned char *buf,
  7778. size_t len, mbedtls_ecjpake_rounds_t round)
  7779. {
  7780. psa_status_t status;
  7781. size_t input_offset = 0;
  7782. /*
  7783. * At round one repeat the KEY_SHARE, ZK_PUBLIC & ZF_PROOF twice
  7784. * At round two perform a single cycle
  7785. */
  7786. unsigned int remaining_steps = (round == MBEDTLS_ECJPAKE_ROUND_ONE) ? 2 : 1;
  7787. for (; remaining_steps > 0; remaining_steps--) {
  7788. for (psa_pake_step_t step = PSA_PAKE_STEP_KEY_SHARE;
  7789. step <= PSA_PAKE_STEP_ZK_PROOF;
  7790. ++step) {
  7791. /* Length is stored at the first byte */
  7792. size_t length = buf[input_offset];
  7793. input_offset += 1;
  7794. if (input_offset + length > len) {
  7795. return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
  7796. }
  7797. status = psa_pake_input(pake_ctx, step,
  7798. buf + input_offset, length);
  7799. if (status != PSA_SUCCESS) {
  7800. return PSA_TO_MBEDTLS_ERR(status);
  7801. }
  7802. input_offset += length;
  7803. }
  7804. }
  7805. if (input_offset != len) {
  7806. return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
  7807. }
  7808. return 0;
  7809. }
  7810. int mbedtls_psa_ecjpake_write_round(
  7811. psa_pake_operation_t *pake_ctx,
  7812. unsigned char *buf,
  7813. size_t len, size_t *olen,
  7814. mbedtls_ecjpake_rounds_t round)
  7815. {
  7816. psa_status_t status;
  7817. size_t output_offset = 0;
  7818. size_t output_len;
  7819. /*
  7820. * At round one repeat the KEY_SHARE, ZK_PUBLIC & ZF_PROOF twice
  7821. * At round two perform a single cycle
  7822. */
  7823. unsigned int remaining_steps = (round == MBEDTLS_ECJPAKE_ROUND_ONE) ? 2 : 1;
  7824. for (; remaining_steps > 0; remaining_steps--) {
  7825. for (psa_pake_step_t step = PSA_PAKE_STEP_KEY_SHARE;
  7826. step <= PSA_PAKE_STEP_ZK_PROOF;
  7827. ++step) {
  7828. /*
  7829. * For each step, prepend 1 byte with the length of the data as
  7830. * given by psa_pake_output().
  7831. */
  7832. status = psa_pake_output(pake_ctx, step,
  7833. buf + output_offset + 1,
  7834. len - output_offset - 1,
  7835. &output_len);
  7836. if (status != PSA_SUCCESS) {
  7837. return PSA_TO_MBEDTLS_ERR(status);
  7838. }
  7839. *(buf + output_offset) = (uint8_t) output_len;
  7840. output_offset += output_len + 1;
  7841. }
  7842. }
  7843. *olen = output_offset;
  7844. return 0;
  7845. }
  7846. #endif //MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED && MBEDTLS_USE_PSA_CRYPTO
  7847. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7848. int mbedtls_ssl_get_key_exchange_md_tls1_2(mbedtls_ssl_context *ssl,
  7849. unsigned char *hash, size_t *hashlen,
  7850. unsigned char *data, size_t data_len,
  7851. mbedtls_md_type_t md_alg)
  7852. {
  7853. psa_status_t status;
  7854. psa_hash_operation_t hash_operation = PSA_HASH_OPERATION_INIT;
  7855. psa_algorithm_t hash_alg = mbedtls_md_psa_alg_from_type(md_alg);
  7856. MBEDTLS_SSL_DEBUG_MSG(3, ("Perform PSA-based computation of digest of ServerKeyExchange"));
  7857. if ((status = psa_hash_setup(&hash_operation,
  7858. hash_alg)) != PSA_SUCCESS) {
  7859. MBEDTLS_SSL_DEBUG_RET(1, "psa_hash_setup", status);
  7860. goto exit;
  7861. }
  7862. if ((status = psa_hash_update(&hash_operation, ssl->handshake->randbytes,
  7863. 64)) != PSA_SUCCESS) {
  7864. MBEDTLS_SSL_DEBUG_RET(1, "psa_hash_update", status);
  7865. goto exit;
  7866. }
  7867. if ((status = psa_hash_update(&hash_operation,
  7868. data, data_len)) != PSA_SUCCESS) {
  7869. MBEDTLS_SSL_DEBUG_RET(1, "psa_hash_update", status);
  7870. goto exit;
  7871. }
  7872. if ((status = psa_hash_finish(&hash_operation, hash, PSA_HASH_MAX_SIZE,
  7873. hashlen)) != PSA_SUCCESS) {
  7874. MBEDTLS_SSL_DEBUG_RET(1, "psa_hash_finish", status);
  7875. goto exit;
  7876. }
  7877. exit:
  7878. if (status != PSA_SUCCESS) {
  7879. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  7880. MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR);
  7881. switch (status) {
  7882. case PSA_ERROR_NOT_SUPPORTED:
  7883. return MBEDTLS_ERR_MD_FEATURE_UNAVAILABLE;
  7884. case PSA_ERROR_BAD_STATE: /* Intentional fallthrough */
  7885. case PSA_ERROR_BUFFER_TOO_SMALL:
  7886. return MBEDTLS_ERR_MD_BAD_INPUT_DATA;
  7887. case PSA_ERROR_INSUFFICIENT_MEMORY:
  7888. return MBEDTLS_ERR_MD_ALLOC_FAILED;
  7889. default:
  7890. return MBEDTLS_ERR_PLATFORM_HW_ACCEL_FAILED;
  7891. }
  7892. }
  7893. return 0;
  7894. }
  7895. #else
  7896. int mbedtls_ssl_get_key_exchange_md_tls1_2(mbedtls_ssl_context *ssl,
  7897. unsigned char *hash, size_t *hashlen,
  7898. unsigned char *data, size_t data_len,
  7899. mbedtls_md_type_t md_alg)
  7900. {
  7901. int ret = 0;
  7902. mbedtls_md_context_t ctx;
  7903. const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type(md_alg);
  7904. *hashlen = mbedtls_md_get_size(md_info);
  7905. MBEDTLS_SSL_DEBUG_MSG(3, ("Perform mbedtls-based computation of digest of ServerKeyExchange"));
  7906. mbedtls_md_init(&ctx);
  7907. /*
  7908. * digitally-signed struct {
  7909. * opaque client_random[32];
  7910. * opaque server_random[32];
  7911. * ServerDHParams params;
  7912. * };
  7913. */
  7914. if ((ret = mbedtls_md_setup(&ctx, md_info, 0)) != 0) {
  7915. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_setup", ret);
  7916. goto exit;
  7917. }
  7918. if ((ret = mbedtls_md_starts(&ctx)) != 0) {
  7919. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_starts", ret);
  7920. goto exit;
  7921. }
  7922. if ((ret = mbedtls_md_update(&ctx, ssl->handshake->randbytes, 64)) != 0) {
  7923. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_update", ret);
  7924. goto exit;
  7925. }
  7926. if ((ret = mbedtls_md_update(&ctx, data, data_len)) != 0) {
  7927. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_update", ret);
  7928. goto exit;
  7929. }
  7930. if ((ret = mbedtls_md_finish(&ctx, hash)) != 0) {
  7931. MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_md_finish", ret);
  7932. goto exit;
  7933. }
  7934. exit:
  7935. mbedtls_md_free(&ctx);
  7936. if (ret != 0) {
  7937. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  7938. MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR);
  7939. }
  7940. return ret;
  7941. }
  7942. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7943. #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
  7944. /* Find the preferred hash for a given signature algorithm. */
  7945. unsigned int mbedtls_ssl_tls12_get_preferred_hash_for_sig_alg(
  7946. mbedtls_ssl_context *ssl,
  7947. unsigned int sig_alg)
  7948. {
  7949. unsigned int i;
  7950. uint16_t *received_sig_algs = ssl->handshake->received_sig_algs;
  7951. if (sig_alg == MBEDTLS_SSL_SIG_ANON) {
  7952. return MBEDTLS_SSL_HASH_NONE;
  7953. }
  7954. for (i = 0; received_sig_algs[i] != MBEDTLS_TLS_SIG_NONE; i++) {
  7955. unsigned int hash_alg_received =
  7956. MBEDTLS_SSL_TLS12_HASH_ALG_FROM_SIG_AND_HASH_ALG(
  7957. received_sig_algs[i]);
  7958. unsigned int sig_alg_received =
  7959. MBEDTLS_SSL_TLS12_SIG_ALG_FROM_SIG_AND_HASH_ALG(
  7960. received_sig_algs[i]);
  7961. mbedtls_md_type_t md_alg =
  7962. mbedtls_ssl_md_alg_from_hash((unsigned char) hash_alg_received);
  7963. if (md_alg == MBEDTLS_MD_NONE) {
  7964. continue;
  7965. }
  7966. if (sig_alg == sig_alg_received) {
  7967. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  7968. if (ssl->handshake->key_cert && ssl->handshake->key_cert->key) {
  7969. psa_algorithm_t psa_hash_alg =
  7970. mbedtls_md_psa_alg_from_type(md_alg);
  7971. if (sig_alg_received == MBEDTLS_SSL_SIG_ECDSA &&
  7972. !mbedtls_pk_can_do_ext(ssl->handshake->key_cert->key,
  7973. PSA_ALG_ECDSA(psa_hash_alg),
  7974. PSA_KEY_USAGE_SIGN_HASH)) {
  7975. continue;
  7976. }
  7977. if (sig_alg_received == MBEDTLS_SSL_SIG_RSA &&
  7978. !mbedtls_pk_can_do_ext(ssl->handshake->key_cert->key,
  7979. PSA_ALG_RSA_PKCS1V15_SIGN(
  7980. psa_hash_alg),
  7981. PSA_KEY_USAGE_SIGN_HASH)) {
  7982. continue;
  7983. }
  7984. }
  7985. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  7986. return hash_alg_received;
  7987. }
  7988. }
  7989. return MBEDTLS_SSL_HASH_NONE;
  7990. }
  7991. #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
  7992. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  7993. int mbedtls_ssl_validate_ciphersuite(
  7994. const mbedtls_ssl_context *ssl,
  7995. const mbedtls_ssl_ciphersuite_t *suite_info,
  7996. mbedtls_ssl_protocol_version min_tls_version,
  7997. mbedtls_ssl_protocol_version max_tls_version)
  7998. {
  7999. (void) ssl;
  8000. if (suite_info == NULL) {
  8001. return -1;
  8002. }
  8003. if ((suite_info->min_tls_version > max_tls_version) ||
  8004. (suite_info->max_tls_version < min_tls_version)) {
  8005. return -1;
  8006. }
  8007. #if defined(MBEDTLS_SSL_PROTO_TLS1_2) && defined(MBEDTLS_SSL_CLI_C)
  8008. #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
  8009. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  8010. if (suite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE &&
  8011. ssl->handshake->psa_pake_ctx_is_ok != 1)
  8012. #else
  8013. if (suite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE &&
  8014. mbedtls_ecjpake_check(&ssl->handshake->ecjpake_ctx) != 0)
  8015. #endif /* MBEDTLS_USE_PSA_CRYPTO */
  8016. {
  8017. return -1;
  8018. }
  8019. #endif
  8020. /* Don't suggest PSK-based ciphersuite if no PSK is available. */
  8021. #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
  8022. if (mbedtls_ssl_ciphersuite_uses_psk(suite_info) &&
  8023. mbedtls_ssl_conf_has_static_psk(ssl->conf) == 0) {
  8024. return -1;
  8025. }
  8026. #endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
  8027. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
  8028. return 0;
  8029. }
  8030. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  8031. /*
  8032. * Function for writing a signature algorithm extension.
  8033. *
  8034. * The `extension_data` field of signature algorithm contains a `SignatureSchemeList`
  8035. * value (TLS 1.3 RFC8446):
  8036. * enum {
  8037. * ....
  8038. * ecdsa_secp256r1_sha256( 0x0403 ),
  8039. * ecdsa_secp384r1_sha384( 0x0503 ),
  8040. * ecdsa_secp521r1_sha512( 0x0603 ),
  8041. * ....
  8042. * } SignatureScheme;
  8043. *
  8044. * struct {
  8045. * SignatureScheme supported_signature_algorithms<2..2^16-2>;
  8046. * } SignatureSchemeList;
  8047. *
  8048. * The `extension_data` field of signature algorithm contains a `SignatureAndHashAlgorithm`
  8049. * value (TLS 1.2 RFC5246):
  8050. * enum {
  8051. * none(0), md5(1), sha1(2), sha224(3), sha256(4), sha384(5),
  8052. * sha512(6), (255)
  8053. * } HashAlgorithm;
  8054. *
  8055. * enum { anonymous(0), rsa(1), dsa(2), ecdsa(3), (255) }
  8056. * SignatureAlgorithm;
  8057. *
  8058. * struct {
  8059. * HashAlgorithm hash;
  8060. * SignatureAlgorithm signature;
  8061. * } SignatureAndHashAlgorithm;
  8062. *
  8063. * SignatureAndHashAlgorithm
  8064. * supported_signature_algorithms<2..2^16-2>;
  8065. *
  8066. * The TLS 1.3 signature algorithm extension was defined to be a compatible
  8067. * generalization of the TLS 1.2 signature algorithm extension.
  8068. * `SignatureAndHashAlgorithm` field of TLS 1.2 can be represented by
  8069. * `SignatureScheme` field of TLS 1.3
  8070. *
  8071. */
  8072. int mbedtls_ssl_write_sig_alg_ext(mbedtls_ssl_context *ssl, unsigned char *buf,
  8073. const unsigned char *end, size_t *out_len)
  8074. {
  8075. unsigned char *p = buf;
  8076. unsigned char *supported_sig_alg; /* Start of supported_signature_algorithms */
  8077. size_t supported_sig_alg_len = 0; /* Length of supported_signature_algorithms */
  8078. *out_len = 0;
  8079. MBEDTLS_SSL_DEBUG_MSG(3, ("adding signature_algorithms extension"));
  8080. /* Check if we have space for header and length field:
  8081. * - extension_type (2 bytes)
  8082. * - extension_data_length (2 bytes)
  8083. * - supported_signature_algorithms_length (2 bytes)
  8084. */
  8085. MBEDTLS_SSL_CHK_BUF_PTR(p, end, 6);
  8086. p += 6;
  8087. /*
  8088. * Write supported_signature_algorithms
  8089. */
  8090. supported_sig_alg = p;
  8091. const uint16_t *sig_alg = mbedtls_ssl_get_sig_algs(ssl);
  8092. if (sig_alg == NULL) {
  8093. return MBEDTLS_ERR_SSL_BAD_CONFIG;
  8094. }
  8095. for (; *sig_alg != MBEDTLS_TLS1_3_SIG_NONE; sig_alg++) {
  8096. MBEDTLS_SSL_DEBUG_MSG(3, ("got signature scheme [%x] %s",
  8097. *sig_alg,
  8098. mbedtls_ssl_sig_alg_to_str(*sig_alg)));
  8099. if (!mbedtls_ssl_sig_alg_is_supported(ssl, *sig_alg)) {
  8100. continue;
  8101. }
  8102. MBEDTLS_SSL_CHK_BUF_PTR(p, end, 2);
  8103. MBEDTLS_PUT_UINT16_BE(*sig_alg, p, 0);
  8104. p += 2;
  8105. MBEDTLS_SSL_DEBUG_MSG(3, ("sent signature scheme [%x] %s",
  8106. *sig_alg,
  8107. mbedtls_ssl_sig_alg_to_str(*sig_alg)));
  8108. }
  8109. /* Length of supported_signature_algorithms */
  8110. supported_sig_alg_len = (size_t) (p - supported_sig_alg);
  8111. if (supported_sig_alg_len == 0) {
  8112. MBEDTLS_SSL_DEBUG_MSG(1, ("No signature algorithms defined."));
  8113. return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
  8114. }
  8115. MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_SIG_ALG, buf, 0);
  8116. MBEDTLS_PUT_UINT16_BE(supported_sig_alg_len + 2, buf, 2);
  8117. MBEDTLS_PUT_UINT16_BE(supported_sig_alg_len, buf, 4);
  8118. *out_len = (size_t) (p - buf);
  8119. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  8120. mbedtls_ssl_tls13_set_hs_sent_ext_mask(ssl, MBEDTLS_TLS_EXT_SIG_ALG);
  8121. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */
  8122. return 0;
  8123. }
  8124. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  8125. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  8126. /*
  8127. * mbedtls_ssl_parse_server_name_ext
  8128. *
  8129. * Structure of server_name extension:
  8130. *
  8131. * enum {
  8132. * host_name(0), (255)
  8133. * } NameType;
  8134. * opaque HostName<1..2^16-1>;
  8135. *
  8136. * struct {
  8137. * NameType name_type;
  8138. * select (name_type) {
  8139. * case host_name: HostName;
  8140. * } name;
  8141. * } ServerName;
  8142. * struct {
  8143. * ServerName server_name_list<1..2^16-1>
  8144. * } ServerNameList;
  8145. */
  8146. MBEDTLS_CHECK_RETURN_CRITICAL
  8147. int mbedtls_ssl_parse_server_name_ext(mbedtls_ssl_context *ssl,
  8148. const unsigned char *buf,
  8149. const unsigned char *end)
  8150. {
  8151. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  8152. const unsigned char *p = buf;
  8153. size_t server_name_list_len, hostname_len;
  8154. const unsigned char *server_name_list_end;
  8155. MBEDTLS_SSL_DEBUG_MSG(3, ("parse ServerName extension"));
  8156. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, end, 2);
  8157. server_name_list_len = MBEDTLS_GET_UINT16_BE(p, 0);
  8158. p += 2;
  8159. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, end, server_name_list_len);
  8160. server_name_list_end = p + server_name_list_len;
  8161. while (p < server_name_list_end) {
  8162. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, server_name_list_end, 3);
  8163. hostname_len = MBEDTLS_GET_UINT16_BE(p, 1);
  8164. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, server_name_list_end,
  8165. hostname_len + 3);
  8166. if (p[0] == MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME) {
  8167. /* sni_name is intended to be used only during the parsing of the
  8168. * ClientHello message (it is reset to NULL before the end of
  8169. * the message parsing). Thus it is ok to just point to the
  8170. * reception buffer and not make a copy of it.
  8171. */
  8172. ssl->handshake->sni_name = p + 3;
  8173. ssl->handshake->sni_name_len = hostname_len;
  8174. if (ssl->conf->f_sni == NULL) {
  8175. return 0;
  8176. }
  8177. ret = ssl->conf->f_sni(ssl->conf->p_sni,
  8178. ssl, p + 3, hostname_len);
  8179. if (ret != 0) {
  8180. MBEDTLS_SSL_DEBUG_RET(1, "ssl_sni_wrapper", ret);
  8181. MBEDTLS_SSL_PEND_FATAL_ALERT(MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME,
  8182. MBEDTLS_ERR_SSL_UNRECOGNIZED_NAME);
  8183. return MBEDTLS_ERR_SSL_UNRECOGNIZED_NAME;
  8184. }
  8185. return 0;
  8186. }
  8187. p += hostname_len + 3;
  8188. }
  8189. return 0;
  8190. }
  8191. #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
  8192. #if defined(MBEDTLS_SSL_ALPN)
  8193. MBEDTLS_CHECK_RETURN_CRITICAL
  8194. int mbedtls_ssl_parse_alpn_ext(mbedtls_ssl_context *ssl,
  8195. const unsigned char *buf,
  8196. const unsigned char *end)
  8197. {
  8198. const unsigned char *p = buf;
  8199. size_t protocol_name_list_len;
  8200. const unsigned char *protocol_name_list;
  8201. const unsigned char *protocol_name_list_end;
  8202. size_t protocol_name_len;
  8203. /* If ALPN not configured, just ignore the extension */
  8204. if (ssl->conf->alpn_list == NULL) {
  8205. return 0;
  8206. }
  8207. /*
  8208. * RFC7301, section 3.1
  8209. * opaque ProtocolName<1..2^8-1>;
  8210. *
  8211. * struct {
  8212. * ProtocolName protocol_name_list<2..2^16-1>
  8213. * } ProtocolNameList;
  8214. */
  8215. /*
  8216. * protocol_name_list_len 2 bytes
  8217. * protocol_name_len 1 bytes
  8218. * protocol_name >=1 byte
  8219. */
  8220. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, end, 4);
  8221. protocol_name_list_len = MBEDTLS_GET_UINT16_BE(p, 0);
  8222. p += 2;
  8223. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, end, protocol_name_list_len);
  8224. protocol_name_list = p;
  8225. protocol_name_list_end = p + protocol_name_list_len;
  8226. /* Validate peer's list (lengths) */
  8227. while (p < protocol_name_list_end) {
  8228. protocol_name_len = *p++;
  8229. MBEDTLS_SSL_CHK_BUF_READ_PTR(p, protocol_name_list_end,
  8230. protocol_name_len);
  8231. if (protocol_name_len == 0) {
  8232. MBEDTLS_SSL_PEND_FATAL_ALERT(
  8233. MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER,
  8234. MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER);
  8235. return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
  8236. }
  8237. p += protocol_name_len;
  8238. }
  8239. /* Use our order of preference */
  8240. for (const char **alpn = ssl->conf->alpn_list; *alpn != NULL; alpn++) {
  8241. size_t const alpn_len = strlen(*alpn);
  8242. p = protocol_name_list;
  8243. while (p < protocol_name_list_end) {
  8244. protocol_name_len = *p++;
  8245. if (protocol_name_len == alpn_len &&
  8246. memcmp(p, *alpn, alpn_len) == 0) {
  8247. ssl->alpn_chosen = *alpn;
  8248. return 0;
  8249. }
  8250. p += protocol_name_len;
  8251. }
  8252. }
  8253. /* If we get here, no match was found */
  8254. MBEDTLS_SSL_PEND_FATAL_ALERT(
  8255. MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL,
  8256. MBEDTLS_ERR_SSL_NO_APPLICATION_PROTOCOL);
  8257. return MBEDTLS_ERR_SSL_NO_APPLICATION_PROTOCOL;
  8258. }
  8259. int mbedtls_ssl_write_alpn_ext(mbedtls_ssl_context *ssl,
  8260. unsigned char *buf,
  8261. unsigned char *end,
  8262. size_t *out_len)
  8263. {
  8264. unsigned char *p = buf;
  8265. size_t protocol_name_len;
  8266. *out_len = 0;
  8267. if (ssl->alpn_chosen == NULL) {
  8268. return 0;
  8269. }
  8270. protocol_name_len = strlen(ssl->alpn_chosen);
  8271. MBEDTLS_SSL_CHK_BUF_PTR(p, end, 7 + protocol_name_len);
  8272. MBEDTLS_SSL_DEBUG_MSG(3, ("server side, adding alpn extension"));
  8273. /*
  8274. * 0 . 1 ext identifier
  8275. * 2 . 3 ext length
  8276. * 4 . 5 protocol list length
  8277. * 6 . 6 protocol name length
  8278. * 7 . 7+n protocol name
  8279. */
  8280. MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_ALPN, p, 0);
  8281. *out_len = 7 + protocol_name_len;
  8282. MBEDTLS_PUT_UINT16_BE(protocol_name_len + 3, p, 2);
  8283. MBEDTLS_PUT_UINT16_BE(protocol_name_len + 1, p, 4);
  8284. /* Note: the length of the chosen protocol has been checked to be less
  8285. * than 255 bytes in `mbedtls_ssl_conf_alpn_protocols`.
  8286. */
  8287. p[6] = MBEDTLS_BYTE_0(protocol_name_len);
  8288. memcpy(p + 7, ssl->alpn_chosen, protocol_name_len);
  8289. #if defined(MBEDTLS_SSL_PROTO_TLS1_3)
  8290. mbedtls_ssl_tls13_set_hs_sent_ext_mask(ssl, MBEDTLS_TLS_EXT_ALPN);
  8291. #endif
  8292. return 0;
  8293. }
  8294. #endif /* MBEDTLS_SSL_ALPN */
  8295. #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && \
  8296. defined(MBEDTLS_SSL_SESSION_TICKETS) && \
  8297. defined(MBEDTLS_SSL_SERVER_NAME_INDICATION) && \
  8298. defined(MBEDTLS_SSL_CLI_C)
  8299. int mbedtls_ssl_session_set_hostname(mbedtls_ssl_session *session,
  8300. const char *hostname)
  8301. {
  8302. /* Initialize to suppress unnecessary compiler warning */
  8303. size_t hostname_len = 0;
  8304. /* Check if new hostname is valid before
  8305. * making any change to current one */
  8306. if (hostname != NULL) {
  8307. hostname_len = strlen(hostname);
  8308. if (hostname_len > MBEDTLS_SSL_MAX_HOST_NAME_LEN) {
  8309. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  8310. }
  8311. }
  8312. /* Now it's clear that we will overwrite the old hostname,
  8313. * so we can free it safely */
  8314. if (session->hostname != NULL) {
  8315. mbedtls_zeroize_and_free(session->hostname,
  8316. strlen(session->hostname));
  8317. }
  8318. /* Passing NULL as hostname shall clear the old one */
  8319. if (hostname == NULL) {
  8320. session->hostname = NULL;
  8321. } else {
  8322. session->hostname = mbedtls_calloc(1, hostname_len + 1);
  8323. if (session->hostname == NULL) {
  8324. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  8325. }
  8326. memcpy(session->hostname, hostname, hostname_len);
  8327. }
  8328. return 0;
  8329. }
  8330. #endif /* MBEDTLS_SSL_PROTO_TLS1_3 &&
  8331. MBEDTLS_SSL_SESSION_TICKETS &&
  8332. MBEDTLS_SSL_SERVER_NAME_INDICATION &&
  8333. MBEDTLS_SSL_CLI_C */
  8334. #if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_EARLY_DATA) && \
  8335. defined(MBEDTLS_SSL_ALPN)
  8336. int mbedtls_ssl_session_set_ticket_alpn(mbedtls_ssl_session *session,
  8337. const char *alpn)
  8338. {
  8339. size_t alpn_len = 0;
  8340. if (alpn != NULL) {
  8341. alpn_len = strlen(alpn);
  8342. if (alpn_len > MBEDTLS_SSL_MAX_ALPN_NAME_LEN) {
  8343. return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
  8344. }
  8345. }
  8346. if (session->ticket_alpn != NULL) {
  8347. mbedtls_zeroize_and_free(session->ticket_alpn,
  8348. strlen(session->ticket_alpn));
  8349. session->ticket_alpn = NULL;
  8350. }
  8351. if (alpn != NULL) {
  8352. session->ticket_alpn = mbedtls_calloc(alpn_len + 1, 1);
  8353. if (session->ticket_alpn == NULL) {
  8354. return MBEDTLS_ERR_SSL_ALLOC_FAILED;
  8355. }
  8356. memcpy(session->ticket_alpn, alpn, alpn_len);
  8357. }
  8358. return 0;
  8359. }
  8360. #endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_EARLY_DATA && MBEDTLS_SSL_ALPN */
  8361. /*
  8362. * The following functions are used by 1.2 and 1.3, client and server.
  8363. */
  8364. #if defined(MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED)
  8365. int mbedtls_ssl_check_cert_usage(const mbedtls_x509_crt *cert,
  8366. const mbedtls_ssl_ciphersuite_t *ciphersuite,
  8367. int recv_endpoint,
  8368. mbedtls_ssl_protocol_version tls_version,
  8369. uint32_t *flags)
  8370. {
  8371. int ret = 0;
  8372. unsigned int usage = 0;
  8373. const char *ext_oid;
  8374. size_t ext_len;
  8375. /*
  8376. * keyUsage
  8377. */
  8378. /* Note: don't guard this with MBEDTLS_SSL_CLI_C because the server wants
  8379. * to check what a compliant client will think while choosing which cert
  8380. * to send to the client. */
  8381. #if defined(MBEDTLS_SSL_PROTO_TLS1_2)
  8382. if (tls_version == MBEDTLS_SSL_VERSION_TLS1_2 &&
  8383. recv_endpoint == MBEDTLS_SSL_IS_CLIENT) {
  8384. /* TLS 1.2 server part of the key exchange */
  8385. switch (ciphersuite->key_exchange) {
  8386. case MBEDTLS_KEY_EXCHANGE_RSA:
  8387. case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
  8388. usage = MBEDTLS_X509_KU_KEY_ENCIPHERMENT;
  8389. break;
  8390. case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
  8391. case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
  8392. case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
  8393. usage = MBEDTLS_X509_KU_DIGITAL_SIGNATURE;
  8394. break;
  8395. case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
  8396. case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
  8397. usage = MBEDTLS_X509_KU_KEY_AGREEMENT;
  8398. break;
  8399. /* Don't use default: we want warnings when adding new values */
  8400. case MBEDTLS_KEY_EXCHANGE_NONE:
  8401. case MBEDTLS_KEY_EXCHANGE_PSK:
  8402. case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
  8403. case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
  8404. case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
  8405. usage = 0;
  8406. }
  8407. } else
  8408. #endif
  8409. {
  8410. /* This is either TLS 1.3 authentication, which always uses signatures,
  8411. * or 1.2 client auth: rsa_sign and mbedtls_ecdsa_sign are the only
  8412. * options we implement, both using signatures. */
  8413. (void) tls_version;
  8414. (void) ciphersuite;
  8415. usage = MBEDTLS_X509_KU_DIGITAL_SIGNATURE;
  8416. }
  8417. if (mbedtls_x509_crt_check_key_usage(cert, usage) != 0) {
  8418. *flags |= MBEDTLS_X509_BADCERT_KEY_USAGE;
  8419. ret = -1;
  8420. }
  8421. /*
  8422. * extKeyUsage
  8423. */
  8424. if (recv_endpoint == MBEDTLS_SSL_IS_CLIENT) {
  8425. ext_oid = MBEDTLS_OID_SERVER_AUTH;
  8426. ext_len = MBEDTLS_OID_SIZE(MBEDTLS_OID_SERVER_AUTH);
  8427. } else {
  8428. ext_oid = MBEDTLS_OID_CLIENT_AUTH;
  8429. ext_len = MBEDTLS_OID_SIZE(MBEDTLS_OID_CLIENT_AUTH);
  8430. }
  8431. if (mbedtls_x509_crt_check_extended_key_usage(cert, ext_oid, ext_len) != 0) {
  8432. *flags |= MBEDTLS_X509_BADCERT_EXT_KEY_USAGE;
  8433. ret = -1;
  8434. }
  8435. return ret;
  8436. }
  8437. int mbedtls_ssl_verify_certificate(mbedtls_ssl_context *ssl,
  8438. int authmode,
  8439. mbedtls_x509_crt *chain,
  8440. const mbedtls_ssl_ciphersuite_t *ciphersuite_info,
  8441. void *rs_ctx)
  8442. {
  8443. if (authmode == MBEDTLS_SSL_VERIFY_NONE) {
  8444. return 0;
  8445. }
  8446. /*
  8447. * Primary check: use the appropriate X.509 verification function
  8448. */
  8449. int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
  8450. void *p_vrfy;
  8451. if (ssl->f_vrfy != NULL) {
  8452. MBEDTLS_SSL_DEBUG_MSG(3, ("Use context-specific verification callback"));
  8453. f_vrfy = ssl->f_vrfy;
  8454. p_vrfy = ssl->p_vrfy;
  8455. } else {
  8456. MBEDTLS_SSL_DEBUG_MSG(3, ("Use configuration-specific verification callback"));
  8457. f_vrfy = ssl->conf->f_vrfy;
  8458. p_vrfy = ssl->conf->p_vrfy;
  8459. }
  8460. int ret = 0;
  8461. int have_ca_chain_or_callback = 0;
  8462. #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
  8463. if (ssl->conf->f_ca_cb != NULL) {
  8464. ((void) rs_ctx);
  8465. have_ca_chain_or_callback = 1;
  8466. MBEDTLS_SSL_DEBUG_MSG(3, ("use CA callback for X.509 CRT verification"));
  8467. ret = mbedtls_x509_crt_verify_with_ca_cb(
  8468. chain,
  8469. ssl->conf->f_ca_cb,
  8470. ssl->conf->p_ca_cb,
  8471. ssl->conf->cert_profile,
  8472. ssl->hostname,
  8473. &ssl->session_negotiate->verify_result,
  8474. f_vrfy, p_vrfy);
  8475. } else
  8476. #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
  8477. {
  8478. mbedtls_x509_crt *ca_chain;
  8479. mbedtls_x509_crl *ca_crl;
  8480. #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
  8481. if (ssl->handshake->sni_ca_chain != NULL) {
  8482. ca_chain = ssl->handshake->sni_ca_chain;
  8483. ca_crl = ssl->handshake->sni_ca_crl;
  8484. } else
  8485. #endif
  8486. {
  8487. ca_chain = ssl->conf->ca_chain;
  8488. ca_crl = ssl->conf->ca_crl;
  8489. }
  8490. if (ca_chain != NULL) {
  8491. have_ca_chain_or_callback = 1;
  8492. }
  8493. ret = mbedtls_x509_crt_verify_restartable(
  8494. chain,
  8495. ca_chain, ca_crl,
  8496. ssl->conf->cert_profile,
  8497. ssl->hostname,
  8498. &ssl->session_negotiate->verify_result,
  8499. f_vrfy, p_vrfy, rs_ctx);
  8500. }
  8501. if (ret != 0) {
  8502. MBEDTLS_SSL_DEBUG_RET(1, "x509_verify_cert", ret);
  8503. }
  8504. #if defined(MBEDTLS_SSL_ECP_RESTARTABLE_ENABLED)
  8505. if (ret == MBEDTLS_ERR_ECP_IN_PROGRESS) {
  8506. return MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS;
  8507. }
  8508. #endif
  8509. /*
  8510. * Secondary checks: always done, but change 'ret' only if it was 0
  8511. */
  8512. /* With TLS 1.2 and ECC certs, check that the curve used by the
  8513. * certificate is on our list of acceptable curves.
  8514. *
  8515. * With TLS 1.3 this is not needed because the curve is part of the
  8516. * signature algorithm (eg ecdsa_secp256r1_sha256) which is checked when
  8517. * we validate the signature made with the key associated to this cert.
  8518. */
  8519. #if defined(MBEDTLS_SSL_PROTO_TLS1_2) && \
  8520. defined(MBEDTLS_PK_HAVE_ECC_KEYS)
  8521. if (ssl->tls_version == MBEDTLS_SSL_VERSION_TLS1_2 &&
  8522. mbedtls_pk_can_do(&chain->pk, MBEDTLS_PK_ECKEY)) {
  8523. if (mbedtls_ssl_check_curve(ssl, mbedtls_pk_get_ec_group_id(&chain->pk)) != 0) {
  8524. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate (EC key curve)"));
  8525. ssl->session_negotiate->verify_result |= MBEDTLS_X509_BADCERT_BAD_KEY;
  8526. if (ret == 0) {
  8527. ret = MBEDTLS_ERR_SSL_BAD_CERTIFICATE;
  8528. }
  8529. }
  8530. }
  8531. #endif /* MBEDTLS_SSL_PROTO_TLS1_2 && MBEDTLS_PK_HAVE_ECC_KEYS */
  8532. /* Check X.509 usage extensions (keyUsage, extKeyUsage) */
  8533. if (mbedtls_ssl_check_cert_usage(chain,
  8534. ciphersuite_info,
  8535. ssl->conf->endpoint,
  8536. ssl->tls_version,
  8537. &ssl->session_negotiate->verify_result) != 0) {
  8538. MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate (usage extensions)"));
  8539. if (ret == 0) {
  8540. ret = MBEDTLS_ERR_SSL_BAD_CERTIFICATE;
  8541. }
  8542. }
  8543. /* With authmode optional, we want to keep going if the certificate was
  8544. * unacceptable, but still fail on other errors (out of memory etc),
  8545. * including fatal errors from the f_vrfy callback.
  8546. *
  8547. * The only acceptable errors are:
  8548. * - MBEDTLS_ERR_X509_CERT_VERIFY_FAILED: cert rejected by primary check;
  8549. * - MBEDTLS_ERR_SSL_BAD_CERTIFICATE: cert rejected by secondary checks.
  8550. * Anything else is a fatal error. */
  8551. if (authmode == MBEDTLS_SSL_VERIFY_OPTIONAL &&
  8552. (ret == MBEDTLS_ERR_X509_CERT_VERIFY_FAILED ||
  8553. ret == MBEDTLS_ERR_SSL_BAD_CERTIFICATE)) {
  8554. ret = 0;
  8555. }
  8556. /* Return a specific error as this is a user error: inconsistent
  8557. * configuration - can't verify without trust anchors. */
  8558. if (have_ca_chain_or_callback == 0 && authmode == MBEDTLS_SSL_VERIFY_REQUIRED) {
  8559. MBEDTLS_SSL_DEBUG_MSG(1, ("got no CA chain"));
  8560. ret = MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED;
  8561. }
  8562. if (ret != 0) {
  8563. uint8_t alert;
  8564. /* The certificate may have been rejected for several reasons.
  8565. Pick one and send the corresponding alert. Which alert to send
  8566. may be a subject of debate in some cases. */
  8567. if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_OTHER) {
  8568. alert = MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED;
  8569. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_CN_MISMATCH) {
  8570. alert = MBEDTLS_SSL_ALERT_MSG_BAD_CERT;
  8571. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_KEY_USAGE) {
  8572. alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
  8573. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_EXT_KEY_USAGE) {
  8574. alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
  8575. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_BAD_PK) {
  8576. alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
  8577. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_BAD_KEY) {
  8578. alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
  8579. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_EXPIRED) {
  8580. alert = MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED;
  8581. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_REVOKED) {
  8582. alert = MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED;
  8583. } else if (ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_NOT_TRUSTED) {
  8584. alert = MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA;
  8585. } else {
  8586. alert = MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN;
  8587. }
  8588. mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
  8589. alert);
  8590. }
  8591. #if defined(MBEDTLS_DEBUG_C)
  8592. if (ssl->session_negotiate->verify_result != 0) {
  8593. MBEDTLS_SSL_DEBUG_MSG(3, ("! Certificate verification flags %08x",
  8594. (unsigned int) ssl->session_negotiate->verify_result));
  8595. } else {
  8596. MBEDTLS_SSL_DEBUG_MSG(3, ("Certificate verification flags clear"));
  8597. }
  8598. #endif /* MBEDTLS_DEBUG_C */
  8599. return ret;
  8600. }
  8601. #endif /* MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED */
  8602. #endif /* MBEDTLS_SSL_TLS_C */