ecjpake.c 42 KB

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