Home | History | Annotate | Line # | Download | only in krb5
      1 /*	$NetBSD: crypto.h,v 1.4 2023/06/19 21:41:44 christos Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1997 - 2016 Kungliga Tekniska Hgskolan
      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 
     40 struct _krb5_key_data {
     41     krb5_keyblock *key;
     42     krb5_data *schedule;
     43 };
     44 
     45 struct _krb5_key_usage;
     46 
     47 struct 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 
     74 struct 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 
     81 struct _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 
     95 struct _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 
    113 struct _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 
    141 extern struct _krb5_checksum_type _krb5_checksum_none;
    142 extern struct _krb5_checksum_type _krb5_checksum_crc32;
    143 extern struct _krb5_checksum_type _krb5_checksum_rsa_md4;
    144 extern struct _krb5_checksum_type _krb5_checksum_rsa_md4_des;
    145 extern struct _krb5_checksum_type _krb5_checksum_rsa_md5_des;
    146 extern struct _krb5_checksum_type _krb5_checksum_rsa_md5_des3;
    147 extern struct _krb5_checksum_type _krb5_checksum_rsa_md5;
    148 extern struct _krb5_checksum_type _krb5_checksum_hmac_sha1_des3;
    149 extern struct _krb5_checksum_type _krb5_checksum_hmac_sha1_aes128;
    150 extern struct _krb5_checksum_type _krb5_checksum_hmac_sha1_aes256;
    151 extern struct _krb5_checksum_type _krb5_checksum_hmac_sha256_128_aes128;
    152 extern struct _krb5_checksum_type _krb5_checksum_hmac_sha384_192_aes256;
    153 extern struct _krb5_checksum_type _krb5_checksum_hmac_md5;
    154 extern struct _krb5_checksum_type _krb5_checksum_sha1;
    155 extern struct _krb5_checksum_type _krb5_checksum_sha2;
    156 
    157 extern struct _krb5_checksum_type *_krb5_checksum_types[];
    158 extern int _krb5_num_checksums;
    159 
    160 /* Salts */
    161 
    162 extern struct salt_type _krb5_AES_SHA1_salt[];
    163 extern struct salt_type _krb5_AES_SHA2_salt[];
    164 extern struct salt_type _krb5_arcfour_salt[];
    165 extern struct salt_type _krb5_des_salt[];
    166 extern struct salt_type _krb5_des3_salt[];
    167 extern struct salt_type _krb5_des3_salt_derived[];
    168 
    169 /* Encryption types */
    170 
    171 extern struct _krb5_encryption_type _krb5_enctype_aes256_cts_hmac_sha1;
    172 extern struct _krb5_encryption_type _krb5_enctype_aes128_cts_hmac_sha1;
    173 extern struct _krb5_encryption_type _krb5_enctype_aes128_cts_hmac_sha256_128;
    174 extern struct _krb5_encryption_type _krb5_enctype_aes256_cts_hmac_sha384_192;
    175 extern struct _krb5_encryption_type _krb5_enctype_des3_cbc_sha1;
    176 extern struct _krb5_encryption_type _krb5_enctype_des3_cbc_md5;
    177 extern struct _krb5_encryption_type _krb5_enctype_des3_cbc_none;
    178 extern struct _krb5_encryption_type _krb5_enctype_arcfour_hmac_md5;
    179 extern struct _krb5_encryption_type _krb5_enctype_des_cbc_md5;
    180 extern struct _krb5_encryption_type _krb5_enctype_old_des3_cbc_sha1;
    181 extern struct _krb5_encryption_type _krb5_enctype_des_cbc_crc;
    182 extern struct _krb5_encryption_type _krb5_enctype_des_cbc_md4;
    183 extern struct _krb5_encryption_type _krb5_enctype_des_cbc_md5;
    184 extern struct _krb5_encryption_type _krb5_enctype_des_cbc_none;
    185 extern struct _krb5_encryption_type _krb5_enctype_des_cfb64_none;
    186 extern struct _krb5_encryption_type _krb5_enctype_des_pcbc_none;
    187 extern struct _krb5_encryption_type _krb5_enctype_null;
    188 
    189 extern struct _krb5_encryption_type *_krb5_etypes[];
    190 extern 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 */
    195 struct _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