1/* $NetBSD: crypto.h,v 1.4 2023/06/19 21:41:44 christos Exp $ */ 2 3/* 4 * Copyright (c) 1997 - 2016 Kungliga Tekniska H��gskolan 5 * (Royal Institute of Technology, Stockholm, Sweden). 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 19 * 3. Neither the name of the Institute nor the names of its contributors 20 * may be used to endorse or promote products derived from this software 21 * without specific prior written permission. 22 * 23 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND 24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE 27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33 * SUCH DAMAGE. 34 */ 35 36#ifndef HEIMDAL_SMALLER 37#define DES3_OLD_ENCTYPE 1 38#endif 39 40struct _krb5_key_data { 41 krb5_keyblock *key; 42 krb5_data *schedule; 43}; 44 45struct _krb5_key_usage; 46 47struct krb5_crypto_data { 48 struct _krb5_encryption_type *et; 49 struct _krb5_key_data key; 50 int num_key_usage; 51 struct _krb5_key_usage *key_usage; 52}; 53 54#define CRYPTO_ETYPE(C) ((C)->et->type) 55 56/* bits for `flags' below */ 57#define F_KEYED 0x0001 /* checksum is keyed */ 58#define F_CPROOF 0x0002 /* checksum is collision proof */ 59#define F_DERIVED 0x0004 /* uses derived keys */ 60#define F_VARIANT 0x0008 /* uses `variant' keys (6.4.3) */ 61#define F_PSEUDO 0x0010 /* not a real protocol type */ 62#define F_DISABLED 0x0020 /* enctype/checksum disabled */ 63#define F_WEAK 0x0040 /* enctype is considered weak */ 64 65#define F_RFC3961_ENC 0x0100 /* RFC3961 simplified profile */ 66#define F_SPECIAL 0x0200 /* backwards */ 67#define F_ENC_THEN_CKSUM 0x0400 /* checksum is over encrypted data */ 68#define F_CRYPTO_MASK 0x0F00 69 70#define F_RFC3961_KDF 0x1000 /* RFC3961 KDF */ 71#define F_SP800_108_HMAC_KDF 0x2000 /* SP800-108 HMAC KDF */ 72#define F_KDF_MASK 0xF000 73 74struct salt_type { 75 krb5_salttype type; 76 const char *name; 77 krb5_error_code (*string_to_key)(krb5_context, krb5_enctype, krb5_data, 78 krb5_salt, krb5_data, krb5_keyblock*); 79}; 80 81struct _krb5_key_type { 82 krb5_enctype type; 83 const char *name; 84 size_t bits; 85 size_t size; 86 size_t schedule_size; 87 void (*random_key)(krb5_context, krb5_keyblock*); 88 void (*schedule)(krb5_context, struct _krb5_key_type *, struct _krb5_key_data *); 89 struct salt_type *string_to_key; 90 void (*random_to_key)(krb5_context, krb5_keyblock*, const void*, size_t); 91 void (*cleanup)(krb5_context, struct _krb5_key_data *); 92 const EVP_CIPHER *(*evp)(void); 93}; 94 95struct _krb5_checksum_type { 96 krb5_cksumtype type; 97 const char *name; 98 size_t blocksize; 99 size_t checksumsize; 100 unsigned flags; 101 krb5_error_code (*checksum)(krb5_context context, 102 struct _krb5_key_data *key, 103 const void *buf, size_t len, 104 unsigned usage, 105 Checksum *csum); 106 krb5_error_code (*verify)(krb5_context context, 107 struct _krb5_key_data *key, 108 const void *buf, size_t len, 109 unsigned usage, 110 Checksum *csum); 111}; 112 113struct _krb5_encryption_type { 114 krb5_enctype type; 115 const char *name; 116 const char *alias; 117 size_t blocksize; 118 size_t padsize; 119 size_t confoundersize; 120 struct _krb5_key_type *keytype; 121 struct _krb5_checksum_type *checksum; 122 struct _krb5_checksum_type *keyed_checksum; 123 unsigned flags; 124 krb5_error_code (*encrypt)(krb5_context context, 125 struct _krb5_key_data *key, 126 void *data, size_t len, 127 krb5_boolean encryptp, 128 int usage, 129 void *ivec); 130 size_t prf_length; 131 krb5_error_code (*prf)(krb5_context, 132 krb5_crypto, const krb5_data *, krb5_data *); 133}; 134 135#define ENCRYPTION_USAGE(U) ((int32_t)((((uint32_t)(U)) << 8)) | 0xAA) 136#define INTEGRITY_USAGE(U) ((int32_t)((((uint32_t)(U)) << 8)) | 0x55) 137#define CHECKSUM_USAGE(U) ((int32_t)((((uint32_t)(U)) << 8)) | 0x99) 138 139/* Checksums */ 140 141extern struct _krb5_checksum_type _krb5_checksum_none; 142extern struct _krb5_checksum_type _krb5_checksum_crc32; 143extern struct _krb5_checksum_type _krb5_checksum_rsa_md4; 144extern struct _krb5_checksum_type _krb5_checksum_rsa_md4_des; 145extern struct _krb5_checksum_type _krb5_checksum_rsa_md5_des; 146extern struct _krb5_checksum_type _krb5_checksum_rsa_md5_des3; 147extern struct _krb5_checksum_type _krb5_checksum_rsa_md5; 148extern struct _krb5_checksum_type _krb5_checksum_hmac_sha1_des3; 149extern struct _krb5_checksum_type _krb5_checksum_hmac_sha1_aes128; 150extern struct _krb5_checksum_type _krb5_checksum_hmac_sha1_aes256; 151extern struct _krb5_checksum_type _krb5_checksum_hmac_sha256_128_aes128; 152extern struct _krb5_checksum_type _krb5_checksum_hmac_sha384_192_aes256; 153extern struct _krb5_checksum_type _krb5_checksum_hmac_md5; 154extern struct _krb5_checksum_type _krb5_checksum_sha1; 155extern struct _krb5_checksum_type _krb5_checksum_sha2; 156 157extern struct _krb5_checksum_type *_krb5_checksum_types[]; 158extern int _krb5_num_checksums; 159 160/* Salts */ 161 162extern struct salt_type _krb5_AES_SHA1_salt[]; 163extern struct salt_type _krb5_AES_SHA2_salt[]; 164extern struct salt_type _krb5_arcfour_salt[]; 165extern struct salt_type _krb5_des_salt[]; 166extern struct salt_type _krb5_des3_salt[]; 167extern struct salt_type _krb5_des3_salt_derived[]; 168 169/* Encryption types */ 170 171extern struct _krb5_encryption_type _krb5_enctype_aes256_cts_hmac_sha1; 172extern struct _krb5_encryption_type _krb5_enctype_aes128_cts_hmac_sha1; 173extern struct _krb5_encryption_type _krb5_enctype_aes128_cts_hmac_sha256_128; 174extern struct _krb5_encryption_type _krb5_enctype_aes256_cts_hmac_sha384_192; 175extern struct _krb5_encryption_type _krb5_enctype_des3_cbc_sha1; 176extern struct _krb5_encryption_type _krb5_enctype_des3_cbc_md5; 177extern struct _krb5_encryption_type _krb5_enctype_des3_cbc_none; 178extern struct _krb5_encryption_type _krb5_enctype_arcfour_hmac_md5; 179extern struct _krb5_encryption_type _krb5_enctype_des_cbc_md5; 180extern struct _krb5_encryption_type _krb5_enctype_old_des3_cbc_sha1; 181extern struct _krb5_encryption_type _krb5_enctype_des_cbc_crc; 182extern struct _krb5_encryption_type _krb5_enctype_des_cbc_md4; 183extern struct _krb5_encryption_type _krb5_enctype_des_cbc_md5; 184extern struct _krb5_encryption_type _krb5_enctype_des_cbc_none; 185extern struct _krb5_encryption_type _krb5_enctype_des_cfb64_none; 186extern struct _krb5_encryption_type _krb5_enctype_des_pcbc_none; 187extern struct _krb5_encryption_type _krb5_enctype_null; 188 189extern struct _krb5_encryption_type *_krb5_etypes[]; 190extern int _krb5_num_etypes; 191 192/* NO_HCRYPTO_POLLUTION is defined in pkinit-ec.c. See commentary there. */ 193#ifndef NO_HCRYPTO_POLLUTION 194/* Interface to the EVP crypto layer provided by hcrypto */ 195struct _krb5_evp_schedule { 196 /* 197 * Normally we'd say EVP_CIPHER_CTX here, but! this header gets 198 * included in lib/krb5/pkinit-ec.ck 199 */ 200 EVP_CIPHER_CTX *ectx; 201 EVP_CIPHER_CTX *dctx; 202}; 203#endif 204