]>
Commit | Line | Data |
---|---|---|
031e5cce SM |
1 | /* crypto/rsa/rsa.h */ |
2 | /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) | |
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. | |
8 | * | |
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). | |
15 | * | |
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. | |
b6f94dbe | 22 | * |
031e5cce SM |
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 :-). | |
37 | * 4. If you include any Windows specific code (or a derivative thereof) from | |
38 | * the apps directory (application code) you must include an acknowledgement: | |
39 | * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" | |
40 | * | |
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. | |
52 | * | |
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.] | |
3e575651 SL |
57 | */ |
58 | ||
59 | #ifndef HEADER_RSA_H | |
d3819813 | 60 | # define HEADER_RSA_H |
3e575651 | 61 | |
7bf7a6d0 | 62 | # include <openssl/asn1.h> |
031e5cce SM |
63 | |
64 | # ifndef OPENSSL_NO_BIO | |
65 | # include <openssl/bio.h> | |
66 | # endif | |
d3819813 MTL |
67 | # include <openssl/crypto.h> |
68 | # include <openssl/ossl_typ.h> | |
031e5cce | 69 | # ifndef OPENSSL_NO_DEPRECATED |
d3819813 MTL |
70 | # include <openssl/bn.h> |
71 | # endif | |
031e5cce SM |
72 | |
73 | # ifdef OPENSSL_NO_RSA | |
74 | # error RSA is disabled. | |
7bf7a6d0 | 75 | # endif |
b6f94dbe | 76 | |
031e5cce SM |
77 | #ifdef __cplusplus |
78 | extern "C" { | |
79 | #endif | |
80 | ||
81 | /* Declared already in ossl_typ.h */ | |
82 | /* typedef struct rsa_st RSA; */ | |
83 | /* typedef struct rsa_meth_st RSA_METHOD; */ | |
84 | ||
85 | struct rsa_meth_st { | |
86 | const char *name; | |
87 | int (*rsa_pub_enc) (int flen, const unsigned char *from, | |
88 | unsigned char *to, RSA *rsa, int padding); | |
89 | int (*rsa_pub_dec) (int flen, const unsigned char *from, | |
90 | unsigned char *to, RSA *rsa, int padding); | |
91 | int (*rsa_priv_enc) (int flen, const unsigned char *from, | |
92 | unsigned char *to, RSA *rsa, int padding); | |
93 | int (*rsa_priv_dec) (int flen, const unsigned char *from, | |
94 | unsigned char *to, RSA *rsa, int padding); | |
95 | /* Can be null */ | |
96 | int (*rsa_mod_exp) (BIGNUM *r0, const BIGNUM *I, RSA *rsa, BN_CTX *ctx); | |
97 | /* Can be null */ | |
98 | int (*bn_mod_exp) (BIGNUM *r, const BIGNUM *a, const BIGNUM *p, | |
99 | const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx); | |
100 | /* called at new */ | |
101 | int (*init) (RSA *rsa); | |
102 | /* called at free */ | |
103 | int (*finish) (RSA *rsa); | |
104 | /* RSA_METHOD_FLAG_* things */ | |
105 | int flags; | |
106 | /* may be needed! */ | |
107 | char *app_data; | |
108 | /* | |
109 | * New sign and verify functions: some libraries don't allow arbitrary | |
110 | * data to be signed/verified: this allows them to be used. Note: for | |
111 | * this to work the RSA_public_decrypt() and RSA_private_encrypt() should | |
112 | * *NOT* be used RSA_sign(), RSA_verify() should be used instead. Note: | |
113 | * for backwards compatibility this functionality is only enabled if the | |
114 | * RSA_FLAG_SIGN_VER option is set in 'flags'. | |
115 | */ | |
116 | int (*rsa_sign) (int type, | |
117 | const unsigned char *m, unsigned int m_length, | |
118 | unsigned char *sigret, unsigned int *siglen, | |
119 | const RSA *rsa); | |
120 | int (*rsa_verify) (int dtype, const unsigned char *m, | |
121 | unsigned int m_length, const unsigned char *sigbuf, | |
122 | unsigned int siglen, const RSA *rsa); | |
123 | /* | |
124 | * If this callback is NULL, the builtin software RSA key-gen will be | |
125 | * used. This is for behavioural compatibility whilst the code gets | |
126 | * rewired, but one day it would be nice to assume there are no such | |
127 | * things as "builtin software" implementations. | |
128 | */ | |
129 | int (*rsa_keygen) (RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb); | |
130 | }; | |
131 | ||
132 | struct rsa_st { | |
133 | /* | |
134 | * The first parameter is used to pickup errors where this is passed | |
135 | * instead of aEVP_PKEY, it is set to 0 | |
136 | */ | |
137 | int pad; | |
138 | long version; | |
139 | const RSA_METHOD *meth; | |
140 | /* functional reference if 'meth' is ENGINE-provided */ | |
141 | ENGINE *engine; | |
142 | BIGNUM *n; | |
143 | BIGNUM *e; | |
144 | BIGNUM *d; | |
145 | BIGNUM *p; | |
146 | BIGNUM *q; | |
147 | BIGNUM *dmp1; | |
148 | BIGNUM *dmq1; | |
149 | BIGNUM *iqmp; | |
150 | /* be careful using this if the RSA structure is shared */ | |
151 | CRYPTO_EX_DATA ex_data; | |
152 | int references; | |
153 | int flags; | |
154 | /* Used to cache montgomery values */ | |
155 | BN_MONT_CTX *_method_mod_n; | |
156 | BN_MONT_CTX *_method_mod_p; | |
157 | BN_MONT_CTX *_method_mod_q; | |
158 | /* | |
159 | * all BIGNUM values are actually in the following data, if it is not | |
160 | * NULL | |
161 | */ | |
162 | char *bignum_data; | |
163 | BN_BLINDING *blinding; | |
164 | BN_BLINDING *mt_blinding; | |
165 | }; | |
d3819813 MTL |
166 | |
167 | # ifndef OPENSSL_RSA_MAX_MODULUS_BITS | |
168 | # define OPENSSL_RSA_MAX_MODULUS_BITS 16384 | |
169 | # endif | |
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 | |
175 | ||
176 | /* exponent limit enforced for "large" modulus only */ | |
177 | # define OPENSSL_RSA_MAX_PUBEXP_BITS 64 | |
178 | # endif | |
179 | ||
180 | # define RSA_3 0x3L | |
181 | # define RSA_F4 0x10001L | |
182 | ||
183 | # define RSA_METHOD_FLAG_NO_CHECK 0x0001/* don't check pub/private | |
184 | * match */ | |
185 | ||
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 | |
192 | * and that they do not depend on the private key components being present: | |
193 | * for example a key stored in external hardware. Without this flag | |
194 | * bn_mod_exp gets called when private key components are absent. | |
3e575651 | 195 | */ |
d3819813 | 196 | # define RSA_FLAG_EXT_PKEY 0x0020 |
3e575651 | 197 | |
031e5cce SM |
198 | /* |
199 | * This flag in the RSA_METHOD enables the new rsa_sign, rsa_verify | |
200 | * functions. | |
201 | */ | |
202 | # define RSA_FLAG_SIGN_VER 0x0040 | |
203 | ||
d3819813 MTL |
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 | */ | |
210 | # define RSA_FLAG_NO_BLINDING 0x0080 | |
211 | /* | |
031e5cce SM |
212 | * new with 0.9.8f; the built-in RSA |
213 | * implementation now uses constant time | |
214 | * operations by default in private key operations, | |
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 | |
220 | * private key operations. | |
d3819813 | 221 | */ |
031e5cce SM |
222 | # define RSA_FLAG_NO_CONSTTIME 0x0100 |
223 | # ifdef OPENSSL_USE_DEPRECATED | |
d3819813 MTL |
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. | |
3e575651 | 232 | */ |
d3819813 MTL |
233 | # define RSA_FLAG_NO_EXP_CONSTTIME RSA_FLAG_NO_CONSTTIME |
234 | # endif | |
3e575651 | 235 | |
d3819813 MTL |
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) | |
3e575651 | 239 | |
d3819813 MTL |
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) | |
3e575651 | 243 | |
d3819813 MTL |
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) | |
3e575651 | 249 | |
d3819813 MTL |
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) | |
3e575651 | 255 | |
d3819813 MTL |
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) | |
3e575651 | 259 | |
d3819813 MTL |
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) | |
3e575651 | 263 | |
d3819813 MTL |
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) | |
3e575651 | 268 | |
d3819813 MTL |
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) | |
3e575651 | 272 | |
d3819813 MTL |
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) | |
3e575651 | 277 | |
d3819813 MTL |
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) | |
3e575651 | 281 | |
d3819813 MTL |
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) | |
3e575651 | 300 | |
d3819813 MTL |
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) | |
3e575651 | 303 | |
d3819813 MTL |
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) | |
3e575651 | 306 | |
d3819813 MTL |
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 | |
312 | /* EVP_PKEY_ only */ | |
313 | # define RSA_PKCS1_PSS_PADDING 6 | |
3e575651 | 314 | |
d3819813 | 315 | # define RSA_PKCS1_PADDING_SIZE 11 |
3e575651 | 316 | |
d3819813 MTL |
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) | |
319 | ||
320 | RSA *RSA_new(void); | |
321 | RSA *RSA_new_method(ENGINE *engine); | |
322 | int RSA_size(const RSA *rsa); | |
3e575651 SL |
323 | |
324 | /* Deprecated version */ | |
031e5cce SM |
325 | # ifndef OPENSSL_NO_DEPRECATED |
326 | RSA *RSA_generate_key(int bits, unsigned long e, void | |
327 | (*callback) (int, int, void *), void *cb_arg); | |
328 | # endif /* !defined(OPENSSL_NO_DEPRECATED) */ | |
3e575651 SL |
329 | |
330 | /* New version */ | |
d3819813 MTL |
331 | int RSA_generate_key_ex(RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb); |
332 | ||
333 | int RSA_check_key(const RSA *); | |
334 | /* next 4 return -1 on error */ | |
335 | int RSA_public_encrypt(int flen, const unsigned char *from, | |
336 | unsigned char *to, RSA *rsa, int padding); | |
337 | int RSA_private_encrypt(int flen, const unsigned char *from, | |
338 | unsigned char *to, RSA *rsa, int padding); | |
339 | int RSA_public_decrypt(int flen, const unsigned char *from, | |
340 | unsigned char *to, RSA *rsa, int padding); | |
341 | int RSA_private_decrypt(int flen, const unsigned char *from, | |
342 | unsigned char *to, RSA *rsa, int padding); | |
343 | void RSA_free(RSA *r); | |
3e575651 | 344 | /* "up" the RSA object's reference count */ |
d3819813 | 345 | int RSA_up_ref(RSA *r); |
3e575651 | 346 | |
d3819813 | 347 | int RSA_flags(const RSA *r); |
3e575651 SL |
348 | |
349 | void RSA_set_default_method(const RSA_METHOD *meth); | |
350 | const RSA_METHOD *RSA_get_default_method(void); | |
351 | const RSA_METHOD *RSA_get_method(const RSA *rsa); | |
352 | int RSA_set_method(RSA *rsa, const RSA_METHOD *meth); | |
353 | ||
031e5cce SM |
354 | /* This function needs the memory locking malloc callbacks to be installed */ |
355 | int RSA_memory_lock(RSA *r); | |
356 | ||
357 | /* these are the actual SSLeay RSA functions */ | |
358 | const RSA_METHOD *RSA_PKCS1_SSLeay(void); | |
3e575651 SL |
359 | |
360 | const RSA_METHOD *RSA_null_method(void); | |
361 | ||
362 | DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPublicKey) | |
363 | DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPrivateKey) | |
364 | ||
d3819813 MTL |
365 | typedef struct rsa_pss_params_st { |
366 | X509_ALGOR *hashAlgorithm; | |
367 | X509_ALGOR *maskGenAlgorithm; | |
368 | ASN1_INTEGER *saltLength; | |
369 | ASN1_INTEGER *trailerField; | |
370 | } RSA_PSS_PARAMS; | |
3e575651 | 371 | |
d3819813 MTL |
372 | DECLARE_ASN1_FUNCTIONS(RSA_PSS_PARAMS) |
373 | ||
374 | typedef struct rsa_oaep_params_st { | |
375 | X509_ALGOR *hashFunc; | |
376 | X509_ALGOR *maskGenFunc; | |
377 | X509_ALGOR *pSourceFunc; | |
378 | } RSA_OAEP_PARAMS; | |
379 | ||
380 | DECLARE_ASN1_FUNCTIONS(RSA_OAEP_PARAMS) | |
381 | ||
031e5cce | 382 | # ifndef OPENSSL_NO_FP_API |
d3819813 MTL |
383 | int RSA_print_fp(FILE *fp, const RSA *r, int offset); |
384 | # endif | |
3e575651 | 385 | |
031e5cce | 386 | # ifndef OPENSSL_NO_BIO |
d3819813 | 387 | int RSA_print(BIO *bp, const RSA *r, int offset); |
031e5cce SM |
388 | # endif |
389 | ||
390 | # ifndef OPENSSL_NO_RC4 | |
391 | int i2d_RSA_NET(const RSA *a, unsigned char **pp, | |
392 | int (*cb) (char *buf, int len, const char *prompt, | |
393 | int verify), int sgckey); | |
394 | RSA *d2i_RSA_NET(RSA **a, const unsigned char **pp, long length, | |
395 | int (*cb) (char *buf, int len, const char *prompt, | |
396 | int verify), int sgckey); | |
397 | ||
398 | int i2d_Netscape_RSA(const RSA *a, unsigned char **pp, | |
399 | int (*cb) (char *buf, int len, const char *prompt, | |
400 | int verify)); | |
401 | RSA *d2i_Netscape_RSA(RSA **a, const unsigned char **pp, long length, | |
402 | int (*cb) (char *buf, int len, const char *prompt, | |
403 | int verify)); | |
404 | # endif | |
3e575651 | 405 | |
d3819813 MTL |
406 | /* |
407 | * The following 2 functions sign and verify a X509_SIG ASN1 object inside | |
408 | * PKCS#1 padded RSA encryption | |
409 | */ | |
3e575651 | 410 | int RSA_sign(int type, const unsigned char *m, unsigned int m_length, |
d3819813 | 411 | unsigned char *sigret, unsigned int *siglen, RSA *rsa); |
3e575651 | 412 | int RSA_verify(int type, const unsigned char *m, unsigned int m_length, |
d3819813 | 413 | const unsigned char *sigbuf, unsigned int siglen, RSA *rsa); |
3e575651 | 414 | |
d3819813 MTL |
415 | /* |
416 | * The following 2 function sign and verify a ASN1_OCTET_STRING object inside | |
417 | * PKCS#1 padded RSA encryption | |
418 | */ | |
3e575651 | 419 | int RSA_sign_ASN1_OCTET_STRING(int type, |
d3819813 MTL |
420 | const unsigned char *m, unsigned int m_length, |
421 | unsigned char *sigret, unsigned int *siglen, | |
422 | RSA *rsa); | |
423 | int RSA_verify_ASN1_OCTET_STRING(int type, const unsigned char *m, | |
424 | unsigned int m_length, unsigned char *sigbuf, | |
425 | unsigned int siglen, RSA *rsa); | |
3e575651 SL |
426 | |
427 | int RSA_blinding_on(RSA *rsa, BN_CTX *ctx); | |
428 | void RSA_blinding_off(RSA *rsa); | |
429 | BN_BLINDING *RSA_setup_blinding(RSA *rsa, BN_CTX *ctx); | |
430 | ||
d3819813 MTL |
431 | int RSA_padding_add_PKCS1_type_1(unsigned char *to, int tlen, |
432 | const unsigned char *f, int fl); | |
433 | int RSA_padding_check_PKCS1_type_1(unsigned char *to, int tlen, | |
434 | const unsigned char *f, int fl, | |
435 | int rsa_len); | |
436 | int RSA_padding_add_PKCS1_type_2(unsigned char *to, int tlen, | |
437 | const unsigned char *f, int fl); | |
438 | int RSA_padding_check_PKCS1_type_2(unsigned char *to, int tlen, | |
439 | const unsigned char *f, int fl, | |
440 | int rsa_len); | |
441 | int PKCS1_MGF1(unsigned char *mask, long len, const unsigned char *seed, | |
442 | long seedlen, const EVP_MD *dgst); | |
443 | int RSA_padding_add_PKCS1_OAEP(unsigned char *to, int tlen, | |
444 | const unsigned char *f, int fl, | |
445 | const unsigned char *p, int pl); | |
446 | int RSA_padding_check_PKCS1_OAEP(unsigned char *to, int tlen, | |
447 | const unsigned char *f, int fl, int rsa_len, | |
448 | const unsigned char *p, int pl); | |
449 | int RSA_padding_add_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, | |
450 | const unsigned char *from, int flen, | |
451 | const unsigned char *param, int plen, | |
452 | const EVP_MD *md, const EVP_MD *mgf1md); | |
453 | int RSA_padding_check_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, | |
454 | const unsigned char *from, int flen, | |
455 | int num, const unsigned char *param, | |
456 | int plen, const EVP_MD *md, | |
457 | const EVP_MD *mgf1md); | |
458 | int RSA_padding_add_SSLv23(unsigned char *to, int tlen, | |
459 | const unsigned char *f, int fl); | |
460 | int RSA_padding_check_SSLv23(unsigned char *to, int tlen, | |
461 | const unsigned char *f, int fl, int rsa_len); | |
462 | int RSA_padding_add_none(unsigned char *to, int tlen, const unsigned char *f, | |
463 | int fl); | |
464 | int RSA_padding_check_none(unsigned char *to, int tlen, | |
465 | const unsigned char *f, int fl, int rsa_len); | |
466 | int RSA_padding_add_X931(unsigned char *to, int tlen, const unsigned char *f, | |
467 | int fl); | |
468 | int RSA_padding_check_X931(unsigned char *to, int tlen, | |
469 | const unsigned char *f, int fl, int rsa_len); | |
3e575651 SL |
470 | int RSA_X931_hash_id(int nid); |
471 | ||
472 | int RSA_verify_PKCS1_PSS(RSA *rsa, const unsigned char *mHash, | |
d3819813 MTL |
473 | const EVP_MD *Hash, const unsigned char *EM, |
474 | int sLen); | |
3e575651 | 475 | int RSA_padding_add_PKCS1_PSS(RSA *rsa, unsigned char *EM, |
d3819813 MTL |
476 | const unsigned char *mHash, const EVP_MD *Hash, |
477 | int sLen); | |
478 | ||
479 | int RSA_verify_PKCS1_PSS_mgf1(RSA *rsa, const unsigned char *mHash, | |
480 | const EVP_MD *Hash, const EVP_MD *mgf1Hash, | |
481 | const unsigned char *EM, int sLen); | |
482 | ||
483 | int RSA_padding_add_PKCS1_PSS_mgf1(RSA *rsa, unsigned char *EM, | |
484 | const unsigned char *mHash, | |
485 | const EVP_MD *Hash, const EVP_MD *mgf1Hash, | |
486 | int sLen); | |
3e575651 | 487 | |
031e5cce SM |
488 | int RSA_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func, |
489 | CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func); | |
d3819813 | 490 | int RSA_set_ex_data(RSA *r, int idx, void *arg); |
3e575651 SL |
491 | void *RSA_get_ex_data(const RSA *r, int idx); |
492 | ||
493 | RSA *RSAPublicKey_dup(RSA *rsa); | |
494 | RSA *RSAPrivateKey_dup(RSA *rsa); | |
495 | ||
d3819813 MTL |
496 | /* |
497 | * If this flag is set the RSA method is FIPS compliant and can be used in | |
498 | * FIPS mode. This is set in the validated module method. If an application | |
499 | * sets this flag in its own methods it is its responsibility to ensure the | |
500 | * result is compliant. | |
501 | */ | |
502 | ||
503 | # define RSA_FLAG_FIPS_METHOD 0x0400 | |
504 | ||
505 | /* | |
506 | * If this flag is set the operations normally disabled in FIPS mode are | |
507 | * permitted it is then the applications responsibility to ensure that the | |
508 | * usage is compliant. | |
509 | */ | |
510 | ||
511 | # define RSA_FLAG_NON_FIPS_ALLOW 0x0400 | |
512 | /* | |
513 | * Application has decided PRNG is good enough to generate a key: don't | |
514 | * check. | |
515 | */ | |
516 | # define RSA_FLAG_CHECKED 0x0800 | |
517 | ||
3e575651 | 518 | /* BEGIN ERROR CODES */ |
d3819813 MTL |
519 | /* |
520 | * The following lines are auto generated by the script mkerr.pl. Any changes | |
3e575651 SL |
521 | * made after this point may be overwritten when the script is next run. |
522 | */ | |
031e5cce | 523 | void ERR_load_RSA_strings(void); |
3e575651 SL |
524 | |
525 | /* Error codes for the RSA functions. */ | |
526 | ||
527 | /* Function codes. */ | |
d3819813 | 528 | # define RSA_F_CHECK_PADDING_MD 140 |
031e5cce | 529 | # define RSA_F_DO_RSA_PRINT 146 |
d3819813 | 530 | # define RSA_F_INT_RSA_VERIFY 145 |
031e5cce | 531 | # define RSA_F_MEMORY_LOCK 100 |
d3819813 MTL |
532 | # define RSA_F_OLD_RSA_PRIV_DECODE 147 |
533 | # define RSA_F_PKEY_RSA_CTRL 143 | |
534 | # define RSA_F_PKEY_RSA_CTRL_STR 144 | |
535 | # define RSA_F_PKEY_RSA_SIGN 142 | |
031e5cce | 536 | # define RSA_F_PKEY_RSA_VERIFY 154 |
d3819813 | 537 | # define RSA_F_PKEY_RSA_VERIFYRECOVER 141 |
031e5cce | 538 | # define RSA_F_RSA_ALGOR_TO_MD 157 |
d3819813 MTL |
539 | # define RSA_F_RSA_BUILTIN_KEYGEN 129 |
540 | # define RSA_F_RSA_CHECK_KEY 123 | |
031e5cce SM |
541 | # define RSA_F_RSA_CMS_DECRYPT 158 |
542 | # define RSA_F_RSA_EAY_PRIVATE_DECRYPT 101 | |
543 | # define RSA_F_RSA_EAY_PRIVATE_ENCRYPT 102 | |
544 | # define RSA_F_RSA_EAY_PUBLIC_DECRYPT 103 | |
545 | # define RSA_F_RSA_EAY_PUBLIC_ENCRYPT 104 | |
546 | # define RSA_F_RSA_GENERATE_KEY 105 | |
547 | # define RSA_F_RSA_GENERATE_KEY_EX 155 | |
548 | # define RSA_F_RSA_ITEM_VERIFY 156 | |
549 | # define RSA_F_RSA_MEMORY_LOCK 130 | |
550 | # define RSA_F_RSA_MGF1_TO_MD 159 | |
d3819813 MTL |
551 | # define RSA_F_RSA_NEW_METHOD 106 |
552 | # define RSA_F_RSA_NULL 124 | |
031e5cce | 553 | # define RSA_F_RSA_NULL_MOD_EXP 131 |
d3819813 MTL |
554 | # define RSA_F_RSA_NULL_PRIVATE_DECRYPT 132 |
555 | # define RSA_F_RSA_NULL_PRIVATE_ENCRYPT 133 | |
556 | # define RSA_F_RSA_NULL_PUBLIC_DECRYPT 134 | |
557 | # define RSA_F_RSA_NULL_PUBLIC_ENCRYPT 135 | |
558 | # define RSA_F_RSA_PADDING_ADD_NONE 107 | |
559 | # define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP 121 | |
031e5cce | 560 | # define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP_MGF1 160 |
d3819813 | 561 | # define RSA_F_RSA_PADDING_ADD_PKCS1_PSS 125 |
031e5cce | 562 | # define RSA_F_RSA_PADDING_ADD_PKCS1_PSS_MGF1 148 |
d3819813 MTL |
563 | # define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_1 108 |
564 | # define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_2 109 | |
565 | # define RSA_F_RSA_PADDING_ADD_SSLV23 110 | |
566 | # define RSA_F_RSA_PADDING_ADD_X931 127 | |
567 | # define RSA_F_RSA_PADDING_CHECK_NONE 111 | |
568 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP 122 | |
031e5cce | 569 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP_MGF1 161 |
d3819813 MTL |
570 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_1 112 |
571 | # define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_2 113 | |
572 | # define RSA_F_RSA_PADDING_CHECK_SSLV23 114 | |
573 | # define RSA_F_RSA_PADDING_CHECK_X931 128 | |
574 | # define RSA_F_RSA_PRINT 115 | |
575 | # define RSA_F_RSA_PRINT_FP 116 | |
031e5cce SM |
576 | # define RSA_F_RSA_PRIVATE_DECRYPT 150 |
577 | # define RSA_F_RSA_PRIVATE_ENCRYPT 151 | |
578 | # define RSA_F_RSA_PRIV_DECODE 137 | |
d3819813 | 579 | # define RSA_F_RSA_PRIV_ENCODE 138 |
031e5cce SM |
580 | # define RSA_F_RSA_PSS_TO_CTX 162 |
581 | # define RSA_F_RSA_PUBLIC_DECRYPT 152 | |
582 | # define RSA_F_RSA_PUBLIC_ENCRYPT 153 | |
d3819813 MTL |
583 | # define RSA_F_RSA_PUB_DECODE 139 |
584 | # define RSA_F_RSA_SETUP_BLINDING 136 | |
585 | # define RSA_F_RSA_SIGN 117 | |
586 | # define RSA_F_RSA_SIGN_ASN1_OCTET_STRING 118 | |
587 | # define RSA_F_RSA_VERIFY 119 | |
588 | # define RSA_F_RSA_VERIFY_ASN1_OCTET_STRING 120 | |
031e5cce SM |
589 | # define RSA_F_RSA_VERIFY_PKCS1_PSS 126 |
590 | # define RSA_F_RSA_VERIFY_PKCS1_PSS_MGF1 149 | |
3e575651 SL |
591 | |
592 | /* Reason codes. */ | |
d3819813 MTL |
593 | # define RSA_R_ALGORITHM_MISMATCH 100 |
594 | # define RSA_R_BAD_E_VALUE 101 | |
595 | # define RSA_R_BAD_FIXED_HEADER_DECRYPT 102 | |
596 | # define RSA_R_BAD_PAD_BYTE_COUNT 103 | |
597 | # define RSA_R_BAD_SIGNATURE 104 | |
598 | # define RSA_R_BLOCK_TYPE_IS_NOT_01 106 | |
599 | # define RSA_R_BLOCK_TYPE_IS_NOT_02 107 | |
600 | # define RSA_R_DATA_GREATER_THAN_MOD_LEN 108 | |
601 | # define RSA_R_DATA_TOO_LARGE 109 | |
602 | # define RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE 110 | |
603 | # define RSA_R_DATA_TOO_LARGE_FOR_MODULUS 132 | |
604 | # define RSA_R_DATA_TOO_SMALL 111 | |
605 | # define RSA_R_DATA_TOO_SMALL_FOR_KEY_SIZE 122 | |
031e5cce | 606 | # define RSA_R_DIGEST_DOES_NOT_MATCH 166 |
d3819813 MTL |
607 | # define RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY 112 |
608 | # define RSA_R_DMP1_NOT_CONGRUENT_TO_D 124 | |
609 | # define RSA_R_DMQ1_NOT_CONGRUENT_TO_D 125 | |
610 | # define RSA_R_D_E_NOT_CONGRUENT_TO_1 123 | |
611 | # define RSA_R_FIRST_OCTET_INVALID 133 | |
612 | # define RSA_R_ILLEGAL_OR_UNSUPPORTED_PADDING_MODE 144 | |
031e5cce | 613 | # define RSA_R_INVALID_DIGEST 160 |
d3819813 MTL |
614 | # define RSA_R_INVALID_DIGEST_LENGTH 143 |
615 | # define RSA_R_INVALID_HEADER 137 | |
031e5cce SM |
616 | # define RSA_R_INVALID_KEYBITS 145 |
617 | # define RSA_R_INVALID_LABEL 161 | |
d3819813 MTL |
618 | # define RSA_R_INVALID_MESSAGE_LENGTH 131 |
619 | # define RSA_R_INVALID_MGF1_MD 156 | |
031e5cce | 620 | # define RSA_R_INVALID_OAEP_PARAMETERS 162 |
d3819813 MTL |
621 | # define RSA_R_INVALID_PADDING 138 |
622 | # define RSA_R_INVALID_PADDING_MODE 141 | |
623 | # define RSA_R_INVALID_PSS_PARAMETERS 149 | |
624 | # define RSA_R_INVALID_PSS_SALTLEN 146 | |
625 | # define RSA_R_INVALID_SALT_LENGTH 150 | |
626 | # define RSA_R_INVALID_TRAILER 139 | |
627 | # define RSA_R_INVALID_X931_DIGEST 142 | |
628 | # define RSA_R_IQMP_NOT_INVERSE_OF_Q 126 | |
629 | # define RSA_R_KEY_SIZE_TOO_SMALL 120 | |
630 | # define RSA_R_LAST_OCTET_INVALID 134 | |
631 | # define RSA_R_MODULUS_TOO_LARGE 105 | |
031e5cce | 632 | # define RSA_R_NON_FIPS_RSA_METHOD 157 |
d3819813 MTL |
633 | # define RSA_R_NO_PUBLIC_EXPONENT 140 |
634 | # define RSA_R_NULL_BEFORE_BLOCK_MISSING 113 | |
635 | # define RSA_R_N_DOES_NOT_EQUAL_P_Q 127 | |
636 | # define RSA_R_OAEP_DECODING_ERROR 121 | |
031e5cce | 637 | # define RSA_R_OPERATION_NOT_ALLOWED_IN_FIPS_MODE 158 |
d3819813 MTL |
638 | # define RSA_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE 148 |
639 | # define RSA_R_PADDING_CHECK_FAILED 114 | |
640 | # define RSA_R_PKCS_DECODING_ERROR 159 | |
641 | # define RSA_R_P_NOT_PRIME 128 | |
642 | # define RSA_R_Q_NOT_PRIME 129 | |
643 | # define RSA_R_RSA_OPERATIONS_NOT_SUPPORTED 130 | |
644 | # define RSA_R_SLEN_CHECK_FAILED 136 | |
645 | # define RSA_R_SLEN_RECOVERY_FAILED 135 | |
646 | # define RSA_R_SSLV3_ROLLBACK_ATTACK 115 | |
647 | # define RSA_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 116 | |
648 | # define RSA_R_UNKNOWN_ALGORITHM_TYPE 117 | |
031e5cce | 649 | # define RSA_R_UNKNOWN_DIGEST 163 |
d3819813 MTL |
650 | # define RSA_R_UNKNOWN_MASK_DIGEST 151 |
651 | # define RSA_R_UNKNOWN_PADDING_TYPE 118 | |
031e5cce SM |
652 | # define RSA_R_UNKNOWN_PSS_DIGEST 152 |
653 | # define RSA_R_UNSUPPORTED_ENCRYPTION_TYPE 164 | |
654 | # define RSA_R_UNSUPPORTED_LABEL_SOURCE 165 | |
d3819813 MTL |
655 | # define RSA_R_UNSUPPORTED_MASK_ALGORITHM 153 |
656 | # define RSA_R_UNSUPPORTED_MASK_PARAMETER 154 | |
657 | # define RSA_R_UNSUPPORTED_SIGNATURE_TYPE 155 | |
658 | # define RSA_R_VALUE_MISSING 147 | |
659 | # define RSA_R_WRONG_SIGNATURE_LENGTH 119 | |
3e575651 | 660 | |
031e5cce | 661 | #ifdef __cplusplus |
3e575651 | 662 | } |
031e5cce | 663 | #endif |
3e575651 | 664 | #endif |