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