]>
Commit | Line | Data |
---|---|---|
d02b48c6 | 1 | /* crypto/rsa/rsa.h */ |
58964a49 | 2 | /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) |
d02b48c6 RE |
3 | * All rights reserved. |
4 | * | |
5 | * This package is an SSL implementation written | |
6 | * by Eric Young (eay@cryptsoft.com). | |
7 | * The implementation was written so as to conform with Netscapes SSL. | |
0f113f3e | 8 | * |
d02b48c6 RE |
9 | * This library is free for commercial and non-commercial use as long as |
10 | * the following conditions are aheared to. The following conditions | |
11 | * apply to all code found in this distribution, be it the RC4, RSA, | |
12 | * lhash, DES, etc., code; not just the SSL code. The SSL documentation | |
13 | * included with this distribution is covered by the same copyright terms | |
14 | * except that the holder is Tim Hudson (tjh@cryptsoft.com). | |
0f113f3e | 15 | * |
d02b48c6 RE |
16 | * Copyright remains Eric Young's, and as such any Copyright notices in |
17 | * the code are not to be removed. | |
18 | * If this package is used in a product, Eric Young should be given attribution | |
19 | * as the author of the parts of the library used. | |
20 | * This can be in the form of a textual message at program startup or | |
21 | * in documentation (online or textual) provided with the package. | |
0f113f3e | 22 | * |
d02b48c6 RE |
23 | * Redistribution and use in source and binary forms, with or without |
24 | * modification, are permitted provided that the following conditions | |
25 | * are met: | |
26 | * 1. Redistributions of source code must retain the copyright | |
27 | * notice, this list of conditions and the following disclaimer. | |
28 | * 2. Redistributions in binary form must reproduce the above copyright | |
29 | * notice, this list of conditions and the following disclaimer in the | |
30 | * documentation and/or other materials provided with the distribution. | |
31 | * 3. All advertising materials mentioning features or use of this software | |
32 | * must display the following acknowledgement: | |
33 | * "This product includes cryptographic software written by | |
34 | * Eric Young (eay@cryptsoft.com)" | |
35 | * The word 'cryptographic' can be left out if the rouines from the library | |
36 | * being used are not cryptographic related :-). | |
0f113f3e | 37 | * 4. If you include any Windows specific code (or a derivative thereof) from |
d02b48c6 RE |
38 | * the apps directory (application code) you must include an acknowledgement: |
39 | * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" | |
0f113f3e | 40 | * |
d02b48c6 RE |
41 | * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND |
42 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
43 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
44 | * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE | |
45 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
46 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
47 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
48 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
49 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
50 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
51 | * SUCH DAMAGE. | |
0f113f3e | 52 | * |
d02b48c6 RE |
53 | * The licence and distribution terms for any publically available version or |
54 | * derivative of this code cannot be changed. i.e. this code cannot simply be | |
55 | * copied and put under another distribution licence | |
56 | * [including the GNU Public Licence.] | |
57 | */ | |
58 | ||
59 | #ifndef HEADER_RSA_H | |
0f113f3e | 60 | # define HEADER_RSA_H |
d02b48c6 | 61 | |
0f113f3e | 62 | # include <openssl/asn1.h> |
78d3b819 | 63 | |
a00ae6c4 | 64 | # include <openssl/bio.h> |
0f113f3e MC |
65 | # include <openssl/crypto.h> |
66 | # include <openssl/ossl_typ.h> | |
67 | # ifdef OPENSSL_USE_DEPRECATED | |
68 | # include <openssl/bn.h> | |
69 | # endif | |
d02b48c6 | 70 | |
0f113f3e MC |
71 | # ifdef OPENSSL_NO_RSA |
72 | # error RSA is disabled. | |
73 | # endif | |
f5d7a031 | 74 | |
82271cee RL |
75 | #ifdef __cplusplus |
76 | extern "C" { | |
77 | #endif | |
78 | ||
3a87a9b9 GT |
79 | /* Declared already in ossl_typ.h */ |
80 | /* typedef struct rsa_st RSA; */ | |
81 | /* typedef struct rsa_meth_st RSA_METHOD; */ | |
03f8b042 | 82 | |
0f113f3e MC |
83 | struct rsa_meth_st { |
84 | const char *name; | |
85 | int (*rsa_pub_enc) (int flen, const unsigned char *from, | |
86 | unsigned char *to, RSA *rsa, int padding); | |
87 | int (*rsa_pub_dec) (int flen, const unsigned char *from, | |
88 | unsigned char *to, RSA *rsa, int padding); | |
89 | int (*rsa_priv_enc) (int flen, const unsigned char *from, | |
90 | unsigned char *to, RSA *rsa, int padding); | |
91 | int (*rsa_priv_dec) (int flen, const unsigned char *from, | |
92 | unsigned char *to, RSA *rsa, int padding); | |
93 | /* Can be null */ | |
94 | int (*rsa_mod_exp) (BIGNUM *r0, const BIGNUM *I, RSA *rsa, BN_CTX *ctx); | |
95 | /* Can be null */ | |
96 | int (*bn_mod_exp) (BIGNUM *r, const BIGNUM *a, const BIGNUM *p, | |
97 | const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx); | |
98 | /* called at new */ | |
99 | int (*init) (RSA *rsa); | |
100 | /* called at free */ | |
101 | int (*finish) (RSA *rsa); | |
102 | /* RSA_METHOD_FLAG_* things */ | |
103 | int flags; | |
104 | /* may be needed! */ | |
105 | char *app_data; | |
106 | /* | |
107 | * New sign and verify functions: some libraries don't allow arbitrary | |
108 | * data to be signed/verified: this allows them to be used. Note: for | |
109 | * this to work the RSA_public_decrypt() and RSA_private_encrypt() should | |
110 | * *NOT* be used RSA_sign(), RSA_verify() should be used instead. Note: | |
111 | * for backwards compatibility this functionality is only enabled if the | |
112 | * RSA_FLAG_SIGN_VER option is set in 'flags'. | |
113 | */ | |
114 | int (*rsa_sign) (int type, | |
115 | const unsigned char *m, unsigned int m_length, | |
116 | unsigned char *sigret, unsigned int *siglen, | |
117 | const RSA *rsa); | |
118 | int (*rsa_verify) (int dtype, const unsigned char *m, | |
119 | unsigned int m_length, const unsigned char *sigbuf, | |
120 | unsigned int siglen, const RSA *rsa); | |
121 | /* | |
122 | * If this callback is NULL, the builtin software RSA key-gen will be | |
123 | * used. This is for behavioural compatibility whilst the code gets | |
124 | * rewired, but one day it would be nice to assume there are no such | |
125 | * things as "builtin software" implementations. | |
126 | */ | |
127 | int (*rsa_keygen) (RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb); | |
128 | }; | |
129 | ||
130 | struct rsa_st { | |
131 | /* | |
132 | * The first parameter is used to pickup errors where this is passed | |
133 | * instead of aEVP_PKEY, it is set to 0 | |
134 | */ | |
135 | int pad; | |
136 | long version; | |
137 | const RSA_METHOD *meth; | |
138 | /* functional reference if 'meth' is ENGINE-provided */ | |
139 | ENGINE *engine; | |
140 | BIGNUM *n; | |
141 | BIGNUM *e; | |
142 | BIGNUM *d; | |
143 | BIGNUM *p; | |
144 | BIGNUM *q; | |
145 | BIGNUM *dmp1; | |
146 | BIGNUM *dmq1; | |
147 | BIGNUM *iqmp; | |
148 | /* be careful using this if the RSA structure is shared */ | |
149 | CRYPTO_EX_DATA ex_data; | |
150 | int references; | |
151 | int flags; | |
152 | /* Used to cache montgomery values */ | |
153 | BN_MONT_CTX *_method_mod_n; | |
154 | BN_MONT_CTX *_method_mod_p; | |
155 | BN_MONT_CTX *_method_mod_q; | |
156 | /* | |
157 | * all BIGNUM values are actually in the following data, if it is not | |
158 | * NULL | |
159 | */ | |
160 | char *bignum_data; | |
161 | BN_BLINDING *blinding; | |
162 | BN_BLINDING *mt_blinding; | |
163 | }; | |
164 | ||
165 | # ifndef OPENSSL_RSA_MAX_MODULUS_BITS | |
166 | # define OPENSSL_RSA_MAX_MODULUS_BITS 16384 | |
167 | # endif | |
168 | ||
169 | # define OPENSSL_RSA_FIPS_MIN_MODULUS_BITS 1024 | |
170 | ||
171 | # ifndef OPENSSL_RSA_SMALL_MODULUS_BITS | |
172 | # define OPENSSL_RSA_SMALL_MODULUS_BITS 3072 | |
173 | # endif | |
174 | # ifndef OPENSSL_RSA_MAX_PUBEXP_BITS | |
dbd87ffc MC |
175 | |
176 | /* exponent limit enforced for "large" modulus only */ | |
0f113f3e MC |
177 | # define OPENSSL_RSA_MAX_PUBEXP_BITS 64 |
178 | # endif | |
5e3225cc | 179 | |
0f113f3e MC |
180 | # define RSA_3 0x3L |
181 | # define RSA_F4 0x10001L | |
d02b48c6 | 182 | |
0f113f3e MC |
183 | # define RSA_METHOD_FLAG_NO_CHECK 0x0001/* don't check pub/private |
184 | * match */ | |
dfeab068 | 185 | |
0f113f3e MC |
186 | # define RSA_FLAG_CACHE_PUBLIC 0x0002 |
187 | # define RSA_FLAG_CACHE_PRIVATE 0x0004 | |
188 | # define RSA_FLAG_BLINDING 0x0008 | |
189 | # define RSA_FLAG_THREAD_SAFE 0x0010 | |
190 | /* | |
191 | * This flag means the private key operations will be handled by rsa_mod_exp | |
770d19b8 | 192 | * and that they do not depend on the private key components being present: |
0f113f3e MC |
193 | * for example a key stored in external hardware. Without this flag |
194 | * bn_mod_exp gets called when private key components are absent. | |
770d19b8 | 195 | */ |
0f113f3e | 196 | # define RSA_FLAG_EXT_PKEY 0x0020 |
58964a49 | 197 | |
0f113f3e MC |
198 | /* |
199 | * This flag in the RSA_METHOD enables the new rsa_sign, rsa_verify | |
200 | * functions. | |
1c80019a | 201 | */ |
0f113f3e | 202 | # define RSA_FLAG_SIGN_VER 0x0040 |
46a64376 | 203 | |
dbd87ffc MC |
204 | /* |
205 | * new with 0.9.6j and 0.9.7b; the built-in | |
206 | * RSA implementation now uses blinding by | |
207 | * default (ignoring RSA_FLAG_BLINDING), | |
208 | * but other engines might not need it | |
209 | */ | |
0f113f3e | 210 | # define RSA_FLAG_NO_BLINDING 0x0080 |
dbd87ffc MC |
211 | /* |
212 | * new with 0.9.8f; the built-in RSA | |
213 | * implementation now uses constant time | |
214 | * operations by default in private key operations, | |
0f113f3e MC |
215 | * e.g., constant time modular exponentiation, |
216 | * modular inverse without leaking branches, | |
217 | * division without leaking branches. This | |
218 | * flag disables these constant time | |
219 | * operations and results in faster RSA | |
dbd87ffc | 220 | * private key operations. |
0f113f3e MC |
221 | */ |
222 | # define RSA_FLAG_NO_CONSTTIME 0x0100 | |
223 | # ifdef OPENSSL_USE_DEPRECATED | |
dbd87ffc MC |
224 | /* deprecated name for the flag*/ |
225 | /* | |
226 | * new with 0.9.7h; the built-in RSA | |
227 | * implementation now uses constant time | |
228 | * modular exponentiation for secret exponents | |
229 | * by default. This flag causes the | |
230 | * faster variable sliding window method to | |
231 | * be used for all exponents. | |
232 | */ | |
0f113f3e MC |
233 | # define RSA_FLAG_NO_EXP_CONSTTIME RSA_FLAG_NO_CONSTTIME |
234 | # endif | |
235 | ||
236 | # define EVP_PKEY_CTX_set_rsa_padding(ctx, pad) \ | |
237 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, -1, EVP_PKEY_CTRL_RSA_PADDING, \ | |
238 | pad, NULL) | |
239 | ||
240 | # define EVP_PKEY_CTX_get_rsa_padding(ctx, ppad) \ | |
241 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, -1, \ | |
242 | EVP_PKEY_CTRL_GET_RSA_PADDING, 0, ppad) | |
243 | ||
244 | # define EVP_PKEY_CTX_set_rsa_pss_saltlen(ctx, len) \ | |
245 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \ | |
246 | (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \ | |
247 | EVP_PKEY_CTRL_RSA_PSS_SALTLEN, \ | |
248 | len, NULL) | |
249 | ||
250 | # define EVP_PKEY_CTX_get_rsa_pss_saltlen(ctx, plen) \ | |
251 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \ | |
252 | (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \ | |
253 | EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN, \ | |
254 | 0, plen) | |
255 | ||
256 | # define EVP_PKEY_CTX_set_rsa_keygen_bits(ctx, bits) \ | |
257 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_KEYGEN, \ | |
258 | EVP_PKEY_CTRL_RSA_KEYGEN_BITS, bits, NULL) | |
259 | ||
260 | # define EVP_PKEY_CTX_set_rsa_keygen_pubexp(ctx, pubexp) \ | |
261 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_KEYGEN, \ | |
262 | EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP, 0, pubexp) | |
263 | ||
264 | # define EVP_PKEY_CTX_set_rsa_mgf1_md(ctx, md) \ | |
265 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \ | |
266 | EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \ | |
267 | EVP_PKEY_CTRL_RSA_MGF1_MD, 0, (void *)md) | |
268 | ||
269 | # define EVP_PKEY_CTX_set_rsa_oaep_md(ctx, md) \ | |
270 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ | |
271 | EVP_PKEY_CTRL_RSA_OAEP_MD, 0, (void *)md) | |
272 | ||
273 | # define EVP_PKEY_CTX_get_rsa_mgf1_md(ctx, pmd) \ | |
274 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, \ | |
275 | EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \ | |
276 | EVP_PKEY_CTRL_GET_RSA_MGF1_MD, 0, (void *)pmd) | |
277 | ||
278 | # define EVP_PKEY_CTX_get_rsa_oaep_md(ctx, pmd) \ | |
279 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ | |
280 | EVP_PKEY_CTRL_GET_RSA_OAEP_MD, 0, (void *)pmd) | |
281 | ||
282 | # define EVP_PKEY_CTX_set0_rsa_oaep_label(ctx, l, llen) \ | |
283 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ | |
284 | EVP_PKEY_CTRL_RSA_OAEP_LABEL, llen, (void *)l) | |
285 | ||
286 | # define EVP_PKEY_CTX_get0_rsa_oaep_label(ctx, l) \ | |
287 | EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ | |
288 | EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL, 0, (void *)l) | |
289 | ||
290 | # define EVP_PKEY_CTRL_RSA_PADDING (EVP_PKEY_ALG_CTRL + 1) | |
291 | # define EVP_PKEY_CTRL_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 2) | |
292 | ||
293 | # define EVP_PKEY_CTRL_RSA_KEYGEN_BITS (EVP_PKEY_ALG_CTRL + 3) | |
294 | # define EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP (EVP_PKEY_ALG_CTRL + 4) | |
295 | # define EVP_PKEY_CTRL_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 5) | |
296 | ||
297 | # define EVP_PKEY_CTRL_GET_RSA_PADDING (EVP_PKEY_ALG_CTRL + 6) | |
298 | # define EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 7) | |
299 | # define EVP_PKEY_CTRL_GET_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 8) | |
300 | ||
301 | # define EVP_PKEY_CTRL_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 9) | |
302 | # define EVP_PKEY_CTRL_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 10) | |
303 | ||
304 | # define EVP_PKEY_CTRL_GET_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 11) | |
305 | # define EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 12) | |
306 | ||
307 | # define RSA_PKCS1_PADDING 1 | |
308 | # define RSA_SSLV23_PADDING 2 | |
309 | # define RSA_NO_PADDING 3 | |
310 | # define RSA_PKCS1_OAEP_PADDING 4 | |
311 | # define RSA_X931_PADDING 5 | |
29db322e | 312 | /* EVP_PKEY_ only */ |
0f113f3e | 313 | # define RSA_PKCS1_PSS_PADDING 6 |
58964a49 | 314 | |
0f113f3e | 315 | # define RSA_PKCS1_PADDING_SIZE 11 |
ba8ad074 | 316 | |
0f113f3e MC |
317 | # define RSA_set_app_data(s,arg) RSA_set_ex_data(s,0,arg) |
318 | # define RSA_get_app_data(s) RSA_get_ex_data(s,0) | |
d02b48c6 | 319 | |
0f113f3e MC |
320 | RSA *RSA_new(void); |
321 | RSA *RSA_new_method(ENGINE *engine); | |
26c79d56 | 322 | int RSA_bits(const RSA *rsa); |
0f113f3e MC |
323 | int RSA_size(const RSA *rsa); |
324 | int RSA_security_bits(const RSA *rsa); | |
e9224c71 GT |
325 | |
326 | /* Deprecated version */ | |
0f113f3e MC |
327 | # ifdef OPENSSL_USE_DEPRECATED |
328 | DECLARE_DEPRECATED(RSA *RSA_generate_key(int bits, unsigned long e, void | |
329 | (*callback) (int, int, void *), | |
330 | void *cb_arg)); | |
331 | # endif /* defined(OPENSSL_USE_DEPRECATED) */ | |
e9224c71 GT |
332 | |
333 | /* New version */ | |
0f113f3e MC |
334 | int RSA_generate_key_ex(RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb); |
335 | ||
336 | int RSA_X931_derive_ex(RSA *rsa, BIGNUM *p1, BIGNUM *p2, BIGNUM *q1, | |
337 | BIGNUM *q2, const BIGNUM *Xp1, const BIGNUM *Xp2, | |
338 | const BIGNUM *Xp, const BIGNUM *Xq1, const BIGNUM *Xq2, | |
339 | const BIGNUM *Xq, const BIGNUM *e, BN_GENCB *cb); | |
340 | int RSA_X931_generate_key_ex(RSA *rsa, int bits, const BIGNUM *e, | |
341 | BN_GENCB *cb); | |
342 | ||
343 | int RSA_check_key(const RSA *); | |
344 | int RSA_check_key_ex(const RSA *, BN_GENCB *cb); | |
345 | /* next 4 return -1 on error */ | |
346 | int RSA_public_encrypt(int flen, const unsigned char *from, | |
347 | unsigned char *to, RSA *rsa, int padding); | |
348 | int RSA_private_encrypt(int flen, const unsigned char *from, | |
349 | unsigned char *to, RSA *rsa, int padding); | |
350 | int RSA_public_decrypt(int flen, const unsigned char *from, | |
351 | unsigned char *to, RSA *rsa, int padding); | |
352 | int RSA_private_decrypt(int flen, const unsigned char *from, | |
353 | unsigned char *to, RSA *rsa, int padding); | |
354 | void RSA_free(RSA *r); | |
5cbc2e8b | 355 | /* "up" the RSA object's reference count */ |
0f113f3e | 356 | int RSA_up_ref(RSA *r); |
d02b48c6 | 357 | |
0f113f3e | 358 | int RSA_flags(const RSA *r); |
58964a49 | 359 | |
cb78486d GT |
360 | void RSA_set_default_method(const RSA_METHOD *meth); |
361 | const RSA_METHOD *RSA_get_default_method(void); | |
29c1f061 | 362 | const RSA_METHOD *RSA_get_method(const RSA *rsa); |
cb78486d | 363 | int RSA_set_method(RSA *rsa, const RSA_METHOD *meth); |
d02b48c6 | 364 | |
dfeab068 RE |
365 | /* This function needs the memory locking malloc callbacks to be installed */ |
366 | int RSA_memory_lock(RSA *r); | |
367 | ||
d02b48c6 | 368 | /* these are the actual SSLeay RSA functions */ |
7be7c2ed | 369 | const RSA_METHOD *RSA_PKCS1_SSLeay(void); |
d02b48c6 | 370 | |
7be7c2ed | 371 | const RSA_METHOD *RSA_null_method(void); |
c1cd88a0 | 372 | |
78d3b819 DSH |
373 | DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPublicKey) |
374 | DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPrivateKey) | |
375 | ||
0f113f3e MC |
376 | typedef struct rsa_pss_params_st { |
377 | X509_ALGOR *hashAlgorithm; | |
378 | X509_ALGOR *maskGenAlgorithm; | |
379 | ASN1_INTEGER *saltLength; | |
380 | ASN1_INTEGER *trailerField; | |
381 | } RSA_PSS_PARAMS; | |
ff04bbe3 | 382 | |
63b825c9 | 383 | DECLARE_ASN1_FUNCTIONS(RSA_PSS_PARAMS) |
ff04bbe3 | 384 | |
0f113f3e MC |
385 | typedef struct rsa_oaep_params_st { |
386 | X509_ALGOR *hashFunc; | |
387 | X509_ALGOR *maskGenFunc; | |
388 | X509_ALGOR *pSourceFunc; | |
389 | } RSA_OAEP_PARAMS; | |
0574cadf DSH |
390 | |
391 | DECLARE_ASN1_FUNCTIONS(RSA_OAEP_PARAMS) | |
392 | ||
0f113f3e MC |
393 | # ifndef OPENSSL_NO_STDIO |
394 | int RSA_print_fp(FILE *fp, const RSA *r, int offset); | |
395 | # endif | |
d02b48c6 | 396 | |
0f113f3e | 397 | int RSA_print(BIO *bp, const RSA *r, int offset); |
d02b48c6 | 398 | |
0f113f3e MC |
399 | /* |
400 | * The following 2 functions sign and verify a X509_SIG ASN1 object inside | |
401 | * PKCS#1 padded RSA encryption | |
402 | */ | |
3e83e686 | 403 | int RSA_sign(int type, const unsigned char *m, unsigned int m_length, |
0f113f3e | 404 | unsigned char *sigret, unsigned int *siglen, RSA *rsa); |
3e83e686 | 405 | int RSA_verify(int type, const unsigned char *m, unsigned int m_length, |
0f113f3e | 406 | const unsigned char *sigbuf, unsigned int siglen, RSA *rsa); |
d02b48c6 | 407 | |
0f113f3e MC |
408 | /* |
409 | * The following 2 function sign and verify a ASN1_OCTET_STRING object inside | |
410 | * PKCS#1 padded RSA encryption | |
411 | */ | |
29c1f061 | 412 | int RSA_sign_ASN1_OCTET_STRING(int type, |
0f113f3e MC |
413 | const unsigned char *m, unsigned int m_length, |
414 | unsigned char *sigret, unsigned int *siglen, | |
415 | RSA *rsa); | |
416 | int RSA_verify_ASN1_OCTET_STRING(int type, const unsigned char *m, | |
417 | unsigned int m_length, unsigned char *sigbuf, | |
418 | unsigned int siglen, RSA *rsa); | |
d02b48c6 | 419 | |
58964a49 RE |
420 | int RSA_blinding_on(RSA *rsa, BN_CTX *ctx); |
421 | void RSA_blinding_off(RSA *rsa); | |
800e400d | 422 | BN_BLINDING *RSA_setup_blinding(RSA *rsa, BN_CTX *ctx); |
58964a49 | 423 | |
0f113f3e MC |
424 | int RSA_padding_add_PKCS1_type_1(unsigned char *to, int tlen, |
425 | const unsigned char *f, int fl); | |
426 | int RSA_padding_check_PKCS1_type_1(unsigned char *to, int tlen, | |
427 | const unsigned char *f, int fl, | |
428 | int rsa_len); | |
429 | int RSA_padding_add_PKCS1_type_2(unsigned char *to, int tlen, | |
430 | const unsigned char *f, int fl); | |
431 | int RSA_padding_check_PKCS1_type_2(unsigned char *to, int tlen, | |
432 | const unsigned char *f, int fl, | |
433 | int rsa_len); | |
434 | int PKCS1_MGF1(unsigned char *mask, long len, const unsigned char *seed, | |
435 | long seedlen, const EVP_MD *dgst); | |
436 | int RSA_padding_add_PKCS1_OAEP(unsigned char *to, int tlen, | |
437 | const unsigned char *f, int fl, | |
438 | const unsigned char *p, int pl); | |
439 | int RSA_padding_check_PKCS1_OAEP(unsigned char *to, int tlen, | |
440 | const unsigned char *f, int fl, int rsa_len, | |
441 | const unsigned char *p, int pl); | |
271fef0e | 442 | int RSA_padding_add_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, |
0f113f3e MC |
443 | const unsigned char *from, int flen, |
444 | const unsigned char *param, int plen, | |
445 | const EVP_MD *md, const EVP_MD *mgf1md); | |
271fef0e | 446 | int RSA_padding_check_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, |
0f113f3e MC |
447 | const unsigned char *from, int flen, |
448 | int num, const unsigned char *param, | |
449 | int plen, const EVP_MD *md, | |
450 | const EVP_MD *mgf1md); | |
451 | int RSA_padding_add_SSLv23(unsigned char *to, int tlen, | |
452 | const unsigned char *f, int fl); | |
453 | int RSA_padding_check_SSLv23(unsigned char *to, int tlen, | |
454 | const unsigned char *f, int fl, int rsa_len); | |
455 | int RSA_padding_add_none(unsigned char *to, int tlen, const unsigned char *f, | |
456 | int fl); | |
457 | int RSA_padding_check_none(unsigned char *to, int tlen, | |
458 | const unsigned char *f, int fl, int rsa_len); | |
459 | int RSA_padding_add_X931(unsigned char *to, int tlen, const unsigned char *f, | |
460 | int fl); | |
461 | int RSA_padding_check_X931(unsigned char *to, int tlen, | |
462 | const unsigned char *f, int fl, int rsa_len); | |
499fca2d | 463 | int RSA_X931_hash_id(int nid); |
58964a49 | 464 | |
c7aaf391 | 465 | int RSA_verify_PKCS1_PSS(RSA *rsa, const unsigned char *mHash, |
0f113f3e MC |
466 | const EVP_MD *Hash, const unsigned char *EM, |
467 | int sLen); | |
c7aaf391 | 468 | int RSA_padding_add_PKCS1_PSS(RSA *rsa, unsigned char *EM, |
0f113f3e MC |
469 | const unsigned char *mHash, const EVP_MD *Hash, |
470 | int sLen); | |
c7aaf391 | 471 | |
c553721e | 472 | int RSA_verify_PKCS1_PSS_mgf1(RSA *rsa, const unsigned char *mHash, |
0f113f3e MC |
473 | const EVP_MD *Hash, const EVP_MD *mgf1Hash, |
474 | const unsigned char *EM, int sLen); | |
c553721e DSH |
475 | |
476 | int RSA_padding_add_PKCS1_PSS_mgf1(RSA *rsa, unsigned char *EM, | |
0f113f3e MC |
477 | const unsigned char *mHash, |
478 | const EVP_MD *Hash, const EVP_MD *mgf1Hash, | |
479 | int sLen); | |
c553721e | 480 | |
dd9d233e | 481 | int RSA_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func, |
0f113f3e MC |
482 | CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func); |
483 | int RSA_set_ex_data(RSA *r, int idx, void *arg); | |
29c1f061 | 484 | void *RSA_get_ex_data(const RSA *r, int idx); |
58964a49 | 485 | |
40889b9c LJ |
486 | RSA *RSAPublicKey_dup(RSA *rsa); |
487 | RSA *RSAPrivateKey_dup(RSA *rsa); | |
488 | ||
0f113f3e MC |
489 | /* |
490 | * If this flag is set the RSA method is FIPS compliant and can be used in | |
491 | * FIPS mode. This is set in the validated module method. If an application | |
492 | * sets this flag in its own methods it is its responsibility to ensure the | |
493 | * result is compliant. | |
c553721e DSH |
494 | */ |
495 | ||
0f113f3e | 496 | # define RSA_FLAG_FIPS_METHOD 0x0400 |
c553721e | 497 | |
0f113f3e MC |
498 | /* |
499 | * If this flag is set the operations normally disabled in FIPS mode are | |
c553721e DSH |
500 | * permitted it is then the applications responsibility to ensure that the |
501 | * usage is compliant. | |
502 | */ | |
503 | ||
0f113f3e MC |
504 | # define RSA_FLAG_NON_FIPS_ALLOW 0x0400 |
505 | /* | |
506 | * Application has decided PRNG is good enough to generate a key: don't | |
cac4fb58 DSH |
507 | * check. |
508 | */ | |
0f113f3e | 509 | # define RSA_FLAG_CHECKED 0x0800 |
c553721e | 510 | |
d02b48c6 | 511 | /* BEGIN ERROR CODES */ |
0f113f3e MC |
512 | /* |
513 | * The following lines are auto generated by the script mkerr.pl. Any changes | |
6d311938 DSH |
514 | * made after this point may be overwritten when the script is next run. |
515 | */ | |
24cff6ce | 516 | void ERR_load_RSA_strings(void); |
6d311938 | 517 | |
d02b48c6 RE |
518 | /* Error codes for the RSA functions. */ |
519 | ||
520 | /* Function codes. */ | |
0f113f3e MC |
521 | # define RSA_F_CHECK_PADDING_MD 140 |
522 | # define RSA_F_DO_RSA_PRINT 146 | |
523 | # define RSA_F_FIPS_RSA_SIGN_DIGEST 149 | |
524 | # define RSA_F_FIPS_RSA_VERIFY 150 | |
525 | # define RSA_F_FIPS_RSA_VERIFY_DIGEST 151 | |
526 | # define RSA_F_INT_RSA_VERIFY 145 | |
527 | # define RSA_F_MEMORY_LOCK 100 | |
528 | # define RSA_F_OLD_RSA_PRIV_DECODE 147 | |
529 | # define RSA_F_PKEY_RSA_CTRL 143 | |
530 | # define RSA_F_PKEY_RSA_CTRL_STR 144 | |
531 | # define RSA_F_PKEY_RSA_SIGN 142 | |
532 | # define RSA_F_PKEY_RSA_VERIFYRECOVER 141 | |
533 | # define RSA_F_RSA_ALGOR_TO_MD 156 | |
534 | # define RSA_F_RSA_BUILTIN_KEYGEN 129 | |
535 | # define RSA_F_RSA_CHECK_KEY 123 | |
536 | # define RSA_F_RSA_CHECK_KEY_EX 160 | |
537 | # define RSA_F_RSA_CMS_DECRYPT 159 | |
538 | # define RSA_F_RSA_EAY_PRIVATE_DECRYPT 101 | |
539 | # define RSA_F_RSA_EAY_PRIVATE_ENCRYPT 102 | |
540 | # define RSA_F_RSA_EAY_PUBLIC_DECRYPT 103 | |
541 | # define RSA_F_RSA_EAY_PUBLIC_ENCRYPT 104 | |
542 | # define RSA_F_RSA_GENERATE_KEY 105 | |
543 | # define RSA_F_RSA_ITEM_VERIFY 148 | |
544 | # define RSA_F_RSA_MEMORY_LOCK 130 | |
545 | # define RSA_F_RSA_MGF1_TO_MD 157 | |
546 | # define RSA_F_RSA_NEW_METHOD 106 | |
547 | # define RSA_F_RSA_NULL 124 | |
548 | # define RSA_F_RSA_NULL_MOD_EXP 131 | |
549 | # define RSA_F_RSA_NULL_PRIVATE_DECRYPT 132 | |
550 | # define RSA_F_RSA_NULL_PRIVATE_ENCRYPT 133 | |
551 | # define RSA_F_RSA_NULL_PUBLIC_DECRYPT 134 | |
552 | # define RSA_F_RSA_NULL_PUBLIC_ENCRYPT 135 | |
553 | # define RSA_F_RSA_OAEP_TO_CTX 158 | |
554 | # define RSA_F_RSA_PADDING_ADD_NONE 107 | |
555 | # define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP 121 | |
556 | # define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP_MGF1 154 | |
557 | # define RSA_F_RSA_PADDING_ADD_PKCS1_PSS 125 | |
558 | # define RSA_F_RSA_PADDING_ADD_PKCS1_PSS_MGF1 152 | |
559 | # define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_1 108 | |
560 | # define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_2 109 | |
561 | # define RSA_F_RSA_PADDING_ADD_SSLV23 110 | |
562 | # define RSA_F_RSA_PADDING_ADD_X931 127 | |
563 | # define RSA_F_RSA_PADDING_CHECK_NONE 111 | |
564 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP 122 | |
565 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP_MGF1 153 | |
566 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_1 112 | |
567 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_2 113 | |
568 | # define RSA_F_RSA_PADDING_CHECK_SSLV23 114 | |
569 | # define RSA_F_RSA_PADDING_CHECK_X931 128 | |
570 | # define RSA_F_RSA_PRINT 115 | |
571 | # define RSA_F_RSA_PRINT_FP 116 | |
572 | # define RSA_F_RSA_PRIV_DECODE 137 | |
573 | # define RSA_F_RSA_PRIV_ENCODE 138 | |
574 | # define RSA_F_RSA_PSS_TO_CTX 155 | |
575 | # define RSA_F_RSA_PUB_DECODE 139 | |
576 | # define RSA_F_RSA_SETUP_BLINDING 136 | |
577 | # define RSA_F_RSA_SIGN 117 | |
578 | # define RSA_F_RSA_SIGN_ASN1_OCTET_STRING 118 | |
579 | # define RSA_F_RSA_VERIFY 119 | |
580 | # define RSA_F_RSA_VERIFY_ASN1_OCTET_STRING 120 | |
581 | # define RSA_F_RSA_VERIFY_PKCS1_PSS_MGF1 126 | |
d02b48c6 RE |
582 | |
583 | /* Reason codes. */ | |
0f113f3e MC |
584 | # define RSA_R_ALGORITHM_MISMATCH 100 |
585 | # define RSA_R_BAD_E_VALUE 101 | |
586 | # define RSA_R_BAD_FIXED_HEADER_DECRYPT 102 | |
587 | # define RSA_R_BAD_PAD_BYTE_COUNT 103 | |
588 | # define RSA_R_BAD_SIGNATURE 104 | |
589 | # define RSA_R_BLOCK_TYPE_IS_NOT_01 106 | |
590 | # define RSA_R_BLOCK_TYPE_IS_NOT_02 107 | |
591 | # define RSA_R_DATA_GREATER_THAN_MOD_LEN 108 | |
592 | # define RSA_R_DATA_TOO_LARGE 109 | |
593 | # define RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE 110 | |
594 | # define RSA_R_DATA_TOO_LARGE_FOR_MODULUS 132 | |
595 | # define RSA_R_DATA_TOO_SMALL 111 | |
596 | # define RSA_R_DATA_TOO_SMALL_FOR_KEY_SIZE 122 | |
597 | # define RSA_R_DIGEST_DOES_NOT_MATCH 158 | |
598 | # define RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY 112 | |
599 | # define RSA_R_DMP1_NOT_CONGRUENT_TO_D 124 | |
600 | # define RSA_R_DMQ1_NOT_CONGRUENT_TO_D 125 | |
601 | # define RSA_R_D_E_NOT_CONGRUENT_TO_1 123 | |
602 | # define RSA_R_FIRST_OCTET_INVALID 133 | |
603 | # define RSA_R_ILLEGAL_OR_UNSUPPORTED_PADDING_MODE 144 | |
604 | # define RSA_R_INVALID_DIGEST 157 | |
605 | # define RSA_R_INVALID_DIGEST_LENGTH 143 | |
606 | # define RSA_R_INVALID_HEADER 137 | |
607 | # define RSA_R_INVALID_KEYBITS 145 | |
608 | # define RSA_R_INVALID_LABEL 160 | |
609 | # define RSA_R_INVALID_MESSAGE_LENGTH 131 | |
610 | # define RSA_R_INVALID_MGF1_MD 156 | |
611 | # define RSA_R_INVALID_OAEP_PARAMETERS 161 | |
612 | # define RSA_R_INVALID_PADDING 138 | |
613 | # define RSA_R_INVALID_PADDING_MODE 141 | |
614 | # define RSA_R_INVALID_PSS_PARAMETERS 149 | |
615 | # define RSA_R_INVALID_PSS_SALTLEN 146 | |
616 | # define RSA_R_INVALID_SALT_LENGTH 150 | |
617 | # define RSA_R_INVALID_TRAILER 139 | |
618 | # define RSA_R_INVALID_X931_DIGEST 142 | |
619 | # define RSA_R_IQMP_NOT_INVERSE_OF_Q 126 | |
620 | # define RSA_R_KEY_SIZE_TOO_SMALL 120 | |
621 | # define RSA_R_LAST_OCTET_INVALID 134 | |
622 | # define RSA_R_MODULUS_TOO_LARGE 105 | |
623 | # define RSA_R_NO_PUBLIC_EXPONENT 140 | |
624 | # define RSA_R_NULL_BEFORE_BLOCK_MISSING 113 | |
625 | # define RSA_R_N_DOES_NOT_EQUAL_P_Q 127 | |
626 | # define RSA_R_OAEP_DECODING_ERROR 121 | |
627 | # define RSA_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE 148 | |
628 | # define RSA_R_PADDING_CHECK_FAILED 114 | |
629 | # define RSA_R_PKCS_DECODING_ERROR 159 | |
630 | # define RSA_R_P_NOT_PRIME 128 | |
631 | # define RSA_R_Q_NOT_PRIME 129 | |
632 | # define RSA_R_RSA_OPERATIONS_NOT_SUPPORTED 130 | |
633 | # define RSA_R_SLEN_CHECK_FAILED 136 | |
634 | # define RSA_R_SLEN_RECOVERY_FAILED 135 | |
635 | # define RSA_R_SSLV3_ROLLBACK_ATTACK 115 | |
636 | # define RSA_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 116 | |
637 | # define RSA_R_UNKNOWN_ALGORITHM_TYPE 117 | |
638 | # define RSA_R_UNKNOWN_DIGEST 166 | |
639 | # define RSA_R_UNKNOWN_MASK_DIGEST 151 | |
640 | # define RSA_R_UNKNOWN_PADDING_TYPE 118 | |
641 | # define RSA_R_UNKNOWN_PSS_DIGEST 152 | |
642 | # define RSA_R_UNSUPPORTED_ENCRYPTION_TYPE 162 | |
643 | # define RSA_R_UNSUPPORTED_LABEL_SOURCE 163 | |
644 | # define RSA_R_UNSUPPORTED_MASK_ALGORITHM 153 | |
645 | # define RSA_R_UNSUPPORTED_MASK_PARAMETER 154 | |
646 | # define RSA_R_UNSUPPORTED_SIGNATURE_TYPE 155 | |
647 | # define RSA_R_VALUE_MISSING 147 | |
648 | # define RSA_R_WRONG_SIGNATURE_LENGTH 119 | |
6d311938 | 649 | |
d02b48c6 RE |
650 | #ifdef __cplusplus |
651 | } | |
652 | #endif | |
653 | #endif |