Move kadmin and ktutil to /usr/bin.
[heimdal.git] / lib / krb5 / crypto.c
blobb0c80dc8e3cf27b46e3b4f747003bd6935483771
1 /*
2 * Copyright (c) 1997 - 2008 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
4 * All rights reserved.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
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.
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.
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.
34 #include "krb5_locl.h"
36 struct _krb5_key_usage {
37 unsigned usage;
38 struct _krb5_key_data key;
42 #ifndef HEIMDAL_SMALLER
43 #define DES3_OLD_ENCTYPE 1
44 #endif
46 static krb5_error_code _get_derived_key(krb5_context, krb5_crypto,
47 unsigned, struct _krb5_key_data**);
48 static struct _krb5_key_data *_new_derived_key(krb5_crypto crypto, unsigned usage);
50 static void free_key_schedule(krb5_context,
51 struct _krb5_key_data *,
52 struct _krb5_encryption_type *);
54 /*
55 * Converts etype to a user readable string and sets as a side effect
56 * the krb5_error_message containing this string. Returns
57 * KRB5_PROG_ETYPE_NOSUPP in not the conversion of the etype failed in
58 * which case the error code of the etype convesion is returned.
61 static krb5_error_code
62 unsupported_enctype(krb5_context context, krb5_enctype etype)
64 krb5_error_code ret;
65 char *name;
67 ret = krb5_enctype_to_string(context, etype, &name);
68 if (ret)
69 return ret;
71 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
72 N_("Encryption type %s not supported", ""),
73 name);
74 free(name);
75 return KRB5_PROG_ETYPE_NOSUPP;
82 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
83 krb5_enctype_keysize(krb5_context context,
84 krb5_enctype type,
85 size_t *keysize)
87 struct _krb5_encryption_type *et = _krb5_find_enctype(type);
88 if(et == NULL) {
89 return unsupported_enctype (context, type);
91 *keysize = et->keytype->size;
92 return 0;
95 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
96 krb5_enctype_keybits(krb5_context context,
97 krb5_enctype type,
98 size_t *keybits)
100 struct _krb5_encryption_type *et = _krb5_find_enctype(type);
101 if(et == NULL) {
102 return unsupported_enctype (context, type);
104 *keybits = et->keytype->bits;
105 return 0;
108 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
109 krb5_generate_random_keyblock(krb5_context context,
110 krb5_enctype type,
111 krb5_keyblock *key)
113 krb5_error_code ret;
114 struct _krb5_encryption_type *et = _krb5_find_enctype(type);
115 if(et == NULL) {
116 return unsupported_enctype (context, type);
118 ret = krb5_data_alloc(&key->keyvalue, et->keytype->size);
119 if(ret)
120 return ret;
121 key->keytype = type;
122 if(et->keytype->random_key)
123 (*et->keytype->random_key)(context, key);
124 else
125 krb5_generate_random_block(key->keyvalue.data,
126 key->keyvalue.length);
127 return 0;
130 static krb5_error_code
131 _key_schedule(krb5_context context,
132 struct _krb5_key_data *key)
134 krb5_error_code ret;
135 struct _krb5_encryption_type *et = _krb5_find_enctype(key->key->keytype);
136 struct _krb5_key_type *kt;
138 if (et == NULL) {
139 return unsupported_enctype (context,
140 key->key->keytype);
143 kt = et->keytype;
145 if(kt->schedule == NULL)
146 return 0;
147 if (key->schedule != NULL)
148 return 0;
149 ALLOC(key->schedule, 1);
150 if (key->schedule == NULL)
151 return krb5_enomem(context);
152 ret = krb5_data_alloc(key->schedule, kt->schedule_size);
153 if(ret) {
154 free(key->schedule);
155 key->schedule = NULL;
156 return ret;
158 (*kt->schedule)(context, kt, key);
159 return 0;
162 /************************************************************
164 ************************************************************/
166 static krb5_error_code
167 SHA1_checksum(krb5_context context,
168 struct _krb5_key_data *key,
169 const void *data,
170 size_t len,
171 unsigned usage,
172 Checksum *C)
174 if (EVP_Digest(data, len, C->checksum.data, NULL, EVP_sha1(), NULL) != 1)
175 krb5_abortx(context, "sha1 checksum failed");
176 return 0;
179 /* HMAC according to RFC2104 */
180 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
181 _krb5_internal_hmac(krb5_context context,
182 struct _krb5_checksum_type *cm,
183 const void *data,
184 size_t len,
185 unsigned usage,
186 struct _krb5_key_data *keyblock,
187 Checksum *result)
189 unsigned char *ipad, *opad;
190 unsigned char *key;
191 size_t key_len;
192 size_t i;
194 ipad = malloc(cm->blocksize + len);
195 if (ipad == NULL)
196 return ENOMEM;
197 opad = malloc(cm->blocksize + cm->checksumsize);
198 if (opad == NULL) {
199 free(ipad);
200 return ENOMEM;
202 memset(ipad, 0x36, cm->blocksize);
203 memset(opad, 0x5c, cm->blocksize);
205 if(keyblock->key->keyvalue.length > cm->blocksize){
206 (*cm->checksum)(context,
207 keyblock,
208 keyblock->key->keyvalue.data,
209 keyblock->key->keyvalue.length,
210 usage,
211 result);
212 key = result->checksum.data;
213 key_len = result->checksum.length;
214 } else {
215 key = keyblock->key->keyvalue.data;
216 key_len = keyblock->key->keyvalue.length;
218 for(i = 0; i < key_len; i++){
219 ipad[i] ^= key[i];
220 opad[i] ^= key[i];
222 memcpy(ipad + cm->blocksize, data, len);
223 (*cm->checksum)(context, keyblock, ipad, cm->blocksize + len,
224 usage, result);
225 memcpy(opad + cm->blocksize, result->checksum.data,
226 result->checksum.length);
227 (*cm->checksum)(context, keyblock, opad,
228 cm->blocksize + cm->checksumsize, usage, result);
229 memset(ipad, 0, cm->blocksize + len);
230 free(ipad);
231 memset(opad, 0, cm->blocksize + cm->checksumsize);
232 free(opad);
234 return 0;
237 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
238 krb5_hmac(krb5_context context,
239 krb5_cksumtype cktype,
240 const void *data,
241 size_t len,
242 unsigned usage,
243 krb5_keyblock *key,
244 Checksum *result)
246 struct _krb5_checksum_type *c = _krb5_find_checksum(cktype);
247 struct _krb5_key_data kd;
248 krb5_error_code ret;
250 if (c == NULL) {
251 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
252 N_("checksum type %d not supported", ""),
253 cktype);
254 return KRB5_PROG_SUMTYPE_NOSUPP;
257 kd.key = key;
258 kd.schedule = NULL;
260 ret = _krb5_internal_hmac(context, c, data, len, usage, &kd, result);
262 if (kd.schedule)
263 krb5_free_data(context, kd.schedule);
265 return ret;
268 krb5_error_code
269 _krb5_SP_HMAC_SHA1_checksum(krb5_context context,
270 struct _krb5_key_data *key,
271 const void *data,
272 size_t len,
273 unsigned usage,
274 Checksum *result)
276 struct _krb5_checksum_type *c = _krb5_find_checksum(CKSUMTYPE_SHA1);
277 Checksum res;
278 char sha1_data[20];
279 krb5_error_code ret;
281 res.checksum.data = sha1_data;
282 res.checksum.length = sizeof(sha1_data);
284 ret = _krb5_internal_hmac(context, c, data, len, usage, key, &res);
285 if (ret)
286 krb5_abortx(context, "hmac failed");
287 memcpy(result->checksum.data, res.checksum.data, result->checksum.length);
288 return 0;
291 struct _krb5_checksum_type _krb5_checksum_sha1 = {
292 CKSUMTYPE_SHA1,
293 "sha1",
296 F_CPROOF,
297 SHA1_checksum,
298 NULL
301 KRB5_LIB_FUNCTION struct _krb5_checksum_type * KRB5_LIB_CALL
302 _krb5_find_checksum(krb5_cksumtype type)
304 int i;
305 for(i = 0; i < _krb5_num_checksums; i++)
306 if(_krb5_checksum_types[i]->type == type)
307 return _krb5_checksum_types[i];
308 return NULL;
311 static krb5_error_code
312 get_checksum_key(krb5_context context,
313 krb5_crypto crypto,
314 unsigned usage, /* not krb5_key_usage */
315 struct _krb5_checksum_type *ct,
316 struct _krb5_key_data **key)
318 krb5_error_code ret = 0;
320 if(ct->flags & F_DERIVED)
321 ret = _get_derived_key(context, crypto, usage, key);
322 else if(ct->flags & F_VARIANT) {
323 size_t i;
325 *key = _new_derived_key(crypto, 0xff/* KRB5_KU_RFC1510_VARIANT */);
326 if (*key == NULL)
327 return krb5_enomem(context);
328 ret = krb5_copy_keyblock(context, crypto->key.key, &(*key)->key);
329 if(ret)
330 return ret;
331 for(i = 0; i < (*key)->key->keyvalue.length; i++)
332 ((unsigned char*)(*key)->key->keyvalue.data)[i] ^= 0xF0;
333 } else {
334 *key = &crypto->key;
336 if(ret == 0)
337 ret = _key_schedule(context, *key);
338 return ret;
341 static krb5_error_code
342 create_checksum (krb5_context context,
343 struct _krb5_checksum_type *ct,
344 krb5_crypto crypto,
345 unsigned usage,
346 void *data,
347 size_t len,
348 Checksum *result)
350 krb5_error_code ret;
351 struct _krb5_key_data *dkey;
352 int keyed_checksum;
354 if (ct->flags & F_DISABLED) {
355 krb5_clear_error_message (context);
356 return KRB5_PROG_SUMTYPE_NOSUPP;
358 keyed_checksum = (ct->flags & F_KEYED) != 0;
359 if(keyed_checksum && crypto == NULL) {
360 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
361 N_("Checksum type %s is keyed but no "
362 "crypto context (key) was passed in", ""),
363 ct->name);
364 return KRB5_PROG_SUMTYPE_NOSUPP; /* XXX */
366 if(keyed_checksum) {
367 ret = get_checksum_key(context, crypto, usage, ct, &dkey);
368 if (ret)
369 return ret;
370 } else
371 dkey = NULL;
372 result->cksumtype = ct->type;
373 ret = krb5_data_alloc(&result->checksum, ct->checksumsize);
374 if (ret)
375 return (ret);
376 return (*ct->checksum)(context, dkey, data, len, usage, result);
379 static int
380 arcfour_checksum_p(struct _krb5_checksum_type *ct, krb5_crypto crypto)
382 return (ct->type == CKSUMTYPE_HMAC_MD5) &&
383 (crypto->key.key->keytype == KEYTYPE_ARCFOUR);
386 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
387 krb5_create_checksum(krb5_context context,
388 krb5_crypto crypto,
389 krb5_key_usage usage,
390 int type,
391 void *data,
392 size_t len,
393 Checksum *result)
395 struct _krb5_checksum_type *ct = NULL;
396 unsigned keyusage;
398 /* type 0 -> pick from crypto */
399 if (type) {
400 ct = _krb5_find_checksum(type);
401 } else if (crypto) {
402 ct = crypto->et->keyed_checksum;
403 if (ct == NULL)
404 ct = crypto->et->checksum;
407 if(ct == NULL) {
408 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
409 N_("checksum type %d not supported", ""),
410 type);
411 return KRB5_PROG_SUMTYPE_NOSUPP;
414 if (arcfour_checksum_p(ct, crypto)) {
415 keyusage = usage;
416 _krb5_usage2arcfour(context, &keyusage);
417 } else
418 keyusage = CHECKSUM_USAGE(usage);
420 return create_checksum(context, ct, crypto, keyusage,
421 data, len, result);
424 static krb5_error_code
425 verify_checksum(krb5_context context,
426 krb5_crypto crypto,
427 unsigned usage, /* not krb5_key_usage */
428 void *data,
429 size_t len,
430 Checksum *cksum)
432 krb5_error_code ret;
433 struct _krb5_key_data *dkey;
434 int keyed_checksum;
435 Checksum c;
436 struct _krb5_checksum_type *ct;
438 ct = _krb5_find_checksum(cksum->cksumtype);
439 if (ct == NULL || (ct->flags & F_DISABLED)) {
440 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
441 N_("checksum type %d not supported", ""),
442 cksum->cksumtype);
443 return KRB5_PROG_SUMTYPE_NOSUPP;
445 if(ct->checksumsize != cksum->checksum.length) {
446 krb5_clear_error_message (context);
447 krb5_set_error_message(context, KRB5KRB_AP_ERR_BAD_INTEGRITY,
448 N_("Decrypt integrity check failed for checksum type %s, "
449 "length was %u, expected %u", ""),
450 ct->name, (unsigned)cksum->checksum.length,
451 (unsigned)ct->checksumsize);
453 return KRB5KRB_AP_ERR_BAD_INTEGRITY; /* XXX */
455 keyed_checksum = (ct->flags & F_KEYED) != 0;
456 if(keyed_checksum) {
457 struct _krb5_checksum_type *kct;
458 if (crypto == NULL) {
459 krb5_set_error_message(context, KRB5_PROG_SUMTYPE_NOSUPP,
460 N_("Checksum type %s is keyed but no "
461 "crypto context (key) was passed in", ""),
462 ct->name);
463 return KRB5_PROG_SUMTYPE_NOSUPP; /* XXX */
465 kct = crypto->et->keyed_checksum;
466 if (kct == NULL || kct->type != ct->type) {
467 krb5_set_error_message(context, KRB5_PROG_SUMTYPE_NOSUPP,
468 N_("Checksum type %s is keyed, but "
469 "the key type %s passed didnt have that checksum "
470 "type as the keyed type", ""),
471 ct->name, crypto->et->name);
472 return KRB5_PROG_SUMTYPE_NOSUPP; /* XXX */
475 ret = get_checksum_key(context, crypto, usage, ct, &dkey);
476 if (ret)
477 return ret;
478 } else
479 dkey = NULL;
482 * If checksum have a verify function, lets use that instead of
483 * calling ->checksum and then compare result.
486 if(ct->verify) {
487 ret = (*ct->verify)(context, dkey, data, len, usage, cksum);
488 if (ret)
489 krb5_set_error_message(context, ret,
490 N_("Decrypt integrity check failed for checksum "
491 "type %s, key type %s", ""),
492 ct->name, (crypto != NULL)? crypto->et->name : "(none)");
493 return ret;
496 ret = krb5_data_alloc (&c.checksum, ct->checksumsize);
497 if (ret)
498 return ret;
500 ret = (*ct->checksum)(context, dkey, data, len, usage, &c);
501 if (ret) {
502 krb5_data_free(&c.checksum);
503 return ret;
506 if(krb5_data_ct_cmp(&c.checksum, &cksum->checksum) != 0) {
507 ret = KRB5KRB_AP_ERR_BAD_INTEGRITY;
508 krb5_set_error_message(context, ret,
509 N_("Decrypt integrity check failed for checksum "
510 "type %s, key type %s", ""),
511 ct->name, crypto ? crypto->et->name : "(unkeyed)");
512 } else {
513 ret = 0;
515 krb5_data_free (&c.checksum);
516 return ret;
519 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
520 krb5_verify_checksum(krb5_context context,
521 krb5_crypto crypto,
522 krb5_key_usage usage,
523 void *data,
524 size_t len,
525 Checksum *cksum)
527 struct _krb5_checksum_type *ct;
528 unsigned keyusage;
530 ct = _krb5_find_checksum(cksum->cksumtype);
531 if(ct == NULL) {
532 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
533 N_("checksum type %d not supported", ""),
534 cksum->cksumtype);
535 return KRB5_PROG_SUMTYPE_NOSUPP;
538 if (arcfour_checksum_p(ct, crypto)) {
539 keyusage = usage;
540 _krb5_usage2arcfour(context, &keyusage);
541 } else
542 keyusage = CHECKSUM_USAGE(usage);
544 return verify_checksum(context, crypto, keyusage,
545 data, len, cksum);
548 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
549 krb5_crypto_get_checksum_type(krb5_context context,
550 krb5_crypto crypto,
551 krb5_cksumtype *type)
553 struct _krb5_checksum_type *ct = NULL;
555 if (crypto != NULL) {
556 ct = crypto->et->keyed_checksum;
557 if (ct == NULL)
558 ct = crypto->et->checksum;
561 if (ct == NULL) {
562 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
563 N_("checksum type not found", ""));
564 return KRB5_PROG_SUMTYPE_NOSUPP;
567 *type = ct->type;
569 return 0;
573 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
574 krb5_checksumsize(krb5_context context,
575 krb5_cksumtype type,
576 size_t *size)
578 struct _krb5_checksum_type *ct = _krb5_find_checksum(type);
579 if(ct == NULL) {
580 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
581 N_("checksum type %d not supported", ""),
582 type);
583 return KRB5_PROG_SUMTYPE_NOSUPP;
585 *size = ct->checksumsize;
586 return 0;
589 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
590 krb5_checksum_is_keyed(krb5_context context,
591 krb5_cksumtype type)
593 struct _krb5_checksum_type *ct = _krb5_find_checksum(type);
594 if(ct == NULL) {
595 if (context)
596 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
597 N_("checksum type %d not supported", ""),
598 type);
599 return KRB5_PROG_SUMTYPE_NOSUPP;
601 return ct->flags & F_KEYED;
604 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
605 krb5_checksum_is_collision_proof(krb5_context context,
606 krb5_cksumtype type)
608 struct _krb5_checksum_type *ct = _krb5_find_checksum(type);
609 if(ct == NULL) {
610 if (context)
611 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
612 N_("checksum type %d not supported", ""),
613 type);
614 return KRB5_PROG_SUMTYPE_NOSUPP;
616 return ct->flags & F_CPROOF;
619 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
620 krb5_checksum_disable(krb5_context context,
621 krb5_cksumtype type)
623 struct _krb5_checksum_type *ct = _krb5_find_checksum(type);
624 if(ct == NULL) {
625 if (context)
626 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
627 N_("checksum type %d not supported", ""),
628 type);
629 return KRB5_PROG_SUMTYPE_NOSUPP;
631 ct->flags |= F_DISABLED;
632 return 0;
635 /************************************************************
637 ************************************************************/
639 KRB5_LIB_FUNCTION struct _krb5_encryption_type * KRB5_LIB_CALL
640 _krb5_find_enctype(krb5_enctype type)
642 int i;
643 for(i = 0; i < _krb5_num_etypes; i++)
644 if(_krb5_etypes[i]->type == type)
645 return _krb5_etypes[i];
646 return NULL;
650 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
651 krb5_enctype_to_string(krb5_context context,
652 krb5_enctype etype,
653 char **string)
655 struct _krb5_encryption_type *e;
656 e = _krb5_find_enctype(etype);
657 if(e == NULL) {
658 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
659 N_("encryption type %d not supported", ""),
660 etype);
661 *string = NULL;
662 return KRB5_PROG_ETYPE_NOSUPP;
664 *string = strdup(e->name);
665 if (*string == NULL)
666 return krb5_enomem(context);
667 return 0;
670 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
671 krb5_string_to_enctype(krb5_context context,
672 const char *string,
673 krb5_enctype *etype)
675 int i;
676 for(i = 0; i < _krb5_num_etypes; i++) {
677 if(strcasecmp(_krb5_etypes[i]->name, string) == 0){
678 *etype = _krb5_etypes[i]->type;
679 return 0;
681 if(_krb5_etypes[i]->alias != NULL &&
682 strcasecmp(_krb5_etypes[i]->alias, string) == 0){
683 *etype = _krb5_etypes[i]->type;
684 return 0;
687 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
688 N_("encryption type %s not supported", ""),
689 string);
690 return KRB5_PROG_ETYPE_NOSUPP;
693 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
694 krb5_enctype_to_keytype(krb5_context context,
695 krb5_enctype etype,
696 krb5_keytype *keytype)
698 struct _krb5_encryption_type *e = _krb5_find_enctype(etype);
699 if(e == NULL) {
700 return unsupported_enctype (context, etype);
702 *keytype = e->keytype->type; /* XXX */
703 return 0;
707 * Check if a enctype is valid, return 0 if it is.
709 * @param context Kerberos context
710 * @param etype enctype to check if its valid or not
712 * @return Return an error code for an failure or 0 on success (enctype valid).
713 * @ingroup krb5_crypto
716 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
717 krb5_enctype_valid(krb5_context context,
718 krb5_enctype etype)
720 struct _krb5_encryption_type *e = _krb5_find_enctype(etype);
721 if(e && (e->flags & F_DISABLED) == 0)
722 return 0;
723 if (context == NULL)
724 return KRB5_PROG_ETYPE_NOSUPP;
725 if(e == NULL) {
726 return unsupported_enctype (context, etype);
728 /* Must be (e->flags & F_DISABLED) */
729 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
730 N_("encryption type %s is disabled", ""),
731 e->name);
732 return KRB5_PROG_ETYPE_NOSUPP;
736 * Return the coresponding encryption type for a checksum type.
738 * @param context Kerberos context
739 * @param ctype The checksum type to get the result enctype for
740 * @param etype The returned encryption, when the matching etype is
741 * not found, etype is set to ETYPE_NULL.
743 * @return Return an error code for an failure or 0 on success.
744 * @ingroup krb5_crypto
748 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
749 krb5_cksumtype_to_enctype(krb5_context context,
750 krb5_cksumtype ctype,
751 krb5_enctype *etype)
753 int i;
755 *etype = ETYPE_NULL;
757 for(i = 0; i < _krb5_num_etypes; i++) {
758 if(_krb5_etypes[i]->keyed_checksum &&
759 _krb5_etypes[i]->keyed_checksum->type == ctype)
761 *etype = _krb5_etypes[i]->type;
762 return 0;
766 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
767 N_("checksum type %d not supported", ""),
768 (int)ctype);
769 return KRB5_PROG_SUMTYPE_NOSUPP;
773 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
774 krb5_cksumtype_valid(krb5_context context,
775 krb5_cksumtype ctype)
777 struct _krb5_checksum_type *c = _krb5_find_checksum(ctype);
778 if (c == NULL) {
779 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
780 N_("checksum type %d not supported", ""),
781 ctype);
782 return KRB5_PROG_SUMTYPE_NOSUPP;
784 if (c->flags & F_DISABLED) {
785 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
786 N_("checksum type %s is disabled", ""),
787 c->name);
788 return KRB5_PROG_SUMTYPE_NOSUPP;
790 return 0;
794 static krb5_boolean
795 derived_crypto(krb5_context context,
796 krb5_crypto crypto)
798 return (crypto->et->flags & F_DERIVED) != 0;
801 static krb5_boolean
802 special_crypto(krb5_context context,
803 krb5_crypto crypto)
805 return (crypto->et->flags & F_SPECIAL) != 0;
808 #define CHECKSUMSIZE(C) ((C)->checksumsize)
809 #define CHECKSUMTYPE(C) ((C)->type)
811 static krb5_error_code
812 encrypt_internal_derived(krb5_context context,
813 krb5_crypto crypto,
814 unsigned usage,
815 const void *data,
816 size_t len,
817 krb5_data *result,
818 void *ivec)
820 size_t sz, block_sz, checksum_sz, total_sz;
821 Checksum cksum;
822 unsigned char *p, *q;
823 krb5_error_code ret;
824 struct _krb5_key_data *dkey;
825 const struct _krb5_encryption_type *et = crypto->et;
827 checksum_sz = CHECKSUMSIZE(et->keyed_checksum);
829 sz = et->confoundersize + len;
830 block_sz = (sz + et->padsize - 1) &~ (et->padsize - 1); /* pad */
831 total_sz = block_sz + checksum_sz;
832 p = calloc(1, total_sz);
833 if (p == NULL)
834 return krb5_enomem(context);
836 q = p;
837 krb5_generate_random_block(q, et->confoundersize); /* XXX */
838 q += et->confoundersize;
839 memcpy(q, data, len);
841 ret = create_checksum(context,
842 et->keyed_checksum,
843 crypto,
844 INTEGRITY_USAGE(usage),
846 block_sz,
847 &cksum);
848 if(ret == 0 && cksum.checksum.length != checksum_sz) {
849 free_Checksum (&cksum);
850 krb5_clear_error_message (context);
851 ret = KRB5_CRYPTO_INTERNAL;
853 if(ret)
854 goto fail;
855 memcpy(p + block_sz, cksum.checksum.data, cksum.checksum.length);
856 free_Checksum (&cksum);
857 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
858 if(ret)
859 goto fail;
860 ret = _key_schedule(context, dkey);
861 if(ret)
862 goto fail;
863 ret = (*et->encrypt)(context, dkey, p, block_sz, 1, usage, ivec);
864 if (ret)
865 goto fail;
866 result->data = p;
867 result->length = total_sz;
868 return 0;
869 fail:
870 memset(p, 0, total_sz);
871 free(p);
872 return ret;
876 static krb5_error_code
877 encrypt_internal(krb5_context context,
878 krb5_crypto crypto,
879 const void *data,
880 size_t len,
881 krb5_data *result,
882 void *ivec)
884 size_t sz, block_sz, checksum_sz;
885 Checksum cksum;
886 unsigned char *p, *q;
887 krb5_error_code ret;
888 const struct _krb5_encryption_type *et = crypto->et;
890 checksum_sz = CHECKSUMSIZE(et->checksum);
892 sz = et->confoundersize + checksum_sz + len;
893 block_sz = (sz + et->padsize - 1) &~ (et->padsize - 1); /* pad */
894 p = calloc(1, block_sz);
895 if (p == NULL)
896 return krb5_enomem(context);
898 q = p;
899 krb5_generate_random_block(q, et->confoundersize); /* XXX */
900 q += et->confoundersize;
901 memset(q, 0, checksum_sz);
902 q += checksum_sz;
903 memcpy(q, data, len);
905 ret = create_checksum(context,
906 et->checksum,
907 crypto,
910 block_sz,
911 &cksum);
912 if(ret == 0 && cksum.checksum.length != checksum_sz) {
913 krb5_clear_error_message (context);
914 free_Checksum(&cksum);
915 ret = KRB5_CRYPTO_INTERNAL;
917 if(ret)
918 goto fail;
919 memcpy(p + et->confoundersize, cksum.checksum.data, cksum.checksum.length);
920 free_Checksum(&cksum);
921 ret = _key_schedule(context, &crypto->key);
922 if(ret)
923 goto fail;
924 ret = (*et->encrypt)(context, &crypto->key, p, block_sz, 1, 0, ivec);
925 if (ret) {
926 memset(p, 0, block_sz);
927 free(p);
928 return ret;
930 result->data = p;
931 result->length = block_sz;
932 return 0;
933 fail:
934 memset(p, 0, block_sz);
935 free(p);
936 return ret;
939 static krb5_error_code
940 encrypt_internal_special(krb5_context context,
941 krb5_crypto crypto,
942 int usage,
943 const void *data,
944 size_t len,
945 krb5_data *result,
946 void *ivec)
948 struct _krb5_encryption_type *et = crypto->et;
949 size_t cksum_sz = CHECKSUMSIZE(et->checksum);
950 size_t sz = len + cksum_sz + et->confoundersize;
951 char *tmp, *p;
952 krb5_error_code ret;
954 tmp = malloc (sz);
955 if (tmp == NULL)
956 return krb5_enomem(context);
957 p = tmp;
958 memset (p, 0, cksum_sz);
959 p += cksum_sz;
960 krb5_generate_random_block(p, et->confoundersize);
961 p += et->confoundersize;
962 memcpy (p, data, len);
963 ret = (*et->encrypt)(context, &crypto->key, tmp, sz, TRUE, usage, ivec);
964 if (ret) {
965 memset(tmp, 0, sz);
966 free(tmp);
967 return ret;
969 result->data = tmp;
970 result->length = sz;
971 return 0;
974 static krb5_error_code
975 decrypt_internal_derived(krb5_context context,
976 krb5_crypto crypto,
977 unsigned usage,
978 void *data,
979 size_t len,
980 krb5_data *result,
981 void *ivec)
983 size_t checksum_sz;
984 Checksum cksum;
985 unsigned char *p;
986 krb5_error_code ret;
987 struct _krb5_key_data *dkey;
988 struct _krb5_encryption_type *et = crypto->et;
989 unsigned long l;
991 checksum_sz = CHECKSUMSIZE(et->keyed_checksum);
992 if (len < checksum_sz + et->confoundersize) {
993 krb5_set_error_message(context, KRB5_BAD_MSIZE,
994 N_("Encrypted data shorter then "
995 "checksum + confunder", ""));
996 return KRB5_BAD_MSIZE;
999 if (((len - checksum_sz) % et->padsize) != 0) {
1000 krb5_clear_error_message(context);
1001 return KRB5_BAD_MSIZE;
1004 p = malloc(len);
1005 if (len != 0 && p == NULL)
1006 return krb5_enomem(context);
1007 memcpy(p, data, len);
1009 len -= checksum_sz;
1011 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
1012 if(ret) {
1013 free(p);
1014 return ret;
1016 ret = _key_schedule(context, dkey);
1017 if(ret) {
1018 free(p);
1019 return ret;
1021 ret = (*et->encrypt)(context, dkey, p, len, 0, usage, ivec);
1022 if (ret) {
1023 free(p);
1024 return ret;
1027 cksum.checksum.data = p + len;
1028 cksum.checksum.length = checksum_sz;
1029 cksum.cksumtype = CHECKSUMTYPE(et->keyed_checksum);
1031 ret = verify_checksum(context,
1032 crypto,
1033 INTEGRITY_USAGE(usage),
1035 len,
1036 &cksum);
1037 if(ret) {
1038 free(p);
1039 return ret;
1041 l = len - et->confoundersize;
1042 memmove(p, p + et->confoundersize, l);
1043 result->data = realloc(p, l);
1044 if(result->data == NULL && l != 0) {
1045 free(p);
1046 return krb5_enomem(context);
1048 result->length = l;
1049 return 0;
1052 static krb5_error_code
1053 decrypt_internal(krb5_context context,
1054 krb5_crypto crypto,
1055 void *data,
1056 size_t len,
1057 krb5_data *result,
1058 void *ivec)
1060 krb5_error_code ret;
1061 unsigned char *p;
1062 Checksum cksum;
1063 size_t checksum_sz, l;
1064 struct _krb5_encryption_type *et = crypto->et;
1066 if ((len % et->padsize) != 0) {
1067 krb5_clear_error_message(context);
1068 return KRB5_BAD_MSIZE;
1070 checksum_sz = CHECKSUMSIZE(et->checksum);
1071 if (len < checksum_sz + et->confoundersize) {
1072 krb5_set_error_message(context, KRB5_BAD_MSIZE,
1073 N_("Encrypted data shorter then "
1074 "checksum + confunder", ""));
1075 return KRB5_BAD_MSIZE;
1078 p = malloc(len);
1079 if (len != 0 && p == NULL)
1080 return krb5_enomem(context);
1081 memcpy(p, data, len);
1083 ret = _key_schedule(context, &crypto->key);
1084 if(ret) {
1085 free(p);
1086 return ret;
1088 ret = (*et->encrypt)(context, &crypto->key, p, len, 0, 0, ivec);
1089 if (ret) {
1090 free(p);
1091 return ret;
1093 ret = krb5_data_copy(&cksum.checksum, p + et->confoundersize, checksum_sz);
1094 if(ret) {
1095 free(p);
1096 return ret;
1098 memset(p + et->confoundersize, 0, checksum_sz);
1099 cksum.cksumtype = CHECKSUMTYPE(et->checksum);
1100 ret = verify_checksum(context, NULL, 0, p, len, &cksum);
1101 free_Checksum(&cksum);
1102 if(ret) {
1103 free(p);
1104 return ret;
1106 l = len - et->confoundersize - checksum_sz;
1107 memmove(p, p + et->confoundersize + checksum_sz, l);
1108 result->data = realloc(p, l);
1109 if(result->data == NULL && l != 0) {
1110 free(p);
1111 return krb5_enomem(context);
1113 result->length = l;
1114 return 0;
1117 static krb5_error_code
1118 decrypt_internal_special(krb5_context context,
1119 krb5_crypto crypto,
1120 int usage,
1121 void *data,
1122 size_t len,
1123 krb5_data *result,
1124 void *ivec)
1126 struct _krb5_encryption_type *et = crypto->et;
1127 size_t cksum_sz = CHECKSUMSIZE(et->checksum);
1128 size_t sz = len - cksum_sz - et->confoundersize;
1129 unsigned char *p;
1130 krb5_error_code ret;
1132 if ((len % et->padsize) != 0) {
1133 krb5_clear_error_message(context);
1134 return KRB5_BAD_MSIZE;
1136 if (len < cksum_sz + et->confoundersize) {
1137 krb5_set_error_message(context, KRB5_BAD_MSIZE,
1138 N_("Encrypted data shorter then "
1139 "checksum + confunder", ""));
1140 return KRB5_BAD_MSIZE;
1143 p = malloc (len);
1144 if (p == NULL)
1145 return krb5_enomem(context);
1146 memcpy(p, data, len);
1148 ret = (*et->encrypt)(context, &crypto->key, p, len, FALSE, usage, ivec);
1149 if (ret) {
1150 free(p);
1151 return ret;
1154 memmove (p, p + cksum_sz + et->confoundersize, sz);
1155 result->data = realloc(p, sz);
1156 if(result->data == NULL && sz != 0) {
1157 free(p);
1158 return krb5_enomem(context);
1160 result->length = sz;
1161 return 0;
1164 static krb5_crypto_iov *
1165 find_iv(krb5_crypto_iov *data, size_t num_data, unsigned type)
1167 size_t i;
1168 for (i = 0; i < num_data; i++)
1169 if (data[i].flags == type)
1170 return &data[i];
1171 return NULL;
1175 * Inline encrypt a kerberos message
1177 * @param context Kerberos context
1178 * @param crypto Kerberos crypto context
1179 * @param usage Key usage for this buffer
1180 * @param data array of buffers to process
1181 * @param num_data length of array
1182 * @param ivec initial cbc/cts vector
1184 * @return Return an error code or 0.
1185 * @ingroup krb5_crypto
1187 * Kerberos encrypted data look like this:
1189 * 1. KRB5_CRYPTO_TYPE_HEADER
1190 * 2. array [1,...] KRB5_CRYPTO_TYPE_DATA and array [0,...]
1191 * KRB5_CRYPTO_TYPE_SIGN_ONLY in any order, however the receiver
1192 * have to aware of the order. KRB5_CRYPTO_TYPE_SIGN_ONLY is
1193 * commonly used headers and trailers.
1194 * 3. KRB5_CRYPTO_TYPE_PADDING, at least on padsize long if padsize > 1
1195 * 4. KRB5_CRYPTO_TYPE_TRAILER
1198 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1199 krb5_encrypt_iov_ivec(krb5_context context,
1200 krb5_crypto crypto,
1201 unsigned usage,
1202 krb5_crypto_iov *data,
1203 int num_data,
1204 void *ivec)
1206 size_t headersz, trailersz, len;
1207 int i;
1208 size_t sz, block_sz, pad_sz;
1209 Checksum cksum;
1210 unsigned char *p, *q;
1211 krb5_error_code ret;
1212 struct _krb5_key_data *dkey;
1213 const struct _krb5_encryption_type *et = crypto->et;
1214 krb5_crypto_iov *tiv, *piv, *hiv;
1216 if (num_data < 0) {
1217 krb5_clear_error_message(context);
1218 return KRB5_CRYPTO_INTERNAL;
1221 if(!derived_crypto(context, crypto)) {
1222 krb5_clear_error_message(context);
1223 return KRB5_CRYPTO_INTERNAL;
1226 headersz = et->confoundersize;
1227 trailersz = CHECKSUMSIZE(et->keyed_checksum);
1229 for (len = 0, i = 0; i < num_data; i++) {
1230 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1231 continue;
1232 len += data[i].data.length;
1235 sz = headersz + len;
1236 block_sz = (sz + et->padsize - 1) &~ (et->padsize - 1); /* pad */
1238 pad_sz = block_sz - sz;
1240 /* header */
1242 hiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_HEADER);
1243 if (hiv == NULL || hiv->data.length != headersz)
1244 return KRB5_BAD_MSIZE;
1246 krb5_generate_random_block(hiv->data.data, hiv->data.length);
1248 /* padding */
1249 piv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_PADDING);
1250 /* its ok to have no TYPE_PADDING if there is no padding */
1251 if (piv == NULL && pad_sz != 0)
1252 return KRB5_BAD_MSIZE;
1253 if (piv) {
1254 if (piv->data.length < pad_sz)
1255 return KRB5_BAD_MSIZE;
1256 piv->data.length = pad_sz;
1257 if (pad_sz)
1258 memset(piv->data.data, pad_sz, pad_sz);
1259 else
1260 piv = NULL;
1263 /* trailer */
1264 tiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_TRAILER);
1265 if (tiv == NULL || tiv->data.length != trailersz)
1266 return KRB5_BAD_MSIZE;
1269 * XXX replace with EVP_Sign? at least make create_checksum an iov
1270 * function.
1271 * XXX CTS EVP is broken, can't handle multi buffers :(
1274 len = block_sz;
1275 for (i = 0; i < num_data; i++) {
1276 if (data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1277 continue;
1278 len += data[i].data.length;
1281 p = q = malloc(len);
1283 memcpy(q, hiv->data.data, hiv->data.length);
1284 q += hiv->data.length;
1285 for (i = 0; i < num_data; i++) {
1286 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1287 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1288 continue;
1289 memcpy(q, data[i].data.data, data[i].data.length);
1290 q += data[i].data.length;
1292 if (piv)
1293 memset(q, 0, piv->data.length);
1295 ret = create_checksum(context,
1296 et->keyed_checksum,
1297 crypto,
1298 INTEGRITY_USAGE(usage),
1300 len,
1301 &cksum);
1302 free(p);
1303 if(ret == 0 && cksum.checksum.length != trailersz) {
1304 free_Checksum (&cksum);
1305 krb5_clear_error_message (context);
1306 ret = KRB5_CRYPTO_INTERNAL;
1308 if(ret)
1309 return ret;
1311 /* save cksum at end */
1312 memcpy(tiv->data.data, cksum.checksum.data, cksum.checksum.length);
1313 free_Checksum (&cksum);
1315 /* XXX replace with EVP_Cipher */
1316 p = q = malloc(block_sz);
1317 if(p == NULL)
1318 return ENOMEM;
1320 memcpy(q, hiv->data.data, hiv->data.length);
1321 q += hiv->data.length;
1323 for (i = 0; i < num_data; i++) {
1324 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1325 continue;
1326 memcpy(q, data[i].data.data, data[i].data.length);
1327 q += data[i].data.length;
1329 if (piv)
1330 memset(q, 0, piv->data.length);
1333 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
1334 if(ret) {
1335 free(p);
1336 return ret;
1338 ret = _key_schedule(context, dkey);
1339 if(ret) {
1340 free(p);
1341 return ret;
1344 ret = (*et->encrypt)(context, dkey, p, block_sz, 1, usage, ivec);
1345 if (ret) {
1346 free(p);
1347 return ret;
1350 /* now copy data back to buffers */
1351 q = p;
1353 memcpy(hiv->data.data, q, hiv->data.length);
1354 q += hiv->data.length;
1356 for (i = 0; i < num_data; i++) {
1357 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1358 continue;
1359 memcpy(data[i].data.data, q, data[i].data.length);
1360 q += data[i].data.length;
1362 if (piv)
1363 memcpy(piv->data.data, q, pad_sz);
1365 free(p);
1367 return ret;
1371 * Inline decrypt a Kerberos message.
1373 * @param context Kerberos context
1374 * @param crypto Kerberos crypto context
1375 * @param usage Key usage for this buffer
1376 * @param data array of buffers to process
1377 * @param num_data length of array
1378 * @param ivec initial cbc/cts vector
1380 * @return Return an error code or 0.
1381 * @ingroup krb5_crypto
1383 * 1. KRB5_CRYPTO_TYPE_HEADER
1384 * 2. one KRB5_CRYPTO_TYPE_DATA and array [0,...] of KRB5_CRYPTO_TYPE_SIGN_ONLY in
1385 * any order, however the receiver have to aware of the
1386 * order. KRB5_CRYPTO_TYPE_SIGN_ONLY is commonly used unencrypoted
1387 * protocol headers and trailers. The output data will be of same
1388 * size as the input data or shorter.
1391 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1392 krb5_decrypt_iov_ivec(krb5_context context,
1393 krb5_crypto crypto,
1394 unsigned usage,
1395 krb5_crypto_iov *data,
1396 unsigned int num_data,
1397 void *ivec)
1399 unsigned int i;
1400 size_t headersz, trailersz, len;
1401 Checksum cksum;
1402 unsigned char *p, *q;
1403 krb5_error_code ret;
1404 struct _krb5_key_data *dkey;
1405 struct _krb5_encryption_type *et = crypto->et;
1406 krb5_crypto_iov *tiv, *hiv;
1408 if(!derived_crypto(context, crypto)) {
1409 krb5_clear_error_message(context);
1410 return KRB5_CRYPTO_INTERNAL;
1413 headersz = et->confoundersize;
1415 hiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_HEADER);
1416 if (hiv == NULL || hiv->data.length != headersz)
1417 return KRB5_BAD_MSIZE;
1419 /* trailer */
1420 trailersz = CHECKSUMSIZE(et->keyed_checksum);
1422 tiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_TRAILER);
1423 if (tiv->data.length != trailersz)
1424 return KRB5_BAD_MSIZE;
1426 /* Find length of data we will decrypt */
1428 len = headersz;
1429 for (i = 0; i < num_data; i++) {
1430 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1431 continue;
1432 len += data[i].data.length;
1435 if ((len % et->padsize) != 0) {
1436 krb5_clear_error_message(context);
1437 return KRB5_BAD_MSIZE;
1440 /* XXX replace with EVP_Cipher */
1442 p = q = malloc(len);
1443 if (p == NULL)
1444 return ENOMEM;
1446 memcpy(q, hiv->data.data, hiv->data.length);
1447 q += hiv->data.length;
1449 for (i = 0; i < num_data; i++) {
1450 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1451 continue;
1452 memcpy(q, data[i].data.data, data[i].data.length);
1453 q += data[i].data.length;
1456 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
1457 if(ret) {
1458 free(p);
1459 return ret;
1461 ret = _key_schedule(context, dkey);
1462 if(ret) {
1463 free(p);
1464 return ret;
1467 ret = (*et->encrypt)(context, dkey, p, len, 0, usage, ivec);
1468 if (ret) {
1469 free(p);
1470 return ret;
1473 /* copy data back to buffers */
1474 memcpy(hiv->data.data, p, hiv->data.length);
1475 q = p + hiv->data.length;
1476 for (i = 0; i < num_data; i++) {
1477 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1478 continue;
1479 memcpy(data[i].data.data, q, data[i].data.length);
1480 q += data[i].data.length;
1483 free(p);
1485 /* check signature */
1486 for (i = 0; i < num_data; i++) {
1487 if (data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1488 continue;
1489 len += data[i].data.length;
1492 p = q = malloc(len);
1493 if (p == NULL)
1494 return ENOMEM;
1496 memcpy(q, hiv->data.data, hiv->data.length);
1497 q += hiv->data.length;
1498 for (i = 0; i < num_data; i++) {
1499 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1500 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1501 continue;
1502 memcpy(q, data[i].data.data, data[i].data.length);
1503 q += data[i].data.length;
1506 cksum.checksum.data = tiv->data.data;
1507 cksum.checksum.length = tiv->data.length;
1508 cksum.cksumtype = CHECKSUMTYPE(et->keyed_checksum);
1510 ret = verify_checksum(context,
1511 crypto,
1512 INTEGRITY_USAGE(usage),
1514 len,
1515 &cksum);
1516 free(p);
1517 return ret;
1521 * Create a Kerberos message checksum.
1523 * @param context Kerberos context
1524 * @param crypto Kerberos crypto context
1525 * @param usage Key usage for this buffer
1526 * @param data array of buffers to process
1527 * @param num_data length of array
1528 * @param type output data
1530 * @return Return an error code or 0.
1531 * @ingroup krb5_crypto
1534 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1535 krb5_create_checksum_iov(krb5_context context,
1536 krb5_crypto crypto,
1537 unsigned usage,
1538 krb5_crypto_iov *data,
1539 unsigned int num_data,
1540 krb5_cksumtype *type)
1542 Checksum cksum;
1543 krb5_crypto_iov *civ;
1544 krb5_error_code ret;
1545 size_t i;
1546 size_t len;
1547 char *p, *q;
1549 if(!derived_crypto(context, crypto)) {
1550 krb5_clear_error_message(context);
1551 return KRB5_CRYPTO_INTERNAL;
1554 civ = find_iv(data, num_data, KRB5_CRYPTO_TYPE_CHECKSUM);
1555 if (civ == NULL)
1556 return KRB5_BAD_MSIZE;
1558 len = 0;
1559 for (i = 0; i < num_data; i++) {
1560 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1561 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1562 continue;
1563 len += data[i].data.length;
1566 p = q = malloc(len);
1568 for (i = 0; i < num_data; i++) {
1569 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1570 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1571 continue;
1572 memcpy(q, data[i].data.data, data[i].data.length);
1573 q += data[i].data.length;
1576 ret = krb5_create_checksum(context, crypto, usage, 0, p, len, &cksum);
1577 free(p);
1578 if (ret)
1579 return ret;
1581 if (type)
1582 *type = cksum.cksumtype;
1584 if (cksum.checksum.length > civ->data.length) {
1585 krb5_set_error_message(context, KRB5_BAD_MSIZE,
1586 N_("Checksum larger then input buffer", ""));
1587 free_Checksum(&cksum);
1588 return KRB5_BAD_MSIZE;
1591 civ->data.length = cksum.checksum.length;
1592 memcpy(civ->data.data, cksum.checksum.data, civ->data.length);
1593 free_Checksum(&cksum);
1595 return 0;
1599 * Verify a Kerberos message checksum.
1601 * @param context Kerberos context
1602 * @param crypto Kerberos crypto context
1603 * @param usage Key usage for this buffer
1604 * @param data array of buffers to process
1605 * @param num_data length of array
1606 * @param type return checksum type if not NULL
1608 * @return Return an error code or 0.
1609 * @ingroup krb5_crypto
1612 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1613 krb5_verify_checksum_iov(krb5_context context,
1614 krb5_crypto crypto,
1615 unsigned usage,
1616 krb5_crypto_iov *data,
1617 unsigned int num_data,
1618 krb5_cksumtype *type)
1620 struct _krb5_encryption_type *et = crypto->et;
1621 Checksum cksum;
1622 krb5_crypto_iov *civ;
1623 krb5_error_code ret;
1624 size_t i;
1625 size_t len;
1626 char *p, *q;
1628 if(!derived_crypto(context, crypto)) {
1629 krb5_clear_error_message(context);
1630 return KRB5_CRYPTO_INTERNAL;
1633 civ = find_iv(data, num_data, KRB5_CRYPTO_TYPE_CHECKSUM);
1634 if (civ == NULL)
1635 return KRB5_BAD_MSIZE;
1637 len = 0;
1638 for (i = 0; i < num_data; i++) {
1639 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1640 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1641 continue;
1642 len += data[i].data.length;
1645 p = q = malloc(len);
1647 for (i = 0; i < num_data; i++) {
1648 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1649 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1650 continue;
1651 memcpy(q, data[i].data.data, data[i].data.length);
1652 q += data[i].data.length;
1655 cksum.cksumtype = CHECKSUMTYPE(et->keyed_checksum);
1656 cksum.checksum.length = civ->data.length;
1657 cksum.checksum.data = civ->data.data;
1659 ret = krb5_verify_checksum(context, crypto, usage, p, len, &cksum);
1660 free(p);
1662 if (ret == 0 && type)
1663 *type = cksum.cksumtype;
1665 return ret;
1669 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1670 krb5_crypto_length(krb5_context context,
1671 krb5_crypto crypto,
1672 int type,
1673 size_t *len)
1675 if (!derived_crypto(context, crypto)) {
1676 krb5_set_error_message(context, EINVAL, "not a derived crypto");
1677 return EINVAL;
1680 switch(type) {
1681 case KRB5_CRYPTO_TYPE_EMPTY:
1682 *len = 0;
1683 return 0;
1684 case KRB5_CRYPTO_TYPE_HEADER:
1685 *len = crypto->et->blocksize;
1686 return 0;
1687 case KRB5_CRYPTO_TYPE_DATA:
1688 case KRB5_CRYPTO_TYPE_SIGN_ONLY:
1689 /* len must already been filled in */
1690 return 0;
1691 case KRB5_CRYPTO_TYPE_PADDING:
1692 if (crypto->et->padsize > 1)
1693 *len = crypto->et->padsize;
1694 else
1695 *len = 0;
1696 return 0;
1697 case KRB5_CRYPTO_TYPE_TRAILER:
1698 *len = CHECKSUMSIZE(crypto->et->keyed_checksum);
1699 return 0;
1700 case KRB5_CRYPTO_TYPE_CHECKSUM:
1701 if (crypto->et->keyed_checksum)
1702 *len = CHECKSUMSIZE(crypto->et->keyed_checksum);
1703 else
1704 *len = CHECKSUMSIZE(crypto->et->checksum);
1705 return 0;
1707 krb5_set_error_message(context, EINVAL,
1708 "%d not a supported type", type);
1709 return EINVAL;
1713 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1714 krb5_crypto_length_iov(krb5_context context,
1715 krb5_crypto crypto,
1716 krb5_crypto_iov *data,
1717 unsigned int num_data)
1719 krb5_error_code ret;
1720 size_t i;
1722 for (i = 0; i < num_data; i++) {
1723 ret = krb5_crypto_length(context, crypto,
1724 data[i].flags,
1725 &data[i].data.length);
1726 if (ret)
1727 return ret;
1729 return 0;
1733 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1734 krb5_encrypt_ivec(krb5_context context,
1735 krb5_crypto crypto,
1736 unsigned usage,
1737 const void *data,
1738 size_t len,
1739 krb5_data *result,
1740 void *ivec)
1742 if(derived_crypto(context, crypto))
1743 return encrypt_internal_derived(context, crypto, usage,
1744 data, len, result, ivec);
1745 else if (special_crypto(context, crypto))
1746 return encrypt_internal_special (context, crypto, usage,
1747 data, len, result, ivec);
1748 else
1749 return encrypt_internal(context, crypto, data, len, result, ivec);
1752 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1753 krb5_encrypt(krb5_context context,
1754 krb5_crypto crypto,
1755 unsigned usage,
1756 const void *data,
1757 size_t len,
1758 krb5_data *result)
1760 return krb5_encrypt_ivec(context, crypto, usage, data, len, result, NULL);
1763 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1764 krb5_encrypt_EncryptedData(krb5_context context,
1765 krb5_crypto crypto,
1766 unsigned usage,
1767 void *data,
1768 size_t len,
1769 int kvno,
1770 EncryptedData *result)
1772 result->etype = CRYPTO_ETYPE(crypto);
1773 if(kvno){
1774 ALLOC(result->kvno, 1);
1775 *result->kvno = kvno;
1776 }else
1777 result->kvno = NULL;
1778 return krb5_encrypt(context, crypto, usage, data, len, &result->cipher);
1781 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1782 krb5_decrypt_ivec(krb5_context context,
1783 krb5_crypto crypto,
1784 unsigned usage,
1785 void *data,
1786 size_t len,
1787 krb5_data *result,
1788 void *ivec)
1790 if(derived_crypto(context, crypto))
1791 return decrypt_internal_derived(context, crypto, usage,
1792 data, len, result, ivec);
1793 else if (special_crypto (context, crypto))
1794 return decrypt_internal_special(context, crypto, usage,
1795 data, len, result, ivec);
1796 else
1797 return decrypt_internal(context, crypto, data, len, result, ivec);
1800 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1801 krb5_decrypt(krb5_context context,
1802 krb5_crypto crypto,
1803 unsigned usage,
1804 void *data,
1805 size_t len,
1806 krb5_data *result)
1808 return krb5_decrypt_ivec (context, crypto, usage, data, len, result,
1809 NULL);
1812 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1813 krb5_decrypt_EncryptedData(krb5_context context,
1814 krb5_crypto crypto,
1815 unsigned usage,
1816 const EncryptedData *e,
1817 krb5_data *result)
1819 return krb5_decrypt(context, crypto, usage,
1820 e->cipher.data, e->cipher.length, result);
1823 /************************************************************
1825 ************************************************************/
1827 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1828 _krb5_derive_key(krb5_context context,
1829 struct _krb5_encryption_type *et,
1830 struct _krb5_key_data *key,
1831 const void *constant,
1832 size_t len)
1834 unsigned char *k = NULL;
1835 unsigned int nblocks = 0, i;
1836 krb5_error_code ret = 0;
1837 struct _krb5_key_type *kt = et->keytype;
1839 ret = _key_schedule(context, key);
1840 if(ret)
1841 return ret;
1842 if(et->blocksize * 8 < kt->bits || len != et->blocksize) {
1843 nblocks = (kt->bits + et->blocksize * 8 - 1) / (et->blocksize * 8);
1844 k = malloc(nblocks * et->blocksize);
1845 if(k == NULL) {
1846 ret = krb5_enomem(context);
1847 goto out;
1849 ret = _krb5_n_fold(constant, len, k, et->blocksize);
1850 if (ret) {
1851 krb5_enomem(context);
1852 goto out;
1855 for(i = 0; i < nblocks; i++) {
1856 if(i > 0)
1857 memcpy(k + i * et->blocksize,
1858 k + (i - 1) * et->blocksize,
1859 et->blocksize);
1860 (*et->encrypt)(context, key, k + i * et->blocksize, et->blocksize,
1861 1, 0, NULL);
1863 } else {
1864 /* this case is probably broken, but won't be run anyway */
1865 void *c = malloc(len);
1866 size_t res_len = (kt->bits + 7) / 8;
1868 if(len != 0 && c == NULL) {
1869 ret = krb5_enomem(context);
1870 goto out;
1872 memcpy(c, constant, len);
1873 (*et->encrypt)(context, key, c, len, 1, 0, NULL);
1874 k = malloc(res_len);
1875 if(res_len != 0 && k == NULL) {
1876 free(c);
1877 ret = krb5_enomem(context);
1878 goto out;
1880 ret = _krb5_n_fold(c, len, k, res_len);
1881 free(c);
1882 if (ret) {
1883 krb5_enomem(context);
1884 goto out;
1888 /* XXX keytype dependent post-processing */
1889 switch(kt->type) {
1890 case KRB5_ENCTYPE_OLD_DES3_CBC_SHA1:
1891 _krb5_DES3_random_to_key(context, key->key, k, nblocks * et->blocksize);
1892 break;
1893 case ETYPE_DES3_CBC_SHA1:
1894 case KRB5_ENCTYPE_AES128_CTS_HMAC_SHA1_96:
1895 case KRB5_ENCTYPE_AES256_CTS_HMAC_SHA1_96:
1896 memcpy(key->key->keyvalue.data, k, key->key->keyvalue.length);
1897 break;
1898 default:
1899 ret = KRB5_CRYPTO_INTERNAL;
1900 krb5_set_error_message(context, ret,
1901 N_("derive_key() called with unknown keytype (%u)", ""),
1902 kt->type);
1903 break;
1905 out:
1906 if (key->schedule) {
1907 free_key_schedule(context, key, et);
1908 key->schedule = NULL;
1910 if (k) {
1911 memset(k, 0, nblocks * et->blocksize);
1912 free(k);
1914 return ret;
1917 static struct _krb5_key_data *
1918 _new_derived_key(krb5_crypto crypto, unsigned usage)
1920 struct _krb5_key_usage *d = crypto->key_usage;
1921 d = realloc(d, (crypto->num_key_usage + 1) * sizeof(*d));
1922 if(d == NULL)
1923 return NULL;
1924 crypto->key_usage = d;
1925 d += crypto->num_key_usage++;
1926 memset(d, 0, sizeof(*d));
1927 d->usage = usage;
1928 return &d->key;
1931 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1932 krb5_derive_key(krb5_context context,
1933 const krb5_keyblock *key,
1934 krb5_enctype etype,
1935 const void *constant,
1936 size_t constant_len,
1937 krb5_keyblock **derived_key)
1939 krb5_error_code ret;
1940 struct _krb5_encryption_type *et;
1941 struct _krb5_key_data d;
1943 *derived_key = NULL;
1945 et = _krb5_find_enctype (etype);
1946 if (et == NULL) {
1947 return unsupported_enctype (context, etype);
1950 ret = krb5_copy_keyblock(context, key, &d.key);
1951 if (ret)
1952 return ret;
1954 d.schedule = NULL;
1955 ret = _krb5_derive_key(context, et, &d, constant, constant_len);
1956 if (ret == 0)
1957 ret = krb5_copy_keyblock(context, d.key, derived_key);
1958 _krb5_free_key_data(context, &d, et);
1959 return ret;
1962 static krb5_error_code
1963 _get_derived_key(krb5_context context,
1964 krb5_crypto crypto,
1965 unsigned usage,
1966 struct _krb5_key_data **key)
1968 int i;
1969 struct _krb5_key_data *d;
1970 unsigned char constant[5];
1972 for(i = 0; i < crypto->num_key_usage; i++)
1973 if(crypto->key_usage[i].usage == usage) {
1974 *key = &crypto->key_usage[i].key;
1975 return 0;
1977 d = _new_derived_key(crypto, usage);
1978 if (d == NULL)
1979 return krb5_enomem(context);
1980 krb5_copy_keyblock(context, crypto->key.key, &d->key);
1981 _krb5_put_int(constant, usage, 5);
1982 _krb5_derive_key(context, crypto->et, d, constant, sizeof(constant));
1983 *key = d;
1984 return 0;
1988 * Create a crypto context used for all encryption and signature
1989 * operation. The encryption type to use is taken from the key, but
1990 * can be overridden with the enctype parameter. This can be useful
1991 * for encryptions types which is compatiable (DES for example).
1993 * To free the crypto context, use krb5_crypto_destroy().
1995 * @param context Kerberos context
1996 * @param key the key block information with all key data
1997 * @param etype the encryption type
1998 * @param crypto the resulting crypto context
2000 * @return Return an error code or 0.
2002 * @ingroup krb5_crypto
2005 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2006 krb5_crypto_init(krb5_context context,
2007 const krb5_keyblock *key,
2008 krb5_enctype etype,
2009 krb5_crypto *crypto)
2011 krb5_error_code ret;
2012 ALLOC(*crypto, 1);
2013 if (*crypto == NULL)
2014 return krb5_enomem(context);
2015 if(etype == (krb5_enctype)ETYPE_NULL)
2016 etype = key->keytype;
2017 (*crypto)->et = _krb5_find_enctype(etype);
2018 if((*crypto)->et == NULL || ((*crypto)->et->flags & F_DISABLED)) {
2019 free(*crypto);
2020 *crypto = NULL;
2021 return unsupported_enctype(context, etype);
2023 if((*crypto)->et->keytype->size != key->keyvalue.length) {
2024 free(*crypto);
2025 *crypto = NULL;
2026 krb5_set_error_message (context, KRB5_BAD_KEYSIZE,
2027 "encryption key has bad length");
2028 return KRB5_BAD_KEYSIZE;
2030 ret = krb5_copy_keyblock(context, key, &(*crypto)->key.key);
2031 if(ret) {
2032 free(*crypto);
2033 *crypto = NULL;
2034 return ret;
2036 (*crypto)->key.schedule = NULL;
2037 (*crypto)->num_key_usage = 0;
2038 (*crypto)->key_usage = NULL;
2039 return 0;
2042 static void
2043 free_key_schedule(krb5_context context,
2044 struct _krb5_key_data *key,
2045 struct _krb5_encryption_type *et)
2047 if (et->keytype->cleanup)
2048 (*et->keytype->cleanup)(context, key);
2049 memset(key->schedule->data, 0, key->schedule->length);
2050 krb5_free_data(context, key->schedule);
2053 KRB5_LIB_FUNCTION void KRB5_LIB_CALL
2054 _krb5_free_key_data(krb5_context context, struct _krb5_key_data *key,
2055 struct _krb5_encryption_type *et)
2057 krb5_free_keyblock(context, key->key);
2058 if(key->schedule) {
2059 free_key_schedule(context, key, et);
2060 key->schedule = NULL;
2064 static void
2065 free_key_usage(krb5_context context, struct _krb5_key_usage *ku,
2066 struct _krb5_encryption_type *et)
2068 _krb5_free_key_data(context, &ku->key, et);
2072 * Free a crypto context created by krb5_crypto_init().
2074 * @param context Kerberos context
2075 * @param crypto crypto context to free
2077 * @return Return an error code or 0.
2079 * @ingroup krb5_crypto
2082 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2083 krb5_crypto_destroy(krb5_context context,
2084 krb5_crypto crypto)
2086 int i;
2088 for(i = 0; i < crypto->num_key_usage; i++)
2089 free_key_usage(context, &crypto->key_usage[i], crypto->et);
2090 free(crypto->key_usage);
2091 _krb5_free_key_data(context, &crypto->key, crypto->et);
2092 free (crypto);
2093 return 0;
2097 * Return the blocksize used algorithm referenced by the crypto context
2099 * @param context Kerberos context
2100 * @param crypto crypto context to query
2101 * @param blocksize the resulting blocksize
2103 * @return Return an error code or 0.
2105 * @ingroup krb5_crypto
2108 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2109 krb5_crypto_getblocksize(krb5_context context,
2110 krb5_crypto crypto,
2111 size_t *blocksize)
2113 *blocksize = crypto->et->blocksize;
2114 return 0;
2118 * Return the encryption type used by the crypto context
2120 * @param context Kerberos context
2121 * @param crypto crypto context to query
2122 * @param enctype the resulting encryption type
2124 * @return Return an error code or 0.
2126 * @ingroup krb5_crypto
2129 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2130 krb5_crypto_getenctype(krb5_context context,
2131 krb5_crypto crypto,
2132 krb5_enctype *enctype)
2134 *enctype = crypto->et->type;
2135 return 0;
2139 * Return the padding size used by the crypto context
2141 * @param context Kerberos context
2142 * @param crypto crypto context to query
2143 * @param padsize the return padding size
2145 * @return Return an error code or 0.
2147 * @ingroup krb5_crypto
2150 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2151 krb5_crypto_getpadsize(krb5_context context,
2152 krb5_crypto crypto,
2153 size_t *padsize)
2155 *padsize = crypto->et->padsize;
2156 return 0;
2160 * Return the confounder size used by the crypto context
2162 * @param context Kerberos context
2163 * @param crypto crypto context to query
2164 * @param confoundersize the returned confounder size
2166 * @return Return an error code or 0.
2168 * @ingroup krb5_crypto
2171 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2172 krb5_crypto_getconfoundersize(krb5_context context,
2173 krb5_crypto crypto,
2174 size_t *confoundersize)
2176 *confoundersize = crypto->et->confoundersize;
2177 return 0;
2182 * Disable encryption type
2184 * @param context Kerberos 5 context
2185 * @param enctype encryption type to disable
2187 * @return Return an error code or 0.
2189 * @ingroup krb5_crypto
2192 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2193 krb5_enctype_disable(krb5_context context,
2194 krb5_enctype enctype)
2196 struct _krb5_encryption_type *et = _krb5_find_enctype(enctype);
2197 if(et == NULL) {
2198 if (context)
2199 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
2200 N_("encryption type %d not supported", ""),
2201 enctype);
2202 return KRB5_PROG_ETYPE_NOSUPP;
2204 et->flags |= F_DISABLED;
2205 return 0;
2209 * Enable encryption type
2211 * @param context Kerberos 5 context
2212 * @param enctype encryption type to enable
2214 * @return Return an error code or 0.
2216 * @ingroup krb5_crypto
2219 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2220 krb5_enctype_enable(krb5_context context,
2221 krb5_enctype enctype)
2223 struct _krb5_encryption_type *et = _krb5_find_enctype(enctype);
2224 if(et == NULL) {
2225 if (context)
2226 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
2227 N_("encryption type %d not supported", ""),
2228 enctype);
2229 return KRB5_PROG_ETYPE_NOSUPP;
2231 et->flags &= ~F_DISABLED;
2232 return 0;
2236 * Enable or disable all weak encryption types
2238 * @param context Kerberos 5 context
2239 * @param enable true to enable, false to disable
2241 * @return Return an error code or 0.
2243 * @ingroup krb5_crypto
2246 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2247 krb5_allow_weak_crypto(krb5_context context,
2248 krb5_boolean enable)
2250 int i;
2252 for(i = 0; i < _krb5_num_etypes; i++)
2253 if(_krb5_etypes[i]->flags & F_WEAK) {
2254 if(enable)
2255 _krb5_etypes[i]->flags &= ~F_DISABLED;
2256 else
2257 _krb5_etypes[i]->flags |= F_DISABLED;
2259 return 0;
2263 * Returns is the encryption is strong or weak
2265 * @param context Kerberos 5 context
2266 * @param enctype encryption type to probe
2268 * @return Returns true if encryption type is weak or is not supported.
2270 * @ingroup krb5_crypto
2273 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
2274 krb5_is_enctype_weak(krb5_context context, krb5_enctype enctype)
2276 struct _krb5_encryption_type *et = _krb5_find_enctype(enctype);
2277 if(et == NULL || (et->flags & F_WEAK))
2278 return TRUE;
2279 return FALSE;
2282 static size_t
2283 wrapped_length (krb5_context context,
2284 krb5_crypto crypto,
2285 size_t data_len)
2287 struct _krb5_encryption_type *et = crypto->et;
2288 size_t padsize = et->padsize;
2289 size_t checksumsize = CHECKSUMSIZE(et->checksum);
2290 size_t res;
2292 res = et->confoundersize + checksumsize + data_len;
2293 res = (res + padsize - 1) / padsize * padsize;
2294 return res;
2297 static size_t
2298 wrapped_length_dervied (krb5_context context,
2299 krb5_crypto crypto,
2300 size_t data_len)
2302 struct _krb5_encryption_type *et = crypto->et;
2303 size_t padsize = et->padsize;
2304 size_t res;
2306 res = et->confoundersize + data_len;
2307 res = (res + padsize - 1) / padsize * padsize;
2308 if (et->keyed_checksum)
2309 res += et->keyed_checksum->checksumsize;
2310 else
2311 res += et->checksum->checksumsize;
2312 return res;
2316 * Return the size of an encrypted packet of length `data_len'
2319 KRB5_LIB_FUNCTION size_t KRB5_LIB_CALL
2320 krb5_get_wrapped_length (krb5_context context,
2321 krb5_crypto crypto,
2322 size_t data_len)
2324 if (derived_crypto (context, crypto))
2325 return wrapped_length_dervied (context, crypto, data_len);
2326 else
2327 return wrapped_length (context, crypto, data_len);
2331 * Return the size of an encrypted packet of length `data_len'
2334 static size_t
2335 crypto_overhead (krb5_context context,
2336 krb5_crypto crypto)
2338 struct _krb5_encryption_type *et = crypto->et;
2339 size_t res;
2341 res = CHECKSUMSIZE(et->checksum);
2342 res += et->confoundersize;
2343 if (et->padsize > 1)
2344 res += et->padsize;
2345 return res;
2348 static size_t
2349 crypto_overhead_dervied (krb5_context context,
2350 krb5_crypto crypto)
2352 struct _krb5_encryption_type *et = crypto->et;
2353 size_t res;
2355 if (et->keyed_checksum)
2356 res = CHECKSUMSIZE(et->keyed_checksum);
2357 else
2358 res = CHECKSUMSIZE(et->checksum);
2359 res += et->confoundersize;
2360 if (et->padsize > 1)
2361 res += et->padsize;
2362 return res;
2365 KRB5_LIB_FUNCTION size_t KRB5_LIB_CALL
2366 krb5_crypto_overhead (krb5_context context, krb5_crypto crypto)
2368 if (derived_crypto (context, crypto))
2369 return crypto_overhead_dervied (context, crypto);
2370 else
2371 return crypto_overhead (context, crypto);
2375 * Converts the random bytestring to a protocol key according to
2376 * Kerberos crypto frame work. It may be assumed that all the bits of
2377 * the input string are equally random, even though the entropy
2378 * present in the random source may be limited.
2380 * @param context Kerberos 5 context
2381 * @param type the enctype resulting key will be of
2382 * @param data input random data to convert to a key
2383 * @param size size of input random data, at least krb5_enctype_keysize() long
2384 * @param key key, output key, free with krb5_free_keyblock_contents()
2386 * @return Return an error code or 0.
2388 * @ingroup krb5_crypto
2391 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2392 krb5_random_to_key(krb5_context context,
2393 krb5_enctype type,
2394 const void *data,
2395 size_t size,
2396 krb5_keyblock *key)
2398 krb5_error_code ret;
2399 struct _krb5_encryption_type *et = _krb5_find_enctype(type);
2400 if(et == NULL) {
2401 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2402 N_("encryption type %d not supported", ""),
2403 type);
2404 return KRB5_PROG_ETYPE_NOSUPP;
2406 if ((et->keytype->bits + 7) / 8 > size) {
2407 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2408 N_("encryption key %s needs %d bytes "
2409 "of random to make an encryption key "
2410 "out of it", ""),
2411 et->name, (int)et->keytype->size);
2412 return KRB5_PROG_ETYPE_NOSUPP;
2414 ret = krb5_data_alloc(&key->keyvalue, et->keytype->size);
2415 if(ret)
2416 return ret;
2417 key->keytype = type;
2418 if (et->keytype->random_to_key)
2419 (*et->keytype->random_to_key)(context, key, data, size);
2420 else
2421 memcpy(key->keyvalue.data, data, et->keytype->size);
2423 return 0;
2428 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2429 krb5_crypto_prf_length(krb5_context context,
2430 krb5_enctype type,
2431 size_t *length)
2433 struct _krb5_encryption_type *et = _krb5_find_enctype(type);
2435 if(et == NULL || et->prf_length == 0) {
2436 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2437 N_("encryption type %d not supported", ""),
2438 type);
2439 return KRB5_PROG_ETYPE_NOSUPP;
2442 *length = et->prf_length;
2443 return 0;
2446 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2447 krb5_crypto_prf(krb5_context context,
2448 const krb5_crypto crypto,
2449 const krb5_data *input,
2450 krb5_data *output)
2452 struct _krb5_encryption_type *et = crypto->et;
2454 krb5_data_zero(output);
2456 if(et->prf == NULL) {
2457 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2458 "kerberos prf for %s not supported",
2459 et->name);
2460 return KRB5_PROG_ETYPE_NOSUPP;
2463 return (*et->prf)(context, crypto, input, output);
2466 static krb5_error_code
2467 krb5_crypto_prfplus(krb5_context context,
2468 const krb5_crypto crypto,
2469 const krb5_data *input,
2470 size_t length,
2471 krb5_data *output)
2473 krb5_error_code ret;
2474 krb5_data input2;
2475 unsigned char i = 1;
2476 unsigned char *p;
2478 krb5_data_zero(&input2);
2479 krb5_data_zero(output);
2481 krb5_clear_error_message(context);
2483 ret = krb5_data_alloc(output, length);
2484 if (ret) goto out;
2485 ret = krb5_data_alloc(&input2, input->length + 1);
2486 if (ret) goto out;
2488 krb5_clear_error_message(context);
2490 memcpy(((unsigned char *)input2.data) + 1, input->data, input->length);
2492 p = output->data;
2494 while (length) {
2495 krb5_data block;
2497 ((unsigned char *)input2.data)[0] = i++;
2499 ret = krb5_crypto_prf(context, crypto, &input2, &block);
2500 if (ret)
2501 goto out;
2503 if (block.length < length) {
2504 memcpy(p, block.data, block.length);
2505 length -= block.length;
2506 } else {
2507 memcpy(p, block.data, length);
2508 length = 0;
2510 p += block.length;
2511 krb5_data_free(&block);
2514 out:
2515 krb5_data_free(&input2);
2516 if (ret)
2517 krb5_data_free(output);
2518 return ret;
2522 * The FX-CF2 key derivation function, used in FAST and preauth framework.
2524 * @param context Kerberos 5 context
2525 * @param crypto1 first key to combine
2526 * @param crypto2 second key to combine
2527 * @param pepper1 factor to combine with first key to garante uniqueness
2528 * @param pepper2 factor to combine with second key to garante uniqueness
2529 * @param enctype the encryption type of the resulting key
2530 * @param res allocated key, free with krb5_free_keyblock_contents()
2532 * @return Return an error code or 0.
2534 * @ingroup krb5_crypto
2537 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2538 krb5_crypto_fx_cf2(krb5_context context,
2539 const krb5_crypto crypto1,
2540 const krb5_crypto crypto2,
2541 krb5_data *pepper1,
2542 krb5_data *pepper2,
2543 krb5_enctype enctype,
2544 krb5_keyblock *res)
2546 krb5_error_code ret;
2547 krb5_data os1, os2;
2548 size_t i, keysize;
2550 memset(res, 0, sizeof(*res));
2551 krb5_data_zero(&os1);
2552 krb5_data_zero(&os2);
2554 ret = krb5_enctype_keybits(context, enctype, &keysize);
2555 if (ret)
2556 return ret;
2557 keysize = (keysize + 7) / 8;
2559 ret = krb5_crypto_prfplus(context, crypto1, pepper1, keysize, &os1);
2560 if (ret)
2561 goto out;
2562 ret = krb5_crypto_prfplus(context, crypto2, pepper2, keysize, &os2);
2563 if (ret)
2564 goto out;
2566 res->keytype = enctype;
2568 unsigned char *p1 = os1.data, *p2 = os2.data;
2569 for (i = 0; i < keysize; i++)
2570 p1[i] ^= p2[i];
2572 ret = krb5_random_to_key(context, enctype, os1.data, keysize, res);
2573 out:
2574 krb5_data_free(&os1);
2575 krb5_data_free(&os2);
2577 return ret;
2582 #ifndef HEIMDAL_SMALLER
2585 * Deprecated: keytypes doesn't exists, they are really enctypes.
2587 * @ingroup krb5_deprecated
2590 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2591 krb5_keytype_to_enctypes (krb5_context context,
2592 krb5_keytype keytype,
2593 unsigned *len,
2594 krb5_enctype **val)
2595 KRB5_DEPRECATED_FUNCTION("Use X instead")
2597 int i;
2598 unsigned n = 0;
2599 krb5_enctype *ret;
2601 for (i = _krb5_num_etypes - 1; i >= 0; --i) {
2602 if (_krb5_etypes[i]->keytype->type == keytype
2603 && !(_krb5_etypes[i]->flags & F_PSEUDO)
2604 && krb5_enctype_valid(context, _krb5_etypes[i]->type) == 0)
2605 ++n;
2607 if (n == 0) {
2608 krb5_set_error_message(context, KRB5_PROG_KEYTYPE_NOSUPP,
2609 "Keytype have no mapping");
2610 return KRB5_PROG_KEYTYPE_NOSUPP;
2613 ret = malloc(n * sizeof(*ret));
2614 if (ret == NULL && n != 0)
2615 return krb5_enomem(context);
2616 n = 0;
2617 for (i = _krb5_num_etypes - 1; i >= 0; --i) {
2618 if (_krb5_etypes[i]->keytype->type == keytype
2619 && !(_krb5_etypes[i]->flags & F_PSEUDO)
2620 && krb5_enctype_valid(context, _krb5_etypes[i]->type) == 0)
2621 ret[n++] = _krb5_etypes[i]->type;
2623 *len = n;
2624 *val = ret;
2625 return 0;
2629 * Deprecated: keytypes doesn't exists, they are really enctypes.
2631 * @ingroup krb5_deprecated
2634 /* if two enctypes have compatible keys */
2635 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
2636 krb5_enctypes_compatible_keys(krb5_context context,
2637 krb5_enctype etype1,
2638 krb5_enctype etype2)
2639 KRB5_DEPRECATED_FUNCTION("Use X instead")
2641 struct _krb5_encryption_type *e1 = _krb5_find_enctype(etype1);
2642 struct _krb5_encryption_type *e2 = _krb5_find_enctype(etype2);
2643 return e1 != NULL && e2 != NULL && e1->keytype == e2->keytype;
2646 #endif /* HEIMDAL_SMALLER */