/src/openssl/crypto/ec/ec2_oct.c
Line | Count | Source |
1 | | /* |
2 | | * Copyright 2011-2025 The OpenSSL Project Authors. All Rights Reserved. |
3 | | * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved |
4 | | * |
5 | | * Licensed under the Apache License 2.0 (the "License"). You may not use |
6 | | * this file except in compliance with the License. You can obtain a copy |
7 | | * in the file LICENSE in the source distribution or at |
8 | | * https://www.openssl.org/source/license.html |
9 | | */ |
10 | | |
11 | | /* |
12 | | * ECDSA low level APIs are deprecated for public use, but still ok for |
13 | | * internal use. |
14 | | */ |
15 | | #include "internal/deprecated.h" |
16 | | |
17 | | #include <openssl/err.h> |
18 | | |
19 | | #include "ec_local.h" |
20 | | |
21 | | #ifndef OPENSSL_NO_EC2M |
22 | | |
23 | | /*- |
24 | | * Calculates and sets the affine coordinates of an EC_POINT from the given |
25 | | * compressed coordinates. Uses algorithm 2.3.4 of SEC 1. |
26 | | * Note that the simple implementation only uses affine coordinates. |
27 | | * |
28 | | * The method is from the following publication: |
29 | | * |
30 | | * Harper, Menezes, Vanstone: |
31 | | * "Public-Key Cryptosystems with Very Small Key Lengths", |
32 | | * EUROCRYPT '92, Springer-Verlag LNCS 658, |
33 | | * published February 1993 |
34 | | * |
35 | | * US Patents 6,141,420 and 6,618,483 (Vanstone, Mullin, Agnew) describe |
36 | | * the same method, but claim no priority date earlier than July 29, 1994 |
37 | | * (and additionally fail to cite the EUROCRYPT '92 publication as prior art). |
38 | | */ |
39 | | int ossl_ec_GF2m_simple_set_compressed_coordinates(const EC_GROUP *group, |
40 | | EC_POINT *point, |
41 | | const BIGNUM *x_, int y_bit, |
42 | | BN_CTX *ctx) |
43 | 0 | { |
44 | 0 | BIGNUM *tmp, *x, *y, *z; |
45 | 0 | int ret = 0, z0; |
46 | 0 | #ifndef FIPS_MODULE |
47 | 0 | BN_CTX *new_ctx = NULL; |
48 | |
|
49 | 0 | if (ctx == NULL) { |
50 | 0 | ctx = new_ctx = BN_CTX_new(); |
51 | 0 | if (ctx == NULL) |
52 | 0 | return 0; |
53 | 0 | } |
54 | 0 | #endif |
55 | | |
56 | 0 | y_bit = (y_bit != 0) ? 1 : 0; |
57 | |
|
58 | 0 | BN_CTX_start(ctx); |
59 | 0 | tmp = BN_CTX_get(ctx); |
60 | 0 | x = BN_CTX_get(ctx); |
61 | 0 | y = BN_CTX_get(ctx); |
62 | 0 | z = BN_CTX_get(ctx); |
63 | 0 | if (z == NULL) |
64 | 0 | goto err; |
65 | | |
66 | 0 | if (!BN_GF2m_mod_arr(x, x_, group->poly)) |
67 | 0 | goto err; |
68 | 0 | if (BN_is_zero(x)) { |
69 | 0 | if (!BN_GF2m_mod_sqrt_arr(y, group->b, group->poly, ctx)) |
70 | 0 | goto err; |
71 | 0 | } else { |
72 | 0 | if (!group->meth->field_sqr(group, tmp, x, ctx)) |
73 | 0 | goto err; |
74 | 0 | if (!group->meth->field_div(group, tmp, group->b, tmp, ctx)) |
75 | 0 | goto err; |
76 | 0 | if (!BN_GF2m_add(tmp, group->a, tmp)) |
77 | 0 | goto err; |
78 | 0 | if (!BN_GF2m_add(tmp, x, tmp)) |
79 | 0 | goto err; |
80 | 0 | ERR_set_mark(); |
81 | 0 | if (!BN_GF2m_mod_solve_quad_arr(z, tmp, group->poly, ctx)) { |
82 | 0 | #ifndef FIPS_MODULE |
83 | 0 | unsigned long err = ERR_peek_last_error(); |
84 | |
|
85 | 0 | if (ERR_GET_LIB(err) == ERR_LIB_BN |
86 | 0 | && ERR_GET_REASON(err) == BN_R_NO_SOLUTION) { |
87 | 0 | ERR_pop_to_mark(); |
88 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_COMPRESSED_POINT); |
89 | 0 | } else |
90 | 0 | #endif |
91 | 0 | { |
92 | 0 | ERR_clear_last_mark(); |
93 | 0 | ERR_raise(ERR_LIB_EC, ERR_R_BN_LIB); |
94 | 0 | } |
95 | 0 | goto err; |
96 | 0 | } |
97 | 0 | ERR_clear_last_mark(); |
98 | 0 | z0 = (BN_is_odd(z)) ? 1 : 0; |
99 | 0 | if (!group->meth->field_mul(group, y, x, z, ctx)) |
100 | 0 | goto err; |
101 | 0 | if (z0 != y_bit) { |
102 | 0 | if (!BN_GF2m_add(y, y, x)) |
103 | 0 | goto err; |
104 | 0 | } |
105 | 0 | } |
106 | | |
107 | 0 | if (!EC_POINT_set_affine_coordinates(group, point, x, y, ctx)) |
108 | 0 | goto err; |
109 | | |
110 | 0 | ret = 1; |
111 | |
|
112 | 0 | err: |
113 | 0 | BN_CTX_end(ctx); |
114 | 0 | #ifndef FIPS_MODULE |
115 | 0 | BN_CTX_free(new_ctx); |
116 | 0 | #endif |
117 | 0 | return ret; |
118 | 0 | } |
119 | | |
120 | | /* |
121 | | * Converts an EC_POINT to an octet string. If buf is NULL, the encoded |
122 | | * length will be returned. If the length len of buf is smaller than required |
123 | | * an error will be returned. |
124 | | */ |
125 | | size_t ossl_ec_GF2m_simple_point2oct(const EC_GROUP *group, |
126 | | const EC_POINT *point, |
127 | | point_conversion_form_t form, |
128 | | unsigned char *buf, size_t len, BN_CTX *ctx) |
129 | 0 | { |
130 | 0 | size_t ret; |
131 | 0 | int used_ctx = 0; |
132 | 0 | BIGNUM *x, *y, *yxi; |
133 | 0 | size_t field_len, i, skip; |
134 | 0 | #ifndef FIPS_MODULE |
135 | 0 | BN_CTX *new_ctx = NULL; |
136 | 0 | #endif |
137 | |
|
138 | 0 | if ((form != POINT_CONVERSION_COMPRESSED) |
139 | 0 | && (form != POINT_CONVERSION_UNCOMPRESSED) |
140 | 0 | && (form != POINT_CONVERSION_HYBRID)) { |
141 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_FORM); |
142 | 0 | goto err; |
143 | 0 | } |
144 | | |
145 | 0 | if (EC_POINT_is_at_infinity(group, point)) { |
146 | | /* encodes to a single 0 octet */ |
147 | 0 | if (buf != NULL) { |
148 | 0 | if (len < 1) { |
149 | 0 | ERR_raise(ERR_LIB_EC, EC_R_BUFFER_TOO_SMALL); |
150 | 0 | return 0; |
151 | 0 | } |
152 | 0 | buf[0] = 0; |
153 | 0 | } |
154 | 0 | return 1; |
155 | 0 | } |
156 | | |
157 | | /* ret := required output buffer length */ |
158 | 0 | field_len = (EC_GROUP_get_degree(group) + 7) / 8; |
159 | 0 | ret = (form == POINT_CONVERSION_COMPRESSED) ? 1 + field_len : 1 + 2 * field_len; |
160 | | |
161 | | /* if 'buf' is NULL, just return required length */ |
162 | 0 | if (buf != NULL) { |
163 | 0 | if (len < ret) { |
164 | 0 | ERR_raise(ERR_LIB_EC, EC_R_BUFFER_TOO_SMALL); |
165 | 0 | goto err; |
166 | 0 | } |
167 | | |
168 | 0 | #ifndef FIPS_MODULE |
169 | 0 | if (ctx == NULL) { |
170 | 0 | ctx = new_ctx = BN_CTX_new(); |
171 | 0 | if (ctx == NULL) |
172 | 0 | return 0; |
173 | 0 | } |
174 | 0 | #endif |
175 | | |
176 | 0 | BN_CTX_start(ctx); |
177 | 0 | used_ctx = 1; |
178 | 0 | x = BN_CTX_get(ctx); |
179 | 0 | y = BN_CTX_get(ctx); |
180 | 0 | yxi = BN_CTX_get(ctx); |
181 | 0 | if (yxi == NULL) |
182 | 0 | goto err; |
183 | | |
184 | 0 | if (!EC_POINT_get_affine_coordinates(group, point, x, y, ctx)) |
185 | 0 | goto err; |
186 | | |
187 | 0 | buf[0] = form; |
188 | 0 | if ((form != POINT_CONVERSION_UNCOMPRESSED) && !BN_is_zero(x)) { |
189 | 0 | if (!group->meth->field_div(group, yxi, y, x, ctx)) |
190 | 0 | goto err; |
191 | 0 | if (BN_is_odd(yxi)) |
192 | 0 | buf[0]++; |
193 | 0 | } |
194 | | |
195 | 0 | i = 1; |
196 | |
|
197 | 0 | skip = field_len - BN_num_bytes(x); |
198 | 0 | if (skip > field_len) { |
199 | 0 | ERR_raise(ERR_LIB_EC, ERR_R_INTERNAL_ERROR); |
200 | 0 | goto err; |
201 | 0 | } |
202 | 0 | while (skip > 0) { |
203 | 0 | buf[i++] = 0; |
204 | 0 | skip--; |
205 | 0 | } |
206 | 0 | skip = BN_bn2bin(x, buf + i); |
207 | 0 | i += skip; |
208 | 0 | if (i != 1 + field_len) { |
209 | 0 | ERR_raise(ERR_LIB_EC, ERR_R_INTERNAL_ERROR); |
210 | 0 | goto err; |
211 | 0 | } |
212 | | |
213 | 0 | if (form == POINT_CONVERSION_UNCOMPRESSED |
214 | 0 | || form == POINT_CONVERSION_HYBRID) { |
215 | 0 | skip = field_len - BN_num_bytes(y); |
216 | 0 | if (skip > field_len) { |
217 | 0 | ERR_raise(ERR_LIB_EC, ERR_R_INTERNAL_ERROR); |
218 | 0 | goto err; |
219 | 0 | } |
220 | 0 | while (skip > 0) { |
221 | 0 | buf[i++] = 0; |
222 | 0 | skip--; |
223 | 0 | } |
224 | 0 | skip = BN_bn2bin(y, buf + i); |
225 | 0 | i += skip; |
226 | 0 | } |
227 | | |
228 | 0 | if (i != ret) { |
229 | 0 | ERR_raise(ERR_LIB_EC, ERR_R_INTERNAL_ERROR); |
230 | 0 | goto err; |
231 | 0 | } |
232 | 0 | } |
233 | | |
234 | 0 | if (used_ctx) |
235 | 0 | BN_CTX_end(ctx); |
236 | 0 | #ifndef FIPS_MODULE |
237 | 0 | BN_CTX_free(new_ctx); |
238 | 0 | #endif |
239 | 0 | return ret; |
240 | | |
241 | 0 | err: |
242 | 0 | if (used_ctx) |
243 | 0 | BN_CTX_end(ctx); |
244 | 0 | #ifndef FIPS_MODULE |
245 | 0 | BN_CTX_free(new_ctx); |
246 | 0 | #endif |
247 | 0 | return 0; |
248 | 0 | } |
249 | | |
250 | | /* |
251 | | * Converts an octet string representation to an EC_POINT. Note that the |
252 | | * simple implementation only uses affine coordinates. |
253 | | */ |
254 | | int ossl_ec_GF2m_simple_oct2point(const EC_GROUP *group, EC_POINT *point, |
255 | | const unsigned char *buf, size_t len, |
256 | | BN_CTX *ctx) |
257 | 0 | { |
258 | 0 | point_conversion_form_t form; |
259 | 0 | int y_bit, m; |
260 | 0 | BIGNUM *x, *y, *yxi; |
261 | 0 | int field_len, enc_len; |
262 | 0 | int ret = 0; |
263 | 0 | #ifndef FIPS_MODULE |
264 | 0 | BN_CTX *new_ctx = NULL; |
265 | 0 | #endif |
266 | |
|
267 | 0 | if (len == 0) { |
268 | 0 | ERR_raise(ERR_LIB_EC, EC_R_BUFFER_TOO_SMALL); |
269 | 0 | return 0; |
270 | 0 | } |
271 | | |
272 | | /* |
273 | | * The first octet is the point conversion octet PC, see X9.62, page 4 |
274 | | * and section 4.4.2. It must be: |
275 | | * 0x00 for the point at infinity |
276 | | * 0x02 or 0x03 for compressed form |
277 | | * 0x04 for uncompressed form |
278 | | * 0x06 or 0x07 for hybrid form. |
279 | | * For compressed or hybrid forms, we store the last bit of buf[0] as |
280 | | * y_bit and clear it from buf[0] so as to obtain a POINT_CONVERSION_*. |
281 | | * We error if buf[0] contains any but the above values. |
282 | | */ |
283 | 0 | y_bit = buf[0] & 1; |
284 | 0 | form = buf[0] & ~1U; |
285 | |
|
286 | 0 | if ((form != 0) && (form != POINT_CONVERSION_COMPRESSED) |
287 | 0 | && (form != POINT_CONVERSION_UNCOMPRESSED) |
288 | 0 | && (form != POINT_CONVERSION_HYBRID)) { |
289 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
290 | 0 | return 0; |
291 | 0 | } |
292 | 0 | if ((form == 0 || form == POINT_CONVERSION_UNCOMPRESSED) && y_bit) { |
293 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
294 | 0 | return 0; |
295 | 0 | } |
296 | | |
297 | | /* The point at infinity is represented by a single zero octet. */ |
298 | 0 | if (form == 0) { |
299 | 0 | if (len != 1) { |
300 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
301 | 0 | return 0; |
302 | 0 | } |
303 | | |
304 | 0 | return EC_POINT_set_to_infinity(group, point); |
305 | 0 | } |
306 | | |
307 | 0 | m = EC_GROUP_get_degree(group); |
308 | 0 | field_len = (m + 7) / 8; |
309 | 0 | enc_len = (form == POINT_CONVERSION_COMPRESSED) ? 1 + field_len : 1 + 2 * field_len; |
310 | |
|
311 | 0 | if (len != (size_t)enc_len) { |
312 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
313 | 0 | return 0; |
314 | 0 | } |
315 | | |
316 | 0 | #ifndef FIPS_MODULE |
317 | 0 | if (ctx == NULL) { |
318 | 0 | ctx = new_ctx = BN_CTX_new(); |
319 | 0 | if (ctx == NULL) |
320 | 0 | return 0; |
321 | 0 | } |
322 | 0 | #endif |
323 | | |
324 | 0 | BN_CTX_start(ctx); |
325 | 0 | x = BN_CTX_get(ctx); |
326 | 0 | y = BN_CTX_get(ctx); |
327 | 0 | yxi = BN_CTX_get(ctx); |
328 | 0 | if (yxi == NULL) |
329 | 0 | goto err; |
330 | | |
331 | 0 | if (!BN_bin2bn(buf + 1, field_len, x)) |
332 | 0 | goto err; |
333 | 0 | if (BN_num_bits(x) > m) { |
334 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
335 | 0 | goto err; |
336 | 0 | } |
337 | | |
338 | 0 | if (form == POINT_CONVERSION_COMPRESSED) { |
339 | 0 | if (!EC_POINT_set_compressed_coordinates(group, point, x, y_bit, ctx)) |
340 | 0 | goto err; |
341 | 0 | } else { |
342 | 0 | if (!BN_bin2bn(buf + 1 + field_len, field_len, y)) |
343 | 0 | goto err; |
344 | 0 | if (BN_num_bits(y) > m) { |
345 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
346 | 0 | goto err; |
347 | 0 | } |
348 | 0 | if (form == POINT_CONVERSION_HYBRID) { |
349 | | /* |
350 | | * Check that the form in the encoding was set correctly |
351 | | * according to X9.62 4.4.2.a, 4(c), see also first paragraph |
352 | | * of X9.62, 4.4.1.b. |
353 | | */ |
354 | 0 | if (BN_is_zero(x)) { |
355 | 0 | if (y_bit != 0) { |
356 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
357 | 0 | goto err; |
358 | 0 | } |
359 | 0 | } else { |
360 | 0 | if (!group->meth->field_div(group, yxi, y, x, ctx)) |
361 | 0 | goto err; |
362 | 0 | if (y_bit != BN_is_odd(yxi)) { |
363 | 0 | ERR_raise(ERR_LIB_EC, EC_R_INVALID_ENCODING); |
364 | 0 | goto err; |
365 | 0 | } |
366 | 0 | } |
367 | 0 | } |
368 | | |
369 | | /* |
370 | | * EC_POINT_set_affine_coordinates is responsible for checking that |
371 | | * the point is on the curve. |
372 | | */ |
373 | 0 | if (!EC_POINT_set_affine_coordinates(group, point, x, y, ctx)) |
374 | 0 | goto err; |
375 | 0 | } |
376 | | |
377 | 0 | ret = 1; |
378 | |
|
379 | 0 | err: |
380 | 0 | BN_CTX_end(ctx); |
381 | 0 | #ifndef FIPS_MODULE |
382 | 0 | BN_CTX_free(new_ctx); |
383 | 0 | #endif |
384 | 0 | return ret; |
385 | 0 | } |
386 | | #endif |