1/*
2 * Copyright 2006-2017 The OpenSSL Project Authors. All Rights Reserved.
3 *
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
8 */
9
10#ifndef OSSL_CRYPTO_RSA_LOCAL_H
11#define OSSL_CRYPTO_RSA_LOCAL_H
12
13#include <openssl/rsa.h>
14#include "internal/refcount.h"
15
16#define RSA_MAX_PRIME_NUM 5
17#define RSA_MIN_MODULUS_BITS 512
18
19typedef struct rsa_prime_info_st {
20 BIGNUM *r;
21 BIGNUM *d;
22 BIGNUM *t;
23 /* save product of primes prior to this one */
24 BIGNUM *pp;
25 BN_MONT_CTX *m;
26} RSA_PRIME_INFO;
27
28DECLARE_ASN1_ITEM(RSA_PRIME_INFO)
29DEFINE_STACK_OF(RSA_PRIME_INFO)
30
31struct rsa_st {
32 /*
33 * The first parameter is used to pickup errors where this is passed
34 * instead of an EVP_PKEY, it is set to 0
35 */
36 int pad;
37 int32_t version;
38 const RSA_METHOD *meth;
39 /* functional reference if 'meth' is ENGINE-provided */
40 ENGINE *engine;
41 BIGNUM *n;
42 BIGNUM *e;
43 BIGNUM *d;
44 BIGNUM *p;
45 BIGNUM *q;
46 BIGNUM *dmp1;
47 BIGNUM *dmq1;
48 BIGNUM *iqmp;
49 /* for multi-prime RSA, defined in RFC 8017 */
50 STACK_OF(RSA_PRIME_INFO) *prime_infos;
51 /* If a PSS only key this contains the parameter restrictions */
52 RSA_PSS_PARAMS *pss;
53 /* be careful using this if the RSA structure is shared */
54 CRYPTO_EX_DATA ex_data;
55 CRYPTO_REF_COUNT references;
56 int flags;
57 /* Used to cache montgomery values */
58 BN_MONT_CTX *_method_mod_n;
59 BN_MONT_CTX *_method_mod_p;
60 BN_MONT_CTX *_method_mod_q;
61 /*
62 * all BIGNUM values are actually in the following data, if it is not
63 * NULL
64 */
65 char *bignum_data;
66 BN_BLINDING *blinding;
67 BN_BLINDING *mt_blinding;
68 CRYPTO_RWLOCK *lock;
69
70 int dirty_cnt;
71};
72
73struct rsa_meth_st {
74 char *name;
75 int (*rsa_pub_enc) (int flen, const unsigned char *from,
76 unsigned char *to, RSA *rsa, int padding);
77 int (*rsa_pub_dec) (int flen, const unsigned char *from,
78 unsigned char *to, RSA *rsa, int padding);
79 int (*rsa_priv_enc) (int flen, const unsigned char *from,
80 unsigned char *to, RSA *rsa, int padding);
81 int (*rsa_priv_dec) (int flen, const unsigned char *from,
82 unsigned char *to, RSA *rsa, int padding);
83 /* Can be null */
84 int (*rsa_mod_exp) (BIGNUM *r0, const BIGNUM *I, RSA *rsa, BN_CTX *ctx);
85 /* Can be null */
86 int (*bn_mod_exp) (BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
87 const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx);
88 /* called at new */
89 int (*init) (RSA *rsa);
90 /* called at free */
91 int (*finish) (RSA *rsa);
92 /* RSA_METHOD_FLAG_* things */
93 int flags;
94 /* may be needed! */
95 char *app_data;
96 /*
97 * New sign and verify functions: some libraries don't allow arbitrary
98 * data to be signed/verified: this allows them to be used. Note: for
99 * this to work the RSA_public_decrypt() and RSA_private_encrypt() should
100 * *NOT* be used RSA_sign(), RSA_verify() should be used instead.
101 */
102 int (*rsa_sign) (int type,
103 const unsigned char *m, unsigned int m_length,
104 unsigned char *sigret, unsigned int *siglen,
105 const RSA *rsa);
106 int (*rsa_verify) (int dtype, const unsigned char *m,
107 unsigned int m_length, const unsigned char *sigbuf,
108 unsigned int siglen, const RSA *rsa);
109 /*
110 * If this callback is NULL, the builtin software RSA key-gen will be
111 * used. This is for behavioural compatibility whilst the code gets
112 * rewired, but one day it would be nice to assume there are no such
113 * things as "builtin software" implementations.
114 */
115 int (*rsa_keygen) (RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb);
116 int (*rsa_multi_prime_keygen) (RSA *rsa, int bits, int primes,
117 BIGNUM *e, BN_GENCB *cb);
118};
119
120extern int int_rsa_verify(int dtype, const unsigned char *m,
121 unsigned int m_len, unsigned char *rm,
122 size_t *prm_len, const unsigned char *sigbuf,
123 size_t siglen, RSA *rsa);
124/* Macros to test if a pkey or ctx is for a PSS key */
125#define pkey_is_pss(pkey) (pkey->ameth->pkey_id == EVP_PKEY_RSA_PSS)
126#define pkey_ctx_is_pss(ctx) (ctx->pmeth->pkey_id == EVP_PKEY_RSA_PSS)
127
128RSA_PSS_PARAMS *rsa_pss_params_create(const EVP_MD *sigmd,
129 const EVP_MD *mgf1md, int saltlen);
130int rsa_pss_get_param(const RSA_PSS_PARAMS *pss, const EVP_MD **pmd,
131 const EVP_MD **pmgf1md, int *psaltlen);
132/* internal function to clear and free multi-prime parameters */
133void rsa_multip_info_free_ex(RSA_PRIME_INFO *pinfo);
134void rsa_multip_info_free(RSA_PRIME_INFO *pinfo);
135RSA_PRIME_INFO *rsa_multip_info_new(void);
136int rsa_multip_calc_product(RSA *rsa);
137int rsa_multip_cap(int bits);
138
139uint16_t rsa_compute_security_bits(int n);
140
141int rsa_sp800_56b_validate_strength(int nbits, int strength);
142int rsa_check_pminusq_diff(BIGNUM *diff, const BIGNUM *p, const BIGNUM *q,
143 int nbits);
144int rsa_get_lcm(BN_CTX *ctx, const BIGNUM *p, const BIGNUM *q,
145 BIGNUM *lcm, BIGNUM *gcd, BIGNUM *p1, BIGNUM *q1,
146 BIGNUM *p1q1);
147
148int rsa_check_public_exponent(const BIGNUM *e);
149int rsa_check_private_exponent(const RSA *rsa, int nbits, BN_CTX *ctx);
150int rsa_check_prime_factor(BIGNUM *p, BIGNUM *e, int nbits, BN_CTX *ctx);
151int rsa_check_prime_factor_range(const BIGNUM *p, int nbits, BN_CTX *ctx);
152int rsa_check_crt_components(const RSA *rsa, BN_CTX *ctx);
153
154int rsa_sp800_56b_pairwise_test(RSA *rsa, BN_CTX *ctx);
155int rsa_sp800_56b_check_public(const RSA *rsa);
156int rsa_sp800_56b_check_private(const RSA *rsa);
157int rsa_sp800_56b_check_keypair(const RSA *rsa, const BIGNUM *efixed,
158 int strength, int nbits);
159int rsa_sp800_56b_generate_key(RSA *rsa, int nbits, const BIGNUM *efixed,
160 BN_GENCB *cb);
161
162int rsa_sp800_56b_derive_params_from_pq(RSA *rsa, int nbits,
163 const BIGNUM *e, BN_CTX *ctx);
164int rsa_fips186_4_gen_prob_primes(RSA *rsa, BIGNUM *p1, BIGNUM *p2,
165 BIGNUM *Xpout, const BIGNUM *Xp,
166 const BIGNUM *Xp1, const BIGNUM *Xp2,
167 BIGNUM *q1, BIGNUM *q2, BIGNUM *Xqout,
168 const BIGNUM *Xq, const BIGNUM *Xq1,
169 const BIGNUM *Xq2, int nbits,
170 const BIGNUM *e, BN_CTX *ctx, BN_GENCB *cb);
171
172#endif /* OSSL_CRYPTO_RSA_LOCAL_H */
173