pkparse.c 46 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529
  1. /*
  2. * Public Key layer for parsing key files and structures
  3. *
  4. * Copyright The Mbed TLS Contributors
  5. * SPDX-License-Identifier: Apache-2.0
  6. *
  7. * Licensed under the Apache License, Version 2.0 (the "License"); you may
  8. * not use this file except in compliance with the License.
  9. * You may obtain a copy of the License at
  10. *
  11. * http://www.apache.org/licenses/LICENSE-2.0
  12. *
  13. * Unless required by applicable law or agreed to in writing, software
  14. * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  15. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16. * See the License for the specific language governing permissions and
  17. * limitations under the License.
  18. */
  19. #include "common.h"
  20. #if defined(MBEDTLS_PK_PARSE_C)
  21. #include "mbedtls/pk.h"
  22. #include "mbedtls/asn1.h"
  23. #include "mbedtls/oid.h"
  24. #include "mbedtls/platform_util.h"
  25. #include "mbedtls/error.h"
  26. #include <string.h>
  27. #if defined(MBEDTLS_RSA_C)
  28. #include "mbedtls/rsa.h"
  29. #endif
  30. #if defined(MBEDTLS_ECP_C)
  31. #include "mbedtls/ecp.h"
  32. #endif
  33. #if defined(MBEDTLS_ECDSA_C)
  34. #include "mbedtls/ecdsa.h"
  35. #endif
  36. #if defined(MBEDTLS_PEM_PARSE_C)
  37. #include "mbedtls/pem.h"
  38. #endif
  39. #if defined(MBEDTLS_PKCS5_C)
  40. #include "mbedtls/pkcs5.h"
  41. #endif
  42. #if defined(MBEDTLS_PKCS12_C)
  43. #include "mbedtls/pkcs12.h"
  44. #endif
  45. #if defined(MBEDTLS_PLATFORM_C)
  46. #include "mbedtls/platform.h"
  47. #else
  48. #include <stdlib.h>
  49. #define mbedtls_calloc calloc
  50. #define mbedtls_free free
  51. #endif
  52. /* Parameter validation macros based on platform_util.h */
  53. #define PK_VALIDATE_RET( cond ) \
  54. MBEDTLS_INTERNAL_VALIDATE_RET( cond, MBEDTLS_ERR_PK_BAD_INPUT_DATA )
  55. #define PK_VALIDATE( cond ) \
  56. MBEDTLS_INTERNAL_VALIDATE( cond )
  57. #if defined(MBEDTLS_FS_IO)
  58. /*
  59. * Load all data from a file into a given buffer.
  60. *
  61. * The file is expected to contain either PEM or DER encoded data.
  62. * A terminating null byte is always appended. It is included in the announced
  63. * length only if the data looks like it is PEM encoded.
  64. */
  65. int mbedtls_pk_load_file( const char *path, unsigned char **buf, size_t *n )
  66. {
  67. FILE *f;
  68. long size;
  69. PK_VALIDATE_RET( path != NULL );
  70. PK_VALIDATE_RET( buf != NULL );
  71. PK_VALIDATE_RET( n != NULL );
  72. if( ( f = fopen( path, "rb" ) ) == NULL )
  73. return( MBEDTLS_ERR_PK_FILE_IO_ERROR );
  74. fseek( f, 0, SEEK_END );
  75. if( ( size = ftell( f ) ) == -1 )
  76. {
  77. fclose( f );
  78. return( MBEDTLS_ERR_PK_FILE_IO_ERROR );
  79. }
  80. fseek( f, 0, SEEK_SET );
  81. *n = (size_t) size;
  82. if( *n + 1 == 0 ||
  83. ( *buf = mbedtls_calloc( 1, *n + 1 ) ) == NULL )
  84. {
  85. fclose( f );
  86. return( MBEDTLS_ERR_PK_ALLOC_FAILED );
  87. }
  88. if( fread( *buf, 1, *n, f ) != *n )
  89. {
  90. fclose( f );
  91. mbedtls_platform_zeroize( *buf, *n );
  92. mbedtls_free( *buf );
  93. return( MBEDTLS_ERR_PK_FILE_IO_ERROR );
  94. }
  95. fclose( f );
  96. (*buf)[*n] = '\0';
  97. if( strstr( (const char *) *buf, "-----BEGIN " ) != NULL )
  98. ++*n;
  99. return( 0 );
  100. }
  101. /*
  102. * Load and parse a private key
  103. */
  104. int mbedtls_pk_parse_keyfile( mbedtls_pk_context *ctx,
  105. const char *path, const char *pwd,
  106. int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
  107. {
  108. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  109. size_t n;
  110. unsigned char *buf;
  111. PK_VALIDATE_RET( ctx != NULL );
  112. PK_VALIDATE_RET( path != NULL );
  113. if( ( ret = mbedtls_pk_load_file( path, &buf, &n ) ) != 0 )
  114. return( ret );
  115. if( pwd == NULL )
  116. ret = mbedtls_pk_parse_key( ctx, buf, n, NULL, 0, f_rng, p_rng );
  117. else
  118. ret = mbedtls_pk_parse_key( ctx, buf, n,
  119. (const unsigned char *) pwd, strlen( pwd ), f_rng, p_rng );
  120. mbedtls_platform_zeroize( buf, n );
  121. mbedtls_free( buf );
  122. return( ret );
  123. }
  124. /*
  125. * Load and parse a public key
  126. */
  127. int mbedtls_pk_parse_public_keyfile( mbedtls_pk_context *ctx, const char *path )
  128. {
  129. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  130. size_t n;
  131. unsigned char *buf;
  132. PK_VALIDATE_RET( ctx != NULL );
  133. PK_VALIDATE_RET( path != NULL );
  134. if( ( ret = mbedtls_pk_load_file( path, &buf, &n ) ) != 0 )
  135. return( ret );
  136. ret = mbedtls_pk_parse_public_key( ctx, buf, n );
  137. mbedtls_platform_zeroize( buf, n );
  138. mbedtls_free( buf );
  139. return( ret );
  140. }
  141. #endif /* MBEDTLS_FS_IO */
  142. #if defined(MBEDTLS_ECP_C)
  143. /* Minimally parse an ECParameters buffer to and mbedtls_asn1_buf
  144. *
  145. * ECParameters ::= CHOICE {
  146. * namedCurve OBJECT IDENTIFIER
  147. * specifiedCurve SpecifiedECDomain -- = SEQUENCE { ... }
  148. * -- implicitCurve NULL
  149. * }
  150. */
  151. static int pk_get_ecparams( unsigned char **p, const unsigned char *end,
  152. mbedtls_asn1_buf *params )
  153. {
  154. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  155. if ( end - *p < 1 )
  156. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  157. MBEDTLS_ERR_ASN1_OUT_OF_DATA ) );
  158. /* Tag may be either OID or SEQUENCE */
  159. params->tag = **p;
  160. if( params->tag != MBEDTLS_ASN1_OID
  161. #if defined(MBEDTLS_PK_PARSE_EC_EXTENDED)
  162. && params->tag != ( MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE )
  163. #endif
  164. )
  165. {
  166. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  167. MBEDTLS_ERR_ASN1_UNEXPECTED_TAG ) );
  168. }
  169. if( ( ret = mbedtls_asn1_get_tag( p, end, &params->len, params->tag ) ) != 0 )
  170. {
  171. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  172. }
  173. params->p = *p;
  174. *p += params->len;
  175. if( *p != end )
  176. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  177. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH ) );
  178. return( 0 );
  179. }
  180. #if defined(MBEDTLS_PK_PARSE_EC_EXTENDED)
  181. /*
  182. * Parse a SpecifiedECDomain (SEC 1 C.2) and (mostly) fill the group with it.
  183. * WARNING: the resulting group should only be used with
  184. * pk_group_id_from_specified(), since its base point may not be set correctly
  185. * if it was encoded compressed.
  186. *
  187. * SpecifiedECDomain ::= SEQUENCE {
  188. * version SpecifiedECDomainVersion(ecdpVer1 | ecdpVer2 | ecdpVer3, ...),
  189. * fieldID FieldID {{FieldTypes}},
  190. * curve Curve,
  191. * base ECPoint,
  192. * order INTEGER,
  193. * cofactor INTEGER OPTIONAL,
  194. * hash HashAlgorithm OPTIONAL,
  195. * ...
  196. * }
  197. *
  198. * We only support prime-field as field type, and ignore hash and cofactor.
  199. */
  200. static int pk_group_from_specified( const mbedtls_asn1_buf *params, mbedtls_ecp_group *grp )
  201. {
  202. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  203. unsigned char *p = params->p;
  204. const unsigned char * const end = params->p + params->len;
  205. const unsigned char *end_field, *end_curve;
  206. size_t len;
  207. int ver;
  208. /* SpecifiedECDomainVersion ::= INTEGER { 1, 2, 3 } */
  209. if( ( ret = mbedtls_asn1_get_int( &p, end, &ver ) ) != 0 )
  210. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  211. if( ver < 1 || ver > 3 )
  212. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  213. /*
  214. * FieldID { FIELD-ID:IOSet } ::= SEQUENCE { -- Finite field
  215. * fieldType FIELD-ID.&id({IOSet}),
  216. * parameters FIELD-ID.&Type({IOSet}{@fieldType})
  217. * }
  218. */
  219. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  220. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  221. return( ret );
  222. end_field = p + len;
  223. /*
  224. * FIELD-ID ::= TYPE-IDENTIFIER
  225. * FieldTypes FIELD-ID ::= {
  226. * { Prime-p IDENTIFIED BY prime-field } |
  227. * { Characteristic-two IDENTIFIED BY characteristic-two-field }
  228. * }
  229. * prime-field OBJECT IDENTIFIER ::= { id-fieldType 1 }
  230. */
  231. if( ( ret = mbedtls_asn1_get_tag( &p, end_field, &len, MBEDTLS_ASN1_OID ) ) != 0 )
  232. return( ret );
  233. if( len != MBEDTLS_OID_SIZE( MBEDTLS_OID_ANSI_X9_62_PRIME_FIELD ) ||
  234. memcmp( p, MBEDTLS_OID_ANSI_X9_62_PRIME_FIELD, len ) != 0 )
  235. {
  236. return( MBEDTLS_ERR_PK_FEATURE_UNAVAILABLE );
  237. }
  238. p += len;
  239. /* Prime-p ::= INTEGER -- Field of size p. */
  240. if( ( ret = mbedtls_asn1_get_mpi( &p, end_field, &grp->P ) ) != 0 )
  241. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  242. grp->pbits = mbedtls_mpi_bitlen( &grp->P );
  243. if( p != end_field )
  244. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  245. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH ) );
  246. /*
  247. * Curve ::= SEQUENCE {
  248. * a FieldElement,
  249. * b FieldElement,
  250. * seed BIT STRING OPTIONAL
  251. * -- Shall be present if used in SpecifiedECDomain
  252. * -- with version equal to ecdpVer2 or ecdpVer3
  253. * }
  254. */
  255. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  256. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  257. return( ret );
  258. end_curve = p + len;
  259. /*
  260. * FieldElement ::= OCTET STRING
  261. * containing an integer in the case of a prime field
  262. */
  263. if( ( ret = mbedtls_asn1_get_tag( &p, end_curve, &len, MBEDTLS_ASN1_OCTET_STRING ) ) != 0 ||
  264. ( ret = mbedtls_mpi_read_binary( &grp->A, p, len ) ) != 0 )
  265. {
  266. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  267. }
  268. p += len;
  269. if( ( ret = mbedtls_asn1_get_tag( &p, end_curve, &len, MBEDTLS_ASN1_OCTET_STRING ) ) != 0 ||
  270. ( ret = mbedtls_mpi_read_binary( &grp->B, p, len ) ) != 0 )
  271. {
  272. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  273. }
  274. p += len;
  275. /* Ignore seed BIT STRING OPTIONAL */
  276. if( ( ret = mbedtls_asn1_get_tag( &p, end_curve, &len, MBEDTLS_ASN1_BIT_STRING ) ) == 0 )
  277. p += len;
  278. if( p != end_curve )
  279. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  280. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH ) );
  281. /*
  282. * ECPoint ::= OCTET STRING
  283. */
  284. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len, MBEDTLS_ASN1_OCTET_STRING ) ) != 0 )
  285. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  286. if( ( ret = mbedtls_ecp_point_read_binary( grp, &grp->G,
  287. ( const unsigned char *) p, len ) ) != 0 )
  288. {
  289. /*
  290. * If we can't read the point because it's compressed, cheat by
  291. * reading only the X coordinate and the parity bit of Y.
  292. */
  293. if( ret != MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE ||
  294. ( p[0] != 0x02 && p[0] != 0x03 ) ||
  295. len != mbedtls_mpi_size( &grp->P ) + 1 ||
  296. mbedtls_mpi_read_binary( &grp->G.X, p + 1, len - 1 ) != 0 ||
  297. mbedtls_mpi_lset( &grp->G.Y, p[0] - 2 ) != 0 ||
  298. mbedtls_mpi_lset( &grp->G.Z, 1 ) != 0 )
  299. {
  300. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  301. }
  302. }
  303. p += len;
  304. /*
  305. * order INTEGER
  306. */
  307. if( ( ret = mbedtls_asn1_get_mpi( &p, end, &grp->N ) ) != 0 )
  308. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  309. grp->nbits = mbedtls_mpi_bitlen( &grp->N );
  310. /*
  311. * Allow optional elements by purposefully not enforcing p == end here.
  312. */
  313. return( 0 );
  314. }
  315. /*
  316. * Find the group id associated with an (almost filled) group as generated by
  317. * pk_group_from_specified(), or return an error if unknown.
  318. */
  319. static int pk_group_id_from_group( const mbedtls_ecp_group *grp, mbedtls_ecp_group_id *grp_id )
  320. {
  321. int ret = 0;
  322. mbedtls_ecp_group ref;
  323. const mbedtls_ecp_group_id *id;
  324. mbedtls_ecp_group_init( &ref );
  325. for( id = mbedtls_ecp_grp_id_list(); *id != MBEDTLS_ECP_DP_NONE; id++ )
  326. {
  327. /* Load the group associated to that id */
  328. mbedtls_ecp_group_free( &ref );
  329. MBEDTLS_MPI_CHK( mbedtls_ecp_group_load( &ref, *id ) );
  330. /* Compare to the group we were given, starting with easy tests */
  331. if( grp->pbits == ref.pbits && grp->nbits == ref.nbits &&
  332. mbedtls_mpi_cmp_mpi( &grp->P, &ref.P ) == 0 &&
  333. mbedtls_mpi_cmp_mpi( &grp->A, &ref.A ) == 0 &&
  334. mbedtls_mpi_cmp_mpi( &grp->B, &ref.B ) == 0 &&
  335. mbedtls_mpi_cmp_mpi( &grp->N, &ref.N ) == 0 &&
  336. mbedtls_mpi_cmp_mpi( &grp->G.X, &ref.G.X ) == 0 &&
  337. mbedtls_mpi_cmp_mpi( &grp->G.Z, &ref.G.Z ) == 0 &&
  338. /* For Y we may only know the parity bit, so compare only that */
  339. mbedtls_mpi_get_bit( &grp->G.Y, 0 ) == mbedtls_mpi_get_bit( &ref.G.Y, 0 ) )
  340. {
  341. break;
  342. }
  343. }
  344. cleanup:
  345. mbedtls_ecp_group_free( &ref );
  346. *grp_id = *id;
  347. if( ret == 0 && *id == MBEDTLS_ECP_DP_NONE )
  348. ret = MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE;
  349. return( ret );
  350. }
  351. /*
  352. * Parse a SpecifiedECDomain (SEC 1 C.2) and find the associated group ID
  353. */
  354. static int pk_group_id_from_specified( const mbedtls_asn1_buf *params,
  355. mbedtls_ecp_group_id *grp_id )
  356. {
  357. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  358. mbedtls_ecp_group grp;
  359. mbedtls_ecp_group_init( &grp );
  360. if( ( ret = pk_group_from_specified( params, &grp ) ) != 0 )
  361. goto cleanup;
  362. ret = pk_group_id_from_group( &grp, grp_id );
  363. cleanup:
  364. mbedtls_ecp_group_free( &grp );
  365. return( ret );
  366. }
  367. #endif /* MBEDTLS_PK_PARSE_EC_EXTENDED */
  368. /*
  369. * Use EC parameters to initialise an EC group
  370. *
  371. * ECParameters ::= CHOICE {
  372. * namedCurve OBJECT IDENTIFIER
  373. * specifiedCurve SpecifiedECDomain -- = SEQUENCE { ... }
  374. * -- implicitCurve NULL
  375. */
  376. static int pk_use_ecparams( const mbedtls_asn1_buf *params, mbedtls_ecp_group *grp )
  377. {
  378. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  379. mbedtls_ecp_group_id grp_id;
  380. if( params->tag == MBEDTLS_ASN1_OID )
  381. {
  382. if( mbedtls_oid_get_ec_grp( params, &grp_id ) != 0 )
  383. return( MBEDTLS_ERR_PK_UNKNOWN_NAMED_CURVE );
  384. }
  385. else
  386. {
  387. #if defined(MBEDTLS_PK_PARSE_EC_EXTENDED)
  388. if( ( ret = pk_group_id_from_specified( params, &grp_id ) ) != 0 )
  389. return( ret );
  390. #else
  391. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  392. #endif
  393. }
  394. /*
  395. * grp may already be initilialized; if so, make sure IDs match
  396. */
  397. if( grp->id != MBEDTLS_ECP_DP_NONE && grp->id != grp_id )
  398. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  399. if( ( ret = mbedtls_ecp_group_load( grp, grp_id ) ) != 0 )
  400. return( ret );
  401. return( 0 );
  402. }
  403. /*
  404. * EC public key is an EC point
  405. *
  406. * The caller is responsible for clearing the structure upon failure if
  407. * desired. Take care to pass along the possible ECP_FEATURE_UNAVAILABLE
  408. * return code of mbedtls_ecp_point_read_binary() and leave p in a usable state.
  409. */
  410. static int pk_get_ecpubkey( unsigned char **p, const unsigned char *end,
  411. mbedtls_ecp_keypair *key )
  412. {
  413. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  414. if( ( ret = mbedtls_ecp_point_read_binary( &key->grp, &key->Q,
  415. (const unsigned char *) *p, end - *p ) ) == 0 )
  416. {
  417. ret = mbedtls_ecp_check_pubkey( &key->grp, &key->Q );
  418. }
  419. /*
  420. * We know mbedtls_ecp_point_read_binary consumed all bytes or failed
  421. */
  422. *p = (unsigned char *) end;
  423. return( ret );
  424. }
  425. #endif /* MBEDTLS_ECP_C */
  426. #if defined(MBEDTLS_RSA_C)
  427. /*
  428. * RSAPublicKey ::= SEQUENCE {
  429. * modulus INTEGER, -- n
  430. * publicExponent INTEGER -- e
  431. * }
  432. */
  433. static int pk_get_rsapubkey( unsigned char **p,
  434. const unsigned char *end,
  435. mbedtls_rsa_context *rsa )
  436. {
  437. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  438. size_t len;
  439. if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
  440. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  441. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY, ret ) );
  442. if( *p + len != end )
  443. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY,
  444. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH ) );
  445. /* Import N */
  446. if( ( ret = mbedtls_asn1_get_tag( p, end, &len, MBEDTLS_ASN1_INTEGER ) ) != 0 )
  447. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY, ret ) );
  448. if( ( ret = mbedtls_rsa_import_raw( rsa, *p, len, NULL, 0, NULL, 0,
  449. NULL, 0, NULL, 0 ) ) != 0 )
  450. return( MBEDTLS_ERR_PK_INVALID_PUBKEY );
  451. *p += len;
  452. /* Import E */
  453. if( ( ret = mbedtls_asn1_get_tag( p, end, &len, MBEDTLS_ASN1_INTEGER ) ) != 0 )
  454. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY, ret ) );
  455. if( ( ret = mbedtls_rsa_import_raw( rsa, NULL, 0, NULL, 0, NULL, 0,
  456. NULL, 0, *p, len ) ) != 0 )
  457. return( MBEDTLS_ERR_PK_INVALID_PUBKEY );
  458. *p += len;
  459. if( mbedtls_rsa_complete( rsa ) != 0 ||
  460. mbedtls_rsa_check_pubkey( rsa ) != 0 )
  461. {
  462. return( MBEDTLS_ERR_PK_INVALID_PUBKEY );
  463. }
  464. if( *p != end )
  465. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY,
  466. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH ) );
  467. return( 0 );
  468. }
  469. #endif /* MBEDTLS_RSA_C */
  470. /* Get a PK algorithm identifier
  471. *
  472. * AlgorithmIdentifier ::= SEQUENCE {
  473. * algorithm OBJECT IDENTIFIER,
  474. * parameters ANY DEFINED BY algorithm OPTIONAL }
  475. */
  476. static int pk_get_pk_alg( unsigned char **p,
  477. const unsigned char *end,
  478. mbedtls_pk_type_t *pk_alg, mbedtls_asn1_buf *params )
  479. {
  480. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  481. mbedtls_asn1_buf alg_oid;
  482. memset( params, 0, sizeof(mbedtls_asn1_buf) );
  483. if( ( ret = mbedtls_asn1_get_alg( p, end, &alg_oid, params ) ) != 0 )
  484. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_ALG, ret ) );
  485. if( mbedtls_oid_get_pk_alg( &alg_oid, pk_alg ) != 0 )
  486. return( MBEDTLS_ERR_PK_UNKNOWN_PK_ALG );
  487. /*
  488. * No parameters with RSA (only for EC)
  489. */
  490. if( *pk_alg == MBEDTLS_PK_RSA &&
  491. ( ( params->tag != MBEDTLS_ASN1_NULL && params->tag != 0 ) ||
  492. params->len != 0 ) )
  493. {
  494. return( MBEDTLS_ERR_PK_INVALID_ALG );
  495. }
  496. return( 0 );
  497. }
  498. /*
  499. * SubjectPublicKeyInfo ::= SEQUENCE {
  500. * algorithm AlgorithmIdentifier,
  501. * subjectPublicKey BIT STRING }
  502. */
  503. int mbedtls_pk_parse_subpubkey( unsigned char **p, const unsigned char *end,
  504. mbedtls_pk_context *pk )
  505. {
  506. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  507. size_t len;
  508. mbedtls_asn1_buf alg_params;
  509. mbedtls_pk_type_t pk_alg = MBEDTLS_PK_NONE;
  510. const mbedtls_pk_info_t *pk_info;
  511. PK_VALIDATE_RET( p != NULL );
  512. PK_VALIDATE_RET( *p != NULL );
  513. PK_VALIDATE_RET( end != NULL );
  514. PK_VALIDATE_RET( pk != NULL );
  515. if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
  516. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  517. {
  518. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  519. }
  520. end = *p + len;
  521. if( ( ret = pk_get_pk_alg( p, end, &pk_alg, &alg_params ) ) != 0 )
  522. return( ret );
  523. if( ( ret = mbedtls_asn1_get_bitstring_null( p, end, &len ) ) != 0 )
  524. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY, ret ) );
  525. if( *p + len != end )
  526. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY,
  527. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH ) );
  528. if( ( pk_info = mbedtls_pk_info_from_type( pk_alg ) ) == NULL )
  529. return( MBEDTLS_ERR_PK_UNKNOWN_PK_ALG );
  530. if( ( ret = mbedtls_pk_setup( pk, pk_info ) ) != 0 )
  531. return( ret );
  532. #if defined(MBEDTLS_RSA_C)
  533. if( pk_alg == MBEDTLS_PK_RSA )
  534. {
  535. ret = pk_get_rsapubkey( p, end, mbedtls_pk_rsa( *pk ) );
  536. } else
  537. #endif /* MBEDTLS_RSA_C */
  538. #if defined(MBEDTLS_ECP_C)
  539. if( pk_alg == MBEDTLS_PK_ECKEY_DH || pk_alg == MBEDTLS_PK_ECKEY )
  540. {
  541. ret = pk_use_ecparams( &alg_params, &mbedtls_pk_ec( *pk )->grp );
  542. if( ret == 0 )
  543. ret = pk_get_ecpubkey( p, end, mbedtls_pk_ec( *pk ) );
  544. } else
  545. #endif /* MBEDTLS_ECP_C */
  546. ret = MBEDTLS_ERR_PK_UNKNOWN_PK_ALG;
  547. if( ret == 0 && *p != end )
  548. ret = MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY,
  549. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
  550. if( ret != 0 )
  551. mbedtls_pk_free( pk );
  552. return( ret );
  553. }
  554. #if defined(MBEDTLS_RSA_C)
  555. /*
  556. * Wrapper around mbedtls_asn1_get_mpi() that rejects zero.
  557. *
  558. * The value zero is:
  559. * - never a valid value for an RSA parameter
  560. * - interpreted as "omitted, please reconstruct" by mbedtls_rsa_complete().
  561. *
  562. * Since values can't be omitted in PKCS#1, passing a zero value to
  563. * rsa_complete() would be incorrect, so reject zero values early.
  564. */
  565. static int asn1_get_nonzero_mpi( unsigned char **p,
  566. const unsigned char *end,
  567. mbedtls_mpi *X )
  568. {
  569. int ret;
  570. ret = mbedtls_asn1_get_mpi( p, end, X );
  571. if( ret != 0 )
  572. return( ret );
  573. if( mbedtls_mpi_cmp_int( X, 0 ) == 0 )
  574. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  575. return( 0 );
  576. }
  577. /*
  578. * Parse a PKCS#1 encoded private RSA key
  579. */
  580. static int pk_parse_key_pkcs1_der( mbedtls_rsa_context *rsa,
  581. const unsigned char *key,
  582. size_t keylen )
  583. {
  584. int ret, version;
  585. size_t len;
  586. unsigned char *p, *end;
  587. mbedtls_mpi T;
  588. mbedtls_mpi_init( &T );
  589. p = (unsigned char *) key;
  590. end = p + keylen;
  591. /*
  592. * This function parses the RSAPrivateKey (PKCS#1)
  593. *
  594. * RSAPrivateKey ::= SEQUENCE {
  595. * version Version,
  596. * modulus INTEGER, -- n
  597. * publicExponent INTEGER, -- e
  598. * privateExponent INTEGER, -- d
  599. * prime1 INTEGER, -- p
  600. * prime2 INTEGER, -- q
  601. * exponent1 INTEGER, -- d mod (p-1)
  602. * exponent2 INTEGER, -- d mod (q-1)
  603. * coefficient INTEGER, -- (inverse of q) mod p
  604. * otherPrimeInfos OtherPrimeInfos OPTIONAL
  605. * }
  606. */
  607. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  608. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  609. {
  610. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  611. }
  612. end = p + len;
  613. if( ( ret = mbedtls_asn1_get_int( &p, end, &version ) ) != 0 )
  614. {
  615. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  616. }
  617. if( version != 0 )
  618. {
  619. return( MBEDTLS_ERR_PK_KEY_INVALID_VERSION );
  620. }
  621. /* Import N */
  622. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  623. ( ret = mbedtls_rsa_import( rsa, &T, NULL, NULL,
  624. NULL, NULL ) ) != 0 )
  625. goto cleanup;
  626. /* Import E */
  627. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  628. ( ret = mbedtls_rsa_import( rsa, NULL, NULL, NULL,
  629. NULL, &T ) ) != 0 )
  630. goto cleanup;
  631. /* Import D */
  632. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  633. ( ret = mbedtls_rsa_import( rsa, NULL, NULL, NULL,
  634. &T, NULL ) ) != 0 )
  635. goto cleanup;
  636. /* Import P */
  637. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  638. ( ret = mbedtls_rsa_import( rsa, NULL, &T, NULL,
  639. NULL, NULL ) ) != 0 )
  640. goto cleanup;
  641. /* Import Q */
  642. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  643. ( ret = mbedtls_rsa_import( rsa, NULL, NULL, &T,
  644. NULL, NULL ) ) != 0 )
  645. goto cleanup;
  646. #if !defined(MBEDTLS_RSA_NO_CRT) && !defined(MBEDTLS_RSA_ALT)
  647. /*
  648. * The RSA CRT parameters DP, DQ and QP are nominally redundant, in
  649. * that they can be easily recomputed from D, P and Q. However by
  650. * parsing them from the PKCS1 structure it is possible to avoid
  651. * recalculating them which both reduces the overhead of loading
  652. * RSA private keys into memory and also avoids side channels which
  653. * can arise when computing those values, since all of D, P, and Q
  654. * are secret. See https://eprint.iacr.org/2020/055 for a
  655. * description of one such attack.
  656. */
  657. /* Import DP */
  658. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  659. ( ret = mbedtls_mpi_copy( &rsa->DP, &T ) ) != 0 )
  660. goto cleanup;
  661. /* Import DQ */
  662. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  663. ( ret = mbedtls_mpi_copy( &rsa->DQ, &T ) ) != 0 )
  664. goto cleanup;
  665. /* Import QP */
  666. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  667. ( ret = mbedtls_mpi_copy( &rsa->QP, &T ) ) != 0 )
  668. goto cleanup;
  669. #else
  670. /* Verify existance of the CRT params */
  671. if( ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  672. ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 ||
  673. ( ret = asn1_get_nonzero_mpi( &p, end, &T ) ) != 0 )
  674. goto cleanup;
  675. #endif
  676. /* rsa_complete() doesn't complete anything with the default
  677. * implementation but is still called:
  678. * - for the benefit of alternative implementation that may want to
  679. * pre-compute stuff beyond what's provided (eg Montgomery factors)
  680. * - as is also sanity-checks the key
  681. *
  682. * Furthermore, we also check the public part for consistency with
  683. * mbedtls_pk_parse_pubkey(), as it includes size minima for example.
  684. */
  685. if( ( ret = mbedtls_rsa_complete( rsa ) ) != 0 ||
  686. ( ret = mbedtls_rsa_check_pubkey( rsa ) ) != 0 )
  687. {
  688. goto cleanup;
  689. }
  690. if( p != end )
  691. {
  692. ret = MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  693. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
  694. }
  695. cleanup:
  696. mbedtls_mpi_free( &T );
  697. if( ret != 0 )
  698. {
  699. /* Wrap error code if it's coming from a lower level */
  700. if( ( ret & 0xff80 ) == 0 )
  701. ret = MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret );
  702. else
  703. ret = MBEDTLS_ERR_PK_KEY_INVALID_FORMAT;
  704. mbedtls_rsa_free( rsa );
  705. }
  706. return( ret );
  707. }
  708. #endif /* MBEDTLS_RSA_C */
  709. #if defined(MBEDTLS_ECP_C)
  710. /*
  711. * Parse a SEC1 encoded private EC key
  712. */
  713. static int pk_parse_key_sec1_der( mbedtls_ecp_keypair *eck,
  714. const unsigned char *key, size_t keylen,
  715. int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
  716. {
  717. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  718. int version, pubkey_done;
  719. size_t len;
  720. mbedtls_asn1_buf params;
  721. unsigned char *p = (unsigned char *) key;
  722. unsigned char *end = p + keylen;
  723. unsigned char *end2;
  724. /*
  725. * RFC 5915, or SEC1 Appendix C.4
  726. *
  727. * ECPrivateKey ::= SEQUENCE {
  728. * version INTEGER { ecPrivkeyVer1(1) } (ecPrivkeyVer1),
  729. * privateKey OCTET STRING,
  730. * parameters [0] ECParameters {{ NamedCurve }} OPTIONAL,
  731. * publicKey [1] BIT STRING OPTIONAL
  732. * }
  733. */
  734. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  735. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  736. {
  737. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  738. }
  739. end = p + len;
  740. if( ( ret = mbedtls_asn1_get_int( &p, end, &version ) ) != 0 )
  741. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  742. if( version != 1 )
  743. return( MBEDTLS_ERR_PK_KEY_INVALID_VERSION );
  744. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len, MBEDTLS_ASN1_OCTET_STRING ) ) != 0 )
  745. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  746. if( ( ret = mbedtls_mpi_read_binary( &eck->d, p, len ) ) != 0 )
  747. {
  748. mbedtls_ecp_keypair_free( eck );
  749. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  750. }
  751. p += len;
  752. pubkey_done = 0;
  753. if( p != end )
  754. {
  755. /*
  756. * Is 'parameters' present?
  757. */
  758. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  759. MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED | 0 ) ) == 0 )
  760. {
  761. if( ( ret = pk_get_ecparams( &p, p + len, &params) ) != 0 ||
  762. ( ret = pk_use_ecparams( &params, &eck->grp ) ) != 0 )
  763. {
  764. mbedtls_ecp_keypair_free( eck );
  765. return( ret );
  766. }
  767. }
  768. else if( ret != MBEDTLS_ERR_ASN1_UNEXPECTED_TAG )
  769. {
  770. mbedtls_ecp_keypair_free( eck );
  771. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  772. }
  773. }
  774. if( p != end )
  775. {
  776. /*
  777. * Is 'publickey' present? If not, or if we can't read it (eg because it
  778. * is compressed), create it from the private key.
  779. */
  780. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  781. MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED | 1 ) ) == 0 )
  782. {
  783. end2 = p + len;
  784. if( ( ret = mbedtls_asn1_get_bitstring_null( &p, end2, &len ) ) != 0 )
  785. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  786. if( p + len != end2 )
  787. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  788. MBEDTLS_ERR_ASN1_LENGTH_MISMATCH ) );
  789. if( ( ret = pk_get_ecpubkey( &p, end2, eck ) ) == 0 )
  790. pubkey_done = 1;
  791. else
  792. {
  793. /*
  794. * The only acceptable failure mode of pk_get_ecpubkey() above
  795. * is if the point format is not recognized.
  796. */
  797. if( ret != MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE )
  798. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  799. }
  800. }
  801. else if( ret != MBEDTLS_ERR_ASN1_UNEXPECTED_TAG )
  802. {
  803. mbedtls_ecp_keypair_free( eck );
  804. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  805. }
  806. }
  807. if( ! pubkey_done &&
  808. ( ret = mbedtls_ecp_mul( &eck->grp, &eck->Q, &eck->d, &eck->grp.G,
  809. f_rng, p_rng ) ) != 0 )
  810. {
  811. mbedtls_ecp_keypair_free( eck );
  812. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  813. }
  814. if( ( ret = mbedtls_ecp_check_privkey( &eck->grp, &eck->d ) ) != 0 )
  815. {
  816. mbedtls_ecp_keypair_free( eck );
  817. return( ret );
  818. }
  819. return( 0 );
  820. }
  821. #endif /* MBEDTLS_ECP_C */
  822. /*
  823. * Parse an unencrypted PKCS#8 encoded private key
  824. *
  825. * Notes:
  826. *
  827. * - This function does not own the key buffer. It is the
  828. * responsibility of the caller to take care of zeroizing
  829. * and freeing it after use.
  830. *
  831. * - The function is responsible for freeing the provided
  832. * PK context on failure.
  833. *
  834. */
  835. static int pk_parse_key_pkcs8_unencrypted_der(
  836. mbedtls_pk_context *pk,
  837. const unsigned char* key, size_t keylen,
  838. int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
  839. {
  840. int ret, version;
  841. size_t len;
  842. mbedtls_asn1_buf params;
  843. unsigned char *p = (unsigned char *) key;
  844. unsigned char *end = p + keylen;
  845. mbedtls_pk_type_t pk_alg = MBEDTLS_PK_NONE;
  846. const mbedtls_pk_info_t *pk_info;
  847. #if !defined(MBEDTLS_ECP_C)
  848. (void) f_rng;
  849. (void) p_rng;
  850. #endif
  851. /*
  852. * This function parses the PrivateKeyInfo object (PKCS#8 v1.2 = RFC 5208)
  853. *
  854. * PrivateKeyInfo ::= SEQUENCE {
  855. * version Version,
  856. * privateKeyAlgorithm PrivateKeyAlgorithmIdentifier,
  857. * privateKey PrivateKey,
  858. * attributes [0] IMPLICIT Attributes OPTIONAL }
  859. *
  860. * Version ::= INTEGER
  861. * PrivateKeyAlgorithmIdentifier ::= AlgorithmIdentifier
  862. * PrivateKey ::= OCTET STRING
  863. *
  864. * The PrivateKey OCTET STRING is a SEC1 ECPrivateKey
  865. */
  866. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  867. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  868. {
  869. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  870. }
  871. end = p + len;
  872. if( ( ret = mbedtls_asn1_get_int( &p, end, &version ) ) != 0 )
  873. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  874. if( version != 0 )
  875. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_VERSION, ret ) );
  876. if( ( ret = pk_get_pk_alg( &p, end, &pk_alg, &params ) ) != 0 )
  877. {
  878. return( ret );
  879. }
  880. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len, MBEDTLS_ASN1_OCTET_STRING ) ) != 0 )
  881. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  882. if( len < 1 )
  883. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT,
  884. MBEDTLS_ERR_ASN1_OUT_OF_DATA ) );
  885. if( ( pk_info = mbedtls_pk_info_from_type( pk_alg ) ) == NULL )
  886. return( MBEDTLS_ERR_PK_UNKNOWN_PK_ALG );
  887. if( ( ret = mbedtls_pk_setup( pk, pk_info ) ) != 0 )
  888. return( ret );
  889. #if defined(MBEDTLS_RSA_C)
  890. if( pk_alg == MBEDTLS_PK_RSA )
  891. {
  892. if( ( ret = pk_parse_key_pkcs1_der( mbedtls_pk_rsa( *pk ), p, len ) ) != 0 )
  893. {
  894. mbedtls_pk_free( pk );
  895. return( ret );
  896. }
  897. } else
  898. #endif /* MBEDTLS_RSA_C */
  899. #if defined(MBEDTLS_ECP_C)
  900. if( pk_alg == MBEDTLS_PK_ECKEY || pk_alg == MBEDTLS_PK_ECKEY_DH )
  901. {
  902. if( ( ret = pk_use_ecparams( &params, &mbedtls_pk_ec( *pk )->grp ) ) != 0 ||
  903. ( ret = pk_parse_key_sec1_der( mbedtls_pk_ec( *pk ), p, len, f_rng, p_rng ) ) != 0 )
  904. {
  905. mbedtls_pk_free( pk );
  906. return( ret );
  907. }
  908. } else
  909. #endif /* MBEDTLS_ECP_C */
  910. return( MBEDTLS_ERR_PK_UNKNOWN_PK_ALG );
  911. return( 0 );
  912. }
  913. /*
  914. * Parse an encrypted PKCS#8 encoded private key
  915. *
  916. * To save space, the decryption happens in-place on the given key buffer.
  917. * Also, while this function may modify the keybuffer, it doesn't own it,
  918. * and instead it is the responsibility of the caller to zeroize and properly
  919. * free it after use.
  920. *
  921. */
  922. #if defined(MBEDTLS_PKCS12_C) || defined(MBEDTLS_PKCS5_C)
  923. static int pk_parse_key_pkcs8_encrypted_der(
  924. mbedtls_pk_context *pk,
  925. unsigned char *key, size_t keylen,
  926. const unsigned char *pwd, size_t pwdlen,
  927. int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
  928. {
  929. int ret, decrypted = 0;
  930. size_t len;
  931. unsigned char *buf;
  932. unsigned char *p, *end;
  933. mbedtls_asn1_buf pbe_alg_oid, pbe_params;
  934. #if defined(MBEDTLS_PKCS12_C)
  935. mbedtls_cipher_type_t cipher_alg;
  936. mbedtls_md_type_t md_alg;
  937. #endif
  938. p = key;
  939. end = p + keylen;
  940. if( pwdlen == 0 )
  941. return( MBEDTLS_ERR_PK_PASSWORD_REQUIRED );
  942. /*
  943. * This function parses the EncryptedPrivateKeyInfo object (PKCS#8)
  944. *
  945. * EncryptedPrivateKeyInfo ::= SEQUENCE {
  946. * encryptionAlgorithm EncryptionAlgorithmIdentifier,
  947. * encryptedData EncryptedData
  948. * }
  949. *
  950. * EncryptionAlgorithmIdentifier ::= AlgorithmIdentifier
  951. *
  952. * EncryptedData ::= OCTET STRING
  953. *
  954. * The EncryptedData OCTET STRING is a PKCS#8 PrivateKeyInfo
  955. *
  956. */
  957. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
  958. MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
  959. {
  960. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  961. }
  962. end = p + len;
  963. if( ( ret = mbedtls_asn1_get_alg( &p, end, &pbe_alg_oid, &pbe_params ) ) != 0 )
  964. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  965. if( ( ret = mbedtls_asn1_get_tag( &p, end, &len, MBEDTLS_ASN1_OCTET_STRING ) ) != 0 )
  966. return( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT, ret ) );
  967. buf = p;
  968. /*
  969. * Decrypt EncryptedData with appropriate PBE
  970. */
  971. #if defined(MBEDTLS_PKCS12_C)
  972. if( mbedtls_oid_get_pkcs12_pbe_alg( &pbe_alg_oid, &md_alg, &cipher_alg ) == 0 )
  973. {
  974. if( ( ret = mbedtls_pkcs12_pbe( &pbe_params, MBEDTLS_PKCS12_PBE_DECRYPT,
  975. cipher_alg, md_alg,
  976. pwd, pwdlen, p, len, buf ) ) != 0 )
  977. {
  978. if( ret == MBEDTLS_ERR_PKCS12_PASSWORD_MISMATCH )
  979. return( MBEDTLS_ERR_PK_PASSWORD_MISMATCH );
  980. return( ret );
  981. }
  982. decrypted = 1;
  983. }
  984. else
  985. #endif /* MBEDTLS_PKCS12_C */
  986. #if defined(MBEDTLS_PKCS5_C)
  987. if( MBEDTLS_OID_CMP( MBEDTLS_OID_PKCS5_PBES2, &pbe_alg_oid ) == 0 )
  988. {
  989. if( ( ret = mbedtls_pkcs5_pbes2( &pbe_params, MBEDTLS_PKCS5_DECRYPT, pwd, pwdlen,
  990. p, len, buf ) ) != 0 )
  991. {
  992. if( ret == MBEDTLS_ERR_PKCS5_PASSWORD_MISMATCH )
  993. return( MBEDTLS_ERR_PK_PASSWORD_MISMATCH );
  994. return( ret );
  995. }
  996. decrypted = 1;
  997. }
  998. else
  999. #endif /* MBEDTLS_PKCS5_C */
  1000. {
  1001. ((void) pwd);
  1002. }
  1003. if( decrypted == 0 )
  1004. return( MBEDTLS_ERR_PK_FEATURE_UNAVAILABLE );
  1005. return( pk_parse_key_pkcs8_unencrypted_der( pk, buf, len, f_rng, p_rng ) );
  1006. }
  1007. #endif /* MBEDTLS_PKCS12_C || MBEDTLS_PKCS5_C */
  1008. /*
  1009. * Parse a private key
  1010. */
  1011. int mbedtls_pk_parse_key( mbedtls_pk_context *pk,
  1012. const unsigned char *key, size_t keylen,
  1013. const unsigned char *pwd, size_t pwdlen,
  1014. int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
  1015. {
  1016. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  1017. const mbedtls_pk_info_t *pk_info;
  1018. #if defined(MBEDTLS_PEM_PARSE_C)
  1019. size_t len;
  1020. mbedtls_pem_context pem;
  1021. #endif
  1022. PK_VALIDATE_RET( pk != NULL );
  1023. if( keylen == 0 )
  1024. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  1025. PK_VALIDATE_RET( key != NULL );
  1026. #if defined(MBEDTLS_PEM_PARSE_C)
  1027. mbedtls_pem_init( &pem );
  1028. #if defined(MBEDTLS_RSA_C)
  1029. /* Avoid calling mbedtls_pem_read_buffer() on non-null-terminated string */
  1030. if( key[keylen - 1] != '\0' )
  1031. ret = MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  1032. else
  1033. ret = mbedtls_pem_read_buffer( &pem,
  1034. "-----BEGIN RSA PRIVATE KEY-----",
  1035. "-----END RSA PRIVATE KEY-----",
  1036. key, pwd, pwdlen, &len );
  1037. if( ret == 0 )
  1038. {
  1039. pk_info = mbedtls_pk_info_from_type( MBEDTLS_PK_RSA );
  1040. if( ( ret = mbedtls_pk_setup( pk, pk_info ) ) != 0 ||
  1041. ( ret = pk_parse_key_pkcs1_der( mbedtls_pk_rsa( *pk ),
  1042. pem.buf, pem.buflen ) ) != 0 )
  1043. {
  1044. mbedtls_pk_free( pk );
  1045. }
  1046. mbedtls_pem_free( &pem );
  1047. return( ret );
  1048. }
  1049. else if( ret == MBEDTLS_ERR_PEM_PASSWORD_MISMATCH )
  1050. return( MBEDTLS_ERR_PK_PASSWORD_MISMATCH );
  1051. else if( ret == MBEDTLS_ERR_PEM_PASSWORD_REQUIRED )
  1052. return( MBEDTLS_ERR_PK_PASSWORD_REQUIRED );
  1053. else if( ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT )
  1054. return( ret );
  1055. #endif /* MBEDTLS_RSA_C */
  1056. #if defined(MBEDTLS_ECP_C)
  1057. /* Avoid calling mbedtls_pem_read_buffer() on non-null-terminated string */
  1058. if( key[keylen - 1] != '\0' )
  1059. ret = MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  1060. else
  1061. ret = mbedtls_pem_read_buffer( &pem,
  1062. "-----BEGIN EC PRIVATE KEY-----",
  1063. "-----END EC PRIVATE KEY-----",
  1064. key, pwd, pwdlen, &len );
  1065. if( ret == 0 )
  1066. {
  1067. pk_info = mbedtls_pk_info_from_type( MBEDTLS_PK_ECKEY );
  1068. if( ( ret = mbedtls_pk_setup( pk, pk_info ) ) != 0 ||
  1069. ( ret = pk_parse_key_sec1_der( mbedtls_pk_ec( *pk ),
  1070. pem.buf, pem.buflen,
  1071. f_rng, p_rng ) ) != 0 )
  1072. {
  1073. mbedtls_pk_free( pk );
  1074. }
  1075. mbedtls_pem_free( &pem );
  1076. return( ret );
  1077. }
  1078. else if( ret == MBEDTLS_ERR_PEM_PASSWORD_MISMATCH )
  1079. return( MBEDTLS_ERR_PK_PASSWORD_MISMATCH );
  1080. else if( ret == MBEDTLS_ERR_PEM_PASSWORD_REQUIRED )
  1081. return( MBEDTLS_ERR_PK_PASSWORD_REQUIRED );
  1082. else if( ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT )
  1083. return( ret );
  1084. #endif /* MBEDTLS_ECP_C */
  1085. /* Avoid calling mbedtls_pem_read_buffer() on non-null-terminated string */
  1086. if( key[keylen - 1] != '\0' )
  1087. ret = MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  1088. else
  1089. ret = mbedtls_pem_read_buffer( &pem,
  1090. "-----BEGIN PRIVATE KEY-----",
  1091. "-----END PRIVATE KEY-----",
  1092. key, NULL, 0, &len );
  1093. if( ret == 0 )
  1094. {
  1095. if( ( ret = pk_parse_key_pkcs8_unencrypted_der( pk,
  1096. pem.buf, pem.buflen, f_rng, p_rng ) ) != 0 )
  1097. {
  1098. mbedtls_pk_free( pk );
  1099. }
  1100. mbedtls_pem_free( &pem );
  1101. return( ret );
  1102. }
  1103. else if( ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT )
  1104. return( ret );
  1105. #if defined(MBEDTLS_PKCS12_C) || defined(MBEDTLS_PKCS5_C)
  1106. /* Avoid calling mbedtls_pem_read_buffer() on non-null-terminated string */
  1107. if( key[keylen - 1] != '\0' )
  1108. ret = MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  1109. else
  1110. ret = mbedtls_pem_read_buffer( &pem,
  1111. "-----BEGIN ENCRYPTED PRIVATE KEY-----",
  1112. "-----END ENCRYPTED PRIVATE KEY-----",
  1113. key, NULL, 0, &len );
  1114. if( ret == 0 )
  1115. {
  1116. if( ( ret = pk_parse_key_pkcs8_encrypted_der( pk, pem.buf, pem.buflen,
  1117. pwd, pwdlen, f_rng, p_rng ) ) != 0 )
  1118. {
  1119. mbedtls_pk_free( pk );
  1120. }
  1121. mbedtls_pem_free( &pem );
  1122. return( ret );
  1123. }
  1124. else if( ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT )
  1125. return( ret );
  1126. #endif /* MBEDTLS_PKCS12_C || MBEDTLS_PKCS5_C */
  1127. #else
  1128. ((void) pwd);
  1129. ((void) pwdlen);
  1130. #endif /* MBEDTLS_PEM_PARSE_C */
  1131. /*
  1132. * At this point we only know it's not a PEM formatted key. Could be any
  1133. * of the known DER encoded private key formats
  1134. *
  1135. * We try the different DER format parsers to see if one passes without
  1136. * error
  1137. */
  1138. #if defined(MBEDTLS_PKCS12_C) || defined(MBEDTLS_PKCS5_C)
  1139. {
  1140. unsigned char *key_copy;
  1141. if( ( key_copy = mbedtls_calloc( 1, keylen ) ) == NULL )
  1142. return( MBEDTLS_ERR_PK_ALLOC_FAILED );
  1143. memcpy( key_copy, key, keylen );
  1144. ret = pk_parse_key_pkcs8_encrypted_der( pk, key_copy, keylen,
  1145. pwd, pwdlen, f_rng, p_rng );
  1146. mbedtls_platform_zeroize( key_copy, keylen );
  1147. mbedtls_free( key_copy );
  1148. }
  1149. if( ret == 0 )
  1150. return( 0 );
  1151. mbedtls_pk_free( pk );
  1152. mbedtls_pk_init( pk );
  1153. if( ret == MBEDTLS_ERR_PK_PASSWORD_MISMATCH )
  1154. {
  1155. return( ret );
  1156. }
  1157. #endif /* MBEDTLS_PKCS12_C || MBEDTLS_PKCS5_C */
  1158. ret = pk_parse_key_pkcs8_unencrypted_der( pk, key, keylen, f_rng, p_rng );
  1159. if( ret == 0 )
  1160. {
  1161. return( 0 );
  1162. }
  1163. mbedtls_pk_free( pk );
  1164. mbedtls_pk_init( pk );
  1165. #if defined(MBEDTLS_RSA_C)
  1166. pk_info = mbedtls_pk_info_from_type( MBEDTLS_PK_RSA );
  1167. if( mbedtls_pk_setup( pk, pk_info ) == 0 &&
  1168. pk_parse_key_pkcs1_der( mbedtls_pk_rsa( *pk ), key, keylen ) == 0 )
  1169. {
  1170. return( 0 );
  1171. }
  1172. mbedtls_pk_free( pk );
  1173. mbedtls_pk_init( pk );
  1174. #endif /* MBEDTLS_RSA_C */
  1175. #if defined(MBEDTLS_ECP_C)
  1176. pk_info = mbedtls_pk_info_from_type( MBEDTLS_PK_ECKEY );
  1177. if( mbedtls_pk_setup( pk, pk_info ) == 0 &&
  1178. pk_parse_key_sec1_der( mbedtls_pk_ec( *pk ),
  1179. key, keylen, f_rng, p_rng ) == 0 )
  1180. {
  1181. return( 0 );
  1182. }
  1183. mbedtls_pk_free( pk );
  1184. #endif /* MBEDTLS_ECP_C */
  1185. /* If MBEDTLS_RSA_C is defined but MBEDTLS_ECP_C isn't,
  1186. * it is ok to leave the PK context initialized but not
  1187. * freed: It is the caller's responsibility to call pk_init()
  1188. * before calling this function, and to call pk_free()
  1189. * when it fails. If MBEDTLS_ECP_C is defined but MBEDTLS_RSA_C
  1190. * isn't, this leads to mbedtls_pk_free() being called
  1191. * twice, once here and once by the caller, but this is
  1192. * also ok and in line with the mbedtls_pk_free() calls
  1193. * on failed PEM parsing attempts. */
  1194. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  1195. }
  1196. /*
  1197. * Parse a public key
  1198. */
  1199. int mbedtls_pk_parse_public_key( mbedtls_pk_context *ctx,
  1200. const unsigned char *key, size_t keylen )
  1201. {
  1202. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  1203. unsigned char *p;
  1204. #if defined(MBEDTLS_RSA_C)
  1205. const mbedtls_pk_info_t *pk_info;
  1206. #endif
  1207. #if defined(MBEDTLS_PEM_PARSE_C)
  1208. size_t len;
  1209. mbedtls_pem_context pem;
  1210. #endif
  1211. PK_VALIDATE_RET( ctx != NULL );
  1212. if( keylen == 0 )
  1213. return( MBEDTLS_ERR_PK_KEY_INVALID_FORMAT );
  1214. PK_VALIDATE_RET( key != NULL || keylen == 0 );
  1215. #if defined(MBEDTLS_PEM_PARSE_C)
  1216. mbedtls_pem_init( &pem );
  1217. #if defined(MBEDTLS_RSA_C)
  1218. /* Avoid calling mbedtls_pem_read_buffer() on non-null-terminated string */
  1219. if( key[keylen - 1] != '\0' )
  1220. ret = MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  1221. else
  1222. ret = mbedtls_pem_read_buffer( &pem,
  1223. "-----BEGIN RSA PUBLIC KEY-----",
  1224. "-----END RSA PUBLIC KEY-----",
  1225. key, NULL, 0, &len );
  1226. if( ret == 0 )
  1227. {
  1228. p = pem.buf;
  1229. if( ( pk_info = mbedtls_pk_info_from_type( MBEDTLS_PK_RSA ) ) == NULL )
  1230. return( MBEDTLS_ERR_PK_UNKNOWN_PK_ALG );
  1231. if( ( ret = mbedtls_pk_setup( ctx, pk_info ) ) != 0 )
  1232. return( ret );
  1233. if ( ( ret = pk_get_rsapubkey( &p, p + pem.buflen, mbedtls_pk_rsa( *ctx ) ) ) != 0 )
  1234. mbedtls_pk_free( ctx );
  1235. mbedtls_pem_free( &pem );
  1236. return( ret );
  1237. }
  1238. else if( ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT )
  1239. {
  1240. mbedtls_pem_free( &pem );
  1241. return( ret );
  1242. }
  1243. #endif /* MBEDTLS_RSA_C */
  1244. /* Avoid calling mbedtls_pem_read_buffer() on non-null-terminated string */
  1245. if( key[keylen - 1] != '\0' )
  1246. ret = MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  1247. else
  1248. ret = mbedtls_pem_read_buffer( &pem,
  1249. "-----BEGIN PUBLIC KEY-----",
  1250. "-----END PUBLIC KEY-----",
  1251. key, NULL, 0, &len );
  1252. if( ret == 0 )
  1253. {
  1254. /*
  1255. * Was PEM encoded
  1256. */
  1257. p = pem.buf;
  1258. ret = mbedtls_pk_parse_subpubkey( &p, p + pem.buflen, ctx );
  1259. mbedtls_pem_free( &pem );
  1260. return( ret );
  1261. }
  1262. else if( ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT )
  1263. {
  1264. mbedtls_pem_free( &pem );
  1265. return( ret );
  1266. }
  1267. mbedtls_pem_free( &pem );
  1268. #endif /* MBEDTLS_PEM_PARSE_C */
  1269. #if defined(MBEDTLS_RSA_C)
  1270. if( ( pk_info = mbedtls_pk_info_from_type( MBEDTLS_PK_RSA ) ) == NULL )
  1271. return( MBEDTLS_ERR_PK_UNKNOWN_PK_ALG );
  1272. if( ( ret = mbedtls_pk_setup( ctx, pk_info ) ) != 0 )
  1273. return( ret );
  1274. p = (unsigned char *)key;
  1275. ret = pk_get_rsapubkey( &p, p + keylen, mbedtls_pk_rsa( *ctx ) );
  1276. if( ret == 0 )
  1277. {
  1278. return( ret );
  1279. }
  1280. mbedtls_pk_free( ctx );
  1281. if( ret != ( MBEDTLS_ERROR_ADD( MBEDTLS_ERR_PK_INVALID_PUBKEY,
  1282. MBEDTLS_ERR_ASN1_UNEXPECTED_TAG ) ) )
  1283. {
  1284. return( ret );
  1285. }
  1286. #endif /* MBEDTLS_RSA_C */
  1287. p = (unsigned char *) key;
  1288. ret = mbedtls_pk_parse_subpubkey( &p, p + keylen, ctx );
  1289. return( ret );
  1290. }
  1291. #endif /* MBEDTLS_PK_PARSE_C */