2 Unix SMB/CIFS implementation.
3 simple kerberos5/SPNEGO routines
4 Copyright (C) Andrew Tridgell 2001
5 Copyright (C) Jim McDonough 2002
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 generate a negTokenInit packet given a GUID, a list of supported
26 OIDs (the mechanisms) and a principal name string
28 DATA_BLOB spnego_gen_negTokenInit(uint8 guid[16],
30 const char *principal)
36 memset(&data, 0, sizeof(data));
38 asn1_write(&data, guid, 16);
39 asn1_push_tag(&data,ASN1_APPLICATION(0));
40 asn1_write_OID(&data,OID_SPNEGO);
41 asn1_push_tag(&data,ASN1_CONTEXT(0));
42 asn1_push_tag(&data,ASN1_SEQUENCE(0));
44 asn1_push_tag(&data,ASN1_CONTEXT(0));
45 asn1_push_tag(&data,ASN1_SEQUENCE(0));
46 for (i=0; OIDs[i]; i++) {
47 asn1_write_OID(&data,OIDs[i]);
52 asn1_push_tag(&data, ASN1_CONTEXT(3));
53 asn1_push_tag(&data, ASN1_SEQUENCE(0));
54 asn1_push_tag(&data, ASN1_CONTEXT(0));
55 asn1_write_GeneralString(&data,principal);
66 DEBUG(1,("Failed to build negTokenInit at offset %d\n", (int)data.ofs));
70 ret = data_blob(data.data, data.length);
78 parse a negTokenInit packet giving a GUID, a list of supported
79 OIDs (the mechanisms) and a principal name string
81 BOOL spnego_parse_negTokenInit(DATA_BLOB blob,
82 char *OIDs[ASN1_MAX_OIDS],
89 asn1_load(&data, blob);
91 asn1_start_tag(&data,ASN1_APPLICATION(0));
92 asn1_check_OID(&data,OID_SPNEGO);
93 asn1_start_tag(&data,ASN1_CONTEXT(0));
94 asn1_start_tag(&data,ASN1_SEQUENCE(0));
96 asn1_start_tag(&data,ASN1_CONTEXT(0));
97 asn1_start_tag(&data,ASN1_SEQUENCE(0));
98 for (i=0; asn1_tag_remaining(&data) > 0 && i < ASN1_MAX_OIDS; i++) {
100 asn1_read_OID(&data,&oid);
107 asn1_start_tag(&data, ASN1_CONTEXT(3));
108 asn1_start_tag(&data, ASN1_SEQUENCE(0));
109 asn1_start_tag(&data, ASN1_CONTEXT(0));
110 asn1_read_GeneralString(&data,principal);
120 ret = !data.has_error;
127 generate a negTokenTarg packet given a list of OIDs and a security blob
129 DATA_BLOB gen_negTokenTarg(const char *OIDs[], DATA_BLOB blob)
135 memset(&data, 0, sizeof(data));
137 asn1_push_tag(&data, ASN1_APPLICATION(0));
138 asn1_write_OID(&data,OID_SPNEGO);
139 asn1_push_tag(&data, ASN1_CONTEXT(0));
140 asn1_push_tag(&data, ASN1_SEQUENCE(0));
142 asn1_push_tag(&data, ASN1_CONTEXT(0));
143 asn1_push_tag(&data, ASN1_SEQUENCE(0));
144 for (i=0; OIDs[i]; i++) {
145 asn1_write_OID(&data,OIDs[i]);
150 asn1_push_tag(&data, ASN1_CONTEXT(2));
151 asn1_write_OctetString(&data,blob.data,blob.length);
159 if (data.has_error) {
160 DEBUG(1,("Failed to build negTokenTarg at offset %d\n", (int)data.ofs));
164 ret = data_blob(data.data, data.length);
172 parse a negTokenTarg packet giving a list of OIDs and a security blob
174 BOOL parse_negTokenTarg(DATA_BLOB blob, char *OIDs[ASN1_MAX_OIDS], DATA_BLOB *secblob)
179 asn1_load(&data, blob);
180 asn1_start_tag(&data, ASN1_APPLICATION(0));
181 asn1_check_OID(&data,OID_SPNEGO);
182 asn1_start_tag(&data, ASN1_CONTEXT(0));
183 asn1_start_tag(&data, ASN1_SEQUENCE(0));
185 asn1_start_tag(&data, ASN1_CONTEXT(0));
186 asn1_start_tag(&data, ASN1_SEQUENCE(0));
187 for (i=0; asn1_tag_remaining(&data) > 0 && i < ASN1_MAX_OIDS; i++) {
189 asn1_read_OID(&data,&oid);
196 asn1_start_tag(&data, ASN1_CONTEXT(2));
197 asn1_read_OctetString(&data,secblob);
205 if (data.has_error) {
206 DEBUG(1,("Failed to parse negTokenTarg at offset %d\n", (int)data.ofs));
216 generate a krb5 GSS-API wrapper packet given a ticket
218 DATA_BLOB spnego_gen_krb5_wrap(DATA_BLOB ticket)
223 memset(&data, 0, sizeof(data));
225 asn1_push_tag(&data, ASN1_APPLICATION(0));
226 asn1_write_OID(&data, OID_KERBEROS5);
227 asn1_write_BOOLEAN(&data, 0);
228 asn1_write(&data, ticket.data, ticket.length);
231 if (data.has_error) {
232 DEBUG(1,("Failed to build krb5 wrapper at offset %d\n", (int)data.ofs));
236 ret = data_blob(data.data, data.length);
243 parse a krb5 GSS-API wrapper packet giving a ticket
245 BOOL spnego_parse_krb5_wrap(DATA_BLOB blob, DATA_BLOB *ticket)
251 asn1_load(&data, blob);
252 asn1_start_tag(&data, ASN1_APPLICATION(0));
253 asn1_check_OID(&data, OID_KERBEROS5);
254 asn1_check_BOOLEAN(&data, 0);
256 data_remaining = asn1_tag_remaining(&data);
258 if (data_remaining < 1) {
259 data.has_error = True;
262 *ticket = data_blob(data.data, data_remaining);
263 asn1_read(&data, ticket->data, ticket->length);
268 ret = !data.has_error;
277 generate a SPNEGO negTokenTarg packet, ready for a EXTENDED_SECURITY
278 kerberos session setup
280 DATA_BLOB spnego_gen_negTokenTarg(const char *principal)
282 DATA_BLOB tkt, tkt_wrapped, targ;
283 const char *krb_mechs[] = {OID_KERBEROS5_OLD, OID_NTLMSSP, NULL};
285 /* get a kerberos ticket for the service */
286 tkt = krb5_get_ticket(principal);
288 /* wrap that up in a nice GSS-API wrapping */
289 tkt_wrapped = spnego_gen_krb5_wrap(tkt);
291 /* and wrap that in a shiny SPNEGO wrapper */
292 targ = gen_negTokenTarg(krb_mechs, tkt_wrapped);
294 data_blob_free(&tkt_wrapped);
295 data_blob_free(&tkt);
302 parse a spnego NTLMSSP challenge packet giving two security blobs
304 BOOL spnego_parse_challenge(DATA_BLOB blob,
305 DATA_BLOB *chal1, DATA_BLOB *chal2)
313 asn1_load(&data, blob);
314 asn1_start_tag(&data,ASN1_CONTEXT(1));
315 asn1_start_tag(&data,ASN1_SEQUENCE(0));
317 asn1_start_tag(&data,ASN1_CONTEXT(0));
318 asn1_check_enumerated(&data,1);
321 asn1_start_tag(&data,ASN1_CONTEXT(1));
322 asn1_check_OID(&data, OID_NTLMSSP);
325 asn1_start_tag(&data,ASN1_CONTEXT(2));
326 asn1_read_OctetString(&data, chal1);
329 /* the second challenge is optional (XP doesn't send it) */
330 if (asn1_tag_remaining(&data)) {
331 asn1_start_tag(&data,ASN1_CONTEXT(3));
332 asn1_read_OctetString(&data, chal2);
339 ret = !data.has_error;
346 generate a spnego NTLMSSP challenge packet given two security blobs
347 The second challenge is optional
349 BOOL spnego_gen_challenge(DATA_BLOB *blob,
350 DATA_BLOB *chal1, DATA_BLOB *chal2)
356 asn1_push_tag(&data,ASN1_CONTEXT(1));
357 asn1_push_tag(&data,ASN1_SEQUENCE(0));
359 asn1_push_tag(&data,ASN1_CONTEXT(0));
360 asn1_write_enumerated(&data,1);
363 asn1_push_tag(&data,ASN1_CONTEXT(1));
364 asn1_write_OID(&data, OID_NTLMSSP);
367 asn1_push_tag(&data,ASN1_CONTEXT(2));
368 asn1_write_OctetString(&data, chal1->data, chal1->length);
371 /* the second challenge is optional (XP doesn't send it) */
373 asn1_push_tag(&data,ASN1_CONTEXT(3));
374 asn1_write_OctetString(&data, chal2->data, chal2->length);
381 if (data.has_error) {
385 *blob = data_blob(data.data, data.length);
391 generate a SPNEGO NTLMSSP auth packet. This will contain the encrypted passwords
393 DATA_BLOB spnego_gen_auth(DATA_BLOB blob)
398 memset(&data, 0, sizeof(data));
400 asn1_push_tag(&data, ASN1_CONTEXT(1));
401 asn1_push_tag(&data, ASN1_SEQUENCE(0));
402 asn1_push_tag(&data, ASN1_CONTEXT(2));
403 asn1_write_OctetString(&data,blob.data,blob.length);
408 ret = data_blob(data.data, data.length);
416 parse a SPNEGO NTLMSSP auth packet. This contains the encrypted passwords
418 BOOL spnego_parse_auth(DATA_BLOB blob, DATA_BLOB *auth)
422 asn1_load(&data, blob);
423 asn1_start_tag(&data, ASN1_CONTEXT(1));
424 asn1_start_tag(&data, ASN1_SEQUENCE(0));
425 asn1_start_tag(&data, ASN1_CONTEXT(2));
426 asn1_read_OctetString(&data,auth);
431 if (data.has_error) {
432 DEBUG(3,("spnego_parse_auth failed at %d\n", (int)data.ofs));
442 generate a minimal SPNEGO NTLMSSP response packet. Doesn't contain much.
444 DATA_BLOB spnego_gen_auth_response(void)
449 memset(&data, 0, sizeof(data));
451 asn1_push_tag(&data, ASN1_CONTEXT(1));
452 asn1_push_tag(&data, ASN1_SEQUENCE(0));
453 asn1_push_tag(&data, ASN1_CONTEXT(0));
454 asn1_write_enumerated(&data, 0);
459 ret = data_blob(data.data, data.length);
465 this is a tiny msrpc packet generator. I am only using this to
466 avoid tying this code to a particular varient of our rpc code. This
467 generator is not general enough for all our rpc needs, its just
468 enough for the spnego/ntlmssp code
470 format specifiers are:
472 U = unicode string (input is unix string)
473 a = address (1 byte type, 1 byte length, unicode string, all inline)
474 B = data blob (pointer + length)
475 b = data blob in header (pointer + length)
477 C = constant ascii string
479 BOOL msrpc_gen(DATA_BLOB *blob,
480 const char *format, ...)
486 int head_size=0, data_size=0;
487 int head_ofs, data_ofs;
489 /* first scan the format to work out the header and body size */
490 va_start(ap, format);
491 for (i=0; format[i]; i++) {
494 s = va_arg(ap, char *);
496 data_size += str_charnum(s) * 2;
500 s = va_arg(ap, char *);
501 data_size += (str_charnum(s) * 2) + 4;
504 b = va_arg(ap, uint8 *);
506 data_size += va_arg(ap, int);
509 b = va_arg(ap, uint8 *);
510 head_size += va_arg(ap, int);
517 s = va_arg(ap, char *);
518 head_size += str_charnum(s) + 1;
524 /* allocate the space, then scan the format again to fill in the values */
525 *blob = data_blob(NULL, head_size + data_size);
528 data_ofs = head_size;
530 va_start(ap, format);
531 for (i=0; format[i]; i++) {
534 s = va_arg(ap, char *);
536 SSVAL(blob->data, head_ofs, n*2); head_ofs += 2;
537 SSVAL(blob->data, head_ofs, n*2); head_ofs += 2;
538 SIVAL(blob->data, head_ofs, data_ofs); head_ofs += 4;
539 push_string(NULL, blob->data+data_ofs, s, n*2, STR_UNICODE|STR_NOALIGN);
544 SSVAL(blob->data, data_ofs, n); data_ofs += 2;
545 s = va_arg(ap, char *);
547 SSVAL(blob->data, data_ofs, n*2); data_ofs += 2;
549 push_string(NULL, blob->data+data_ofs, s, n*2,
550 STR_UNICODE|STR_NOALIGN);
556 b = va_arg(ap, uint8 *);
558 SSVAL(blob->data, head_ofs, n); head_ofs += 2;
559 SSVAL(blob->data, head_ofs, n); head_ofs += 2;
560 SIVAL(blob->data, head_ofs, data_ofs); head_ofs += 4;
561 memcpy(blob->data+data_ofs, b, n);
566 SIVAL(blob->data, head_ofs, n); head_ofs += 4;
569 b = va_arg(ap, uint8 *);
571 memcpy(blob->data + head_ofs, b, n);
575 s = va_arg(ap, char *);
576 head_ofs += push_string(NULL, blob->data+head_ofs, s, -1,
577 STR_ASCII|STR_TERMINATE);
588 this is a tiny msrpc packet parser. This the the partner of msrpc_gen
590 format specifiers are:
592 U = unicode string (output is unix string)
595 b = data blob in header
597 C = constant ascii string
599 BOOL msrpc_parse(DATA_BLOB *blob,
600 const char *format, ...)
612 va_start(ap, format);
613 for (i=0; format[i]; i++) {
616 len1 = SVAL(blob->data, head_ofs); head_ofs += 2;
617 len2 = SVAL(blob->data, head_ofs); head_ofs += 2;
618 ptr = IVAL(blob->data, head_ofs); head_ofs += 4;
619 /* make sure its in the right format - be strict */
620 if (len1 != len2 || (len1&1) || ptr + len1 > blob->length) {
623 ps = va_arg(ap, char **);
624 pull_string(NULL, p, blob->data + ptr, -1, len1,
625 STR_UNICODE|STR_NOALIGN);
629 len1 = SVAL(blob->data, head_ofs); head_ofs += 2;
630 len2 = SVAL(blob->data, head_ofs); head_ofs += 2;
631 ptr = IVAL(blob->data, head_ofs); head_ofs += 4;
633 /* make sure its in the right format - be strict */
634 if (len1 != len2 || ptr + len1 > blob->length) {
637 ps = va_arg(ap, char **);
639 pull_string(NULL, p, blob->data + ptr, -1,
640 len1, STR_ASCII|STR_NOALIGN);
647 len1 = SVAL(blob->data, head_ofs); head_ofs += 2;
648 len2 = SVAL(blob->data, head_ofs); head_ofs += 2;
649 ptr = IVAL(blob->data, head_ofs); head_ofs += 4;
650 /* make sure its in the right format - be strict */
651 if (len1 != len2 || ptr + len1 > blob->length) {
654 b = (DATA_BLOB *)va_arg(ap, void *);
655 *b = data_blob(blob->data + ptr, len1);
658 b = (DATA_BLOB *)va_arg(ap, void *);
659 len1 = va_arg(ap, unsigned);
660 *b = data_blob(blob->data + head_ofs, len1);
664 v = va_arg(ap, uint32 *);
665 *v = IVAL(blob->data, head_ofs); head_ofs += 4;
668 s = va_arg(ap, char *);
669 head_ofs += pull_string(NULL, p, blob->data+head_ofs, -1,
670 blob->length - head_ofs,
671 STR_ASCII|STR_TERMINATE);
672 if (strcmp(s, p) != 0) {
684 * Print out the NTLMSSP flags for debugging
687 void debug_ntlmssp_flags(uint32 neg_flags)
689 DEBUG(3,("Got NTLMSSP neg_flags=0x%08x\n", neg_flags));
691 if (neg_flags & NTLMSSP_NEGOTIATE_UNICODE)
692 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_UNICODE\n"));
693 if (neg_flags & NTLMSSP_NEGOTIATE_OEM)
694 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_OEM\n"));
695 if (neg_flags & NTLMSSP_REQUEST_TARGET)
696 DEBUGADD(4, (" NTLMSSP_REQUEST_TARGET\n"));
697 if (neg_flags & NTLMSSP_NEGOTIATE_SIGN)
698 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_SIGN\n"));
699 if (neg_flags & NTLMSSP_NEGOTIATE_SEAL)
700 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_SEAL\n"));
701 if (neg_flags & NTLMSSP_NEGOTIATE_LM_KEY)
702 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_LM_KEY\n"));
703 if (neg_flags & NTLMSSP_NEGOTIATE_NETWARE)
704 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_NETWARE\n"));
705 if (neg_flags & NTLMSSP_NEGOTIATE_NTLM)
706 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_NTLM\n"));
707 if (neg_flags & NTLMSSP_NEGOTIATE_DOMAIN_SUPPLIED)
708 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_DOMAIN_SUPPLIED\n"));
709 if (neg_flags & NTLMSSP_NEGOTIATE_WORKSTATION_SUPPLIED)
710 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_WORKSTATION_SUPPLIED\n"));
711 if (neg_flags & NTLMSSP_NEGOTIATE_THIS_IS_LOCAL_CALL)
712 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_THIS_IS_LOCAL_CALL\n"));
713 if (neg_flags & NTLMSSP_NEGOTIATE_ALWAYS_SIGN)
714 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_ALWAYS_SIGN\n"));
715 if (neg_flags & NTLMSSP_NEGOTIATE_NTLM2)
716 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_NTLM2\n"));
717 if (neg_flags & NTLMSSP_CHAL_TARGET_INFO)
718 DEBUGADD(4, (" NTLMSSP_CHAL_TARGET_INFO\n"));
719 if (neg_flags & NTLMSSP_NEGOTIATE_128)
720 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_128\n"));
721 if (neg_flags & NTLMSSP_NEGOTIATE_KEY_EXCH)
722 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_KEY_EXCH\n"));