2 * Copyright (c) 1997 - 2008 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
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
34 #define KRB5_DEPRECATED
36 #include "krb5_locl.h"
38 #ifndef HEIMDAL_SMALLER
39 #define DES3_OLD_ENCTYPE 1
42 static krb5_error_code _get_derived_key(krb5_context, krb5_crypto,
43 unsigned, struct key_data**);
44 static struct key_data *_new_derived_key(krb5_crypto crypto, unsigned usage);
46 static void free_key_schedule(krb5_context,
48 struct encryption_type *);
50 /************************************************************
52 ************************************************************/
54 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
55 krb5_enctype_keysize(krb5_context context,
59 struct encryption_type *et = _krb5_find_enctype(type);
61 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
62 N_("encryption type %d not supported", ""),
64 return KRB5_PROG_ETYPE_NOSUPP;
66 *keysize = et->keytype->size;
70 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
71 krb5_enctype_keybits(krb5_context context,
75 struct encryption_type *et = _krb5_find_enctype(type);
77 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
78 "encryption type %d not supported",
80 return KRB5_PROG_ETYPE_NOSUPP;
82 *keybits = et->keytype->bits;
86 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
87 krb5_generate_random_keyblock(krb5_context context,
92 struct encryption_type *et = _krb5_find_enctype(type);
94 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
95 N_("encryption type %d not supported", ""),
97 return KRB5_PROG_ETYPE_NOSUPP;
99 ret = krb5_data_alloc(&key->keyvalue, et->keytype->size);
103 if(et->keytype->random_key)
104 (*et->keytype->random_key)(context, key);
106 krb5_generate_random_block(key->keyvalue.data,
107 key->keyvalue.length);
111 static krb5_error_code
112 _key_schedule(krb5_context context,
113 struct key_data *key)
116 struct encryption_type *et = _krb5_find_enctype(key->key->keytype);
120 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
121 N_("encryption type %d not supported", ""),
123 return KRB5_PROG_ETYPE_NOSUPP;
128 if(kt->schedule == NULL)
130 if (key->schedule != NULL)
132 ALLOC(key->schedule, 1);
133 if(key->schedule == NULL) {
134 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
137 ret = krb5_data_alloc(key->schedule, kt->schedule_size);
140 key->schedule = NULL;
143 (*kt->schedule)(context, kt, key);
147 /************************************************************
149 ************************************************************/
151 static krb5_error_code
152 SHA1_checksum(krb5_context context,
153 struct key_data *key,
159 if (EVP_Digest(data, len, C->checksum.data, NULL, EVP_sha1(), NULL) != 1)
160 krb5_abortx(context, "sha1 checksum failed");
164 /* HMAC according to RFC2104 */
166 _krb5_internal_hmac(krb5_context context,
167 struct checksum_type *cm,
171 struct key_data *keyblock,
174 unsigned char *ipad, *opad;
179 ipad = malloc(cm->blocksize + len);
182 opad = malloc(cm->blocksize + cm->checksumsize);
187 memset(ipad, 0x36, cm->blocksize);
188 memset(opad, 0x5c, cm->blocksize);
190 if(keyblock->key->keyvalue.length > cm->blocksize){
191 (*cm->checksum)(context,
193 keyblock->key->keyvalue.data,
194 keyblock->key->keyvalue.length,
197 key = result->checksum.data;
198 key_len = result->checksum.length;
200 key = keyblock->key->keyvalue.data;
201 key_len = keyblock->key->keyvalue.length;
203 for(i = 0; i < key_len; i++){
207 memcpy(ipad + cm->blocksize, data, len);
208 (*cm->checksum)(context, keyblock, ipad, cm->blocksize + len,
210 memcpy(opad + cm->blocksize, result->checksum.data,
211 result->checksum.length);
212 (*cm->checksum)(context, keyblock, opad,
213 cm->blocksize + cm->checksumsize, usage, result);
214 memset(ipad, 0, cm->blocksize + len);
216 memset(opad, 0, cm->blocksize + cm->checksumsize);
222 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
223 krb5_hmac(krb5_context context,
224 krb5_cksumtype cktype,
231 struct checksum_type *c = _krb5_find_checksum(cktype);
236 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
237 N_("checksum type %d not supported", ""),
239 return KRB5_PROG_SUMTYPE_NOSUPP;
245 ret = _krb5_internal_hmac(context, c, data, len, usage, &kd, result);
248 krb5_free_data(context, kd.schedule);
254 _krb5_SP_HMAC_SHA1_checksum(krb5_context context,
255 struct key_data *key,
261 struct checksum_type *c = _krb5_find_checksum(CKSUMTYPE_SHA1);
266 res.checksum.data = sha1_data;
267 res.checksum.length = sizeof(sha1_data);
269 ret = _krb5_internal_hmac(context, c, data, len, usage, key, &res);
271 krb5_abortx(context, "hmac failed");
272 memcpy(result->checksum.data, res.checksum.data, result->checksum.length);
276 struct checksum_type _krb5_checksum_sha1 = {
286 struct checksum_type *
287 _krb5_find_checksum(krb5_cksumtype type)
290 for(i = 0; i < _krb5_num_checksums; i++)
291 if(_krb5_checksum_types[i]->type == type)
292 return _krb5_checksum_types[i];
296 static krb5_error_code
297 get_checksum_key(krb5_context context,
299 unsigned usage, /* not krb5_key_usage */
300 struct checksum_type *ct,
301 struct key_data **key)
303 krb5_error_code ret = 0;
305 if(ct->flags & F_DERIVED)
306 ret = _get_derived_key(context, crypto, usage, key);
307 else if(ct->flags & F_VARIANT) {
310 *key = _new_derived_key(crypto, 0xff/* KRB5_KU_RFC1510_VARIANT */);
312 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
315 ret = krb5_copy_keyblock(context, crypto->key.key, &(*key)->key);
318 for(i = 0; i < (*key)->key->keyvalue.length; i++)
319 ((unsigned char*)(*key)->key->keyvalue.data)[i] ^= 0xF0;
324 ret = _key_schedule(context, *key);
328 static krb5_error_code
329 create_checksum (krb5_context context,
330 struct checksum_type *ct,
338 struct key_data *dkey;
341 if (ct->flags & F_DISABLED) {
342 krb5_clear_error_message (context);
343 return KRB5_PROG_SUMTYPE_NOSUPP;
345 keyed_checksum = (ct->flags & F_KEYED) != 0;
346 if(keyed_checksum && crypto == NULL) {
347 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
348 N_("Checksum type %s is keyed but no "
349 "crypto context (key) was passed in", ""),
351 return KRB5_PROG_SUMTYPE_NOSUPP; /* XXX */
354 ret = get_checksum_key(context, crypto, usage, ct, &dkey);
359 result->cksumtype = ct->type;
360 ret = krb5_data_alloc(&result->checksum, ct->checksumsize);
363 return (*ct->checksum)(context, dkey, data, len, usage, result);
367 arcfour_checksum_p(struct checksum_type *ct, krb5_crypto crypto)
369 return (ct->type == CKSUMTYPE_HMAC_MD5) &&
370 (crypto->key.key->keytype == KEYTYPE_ARCFOUR);
373 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
374 krb5_create_checksum(krb5_context context,
376 krb5_key_usage usage,
382 struct checksum_type *ct = NULL;
385 /* type 0 -> pick from crypto */
387 ct = _krb5_find_checksum(type);
389 ct = crypto->et->keyed_checksum;
391 ct = crypto->et->checksum;
395 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
396 N_("checksum type %d not supported", ""),
398 return KRB5_PROG_SUMTYPE_NOSUPP;
401 if (arcfour_checksum_p(ct, crypto)) {
403 _krb5_usage2arcfour(context, &keyusage);
405 keyusage = CHECKSUM_USAGE(usage);
407 return create_checksum(context, ct, crypto, keyusage,
411 static krb5_error_code
412 verify_checksum(krb5_context context,
414 unsigned usage, /* not krb5_key_usage */
420 struct key_data *dkey;
423 struct checksum_type *ct;
425 ct = _krb5_find_checksum(cksum->cksumtype);
426 if (ct == NULL || (ct->flags & F_DISABLED)) {
427 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
428 N_("checksum type %d not supported", ""),
430 return KRB5_PROG_SUMTYPE_NOSUPP;
432 if(ct->checksumsize != cksum->checksum.length) {
433 krb5_clear_error_message (context);
434 krb5_set_error_message(context, KRB5KRB_AP_ERR_BAD_INTEGRITY,
435 N_("Decrypt integrity check failed for checksum type %s, "
436 "length was %u, expected %u", ""),
437 ct->name, (unsigned)cksum->checksum.length,
438 (unsigned)ct->checksumsize);
440 return KRB5KRB_AP_ERR_BAD_INTEGRITY; /* XXX */
442 keyed_checksum = (ct->flags & F_KEYED) != 0;
444 struct checksum_type *kct;
445 if (crypto == NULL) {
446 krb5_set_error_message(context, KRB5_PROG_SUMTYPE_NOSUPP,
447 N_("Checksum type %s is keyed but no "
448 "crypto context (key) was passed in", ""),
450 return KRB5_PROG_SUMTYPE_NOSUPP; /* XXX */
452 kct = crypto->et->keyed_checksum;
453 if (kct != NULL && kct->type != ct->type) {
454 krb5_set_error_message(context, KRB5_PROG_SUMTYPE_NOSUPP,
455 N_("Checksum type %s is keyed, but "
456 "the key type %s passed didnt have that checksum "
457 "type as the keyed type", ""),
458 ct->name, crypto->et->name);
459 return KRB5_PROG_SUMTYPE_NOSUPP; /* XXX */
462 ret = get_checksum_key(context, crypto, usage, ct, &dkey);
469 * If checksum have a verify function, lets use that instead of
470 * calling ->checksum and then compare result.
474 ret = (*ct->verify)(context, dkey, data, len, usage, cksum);
476 krb5_set_error_message(context, ret,
477 N_("Decrypt integrity check failed for checksum "
478 "type %s, key type %s", ""),
479 ct->name, crypto->et->name);
483 ret = krb5_data_alloc (&c.checksum, ct->checksumsize);
487 ret = (*ct->checksum)(context, dkey, data, len, usage, &c);
489 krb5_data_free(&c.checksum);
493 if(krb5_data_ct_cmp(&c.checksum, &cksum->checksum) != 0) {
494 ret = KRB5KRB_AP_ERR_BAD_INTEGRITY;
495 krb5_set_error_message(context, ret,
496 N_("Decrypt integrity check failed for checksum "
497 "type %s, key type %s", ""),
498 ct->name, crypto ? crypto->et->name : "(unkeyed)");
502 krb5_data_free (&c.checksum);
506 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
507 krb5_verify_checksum(krb5_context context,
509 krb5_key_usage usage,
514 struct checksum_type *ct;
517 ct = _krb5_find_checksum(cksum->cksumtype);
519 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
520 N_("checksum type %d not supported", ""),
522 return KRB5_PROG_SUMTYPE_NOSUPP;
525 if (arcfour_checksum_p(ct, crypto)) {
527 _krb5_usage2arcfour(context, &keyusage);
529 keyusage = CHECKSUM_USAGE(usage);
531 return verify_checksum(context, crypto, keyusage,
535 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
536 krb5_crypto_get_checksum_type(krb5_context context,
538 krb5_cksumtype *type)
540 struct checksum_type *ct = NULL;
542 if (crypto != NULL) {
543 ct = crypto->et->keyed_checksum;
545 ct = crypto->et->checksum;
549 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
550 N_("checksum type not found", ""));
551 return KRB5_PROG_SUMTYPE_NOSUPP;
560 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
561 krb5_checksumsize(krb5_context context,
565 struct checksum_type *ct = _krb5_find_checksum(type);
567 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
568 N_("checksum type %d not supported", ""),
570 return KRB5_PROG_SUMTYPE_NOSUPP;
572 *size = ct->checksumsize;
576 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
577 krb5_checksum_is_keyed(krb5_context context,
580 struct checksum_type *ct = _krb5_find_checksum(type);
583 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
584 N_("checksum type %d not supported", ""),
586 return KRB5_PROG_SUMTYPE_NOSUPP;
588 return ct->flags & F_KEYED;
591 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
592 krb5_checksum_is_collision_proof(krb5_context context,
595 struct checksum_type *ct = _krb5_find_checksum(type);
598 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
599 N_("checksum type %d not supported", ""),
601 return KRB5_PROG_SUMTYPE_NOSUPP;
603 return ct->flags & F_CPROOF;
606 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
607 krb5_checksum_disable(krb5_context context,
610 struct checksum_type *ct = _krb5_find_checksum(type);
613 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
614 N_("checksum type %d not supported", ""),
616 return KRB5_PROG_SUMTYPE_NOSUPP;
618 ct->flags |= F_DISABLED;
622 /************************************************************
624 ************************************************************/
626 struct encryption_type *
627 _krb5_find_enctype(krb5_enctype type)
630 for(i = 0; i < _krb5_num_etypes; i++)
631 if(_krb5_etypes[i]->type == type)
632 return _krb5_etypes[i];
637 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
638 krb5_enctype_to_string(krb5_context context,
642 struct encryption_type *e;
643 e = _krb5_find_enctype(etype);
645 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
646 N_("encryption type %d not supported", ""),
649 return KRB5_PROG_ETYPE_NOSUPP;
651 *string = strdup(e->name);
652 if(*string == NULL) {
653 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
659 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
660 krb5_string_to_enctype(krb5_context context,
665 for(i = 0; i < _krb5_num_etypes; i++)
666 if(strcasecmp(_krb5_etypes[i]->name, string) == 0){
667 *etype = _krb5_etypes[i]->type;
670 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
671 N_("encryption type %s not supported", ""),
673 return KRB5_PROG_ETYPE_NOSUPP;
676 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
677 krb5_enctype_to_keytype(krb5_context context,
679 krb5_keytype *keytype)
681 struct encryption_type *e = _krb5_find_enctype(etype);
683 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
684 N_("encryption type %d not supported", ""),
686 return KRB5_PROG_ETYPE_NOSUPP;
688 *keytype = e->keytype->type; /* XXX */
692 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
693 krb5_enctype_valid(krb5_context context,
696 struct encryption_type *e = _krb5_find_enctype(etype);
698 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
699 N_("encryption type %d not supported", ""),
701 return KRB5_PROG_ETYPE_NOSUPP;
703 if (e->flags & F_DISABLED) {
704 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
705 N_("encryption type %s is disabled", ""),
707 return KRB5_PROG_ETYPE_NOSUPP;
713 * Return the coresponding encryption type for a checksum type.
715 * @param context Kerberos context
716 * @param ctype The checksum type to get the result enctype for
717 * @param etype The returned encryption, when the matching etype is
718 * not found, etype is set to ETYPE_NULL.
720 * @return Return an error code for an failure or 0 on success.
721 * @ingroup krb5_crypto
725 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
726 krb5_cksumtype_to_enctype(krb5_context context,
727 krb5_cksumtype ctype,
734 for(i = 0; i < _krb5_num_etypes; i++) {
735 if(_krb5_etypes[i]->keyed_checksum &&
736 _krb5_etypes[i]->keyed_checksum->type == ctype)
738 *etype = _krb5_etypes[i]->type;
743 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
744 N_("checksum type %d not supported", ""),
746 return KRB5_PROG_SUMTYPE_NOSUPP;
750 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
751 krb5_cksumtype_valid(krb5_context context,
752 krb5_cksumtype ctype)
754 struct checksum_type *c = _krb5_find_checksum(ctype);
756 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
757 N_("checksum type %d not supported", ""),
759 return KRB5_PROG_SUMTYPE_NOSUPP;
761 if (c->flags & F_DISABLED) {
762 krb5_set_error_message (context, KRB5_PROG_SUMTYPE_NOSUPP,
763 N_("checksum type %s is disabled", ""),
765 return KRB5_PROG_SUMTYPE_NOSUPP;
772 derived_crypto(krb5_context context,
775 return (crypto->et->flags & F_DERIVED) != 0;
779 special_crypto(krb5_context context,
782 return (crypto->et->flags & F_SPECIAL) != 0;
785 #define CHECKSUMSIZE(C) ((C)->checksumsize)
786 #define CHECKSUMTYPE(C) ((C)->type)
788 static krb5_error_code
789 encrypt_internal_derived(krb5_context context,
797 size_t sz, block_sz, checksum_sz, total_sz;
799 unsigned char *p, *q;
801 struct key_data *dkey;
802 const struct encryption_type *et = crypto->et;
804 checksum_sz = CHECKSUMSIZE(et->keyed_checksum);
806 sz = et->confoundersize + len;
807 block_sz = (sz + et->padsize - 1) &~ (et->padsize - 1); /* pad */
808 total_sz = block_sz + checksum_sz;
809 p = calloc(1, total_sz);
811 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
816 krb5_generate_random_block(q, et->confoundersize); /* XXX */
817 q += et->confoundersize;
818 memcpy(q, data, len);
820 ret = create_checksum(context,
823 INTEGRITY_USAGE(usage),
827 if(ret == 0 && cksum.checksum.length != checksum_sz) {
828 free_Checksum (&cksum);
829 krb5_clear_error_message (context);
830 ret = KRB5_CRYPTO_INTERNAL;
834 memcpy(p + block_sz, cksum.checksum.data, cksum.checksum.length);
835 free_Checksum (&cksum);
836 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
839 ret = _key_schedule(context, dkey);
842 ret = (*et->encrypt)(context, dkey, p, block_sz, 1, usage, ivec);
846 result->length = total_sz;
849 memset(p, 0, total_sz);
855 static krb5_error_code
856 encrypt_internal(krb5_context context,
863 size_t sz, block_sz, checksum_sz;
865 unsigned char *p, *q;
867 const struct encryption_type *et = crypto->et;
869 checksum_sz = CHECKSUMSIZE(et->checksum);
871 sz = et->confoundersize + checksum_sz + len;
872 block_sz = (sz + et->padsize - 1) &~ (et->padsize - 1); /* pad */
873 p = calloc(1, block_sz);
875 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
880 krb5_generate_random_block(q, et->confoundersize); /* XXX */
881 q += et->confoundersize;
882 memset(q, 0, checksum_sz);
884 memcpy(q, data, len);
886 ret = create_checksum(context,
893 if(ret == 0 && cksum.checksum.length != checksum_sz) {
894 krb5_clear_error_message (context);
895 free_Checksum(&cksum);
896 ret = KRB5_CRYPTO_INTERNAL;
900 memcpy(p + et->confoundersize, cksum.checksum.data, cksum.checksum.length);
901 free_Checksum(&cksum);
902 ret = _key_schedule(context, &crypto->key);
905 ret = (*et->encrypt)(context, &crypto->key, p, block_sz, 1, 0, ivec);
907 memset(p, 0, block_sz);
912 result->length = block_sz;
915 memset(p, 0, block_sz);
920 static krb5_error_code
921 encrypt_internal_special(krb5_context context,
929 struct encryption_type *et = crypto->et;
930 size_t cksum_sz = CHECKSUMSIZE(et->checksum);
931 size_t sz = len + cksum_sz + et->confoundersize;
937 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
941 memset (p, 0, cksum_sz);
943 krb5_generate_random_block(p, et->confoundersize);
944 p += et->confoundersize;
945 memcpy (p, data, len);
946 ret = (*et->encrypt)(context, &crypto->key, tmp, sz, TRUE, usage, ivec);
957 static krb5_error_code
958 decrypt_internal_derived(krb5_context context,
970 struct key_data *dkey;
971 struct encryption_type *et = crypto->et;
974 checksum_sz = CHECKSUMSIZE(et->keyed_checksum);
975 if (len < checksum_sz + et->confoundersize) {
976 krb5_set_error_message(context, KRB5_BAD_MSIZE,
977 N_("Encrypted data shorter then "
978 "checksum + confunder", ""));
979 return KRB5_BAD_MSIZE;
982 if (((len - checksum_sz) % et->padsize) != 0) {
983 krb5_clear_error_message(context);
984 return KRB5_BAD_MSIZE;
988 if(len != 0 && p == NULL) {
989 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
992 memcpy(p, data, len);
996 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
1001 ret = _key_schedule(context, dkey);
1006 ret = (*et->encrypt)(context, dkey, p, len, 0, usage, ivec);
1012 cksum.checksum.data = p + len;
1013 cksum.checksum.length = checksum_sz;
1014 cksum.cksumtype = CHECKSUMTYPE(et->keyed_checksum);
1016 ret = verify_checksum(context,
1018 INTEGRITY_USAGE(usage),
1026 l = len - et->confoundersize;
1027 memmove(p, p + et->confoundersize, l);
1028 result->data = realloc(p, l);
1029 if(result->data == NULL && l != 0) {
1031 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
1038 static krb5_error_code
1039 decrypt_internal(krb5_context context,
1046 krb5_error_code ret;
1049 size_t checksum_sz, l;
1050 struct encryption_type *et = crypto->et;
1052 if ((len % et->padsize) != 0) {
1053 krb5_clear_error_message(context);
1054 return KRB5_BAD_MSIZE;
1056 checksum_sz = CHECKSUMSIZE(et->checksum);
1057 if (len < checksum_sz + et->confoundersize) {
1058 krb5_set_error_message(context, KRB5_BAD_MSIZE,
1059 N_("Encrypted data shorter then "
1060 "checksum + confunder", ""));
1061 return KRB5_BAD_MSIZE;
1065 if(len != 0 && p == NULL) {
1066 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
1069 memcpy(p, data, len);
1071 ret = _key_schedule(context, &crypto->key);
1076 ret = (*et->encrypt)(context, &crypto->key, p, len, 0, 0, ivec);
1081 ret = krb5_data_copy(&cksum.checksum, p + et->confoundersize, checksum_sz);
1086 memset(p + et->confoundersize, 0, checksum_sz);
1087 cksum.cksumtype = CHECKSUMTYPE(et->checksum);
1088 ret = verify_checksum(context, NULL, 0, p, len, &cksum);
1089 free_Checksum(&cksum);
1094 l = len - et->confoundersize - checksum_sz;
1095 memmove(p, p + et->confoundersize + checksum_sz, l);
1096 result->data = realloc(p, l);
1097 if(result->data == NULL && l != 0) {
1099 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
1106 static krb5_error_code
1107 decrypt_internal_special(krb5_context context,
1115 struct encryption_type *et = crypto->et;
1116 size_t cksum_sz = CHECKSUMSIZE(et->checksum);
1117 size_t sz = len - cksum_sz - et->confoundersize;
1119 krb5_error_code ret;
1121 if ((len % et->padsize) != 0) {
1122 krb5_clear_error_message(context);
1123 return KRB5_BAD_MSIZE;
1125 if (len < cksum_sz + et->confoundersize) {
1126 krb5_set_error_message(context, KRB5_BAD_MSIZE,
1127 N_("Encrypted data shorter then "
1128 "checksum + confunder", ""));
1129 return KRB5_BAD_MSIZE;
1134 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
1137 memcpy(p, data, len);
1139 ret = (*et->encrypt)(context, &crypto->key, p, len, FALSE, usage, ivec);
1145 memmove (p, p + cksum_sz + et->confoundersize, sz);
1146 result->data = realloc(p, sz);
1147 if(result->data == NULL && sz != 0) {
1149 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
1152 result->length = sz;
1156 static krb5_crypto_iov *
1157 find_iv(krb5_crypto_iov *data, int num_data, int type)
1160 for (i = 0; i < num_data; i++)
1161 if (data[i].flags == type)
1167 * Inline encrypt a kerberos message
1169 * @param context Kerberos context
1170 * @param crypto Kerberos crypto context
1171 * @param usage Key usage for this buffer
1172 * @param data array of buffers to process
1173 * @param num_data length of array
1174 * @param ivec initial cbc/cts vector
1176 * @return Return an error code or 0.
1177 * @ingroup krb5_crypto
1179 * Kerberos encrypted data look like this:
1181 * 1. KRB5_CRYPTO_TYPE_HEADER
1182 * 2. array [1,...] KRB5_CRYPTO_TYPE_DATA and array [0,...]
1183 * KRB5_CRYPTO_TYPE_SIGN_ONLY in any order, however the receiver
1184 * have to aware of the order. KRB5_CRYPTO_TYPE_SIGN_ONLY is
1185 * commonly used headers and trailers.
1186 * 3. KRB5_CRYPTO_TYPE_PADDING, at least on padsize long if padsize > 1
1187 * 4. KRB5_CRYPTO_TYPE_TRAILER
1190 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1191 krb5_encrypt_iov_ivec(krb5_context context,
1194 krb5_crypto_iov *data,
1198 size_t headersz, trailersz, len;
1200 size_t sz, block_sz, pad_sz;
1202 unsigned char *p, *q;
1203 krb5_error_code ret;
1204 struct key_data *dkey;
1205 const struct encryption_type *et = crypto->et;
1206 krb5_crypto_iov *tiv, *piv, *hiv;
1209 krb5_clear_error_message(context);
1210 return KRB5_CRYPTO_INTERNAL;
1213 if(!derived_crypto(context, crypto)) {
1214 krb5_clear_error_message(context);
1215 return KRB5_CRYPTO_INTERNAL;
1218 headersz = et->confoundersize;
1219 trailersz = CHECKSUMSIZE(et->keyed_checksum);
1221 for (len = 0, i = 0; i < num_data; i++) {
1222 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1224 len += data[i].data.length;
1227 sz = headersz + len;
1228 block_sz = (sz + et->padsize - 1) &~ (et->padsize - 1); /* pad */
1230 pad_sz = block_sz - sz;
1234 hiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_HEADER);
1235 if (hiv == NULL || hiv->data.length != headersz)
1236 return KRB5_BAD_MSIZE;
1238 krb5_generate_random_block(hiv->data.data, hiv->data.length);
1241 piv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_PADDING);
1242 /* its ok to have no TYPE_PADDING if there is no padding */
1243 if (piv == NULL && pad_sz != 0)
1244 return KRB5_BAD_MSIZE;
1246 if (piv->data.length < pad_sz)
1247 return KRB5_BAD_MSIZE;
1248 piv->data.length = pad_sz;
1250 memset(piv->data.data, pad_sz, pad_sz);
1256 tiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_TRAILER);
1257 if (tiv == NULL || tiv->data.length != trailersz)
1258 return KRB5_BAD_MSIZE;
1261 * XXX replace with EVP_Sign? at least make create_checksum an iov
1263 * XXX CTS EVP is broken, can't handle multi buffers :(
1267 for (i = 0; i < num_data; i++) {
1268 if (data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1270 len += data[i].data.length;
1273 p = q = malloc(len);
1275 memcpy(q, hiv->data.data, hiv->data.length);
1276 q += hiv->data.length;
1277 for (i = 0; i < num_data; i++) {
1278 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1279 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1281 memcpy(q, data[i].data.data, data[i].data.length);
1282 q += data[i].data.length;
1285 memset(q, 0, piv->data.length);
1287 ret = create_checksum(context,
1290 INTEGRITY_USAGE(usage),
1295 if(ret == 0 && cksum.checksum.length != trailersz) {
1296 free_Checksum (&cksum);
1297 krb5_clear_error_message (context);
1298 ret = KRB5_CRYPTO_INTERNAL;
1303 /* save cksum at end */
1304 memcpy(tiv->data.data, cksum.checksum.data, cksum.checksum.length);
1305 free_Checksum (&cksum);
1307 /* XXX replace with EVP_Cipher */
1308 p = q = malloc(block_sz);
1312 memcpy(q, hiv->data.data, hiv->data.length);
1313 q += hiv->data.length;
1315 for (i = 0; i < num_data; i++) {
1316 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1318 memcpy(q, data[i].data.data, data[i].data.length);
1319 q += data[i].data.length;
1322 memset(q, 0, piv->data.length);
1325 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
1330 ret = _key_schedule(context, dkey);
1336 ret = (*et->encrypt)(context, dkey, p, block_sz, 1, usage, ivec);
1342 /* now copy data back to buffers */
1345 memcpy(hiv->data.data, q, hiv->data.length);
1346 q += hiv->data.length;
1348 for (i = 0; i < num_data; i++) {
1349 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1351 memcpy(data[i].data.data, q, data[i].data.length);
1352 q += data[i].data.length;
1355 memcpy(piv->data.data, q, pad_sz);
1363 * Inline decrypt a Kerberos message.
1365 * @param context Kerberos context
1366 * @param crypto Kerberos crypto context
1367 * @param usage Key usage for this buffer
1368 * @param data array of buffers to process
1369 * @param num_data length of array
1370 * @param ivec initial cbc/cts vector
1372 * @return Return an error code or 0.
1373 * @ingroup krb5_crypto
1375 * 1. KRB5_CRYPTO_TYPE_HEADER
1376 * 2. one KRB5_CRYPTO_TYPE_DATA and array [0,...] of KRB5_CRYPTO_TYPE_SIGN_ONLY in
1377 * any order, however the receiver have to aware of the
1378 * order. KRB5_CRYPTO_TYPE_SIGN_ONLY is commonly used unencrypoted
1379 * protocol headers and trailers. The output data will be of same
1380 * size as the input data or shorter.
1383 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1384 krb5_decrypt_iov_ivec(krb5_context context,
1387 krb5_crypto_iov *data,
1388 unsigned int num_data,
1392 size_t headersz, trailersz, len;
1394 unsigned char *p, *q;
1395 krb5_error_code ret;
1396 struct key_data *dkey;
1397 struct encryption_type *et = crypto->et;
1398 krb5_crypto_iov *tiv, *hiv;
1401 krb5_clear_error_message(context);
1402 return KRB5_CRYPTO_INTERNAL;
1405 if(!derived_crypto(context, crypto)) {
1406 krb5_clear_error_message(context);
1407 return KRB5_CRYPTO_INTERNAL;
1410 headersz = et->confoundersize;
1412 hiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_HEADER);
1413 if (hiv == NULL || hiv->data.length != headersz)
1414 return KRB5_BAD_MSIZE;
1417 trailersz = CHECKSUMSIZE(et->keyed_checksum);
1419 tiv = find_iv(data, num_data, KRB5_CRYPTO_TYPE_TRAILER);
1420 if (tiv->data.length != trailersz)
1421 return KRB5_BAD_MSIZE;
1423 /* Find length of data we will decrypt */
1426 for (i = 0; i < num_data; i++) {
1427 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1429 len += data[i].data.length;
1432 if ((len % et->padsize) != 0) {
1433 krb5_clear_error_message(context);
1434 return KRB5_BAD_MSIZE;
1437 /* XXX replace with EVP_Cipher */
1439 p = q = malloc(len);
1443 memcpy(q, hiv->data.data, hiv->data.length);
1444 q += hiv->data.length;
1446 for (i = 0; i < num_data; i++) {
1447 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1449 memcpy(q, data[i].data.data, data[i].data.length);
1450 q += data[i].data.length;
1453 ret = _get_derived_key(context, crypto, ENCRYPTION_USAGE(usage), &dkey);
1458 ret = _key_schedule(context, dkey);
1464 ret = (*et->encrypt)(context, dkey, p, len, 0, usage, ivec);
1470 /* copy data back to buffers */
1471 memcpy(hiv->data.data, p, hiv->data.length);
1472 q = p + hiv->data.length;
1473 for (i = 0; i < num_data; i++) {
1474 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA)
1476 memcpy(data[i].data.data, q, data[i].data.length);
1477 q += data[i].data.length;
1482 /* check signature */
1483 for (i = 0; i < num_data; i++) {
1484 if (data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1486 len += data[i].data.length;
1489 p = q = malloc(len);
1493 memcpy(q, hiv->data.data, hiv->data.length);
1494 q += hiv->data.length;
1495 for (i = 0; i < num_data; i++) {
1496 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1497 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1499 memcpy(q, data[i].data.data, data[i].data.length);
1500 q += data[i].data.length;
1503 cksum.checksum.data = tiv->data.data;
1504 cksum.checksum.length = tiv->data.length;
1505 cksum.cksumtype = CHECKSUMTYPE(et->keyed_checksum);
1507 ret = verify_checksum(context,
1509 INTEGRITY_USAGE(usage),
1518 * Create a Kerberos message checksum.
1520 * @param context Kerberos context
1521 * @param crypto Kerberos crypto context
1522 * @param usage Key usage for this buffer
1523 * @param data array of buffers to process
1524 * @param num_data length of array
1525 * @param type output data
1527 * @return Return an error code or 0.
1528 * @ingroup krb5_crypto
1531 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1532 krb5_create_checksum_iov(krb5_context context,
1535 krb5_crypto_iov *data,
1536 unsigned int num_data,
1537 krb5_cksumtype *type)
1540 krb5_crypto_iov *civ;
1541 krb5_error_code ret;
1547 krb5_clear_error_message(context);
1548 return KRB5_CRYPTO_INTERNAL;
1551 if(!derived_crypto(context, crypto)) {
1552 krb5_clear_error_message(context);
1553 return KRB5_CRYPTO_INTERNAL;
1556 civ = find_iv(data, num_data, KRB5_CRYPTO_TYPE_CHECKSUM);
1558 return KRB5_BAD_MSIZE;
1561 for (i = 0; i < num_data; i++) {
1562 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1563 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1565 len += data[i].data.length;
1568 p = q = malloc(len);
1570 for (i = 0; i < num_data; i++) {
1571 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1572 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1574 memcpy(q, data[i].data.data, data[i].data.length);
1575 q += data[i].data.length;
1578 ret = krb5_create_checksum(context, crypto, usage, 0, p, len, &cksum);
1584 *type = cksum.cksumtype;
1586 if (cksum.checksum.length > civ->data.length) {
1587 krb5_set_error_message(context, KRB5_BAD_MSIZE,
1588 N_("Checksum larger then input buffer", ""));
1589 free_Checksum(&cksum);
1590 return KRB5_BAD_MSIZE;
1593 civ->data.length = cksum.checksum.length;
1594 memcpy(civ->data.data, cksum.checksum.data, civ->data.length);
1595 free_Checksum(&cksum);
1601 * Verify a Kerberos message checksum.
1603 * @param context Kerberos context
1604 * @param crypto Kerberos crypto context
1605 * @param usage Key usage for this buffer
1606 * @param data array of buffers to process
1607 * @param num_data length of array
1608 * @param type return checksum type if not NULL
1610 * @return Return an error code or 0.
1611 * @ingroup krb5_crypto
1614 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1615 krb5_verify_checksum_iov(krb5_context context,
1618 krb5_crypto_iov *data,
1619 unsigned int num_data,
1620 krb5_cksumtype *type)
1622 struct encryption_type *et = crypto->et;
1624 krb5_crypto_iov *civ;
1625 krb5_error_code ret;
1631 krb5_clear_error_message(context);
1632 return KRB5_CRYPTO_INTERNAL;
1635 if(!derived_crypto(context, crypto)) {
1636 krb5_clear_error_message(context);
1637 return KRB5_CRYPTO_INTERNAL;
1640 civ = find_iv(data, num_data, KRB5_CRYPTO_TYPE_CHECKSUM);
1642 return KRB5_BAD_MSIZE;
1645 for (i = 0; i < num_data; i++) {
1646 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1647 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1649 len += data[i].data.length;
1652 p = q = malloc(len);
1654 for (i = 0; i < num_data; i++) {
1655 if (data[i].flags != KRB5_CRYPTO_TYPE_DATA &&
1656 data[i].flags != KRB5_CRYPTO_TYPE_SIGN_ONLY)
1658 memcpy(q, data[i].data.data, data[i].data.length);
1659 q += data[i].data.length;
1662 cksum.cksumtype = CHECKSUMTYPE(et->keyed_checksum);
1663 cksum.checksum.length = civ->data.length;
1664 cksum.checksum.data = civ->data.data;
1666 ret = krb5_verify_checksum(context, crypto, usage, p, len, &cksum);
1669 if (ret == 0 && type)
1670 *type = cksum.cksumtype;
1676 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1677 krb5_crypto_length(krb5_context context,
1682 if (!derived_crypto(context, crypto)) {
1683 krb5_set_error_message(context, EINVAL, "not a derived crypto");
1688 case KRB5_CRYPTO_TYPE_EMPTY:
1691 case KRB5_CRYPTO_TYPE_HEADER:
1692 *len = crypto->et->blocksize;
1694 case KRB5_CRYPTO_TYPE_DATA:
1695 case KRB5_CRYPTO_TYPE_SIGN_ONLY:
1696 /* len must already been filled in */
1698 case KRB5_CRYPTO_TYPE_PADDING:
1699 if (crypto->et->padsize > 1)
1700 *len = crypto->et->padsize;
1704 case KRB5_CRYPTO_TYPE_TRAILER:
1705 *len = CHECKSUMSIZE(crypto->et->keyed_checksum);
1707 case KRB5_CRYPTO_TYPE_CHECKSUM:
1708 if (crypto->et->keyed_checksum)
1709 *len = CHECKSUMSIZE(crypto->et->keyed_checksum);
1711 *len = CHECKSUMSIZE(crypto->et->checksum);
1714 krb5_set_error_message(context, EINVAL,
1715 "%d not a supported type", type);
1720 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1721 krb5_crypto_length_iov(krb5_context context,
1723 krb5_crypto_iov *data,
1724 unsigned int num_data)
1726 krb5_error_code ret;
1729 for (i = 0; i < num_data; i++) {
1730 ret = krb5_crypto_length(context, crypto,
1732 &data[i].data.length);
1740 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1741 krb5_encrypt_ivec(krb5_context context,
1749 if(derived_crypto(context, crypto))
1750 return encrypt_internal_derived(context, crypto, usage,
1751 data, len, result, ivec);
1752 else if (special_crypto(context, crypto))
1753 return encrypt_internal_special (context, crypto, usage,
1754 data, len, result, ivec);
1756 return encrypt_internal(context, crypto, data, len, result, ivec);
1759 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1760 krb5_encrypt(krb5_context context,
1767 return krb5_encrypt_ivec(context, crypto, usage, data, len, result, NULL);
1770 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1771 krb5_encrypt_EncryptedData(krb5_context context,
1777 EncryptedData *result)
1779 result->etype = CRYPTO_ETYPE(crypto);
1781 ALLOC(result->kvno, 1);
1782 *result->kvno = kvno;
1784 result->kvno = NULL;
1785 return krb5_encrypt(context, crypto, usage, data, len, &result->cipher);
1788 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1789 krb5_decrypt_ivec(krb5_context context,
1797 if(derived_crypto(context, crypto))
1798 return decrypt_internal_derived(context, crypto, usage,
1799 data, len, result, ivec);
1800 else if (special_crypto (context, crypto))
1801 return decrypt_internal_special(context, crypto, usage,
1802 data, len, result, ivec);
1804 return decrypt_internal(context, crypto, data, len, result, ivec);
1807 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1808 krb5_decrypt(krb5_context context,
1815 return krb5_decrypt_ivec (context, crypto, usage, data, len, result,
1819 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1820 krb5_decrypt_EncryptedData(krb5_context context,
1823 const EncryptedData *e,
1826 return krb5_decrypt(context, crypto, usage,
1827 e->cipher.data, e->cipher.length, result);
1830 /************************************************************
1832 ************************************************************/
1835 _krb5_derive_key(krb5_context context,
1836 struct encryption_type *et,
1837 struct key_data *key,
1838 const void *constant,
1841 unsigned char *k = NULL;
1842 unsigned int nblocks = 0, i;
1843 krb5_error_code ret = 0;
1844 struct key_type *kt = et->keytype;
1846 ret = _key_schedule(context, key);
1849 if(et->blocksize * 8 < kt->bits || len != et->blocksize) {
1850 nblocks = (kt->bits + et->blocksize * 8 - 1) / (et->blocksize * 8);
1851 k = malloc(nblocks * et->blocksize);
1854 krb5_set_error_message(context, ret, N_("malloc: out of memory", ""));
1857 ret = _krb5_n_fold(constant, len, k, et->blocksize);
1859 krb5_set_error_message(context, ret, N_("malloc: out of memory", ""));
1863 for(i = 0; i < nblocks; i++) {
1865 memcpy(k + i * et->blocksize,
1866 k + (i - 1) * et->blocksize,
1868 (*et->encrypt)(context, key, k + i * et->blocksize, et->blocksize,
1872 /* this case is probably broken, but won't be run anyway */
1873 void *c = malloc(len);
1874 size_t res_len = (kt->bits + 7) / 8;
1876 if(len != 0 && c == NULL) {
1878 krb5_set_error_message(context, ret, N_("malloc: out of memory", ""));
1881 memcpy(c, constant, len);
1882 (*et->encrypt)(context, key, c, len, 1, 0, NULL);
1883 k = malloc(res_len);
1884 if(res_len != 0 && k == NULL) {
1887 krb5_set_error_message(context, ret, N_("malloc: out of memory", ""));
1890 ret = _krb5_n_fold(c, len, k, res_len);
1893 krb5_set_error_message(context, ret, N_("malloc: out of memory", ""));
1898 /* XXX keytype dependent post-processing */
1901 _krb5_DES3_random_to_key(context, key->key, k, nblocks * et->blocksize);
1903 case KEYTYPE_AES128:
1904 case KEYTYPE_AES256:
1905 memcpy(key->key->keyvalue.data, k, key->key->keyvalue.length);
1908 ret = KRB5_CRYPTO_INTERNAL;
1909 krb5_set_error_message(context, ret,
1910 N_("derive_key() called with unknown keytype (%u)", ""),
1915 if (key->schedule) {
1916 free_key_schedule(context, key, et);
1917 key->schedule = NULL;
1920 memset(k, 0, nblocks * et->blocksize);
1926 static struct key_data *
1927 _new_derived_key(krb5_crypto crypto, unsigned usage)
1929 struct key_usage *d = crypto->key_usage;
1930 d = realloc(d, (crypto->num_key_usage + 1) * sizeof(*d));
1933 crypto->key_usage = d;
1934 d += crypto->num_key_usage++;
1935 memset(d, 0, sizeof(*d));
1940 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1941 krb5_derive_key(krb5_context context,
1942 const krb5_keyblock *key,
1944 const void *constant,
1945 size_t constant_len,
1946 krb5_keyblock **derived_key)
1948 krb5_error_code ret;
1949 struct encryption_type *et;
1952 *derived_key = NULL;
1954 et = _krb5_find_enctype (etype);
1956 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
1957 N_("encryption type %d not supported", ""),
1959 return KRB5_PROG_ETYPE_NOSUPP;
1962 ret = krb5_copy_keyblock(context, key, &d.key);
1967 ret = _krb5_derive_key(context, et, &d, constant, constant_len);
1969 ret = krb5_copy_keyblock(context, d.key, derived_key);
1970 _krb5_free_key_data(context, &d, et);
1974 static krb5_error_code
1975 _get_derived_key(krb5_context context,
1978 struct key_data **key)
1982 unsigned char constant[5];
1984 for(i = 0; i < crypto->num_key_usage; i++)
1985 if(crypto->key_usage[i].usage == usage) {
1986 *key = &crypto->key_usage[i].key;
1989 d = _new_derived_key(crypto, usage);
1991 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
1994 krb5_copy_keyblock(context, crypto->key.key, &d->key);
1995 _krb5_put_int(constant, usage, 5);
1996 _krb5_derive_key(context, crypto->et, d, constant, sizeof(constant));
2002 * Create a crypto context used for all encryption and signature
2003 * operation. The encryption type to use is taken from the key, but
2004 * can be overridden with the enctype parameter. This can be useful
2005 * for encryptions types which is compatiable (DES for example).
2007 * To free the crypto context, use krb5_crypto_destroy().
2009 * @param context Kerberos context
2010 * @param key the key block information with all key data
2011 * @param etype the encryption type
2012 * @param crypto the resulting crypto context
2014 * @return Return an error code or 0.
2016 * @ingroup krb5_crypto
2019 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2020 krb5_crypto_init(krb5_context context,
2021 const krb5_keyblock *key,
2023 krb5_crypto *crypto)
2025 krb5_error_code ret;
2027 if(*crypto == NULL) {
2028 krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
2031 if(etype == ETYPE_NULL)
2032 etype = key->keytype;
2033 (*crypto)->et = _krb5_find_enctype(etype);
2034 if((*crypto)->et == NULL || ((*crypto)->et->flags & F_DISABLED)) {
2037 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
2038 N_("encryption type %d not supported", ""),
2040 return KRB5_PROG_ETYPE_NOSUPP;
2042 if((*crypto)->et->keytype->size != key->keyvalue.length) {
2045 krb5_set_error_message (context, KRB5_BAD_KEYSIZE,
2046 "encryption key has bad length");
2047 return KRB5_BAD_KEYSIZE;
2049 ret = krb5_copy_keyblock(context, key, &(*crypto)->key.key);
2055 (*crypto)->key.schedule = NULL;
2056 (*crypto)->num_key_usage = 0;
2057 (*crypto)->key_usage = NULL;
2062 free_key_schedule(krb5_context context,
2063 struct key_data *key,
2064 struct encryption_type *et)
2066 if (et->keytype->cleanup)
2067 (*et->keytype->cleanup)(context, key);
2068 memset(key->schedule->data, 0, key->schedule->length);
2069 krb5_free_data(context, key->schedule);
2073 _krb5_free_key_data(krb5_context context, struct key_data *key,
2074 struct encryption_type *et)
2076 krb5_free_keyblock(context, key->key);
2078 free_key_schedule(context, key, et);
2079 key->schedule = NULL;
2084 free_key_usage(krb5_context context, struct key_usage *ku,
2085 struct encryption_type *et)
2087 _krb5_free_key_data(context, &ku->key, et);
2091 * Free a crypto context created by krb5_crypto_init().
2093 * @param context Kerberos context
2094 * @param crypto crypto context to free
2096 * @return Return an error code or 0.
2098 * @ingroup krb5_crypto
2101 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2102 krb5_crypto_destroy(krb5_context context,
2107 for(i = 0; i < crypto->num_key_usage; i++)
2108 free_key_usage(context, &crypto->key_usage[i], crypto->et);
2109 free(crypto->key_usage);
2110 _krb5_free_key_data(context, &crypto->key, crypto->et);
2116 * Return the blocksize used algorithm referenced by the crypto context
2118 * @param context Kerberos context
2119 * @param crypto crypto context to query
2120 * @param blocksize the resulting blocksize
2122 * @return Return an error code or 0.
2124 * @ingroup krb5_crypto
2127 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2128 krb5_crypto_getblocksize(krb5_context context,
2132 *blocksize = crypto->et->blocksize;
2137 * Return the encryption type used by the crypto context
2139 * @param context Kerberos context
2140 * @param crypto crypto context to query
2141 * @param enctype the resulting encryption type
2143 * @return Return an error code or 0.
2145 * @ingroup krb5_crypto
2148 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2149 krb5_crypto_getenctype(krb5_context context,
2151 krb5_enctype *enctype)
2153 *enctype = crypto->et->type;
2158 * Return the padding size used by the crypto context
2160 * @param context Kerberos context
2161 * @param crypto crypto context to query
2162 * @param padsize the return padding size
2164 * @return Return an error code or 0.
2166 * @ingroup krb5_crypto
2169 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2170 krb5_crypto_getpadsize(krb5_context context,
2174 *padsize = crypto->et->padsize;
2179 * Return the confounder size used by the crypto context
2181 * @param context Kerberos context
2182 * @param crypto crypto context to query
2183 * @param confoundersize the returned confounder size
2185 * @return Return an error code or 0.
2187 * @ingroup krb5_crypto
2190 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2191 krb5_crypto_getconfoundersize(krb5_context context,
2193 size_t *confoundersize)
2195 *confoundersize = crypto->et->confoundersize;
2201 * Disable encryption type
2203 * @param context Kerberos 5 context
2204 * @param enctype encryption type to disable
2206 * @return Return an error code or 0.
2208 * @ingroup krb5_crypto
2211 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2212 krb5_enctype_disable(krb5_context context,
2213 krb5_enctype enctype)
2215 struct encryption_type *et = _krb5_find_enctype(enctype);
2218 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
2219 N_("encryption type %d not supported", ""),
2221 return KRB5_PROG_ETYPE_NOSUPP;
2223 et->flags |= F_DISABLED;
2228 * Enable encryption type
2230 * @param context Kerberos 5 context
2231 * @param enctype encryption type to enable
2233 * @return Return an error code or 0.
2235 * @ingroup krb5_crypto
2238 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2239 krb5_enctype_enable(krb5_context context,
2240 krb5_enctype enctype)
2242 struct encryption_type *et = _krb5_find_enctype(enctype);
2245 krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
2246 N_("encryption type %d not supported", ""),
2248 return KRB5_PROG_ETYPE_NOSUPP;
2250 et->flags &= ~F_DISABLED;
2255 * Enable or disable all weak encryption types
2257 * @param context Kerberos 5 context
2258 * @param enable true to enable, false to disable
2260 * @return Return an error code or 0.
2262 * @ingroup krb5_crypto
2265 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2266 krb5_allow_weak_crypto(krb5_context context,
2267 krb5_boolean enable)
2271 for(i = 0; i < _krb5_num_etypes; i++)
2272 if(_krb5_etypes[i]->flags & F_WEAK) {
2274 _krb5_etypes[i]->flags &= ~F_DISABLED;
2276 _krb5_etypes[i]->flags |= F_DISABLED;
2282 wrapped_length (krb5_context context,
2286 struct encryption_type *et = crypto->et;
2287 size_t padsize = et->padsize;
2288 size_t checksumsize = CHECKSUMSIZE(et->checksum);
2291 res = et->confoundersize + checksumsize + data_len;
2292 res = (res + padsize - 1) / padsize * padsize;
2297 wrapped_length_dervied (krb5_context context,
2301 struct encryption_type *et = crypto->et;
2302 size_t padsize = et->padsize;
2305 res = et->confoundersize + data_len;
2306 res = (res + padsize - 1) / padsize * padsize;
2307 if (et->keyed_checksum)
2308 res += et->keyed_checksum->checksumsize;
2310 res += et->checksum->checksumsize;
2315 * Return the size of an encrypted packet of length `data_len'
2319 krb5_get_wrapped_length (krb5_context context,
2323 if (derived_crypto (context, crypto))
2324 return wrapped_length_dervied (context, crypto, data_len);
2326 return wrapped_length (context, crypto, data_len);
2330 * Return the size of an encrypted packet of length `data_len'
2334 crypto_overhead (krb5_context context,
2337 struct encryption_type *et = crypto->et;
2340 res = CHECKSUMSIZE(et->checksum);
2341 res += et->confoundersize;
2342 if (et->padsize > 1)
2348 crypto_overhead_dervied (krb5_context context,
2351 struct encryption_type *et = crypto->et;
2354 if (et->keyed_checksum)
2355 res = CHECKSUMSIZE(et->keyed_checksum);
2357 res = CHECKSUMSIZE(et->checksum);
2358 res += et->confoundersize;
2359 if (et->padsize > 1)
2365 krb5_crypto_overhead (krb5_context context, krb5_crypto crypto)
2367 if (derived_crypto (context, crypto))
2368 return crypto_overhead_dervied (context, crypto);
2370 return crypto_overhead (context, crypto);
2374 * Converts the random bytestring to a protocol key according to
2375 * Kerberos crypto frame work. It may be assumed that all the bits of
2376 * the input string are equally random, even though the entropy
2377 * present in the random source may be limited.
2379 * @param context Kerberos 5 context
2380 * @param type the enctype resulting key will be of
2381 * @param data input random data to convert to a key
2382 * @param size size of input random data, at least krb5_enctype_keysize() long
2383 * @param key key, output key, free with krb5_free_keyblock_contents()
2385 * @return Return an error code or 0.
2387 * @ingroup krb5_crypto
2390 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2391 krb5_random_to_key(krb5_context context,
2397 krb5_error_code ret;
2398 struct encryption_type *et = _krb5_find_enctype(type);
2400 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2401 N_("encryption type %d not supported", ""),
2403 return KRB5_PROG_ETYPE_NOSUPP;
2405 if ((et->keytype->bits + 7) / 8 > size) {
2406 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2407 N_("encryption key %s needs %d bytes "
2408 "of random to make an encryption key "
2410 et->name, (int)et->keytype->size);
2411 return KRB5_PROG_ETYPE_NOSUPP;
2413 ret = krb5_data_alloc(&key->keyvalue, et->keytype->size);
2416 key->keytype = type;
2417 if (et->keytype->random_to_key)
2418 (*et->keytype->random_to_key)(context, key, data, size);
2420 memcpy(key->keyvalue.data, data, et->keytype->size);
2427 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2428 krb5_crypto_prf_length(krb5_context context,
2432 struct encryption_type *et = _krb5_find_enctype(type);
2434 if(et == NULL || et->prf_length == 0) {
2435 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2436 N_("encryption type %d not supported", ""),
2438 return KRB5_PROG_ETYPE_NOSUPP;
2441 *length = et->prf_length;
2445 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2446 krb5_crypto_prf(krb5_context context,
2447 const krb5_crypto crypto,
2448 const krb5_data *input,
2451 struct encryption_type *et = crypto->et;
2453 krb5_data_zero(output);
2455 if(et->prf == NULL) {
2456 krb5_set_error_message(context, KRB5_PROG_ETYPE_NOSUPP,
2457 "kerberos prf for %s not supported",
2459 return KRB5_PROG_ETYPE_NOSUPP;
2462 return (*et->prf)(context, crypto, input, output);
2465 static krb5_error_code
2466 krb5_crypto_prfplus(krb5_context context,
2467 const krb5_crypto crypto,
2468 const krb5_data *input,
2472 krb5_error_code ret;
2474 unsigned char i = 1;
2477 krb5_data_zero(&input2);
2478 krb5_data_zero(output);
2480 krb5_clear_error_message(context);
2482 ret = krb5_data_alloc(output, length);
2484 ret = krb5_data_alloc(&input2, input->length + 1);
2487 krb5_clear_error_message(context);
2489 memcpy(((unsigned char *)input2.data) + 1, input->data, input->length);
2496 ((unsigned char *)input2.data)[0] = i++;
2498 ret = krb5_crypto_prf(context, crypto, &input2, &block);
2502 if (block.length < length) {
2503 memcpy(p, block.data, block.length);
2504 length -= block.length;
2506 memcpy(p, block.data, length);
2510 krb5_data_free(&block);
2514 krb5_data_free(&input2);
2516 krb5_data_free(output);
2521 * The FX-CF2 key derivation function, used in FAST and preauth framework.
2523 * @param context Kerberos 5 context
2524 * @param crypto1 first key to combine
2525 * @param crypto2 second key to combine
2526 * @param pepper1 factor to combine with first key to garante uniqueness
2527 * @param pepper2 factor to combine with second key to garante uniqueness
2528 * @param enctype the encryption type of the resulting key
2529 * @param res allocated key, free with krb5_free_keyblock_contents()
2531 * @return Return an error code or 0.
2533 * @ingroup krb5_crypto
2536 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2537 krb5_crypto_fx_cf2(krb5_context context,
2538 const krb5_crypto crypto1,
2539 const krb5_crypto crypto2,
2542 krb5_enctype enctype,
2545 krb5_error_code ret;
2549 memset(res, 0, sizeof(*res));
2551 ret = krb5_enctype_keysize(context, enctype, &keysize);
2555 ret = krb5_data_alloc(&res->keyvalue, keysize);
2558 ret = krb5_crypto_prfplus(context, crypto1, pepper1, keysize, &os1);
2561 ret = krb5_crypto_prfplus(context, crypto2, pepper2, keysize, &os2);
2565 res->keytype = enctype;
2567 unsigned char *p1 = os1.data, *p2 = os2.data, *p3 = res->keyvalue.data;
2568 for (i = 0; i < keysize; i++)
2569 p3[i] = p1[i] ^ p2[i];
2573 krb5_data_free(&res->keyvalue);
2574 krb5_data_free(&os1);
2575 krb5_data_free(&os2);
2582 #ifndef HEIMDAL_SMALLER
2585 * Deprecated: keytypes doesn't exists, they are really enctypes.
2587 * @ingroup krb5_deprecated
2591 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
2592 krb5_keytype_to_enctypes (krb5_context context,
2593 krb5_keytype keytype,
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)
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 krb5_set_error_message(context, ENOMEM, "malloc: out of memory");
2619 for (i = _krb5_num_etypes - 1; i >= 0; --i) {
2620 if (_krb5_etypes[i]->keytype->type == keytype
2621 && !(_krb5_etypes[i]->flags & F_PSEUDO)
2622 && krb5_enctype_valid(context, _krb5_etypes[i]->type) == 0)
2623 ret[n++] = _krb5_etypes[i]->type;
2631 * Deprecated: keytypes doesn't exists, they are really enctypes.
2633 * @ingroup krb5_deprecated
2636 /* if two enctypes have compatible keys */
2638 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
2639 krb5_enctypes_compatible_keys(krb5_context context,
2640 krb5_enctype etype1,
2641 krb5_enctype etype2)
2643 struct encryption_type *e1 = _krb5_find_enctype(etype1);
2644 struct encryption_type *e2 = _krb5_find_enctype(etype2);
2645 return e1 != NULL && e2 != NULL && e1->keytype == e2->keytype;
2648 #endif /* HEIMDAL_SMALLER */