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 A = ASCII string (pointer + length) Actually same as B
475 B = data blob (pointer + length)
476 b = data blob in header (pointer + length)
478 C = constant ascii string
480 BOOL msrpc_gen(DATA_BLOB *blob,
481 const char *format, ...)
487 int head_size=0, data_size=0;
488 int head_ofs, data_ofs;
490 /* first scan the format to work out the header and body size */
491 va_start(ap, format);
492 for (i=0; format[i]; i++) {
495 s = va_arg(ap, char *);
497 data_size += str_charnum(s) * 2;
501 s = va_arg(ap, char *);
502 data_size += (str_charnum(s) * 2) + 4;
506 b = va_arg(ap, uint8 *);
508 data_size += va_arg(ap, int);
511 b = va_arg(ap, uint8 *);
512 head_size += va_arg(ap, int);
519 s = va_arg(ap, char *);
520 head_size += str_charnum(s) + 1;
526 /* allocate the space, then scan the format again to fill in the values */
527 *blob = data_blob(NULL, head_size + data_size);
530 data_ofs = head_size;
532 va_start(ap, format);
533 for (i=0; format[i]; i++) {
536 s = va_arg(ap, char *);
538 SSVAL(blob->data, head_ofs, n*2); head_ofs += 2;
539 SSVAL(blob->data, head_ofs, n*2); head_ofs += 2;
540 SIVAL(blob->data, head_ofs, data_ofs); head_ofs += 4;
541 push_string(NULL, blob->data+data_ofs, s, n*2, STR_UNICODE|STR_NOALIGN);
546 SSVAL(blob->data, data_ofs, n); data_ofs += 2;
547 s = va_arg(ap, char *);
549 SSVAL(blob->data, data_ofs, n*2); data_ofs += 2;
551 push_string(NULL, blob->data+data_ofs, s, n*2,
552 STR_UNICODE|STR_NOALIGN);
558 b = va_arg(ap, uint8 *);
560 SSVAL(blob->data, head_ofs, n); head_ofs += 2;
561 SSVAL(blob->data, head_ofs, n); head_ofs += 2;
562 SIVAL(blob->data, head_ofs, data_ofs); head_ofs += 4;
563 memcpy(blob->data+data_ofs, b, n);
568 SIVAL(blob->data, head_ofs, n); head_ofs += 4;
571 b = va_arg(ap, uint8 *);
573 memcpy(blob->data + head_ofs, b, n);
577 s = va_arg(ap, char *);
578 head_ofs += push_string(NULL, blob->data+head_ofs, s, -1,
579 STR_ASCII|STR_TERMINATE);
590 this is a tiny msrpc packet parser. This the the partner of msrpc_gen
592 format specifiers are:
594 U = unicode string (output is unix string)
597 b = data blob in header
599 C = constant ascii string
601 BOOL msrpc_parse(DATA_BLOB *blob,
602 const char *format, ...)
614 va_start(ap, format);
615 for (i=0; format[i]; i++) {
618 len1 = SVAL(blob->data, head_ofs); head_ofs += 2;
619 len2 = SVAL(blob->data, head_ofs); head_ofs += 2;
620 ptr = IVAL(blob->data, head_ofs); head_ofs += 4;
621 /* make sure its in the right format - be strict */
622 if (len1 != len2 || (len1&1) || ptr + len1 > blob->length) {
625 ps = va_arg(ap, char **);
626 pull_string(NULL, p, blob->data + ptr, -1, len1,
627 STR_UNICODE|STR_NOALIGN);
631 len1 = SVAL(blob->data, head_ofs); head_ofs += 2;
632 len2 = SVAL(blob->data, head_ofs); head_ofs += 2;
633 ptr = IVAL(blob->data, head_ofs); head_ofs += 4;
635 /* make sure its in the right format - be strict */
636 if (len1 != len2 || ptr + len1 > blob->length) {
639 ps = va_arg(ap, char **);
641 pull_string(NULL, p, blob->data + ptr, -1,
642 len1, STR_ASCII|STR_NOALIGN);
649 len1 = SVAL(blob->data, head_ofs); head_ofs += 2;
650 len2 = SVAL(blob->data, head_ofs); head_ofs += 2;
651 ptr = IVAL(blob->data, head_ofs); head_ofs += 4;
652 /* make sure its in the right format - be strict */
653 if (len1 != len2 || ptr + len1 > blob->length) {
656 b = (DATA_BLOB *)va_arg(ap, void *);
657 *b = data_blob(blob->data + ptr, len1);
660 b = (DATA_BLOB *)va_arg(ap, void *);
661 len1 = va_arg(ap, unsigned);
662 *b = data_blob(blob->data + head_ofs, len1);
666 v = va_arg(ap, uint32 *);
667 *v = IVAL(blob->data, head_ofs); head_ofs += 4;
670 s = va_arg(ap, char *);
671 head_ofs += pull_string(NULL, p, blob->data+head_ofs, -1,
672 blob->length - head_ofs,
673 STR_ASCII|STR_TERMINATE);
674 if (strcmp(s, p) != 0) {
686 * Print out the NTLMSSP flags for debugging
689 void debug_ntlmssp_flags(uint32 neg_flags)
691 DEBUG(3,("Got NTLMSSP neg_flags=0x%08x\n", neg_flags));
693 if (neg_flags & NTLMSSP_NEGOTIATE_UNICODE)
694 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_UNICODE\n"));
695 if (neg_flags & NTLMSSP_NEGOTIATE_OEM)
696 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_OEM\n"));
697 if (neg_flags & NTLMSSP_REQUEST_TARGET)
698 DEBUGADD(4, (" NTLMSSP_REQUEST_TARGET\n"));
699 if (neg_flags & NTLMSSP_NEGOTIATE_SIGN)
700 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_SIGN\n"));
701 if (neg_flags & NTLMSSP_NEGOTIATE_SEAL)
702 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_SEAL\n"));
703 if (neg_flags & NTLMSSP_NEGOTIATE_LM_KEY)
704 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_LM_KEY\n"));
705 if (neg_flags & NTLMSSP_NEGOTIATE_NETWARE)
706 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_NETWARE\n"));
707 if (neg_flags & NTLMSSP_NEGOTIATE_NTLM)
708 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_NTLM\n"));
709 if (neg_flags & NTLMSSP_NEGOTIATE_DOMAIN_SUPPLIED)
710 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_DOMAIN_SUPPLIED\n"));
711 if (neg_flags & NTLMSSP_NEGOTIATE_WORKSTATION_SUPPLIED)
712 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_WORKSTATION_SUPPLIED\n"));
713 if (neg_flags & NTLMSSP_NEGOTIATE_THIS_IS_LOCAL_CALL)
714 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_THIS_IS_LOCAL_CALL\n"));
715 if (neg_flags & NTLMSSP_NEGOTIATE_ALWAYS_SIGN)
716 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_ALWAYS_SIGN\n"));
717 if (neg_flags & NTLMSSP_NEGOTIATE_NTLM2)
718 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_NTLM2\n"));
719 if (neg_flags & NTLMSSP_CHAL_TARGET_INFO)
720 DEBUGADD(4, (" NTLMSSP_CHAL_TARGET_INFO\n"));
721 if (neg_flags & NTLMSSP_NEGOTIATE_128)
722 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_128\n"));
723 if (neg_flags & NTLMSSP_NEGOTIATE_KEY_EXCH)
724 DEBUGADD(4, (" NTLMSSP_NEGOTIATE_KEY_EXCH\n"));