Home | History | Annotate | Download | only in rsa
      1 /* Copyright (C) 1995-1998 Eric Young (eay (at) cryptsoft.com)
      2  * All rights reserved.
      3  *
      4  * This package is an SSL implementation written
      5  * by Eric Young (eay (at) cryptsoft.com).
      6  * The implementation was written so as to conform with Netscapes SSL.
      7  *
      8  * This library is free for commercial and non-commercial use as long as
      9  * the following conditions are aheared to.  The following conditions
     10  * apply to all code found in this distribution, be it the RC4, RSA,
     11  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
     12  * included with this distribution is covered by the same copyright terms
     13  * except that the holder is Tim Hudson (tjh (at) cryptsoft.com).
     14  *
     15  * Copyright remains Eric Young's, and as such any Copyright notices in
     16  * the code are not to be removed.
     17  * If this package is used in a product, Eric Young should be given attribution
     18  * as the author of the parts of the library used.
     19  * This can be in the form of a textual message at program startup or
     20  * in documentation (online or textual) provided with the package.
     21  *
     22  * Redistribution and use in source and binary forms, with or without
     23  * modification, are permitted provided that the following conditions
     24  * are met:
     25  * 1. Redistributions of source code must retain the copyright
     26  *    notice, this list of conditions and the following disclaimer.
     27  * 2. Redistributions in binary form must reproduce the above copyright
     28  *    notice, this list of conditions and the following disclaimer in the
     29  *    documentation and/or other materials provided with the distribution.
     30  * 3. All advertising materials mentioning features or use of this software
     31  *    must display the following acknowledgement:
     32  *    "This product includes cryptographic software written by
     33  *     Eric Young (eay (at) cryptsoft.com)"
     34  *    The word 'cryptographic' can be left out if the rouines from the library
     35  *    being used are not cryptographic related :-).
     36  * 4. If you include any Windows specific code (or a derivative thereof) from
     37  *    the apps directory (application code) you must include an acknowledgement:
     38  *    "This product includes software written by Tim Hudson (tjh (at) cryptsoft.com)"
     39  *
     40  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
     41  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     42  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     43  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
     44  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     45  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     46  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     47  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     48  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     49  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     50  * SUCH DAMAGE.
     51  *
     52  * The licence and distribution terms for any publically available version or
     53  * derivative of this code cannot be changed.  i.e. this code cannot simply be
     54  * copied and put under another distribution licence
     55  * [including the GNU Public Licence.] */
     56 
     57 #ifndef OPENSSL_HEADER_RSA_INTERNAL_H
     58 #define OPENSSL_HEADER_RSA_INTERNAL_H
     59 
     60 #include <openssl/base.h>
     61 
     62 #include <openssl/asn1.h>
     63 #include <openssl/thread.h>
     64 
     65 #if defined(__cplusplus)
     66 extern "C" {
     67 #endif
     68 
     69 
     70 #define RSA_PKCS1_PADDING_SIZE 11
     71 
     72 
     73 /* BN_BLINDING flags */
     74 #define BN_BLINDING_NO_UPDATE 0x00000001
     75 #define BN_BLINDING_NO_RECREATE 0x00000002
     76 
     77 BN_BLINDING *BN_BLINDING_new(const BIGNUM *A, const BIGNUM *Ai, BIGNUM *mod);
     78 void BN_BLINDING_free(BN_BLINDING *b);
     79 int BN_BLINDING_update(BN_BLINDING *b, BN_CTX *ctx);
     80 int BN_BLINDING_convert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx);
     81 int BN_BLINDING_invert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx);
     82 int BN_BLINDING_convert_ex(BIGNUM *n, BIGNUM *r, BN_BLINDING *b, BN_CTX *);
     83 int BN_BLINDING_invert_ex(BIGNUM *n, const BIGNUM *r, BN_BLINDING *b, BN_CTX *);
     84 CRYPTO_THREADID *BN_BLINDING_thread_id(BN_BLINDING *);
     85 unsigned long BN_BLINDING_get_flags(const BN_BLINDING *);
     86 void BN_BLINDING_set_flags(BN_BLINDING *, unsigned long);
     87 BN_BLINDING *BN_BLINDING_create_param(
     88     BN_BLINDING *b, const BIGNUM *e, BIGNUM *m, BN_CTX *ctx,
     89     int (*bn_mod_exp)(BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
     90                       const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx),
     91     BN_MONT_CTX *m_ctx);
     92 BN_BLINDING *rsa_setup_blinding(RSA *rsa, BN_CTX *in_ctx);
     93 
     94 
     95 int RSA_padding_add_PKCS1_type_1(uint8_t *to, unsigned to_len,
     96                                  const uint8_t *from, unsigned from_len);
     97 int RSA_padding_check_PKCS1_type_1(uint8_t *to, unsigned to_len,
     98                                    const uint8_t *from, unsigned from_len);
     99 int RSA_padding_add_PKCS1_type_2(uint8_t *to, unsigned to_len,
    100                                  const uint8_t *from, unsigned from_len);
    101 int RSA_padding_check_PKCS1_type_2(uint8_t *to, unsigned to_len,
    102                                    const uint8_t *from, unsigned from_len);
    103 int RSA_padding_add_PKCS1_OAEP_mgf1(uint8_t *to, unsigned to_len,
    104                                     const uint8_t *from, unsigned from_len,
    105                                     const uint8_t *param, unsigned plen,
    106                                     const EVP_MD *md, const EVP_MD *mgf1md);
    107 int RSA_padding_check_PKCS1_OAEP_mgf1(uint8_t *to, unsigned to_len,
    108                                       const uint8_t *from, unsigned from_len,
    109                                       const uint8_t *param, unsigned plen,
    110                                       const EVP_MD *md, const EVP_MD *mgf1md);
    111 int RSA_padding_add_none(uint8_t *to, unsigned to_len, const uint8_t *from,
    112                          unsigned from_len);
    113 int RSA_padding_check_none(uint8_t *to, unsigned to_len, const uint8_t *from,
    114                            unsigned from_len);
    115 
    116 /* RSA_verify_PKCS1_PSS_mgf1 */
    117 int RSA_verify_PKCS1_PSS_mgf1(RSA *rsa, const uint8_t *mHash,
    118                               const EVP_MD *Hash, const EVP_MD *mgf1Hash,
    119                               const uint8_t *EM, int sLen);
    120 
    121 int RSA_padding_add_PKCS1_PSS_mgf1(RSA *rsa, uint8_t *EM, const uint8_t *mHash,
    122                                    const EVP_MD *Hash, const EVP_MD *mgf1Hash,
    123                                    int sLen);
    124 
    125 /* RSA_private_transform calls either the method-specific |private_transform|
    126  * function (if given) or the generic one. See the comment for
    127  * |private_transform| in |rsa_meth_st|. */
    128 int RSA_private_transform(RSA *rsa, uint8_t *out, const uint8_t *in,
    129                           size_t len);
    130 
    131 typedef struct rsa_pss_params_st {
    132   X509_ALGOR *hashAlgorithm;
    133   X509_ALGOR *maskGenAlgorithm;
    134   ASN1_INTEGER *saltLength;
    135   ASN1_INTEGER *trailerField;
    136 } RSA_PSS_PARAMS;
    137 
    138 DECLARE_ASN1_FUNCTIONS(RSA_PSS_PARAMS)
    139 
    140 typedef struct rsa_oaep_params_st {
    141   X509_ALGOR *hashFunc;
    142   X509_ALGOR *maskGenFunc;
    143   X509_ALGOR *pSourceFunc;
    144 } RSA_OAEP_PARAMS;
    145 
    146 #if defined(__cplusplus)
    147 } /* extern C */
    148 #endif
    149 
    150 #endif /* OPENSSL_HEADER_RSA_INTERNAL_H */
    151