1 /* $OpenBSD: rsa.h,v 1.58 2022/07/12 14:42:50 kn Exp $ */ 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. 22 * 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.] 57 */ 58 59 #ifndef HEADER_RSA_H 60 #define HEADER_RSA_H 61 62 #include <openssl/opensslconf.h> 63 64 #include <openssl/asn1.h> 65 66 #ifndef OPENSSL_NO_BIO 67 #include <openssl/bio.h> 68 #endif 69 #include <openssl/crypto.h> 70 #include <openssl/ossl_typ.h> 71 #ifndef OPENSSL_NO_DEPRECATED 72 #include <openssl/bn.h> 73 #endif 74 75 #ifdef OPENSSL_NO_RSA 76 #error RSA is disabled. 77 #endif 78 79 #ifdef __cplusplus 80 extern "C" { 81 #endif 82 83 struct rsa_pss_params_st { 84 X509_ALGOR *hashAlgorithm; 85 X509_ALGOR *maskGenAlgorithm; 86 ASN1_INTEGER *saltLength; 87 ASN1_INTEGER *trailerField; 88 89 /* Hash algorithm decoded from maskGenAlgorithm. */ 90 X509_ALGOR *maskHash; 91 } /* RSA_PSS_PARAMS */; 92 93 typedef struct rsa_oaep_params_st { 94 X509_ALGOR *hashFunc; 95 X509_ALGOR *maskGenFunc; 96 X509_ALGOR *pSourceFunc; 97 98 /* Hash algorithm decoded from maskGenFunc. */ 99 X509_ALGOR *maskHash; 100 } RSA_OAEP_PARAMS; 101 102 #ifndef OPENSSL_RSA_MAX_MODULUS_BITS 103 # define OPENSSL_RSA_MAX_MODULUS_BITS 16384 104 #endif 105 106 #ifndef OPENSSL_RSA_SMALL_MODULUS_BITS 107 # define OPENSSL_RSA_SMALL_MODULUS_BITS 3072 108 #endif 109 #ifndef OPENSSL_RSA_MAX_PUBEXP_BITS 110 # define OPENSSL_RSA_MAX_PUBEXP_BITS 64 /* exponent limit enforced for "large" modulus only */ 111 #endif 112 113 #define RSA_3 0x3L 114 #define RSA_F4 0x10001L 115 116 /* Don't check pub/private match. */ 117 #define RSA_METHOD_FLAG_NO_CHECK 0x0001 118 119 #define RSA_FLAG_CACHE_PUBLIC 0x0002 120 #define RSA_FLAG_CACHE_PRIVATE 0x0004 121 #define RSA_FLAG_BLINDING 0x0008 122 #define RSA_FLAG_THREAD_SAFE 0x0010 123 124 /* 125 * This flag means the private key operations will be handled by rsa_mod_exp 126 * and that they do not depend on the private key components being present: 127 * for example a key stored in external hardware. Without this flag bn_mod_exp 128 * gets called when private key components are absent. 129 */ 130 #define RSA_FLAG_EXT_PKEY 0x0020 131 132 /* 133 * This flag in the RSA_METHOD enables the new rsa_sign, rsa_verify functions. 134 */ 135 #define RSA_FLAG_SIGN_VER 0x0040 136 137 /* 138 * The built-in RSA implementation uses blinding by default, but other engines 139 * might not need it. 140 */ 141 #define RSA_FLAG_NO_BLINDING 0x0080 142 143 /* Salt length matches digest */ 144 #define RSA_PSS_SALTLEN_DIGEST -1 145 /* Verify only: auto detect salt length */ 146 #define RSA_PSS_SALTLEN_AUTO -2 147 /* Set salt length to maximum possible */ 148 #define RSA_PSS_SALTLEN_MAX -3 149 150 #define EVP_PKEY_CTX_set_rsa_padding(ctx, pad) \ 151 RSA_pkey_ctx_ctrl(ctx, -1, EVP_PKEY_CTRL_RSA_PADDING, pad, NULL) 152 153 #define EVP_PKEY_CTX_get_rsa_padding(ctx, ppad) \ 154 RSA_pkey_ctx_ctrl(ctx, -1, EVP_PKEY_CTRL_GET_RSA_PADDING, 0, ppad) 155 156 #define EVP_PKEY_CTX_set_rsa_pss_saltlen(ctx, len) \ 157 RSA_pkey_ctx_ctrl(ctx, (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \ 158 EVP_PKEY_CTRL_RSA_PSS_SALTLEN, len, NULL) 159 160 #define EVP_PKEY_CTX_set_rsa_pss_keygen_saltlen(ctx, len) \ 161 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA_PSS, EVP_PKEY_OP_KEYGEN, \ 162 EVP_PKEY_CTRL_RSA_PSS_SALTLEN, len, NULL) 163 164 #define EVP_PKEY_CTX_get_rsa_pss_saltlen(ctx, plen) \ 165 RSA_pkey_ctx_ctrl(ctx, (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \ 166 EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN, 0, plen) 167 168 #define EVP_PKEY_CTX_set_rsa_keygen_bits(ctx, bits) \ 169 RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_KEYGEN, \ 170 EVP_PKEY_CTRL_RSA_KEYGEN_BITS, bits, NULL) 171 172 #define EVP_PKEY_CTX_set_rsa_keygen_pubexp(ctx, pubexp) \ 173 RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_KEYGEN, \ 174 EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP, 0, pubexp) 175 176 #define EVP_PKEY_CTX_set_rsa_mgf1_md(ctx, md) \ 177 RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \ 178 EVP_PKEY_CTRL_RSA_MGF1_MD, 0, (void *)(md)) 179 180 #define EVP_PKEY_CTX_set_rsa_pss_keygen_mgf1_md(ctx, md) \ 181 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA_PSS, EVP_PKEY_OP_KEYGEN, \ 182 EVP_PKEY_CTRL_RSA_MGF1_MD, 0, (void *)(md)) 183 184 #define EVP_PKEY_CTX_set_rsa_oaep_md(ctx, md) \ 185 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ 186 EVP_PKEY_CTRL_RSA_OAEP_MD, 0, (void *)(md)) 187 188 #define EVP_PKEY_CTX_get_rsa_mgf1_md(ctx, pmd) \ 189 RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \ 190 EVP_PKEY_CTRL_GET_RSA_MGF1_MD, 0, (void *)(pmd)) 191 192 #define EVP_PKEY_CTX_get_rsa_oaep_md(ctx, pmd) \ 193 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ 194 EVP_PKEY_CTRL_GET_RSA_OAEP_MD, 0, (void *)(pmd)) 195 196 #define EVP_PKEY_CTX_set0_rsa_oaep_label(ctx, l, llen) \ 197 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ 198 EVP_PKEY_CTRL_RSA_OAEP_LABEL, llen, (void *)(l)) 199 200 #define EVP_PKEY_CTX_get0_rsa_oaep_label(ctx, l) \ 201 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ 202 EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL, 0, (void *)(l)) 203 204 #define EVP_PKEY_CTX_set_rsa_pss_keygen_md(ctx, md) \ 205 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA_PSS, \ 206 EVP_PKEY_OP_KEYGEN, EVP_PKEY_CTRL_MD, 0, (void *)(md)) 207 208 #define EVP_PKEY_CTRL_RSA_PADDING (EVP_PKEY_ALG_CTRL + 1) 209 #define EVP_PKEY_CTRL_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 2) 210 211 #define EVP_PKEY_CTRL_RSA_KEYGEN_BITS (EVP_PKEY_ALG_CTRL + 3) 212 #define EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP (EVP_PKEY_ALG_CTRL + 4) 213 #define EVP_PKEY_CTRL_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 5) 214 215 #define EVP_PKEY_CTRL_GET_RSA_PADDING (EVP_PKEY_ALG_CTRL + 6) 216 #define EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 7) 217 #define EVP_PKEY_CTRL_GET_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 8) 218 219 #define EVP_PKEY_CTRL_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 9) 220 #define EVP_PKEY_CTRL_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 10) 221 222 #define EVP_PKEY_CTRL_GET_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 11) 223 #define EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 12) 224 225 #define RSA_PKCS1_PADDING 1 226 #define RSA_SSLV23_PADDING 2 227 #define RSA_NO_PADDING 3 228 #define RSA_PKCS1_OAEP_PADDING 4 229 #define RSA_X931_PADDING 5 230 /* EVP_PKEY_ only */ 231 #define RSA_PKCS1_PSS_PADDING 6 232 233 #define RSA_PKCS1_PADDING_SIZE 11 234 235 #define RSA_set_app_data(s,arg) RSA_set_ex_data(s,0,arg) 236 #define RSA_get_app_data(s) RSA_get_ex_data(s,0) 237 238 RSA *RSA_new(void); 239 RSA *RSA_new_method(ENGINE *engine); 240 int RSA_bits(const RSA *rsa); 241 int RSA_size(const RSA *rsa); 242 243 /* Deprecated version */ 244 #ifndef OPENSSL_NO_DEPRECATED 245 RSA *RSA_generate_key(int bits, unsigned long e, 246 void (*callback)(int, int, void *), void *cb_arg); 247 #endif /* !defined(OPENSSL_NO_DEPRECATED) */ 248 249 /* New version */ 250 int RSA_generate_key_ex(RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb); 251 252 int RSA_check_key(const RSA *); 253 /* next 4 return -1 on error */ 254 int RSA_public_encrypt(int flen, const unsigned char *from, 255 unsigned char *to, RSA *rsa, int padding); 256 int RSA_private_encrypt(int flen, const unsigned char *from, 257 unsigned char *to, RSA *rsa, int padding); 258 int RSA_public_decrypt(int flen, const unsigned char *from, 259 unsigned char *to, RSA *rsa, int padding); 260 int RSA_private_decrypt(int flen, const unsigned char *from, 261 unsigned char *to, RSA *rsa, int padding); 262 void RSA_free(RSA *r); 263 /* "up" the RSA object's reference count */ 264 int RSA_up_ref(RSA *r); 265 266 int RSA_flags(const RSA *r); 267 268 void RSA_set_default_method(const RSA_METHOD *meth); 269 const RSA_METHOD *RSA_get_default_method(void); 270 const RSA_METHOD *RSA_get_method(const RSA *rsa); 271 int RSA_set_method(RSA *rsa, const RSA_METHOD *meth); 272 273 const RSA_METHOD *RSA_PKCS1_OpenSSL(void); 274 const RSA_METHOD *RSA_PKCS1_SSLeay(void); 275 276 const RSA_METHOD *RSA_null_method(void); 277 278 int RSA_pkey_ctx_ctrl(EVP_PKEY_CTX *ctx, int optype, int cmd, int p1, void *p2); 279 280 RSA *d2i_RSAPublicKey(RSA **a, const unsigned char **in, long len); 281 int i2d_RSAPublicKey(const RSA *a, unsigned char **out); 282 extern const ASN1_ITEM RSAPublicKey_it; 283 RSA *d2i_RSAPrivateKey(RSA **a, const unsigned char **in, long len); 284 int i2d_RSAPrivateKey(const RSA *a, unsigned char **out); 285 extern const ASN1_ITEM RSAPrivateKey_it; 286 287 RSA_PSS_PARAMS *RSA_PSS_PARAMS_new(void); 288 void RSA_PSS_PARAMS_free(RSA_PSS_PARAMS *a); 289 RSA_PSS_PARAMS *d2i_RSA_PSS_PARAMS(RSA_PSS_PARAMS **a, const unsigned char **in, long len); 290 int i2d_RSA_PSS_PARAMS(RSA_PSS_PARAMS *a, unsigned char **out); 291 extern const ASN1_ITEM RSA_PSS_PARAMS_it; 292 293 RSA_OAEP_PARAMS *RSA_OAEP_PARAMS_new(void); 294 void RSA_OAEP_PARAMS_free(RSA_OAEP_PARAMS *a); 295 RSA_OAEP_PARAMS *d2i_RSA_OAEP_PARAMS(RSA_OAEP_PARAMS **a, const unsigned char **in, long len); 296 int i2d_RSA_OAEP_PARAMS(RSA_OAEP_PARAMS *a, unsigned char **out); 297 extern const ASN1_ITEM RSA_OAEP_PARAMS_it; 298 299 int RSA_print_fp(FILE *fp, const RSA *r, int offset); 300 301 #ifndef OPENSSL_NO_BIO 302 int RSA_print(BIO *bp, const RSA *r, int offset); 303 #endif 304 305 /* The following 2 functions sign and verify a X509_SIG ASN1 object 306 * inside PKCS#1 padded RSA encryption */ 307 int RSA_sign(int type, const unsigned char *m, unsigned int m_length, 308 unsigned char *sigret, unsigned int *siglen, RSA *rsa); 309 int RSA_verify(int type, const unsigned char *m, unsigned int m_length, 310 const unsigned char *sigbuf, unsigned int siglen, RSA *rsa); 311 312 /* The following 2 function sign and verify a ASN1_OCTET_STRING 313 * object inside PKCS#1 padded RSA encryption */ 314 int RSA_sign_ASN1_OCTET_STRING(int type, const unsigned char *m, 315 unsigned int m_length, unsigned char *sigret, unsigned int *siglen, 316 RSA *rsa); 317 int RSA_verify_ASN1_OCTET_STRING(int type, const unsigned char *m, 318 unsigned int m_length, unsigned char *sigbuf, unsigned int siglen, 319 RSA *rsa); 320 321 int RSA_blinding_on(RSA *rsa, BN_CTX *ctx); 322 void RSA_blinding_off(RSA *rsa); 323 BN_BLINDING *RSA_setup_blinding(RSA *rsa, BN_CTX *ctx); 324 325 int RSA_padding_add_PKCS1_type_1(unsigned char *to, int tlen, 326 const unsigned char *f, int fl); 327 int RSA_padding_check_PKCS1_type_1(unsigned char *to, int tlen, 328 const unsigned char *f, int fl, int rsa_len); 329 int RSA_padding_add_PKCS1_type_2(unsigned char *to, int tlen, 330 const unsigned char *f, int fl); 331 int RSA_padding_check_PKCS1_type_2(unsigned char *to, int tlen, 332 const unsigned char *f, int fl, int rsa_len); 333 int PKCS1_MGF1(unsigned char *mask, long len, 334 const unsigned char *seed, long seedlen, const EVP_MD *dgst); 335 int RSA_padding_add_PKCS1_OAEP(unsigned char *to, int tlen, 336 const unsigned char *f, int fl, 337 const unsigned char *p, int pl); 338 int RSA_padding_check_PKCS1_OAEP(unsigned char *to, int tlen, 339 const unsigned char *f, int fl, int rsa_len, 340 const unsigned char *p, int pl); 341 int RSA_padding_add_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, 342 const unsigned char *from, int flen, const unsigned char *param, int plen, 343 const EVP_MD *md, const EVP_MD *mgf1md); 344 int RSA_padding_check_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, 345 const unsigned char *from, int flen, int num, const unsigned char *param, 346 int plen, const EVP_MD *md, const EVP_MD *mgf1md); 347 int RSA_padding_add_none(unsigned char *to, int tlen, 348 const unsigned char *f, int fl); 349 int RSA_padding_check_none(unsigned char *to, int tlen, 350 const unsigned char *f, int fl, int rsa_len); 351 int RSA_padding_add_X931(unsigned char *to, int tlen, 352 const unsigned char *f, int fl); 353 int RSA_padding_check_X931(unsigned char *to, int tlen, 354 const unsigned char *f, int fl, int rsa_len); 355 int RSA_X931_hash_id(int nid); 356 357 int RSA_verify_PKCS1_PSS(RSA *rsa, const unsigned char *mHash, 358 const EVP_MD *Hash, const unsigned char *EM, int sLen); 359 int RSA_padding_add_PKCS1_PSS(RSA *rsa, unsigned char *EM, 360 const unsigned char *mHash, const EVP_MD *Hash, int sLen); 361 362 int RSA_verify_PKCS1_PSS_mgf1(RSA *rsa, const unsigned char *mHash, 363 const EVP_MD *Hash, const EVP_MD *mgf1Hash, const unsigned char *EM, 364 int sLen); 365 366 int RSA_padding_add_PKCS1_PSS_mgf1(RSA *rsa, unsigned char *EM, 367 const unsigned char *mHash, const EVP_MD *Hash, const EVP_MD *mgf1Hash, 368 int sLen); 369 370 int RSA_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func, 371 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func); 372 int RSA_set_ex_data(RSA *r, int idx, void *arg); 373 void *RSA_get_ex_data(const RSA *r, int idx); 374 375 int RSA_security_bits(const RSA *rsa); 376 377 void RSA_get0_key(const RSA *r, const BIGNUM **n, const BIGNUM **e, 378 const BIGNUM **d); 379 int RSA_set0_key(RSA *r, BIGNUM *n, BIGNUM *e, BIGNUM *d); 380 void RSA_get0_crt_params(const RSA *r, const BIGNUM **dmp1, const BIGNUM **dmq1, 381 const BIGNUM **iqmp); 382 int RSA_set0_crt_params(RSA *r, BIGNUM *dmp1, BIGNUM *dmq1, BIGNUM *iqmp); 383 void RSA_get0_factors(const RSA *r, const BIGNUM **p, const BIGNUM **q); 384 int RSA_set0_factors(RSA *r, BIGNUM *p, BIGNUM *q); 385 const BIGNUM *RSA_get0_n(const RSA *r); 386 const BIGNUM *RSA_get0_e(const RSA *r); 387 const BIGNUM *RSA_get0_d(const RSA *r); 388 const BIGNUM *RSA_get0_p(const RSA *r); 389 const BIGNUM *RSA_get0_q(const RSA *r); 390 const BIGNUM *RSA_get0_dmp1(const RSA *r); 391 const BIGNUM *RSA_get0_dmq1(const RSA *r); 392 const BIGNUM *RSA_get0_iqmp(const RSA *r); 393 const RSA_PSS_PARAMS *RSA_get0_pss_params(const RSA *r); 394 void RSA_clear_flags(RSA *r, int flags); 395 int RSA_test_flags(const RSA *r, int flags); 396 void RSA_set_flags(RSA *r, int flags); 397 398 RSA *RSAPublicKey_dup(RSA *rsa); 399 RSA *RSAPrivateKey_dup(RSA *rsa); 400 401 /* If this flag is set the RSA method is FIPS compliant and can be used 402 * in FIPS mode. This is set in the validated module method. If an 403 * application sets this flag in its own methods it is its responsibility 404 * to ensure the result is compliant. 405 */ 406 407 #define RSA_FLAG_FIPS_METHOD 0x0400 408 409 /* If this flag is set the operations normally disabled in FIPS mode are 410 * permitted it is then the applications responsibility to ensure that the 411 * usage is compliant. 412 */ 413 414 #define RSA_FLAG_NON_FIPS_ALLOW 0x0400 415 /* Application has decided PRNG is good enough to generate a key: don't 416 * check. 417 */ 418 #define RSA_FLAG_CHECKED 0x0800 419 420 RSA_METHOD *RSA_meth_new(const char *name, int flags); 421 void RSA_meth_free(RSA_METHOD *meth); 422 RSA_METHOD *RSA_meth_dup(const RSA_METHOD *meth); 423 int RSA_meth_set1_name(RSA_METHOD *meth, const char *name); 424 int RSA_meth_set_priv_enc(RSA_METHOD *meth, int (*priv_enc)(int flen, 425 const unsigned char *from, unsigned char *to, RSA *rsa, int padding)); 426 int RSA_meth_set_priv_dec(RSA_METHOD *meth, int (*priv_dec)(int flen, 427 const unsigned char *from, unsigned char *to, RSA *rsa, int padding)); 428 int (*RSA_meth_get_finish(const RSA_METHOD *meth))(RSA *rsa); 429 int RSA_meth_set_finish(RSA_METHOD *meth, int (*finish)(RSA *rsa)); 430 int RSA_meth_set_pub_enc(RSA_METHOD *meth, int (*pub_enc)(int flen, 431 const unsigned char *from, unsigned char *to, RSA *rsa, int padding)); 432 int RSA_meth_set_pub_dec(RSA_METHOD *meth, int (*pub_dec)(int flen, 433 const unsigned char *from, unsigned char *to, RSA *rsa, int padding)); 434 int RSA_meth_set_mod_exp(RSA_METHOD *meth, int (*mod_exp)(BIGNUM *r0, 435 const BIGNUM *i, RSA *rsa, BN_CTX *ctx)); 436 int RSA_meth_set_bn_mod_exp(RSA_METHOD *meth, int (*bn_mod_exp)(BIGNUM *r, 437 const BIGNUM *a, const BIGNUM *p, const BIGNUM *m, BN_CTX *ctx, 438 BN_MONT_CTX *m_ctx)); 439 int RSA_meth_set_init(RSA_METHOD *meth, int (*init)(RSA *rsa)); 440 int RSA_meth_set_keygen(RSA_METHOD *meth, int (*keygen)(RSA *rsa, int bits, 441 BIGNUM *e, BN_GENCB *cb)); 442 int RSA_meth_set_flags(RSA_METHOD *meth, int flags); 443 int RSA_meth_set0_app_data(RSA_METHOD *meth, void *app_data); 444 const char *RSA_meth_get0_name(const RSA_METHOD *); 445 int (*RSA_meth_get_pub_enc(const RSA_METHOD *meth))(int flen, 446 const unsigned char *from, unsigned char *to, RSA *rsa, int padding); 447 int (*RSA_meth_get_pub_dec(const RSA_METHOD *meth))(int flen, 448 const unsigned char *from, unsigned char *to, RSA *rsa, int padding); 449 int (*RSA_meth_get_priv_enc(const RSA_METHOD *meth))(int flen, 450 const unsigned char *from, unsigned char *to, RSA *rsa, int padding); 451 int (*RSA_meth_get_priv_dec(const RSA_METHOD *meth))(int flen, 452 const unsigned char *from, unsigned char *to, RSA *rsa, int padding); 453 int (*RSA_meth_get_mod_exp(const RSA_METHOD *meth))(BIGNUM *r0, const BIGNUM *i, 454 RSA *rsa, BN_CTX *ctx); 455 int (*RSA_meth_get_bn_mod_exp(const RSA_METHOD *meth))(BIGNUM *r, 456 const BIGNUM *a, const BIGNUM *p, const BIGNUM *m, BN_CTX *ctx, 457 BN_MONT_CTX *m_ctx); 458 int (*RSA_meth_get_init(const RSA_METHOD *meth))(RSA *rsa); 459 int (*RSA_meth_get_keygen(const RSA_METHOD *meth))(RSA *rsa, int bits, BIGNUM *e, 460 BN_GENCB *cb); 461 int RSA_meth_get_flags(const RSA_METHOD *meth); 462 void *RSA_meth_get0_app_data(const RSA_METHOD *meth); 463 int (*RSA_meth_get_sign(const RSA_METHOD *meth))(int type, 464 const unsigned char *m, unsigned int m_length, 465 unsigned char *sigret, unsigned int *siglen, 466 const RSA *rsa); 467 int RSA_meth_set_sign(RSA_METHOD *rsa, int (*sign)(int type, 468 const unsigned char *m, unsigned int m_length, unsigned char *sigret, 469 unsigned int *siglen, const RSA *rsa)); 470 int (*RSA_meth_get_verify(const RSA_METHOD *meth))(int dtype, 471 const unsigned char *m, unsigned int m_length, const unsigned char *sigbuf, 472 unsigned int siglen, const RSA *rsa); 473 int RSA_meth_set_verify(RSA_METHOD *rsa, int (*verify)(int dtype, 474 const unsigned char *m, unsigned int m_length, const unsigned char *sigbuf, 475 unsigned int siglen, const RSA *rsa)); 476 477 478 void ERR_load_RSA_strings(void); 479 480 /* Error codes for the RSA functions. */ 481 482 /* Function codes. */ 483 #define RSA_F_CHECK_PADDING_MD 140 484 #define RSA_F_DO_RSA_PRINT 146 485 #define RSA_F_INT_RSA_VERIFY 145 486 #define RSA_F_MEMORY_LOCK 100 487 #define RSA_F_OLD_RSA_PRIV_DECODE 147 488 #define RSA_F_PKEY_RSA_CTRL 143 489 #define RSA_F_PKEY_RSA_CTRL_STR 144 490 #define RSA_F_PKEY_RSA_SIGN 142 491 #define RSA_F_PKEY_RSA_VERIFY 154 492 #define RSA_F_PKEY_RSA_VERIFYRECOVER 141 493 #define RSA_F_RSA_BUILTIN_KEYGEN 129 494 #define RSA_F_RSA_CHECK_KEY 123 495 #define RSA_F_RSA_EAY_MOD_EXP 157 496 #define RSA_F_RSA_EAY_PRIVATE_DECRYPT 101 497 #define RSA_F_RSA_EAY_PRIVATE_ENCRYPT 102 498 #define RSA_F_RSA_EAY_PUBLIC_DECRYPT 103 499 #define RSA_F_RSA_EAY_PUBLIC_ENCRYPT 104 500 #define RSA_F_RSA_GENERATE_KEY 105 501 #define RSA_F_RSA_GENERATE_KEY_EX 155 502 #define RSA_F_RSA_ITEM_VERIFY 156 503 #define RSA_F_RSA_MEMORY_LOCK 130 504 #define RSA_F_RSA_NEW_METHOD 106 505 #define RSA_F_RSA_NULL 124 506 #define RSA_F_RSA_NULL_MOD_EXP 131 507 #define RSA_F_RSA_NULL_PRIVATE_DECRYPT 132 508 #define RSA_F_RSA_NULL_PRIVATE_ENCRYPT 133 509 #define RSA_F_RSA_NULL_PUBLIC_DECRYPT 134 510 #define RSA_F_RSA_NULL_PUBLIC_ENCRYPT 135 511 #define RSA_F_RSA_PADDING_ADD_NONE 107 512 #define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP 121 513 #define RSA_F_RSA_PADDING_ADD_PKCS1_PSS 125 514 #define RSA_F_RSA_PADDING_ADD_PKCS1_PSS_MGF1 148 515 #define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_1 108 516 #define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_2 109 517 #define RSA_F_RSA_PADDING_ADD_X931 127 518 #define RSA_F_RSA_PADDING_CHECK_NONE 111 519 #define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP 122 520 #define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_1 112 521 #define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_2 113 522 #define RSA_F_RSA_PADDING_CHECK_X931 128 523 #define RSA_F_RSA_PRINT 115 524 #define RSA_F_RSA_PRINT_FP 116 525 #define RSA_F_RSA_PRIVATE_DECRYPT 150 526 #define RSA_F_RSA_PRIVATE_ENCRYPT 151 527 #define RSA_F_RSA_PRIV_DECODE 137 528 #define RSA_F_RSA_PRIV_ENCODE 138 529 #define RSA_F_RSA_PUBLIC_DECRYPT 152 530 #define RSA_F_RSA_PUBLIC_ENCRYPT 153 531 #define RSA_F_RSA_PUB_DECODE 139 532 #define RSA_F_RSA_SETUP_BLINDING 136 533 #define RSA_F_RSA_SIGN 117 534 #define RSA_F_RSA_SIGN_ASN1_OCTET_STRING 118 535 #define RSA_F_RSA_VERIFY 119 536 #define RSA_F_RSA_VERIFY_ASN1_OCTET_STRING 120 537 #define RSA_F_RSA_VERIFY_PKCS1_PSS 126 538 #define RSA_F_RSA_VERIFY_PKCS1_PSS_MGF1 149 539 540 /* Reason codes. */ 541 #define RSA_R_ALGORITHM_MISMATCH 100 542 #define RSA_R_BAD_E_VALUE 101 543 #define RSA_R_BAD_FIXED_HEADER_DECRYPT 102 544 #define RSA_R_BAD_PAD_BYTE_COUNT 103 545 #define RSA_R_BAD_SIGNATURE 104 546 #define RSA_R_BLOCK_TYPE_IS_NOT_01 106 547 #define RSA_R_BLOCK_TYPE_IS_NOT_02 107 548 #define RSA_R_DATA_GREATER_THAN_MOD_LEN 108 549 #define RSA_R_DATA_TOO_LARGE 109 550 #define RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE 110 551 #define RSA_R_DATA_TOO_LARGE_FOR_MODULUS 132 552 #define RSA_R_DATA_TOO_SMALL 111 553 #define RSA_R_DATA_TOO_SMALL_FOR_KEY_SIZE 122 554 #define RSA_R_DIGEST_DOES_NOT_MATCH 158 555 #define RSA_R_DIGEST_NOT_ALLOWED 145 556 #define RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY 112 557 #define RSA_R_DMP1_NOT_CONGRUENT_TO_D 124 558 #define RSA_R_DMQ1_NOT_CONGRUENT_TO_D 125 559 #define RSA_R_D_E_NOT_CONGRUENT_TO_1 123 560 #define RSA_R_FIRST_OCTET_INVALID 133 561 #define RSA_R_ILLEGAL_OR_UNSUPPORTED_PADDING_MODE 144 562 #define RSA_R_INVALID_DIGEST 157 563 #define RSA_R_INVALID_DIGEST_LENGTH 143 564 #define RSA_R_INVALID_HEADER 137 565 #define RSA_R_INVALID_KEYBITS 145 566 #define RSA_R_INVALID_LABEL 160 567 #define RSA_R_INVALID_MESSAGE_LENGTH 131 568 #define RSA_R_INVALID_MGF1_MD 156 569 #define RSA_R_INVALID_OAEP_PARAMETERS 161 570 #define RSA_R_INVALID_PADDING 138 571 #define RSA_R_INVALID_PADDING_MODE 141 572 #define RSA_R_INVALID_PSS_PARAMETERS 149 573 #define RSA_R_INVALID_PSS_SALTLEN 146 574 #define RSA_R_INVALID_SALT_LENGTH 150 575 #define RSA_R_INVALID_TRAILER 139 576 #define RSA_R_INVALID_X931_DIGEST 142 577 #define RSA_R_IQMP_NOT_INVERSE_OF_Q 126 578 #define RSA_R_KEY_SIZE_TOO_SMALL 120 579 #define RSA_R_LAST_OCTET_INVALID 134 580 #define RSA_R_MODULUS_TOO_LARGE 105 581 #define RSA_R_MGF1_DIGEST_NOT_ALLOWED 152 582 #define RSA_R_NON_FIPS_RSA_METHOD 157 583 #define RSA_R_NO_PUBLIC_EXPONENT 140 584 #define RSA_R_NULL_BEFORE_BLOCK_MISSING 113 585 #define RSA_R_N_DOES_NOT_EQUAL_P_Q 127 586 #define RSA_R_OAEP_DECODING_ERROR 121 587 #define RSA_R_OPERATION_NOT_ALLOWED_IN_FIPS_MODE 158 588 #define RSA_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE 148 589 #define RSA_R_PADDING_CHECK_FAILED 114 590 #define RSA_R_PSS_SALTLEN_TOO_SMALL 164 591 #define RSA_R_P_NOT_PRIME 128 592 #define RSA_R_Q_NOT_PRIME 129 593 #define RSA_R_RSA_OPERATIONS_NOT_SUPPORTED 130 594 #define RSA_R_SLEN_CHECK_FAILED 136 595 #define RSA_R_SLEN_RECOVERY_FAILED 135 596 #define RSA_R_SSLV3_ROLLBACK_ATTACK 115 597 #define RSA_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 116 598 #define RSA_R_UNKNOWN_ALGORITHM_TYPE 117 599 #define RSA_R_UNKNOWN_DIGEST 166 600 #define RSA_R_UNKNOWN_MASK_DIGEST 151 601 #define RSA_R_UNKNOWN_PADDING_TYPE 118 602 #define RSA_R_UNKNOWN_PSS_DIGEST 152 603 #define RSA_R_UNSUPPORTED_ENCRYPTION_TYPE 162 604 #define RSA_R_UNSUPPORTED_LABEL_SOURCE 163 605 #define RSA_R_UNSUPPORTED_MASK_ALGORITHM 153 606 #define RSA_R_UNSUPPORTED_MASK_PARAMETER 154 607 #define RSA_R_UNSUPPORTED_SIGNATURE_TYPE 155 608 #define RSA_R_VALUE_MISSING 147 609 #define RSA_R_WRONG_SIGNATURE_LENGTH 119 610 611 #ifdef __cplusplus 612 } 613 #endif 614 #endif 615