1 /* ====================================================================
2 * Copyright (c) 2003 The OpenSSL Project. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
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
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/)"
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.
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.
30 * 6. Redistributions of any form whatsoever must retain the following
32 * "This product includes software developed by the OpenSSL Project
33 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
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.
50 #include <openssl/opensslconf.h>
53 #error FIPS is disabled.
67 struct evp_cipher_ctx_st;
69 int FIPS_mode_set(int onoff);
71 const void *FIPS_rand_check(void);
72 int FIPS_selftest(void);
73 int FIPS_selftest_failed(void);
74 void FIPS_selftest_check(void);
75 void FIPS_corrupt_sha1(void);
76 int FIPS_selftest_sha1(void);
77 void FIPS_corrupt_aes(void);
78 int FIPS_selftest_aes_gcm(void);
79 void FIPS_corrupt_aes_gcm(void);
80 int FIPS_selftest_aes(void);
81 void FIPS_corrupt_des(void);
82 int FIPS_selftest_des(void);
83 void FIPS_corrupt_rsa(void);
84 void FIPS_corrupt_rsa_keygen(void);
85 int FIPS_selftest_rsa(void);
86 void FIPS_corrupt_dsa(void);
87 void FIPS_corrupt_dsa_keygen(void);
88 int FIPS_selftest_dsa(void);
89 int FIPS_selftest_ecdsa(void);
90 void FIPS_corrupt_ecdsa(void);
91 void FIPS_corrupt_ec_keygen(void);
92 void FIPS_corrupt_x931(void);
93 void FIPS_corrupt_drbg(void);
94 void FIPS_x931_stick(void);
95 void FIPS_drbg_stick(void);
96 int FIPS_selftest_x931(void);
97 int FIPS_selftest_hmac(void);
98 int FIPS_selftest_drbg(void);
99 int FIPS_selftest_cmac(void);
101 unsigned int FIPS_incore_fingerprint(unsigned char *sig,unsigned int len);
102 int FIPS_check_incore_fingerprint(void);
104 void fips_set_selftest_fail(void);
105 int fips_check_rsa(struct rsa_st *rsa);
107 void FIPS_set_locking_callbacks(void (*func)(int mode, int type,
108 const char *file,int line),
109 int (*add_cb)(int *pointer, int amount,
110 int type, const char *file, int line));
112 void FIPS_set_malloc_callbacks(
113 void *(*malloc_cb)(int num, const char *file, int line),
114 void (*free_cb)(void *));
116 void FIPS_get_timevec(unsigned char *buf, unsigned long *pctr);
118 /* POST callback operation value: */
119 /* All tests started */
120 #define FIPS_POST_BEGIN 1
121 /* All tests end: result in id */
122 #define FIPS_POST_END 2
123 /* One individual test started */
124 #define FIPS_POST_STARTED 3
125 /* Individual test success */
126 #define FIPS_POST_SUCCESS 4
127 /* Individual test failure */
128 #define FIPS_POST_FAIL 5
129 /* Induce failure in test if zero return */
130 #define FIPS_POST_CORRUPT 6
133 /* HMAC integrity test */
134 #define FIPS_TEST_INTEGRITY 1
136 #define FIPS_TEST_DIGEST 2
137 /* Symmetric cipher test */
138 #define FIPS_TEST_CIPHER 3
139 /* Public key signature test */
140 #define FIPS_TEST_SIGNATURE 4
142 #define FIPS_TEST_HMAC 5
144 #define FIPS_TEST_CMAC 6
146 #define FIPS_TEST_GCM 7
148 #define FIPS_TEST_CCM 8
150 #define FIPS_TEST_XTS 9
152 #define FIPS_TEST_X931 10
154 #define FIPS_TEST_DRBG 11
155 /* Keygen pairwise consistency test */
156 #define FIPS_TEST_PAIRWISE 12
157 /* Continuous PRNG test */
158 #define FIPS_TEST_CONTINUOUS 13
160 void FIPS_post_set_callback(
161 int (*post_cb)(int op, int id, int subid, void *ex));
163 #define FIPS_ERROR_IGNORED(alg) OpenSSLDie(__FILE__, __LINE__, \
164 alg " previous FIPS forbidden algorithm error ignored");
166 int fips_pkey_signature_test(int id, struct evp_pkey_st *pkey,
167 const unsigned char *tbs, size_t tbslen,
168 const unsigned char *kat, size_t katlen,
169 const struct env_md_st *digest, int pad_mode,
170 const char *fail_str);
172 int fips_cipher_test(int id, struct evp_cipher_ctx_st *ctx,
173 const struct evp_cipher_st *cipher,
174 const unsigned char *key,
175 const unsigned char *iv,
176 const unsigned char *plaintext,
177 const unsigned char *ciphertext,
180 /* Where necessary redirect standard OpenSSL APIs to FIPS versions */
182 #if defined(OPENSSL_FIPSCANISTER) && defined(OPENSSL_FIPSAPI)
184 #define CRYPTO_lock FIPS_lock
185 #define CRYPTO_add_lock FIPS_add_lock
186 #define CRYPTO_malloc FIPS_malloc
187 #define CRYPTO_free FIPS_free
189 #define ERR_put_error FIPS_put_error
190 #define ERR_add_error_data FIPS_add_error_data
192 #define EVP_MD_CTX_init FIPS_md_ctx_init
193 #define EVP_MD_CTX_cleanup FIPS_md_ctx_cleanup
194 #define EVP_MD_CTX_create FIPS_md_ctx_create
195 #define EVP_MD_CTX_destroy FIPS_md_ctx_destroy
196 #define EVP_DigestInit_ex(ctx, type, impl) FIPS_digestinit(ctx, type)
197 #define EVP_DigestInit FIPS_digestinit
198 #define EVP_DigestUpdate FIPS_digestupdate
199 #define EVP_Digest(data, count, md, size, type, impl) \
200 FIPS_digest(data, count, md, size, type)
201 #define EVP_DigestFinal_ex FIPS_digestfinal
202 #define EVP_MD_CTX_copy_ex FIPS_md_ctx_copy
204 #define EVP_CipherInit_ex(ctx, cipher, impl, key, iv, enc) \
205 FIPS_cipherinit(ctx, cipher, key, iv, enc)
207 #define EVP_CipherInit FIPS_cipherinit
209 #define EVP_CIPHER_CTX_init FIPS_cipher_ctx_init
210 #define EVP_CIPHER_CTX_cleanup FIPS_cipher_ctx_cleanup
211 #define EVP_Cipher FIPS_cipher
212 #define EVP_CIPHER_CTX_ctrl FIPS_cipher_ctx_ctrl
213 #define EVP_CIPHER_CTX_new FIPS_cipher_ctx_new
214 #define EVP_CIPHER_CTX_free FIPS_cipher_ctx_free
215 #define EVP_CIPHER_CTX_copy FIPS_cipher_ctx_copy
216 #define EVP_CIPHER_CTX_set_key_length FIPS_cipher_ctx_set_key_length
218 #define DSA_SIG_new FIPS_dsa_sig_new
219 #define DSA_SIG_free FIPS_dsa_sig_free
221 #define ECDSA_SIG_new FIPS_ecdsa_sig_new
222 #define ECDSA_SIG_free FIPS_ecdsa_sig_free
224 #define ecdsa_check fips_ecdsa_check
225 #define ecdh_check fips_ecdh_check
227 #define RAND_bytes FIPS_rand_bytes
228 #define RAND_pseudo_bytes FIPS_rand_pseudo_bytes
229 #define RAND_add FIPS_rand_add
230 #define RAND_seed FIPS_rand_seed
231 #define RAND_status FIPS_rand_status
235 /* BEGIN ERROR CODES */
236 /* The following lines are auto generated by the script mkerr.pl. Any changes
237 * made after this point may be overwritten when the script is next run.
239 void ERR_load_FIPS_strings(void);
241 /* Error codes for the FIPS functions. */
243 /* Function codes. */
244 #define FIPS_F_DH_BUILTIN_GENPARAMS 100
245 #define FIPS_F_DSA_BUILTIN_PARAMGEN 101
246 #define FIPS_F_DSA_BUILTIN_PARAMGEN2 102
247 #define FIPS_F_DSA_DO_SIGN 103
248 #define FIPS_F_DSA_DO_VERIFY 104
249 #define FIPS_F_FIPS_CHECK_DSA 105
250 #define FIPS_F_FIPS_CHECK_EC 106
251 #define FIPS_F_FIPS_CHECK_INCORE_FINGERPRINT 107
252 #define FIPS_F_FIPS_CHECK_RSA 108
253 #define FIPS_F_FIPS_CIPHERINIT 109
254 #define FIPS_F_FIPS_DIGESTINIT 110
255 #define FIPS_F_FIPS_DRBG_BYTES 111
256 #define FIPS_F_FIPS_DRBG_CPRNG_TEST 112
257 #define FIPS_F_FIPS_DRBG_GENERATE 113
258 #define FIPS_F_FIPS_DRBG_HEALTH_CHECK 114
259 #define FIPS_F_FIPS_DRBG_INIT 115
260 #define FIPS_F_FIPS_DRBG_INSTANTIATE 116
261 #define FIPS_F_FIPS_DRBG_NEW 117
262 #define FIPS_F_FIPS_DRBG_RESEED 118
263 #define FIPS_F_FIPS_DRBG_SINGLE_KAT 119
264 #define FIPS_F_FIPS_MODE_SET 120
265 #define FIPS_F_FIPS_PKEY_SIGNATURE_TEST 121
266 #define FIPS_F_FIPS_RAND_ADD 122
267 #define FIPS_F_FIPS_RAND_BYTES 123
268 #define FIPS_F_FIPS_RAND_PSEUDO_BYTES 124
269 #define FIPS_F_FIPS_RAND_SEED 125
270 #define FIPS_F_FIPS_RAND_SET_METHOD 126
271 #define FIPS_F_FIPS_RAND_STATUS 127
272 #define FIPS_F_FIPS_SELFTEST_AES 128
273 #define FIPS_F_FIPS_SELFTEST_AES_GCM 129
274 #define FIPS_F_FIPS_SELFTEST_CMAC 130
275 #define FIPS_F_FIPS_SELFTEST_DES 131
276 #define FIPS_F_FIPS_SELFTEST_DSA 132
277 #define FIPS_F_FIPS_SELFTEST_ECDSA 133
278 #define FIPS_F_FIPS_SELFTEST_HMAC 134
279 #define FIPS_F_FIPS_SELFTEST_SHA1 135
280 #define FIPS_F_FIPS_SELFTEST_X931 136
281 #define FIPS_F_HASH_FINAL 137
282 #define FIPS_F_RSA_BUILTIN_KEYGEN 138
283 #define FIPS_F_RSA_EAY_PRIVATE_DECRYPT 139
284 #define FIPS_F_RSA_EAY_PRIVATE_ENCRYPT 140
285 #define FIPS_F_RSA_EAY_PUBLIC_DECRYPT 141
286 #define FIPS_F_RSA_EAY_PUBLIC_ENCRYPT 142
287 #define FIPS_F_RSA_X931_GENERATE_KEY_EX 143
290 #define FIPS_R_ADDITIONAL_INPUT_TOO_LONG 100
291 #define FIPS_R_ALREADY_INSTANTIATED 101
292 #define FIPS_R_CONTRADICTING_EVIDENCE 102
293 #define FIPS_R_DRBG_STUCK 103
294 #define FIPS_R_ENTROPY_ERROR_UNDETECTED 104
295 #define FIPS_R_ENTROPY_NOT_REQUESTED_FOR_RESEED 105
296 #define FIPS_R_ERROR_INITIALISING_DRBG 106
297 #define FIPS_R_ERROR_INSTANTIATING_DRBG 107
298 #define FIPS_R_ERROR_RETRIEVING_ADDITIONAL_INPUT 108
299 #define FIPS_R_ERROR_RETRIEVING_ENTROPY 109
300 #define FIPS_R_ERROR_RETRIEVING_NONCE 110
301 #define FIPS_R_FINGERPRINT_DOES_NOT_MATCH 111
302 #define FIPS_R_FINGERPRINT_DOES_NOT_MATCH_NONPIC_RELOCATED 112
303 #define FIPS_R_FINGERPRINT_DOES_NOT_MATCH_SEGMENT_ALIASING 113
304 #define FIPS_R_FIPS_MODE_ALREADY_SET 114
305 #define FIPS_R_FIPS_SELFTEST_FAILED 115
306 #define FIPS_R_FUNCTION_ERROR 116
307 #define FIPS_R_GENERATE_ERROR 117
308 #define FIPS_R_GENERATE_ERROR_UNDETECTED 118
309 #define FIPS_R_INSTANTIATE_ERROR 119
310 #define FIPS_R_INSUFFICIENT_SECURITY_STRENGTH 120
311 #define FIPS_R_INTERNAL_ERROR 121
312 #define FIPS_R_INVALID_KEY_LENGTH 122
313 #define FIPS_R_IN_ERROR_STATE 123
314 #define FIPS_R_KEY_TOO_SHORT 124
315 #define FIPS_R_NON_FIPS_METHOD 125
316 #define FIPS_R_NOT_INSTANTIATED 126
317 #define FIPS_R_PAIRWISE_TEST_FAILED 127
318 #define FIPS_R_PERSONALISATION_ERROR_UNDETECTED 128
319 #define FIPS_R_PERSONALISATION_STRING_TOO_LONG 129
320 #define FIPS_R_REQUEST_LENGTH_ERROR_UNDETECTED 130
321 #define FIPS_R_REQUEST_TOO_LARGE_FOR_DRBG 131
322 #define FIPS_R_RESEED_COUNTER_ERROR 132
323 #define FIPS_R_RESEED_ERROR 133
324 #define FIPS_R_SELFTEST_FAILED 134
325 #define FIPS_R_SELFTEST_FAILURE 135
326 #define FIPS_R_STRENGTH_ERROR_UNDETECTED 136
327 #define FIPS_R_TEST_FAILURE 137
328 #define FIPS_R_UNINSTANTIATE_ERROR 141
329 #define FIPS_R_UNINSTANTIATE_ZEROISE_ERROR 138
330 #define FIPS_R_UNSUPPORTED_DRBG_TYPE 139
331 #define FIPS_R_UNSUPPORTED_PLATFORM 140