Coverage Report

Created: 2025-06-13 06:57

/src/openssl/crypto/ec/ecp_mont.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2001-2021 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
const EC_METHOD *EC_GFp_mont_method(void)
22
1.04k
{
23
1.04k
    static const EC_METHOD ret = {
24
1.04k
        EC_FLAGS_DEFAULT_OCT,
25
1.04k
        NID_X9_62_prime_field,
26
1.04k
        ossl_ec_GFp_mont_group_init,
27
1.04k
        ossl_ec_GFp_mont_group_finish,
28
1.04k
        ossl_ec_GFp_mont_group_clear_finish,
29
1.04k
        ossl_ec_GFp_mont_group_copy,
30
1.04k
        ossl_ec_GFp_mont_group_set_curve,
31
1.04k
        ossl_ec_GFp_simple_group_get_curve,
32
1.04k
        ossl_ec_GFp_simple_group_get_degree,
33
1.04k
        ossl_ec_group_simple_order_bits,
34
1.04k
        ossl_ec_GFp_simple_group_check_discriminant,
35
1.04k
        ossl_ec_GFp_simple_point_init,
36
1.04k
        ossl_ec_GFp_simple_point_finish,
37
1.04k
        ossl_ec_GFp_simple_point_clear_finish,
38
1.04k
        ossl_ec_GFp_simple_point_copy,
39
1.04k
        ossl_ec_GFp_simple_point_set_to_infinity,
40
1.04k
        ossl_ec_GFp_simple_point_set_affine_coordinates,
41
1.04k
        ossl_ec_GFp_simple_point_get_affine_coordinates,
42
1.04k
        0, 0, 0,
43
1.04k
        ossl_ec_GFp_simple_add,
44
1.04k
        ossl_ec_GFp_simple_dbl,
45
1.04k
        ossl_ec_GFp_simple_invert,
46
1.04k
        ossl_ec_GFp_simple_is_at_infinity,
47
1.04k
        ossl_ec_GFp_simple_is_on_curve,
48
1.04k
        ossl_ec_GFp_simple_cmp,
49
1.04k
        ossl_ec_GFp_simple_make_affine,
50
1.04k
        ossl_ec_GFp_simple_points_make_affine,
51
1.04k
        0 /* mul */ ,
52
1.04k
        0 /* precompute_mult */ ,
53
1.04k
        0 /* have_precompute_mult */ ,
54
1.04k
        ossl_ec_GFp_mont_field_mul,
55
1.04k
        ossl_ec_GFp_mont_field_sqr,
56
1.04k
        0 /* field_div */ ,
57
1.04k
        ossl_ec_GFp_mont_field_inv,
58
1.04k
        ossl_ec_GFp_mont_field_encode,
59
1.04k
        ossl_ec_GFp_mont_field_decode,
60
1.04k
        ossl_ec_GFp_mont_field_set_to_one,
61
1.04k
        ossl_ec_key_simple_priv2oct,
62
1.04k
        ossl_ec_key_simple_oct2priv,
63
1.04k
        0, /* set private */
64
1.04k
        ossl_ec_key_simple_generate_key,
65
1.04k
        ossl_ec_key_simple_check_key,
66
1.04k
        ossl_ec_key_simple_generate_public_key,
67
1.04k
        0, /* keycopy */
68
1.04k
        0, /* keyfinish */
69
1.04k
        ossl_ecdh_simple_compute_key,
70
1.04k
        ossl_ecdsa_simple_sign_setup,
71
1.04k
        ossl_ecdsa_simple_sign_sig,
72
1.04k
        ossl_ecdsa_simple_verify_sig,
73
1.04k
        0, /* field_inverse_mod_ord */
74
1.04k
        ossl_ec_GFp_simple_blind_coordinates,
75
1.04k
        ossl_ec_GFp_simple_ladder_pre,
76
1.04k
        ossl_ec_GFp_simple_ladder_step,
77
1.04k
        ossl_ec_GFp_simple_ladder_post
78
1.04k
    };
79
80
1.04k
    return &ret;
81
1.04k
}
82
83
int ossl_ec_GFp_mont_group_init(EC_GROUP *group)
84
1.81k
{
85
1.81k
    int ok;
86
87
1.81k
    ok = ossl_ec_GFp_simple_group_init(group);
88
1.81k
    group->field_data1 = NULL;
89
1.81k
    group->field_data2 = NULL;
90
1.81k
    return ok;
91
1.81k
}
92
93
void ossl_ec_GFp_mont_group_finish(EC_GROUP *group)
94
1.81k
{
95
1.81k
    BN_MONT_CTX_free(group->field_data1);
96
1.81k
    group->field_data1 = NULL;
97
1.81k
    BN_free(group->field_data2);
98
1.81k
    group->field_data2 = NULL;
99
1.81k
    ossl_ec_GFp_simple_group_finish(group);
100
1.81k
}
101
102
void ossl_ec_GFp_mont_group_clear_finish(EC_GROUP *group)
103
0
{
104
0
    BN_MONT_CTX_free(group->field_data1);
105
0
    group->field_data1 = NULL;
106
0
    BN_clear_free(group->field_data2);
107
0
    group->field_data2 = NULL;
108
0
    ossl_ec_GFp_simple_group_clear_finish(group);
109
0
}
110
111
int ossl_ec_GFp_mont_group_copy(EC_GROUP *dest, const EC_GROUP *src)
112
738
{
113
738
    BN_MONT_CTX_free(dest->field_data1);
114
738
    dest->field_data1 = NULL;
115
738
    BN_clear_free(dest->field_data2);
116
738
    dest->field_data2 = NULL;
117
118
738
    if (!ossl_ec_GFp_simple_group_copy(dest, src))
119
0
        return 0;
120
121
738
    if (src->field_data1 != NULL) {
122
738
        dest->field_data1 = BN_MONT_CTX_new();
123
738
        if (dest->field_data1 == NULL)
124
0
            return 0;
125
738
        if (!BN_MONT_CTX_copy(dest->field_data1, src->field_data1))
126
0
            goto err;
127
738
    }
128
738
    if (src->field_data2 != NULL) {
129
738
        dest->field_data2 = BN_dup(src->field_data2);
130
738
        if (dest->field_data2 == NULL)
131
0
            goto err;
132
738
    }
133
134
738
    return 1;
135
136
0
 err:
137
0
    BN_MONT_CTX_free(dest->field_data1);
138
0
    dest->field_data1 = NULL;
139
0
    return 0;
140
738
}
141
142
int ossl_ec_GFp_mont_group_set_curve(EC_GROUP *group, const BIGNUM *p,
143
                                     const BIGNUM *a, const BIGNUM *b,
144
                                     BN_CTX *ctx)
145
1.04k
{
146
1.04k
    BN_CTX *new_ctx = NULL;
147
1.04k
    BN_MONT_CTX *mont = NULL;
148
1.04k
    BIGNUM *one = NULL;
149
1.04k
    int ret = 0;
150
151
1.04k
    BN_MONT_CTX_free(group->field_data1);
152
1.04k
    group->field_data1 = NULL;
153
1.04k
    BN_free(group->field_data2);
154
1.04k
    group->field_data2 = NULL;
155
156
1.04k
    if (ctx == NULL) {
157
622
        ctx = new_ctx = BN_CTX_new_ex(group->libctx);
158
622
        if (ctx == NULL)
159
0
            return 0;
160
622
    }
161
162
1.04k
    mont = BN_MONT_CTX_new();
163
1.04k
    if (mont == NULL)
164
0
        goto err;
165
1.04k
    if (!BN_MONT_CTX_set(mont, p, ctx)) {
166
68
        ERR_raise(ERR_LIB_EC, ERR_R_BN_LIB);
167
68
        goto err;
168
68
    }
169
978
    one = BN_new();
170
978
    if (one == NULL)
171
0
        goto err;
172
978
    if (!BN_to_montgomery(one, BN_value_one(), mont, ctx))
173
0
        goto err;
174
175
978
    group->field_data1 = mont;
176
978
    mont = NULL;
177
978
    group->field_data2 = one;
178
978
    one = NULL;
179
180
978
    ret = ossl_ec_GFp_simple_group_set_curve(group, p, a, b, ctx);
181
182
978
    if (!ret) {
183
6
        BN_MONT_CTX_free(group->field_data1);
184
6
        group->field_data1 = NULL;
185
6
        BN_free(group->field_data2);
186
6
        group->field_data2 = NULL;
187
6
    }
188
189
1.04k
 err:
190
1.04k
    BN_free(one);
191
1.04k
    BN_CTX_free(new_ctx);
192
1.04k
    BN_MONT_CTX_free(mont);
193
1.04k
    return ret;
194
978
}
195
196
int ossl_ec_GFp_mont_field_mul(const EC_GROUP *group, BIGNUM *r, const BIGNUM *a,
197
                               const BIGNUM *b, BN_CTX *ctx)
198
1.25M
{
199
1.25M
    if (group->field_data1 == NULL) {
200
0
        ERR_raise(ERR_LIB_EC, EC_R_NOT_INITIALIZED);
201
0
        return 0;
202
0
    }
203
204
1.25M
    return BN_mod_mul_montgomery(r, a, b, group->field_data1, ctx);
205
1.25M
}
206
207
int ossl_ec_GFp_mont_field_sqr(const EC_GROUP *group, BIGNUM *r, const BIGNUM *a,
208
                               BN_CTX *ctx)
209
938k
{
210
938k
    if (group->field_data1 == NULL) {
211
0
        ERR_raise(ERR_LIB_EC, EC_R_NOT_INITIALIZED);
212
0
        return 0;
213
0
    }
214
215
938k
    return BN_mod_mul_montgomery(r, a, a, group->field_data1, ctx);
216
938k
}
217
218
/*-
219
 * Computes the multiplicative inverse of a in GF(p), storing the result in r.
220
 * If a is zero (or equivalent), you'll get an EC_R_CANNOT_INVERT error.
221
 * We have a Mont structure, so SCA hardening is FLT inversion.
222
 */
223
int ossl_ec_GFp_mont_field_inv(const EC_GROUP *group, BIGNUM *r, const BIGNUM *a,
224
                               BN_CTX *ctx)
225
1.07k
{
226
1.07k
    BIGNUM *e = NULL;
227
1.07k
    BN_CTX *new_ctx = NULL;
228
1.07k
    int ret = 0;
229
230
1.07k
    if (group->field_data1 == NULL)
231
0
        return 0;
232
233
1.07k
    if (ctx == NULL
234
1.07k
            && (ctx = new_ctx = BN_CTX_secure_new_ex(group->libctx)) == NULL)
235
0
        return 0;
236
237
1.07k
    BN_CTX_start(ctx);
238
1.07k
    if ((e = BN_CTX_get(ctx)) == NULL)
239
0
        goto err;
240
241
    /* Inverse in constant time with Fermats Little Theorem */
242
1.07k
    if (!BN_set_word(e, 2))
243
0
        goto err;
244
1.07k
    if (!BN_sub(e, group->field, e))
245
0
        goto err;
246
    /*-
247
     * Exponent e is public.
248
     * No need for scatter-gather or BN_FLG_CONSTTIME.
249
     */
250
1.07k
    if (!BN_mod_exp_mont(r, a, e, group->field, ctx, group->field_data1))
251
0
        goto err;
252
253
    /* throw an error on zero */
254
1.07k
    if (BN_is_zero(r)) {
255
0
        ERR_raise(ERR_LIB_EC, EC_R_CANNOT_INVERT);
256
0
        goto err;
257
0
    }
258
259
1.07k
    ret = 1;
260
261
1.07k
 err:
262
1.07k
    BN_CTX_end(ctx);
263
1.07k
    BN_CTX_free(new_ctx);
264
1.07k
    return ret;
265
1.07k
}
266
267
int ossl_ec_GFp_mont_field_encode(const EC_GROUP *group, BIGNUM *r,
268
                                  const BIGNUM *a, BN_CTX *ctx)
269
6.89k
{
270
6.89k
    if (group->field_data1 == NULL) {
271
0
        ERR_raise(ERR_LIB_EC, EC_R_NOT_INITIALIZED);
272
0
        return 0;
273
0
    }
274
275
6.89k
    return BN_to_montgomery(r, a, (BN_MONT_CTX *)group->field_data1, ctx);
276
6.89k
}
277
278
int ossl_ec_GFp_mont_field_decode(const EC_GROUP *group, BIGNUM *r,
279
                                  const BIGNUM *a, BN_CTX *ctx)
280
8.24k
{
281
8.24k
    if (group->field_data1 == NULL) {
282
0
        ERR_raise(ERR_LIB_EC, EC_R_NOT_INITIALIZED);
283
0
        return 0;
284
0
    }
285
286
8.24k
    return BN_from_montgomery(r, a, group->field_data1, ctx);
287
8.24k
}
288
289
int ossl_ec_GFp_mont_field_set_to_one(const EC_GROUP *group, BIGNUM *r,
290
                                      BN_CTX *ctx)
291
3.63k
{
292
3.63k
    if (group->field_data2 == NULL) {
293
0
        ERR_raise(ERR_LIB_EC, EC_R_NOT_INITIALIZED);
294
0
        return 0;
295
0
    }
296
297
3.63k
    if (!BN_copy(r, group->field_data2))
298
0
        return 0;
299
3.63k
    return 1;
300
3.63k
}