1 /* 2 * Copyright (c) 2006 - 2008 Kungliga Tekniska Högskolan 3 * (Royal Institute of Technology, Stockholm, Sweden). 4 * All rights reserved. 5 * 6 * Portions Copyright (c) 2010 Apple Inc. All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 19 * 3. Neither the name of the Institute nor the names of its contributors 20 * may be used to endorse or promote products derived from this software 21 * without specific prior written permission. 22 * 23 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND 24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE 27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33 * SUCH DAMAGE. 34 */ 35 36 #include <config.h> 37 38 #include <stdio.h> 39 #include <stdlib.h> 40 #include <assert.h> 41 #include <string.h> 42 #include <ctype.h> 43 #include <errno.h> 44 #include <limits.h> 45 46 #include <roken.h> 47 #include <parse_units.h> 48 #include <krb5.h> 49 50 #define HC_DEPRECATED_CRYPTO 51 52 #include "krb5-types.h" 53 #include "crypto-headers.h" 54 55 #include <heimntlm.h> 56 57 /*! \mainpage Heimdal NTLM library 58 * 59 * \section intro Introduction 60 * 61 * Heimdal libheimntlm library is a implementation of the NTLM 62 * protocol, both version 1 and 2. The GSS-API mech that uses this 63 * library adds support for transport encryption and integrity 64 * checking. 65 * 66 * NTLM is a protocol for mutual authentication, its still used in 67 * many protocol where Kerberos is not support, one example is 68 * EAP/X802.1x mechanism LEAP from Microsoft and Cisco. 69 * 70 * This is a support library for the core protocol, its used in 71 * Heimdal to implement and GSS-API mechanism. There is also support 72 * in the KDC to do remote digest authenticiation, this to allow 73 * services to authenticate users w/o direct access to the users ntlm 74 * hashes (same as Kerberos arcfour enctype keys). 75 * 76 * More information about the NTLM protocol can found here 77 * http://davenport.sourceforge.net/ntlm.html . 78 * 79 * The Heimdal projects web page: http://www.h5l.org/ 80 * 81 * @section ntlm_example NTLM Example 82 * 83 * Example to to use @ref test_ntlm.c . 84 * 85 * @example test_ntlm.c 86 * 87 * Example how to use the NTLM primitives. 88 * 89 */ 90 91 /** @defgroup ntlm_core Heimdal NTLM library 92 * 93 * The NTLM core functions implement the string2key generation 94 * function, message encode and decode function, and the hash function 95 * functions. 96 */ 97 98 struct sec_buffer { 99 uint16_t length; 100 uint16_t allocated; 101 uint32_t offset; 102 }; 103 104 static const unsigned char ntlmsigature[8] = "NTLMSSP\x00"; 105 106 /* 107 * 108 */ 109 110 #define CHECK(f, e) \ 111 do { \ 112 ret = f; \ 113 if (ret != (ssize_t)(e)) { \ 114 ret = HNTLM_ERR_DECODE; \ 115 goto out; \ 116 } \ 117 } while(/*CONSTCOND*/0) 118 119 static struct units ntlm_flag_units[] = { 120 #define ntlm_flag(x) { #x, NTLM_##x } 121 ntlm_flag(ENC_56), 122 ntlm_flag(NEG_KEYEX), 123 ntlm_flag(ENC_128), 124 ntlm_flag(MBZ1), 125 ntlm_flag(MBZ2), 126 ntlm_flag(MBZ3), 127 ntlm_flag(NEG_VERSION), 128 ntlm_flag(MBZ4), 129 ntlm_flag(NEG_TARGET_INFO), 130 ntlm_flag(NON_NT_SESSION_KEY), 131 ntlm_flag(MBZ5), 132 ntlm_flag(NEG_IDENTIFY), 133 ntlm_flag(NEG_NTLM2), 134 ntlm_flag(TARGET_SHARE), 135 ntlm_flag(TARGET_SERVER), 136 ntlm_flag(TARGET_DOMAIN), 137 ntlm_flag(NEG_ALWAYS_SIGN), 138 ntlm_flag(MBZ6), 139 ntlm_flag(OEM_SUPPLIED_WORKSTATION), 140 ntlm_flag(OEM_SUPPLIED_DOMAIN), 141 ntlm_flag(NEG_ANONYMOUS), 142 ntlm_flag(NEG_NT_ONLY), 143 ntlm_flag(NEG_NTLM), 144 ntlm_flag(MBZ8), 145 ntlm_flag(NEG_LM_KEY), 146 ntlm_flag(NEG_DATAGRAM), 147 ntlm_flag(NEG_SEAL), 148 ntlm_flag(NEG_SIGN), 149 ntlm_flag(MBZ9), 150 ntlm_flag(NEG_TARGET), 151 ntlm_flag(NEG_OEM), 152 ntlm_flag(NEG_UNICODE), 153 #undef ntlm_flag 154 {NULL, 0} 155 }; 156 157 size_t 158 heim_ntlm_unparse_flags(uint32_t flags, char *s, size_t len) 159 { 160 return unparse_flags(flags, ntlm_flag_units, s, len); 161 } 162 163 164 /** 165 * heim_ntlm_free_buf frees the ntlm buffer 166 * 167 * @param p buffer to be freed 168 * 169 * @ingroup ntlm_core 170 */ 171 172 void 173 heim_ntlm_free_buf(struct ntlm_buf *p) 174 { 175 if (p->data) 176 free(p->data); 177 p->data = NULL; 178 p->length = 0; 179 } 180 181 182 static int 183 ascii2ucs2le(const char *string, int up, struct ntlm_buf *buf) 184 { 185 unsigned char *p; 186 size_t len, i; 187 188 len = strlen(string); 189 if (len / 2 > UINT_MAX) 190 return ERANGE; 191 192 buf->length = len * 2; 193 buf->data = malloc(buf->length); 194 if (buf->data == NULL && len != 0) { 195 heim_ntlm_free_buf(buf); 196 return ENOMEM; 197 } 198 199 p = buf->data; 200 for (i = 0; i < len; i++) { 201 unsigned char t = (unsigned char)string[i]; 202 if (t & 0x80) { 203 heim_ntlm_free_buf(buf); 204 return EINVAL; 205 } 206 if (up) 207 t = toupper(t); 208 p[(i * 2) + 0] = t; 209 p[(i * 2) + 1] = 0; 210 } 211 return 0; 212 } 213 214 /* 215 * 216 */ 217 218 static krb5_error_code 219 ret_sec_buffer(krb5_storage *sp, struct sec_buffer *buf) 220 { 221 krb5_error_code ret; 222 CHECK(krb5_ret_uint16(sp, &buf->length), 0); 223 CHECK(krb5_ret_uint16(sp, &buf->allocated), 0); 224 CHECK(krb5_ret_uint32(sp, &buf->offset), 0); 225 out: 226 return ret; 227 } 228 229 static krb5_error_code 230 store_sec_buffer(krb5_storage *sp, const struct sec_buffer *buf) 231 { 232 krb5_error_code ret; 233 CHECK(krb5_store_uint16(sp, buf->length), 0); 234 CHECK(krb5_store_uint16(sp, buf->allocated), 0); 235 CHECK(krb5_store_uint32(sp, buf->offset), 0); 236 out: 237 return ret; 238 } 239 240 /* 241 * Strings are either OEM or UNICODE. The later is encoded as ucs2 on 242 * wire, but using utf8 in memory. 243 */ 244 245 static krb5_error_code 246 len_string(int ucs2, const char *s) 247 { 248 size_t len = strlen(s); 249 if (ucs2) 250 len *= 2; 251 return len; 252 } 253 254 /* 255 * 256 */ 257 258 static krb5_error_code 259 ret_string(krb5_storage *sp, int ucs2, size_t len, char **s) 260 { 261 krb5_error_code ret; 262 263 *s = malloc(len + 1); 264 if (*s == NULL) 265 return ENOMEM; 266 CHECK(krb5_storage_read(sp, *s, len), len); 267 268 (*s)[len] = '\0'; 269 270 if (ucs2) { 271 size_t i; 272 for (i = 0; i < len / 2; i++) { 273 (*s)[i] = (*s)[i * 2]; 274 if ((*s)[i * 2 + 1]) { 275 free(*s); 276 *s = NULL; 277 return EINVAL; 278 } 279 } 280 (*s)[i] = '\0'; 281 } 282 ret = 0; 283 out: 284 return ret; 285 } 286 287 288 289 static krb5_error_code 290 ret_sec_string(krb5_storage *sp, int ucs2, struct sec_buffer *desc, char **s) 291 { 292 krb5_error_code ret = 0; 293 CHECK(krb5_storage_seek(sp, desc->offset, SEEK_SET), desc->offset); 294 CHECK(ret_string(sp, ucs2, desc->length, s), 0); 295 out: 296 return ret; 297 } 298 299 static krb5_error_code 300 put_string(krb5_storage *sp, int ucs2, const char *s) 301 { 302 krb5_error_code ret; 303 struct ntlm_buf buf; 304 305 if (ucs2) { 306 ret = ascii2ucs2le(s, 0, &buf); 307 if (ret) 308 return ret; 309 } else { 310 buf.data = rk_UNCONST(s); 311 buf.length = strlen(s); 312 } 313 314 CHECK(krb5_storage_write(sp, buf.data, buf.length), buf.length); 315 if (ucs2) 316 heim_ntlm_free_buf(&buf); 317 ret = 0; 318 out: 319 return ret; 320 } 321 322 /* 323 * 324 */ 325 326 static krb5_error_code 327 ret_buf(krb5_storage *sp, struct sec_buffer *desc, struct ntlm_buf *buf) 328 { 329 krb5_error_code ret; 330 331 buf->data = malloc(desc->length); 332 buf->length = desc->length; 333 CHECK(krb5_storage_seek(sp, desc->offset, SEEK_SET), desc->offset); 334 CHECK(krb5_storage_read(sp, buf->data, buf->length), buf->length); 335 ret = 0; 336 out: 337 return ret; 338 } 339 340 static krb5_error_code 341 put_buf(krb5_storage *sp, const struct ntlm_buf *buf) 342 { 343 krb5_error_code ret; 344 CHECK(krb5_storage_write(sp, buf->data, buf->length), buf->length); 345 ret = 0; 346 out: 347 return ret; 348 } 349 350 /** 351 * Frees the ntlm_targetinfo message 352 * 353 * @param ti targetinfo to be freed 354 * 355 * @ingroup ntlm_core 356 */ 357 358 void 359 heim_ntlm_free_targetinfo(struct ntlm_targetinfo *ti) 360 { 361 free(ti->servername); 362 free(ti->domainname); 363 free(ti->dnsdomainname); 364 free(ti->dnsservername); 365 free(ti->dnstreename); 366 memset(ti, 0, sizeof(*ti)); 367 } 368 369 static int 370 encode_ti_string(krb5_storage *out, uint16_t type, int ucs2, char *s) 371 { 372 krb5_error_code ret; 373 CHECK(krb5_store_uint16(out, type), 0); 374 CHECK(krb5_store_uint16(out, len_string(ucs2, s)), 0); 375 CHECK(put_string(out, ucs2, s), 0); 376 out: 377 return ret; 378 } 379 380 /** 381 * Encodes a ntlm_targetinfo message. 382 * 383 * @param ti the ntlm_targetinfo message to encode. 384 * @param ucs2 ignored 385 * @param data is the return buffer with the encoded message, should be 386 * freed with heim_ntlm_free_buf(). 387 * 388 * @return In case of success 0 is return, an errors, a errno in what 389 * went wrong. 390 * 391 * @ingroup ntlm_core 392 */ 393 394 int 395 heim_ntlm_encode_targetinfo(const struct ntlm_targetinfo *ti, 396 int ucs2, 397 struct ntlm_buf *data) 398 { 399 krb5_error_code ret; 400 krb5_storage *out; 401 402 data->data = NULL; 403 data->length = 0; 404 405 out = krb5_storage_emem(); 406 if (out == NULL) 407 return ENOMEM; 408 409 krb5_storage_set_byteorder(out, KRB5_STORAGE_BYTEORDER_LE); 410 411 if (ti->servername) 412 CHECK(encode_ti_string(out, 1, ucs2, ti->servername), 0); 413 if (ti->domainname) 414 CHECK(encode_ti_string(out, 2, ucs2, ti->domainname), 0); 415 if (ti->dnsservername) 416 CHECK(encode_ti_string(out, 3, ucs2, ti->dnsservername), 0); 417 if (ti->dnsdomainname) 418 CHECK(encode_ti_string(out, 4, ucs2, ti->dnsdomainname), 0); 419 if (ti->dnstreename) 420 CHECK(encode_ti_string(out, 5, ucs2, ti->dnstreename), 0); 421 if (ti->avflags) { 422 CHECK(krb5_store_uint16(out, 6), 0); 423 CHECK(krb5_store_uint16(out, 4), 0); 424 CHECK(krb5_store_uint32(out, ti->avflags), 0); 425 } 426 427 /* end tag */ 428 CHECK(krb5_store_int16(out, 0), 0); 429 CHECK(krb5_store_int16(out, 0), 0); 430 431 { 432 krb5_data d; 433 ret = krb5_storage_to_data(out, &d); 434 data->data = d.data; 435 data->length = d.length; 436 } 437 out: 438 krb5_storage_free(out); 439 return ret; 440 } 441 442 /** 443 * Decodes an NTLM targetinfo message 444 * 445 * @param data input data buffer with the encode NTLM targetinfo message 446 * @param ucs2 if the strings should be encoded with ucs2 (selected by flag in message). 447 * @param ti the decoded target info, should be freed with heim_ntlm_free_targetinfo(). 448 * 449 * @return In case of success 0 is return, an errors, a errno in what 450 * went wrong. 451 * 452 * @ingroup ntlm_core 453 */ 454 455 int 456 heim_ntlm_decode_targetinfo(const struct ntlm_buf *data, 457 int ucs2, 458 struct ntlm_targetinfo *ti) 459 { 460 uint16_t type, len; 461 krb5_storage *in; 462 int ret = 0, done = 0; 463 464 memset(ti, 0, sizeof(*ti)); 465 466 if (data->length == 0) 467 return 0; 468 469 in = krb5_storage_from_readonly_mem(data->data, data->length); 470 if (in == NULL) 471 return ENOMEM; 472 krb5_storage_set_byteorder(in, KRB5_STORAGE_BYTEORDER_LE); 473 474 while (!done) { 475 CHECK(krb5_ret_uint16(in, &type), 0); 476 CHECK(krb5_ret_uint16(in, &len), 0); 477 478 switch (type) { 479 case 0: 480 done = 1; 481 break; 482 case 1: 483 CHECK(ret_string(in, ucs2, len, &ti->servername), 0); 484 break; 485 case 2: 486 CHECK(ret_string(in, ucs2, len, &ti->domainname), 0); 487 break; 488 case 3: 489 CHECK(ret_string(in, ucs2, len, &ti->dnsservername), 0); 490 break; 491 case 4: 492 CHECK(ret_string(in, ucs2, len, &ti->dnsdomainname), 0); 493 break; 494 case 5: 495 CHECK(ret_string(in, ucs2, len, &ti->dnstreename), 0); 496 break; 497 case 6: 498 CHECK(krb5_ret_uint32(in, &ti->avflags), 0); 499 break; 500 default: 501 krb5_storage_seek(in, len, SEEK_CUR); 502 break; 503 } 504 } 505 out: 506 if (in) 507 krb5_storage_free(in); 508 return ret; 509 } 510 511 /** 512 * Frees the ntlm_type1 message 513 * 514 * @param data message to be freed 515 * 516 * @ingroup ntlm_core 517 */ 518 519 void 520 heim_ntlm_free_type1(struct ntlm_type1 *data) 521 { 522 if (data->domain) 523 free(data->domain); 524 if (data->hostname) 525 free(data->hostname); 526 memset(data, 0, sizeof(*data)); 527 } 528 529 int 530 heim_ntlm_decode_type1(const struct ntlm_buf *buf, struct ntlm_type1 *data) 531 { 532 krb5_error_code ret; 533 unsigned char sig[8]; 534 uint32_t type; 535 struct sec_buffer domain, hostname; 536 krb5_storage *in; 537 538 memset(data, 0, sizeof(*data)); 539 540 in = krb5_storage_from_readonly_mem(buf->data, buf->length); 541 if (in == NULL) { 542 ret = ENOMEM; 543 goto out; 544 } 545 krb5_storage_set_byteorder(in, KRB5_STORAGE_BYTEORDER_LE); 546 547 CHECK(krb5_storage_read(in, sig, sizeof(sig)), sizeof(sig)); 548 CHECK(memcmp(ntlmsigature, sig, sizeof(ntlmsigature)), 0); 549 CHECK(krb5_ret_uint32(in, &type), 0); 550 CHECK(type, 1); 551 CHECK(krb5_ret_uint32(in, &data->flags), 0); 552 if (data->flags & NTLM_OEM_SUPPLIED_DOMAIN) 553 CHECK(ret_sec_buffer(in, &domain), 0); 554 if (data->flags & NTLM_OEM_SUPPLIED_WORKSTATION) 555 CHECK(ret_sec_buffer(in, &hostname), 0); 556 #if 0 557 if (domain.offset > 32) { 558 CHECK(krb5_ret_uint32(in, &data->os[0]), 0); 559 CHECK(krb5_ret_uint32(in, &data->os[1]), 0); 560 } 561 #endif 562 if (data->flags & NTLM_OEM_SUPPLIED_DOMAIN) 563 CHECK(ret_sec_string(in, 0, &domain, &data->domain), 0); 564 if (data->flags & NTLM_OEM_SUPPLIED_WORKSTATION) 565 CHECK(ret_sec_string(in, 0, &hostname, &data->hostname), 0); 566 567 out: 568 if (in) 569 krb5_storage_free(in); 570 if (ret) 571 heim_ntlm_free_type1(data); 572 573 return ret; 574 } 575 576 /** 577 * Encodes an ntlm_type1 message. 578 * 579 * @param type1 the ntlm_type1 message to encode. 580 * @param data is the return buffer with the encoded message, should be 581 * freed with heim_ntlm_free_buf(). 582 * 583 * @return In case of success 0 is return, an errors, a errno in what 584 * went wrong. 585 * 586 * @ingroup ntlm_core 587 */ 588 589 int 590 heim_ntlm_encode_type1(const struct ntlm_type1 *type1, struct ntlm_buf *data) 591 { 592 krb5_error_code ret; 593 struct sec_buffer domain, hostname; 594 krb5_storage *out; 595 uint32_t base, flags; 596 597 flags = type1->flags; 598 base = 16; 599 600 if (type1->domain) { 601 base += 8; 602 flags |= NTLM_OEM_SUPPLIED_DOMAIN; 603 } 604 if (type1->hostname) { 605 base += 8; 606 flags |= NTLM_OEM_SUPPLIED_WORKSTATION; 607 } 608 if (type1->os[0]) 609 base += 8; 610 611 domain.offset = base; 612 if (type1->domain) { 613 domain.length = len_string(0, type1->domain); 614 domain.allocated = domain.length; 615 } else { 616 domain.length = 0; 617 domain.allocated = 0; 618 } 619 620 hostname.offset = domain.allocated + domain.offset; 621 if (type1->hostname) { 622 hostname.length = len_string(0, type1->hostname); 623 hostname.allocated = hostname.length; 624 } else { 625 hostname.length = 0; 626 hostname.allocated = 0; 627 } 628 629 out = krb5_storage_emem(); 630 if (out == NULL) 631 return ENOMEM; 632 633 krb5_storage_set_byteorder(out, KRB5_STORAGE_BYTEORDER_LE); 634 CHECK(krb5_storage_write(out, ntlmsigature, sizeof(ntlmsigature)), 635 sizeof(ntlmsigature)); 636 CHECK(krb5_store_uint32(out, 1), 0); 637 CHECK(krb5_store_uint32(out, flags), 0); 638 639 CHECK(store_sec_buffer(out, &domain), 0); 640 CHECK(store_sec_buffer(out, &hostname), 0); 641 #if 0 642 CHECK(krb5_store_uint32(out, type1->os[0]), 0); 643 CHECK(krb5_store_uint32(out, type1->os[1]), 0); 644 #endif 645 if (type1->domain) 646 CHECK(put_string(out, 0, type1->domain), 0); 647 if (type1->hostname) 648 CHECK(put_string(out, 0, type1->hostname), 0); 649 650 { 651 krb5_data d; 652 ret = krb5_storage_to_data(out, &d); 653 data->data = d.data; 654 data->length = d.length; 655 } 656 out: 657 krb5_storage_free(out); 658 659 return ret; 660 } 661 662 /** 663 * Frees the ntlm_type2 message 664 * 665 * @param data message to be freed 666 * 667 * @ingroup ntlm_core 668 */ 669 670 void 671 heim_ntlm_free_type2(struct ntlm_type2 *data) 672 { 673 if (data->targetname) 674 free(data->targetname); 675 heim_ntlm_free_buf(&data->targetinfo); 676 memset(data, 0, sizeof(*data)); 677 } 678 679 int 680 heim_ntlm_decode_type2(const struct ntlm_buf *buf, struct ntlm_type2 *type2) 681 { 682 krb5_error_code ret; 683 unsigned char sig[8]; 684 uint32_t type, ctx[2]; 685 struct sec_buffer targetname, targetinfo; 686 krb5_storage *in; 687 int ucs2 = 0; 688 689 memset(type2, 0, sizeof(*type2)); 690 691 in = krb5_storage_from_readonly_mem(buf->data, buf->length); 692 if (in == NULL) { 693 ret = ENOMEM; 694 goto out; 695 } 696 krb5_storage_set_byteorder(in, KRB5_STORAGE_BYTEORDER_LE); 697 698 CHECK(krb5_storage_read(in, sig, sizeof(sig)), sizeof(sig)); 699 CHECK(memcmp(ntlmsigature, sig, sizeof(ntlmsigature)), 0); 700 CHECK(krb5_ret_uint32(in, &type), 0); 701 CHECK(type, 2); 702 703 CHECK(ret_sec_buffer(in, &targetname), 0); 704 CHECK(krb5_ret_uint32(in, &type2->flags), 0); 705 if (type2->flags & NTLM_NEG_UNICODE) 706 ucs2 = 1; 707 CHECK(krb5_storage_read(in, type2->challenge, sizeof(type2->challenge)), 708 sizeof(type2->challenge)); 709 CHECK(krb5_ret_uint32(in, &ctx[0]), 0); /* context */ 710 CHECK(krb5_ret_uint32(in, &ctx[1]), 0); 711 CHECK(ret_sec_buffer(in, &targetinfo), 0); 712 /* os version */ 713 if (type2->flags & NTLM_NEG_VERSION) { 714 CHECK(krb5_ret_uint32(in, &type2->os[0]), 0); 715 CHECK(krb5_ret_uint32(in, &type2->os[1]), 0); 716 } 717 718 CHECK(ret_sec_string(in, ucs2, &targetname, &type2->targetname), 0); 719 CHECK(ret_buf(in, &targetinfo, &type2->targetinfo), 0); 720 ret = 0; 721 722 out: 723 if (in) 724 krb5_storage_free(in); 725 if (ret) 726 heim_ntlm_free_type2(type2); 727 728 return ret; 729 } 730 731 /** 732 * Encodes an ntlm_type2 message. 733 * 734 * @param type2 the ntlm_type2 message to encode. 735 * @param data is the return buffer with the encoded message, should be 736 * freed with heim_ntlm_free_buf(). 737 * 738 * @return In case of success 0 is return, an errors, a errno in what 739 * went wrong. 740 * 741 * @ingroup ntlm_core 742 */ 743 744 int 745 heim_ntlm_encode_type2(const struct ntlm_type2 *type2, struct ntlm_buf *data) 746 { 747 struct sec_buffer targetname, targetinfo; 748 krb5_error_code ret; 749 krb5_storage *out = NULL; 750 uint32_t base; 751 int ucs2 = 0; 752 753 base = 48; 754 755 if (type2->flags & NTLM_NEG_VERSION) 756 base += 8; 757 758 if (type2->flags & NTLM_NEG_UNICODE) 759 ucs2 = 1; 760 761 targetname.offset = base; 762 targetname.length = len_string(ucs2, type2->targetname); 763 targetname.allocated = targetname.length; 764 765 targetinfo.offset = targetname.allocated + targetname.offset; 766 targetinfo.length = type2->targetinfo.length; 767 targetinfo.allocated = type2->targetinfo.length; 768 769 out = krb5_storage_emem(); 770 if (out == NULL) 771 return ENOMEM; 772 773 krb5_storage_set_byteorder(out, KRB5_STORAGE_BYTEORDER_LE); 774 CHECK(krb5_storage_write(out, ntlmsigature, sizeof(ntlmsigature)), 775 sizeof(ntlmsigature)); 776 CHECK(krb5_store_uint32(out, 2), 0); 777 CHECK(store_sec_buffer(out, &targetname), 0); 778 CHECK(krb5_store_uint32(out, type2->flags), 0); 779 CHECK(krb5_storage_write(out, type2->challenge, sizeof(type2->challenge)), 780 sizeof(type2->challenge)); 781 CHECK(krb5_store_uint32(out, 0), 0); /* context */ 782 CHECK(krb5_store_uint32(out, 0), 0); 783 CHECK(store_sec_buffer(out, &targetinfo), 0); 784 /* os version */ 785 if (type2->flags & NTLM_NEG_VERSION) { 786 CHECK(krb5_store_uint32(out, type2->os[0]), 0); 787 CHECK(krb5_store_uint32(out, type2->os[1]), 0); 788 } 789 CHECK(put_string(out, ucs2, type2->targetname), 0); 790 CHECK(krb5_storage_write(out, type2->targetinfo.data, 791 type2->targetinfo.length), 792 type2->targetinfo.length); 793 794 { 795 krb5_data d; 796 ret = krb5_storage_to_data(out, &d); 797 data->data = d.data; 798 data->length = d.length; 799 } 800 801 out: 802 krb5_storage_free(out); 803 804 return ret; 805 } 806 807 /** 808 * Frees the ntlm_type3 message 809 * 810 * @param data message to be freed 811 * 812 * @ingroup ntlm_core 813 */ 814 815 void 816 heim_ntlm_free_type3(struct ntlm_type3 *data) 817 { 818 heim_ntlm_free_buf(&data->lm); 819 heim_ntlm_free_buf(&data->ntlm); 820 if (data->targetname) 821 free(data->targetname); 822 if (data->username) 823 free(data->username); 824 if (data->ws) 825 free(data->ws); 826 heim_ntlm_free_buf(&data->sessionkey); 827 memset(data, 0, sizeof(*data)); 828 } 829 830 /* 831 * 832 */ 833 834 int 835 heim_ntlm_decode_type3(const struct ntlm_buf *buf, 836 int ucs2, 837 struct ntlm_type3 *type3) 838 { 839 krb5_error_code ret; 840 unsigned char sig[8]; 841 uint32_t type; 842 krb5_storage *in; 843 struct sec_buffer lm, ntlm, target, username, sessionkey, ws; 844 uint32_t min_offset = 72; 845 846 memset(type3, 0, sizeof(*type3)); 847 memset(&sessionkey, 0, sizeof(sessionkey)); 848 849 in = krb5_storage_from_readonly_mem(buf->data, buf->length); 850 if (in == NULL) { 851 ret = ENOMEM; 852 goto out; 853 } 854 krb5_storage_set_byteorder(in, KRB5_STORAGE_BYTEORDER_LE); 855 856 CHECK(krb5_storage_read(in, sig, sizeof(sig)), sizeof(sig)); 857 CHECK(memcmp(ntlmsigature, sig, sizeof(ntlmsigature)), 0); 858 CHECK(krb5_ret_uint32(in, &type), 0); 859 CHECK(type, 3); 860 CHECK(ret_sec_buffer(in, &lm), 0); 861 if (lm.allocated) 862 min_offset = min(min_offset, lm.offset); 863 CHECK(ret_sec_buffer(in, &ntlm), 0); 864 if (ntlm.allocated) 865 min_offset = min(min_offset, ntlm.offset); 866 CHECK(ret_sec_buffer(in, &target), 0); 867 if (target.allocated) 868 min_offset = min(min_offset, target.offset); 869 CHECK(ret_sec_buffer(in, &username), 0); 870 if (username.allocated) 871 min_offset = min(min_offset, username.offset); 872 CHECK(ret_sec_buffer(in, &ws), 0); 873 if (ws.allocated) 874 min_offset = min(min_offset, ws.offset); 875 876 if (min_offset > 52) { 877 CHECK(ret_sec_buffer(in, &sessionkey), 0); 878 min_offset = max(min_offset, sessionkey.offset); 879 CHECK(krb5_ret_uint32(in, &type3->flags), 0); 880 } 881 if (min_offset > 52 + 8 + 4 + 8) { 882 CHECK(krb5_ret_uint32(in, &type3->os[0]), 0); 883 CHECK(krb5_ret_uint32(in, &type3->os[1]), 0); 884 } 885 CHECK(ret_buf(in, &lm, &type3->lm), 0); 886 CHECK(ret_buf(in, &ntlm, &type3->ntlm), 0); 887 CHECK(ret_sec_string(in, ucs2, &target, &type3->targetname), 0); 888 CHECK(ret_sec_string(in, ucs2, &username, &type3->username), 0); 889 CHECK(ret_sec_string(in, ucs2, &ws, &type3->ws), 0); 890 if (sessionkey.offset) 891 CHECK(ret_buf(in, &sessionkey, &type3->sessionkey), 0); 892 893 out: 894 if (in) 895 krb5_storage_free(in); 896 if (ret) 897 heim_ntlm_free_type3(type3); 898 899 return ret; 900 } 901 902 /** 903 * Encodes an ntlm_type3 message. 904 * 905 * @param type3 the ntlm_type3 message to encode. 906 * @param data is the return buffer with the encoded message, should be 907 * freed with heim_ntlm_free_buf(). 908 * 909 * @return In case of success 0 is return, an errors, a errno in what 910 * went wrong. 911 * 912 * @ingroup ntlm_core 913 */ 914 915 int 916 heim_ntlm_encode_type3(const struct ntlm_type3 *type3, struct ntlm_buf *data) 917 { 918 struct sec_buffer lm, ntlm, target, username, sessionkey, ws; 919 krb5_error_code ret; 920 krb5_storage *out = NULL; 921 uint32_t base; 922 int ucs2 = 0; 923 924 memset(&lm, 0, sizeof(lm)); 925 memset(&ntlm, 0, sizeof(ntlm)); 926 memset(&target, 0, sizeof(target)); 927 memset(&username, 0, sizeof(username)); 928 memset(&ws, 0, sizeof(ws)); 929 memset(&sessionkey, 0, sizeof(sessionkey)); 930 931 base = 52; 932 933 base += 8; /* sessionkey sec buf */ 934 base += 4; /* flags */ 935 936 if (type3->os[0]) { 937 base += 8; 938 } 939 940 if (type3->flags & NTLM_NEG_UNICODE) 941 ucs2 = 1; 942 943 target.offset = base; 944 target.length = len_string(ucs2, type3->targetname); 945 target.allocated = target.length; 946 947 username.offset = target.offset + target.allocated; 948 username.length = len_string(ucs2, type3->username); 949 username.allocated = username.length; 950 951 ws.offset = username.offset + username.allocated; 952 ws.length = len_string(ucs2, type3->ws); 953 ws.allocated = ws.length; 954 955 lm.offset = ws.offset + ws.allocated; 956 lm.length = type3->lm.length; 957 lm.allocated = type3->lm.length; 958 959 ntlm.offset = lm.offset + lm.allocated; 960 ntlm.length = type3->ntlm.length; 961 ntlm.allocated = ntlm.length; 962 963 sessionkey.offset = ntlm.offset + ntlm.allocated; 964 sessionkey.length = type3->sessionkey.length; 965 sessionkey.allocated = type3->sessionkey.length; 966 967 out = krb5_storage_emem(); 968 if (out == NULL) 969 return ENOMEM; 970 971 krb5_storage_set_byteorder(out, KRB5_STORAGE_BYTEORDER_LE); 972 CHECK(krb5_storage_write(out, ntlmsigature, sizeof(ntlmsigature)), 973 sizeof(ntlmsigature)); 974 CHECK(krb5_store_uint32(out, 3), 0); 975 976 CHECK(store_sec_buffer(out, &lm), 0); 977 CHECK(store_sec_buffer(out, &ntlm), 0); 978 CHECK(store_sec_buffer(out, &target), 0); 979 CHECK(store_sec_buffer(out, &username), 0); 980 CHECK(store_sec_buffer(out, &ws), 0); 981 CHECK(store_sec_buffer(out, &sessionkey), 0); 982 CHECK(krb5_store_uint32(out, type3->flags), 0); 983 984 #if 0 985 CHECK(krb5_store_uint32(out, 0), 0); /* os0 */ 986 CHECK(krb5_store_uint32(out, 0), 0); /* os1 */ 987 #endif 988 989 CHECK(put_string(out, ucs2, type3->targetname), 0); 990 CHECK(put_string(out, ucs2, type3->username), 0); 991 CHECK(put_string(out, ucs2, type3->ws), 0); 992 CHECK(put_buf(out, &type3->lm), 0); 993 CHECK(put_buf(out, &type3->ntlm), 0); 994 CHECK(put_buf(out, &type3->sessionkey), 0); 995 996 { 997 krb5_data d; 998 ret = krb5_storage_to_data(out, &d); 999 data->data = d.data; 1000 data->length = d.length; 1001 } 1002 1003 out: 1004 krb5_storage_free(out); 1005 1006 return ret; 1007 } 1008 1009 1010 /* 1011 * 1012 */ 1013 1014 static void 1015 splitandenc(unsigned char *hash, 1016 unsigned char *challenge, 1017 unsigned char *answer) 1018 { 1019 EVP_CIPHER_CTX ctx; 1020 unsigned char key[8]; 1021 1022 key[0] = hash[0]; 1023 key[1] = (hash[0] << 7) | (hash[1] >> 1); 1024 key[2] = (hash[1] << 6) | (hash[2] >> 2); 1025 key[3] = (hash[2] << 5) | (hash[3] >> 3); 1026 key[4] = (hash[3] << 4) | (hash[4] >> 4); 1027 key[5] = (hash[4] << 3) | (hash[5] >> 5); 1028 key[6] = (hash[5] << 2) | (hash[6] >> 6); 1029 key[7] = (hash[6] << 1); 1030 1031 EVP_CIPHER_CTX_init(&ctx); 1032 1033 EVP_CipherInit_ex(&ctx, EVP_des_cbc(), NULL, key, NULL, 1); 1034 EVP_Cipher(&ctx, answer, challenge, 8); 1035 EVP_CIPHER_CTX_cleanup(&ctx); 1036 memset(key, 0, sizeof(key)); 1037 } 1038 1039 /** 1040 * Calculate the NTLM key, the password is assumed to be in UTF8. 1041 * 1042 * @param password password to calcute the key for. 1043 * @param key calcuted key, should be freed with heim_ntlm_free_buf(). 1044 * 1045 * @return In case of success 0 is return, an errors, a errno in what 1046 * went wrong. 1047 * 1048 * @ingroup ntlm_core 1049 */ 1050 1051 int 1052 heim_ntlm_nt_key(const char *password, struct ntlm_buf *key) 1053 { 1054 struct ntlm_buf buf; 1055 EVP_MD_CTX *m; 1056 int ret; 1057 1058 key->data = malloc(MD5_DIGEST_LENGTH); 1059 if (key->data == NULL) 1060 return ENOMEM; 1061 key->length = MD5_DIGEST_LENGTH; 1062 1063 ret = ascii2ucs2le(password, 0, &buf); 1064 if (ret) { 1065 heim_ntlm_free_buf(key); 1066 return ret; 1067 } 1068 1069 m = EVP_MD_CTX_create(); 1070 if (m == NULL) { 1071 heim_ntlm_free_buf(key); 1072 heim_ntlm_free_buf(&buf); 1073 return ENOMEM; 1074 } 1075 1076 EVP_DigestInit_ex(m, EVP_md4(), NULL); 1077 EVP_DigestUpdate(m, buf.data, buf.length); 1078 EVP_DigestFinal_ex(m, key->data, NULL); 1079 EVP_MD_CTX_destroy(m); 1080 1081 heim_ntlm_free_buf(&buf); 1082 return 0; 1083 } 1084 1085 /** 1086 * Calculate NTLMv1 response hash 1087 * 1088 * @param key the ntlm v1 key 1089 * @param len length of key 1090 * @param challenge sent by the server 1091 * @param answer calculated answer, should be freed with heim_ntlm_free_buf(). 1092 * 1093 * @return In case of success 0 is return, an errors, a errno in what 1094 * went wrong. 1095 * 1096 * @ingroup ntlm_core 1097 */ 1098 1099 int 1100 heim_ntlm_calculate_ntlm1(void *key, size_t len, 1101 unsigned char challenge[8], 1102 struct ntlm_buf *answer) 1103 { 1104 unsigned char res[21]; 1105 1106 if (len != MD4_DIGEST_LENGTH) 1107 return HNTLM_ERR_INVALID_LENGTH; 1108 1109 memcpy(res, key, len); 1110 memset(&res[MD4_DIGEST_LENGTH], 0, sizeof(res) - MD4_DIGEST_LENGTH); 1111 1112 answer->data = malloc(24); 1113 if (answer->data == NULL) 1114 return ENOMEM; 1115 answer->length = 24; 1116 1117 splitandenc(&res[0], challenge, ((unsigned char *)answer->data) + 0); 1118 splitandenc(&res[7], challenge, ((unsigned char *)answer->data) + 8); 1119 splitandenc(&res[14], challenge, ((unsigned char *)answer->data) + 16); 1120 1121 return 0; 1122 } 1123 1124 int 1125 heim_ntlm_v1_base_session(void *key, size_t len, 1126 struct ntlm_buf *session) 1127 { 1128 EVP_MD_CTX *m; 1129 1130 session->length = MD4_DIGEST_LENGTH; 1131 session->data = malloc(session->length); 1132 if (session->data == NULL) { 1133 session->length = 0; 1134 return ENOMEM; 1135 } 1136 1137 m = EVP_MD_CTX_create(); 1138 if (m == NULL) { 1139 heim_ntlm_free_buf(session); 1140 return ENOMEM; 1141 } 1142 EVP_DigestInit_ex(m, EVP_md4(), NULL); 1143 EVP_DigestUpdate(m, key, len); 1144 EVP_DigestFinal_ex(m, session->data, NULL); 1145 EVP_MD_CTX_destroy(m); 1146 1147 return 0; 1148 } 1149 1150 int 1151 heim_ntlm_v2_base_session(void *key, size_t len, 1152 struct ntlm_buf *ntlmResponse, 1153 struct ntlm_buf *session) 1154 { 1155 unsigned int hmaclen; 1156 HMAC_CTX c; 1157 1158 if (ntlmResponse->length <= 16) 1159 return HNTLM_ERR_INVALID_LENGTH; 1160 1161 session->data = malloc(16); 1162 if (session->data == NULL) 1163 return ENOMEM; 1164 session->length = 16; 1165 1166 /* Note: key is the NTLMv2 key */ 1167 HMAC_CTX_init(&c); 1168 HMAC_Init_ex(&c, key, len, EVP_md5(), NULL); 1169 HMAC_Update(&c, ntlmResponse->data, 16); 1170 HMAC_Final(&c, session->data, &hmaclen); 1171 HMAC_CTX_cleanup(&c); 1172 1173 return 0; 1174 } 1175 1176 1177 int 1178 heim_ntlm_keyex_wrap(struct ntlm_buf *base_session, 1179 struct ntlm_buf *session, 1180 struct ntlm_buf *encryptedSession) 1181 { 1182 EVP_CIPHER_CTX c; 1183 int ret; 1184 1185 session->length = MD4_DIGEST_LENGTH; 1186 session->data = malloc(session->length); 1187 if (session->data == NULL) { 1188 session->length = 0; 1189 return ENOMEM; 1190 } 1191 encryptedSession->length = MD4_DIGEST_LENGTH; 1192 encryptedSession->data = malloc(encryptedSession->length); 1193 if (encryptedSession->data == NULL) { 1194 heim_ntlm_free_buf(session); 1195 encryptedSession->length = 0; 1196 return ENOMEM; 1197 } 1198 1199 EVP_CIPHER_CTX_init(&c); 1200 1201 ret = EVP_CipherInit_ex(&c, EVP_rc4(), NULL, base_session->data, NULL, 1); 1202 if (ret != 1) { 1203 EVP_CIPHER_CTX_cleanup(&c); 1204 heim_ntlm_free_buf(encryptedSession); 1205 heim_ntlm_free_buf(session); 1206 return HNTLM_ERR_CRYPTO; 1207 } 1208 1209 if (RAND_bytes(session->data, session->length) != 1) { 1210 EVP_CIPHER_CTX_cleanup(&c); 1211 heim_ntlm_free_buf(encryptedSession); 1212 heim_ntlm_free_buf(session); 1213 return HNTLM_ERR_RAND; 1214 } 1215 1216 EVP_Cipher(&c, encryptedSession->data, session->data, encryptedSession->length); 1217 EVP_CIPHER_CTX_cleanup(&c); 1218 1219 return 0; 1220 1221 1222 1223 } 1224 1225 1226 1227 /** 1228 * Generates an NTLMv1 session random with assosited session master key. 1229 * 1230 * @param key the ntlm v1 key 1231 * @param len length of key 1232 * @param session generated session nonce, should be freed with heim_ntlm_free_buf(). 1233 * @param master calculated session master key, should be freed with heim_ntlm_free_buf(). 1234 * 1235 * @return In case of success 0 is return, an errors, a errno in what 1236 * went wrong. 1237 * 1238 * @ingroup ntlm_core 1239 */ 1240 1241 int 1242 heim_ntlm_build_ntlm1_master(void *key, size_t len, 1243 struct ntlm_buf *session, 1244 struct ntlm_buf *master) 1245 { 1246 struct ntlm_buf sess; 1247 int ret; 1248 1249 ret = heim_ntlm_v1_base_session(key, len, &sess); 1250 if (ret) 1251 return ret; 1252 1253 ret = heim_ntlm_keyex_wrap(&sess, session, master); 1254 heim_ntlm_free_buf(&sess); 1255 1256 return ret; 1257 } 1258 1259 /** 1260 * Generates an NTLMv2 session random with associated session master key. 1261 * 1262 * @param key the NTLMv2 key 1263 * @param len length of key 1264 * @param blob the NTLMv2 "blob" 1265 * @param session generated session nonce, should be freed with heim_ntlm_free_buf(). 1266 * @param master calculated session master key, should be freed with heim_ntlm_free_buf(). 1267 * 1268 * @return In case of success 0 is return, an errors, a errno in what 1269 * went wrong. 1270 * 1271 * @ingroup ntlm_core 1272 */ 1273 1274 1275 int 1276 heim_ntlm_build_ntlm2_master(void *key, size_t len, 1277 struct ntlm_buf *blob, 1278 struct ntlm_buf *session, 1279 struct ntlm_buf *master) 1280 { 1281 struct ntlm_buf sess; 1282 int ret; 1283 1284 ret = heim_ntlm_v2_base_session(key, len, blob, &sess); 1285 if (ret) 1286 return ret; 1287 1288 ret = heim_ntlm_keyex_wrap(&sess, session, master); 1289 heim_ntlm_free_buf(&sess); 1290 1291 return ret; 1292 } 1293 1294 /** 1295 * Given a key and encrypted session, unwrap the session key 1296 * 1297 * @param baseKey the sessionBaseKey 1298 * @param encryptedSession encrypted session, type3.session field. 1299 * @param session generated session nonce, should be freed with heim_ntlm_free_buf(). 1300 * 1301 * @return In case of success 0 is return, an errors, a errno in what 1302 * went wrong. 1303 * 1304 * @ingroup ntlm_core 1305 */ 1306 1307 int 1308 heim_ntlm_keyex_unwrap(struct ntlm_buf *baseKey, 1309 struct ntlm_buf *encryptedSession, 1310 struct ntlm_buf *session) 1311 { 1312 EVP_CIPHER_CTX c; 1313 1314 memset(session, 0, sizeof(*session)); 1315 1316 if (baseKey->length != MD4_DIGEST_LENGTH) 1317 return HNTLM_ERR_INVALID_LENGTH; 1318 1319 session->length = MD4_DIGEST_LENGTH; 1320 session->data = malloc(session->length); 1321 if (session->data == NULL) { 1322 session->length = 0; 1323 return ENOMEM; 1324 } 1325 EVP_CIPHER_CTX_init(&c); 1326 1327 if (EVP_CipherInit_ex(&c, EVP_rc4(), NULL, baseKey->data, NULL, 0) != 1) { 1328 EVP_CIPHER_CTX_cleanup(&c); 1329 heim_ntlm_free_buf(session); 1330 return HNTLM_ERR_CRYPTO; 1331 } 1332 1333 EVP_Cipher(&c, session->data, encryptedSession->data, session->length); 1334 EVP_CIPHER_CTX_cleanup(&c); 1335 1336 return 0; 1337 } 1338 1339 1340 /** 1341 * Generates an NTLMv2 session key. 1342 * 1343 * @param key the ntlm key 1344 * @param len length of key 1345 * @param username name of the user, as sent in the message, assumed to be in UTF8. 1346 * @param target the name of the target, assumed to be in UTF8. 1347 * @param ntlmv2 the ntlmv2 session key 1348 * 1349 * @return 0 on success, or an error code on failure. 1350 * 1351 * @ingroup ntlm_core 1352 */ 1353 1354 int 1355 heim_ntlm_ntlmv2_key(const void *key, size_t len, 1356 const char *username, 1357 const char *target, 1358 unsigned char ntlmv2[16]) 1359 { 1360 int ret; 1361 unsigned int hmaclen; 1362 HMAC_CTX c; 1363 1364 HMAC_CTX_init(&c); 1365 HMAC_Init_ex(&c, key, len, EVP_md5(), NULL); 1366 { 1367 struct ntlm_buf buf; 1368 /* uppercase username and turn it into ucs2-le */ 1369 ret = ascii2ucs2le(username, 1, &buf); 1370 if (ret) 1371 goto out; 1372 HMAC_Update(&c, buf.data, buf.length); 1373 free(buf.data); 1374 /* uppercase target and turn into ucs2-le */ 1375 ret = ascii2ucs2le(target, 1, &buf); 1376 if (ret) 1377 goto out; 1378 HMAC_Update(&c, buf.data, buf.length); 1379 free(buf.data); 1380 } 1381 HMAC_Final(&c, ntlmv2, &hmaclen); 1382 out: 1383 HMAC_CTX_cleanup(&c); 1384 1385 return ret; 1386 } 1387 1388 /* 1389 * 1390 */ 1391 1392 #define NTTIME_EPOCH 0x019DB1DED53E8000LL 1393 1394 static uint64_t 1395 unix2nttime(time_t unix_time) 1396 { 1397 long long wt; 1398 wt = unix_time * (uint64_t)10000000 + (uint64_t)NTTIME_EPOCH; 1399 return wt; 1400 } 1401 1402 static time_t 1403 nt2unixtime(uint64_t t) 1404 { 1405 t = ((t - (uint64_t)NTTIME_EPOCH) / (uint64_t)10000000); 1406 if (t > (((uint64_t)(time_t)(~(uint64_t)0)) >> 1)) 1407 return 0; 1408 return (time_t)t; 1409 } 1410 1411 /** 1412 * Calculate LMv2 response 1413 * 1414 * @param key the ntlm key 1415 * @param len length of key 1416 * @param username name of the user, as sent in the message, assumed to be in UTF8. 1417 * @param target the name of the target, assumed to be in UTF8. 1418 * @param serverchallenge challenge as sent by the server in the type2 message. 1419 * @param ntlmv2 calculated session key 1420 * @param answer ntlm response answer, should be freed with heim_ntlm_free_buf(). 1421 * 1422 * @return In case of success 0 is return, an errors, a errno in what 1423 * went wrong. 1424 * 1425 * @ingroup ntlm_core 1426 */ 1427 1428 int 1429 heim_ntlm_calculate_lm2(const void *key, size_t len, 1430 const char *username, 1431 const char *target, 1432 const unsigned char serverchallenge[8], 1433 unsigned char ntlmv2[16], 1434 struct ntlm_buf *answer) 1435 { 1436 unsigned char clientchallenge[8]; 1437 1438 if (RAND_bytes(clientchallenge, sizeof(clientchallenge)) != 1) 1439 return HNTLM_ERR_RAND; 1440 1441 /* calculate ntlmv2 key */ 1442 1443 heim_ntlm_ntlmv2_key(key, len, username, target, ntlmv2); 1444 1445 answer->data = malloc(24); 1446 if (answer->data == NULL) 1447 return ENOMEM; 1448 answer->length = 24; 1449 1450 heim_ntlm_derive_ntlm2_sess(ntlmv2, clientchallenge, 8, 1451 serverchallenge, answer->data); 1452 1453 memcpy(((uint8_t *)answer->data) + 16, clientchallenge, 8); 1454 1455 return 0; 1456 } 1457 1458 1459 /** 1460 * Calculate NTLMv2 response 1461 * 1462 * @param key the ntlm key 1463 * @param len length of key 1464 * @param username name of the user, as sent in the message, assumed to be in UTF8. 1465 * @param target the name of the target, assumed to be in UTF8. 1466 * @param serverchallenge challenge as sent by the server in the type2 message. 1467 * @param infotarget infotarget as sent by the server in the type2 message. 1468 * @param ntlmv2 calculated session key 1469 * @param answer ntlm response answer, should be freed with heim_ntlm_free_buf(). 1470 * 1471 * @return In case of success 0 is return, an errors, a errno in what 1472 * went wrong. 1473 * 1474 * @ingroup ntlm_core 1475 */ 1476 1477 int 1478 heim_ntlm_calculate_ntlm2(const void *key, size_t len, 1479 const char *username, 1480 const char *target, 1481 const unsigned char serverchallenge[8], 1482 const struct ntlm_buf *infotarget, 1483 unsigned char ntlmv2[16], 1484 struct ntlm_buf *answer) 1485 { 1486 krb5_error_code ret; 1487 krb5_data data; 1488 unsigned char ntlmv2answer[16]; 1489 krb5_storage *sp; 1490 unsigned char clientchallenge[8]; 1491 uint64_t t; 1492 1493 t = unix2nttime(time(NULL)); 1494 1495 if (RAND_bytes(clientchallenge, sizeof(clientchallenge)) != 1) 1496 return HNTLM_ERR_RAND; 1497 1498 /* calculate ntlmv2 key */ 1499 1500 heim_ntlm_ntlmv2_key(key, len, username, target, ntlmv2); 1501 1502 /* calculate and build ntlmv2 answer */ 1503 1504 sp = krb5_storage_emem(); 1505 if (sp == NULL) 1506 return ENOMEM; 1507 krb5_storage_set_flags(sp, KRB5_STORAGE_BYTEORDER_LE); 1508 1509 CHECK(krb5_store_uint32(sp, 0x00000101), 0); 1510 CHECK(krb5_store_uint32(sp, 0), 0); 1511 /* timestamp le 64 bit ts */ 1512 CHECK(krb5_store_uint32(sp, t & 0xffffffff), 0); 1513 CHECK(krb5_store_uint32(sp, t >> 32), 0); 1514 1515 CHECK(krb5_storage_write(sp, clientchallenge, 8), 8); 1516 1517 CHECK(krb5_store_uint32(sp, 0), 0); /* unknown but zero will work */ 1518 CHECK(krb5_storage_write(sp, infotarget->data, infotarget->length), 1519 infotarget->length); 1520 CHECK(krb5_store_uint32(sp, 0), 0); /* unknown but zero will work */ 1521 1522 CHECK(krb5_storage_to_data(sp, &data), 0); 1523 krb5_storage_free(sp); 1524 sp = NULL; 1525 1526 heim_ntlm_derive_ntlm2_sess(ntlmv2, data.data, data.length, serverchallenge, ntlmv2answer); 1527 1528 sp = krb5_storage_emem(); 1529 if (sp == NULL) { 1530 krb5_data_free(&data); 1531 return ENOMEM; 1532 } 1533 1534 CHECK(krb5_storage_write(sp, ntlmv2answer, 16), 16); 1535 CHECK(krb5_storage_write(sp, data.data, data.length), data.length); 1536 krb5_data_free(&data); 1537 1538 CHECK(krb5_storage_to_data(sp, &data), 0); 1539 krb5_storage_free(sp); 1540 sp = NULL; 1541 1542 answer->data = data.data; 1543 answer->length = data.length; 1544 1545 return 0; 1546 out: 1547 if (sp) 1548 krb5_storage_free(sp); 1549 return ret; 1550 } 1551 1552 static const int authtimediff = 3600 * 2; /* 2 hours */ 1553 1554 /** 1555 * Verify NTLMv2 response. 1556 * 1557 * @param key the ntlm key 1558 * @param len length of key 1559 * @param username name of the user, as sent in the message, assumed to be in UTF8. 1560 * @param target the name of the target, assumed to be in UTF8. 1561 * @param now the time now (0 if the library should pick it up itself) 1562 * @param serverchallenge challenge as sent by the server in the type2 message. 1563 * @param answer ntlm response answer, should be freed with heim_ntlm_free_buf(). 1564 * @param infotarget infotarget as sent by the server in the type2 message. 1565 * @param ntlmv2 calculated session key 1566 * 1567 * @return In case of success 0 is return, an errors, a errno in what 1568 * went wrong. 1569 * 1570 * @ingroup ntlm_core 1571 */ 1572 1573 int 1574 heim_ntlm_verify_ntlm2(const void *key, size_t len, 1575 const char *username, 1576 const char *target, 1577 time_t now, 1578 const unsigned char serverchallenge[8], 1579 const struct ntlm_buf *answer, 1580 struct ntlm_buf *infotarget, 1581 unsigned char ntlmv2[16]) 1582 { 1583 krb5_error_code ret; 1584 unsigned char clientanswer[16]; 1585 unsigned char clientnonce[8]; 1586 unsigned char serveranswer[16]; 1587 krb5_storage *sp; 1588 time_t authtime; 1589 uint32_t temp; 1590 uint64_t t; 1591 1592 infotarget->length = 0; 1593 infotarget->data = NULL; 1594 1595 if (answer->length < 16) 1596 return HNTLM_ERR_INVALID_LENGTH; 1597 1598 if (now == 0) 1599 now = time(NULL); 1600 1601 /* calculate ntlmv2 key */ 1602 1603 heim_ntlm_ntlmv2_key(key, len, username, target, ntlmv2); 1604 1605 /* calculate and build ntlmv2 answer */ 1606 1607 sp = krb5_storage_from_readonly_mem(answer->data, answer->length); 1608 if (sp == NULL) 1609 return ENOMEM; 1610 krb5_storage_set_flags(sp, KRB5_STORAGE_BYTEORDER_LE); 1611 1612 CHECK(krb5_storage_read(sp, clientanswer, 16), 16); 1613 1614 CHECK(krb5_ret_uint32(sp, &temp), 0); 1615 CHECK(temp, 0x00000101); 1616 CHECK(krb5_ret_uint32(sp, &temp), 0); 1617 CHECK(temp, 0); 1618 /* timestamp le 64 bit ts */ 1619 CHECK(krb5_ret_uint32(sp, &temp), 0); 1620 t = temp; 1621 CHECK(krb5_ret_uint32(sp, &temp), 0); 1622 t |= ((uint64_t)temp)<< 32; 1623 1624 authtime = nt2unixtime(t); 1625 1626 if (abs((int)(authtime - now)) > authtimediff) { 1627 ret = HNTLM_ERR_TIME_SKEW; 1628 goto out; 1629 } 1630 1631 /* client challenge */ 1632 CHECK(krb5_storage_read(sp, clientnonce, 8), 8); 1633 1634 CHECK(krb5_ret_uint32(sp, &temp), 0); /* unknown */ 1635 1636 /* should really unparse the infotarget, but lets pick up everything */ 1637 infotarget->length = answer->length - krb5_storage_seek(sp, 0, SEEK_CUR); 1638 infotarget->data = malloc(infotarget->length); 1639 if (infotarget->data == NULL) { 1640 ret = ENOMEM; 1641 goto out; 1642 } 1643 CHECK(krb5_storage_read(sp, infotarget->data, infotarget->length), 1644 infotarget->length); 1645 /* XXX remove the unknown ?? */ 1646 krb5_storage_free(sp); 1647 sp = NULL; 1648 1649 if (answer->length < 16) { 1650 ret = HNTLM_ERR_INVALID_LENGTH; 1651 goto out; 1652 } 1653 1654 heim_ntlm_derive_ntlm2_sess(ntlmv2, 1655 ((unsigned char *)answer->data) + 16, answer->length - 16, 1656 serverchallenge, 1657 serveranswer); 1658 1659 if (memcmp(serveranswer, clientanswer, 16) != 0) { 1660 heim_ntlm_free_buf(infotarget); 1661 return HNTLM_ERR_AUTH; 1662 } 1663 1664 return 0; 1665 out: 1666 heim_ntlm_free_buf(infotarget); 1667 if (sp) 1668 krb5_storage_free(sp); 1669 return ret; 1670 } 1671 1672 1673 /* 1674 * Calculate the NTLM2 Session Response 1675 * 1676 * @param clnt_nonce client nonce 1677 * @param svr_chal server challage 1678 * @param ntlm2_hash ntlm hash 1679 * @param lm The LM response, should be freed with heim_ntlm_free_buf(). 1680 * @param ntlm The NTLM response, should be freed with heim_ntlm_free_buf(). 1681 * 1682 * @return In case of success 0 is return, an errors, a errno in what 1683 * went wrong. 1684 * 1685 * @ingroup ntlm_core 1686 */ 1687 1688 int 1689 heim_ntlm_calculate_ntlm2_sess(const unsigned char clnt_nonce[8], 1690 const unsigned char svr_chal[8], 1691 const unsigned char ntlm_hash[16], 1692 struct ntlm_buf *lm, 1693 struct ntlm_buf *ntlm) 1694 { 1695 unsigned char ntlm2_sess_hash[8]; 1696 unsigned char res[21], *resp; 1697 int code; 1698 1699 code = heim_ntlm_calculate_ntlm2_sess_hash(clnt_nonce, svr_chal, 1700 ntlm2_sess_hash); 1701 if (code) { 1702 return code; 1703 } 1704 1705 lm->data = malloc(24); 1706 if (lm->data == NULL) { 1707 return ENOMEM; 1708 } 1709 lm->length = 24; 1710 1711 ntlm->data = malloc(24); 1712 if (ntlm->data == NULL) { 1713 free(lm->data); 1714 lm->data = NULL; 1715 return ENOMEM; 1716 } 1717 ntlm->length = 24; 1718 1719 /* first setup the lm resp */ 1720 memset(lm->data, 0, 24); 1721 memcpy(lm->data, clnt_nonce, 8); 1722 1723 memset(res, 0, sizeof(res)); 1724 memcpy(res, ntlm_hash, 16); 1725 1726 resp = ntlm->data; 1727 splitandenc(&res[0], ntlm2_sess_hash, resp + 0); 1728 splitandenc(&res[7], ntlm2_sess_hash, resp + 8); 1729 splitandenc(&res[14], ntlm2_sess_hash, resp + 16); 1730 1731 return 0; 1732 } 1733 1734 1735 /* 1736 * Calculate the NTLM2 Session "Verifier" 1737 * 1738 * @param clnt_nonce client nonce 1739 * @param svr_chal server challage 1740 * @param hash The NTLM session verifier 1741 * 1742 * @return In case of success 0 is return, an errors, a errno in what 1743 * went wrong. 1744 * 1745 * @ingroup ntlm_core 1746 */ 1747 1748 int 1749 heim_ntlm_calculate_ntlm2_sess_hash(const unsigned char clnt_nonce[8], 1750 const unsigned char svr_chal[8], 1751 unsigned char verifier[8]) 1752 { 1753 unsigned char ntlm2_sess_hash[MD5_DIGEST_LENGTH]; 1754 EVP_MD_CTX *m; 1755 1756 m = EVP_MD_CTX_create(); 1757 if (m == NULL) 1758 return ENOMEM; 1759 1760 EVP_DigestInit_ex(m, EVP_md5(), NULL); 1761 EVP_DigestUpdate(m, svr_chal, 8); /* session nonce part 1 */ 1762 EVP_DigestUpdate(m, clnt_nonce, 8); /* session nonce part 2 */ 1763 EVP_DigestFinal_ex(m, ntlm2_sess_hash, NULL); /* will only use first 8 bytes */ 1764 EVP_MD_CTX_destroy(m); 1765 1766 memcpy(verifier, ntlm2_sess_hash, 8); 1767 1768 return 0; 1769 } 1770 1771 1772 /* 1773 * Derive a NTLM2 session key 1774 * 1775 * @param sessionkey session key from domain controller 1776 * @param clnt_nonce client nonce 1777 * @param svr_chal server challenge 1778 * @param derivedkey salted session key 1779 * 1780 * @return In case of success 0 is return, an errors, a errno in what 1781 * went wrong. 1782 * 1783 * @ingroup ntlm_core 1784 */ 1785 1786 void 1787 heim_ntlm_derive_ntlm2_sess(const unsigned char sessionkey[16], 1788 const unsigned char *clnt_nonce, size_t clnt_nonce_length, 1789 const unsigned char svr_chal[8], 1790 unsigned char derivedkey[16]) 1791 { 1792 unsigned int hmaclen; 1793 HMAC_CTX c; 1794 1795 /* HMAC(Ksession, serverchallenge || clientchallenge) */ 1796 HMAC_CTX_init(&c); 1797 HMAC_Init_ex(&c, sessionkey, 16, EVP_md5(), NULL); 1798 HMAC_Update(&c, svr_chal, 8); 1799 HMAC_Update(&c, clnt_nonce, clnt_nonce_length); 1800 HMAC_Final(&c, derivedkey, &hmaclen); 1801 HMAC_CTX_cleanup(&c); 1802 } 1803 1804