ecjpake.c 40 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177
  1. /*
  2. * Elliptic curve J-PAKE
  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. /*
  20. * References in the code are to the Thread v1.0 Specification,
  21. * available to members of the Thread Group http://threadgroup.org/
  22. */
  23. #include "common.h"
  24. #if defined(MBEDTLS_ECJPAKE_C)
  25. #include "mbedtls/ecjpake.h"
  26. #include "mbedtls/platform_util.h"
  27. #include "mbedtls/error.h"
  28. #include <string.h>
  29. #if !defined(MBEDTLS_ECJPAKE_ALT)
  30. /* Parameter validation macros based on platform_util.h */
  31. #define ECJPAKE_VALIDATE_RET( cond ) \
  32. MBEDTLS_INTERNAL_VALIDATE_RET( cond, MBEDTLS_ERR_ECP_BAD_INPUT_DATA )
  33. #define ECJPAKE_VALIDATE( cond ) \
  34. MBEDTLS_INTERNAL_VALIDATE( cond )
  35. /*
  36. * Convert a mbedtls_ecjpake_role to identifier string
  37. */
  38. static const char * const ecjpake_id[] = {
  39. "client",
  40. "server"
  41. };
  42. #define ID_MINE ( ecjpake_id[ ctx->role ] )
  43. #define ID_PEER ( ecjpake_id[ 1 - ctx->role ] )
  44. /*
  45. * Initialize context
  46. */
  47. void mbedtls_ecjpake_init( mbedtls_ecjpake_context *ctx )
  48. {
  49. ECJPAKE_VALIDATE( ctx != NULL );
  50. ctx->md_info = NULL;
  51. mbedtls_ecp_group_init( &ctx->grp );
  52. ctx->point_format = MBEDTLS_ECP_PF_UNCOMPRESSED;
  53. mbedtls_ecp_point_init( &ctx->Xm1 );
  54. mbedtls_ecp_point_init( &ctx->Xm2 );
  55. mbedtls_ecp_point_init( &ctx->Xp1 );
  56. mbedtls_ecp_point_init( &ctx->Xp2 );
  57. mbedtls_ecp_point_init( &ctx->Xp );
  58. mbedtls_mpi_init( &ctx->xm1 );
  59. mbedtls_mpi_init( &ctx->xm2 );
  60. mbedtls_mpi_init( &ctx->s );
  61. }
  62. /*
  63. * Free context
  64. */
  65. void mbedtls_ecjpake_free( mbedtls_ecjpake_context *ctx )
  66. {
  67. if( ctx == NULL )
  68. return;
  69. ctx->md_info = NULL;
  70. mbedtls_ecp_group_free( &ctx->grp );
  71. mbedtls_ecp_point_free( &ctx->Xm1 );
  72. mbedtls_ecp_point_free( &ctx->Xm2 );
  73. mbedtls_ecp_point_free( &ctx->Xp1 );
  74. mbedtls_ecp_point_free( &ctx->Xp2 );
  75. mbedtls_ecp_point_free( &ctx->Xp );
  76. mbedtls_mpi_free( &ctx->xm1 );
  77. mbedtls_mpi_free( &ctx->xm2 );
  78. mbedtls_mpi_free( &ctx->s );
  79. }
  80. /*
  81. * Setup context
  82. */
  83. int mbedtls_ecjpake_setup( mbedtls_ecjpake_context *ctx,
  84. mbedtls_ecjpake_role role,
  85. mbedtls_md_type_t hash,
  86. mbedtls_ecp_group_id curve,
  87. const unsigned char *secret,
  88. size_t len )
  89. {
  90. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  91. ECJPAKE_VALIDATE_RET( ctx != NULL );
  92. ECJPAKE_VALIDATE_RET( role == MBEDTLS_ECJPAKE_CLIENT ||
  93. role == MBEDTLS_ECJPAKE_SERVER );
  94. ECJPAKE_VALIDATE_RET( secret != NULL || len == 0 );
  95. ctx->role = role;
  96. if( ( ctx->md_info = mbedtls_md_info_from_type( hash ) ) == NULL )
  97. return( MBEDTLS_ERR_MD_FEATURE_UNAVAILABLE );
  98. MBEDTLS_MPI_CHK( mbedtls_ecp_group_load( &ctx->grp, curve ) );
  99. MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &ctx->s, secret, len ) );
  100. cleanup:
  101. if( ret != 0 )
  102. mbedtls_ecjpake_free( ctx );
  103. return( ret );
  104. }
  105. int mbedtls_ecjpake_set_point_format( mbedtls_ecjpake_context *ctx,
  106. int point_format )
  107. {
  108. switch( point_format )
  109. {
  110. case MBEDTLS_ECP_PF_UNCOMPRESSED:
  111. case MBEDTLS_ECP_PF_COMPRESSED:
  112. ctx->point_format = point_format;
  113. return( 0 );
  114. default:
  115. return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
  116. }
  117. }
  118. /*
  119. * Check if context is ready for use
  120. */
  121. int mbedtls_ecjpake_check( const mbedtls_ecjpake_context *ctx )
  122. {
  123. ECJPAKE_VALIDATE_RET( ctx != NULL );
  124. if( ctx->md_info == NULL ||
  125. ctx->grp.id == MBEDTLS_ECP_DP_NONE ||
  126. ctx->s.p == NULL )
  127. {
  128. return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
  129. }
  130. return( 0 );
  131. }
  132. /*
  133. * Write a point plus its length to a buffer
  134. */
  135. static int ecjpake_write_len_point( unsigned char **p,
  136. const unsigned char *end,
  137. const mbedtls_ecp_group *grp,
  138. const int pf,
  139. const mbedtls_ecp_point *P )
  140. {
  141. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  142. size_t len;
  143. /* Need at least 4 for length plus 1 for point */
  144. if( end < *p || end - *p < 5 )
  145. return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
  146. ret = mbedtls_ecp_point_write_binary( grp, P, pf,
  147. &len, *p + 4, end - ( *p + 4 ) );
  148. if( ret != 0 )
  149. return( ret );
  150. MBEDTLS_PUT_UINT32_BE( len, *p, 0 );
  151. *p += 4 + len;
  152. return( 0 );
  153. }
  154. /*
  155. * Size of the temporary buffer for ecjpake_hash:
  156. * 3 EC points plus their length, plus ID and its length (4 + 6 bytes)
  157. */
  158. #define ECJPAKE_HASH_BUF_LEN ( 3 * ( 4 + MBEDTLS_ECP_MAX_PT_LEN ) + 4 + 6 )
  159. /*
  160. * Compute hash for ZKP (7.4.2.2.2.1)
  161. */
  162. static int ecjpake_hash( const mbedtls_md_info_t *md_info,
  163. const mbedtls_ecp_group *grp,
  164. const int pf,
  165. const mbedtls_ecp_point *G,
  166. const mbedtls_ecp_point *V,
  167. const mbedtls_ecp_point *X,
  168. const char *id,
  169. mbedtls_mpi *h )
  170. {
  171. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  172. unsigned char buf[ECJPAKE_HASH_BUF_LEN];
  173. unsigned char *p = buf;
  174. const unsigned char *end = buf + sizeof( buf );
  175. const size_t id_len = strlen( id );
  176. unsigned char hash[MBEDTLS_MD_MAX_SIZE];
  177. /* Write things to temporary buffer */
  178. MBEDTLS_MPI_CHK( ecjpake_write_len_point( &p, end, grp, pf, G ) );
  179. MBEDTLS_MPI_CHK( ecjpake_write_len_point( &p, end, grp, pf, V ) );
  180. MBEDTLS_MPI_CHK( ecjpake_write_len_point( &p, end, grp, pf, X ) );
  181. if( end - p < 4 )
  182. return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
  183. MBEDTLS_PUT_UINT32_BE( id_len, p, 0 );
  184. p += 4;
  185. if( end < p || (size_t)( end - p ) < id_len )
  186. return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
  187. memcpy( p, id, id_len );
  188. p += id_len;
  189. /* Compute hash */
  190. MBEDTLS_MPI_CHK( mbedtls_md( md_info, buf, p - buf, hash ) );
  191. /* Turn it into an integer mod n */
  192. MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( h, hash,
  193. mbedtls_md_get_size( md_info ) ) );
  194. MBEDTLS_MPI_CHK( mbedtls_mpi_mod_mpi( h, h, &grp->N ) );
  195. cleanup:
  196. return( ret );
  197. }
  198. /*
  199. * Parse a ECShnorrZKP (7.4.2.2.2) and verify it (7.4.2.3.3)
  200. */
  201. static int ecjpake_zkp_read( const mbedtls_md_info_t *md_info,
  202. const mbedtls_ecp_group *grp,
  203. const int pf,
  204. const mbedtls_ecp_point *G,
  205. const mbedtls_ecp_point *X,
  206. const char *id,
  207. const unsigned char **p,
  208. const unsigned char *end )
  209. {
  210. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  211. mbedtls_ecp_point V, VV;
  212. mbedtls_mpi r, h;
  213. size_t r_len;
  214. mbedtls_ecp_point_init( &V );
  215. mbedtls_ecp_point_init( &VV );
  216. mbedtls_mpi_init( &r );
  217. mbedtls_mpi_init( &h );
  218. /*
  219. * struct {
  220. * ECPoint V;
  221. * opaque r<1..2^8-1>;
  222. * } ECSchnorrZKP;
  223. */
  224. if( end < *p )
  225. return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
  226. MBEDTLS_MPI_CHK( mbedtls_ecp_tls_read_point( grp, &V, p, end - *p ) );
  227. if( end < *p || (size_t)( end - *p ) < 1 )
  228. {
  229. ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
  230. goto cleanup;
  231. }
  232. r_len = *(*p)++;
  233. if( end < *p || (size_t)( end - *p ) < r_len || r_len == 0 )
  234. {
  235. ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
  236. goto cleanup;
  237. }
  238. MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &r, *p, r_len ) );
  239. *p += r_len;
  240. /*
  241. * Verification
  242. */
  243. MBEDTLS_MPI_CHK( ecjpake_hash( md_info, grp, pf, G, &V, X, id, &h ) );
  244. MBEDTLS_MPI_CHK( mbedtls_ecp_muladd( (mbedtls_ecp_group *) grp,
  245. &VV, &h, X, &r, G ) );
  246. if( mbedtls_ecp_point_cmp( &VV, &V ) != 0 )
  247. {
  248. ret = MBEDTLS_ERR_ECP_VERIFY_FAILED;
  249. goto cleanup;
  250. }
  251. cleanup:
  252. mbedtls_ecp_point_free( &V );
  253. mbedtls_ecp_point_free( &VV );
  254. mbedtls_mpi_free( &r );
  255. mbedtls_mpi_free( &h );
  256. return( ret );
  257. }
  258. /*
  259. * Generate ZKP (7.4.2.3.2) and write it as ECSchnorrZKP (7.4.2.2.2)
  260. */
  261. static int ecjpake_zkp_write( const mbedtls_md_info_t *md_info,
  262. const mbedtls_ecp_group *grp,
  263. const int pf,
  264. const mbedtls_ecp_point *G,
  265. const mbedtls_mpi *x,
  266. const mbedtls_ecp_point *X,
  267. const char *id,
  268. unsigned char **p,
  269. const unsigned char *end,
  270. int (*f_rng)(void *, unsigned char *, size_t),
  271. void *p_rng )
  272. {
  273. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  274. mbedtls_ecp_point V;
  275. mbedtls_mpi v;
  276. mbedtls_mpi h; /* later recycled to hold r */
  277. size_t len;
  278. if( end < *p )
  279. return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
  280. mbedtls_ecp_point_init( &V );
  281. mbedtls_mpi_init( &v );
  282. mbedtls_mpi_init( &h );
  283. /* Compute signature */
  284. MBEDTLS_MPI_CHK( mbedtls_ecp_gen_keypair_base( (mbedtls_ecp_group *) grp,
  285. G, &v, &V, f_rng, p_rng ) );
  286. MBEDTLS_MPI_CHK( ecjpake_hash( md_info, grp, pf, G, &V, X, id, &h ) );
  287. MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &h, &h, x ) ); /* x*h */
  288. MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &h, &v, &h ) ); /* v - x*h */
  289. MBEDTLS_MPI_CHK( mbedtls_mpi_mod_mpi( &h, &h, &grp->N ) ); /* r */
  290. /* Write it out */
  291. MBEDTLS_MPI_CHK( mbedtls_ecp_tls_write_point( grp, &V,
  292. pf, &len, *p, end - *p ) );
  293. *p += len;
  294. len = mbedtls_mpi_size( &h ); /* actually r */
  295. if( end < *p || (size_t)( end - *p ) < 1 + len || len > 255 )
  296. {
  297. ret = MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL;
  298. goto cleanup;
  299. }
  300. *(*p)++ = MBEDTLS_BYTE_0( len );
  301. MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &h, *p, len ) ); /* r */
  302. *p += len;
  303. cleanup:
  304. mbedtls_ecp_point_free( &V );
  305. mbedtls_mpi_free( &v );
  306. mbedtls_mpi_free( &h );
  307. return( ret );
  308. }
  309. /*
  310. * Parse a ECJPAKEKeyKP (7.4.2.2.1) and check proof
  311. * Output: verified public key X
  312. */
  313. static int ecjpake_kkp_read( const mbedtls_md_info_t *md_info,
  314. const mbedtls_ecp_group *grp,
  315. const int pf,
  316. const mbedtls_ecp_point *G,
  317. mbedtls_ecp_point *X,
  318. const char *id,
  319. const unsigned char **p,
  320. const unsigned char *end )
  321. {
  322. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  323. if( end < *p )
  324. return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
  325. /*
  326. * struct {
  327. * ECPoint X;
  328. * ECSchnorrZKP zkp;
  329. * } ECJPAKEKeyKP;
  330. */
  331. MBEDTLS_MPI_CHK( mbedtls_ecp_tls_read_point( grp, X, p, end - *p ) );
  332. if( mbedtls_ecp_is_zero( X ) )
  333. {
  334. ret = MBEDTLS_ERR_ECP_INVALID_KEY;
  335. goto cleanup;
  336. }
  337. MBEDTLS_MPI_CHK( ecjpake_zkp_read( md_info, grp, pf, G, X, id, p, end ) );
  338. cleanup:
  339. return( ret );
  340. }
  341. /*
  342. * Generate an ECJPAKEKeyKP
  343. * Output: the serialized structure, plus private/public key pair
  344. */
  345. static int ecjpake_kkp_write( const mbedtls_md_info_t *md_info,
  346. const mbedtls_ecp_group *grp,
  347. const int pf,
  348. const mbedtls_ecp_point *G,
  349. mbedtls_mpi *x,
  350. mbedtls_ecp_point *X,
  351. const char *id,
  352. unsigned char **p,
  353. const unsigned char *end,
  354. int (*f_rng)(void *, unsigned char *, size_t),
  355. void *p_rng )
  356. {
  357. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  358. size_t len;
  359. if( end < *p )
  360. return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
  361. /* Generate key (7.4.2.3.1) and write it out */
  362. MBEDTLS_MPI_CHK( mbedtls_ecp_gen_keypair_base( (mbedtls_ecp_group *) grp, G, x, X,
  363. f_rng, p_rng ) );
  364. MBEDTLS_MPI_CHK( mbedtls_ecp_tls_write_point( grp, X,
  365. pf, &len, *p, end - *p ) );
  366. *p += len;
  367. /* Generate and write proof */
  368. MBEDTLS_MPI_CHK( ecjpake_zkp_write( md_info, grp, pf, G, x, X, id,
  369. p, end, f_rng, p_rng ) );
  370. cleanup:
  371. return( ret );
  372. }
  373. /*
  374. * Read a ECJPAKEKeyKPPairList (7.4.2.3) and check proofs
  375. * Ouputs: verified peer public keys Xa, Xb
  376. */
  377. static int ecjpake_kkpp_read( const mbedtls_md_info_t *md_info,
  378. const mbedtls_ecp_group *grp,
  379. const int pf,
  380. const mbedtls_ecp_point *G,
  381. mbedtls_ecp_point *Xa,
  382. mbedtls_ecp_point *Xb,
  383. const char *id,
  384. const unsigned char *buf,
  385. size_t len )
  386. {
  387. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  388. const unsigned char *p = buf;
  389. const unsigned char *end = buf + len;
  390. /*
  391. * struct {
  392. * ECJPAKEKeyKP ecjpake_key_kp_pair_list[2];
  393. * } ECJPAKEKeyKPPairList;
  394. */
  395. MBEDTLS_MPI_CHK( ecjpake_kkp_read( md_info, grp, pf, G, Xa, id, &p, end ) );
  396. MBEDTLS_MPI_CHK( ecjpake_kkp_read( md_info, grp, pf, G, Xb, id, &p, end ) );
  397. if( p != end )
  398. ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
  399. cleanup:
  400. return( ret );
  401. }
  402. /*
  403. * Generate a ECJPAKEKeyKPPairList
  404. * Outputs: the serialized structure, plus two private/public key pairs
  405. */
  406. static int ecjpake_kkpp_write( const mbedtls_md_info_t *md_info,
  407. const mbedtls_ecp_group *grp,
  408. const int pf,
  409. const mbedtls_ecp_point *G,
  410. mbedtls_mpi *xm1,
  411. mbedtls_ecp_point *Xa,
  412. mbedtls_mpi *xm2,
  413. mbedtls_ecp_point *Xb,
  414. const char *id,
  415. unsigned char *buf,
  416. size_t len,
  417. size_t *olen,
  418. int (*f_rng)(void *, unsigned char *, size_t),
  419. void *p_rng )
  420. {
  421. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  422. unsigned char *p = buf;
  423. const unsigned char *end = buf + len;
  424. MBEDTLS_MPI_CHK( ecjpake_kkp_write( md_info, grp, pf, G, xm1, Xa, id,
  425. &p, end, f_rng, p_rng ) );
  426. MBEDTLS_MPI_CHK( ecjpake_kkp_write( md_info, grp, pf, G, xm2, Xb, id,
  427. &p, end, f_rng, p_rng ) );
  428. *olen = p - buf;
  429. cleanup:
  430. return( ret );
  431. }
  432. /*
  433. * Read and process the first round message
  434. */
  435. int mbedtls_ecjpake_read_round_one( mbedtls_ecjpake_context *ctx,
  436. const unsigned char *buf,
  437. size_t len )
  438. {
  439. ECJPAKE_VALIDATE_RET( ctx != NULL );
  440. ECJPAKE_VALIDATE_RET( buf != NULL );
  441. return( ecjpake_kkpp_read( ctx->md_info, &ctx->grp, ctx->point_format,
  442. &ctx->grp.G,
  443. &ctx->Xp1, &ctx->Xp2, ID_PEER,
  444. buf, len ) );
  445. }
  446. /*
  447. * Generate and write the first round message
  448. */
  449. int mbedtls_ecjpake_write_round_one( mbedtls_ecjpake_context *ctx,
  450. unsigned char *buf, size_t len, size_t *olen,
  451. int (*f_rng)(void *, unsigned char *, size_t),
  452. void *p_rng )
  453. {
  454. ECJPAKE_VALIDATE_RET( ctx != NULL );
  455. ECJPAKE_VALIDATE_RET( buf != NULL );
  456. ECJPAKE_VALIDATE_RET( olen != NULL );
  457. ECJPAKE_VALIDATE_RET( f_rng != NULL );
  458. return( ecjpake_kkpp_write( ctx->md_info, &ctx->grp, ctx->point_format,
  459. &ctx->grp.G,
  460. &ctx->xm1, &ctx->Xm1, &ctx->xm2, &ctx->Xm2,
  461. ID_MINE, buf, len, olen, f_rng, p_rng ) );
  462. }
  463. /*
  464. * Compute the sum of three points R = A + B + C
  465. */
  466. static int ecjpake_ecp_add3( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
  467. const mbedtls_ecp_point *A,
  468. const mbedtls_ecp_point *B,
  469. const mbedtls_ecp_point *C )
  470. {
  471. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  472. mbedtls_mpi one;
  473. mbedtls_mpi_init( &one );
  474. MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &one, 1 ) );
  475. MBEDTLS_MPI_CHK( mbedtls_ecp_muladd( grp, R, &one, A, &one, B ) );
  476. MBEDTLS_MPI_CHK( mbedtls_ecp_muladd( grp, R, &one, R, &one, C ) );
  477. cleanup:
  478. mbedtls_mpi_free( &one );
  479. return( ret );
  480. }
  481. /*
  482. * Read and process second round message (C: 7.4.2.5, S: 7.4.2.6)
  483. */
  484. int mbedtls_ecjpake_read_round_two( mbedtls_ecjpake_context *ctx,
  485. const unsigned char *buf,
  486. size_t len )
  487. {
  488. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  489. const unsigned char *p = buf;
  490. const unsigned char *end = buf + len;
  491. mbedtls_ecp_group grp;
  492. mbedtls_ecp_point G; /* C: GB, S: GA */
  493. ECJPAKE_VALIDATE_RET( ctx != NULL );
  494. ECJPAKE_VALIDATE_RET( buf != NULL );
  495. mbedtls_ecp_group_init( &grp );
  496. mbedtls_ecp_point_init( &G );
  497. /*
  498. * Server: GA = X3 + X4 + X1 (7.4.2.6.1)
  499. * Client: GB = X1 + X2 + X3 (7.4.2.5.1)
  500. * Unified: G = Xm1 + Xm2 + Xp1
  501. * We need that before parsing in order to check Xp as we read it
  502. */
  503. MBEDTLS_MPI_CHK( ecjpake_ecp_add3( &ctx->grp, &G,
  504. &ctx->Xm1, &ctx->Xm2, &ctx->Xp1 ) );
  505. /*
  506. * struct {
  507. * ECParameters curve_params; // only client reading server msg
  508. * ECJPAKEKeyKP ecjpake_key_kp;
  509. * } Client/ServerECJPAKEParams;
  510. */
  511. if( ctx->role == MBEDTLS_ECJPAKE_CLIENT )
  512. {
  513. MBEDTLS_MPI_CHK( mbedtls_ecp_tls_read_group( &grp, &p, len ) );
  514. if( grp.id != ctx->grp.id )
  515. {
  516. ret = MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE;
  517. goto cleanup;
  518. }
  519. }
  520. MBEDTLS_MPI_CHK( ecjpake_kkp_read( ctx->md_info, &ctx->grp,
  521. ctx->point_format,
  522. &G, &ctx->Xp, ID_PEER, &p, end ) );
  523. if( p != end )
  524. {
  525. ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
  526. goto cleanup;
  527. }
  528. cleanup:
  529. mbedtls_ecp_group_free( &grp );
  530. mbedtls_ecp_point_free( &G );
  531. return( ret );
  532. }
  533. /*
  534. * Compute R = +/- X * S mod N, taking care not to leak S
  535. */
  536. static int ecjpake_mul_secret( mbedtls_mpi *R, int sign,
  537. const mbedtls_mpi *X,
  538. const mbedtls_mpi *S,
  539. const mbedtls_mpi *N,
  540. int (*f_rng)(void *, unsigned char *, size_t),
  541. void *p_rng )
  542. {
  543. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  544. mbedtls_mpi b; /* Blinding value, then s + N * blinding */
  545. mbedtls_mpi_init( &b );
  546. /* b = s + rnd-128-bit * N */
  547. MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( &b, 16, f_rng, p_rng ) );
  548. MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &b, &b, N ) );
  549. MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &b, &b, S ) );
  550. /* R = sign * X * b mod N */
  551. MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( R, X, &b ) );
  552. R->s *= sign;
  553. MBEDTLS_MPI_CHK( mbedtls_mpi_mod_mpi( R, R, N ) );
  554. cleanup:
  555. mbedtls_mpi_free( &b );
  556. return( ret );
  557. }
  558. /*
  559. * Generate and write the second round message (S: 7.4.2.5, C: 7.4.2.6)
  560. */
  561. int mbedtls_ecjpake_write_round_two( mbedtls_ecjpake_context *ctx,
  562. unsigned char *buf, size_t len, size_t *olen,
  563. int (*f_rng)(void *, unsigned char *, size_t),
  564. void *p_rng )
  565. {
  566. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  567. mbedtls_ecp_point G; /* C: GA, S: GB */
  568. mbedtls_ecp_point Xm; /* C: Xc, S: Xs */
  569. mbedtls_mpi xm; /* C: xc, S: xs */
  570. unsigned char *p = buf;
  571. const unsigned char *end = buf + len;
  572. size_t ec_len;
  573. ECJPAKE_VALIDATE_RET( ctx != NULL );
  574. ECJPAKE_VALIDATE_RET( buf != NULL );
  575. ECJPAKE_VALIDATE_RET( olen != NULL );
  576. ECJPAKE_VALIDATE_RET( f_rng != NULL );
  577. mbedtls_ecp_point_init( &G );
  578. mbedtls_ecp_point_init( &Xm );
  579. mbedtls_mpi_init( &xm );
  580. /*
  581. * First generate private/public key pair (S: 7.4.2.5.1, C: 7.4.2.6.1)
  582. *
  583. * Client: GA = X1 + X3 + X4 | xs = x2 * s | Xc = xc * GA
  584. * Server: GB = X3 + X1 + X2 | xs = x4 * s | Xs = xs * GB
  585. * Unified: G = Xm1 + Xp1 + Xp2 | xm = xm2 * s | Xm = xm * G
  586. */
  587. MBEDTLS_MPI_CHK( ecjpake_ecp_add3( &ctx->grp, &G,
  588. &ctx->Xp1, &ctx->Xp2, &ctx->Xm1 ) );
  589. MBEDTLS_MPI_CHK( ecjpake_mul_secret( &xm, 1, &ctx->xm2, &ctx->s,
  590. &ctx->grp.N, f_rng, p_rng ) );
  591. MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &ctx->grp, &Xm, &xm, &G, f_rng, p_rng ) );
  592. /*
  593. * Now write things out
  594. *
  595. * struct {
  596. * ECParameters curve_params; // only server writing its message
  597. * ECJPAKEKeyKP ecjpake_key_kp;
  598. * } Client/ServerECJPAKEParams;
  599. */
  600. if( ctx->role == MBEDTLS_ECJPAKE_SERVER )
  601. {
  602. if( end < p )
  603. {
  604. ret = MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL;
  605. goto cleanup;
  606. }
  607. MBEDTLS_MPI_CHK( mbedtls_ecp_tls_write_group( &ctx->grp, &ec_len,
  608. p, end - p ) );
  609. p += ec_len;
  610. }
  611. if( end < p )
  612. {
  613. ret = MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL;
  614. goto cleanup;
  615. }
  616. MBEDTLS_MPI_CHK( mbedtls_ecp_tls_write_point( &ctx->grp, &Xm,
  617. ctx->point_format, &ec_len, p, end - p ) );
  618. p += ec_len;
  619. MBEDTLS_MPI_CHK( ecjpake_zkp_write( ctx->md_info, &ctx->grp,
  620. ctx->point_format,
  621. &G, &xm, &Xm, ID_MINE,
  622. &p, end, f_rng, p_rng ) );
  623. *olen = p - buf;
  624. cleanup:
  625. mbedtls_ecp_point_free( &G );
  626. mbedtls_ecp_point_free( &Xm );
  627. mbedtls_mpi_free( &xm );
  628. return( ret );
  629. }
  630. /*
  631. * Derive PMS (7.4.2.7 / 7.4.2.8)
  632. */
  633. int mbedtls_ecjpake_derive_secret( mbedtls_ecjpake_context *ctx,
  634. unsigned char *buf, size_t len, size_t *olen,
  635. int (*f_rng)(void *, unsigned char *, size_t),
  636. void *p_rng )
  637. {
  638. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  639. mbedtls_ecp_point K;
  640. mbedtls_mpi m_xm2_s, one;
  641. unsigned char kx[MBEDTLS_ECP_MAX_BYTES];
  642. size_t x_bytes;
  643. ECJPAKE_VALIDATE_RET( ctx != NULL );
  644. ECJPAKE_VALIDATE_RET( buf != NULL );
  645. ECJPAKE_VALIDATE_RET( olen != NULL );
  646. ECJPAKE_VALIDATE_RET( f_rng != NULL );
  647. *olen = mbedtls_md_get_size( ctx->md_info );
  648. if( len < *olen )
  649. return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
  650. mbedtls_ecp_point_init( &K );
  651. mbedtls_mpi_init( &m_xm2_s );
  652. mbedtls_mpi_init( &one );
  653. MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &one, 1 ) );
  654. /*
  655. * Client: K = ( Xs - X4 * x2 * s ) * x2
  656. * Server: K = ( Xc - X2 * x4 * s ) * x4
  657. * Unified: K = ( Xp - Xp2 * xm2 * s ) * xm2
  658. */
  659. MBEDTLS_MPI_CHK( ecjpake_mul_secret( &m_xm2_s, -1, &ctx->xm2, &ctx->s,
  660. &ctx->grp.N, f_rng, p_rng ) );
  661. MBEDTLS_MPI_CHK( mbedtls_ecp_muladd( &ctx->grp, &K,
  662. &one, &ctx->Xp,
  663. &m_xm2_s, &ctx->Xp2 ) );
  664. MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &ctx->grp, &K, &ctx->xm2, &K,
  665. f_rng, p_rng ) );
  666. /* PMS = SHA-256( K.X ) */
  667. x_bytes = ( ctx->grp.pbits + 7 ) / 8;
  668. MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &K.X, kx, x_bytes ) );
  669. MBEDTLS_MPI_CHK( mbedtls_md( ctx->md_info, kx, x_bytes, buf ) );
  670. cleanup:
  671. mbedtls_ecp_point_free( &K );
  672. mbedtls_mpi_free( &m_xm2_s );
  673. mbedtls_mpi_free( &one );
  674. return( ret );
  675. }
  676. #undef ID_MINE
  677. #undef ID_PEER
  678. #endif /* ! MBEDTLS_ECJPAKE_ALT */
  679. #if defined(MBEDTLS_SELF_TEST)
  680. #if defined(MBEDTLS_PLATFORM_C)
  681. #include "mbedtls/platform.h"
  682. #else
  683. #include <stdio.h>
  684. #define mbedtls_printf printf
  685. #endif
  686. #if !defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED) || \
  687. !defined(MBEDTLS_SHA256_C)
  688. int mbedtls_ecjpake_self_test( int verbose )
  689. {
  690. (void) verbose;
  691. return( 0 );
  692. }
  693. #else
  694. static const unsigned char ecjpake_test_password[] = {
  695. 0x74, 0x68, 0x72, 0x65, 0x61, 0x64, 0x6a, 0x70, 0x61, 0x6b, 0x65, 0x74,
  696. 0x65, 0x73, 0x74
  697. };
  698. #if !defined(MBEDTLS_ECJPAKE_ALT)
  699. static const unsigned char ecjpake_test_x1[] = {
  700. 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0a, 0x0b, 0x0c,
  701. 0x0d, 0x0e, 0x0f, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18,
  702. 0x19, 0x1a, 0x1b, 0x1c, 0x1d, 0x1e, 0x1f, 0x21
  703. };
  704. static const unsigned char ecjpake_test_x2[] = {
  705. 0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6a, 0x6b, 0x6c,
  706. 0x6d, 0x6e, 0x6f, 0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78,
  707. 0x79, 0x7a, 0x7b, 0x7c, 0x7d, 0x7e, 0x7f, 0x81
  708. };
  709. static const unsigned char ecjpake_test_x3[] = {
  710. 0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6a, 0x6b, 0x6c,
  711. 0x6d, 0x6e, 0x6f, 0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78,
  712. 0x79, 0x7a, 0x7b, 0x7c, 0x7d, 0x7e, 0x7f, 0x81
  713. };
  714. static const unsigned char ecjpake_test_x4[] = {
  715. 0xc1, 0xc2, 0xc3, 0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xcb, 0xcc,
  716. 0xcd, 0xce, 0xcf, 0xd0, 0xd1, 0xd2, 0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8,
  717. 0xd9, 0xda, 0xdb, 0xdc, 0xdd, 0xde, 0xdf, 0xe1
  718. };
  719. static const unsigned char ecjpake_test_cli_one[] = {
  720. 0x41, 0x04, 0xac, 0xcf, 0x01, 0x06, 0xef, 0x85, 0x8f, 0xa2, 0xd9, 0x19,
  721. 0x33, 0x13, 0x46, 0x80, 0x5a, 0x78, 0xb5, 0x8b, 0xba, 0xd0, 0xb8, 0x44,
  722. 0xe5, 0xc7, 0x89, 0x28, 0x79, 0x14, 0x61, 0x87, 0xdd, 0x26, 0x66, 0xad,
  723. 0xa7, 0x81, 0xbb, 0x7f, 0x11, 0x13, 0x72, 0x25, 0x1a, 0x89, 0x10, 0x62,
  724. 0x1f, 0x63, 0x4d, 0xf1, 0x28, 0xac, 0x48, 0xe3, 0x81, 0xfd, 0x6e, 0xf9,
  725. 0x06, 0x07, 0x31, 0xf6, 0x94, 0xa4, 0x41, 0x04, 0x1d, 0xd0, 0xbd, 0x5d,
  726. 0x45, 0x66, 0xc9, 0xbe, 0xd9, 0xce, 0x7d, 0xe7, 0x01, 0xb5, 0xe8, 0x2e,
  727. 0x08, 0xe8, 0x4b, 0x73, 0x04, 0x66, 0x01, 0x8a, 0xb9, 0x03, 0xc7, 0x9e,
  728. 0xb9, 0x82, 0x17, 0x22, 0x36, 0xc0, 0xc1, 0x72, 0x8a, 0xe4, 0xbf, 0x73,
  729. 0x61, 0x0d, 0x34, 0xde, 0x44, 0x24, 0x6e, 0xf3, 0xd9, 0xc0, 0x5a, 0x22,
  730. 0x36, 0xfb, 0x66, 0xa6, 0x58, 0x3d, 0x74, 0x49, 0x30, 0x8b, 0xab, 0xce,
  731. 0x20, 0x72, 0xfe, 0x16, 0x66, 0x29, 0x92, 0xe9, 0x23, 0x5c, 0x25, 0x00,
  732. 0x2f, 0x11, 0xb1, 0x50, 0x87, 0xb8, 0x27, 0x38, 0xe0, 0x3c, 0x94, 0x5b,
  733. 0xf7, 0xa2, 0x99, 0x5d, 0xda, 0x1e, 0x98, 0x34, 0x58, 0x41, 0x04, 0x7e,
  734. 0xa6, 0xe3, 0xa4, 0x48, 0x70, 0x37, 0xa9, 0xe0, 0xdb, 0xd7, 0x92, 0x62,
  735. 0xb2, 0xcc, 0x27, 0x3e, 0x77, 0x99, 0x30, 0xfc, 0x18, 0x40, 0x9a, 0xc5,
  736. 0x36, 0x1c, 0x5f, 0xe6, 0x69, 0xd7, 0x02, 0xe1, 0x47, 0x79, 0x0a, 0xeb,
  737. 0x4c, 0xe7, 0xfd, 0x65, 0x75, 0xab, 0x0f, 0x6c, 0x7f, 0xd1, 0xc3, 0x35,
  738. 0x93, 0x9a, 0xa8, 0x63, 0xba, 0x37, 0xec, 0x91, 0xb7, 0xe3, 0x2b, 0xb0,
  739. 0x13, 0xbb, 0x2b, 0x41, 0x04, 0xa4, 0x95, 0x58, 0xd3, 0x2e, 0xd1, 0xeb,
  740. 0xfc, 0x18, 0x16, 0xaf, 0x4f, 0xf0, 0x9b, 0x55, 0xfc, 0xb4, 0xca, 0x47,
  741. 0xb2, 0xa0, 0x2d, 0x1e, 0x7c, 0xaf, 0x11, 0x79, 0xea, 0x3f, 0xe1, 0x39,
  742. 0x5b, 0x22, 0xb8, 0x61, 0x96, 0x40, 0x16, 0xfa, 0xba, 0xf7, 0x2c, 0x97,
  743. 0x56, 0x95, 0xd9, 0x3d, 0x4d, 0xf0, 0xe5, 0x19, 0x7f, 0xe9, 0xf0, 0x40,
  744. 0x63, 0x4e, 0xd5, 0x97, 0x64, 0x93, 0x77, 0x87, 0xbe, 0x20, 0xbc, 0x4d,
  745. 0xee, 0xbb, 0xf9, 0xb8, 0xd6, 0x0a, 0x33, 0x5f, 0x04, 0x6c, 0xa3, 0xaa,
  746. 0x94, 0x1e, 0x45, 0x86, 0x4c, 0x7c, 0xad, 0xef, 0x9c, 0xf7, 0x5b, 0x3d,
  747. 0x8b, 0x01, 0x0e, 0x44, 0x3e, 0xf0
  748. };
  749. static const unsigned char ecjpake_test_srv_one[] = {
  750. 0x41, 0x04, 0x7e, 0xa6, 0xe3, 0xa4, 0x48, 0x70, 0x37, 0xa9, 0xe0, 0xdb,
  751. 0xd7, 0x92, 0x62, 0xb2, 0xcc, 0x27, 0x3e, 0x77, 0x99, 0x30, 0xfc, 0x18,
  752. 0x40, 0x9a, 0xc5, 0x36, 0x1c, 0x5f, 0xe6, 0x69, 0xd7, 0x02, 0xe1, 0x47,
  753. 0x79, 0x0a, 0xeb, 0x4c, 0xe7, 0xfd, 0x65, 0x75, 0xab, 0x0f, 0x6c, 0x7f,
  754. 0xd1, 0xc3, 0x35, 0x93, 0x9a, 0xa8, 0x63, 0xba, 0x37, 0xec, 0x91, 0xb7,
  755. 0xe3, 0x2b, 0xb0, 0x13, 0xbb, 0x2b, 0x41, 0x04, 0x09, 0xf8, 0x5b, 0x3d,
  756. 0x20, 0xeb, 0xd7, 0x88, 0x5c, 0xe4, 0x64, 0xc0, 0x8d, 0x05, 0x6d, 0x64,
  757. 0x28, 0xfe, 0x4d, 0xd9, 0x28, 0x7a, 0xa3, 0x65, 0xf1, 0x31, 0xf4, 0x36,
  758. 0x0f, 0xf3, 0x86, 0xd8, 0x46, 0x89, 0x8b, 0xc4, 0xb4, 0x15, 0x83, 0xc2,
  759. 0xa5, 0x19, 0x7f, 0x65, 0xd7, 0x87, 0x42, 0x74, 0x6c, 0x12, 0xa5, 0xec,
  760. 0x0a, 0x4f, 0xfe, 0x2f, 0x27, 0x0a, 0x75, 0x0a, 0x1d, 0x8f, 0xb5, 0x16,
  761. 0x20, 0x93, 0x4d, 0x74, 0xeb, 0x43, 0xe5, 0x4d, 0xf4, 0x24, 0xfd, 0x96,
  762. 0x30, 0x6c, 0x01, 0x17, 0xbf, 0x13, 0x1a, 0xfa, 0xbf, 0x90, 0xa9, 0xd3,
  763. 0x3d, 0x11, 0x98, 0xd9, 0x05, 0x19, 0x37, 0x35, 0x14, 0x41, 0x04, 0x19,
  764. 0x0a, 0x07, 0x70, 0x0f, 0xfa, 0x4b, 0xe6, 0xae, 0x1d, 0x79, 0xee, 0x0f,
  765. 0x06, 0xae, 0xb5, 0x44, 0xcd, 0x5a, 0xdd, 0xaa, 0xbe, 0xdf, 0x70, 0xf8,
  766. 0x62, 0x33, 0x21, 0x33, 0x2c, 0x54, 0xf3, 0x55, 0xf0, 0xfb, 0xfe, 0xc7,
  767. 0x83, 0xed, 0x35, 0x9e, 0x5d, 0x0b, 0xf7, 0x37, 0x7a, 0x0f, 0xc4, 0xea,
  768. 0x7a, 0xce, 0x47, 0x3c, 0x9c, 0x11, 0x2b, 0x41, 0xcc, 0xd4, 0x1a, 0xc5,
  769. 0x6a, 0x56, 0x12, 0x41, 0x04, 0x36, 0x0a, 0x1c, 0xea, 0x33, 0xfc, 0xe6,
  770. 0x41, 0x15, 0x64, 0x58, 0xe0, 0xa4, 0xea, 0xc2, 0x19, 0xe9, 0x68, 0x31,
  771. 0xe6, 0xae, 0xbc, 0x88, 0xb3, 0xf3, 0x75, 0x2f, 0x93, 0xa0, 0x28, 0x1d,
  772. 0x1b, 0xf1, 0xfb, 0x10, 0x60, 0x51, 0xdb, 0x96, 0x94, 0xa8, 0xd6, 0xe8,
  773. 0x62, 0xa5, 0xef, 0x13, 0x24, 0xa3, 0xd9, 0xe2, 0x78, 0x94, 0xf1, 0xee,
  774. 0x4f, 0x7c, 0x59, 0x19, 0x99, 0x65, 0xa8, 0xdd, 0x4a, 0x20, 0x91, 0x84,
  775. 0x7d, 0x2d, 0x22, 0xdf, 0x3e, 0xe5, 0x5f, 0xaa, 0x2a, 0x3f, 0xb3, 0x3f,
  776. 0xd2, 0xd1, 0xe0, 0x55, 0xa0, 0x7a, 0x7c, 0x61, 0xec, 0xfb, 0x8d, 0x80,
  777. 0xec, 0x00, 0xc2, 0xc9, 0xeb, 0x12
  778. };
  779. static const unsigned char ecjpake_test_srv_two[] = {
  780. 0x03, 0x00, 0x17, 0x41, 0x04, 0x0f, 0xb2, 0x2b, 0x1d, 0x5d, 0x11, 0x23,
  781. 0xe0, 0xef, 0x9f, 0xeb, 0x9d, 0x8a, 0x2e, 0x59, 0x0a, 0x1f, 0x4d, 0x7c,
  782. 0xed, 0x2c, 0x2b, 0x06, 0x58, 0x6e, 0x8f, 0x2a, 0x16, 0xd4, 0xeb, 0x2f,
  783. 0xda, 0x43, 0x28, 0xa2, 0x0b, 0x07, 0xd8, 0xfd, 0x66, 0x76, 0x54, 0xca,
  784. 0x18, 0xc5, 0x4e, 0x32, 0xa3, 0x33, 0xa0, 0x84, 0x54, 0x51, 0xe9, 0x26,
  785. 0xee, 0x88, 0x04, 0xfd, 0x7a, 0xf0, 0xaa, 0xa7, 0xa6, 0x41, 0x04, 0x55,
  786. 0x16, 0xea, 0x3e, 0x54, 0xa0, 0xd5, 0xd8, 0xb2, 0xce, 0x78, 0x6b, 0x38,
  787. 0xd3, 0x83, 0x37, 0x00, 0x29, 0xa5, 0xdb, 0xe4, 0x45, 0x9c, 0x9d, 0xd6,
  788. 0x01, 0xb4, 0x08, 0xa2, 0x4a, 0xe6, 0x46, 0x5c, 0x8a, 0xc9, 0x05, 0xb9,
  789. 0xeb, 0x03, 0xb5, 0xd3, 0x69, 0x1c, 0x13, 0x9e, 0xf8, 0x3f, 0x1c, 0xd4,
  790. 0x20, 0x0f, 0x6c, 0x9c, 0xd4, 0xec, 0x39, 0x22, 0x18, 0xa5, 0x9e, 0xd2,
  791. 0x43, 0xd3, 0xc8, 0x20, 0xff, 0x72, 0x4a, 0x9a, 0x70, 0xb8, 0x8c, 0xb8,
  792. 0x6f, 0x20, 0xb4, 0x34, 0xc6, 0x86, 0x5a, 0xa1, 0xcd, 0x79, 0x06, 0xdd,
  793. 0x7c, 0x9b, 0xce, 0x35, 0x25, 0xf5, 0x08, 0x27, 0x6f, 0x26, 0x83, 0x6c
  794. };
  795. static const unsigned char ecjpake_test_cli_two[] = {
  796. 0x41, 0x04, 0x69, 0xd5, 0x4e, 0xe8, 0x5e, 0x90, 0xce, 0x3f, 0x12, 0x46,
  797. 0x74, 0x2d, 0xe5, 0x07, 0xe9, 0x39, 0xe8, 0x1d, 0x1d, 0xc1, 0xc5, 0xcb,
  798. 0x98, 0x8b, 0x58, 0xc3, 0x10, 0xc9, 0xfd, 0xd9, 0x52, 0x4d, 0x93, 0x72,
  799. 0x0b, 0x45, 0x54, 0x1c, 0x83, 0xee, 0x88, 0x41, 0x19, 0x1d, 0xa7, 0xce,
  800. 0xd8, 0x6e, 0x33, 0x12, 0xd4, 0x36, 0x23, 0xc1, 0xd6, 0x3e, 0x74, 0x98,
  801. 0x9a, 0xba, 0x4a, 0xff, 0xd1, 0xee, 0x41, 0x04, 0x07, 0x7e, 0x8c, 0x31,
  802. 0xe2, 0x0e, 0x6b, 0xed, 0xb7, 0x60, 0xc1, 0x35, 0x93, 0xe6, 0x9f, 0x15,
  803. 0xbe, 0x85, 0xc2, 0x7d, 0x68, 0xcd, 0x09, 0xcc, 0xb8, 0xc4, 0x18, 0x36,
  804. 0x08, 0x91, 0x7c, 0x5c, 0x3d, 0x40, 0x9f, 0xac, 0x39, 0xfe, 0xfe, 0xe8,
  805. 0x2f, 0x72, 0x92, 0xd3, 0x6f, 0x0d, 0x23, 0xe0, 0x55, 0x91, 0x3f, 0x45,
  806. 0xa5, 0x2b, 0x85, 0xdd, 0x8a, 0x20, 0x52, 0xe9, 0xe1, 0x29, 0xbb, 0x4d,
  807. 0x20, 0x0f, 0x01, 0x1f, 0x19, 0x48, 0x35, 0x35, 0xa6, 0xe8, 0x9a, 0x58,
  808. 0x0c, 0x9b, 0x00, 0x03, 0xba, 0xf2, 0x14, 0x62, 0xec, 0xe9, 0x1a, 0x82,
  809. 0xcc, 0x38, 0xdb, 0xdc, 0xae, 0x60, 0xd9, 0xc5, 0x4c
  810. };
  811. static const unsigned char ecjpake_test_pms[] = {
  812. 0xf3, 0xd4, 0x7f, 0x59, 0x98, 0x44, 0xdb, 0x92, 0xa5, 0x69, 0xbb, 0xe7,
  813. 0x98, 0x1e, 0x39, 0xd9, 0x31, 0xfd, 0x74, 0x3b, 0xf2, 0x2e, 0x98, 0xf9,
  814. 0xb4, 0x38, 0xf7, 0x19, 0xd3, 0xc4, 0xf3, 0x51
  815. };
  816. /*
  817. * PRNG for test - !!!INSECURE NEVER USE IN PRODUCTION!!!
  818. *
  819. * This is the linear congruential generator from numerical recipes,
  820. * except we only use the low byte as the output. See
  821. * https://en.wikipedia.org/wiki/Linear_congruential_generator#Parameters_in_common_use
  822. */
  823. static int self_test_rng( void *ctx, unsigned char *out, size_t len )
  824. {
  825. static uint32_t state = 42;
  826. (void) ctx;
  827. for( size_t i = 0; i < len; i++ )
  828. {
  829. state = state * 1664525u + 1013904223u;
  830. out[i] = (unsigned char) state;
  831. }
  832. return( 0 );
  833. }
  834. /* Load my private keys and generate the corresponding public keys */
  835. static int ecjpake_test_load( mbedtls_ecjpake_context *ctx,
  836. const unsigned char *xm1, size_t len1,
  837. const unsigned char *xm2, size_t len2 )
  838. {
  839. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  840. MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &ctx->xm1, xm1, len1 ) );
  841. MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &ctx->xm2, xm2, len2 ) );
  842. MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &ctx->grp, &ctx->Xm1, &ctx->xm1,
  843. &ctx->grp.G, self_test_rng, NULL ) );
  844. MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &ctx->grp, &ctx->Xm2, &ctx->xm2,
  845. &ctx->grp.G, self_test_rng, NULL ) );
  846. cleanup:
  847. return( ret );
  848. }
  849. #endif /* ! MBEDTLS_ECJPAKE_ALT */
  850. /* For tests we don't need a secure RNG;
  851. * use the LGC from Numerical Recipes for simplicity */
  852. static int ecjpake_lgc( void *p, unsigned char *out, size_t len )
  853. {
  854. static uint32_t x = 42;
  855. (void) p;
  856. while( len > 0 )
  857. {
  858. size_t use_len = len > 4 ? 4 : len;
  859. x = 1664525 * x + 1013904223;
  860. memcpy( out, &x, use_len );
  861. out += use_len;
  862. len -= use_len;
  863. }
  864. return( 0 );
  865. }
  866. #define TEST_ASSERT( x ) \
  867. do { \
  868. if( x ) \
  869. ret = 0; \
  870. else \
  871. { \
  872. ret = 1; \
  873. goto cleanup; \
  874. } \
  875. } while( 0 )
  876. /*
  877. * Checkup routine
  878. */
  879. int mbedtls_ecjpake_self_test( int verbose )
  880. {
  881. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  882. mbedtls_ecjpake_context cli;
  883. mbedtls_ecjpake_context srv;
  884. unsigned char buf[512], pms[32];
  885. size_t len, pmslen;
  886. mbedtls_ecjpake_init( &cli );
  887. mbedtls_ecjpake_init( &srv );
  888. if( verbose != 0 )
  889. mbedtls_printf( " ECJPAKE test #0 (setup): " );
  890. TEST_ASSERT( mbedtls_ecjpake_setup( &cli, MBEDTLS_ECJPAKE_CLIENT,
  891. MBEDTLS_MD_SHA256, MBEDTLS_ECP_DP_SECP256R1,
  892. ecjpake_test_password,
  893. sizeof( ecjpake_test_password ) ) == 0 );
  894. TEST_ASSERT( mbedtls_ecjpake_setup( &srv, MBEDTLS_ECJPAKE_SERVER,
  895. MBEDTLS_MD_SHA256, MBEDTLS_ECP_DP_SECP256R1,
  896. ecjpake_test_password,
  897. sizeof( ecjpake_test_password ) ) == 0 );
  898. if( verbose != 0 )
  899. mbedtls_printf( "passed\n" );
  900. if( verbose != 0 )
  901. mbedtls_printf( " ECJPAKE test #1 (random handshake): " );
  902. TEST_ASSERT( mbedtls_ecjpake_write_round_one( &cli,
  903. buf, sizeof( buf ), &len, ecjpake_lgc, NULL ) == 0 );
  904. TEST_ASSERT( mbedtls_ecjpake_read_round_one( &srv, buf, len ) == 0 );
  905. TEST_ASSERT( mbedtls_ecjpake_write_round_one( &srv,
  906. buf, sizeof( buf ), &len, ecjpake_lgc, NULL ) == 0 );
  907. TEST_ASSERT( mbedtls_ecjpake_read_round_one( &cli, buf, len ) == 0 );
  908. TEST_ASSERT( mbedtls_ecjpake_write_round_two( &srv,
  909. buf, sizeof( buf ), &len, ecjpake_lgc, NULL ) == 0 );
  910. TEST_ASSERT( mbedtls_ecjpake_read_round_two( &cli, buf, len ) == 0 );
  911. TEST_ASSERT( mbedtls_ecjpake_derive_secret( &cli,
  912. pms, sizeof( pms ), &pmslen, ecjpake_lgc, NULL ) == 0 );
  913. TEST_ASSERT( mbedtls_ecjpake_write_round_two( &cli,
  914. buf, sizeof( buf ), &len, ecjpake_lgc, NULL ) == 0 );
  915. TEST_ASSERT( mbedtls_ecjpake_read_round_two( &srv, buf, len ) == 0 );
  916. TEST_ASSERT( mbedtls_ecjpake_derive_secret( &srv,
  917. buf, sizeof( buf ), &len, ecjpake_lgc, NULL ) == 0 );
  918. TEST_ASSERT( len == pmslen );
  919. TEST_ASSERT( memcmp( buf, pms, len ) == 0 );
  920. if( verbose != 0 )
  921. mbedtls_printf( "passed\n" );
  922. #if !defined(MBEDTLS_ECJPAKE_ALT)
  923. /* 'reference handshake' tests can only be run against implementations
  924. * for which we have 100% control over how the random ephemeral keys
  925. * are generated. This is only the case for the internal mbed TLS
  926. * implementation, so these tests are skipped in case the internal
  927. * implementation is swapped out for an alternative one. */
  928. if( verbose != 0 )
  929. mbedtls_printf( " ECJPAKE test #2 (reference handshake): " );
  930. /* Simulate generation of round one */
  931. MBEDTLS_MPI_CHK( ecjpake_test_load( &cli,
  932. ecjpake_test_x1, sizeof( ecjpake_test_x1 ),
  933. ecjpake_test_x2, sizeof( ecjpake_test_x2 ) ) );
  934. MBEDTLS_MPI_CHK( ecjpake_test_load( &srv,
  935. ecjpake_test_x3, sizeof( ecjpake_test_x3 ),
  936. ecjpake_test_x4, sizeof( ecjpake_test_x4 ) ) );
  937. /* Read round one */
  938. TEST_ASSERT( mbedtls_ecjpake_read_round_one( &srv,
  939. ecjpake_test_cli_one,
  940. sizeof( ecjpake_test_cli_one ) ) == 0 );
  941. TEST_ASSERT( mbedtls_ecjpake_read_round_one( &cli,
  942. ecjpake_test_srv_one,
  943. sizeof( ecjpake_test_srv_one ) ) == 0 );
  944. /* Skip generation of round two, read round two */
  945. TEST_ASSERT( mbedtls_ecjpake_read_round_two( &cli,
  946. ecjpake_test_srv_two,
  947. sizeof( ecjpake_test_srv_two ) ) == 0 );
  948. TEST_ASSERT( mbedtls_ecjpake_read_round_two( &srv,
  949. ecjpake_test_cli_two,
  950. sizeof( ecjpake_test_cli_two ) ) == 0 );
  951. /* Server derives PMS */
  952. TEST_ASSERT( mbedtls_ecjpake_derive_secret( &srv,
  953. buf, sizeof( buf ), &len, ecjpake_lgc, NULL ) == 0 );
  954. TEST_ASSERT( len == sizeof( ecjpake_test_pms ) );
  955. TEST_ASSERT( memcmp( buf, ecjpake_test_pms, len ) == 0 );
  956. memset( buf, 0, len ); /* Avoid interferences with next step */
  957. /* Client derives PMS */
  958. TEST_ASSERT( mbedtls_ecjpake_derive_secret( &cli,
  959. buf, sizeof( buf ), &len, ecjpake_lgc, NULL ) == 0 );
  960. TEST_ASSERT( len == sizeof( ecjpake_test_pms ) );
  961. TEST_ASSERT( memcmp( buf, ecjpake_test_pms, len ) == 0 );
  962. if( verbose != 0 )
  963. mbedtls_printf( "passed\n" );
  964. #endif /* ! MBEDTLS_ECJPAKE_ALT */
  965. cleanup:
  966. mbedtls_ecjpake_free( &cli );
  967. mbedtls_ecjpake_free( &srv );
  968. if( ret != 0 )
  969. {
  970. if( verbose != 0 )
  971. mbedtls_printf( "failed\n" );
  972. ret = 1;
  973. }
  974. if( verbose != 0 )
  975. mbedtls_printf( "\n" );
  976. return( ret );
  977. }
  978. #undef TEST_ASSERT
  979. #endif /* MBEDTLS_ECP_DP_SECP256R1_ENABLED && MBEDTLS_SHA256_C */
  980. #endif /* MBEDTLS_SELF_TEST */
  981. #endif /* MBEDTLS_ECJPAKE_C */