fips/fips.h

   1 /* ====================================================================
   2  * Copyright (c) 2003 The OpenSSL Project.  All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  *
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  *
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in
  13  *    the documentation and/or other materials provided with the
  14  *    distribution.
  15  *
  16  * 3. All advertising materials mentioning features or use of this
  17  *    software must display the following acknowledgment:
  18  *    "This product includes software developed by the OpenSSL Project
  19  *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
  20  *
  21  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  22  *    endorse or promote products derived from this software without
  23  *    prior written permission. For written permission, please contact
  24  *    openssl-core@openssl.org.
  25  *
  26  * 5. Products derived from this software may not be called "OpenSSL"
  27  *    nor may "OpenSSL" appear in their names without prior written
  28  *    permission of the OpenSSL Project.
  29  *
  30  * 6. Redistributions of any form whatsoever must retain the following
  31  *    acknowledgment:
  32  *    "This product includes software developed by the OpenSSL Project
  33  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
  34  *
  35  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  36  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  37  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  38  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
  39  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  41  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  42  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  43  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  44  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  45  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  46  * OF THE POSSIBILITY OF SUCH DAMAGE.
  47  *
  48  */
  49
  50 #include <openssl/opensslconf.h>
  51
  52 #ifndef OPENSSL_FIPS
  53 # error FIPS is disabled.
  54 #endif
  55
  56 #ifdef OPENSSL_FIPS
  57
  58 #ifdef  __cplusplus
  59 extern "C" {
  60 #endif
  61
  62 struct dsa_st;
  63 struct evp_pkey_st;
  64 struct env_md_st;
  65 struct evp_cipher_st;
  66 struct evp_cipher_ctx_st;
  67
  68 int FIPS_mode_set(int onoff);
  69 int FIPS_mode(void);
  70 const void *FIPS_rand_check(void);
  71 int FIPS_selftest_failed(void);
  72 void FIPS_selftest_check(void);
  73 void FIPS_corrupt_sha1(void);
  74 int FIPS_selftest_sha1(void);
  75 void FIPS_corrupt_aes(void);
  76 int FIPS_selftest_aes(void);
  77 void FIPS_corrupt_des(void);
  78 int FIPS_selftest_des(void);
  79 void FIPS_corrupt_rsa(void);
  80 void FIPS_corrupt_rsa_keygen(void);
  81 int FIPS_selftest_rsa(void);
  82 void FIPS_corrupt_dsa(void);
  83 void FIPS_corrupt_dsa_keygen(void);
  84 int FIPS_selftest_dsa(void);
  85 void FIPS_corrupt_rng(void);
  86 void FIPS_rng_stick(void);
  87 int FIPS_selftest_rng(void);
  88 int FIPS_selftest_hmac(void);
  89
  90 int fips_pkey_signature_test(struct evp_pkey_st *pkey,
  91                              const unsigned char *tbs, int tbslen,
  92                              const unsigned char *kat, unsigned int katlen,
  93                              const struct env_md_st *digest,
  94                              unsigned int md_flags, const char *fail_str);
  95
  96 int fips_cipher_test(struct evp_cipher_ctx_st *ctx,
  97                      const struct evp_cipher_st *cipher,
  98                      const unsigned char *key,
  99                      const unsigned char *iv,
 100                      const unsigned char *plaintext,
 101                      const unsigned char *ciphertext, int len);
 102
 103 /* BEGIN ERROR CODES */
 104 /*
 105  * The following lines are auto generated by the script mkerr.pl. Any changes
 106  * made after this point may be overwritten when the script is next run.
 107  */
 108 void ERR_load_FIPS_strings(void);
 109
 110 /* Error codes for the FIPS functions. */
 111
 112 /* Function codes. */
 113 # define FIPS_F_DH_BUILTIN_GENPARAMS                      100
 114 # define FIPS_F_DSA_BUILTIN_PARAMGEN                      101
 115 # define FIPS_F_DSA_DO_SIGN                               102
 116 # define FIPS_F_DSA_DO_VERIFY                             103
 117 # define FIPS_F_EVP_CIPHERINIT_EX                         124
 118 # define FIPS_F_EVP_DIGESTINIT_EX                         125
 119 # define FIPS_F_FIPS_CHECK_DSA                            104
 120 # define FIPS_F_FIPS_CHECK_INCORE_FINGERPRINT             105
 121 # define FIPS_F_FIPS_CHECK_RSA                            106
 122 # define FIPS_F_FIPS_DSA_CHECK                            107
 123 # define FIPS_F_FIPS_MODE_SET                             108
 124 # define FIPS_F_FIPS_PKEY_SIGNATURE_TEST                  109
 125 # define FIPS_F_FIPS_SELFTEST_AES                         110
 126 # define FIPS_F_FIPS_SELFTEST_DES                         111
 127 # define FIPS_F_FIPS_SELFTEST_DSA                         112
 128 # define FIPS_F_FIPS_SELFTEST_HMAC                        113
 129 # define FIPS_F_FIPS_SELFTEST_RNG                         114
 130 # define FIPS_F_FIPS_SELFTEST_SHA1                        115
 131 # define FIPS_F_HASH_FINAL                                123
 132 # define FIPS_F_RSA_BUILTIN_KEYGEN                        116
 133 # define FIPS_F_RSA_EAY_PRIVATE_DECRYPT                   117
 134 # define FIPS_F_RSA_EAY_PRIVATE_ENCRYPT                   118
 135 # define FIPS_F_RSA_EAY_PUBLIC_DECRYPT                    119
 136 # define FIPS_F_RSA_EAY_PUBLIC_ENCRYPT                    120
 137 # define FIPS_F_RSA_X931_GENERATE_KEY_EX                  121
 138 # define FIPS_F_SSLEAY_RAND_BYTES                         122
 139
 140 /* Reason codes. */
 141 # define FIPS_R_CANNOT_READ_EXE                           103
 142 # define FIPS_R_CANNOT_READ_EXE_DIGEST                    104
 143 # define FIPS_R_CONTRADICTING_EVIDENCE                    114
 144 # define FIPS_R_EXE_DIGEST_DOES_NOT_MATCH                 105
 145 # define FIPS_R_FINGERPRINT_DOES_NOT_MATCH                110
 146 # define FIPS_R_FINGERPRINT_DOES_NOT_MATCH_NONPIC_RELOCATED 111
 147 # define FIPS_R_FINGERPRINT_DOES_NOT_MATCH_SEGMENT_ALIASING 112
 148 # define FIPS_R_FIPS_MODE_ALREADY_SET                     102
 149 # define FIPS_R_FIPS_SELFTEST_FAILED                      106
 150 # define FIPS_R_INVALID_KEY_LENGTH                        109
 151 # define FIPS_R_KEY_TOO_SHORT                             108
 152 # define FIPS_R_NON_FIPS_METHOD                           100
 153 # define FIPS_R_PAIRWISE_TEST_FAILED                      107
 154 # define FIPS_R_RSA_DECRYPT_ERROR                         115
 155 # define FIPS_R_RSA_ENCRYPT_ERROR                         116
 156 # define FIPS_R_SELFTEST_FAILED                           101
 157 # define FIPS_R_TEST_FAILURE                              117
 158 # define FIPS_R_UNSUPPORTED_PLATFORM                      113
 159
 160 #ifdef  __cplusplus
 161 }
 162 #endif
 163 #endif