2 Unix SMB/CIFS implementation.
3 simple kerberos5/SPNEGO routines
4 Copyright (C) Andrew Tridgell 2001
5 Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2002
6 Copyright (C) Luke Howard 2003
7 Copyright (C) Jeremy Allison 2010
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 #include "../libcli/auth/spnego.h"
26 #include "../lib/util/asn1.h"
29 generate a negTokenInit packet given a list of supported
30 OIDs (the mechanisms) a blob, and a principal name string
33 DATA_BLOB
spnego_gen_negTokenInit(TALLOC_CTX
*ctx
,
36 const char *principal
)
42 data
= asn1_init(talloc_tos());
44 return data_blob_null
;
47 asn1_push_tag(data
,ASN1_APPLICATION(0));
48 asn1_write_OID(data
,OID_SPNEGO
);
49 asn1_push_tag(data
,ASN1_CONTEXT(0));
50 asn1_push_tag(data
,ASN1_SEQUENCE(0));
52 asn1_push_tag(data
,ASN1_CONTEXT(0));
53 asn1_push_tag(data
,ASN1_SEQUENCE(0));
54 for (i
=0; OIDs
[i
]; i
++) {
55 asn1_write_OID(data
,OIDs
[i
]);
60 if (psecblob
&& psecblob
->length
&& psecblob
->data
) {
61 asn1_push_tag(data
, ASN1_CONTEXT(2));
62 asn1_write_OctetString(data
,psecblob
->data
,
68 asn1_push_tag(data
, ASN1_CONTEXT(3));
69 asn1_push_tag(data
, ASN1_SEQUENCE(0));
70 asn1_push_tag(data
, ASN1_CONTEXT(0));
71 asn1_write_GeneralString(data
,principal
);
82 if (data
->has_error
) {
83 DEBUG(1,("Failed to build negTokenInit at offset %d\n", (int)data
->ofs
));
86 ret
= data_blob_talloc(ctx
, data
->data
, data
->length
);
93 parse a negTokenInit packet giving a GUID, a list of supported
94 OIDs (the mechanisms) and a principal name string
96 bool spnego_parse_negTokenInit(TALLOC_CTX
*ctx
,
98 char *OIDs
[ASN1_MAX_OIDS
],
106 data
= asn1_init(talloc_tos());
111 asn1_load(data
, blob
);
113 asn1_start_tag(data
,ASN1_APPLICATION(0));
115 asn1_check_OID(data
,OID_SPNEGO
);
117 /* negTokenInit [0] NegTokenInit */
118 asn1_start_tag(data
,ASN1_CONTEXT(0));
119 asn1_start_tag(data
,ASN1_SEQUENCE(0));
121 /* mechTypes [0] MechTypeList OPTIONAL */
123 /* Not really optional, we depend on this to decide
124 * what mechanisms we have to work with. */
126 asn1_start_tag(data
,ASN1_CONTEXT(0));
127 asn1_start_tag(data
,ASN1_SEQUENCE(0));
128 for (i
=0; asn1_tag_remaining(data
) > 0 && i
< ASN1_MAX_OIDS
-1; i
++) {
129 if (!asn1_read_OID(data
,ctx
, &OIDs
[i
])) {
132 if (data
->has_error
) {
144 *secblob
= data_blob_null
;
148 Win7 + Live Sign-in Assistant attaches a mechToken
149 ASN1_CONTEXT(2) to the negTokenInit packet
150 which breaks our negotiation if we just assume
151 the next tag is ASN1_CONTEXT(3).
154 if (asn1_peek_tag(data
, ASN1_CONTEXT(1))) {
157 /* reqFlags [1] ContextFlags OPTIONAL */
158 asn1_start_tag(data
, ASN1_CONTEXT(1));
159 asn1_start_tag(data
, ASN1_BIT_STRING
);
160 while (asn1_tag_remaining(data
) > 0) {
161 asn1_read_uint8(data
, &flags
);
167 if (asn1_peek_tag(data
, ASN1_CONTEXT(2))) {
168 DATA_BLOB sblob
= data_blob_null
;
169 /* mechToken [2] OCTET STRING OPTIONAL */
170 asn1_start_tag(data
, ASN1_CONTEXT(2));
171 asn1_read_OctetString(data
, ctx
, &sblob
);
176 data_blob_free(&sblob
);
180 if (asn1_peek_tag(data
, ASN1_CONTEXT(3))) {
182 /* mechListMIC [3] OCTET STRING OPTIONAL */
183 asn1_start_tag(data
, ASN1_CONTEXT(3));
184 asn1_start_tag(data
, ASN1_SEQUENCE(0));
185 asn1_start_tag(data
, ASN1_CONTEXT(0));
186 asn1_read_GeneralString(data
, ctx
, &princ
);
202 ret
= !data
->has_error
;
203 if (data
->has_error
) {
206 TALLOC_FREE(*principal
);
209 data_blob_free(secblob
);
211 for(j
= 0; j
< i
&& j
< ASN1_MAX_OIDS
-1; j
++) {
212 TALLOC_FREE(OIDs
[j
]);
221 generate a krb5 GSS-API wrapper packet given a ticket
223 DATA_BLOB
spnego_gen_krb5_wrap(TALLOC_CTX
*ctx
, const DATA_BLOB ticket
, const uint8 tok_id
[2])
228 data
= asn1_init(talloc_tos());
230 return data_blob_null
;
233 asn1_push_tag(data
, ASN1_APPLICATION(0));
234 asn1_write_OID(data
, OID_KERBEROS5
);
236 asn1_write(data
, tok_id
, 2);
237 asn1_write(data
, ticket
.data
, ticket
.length
);
240 if (data
->has_error
) {
241 DEBUG(1,("Failed to build krb5 wrapper at offset %d\n", (int)data
->ofs
));
244 ret
= data_blob_talloc(ctx
, data
->data
, data
->length
);
251 parse a krb5 GSS-API wrapper packet giving a ticket
253 bool spnego_parse_krb5_wrap(TALLOC_CTX
*ctx
, DATA_BLOB blob
, DATA_BLOB
*ticket
, uint8 tok_id
[2])
259 data
= asn1_init(talloc_tos());
264 asn1_load(data
, blob
);
265 asn1_start_tag(data
, ASN1_APPLICATION(0));
266 asn1_check_OID(data
, OID_KERBEROS5
);
268 data_remaining
= asn1_tag_remaining(data
);
270 if (data_remaining
< 3) {
271 data
->has_error
= True
;
273 asn1_read(data
, tok_id
, 2);
275 *ticket
= data_blob_talloc(ctx
, NULL
, data_remaining
);
276 asn1_read(data
, ticket
->data
, ticket
->length
);
281 ret
= !data
->has_error
;
283 if (data
->has_error
) {
284 data_blob_free(ticket
);
294 generate a SPNEGO krb5 negTokenInit packet, ready for a EXTENDED_SECURITY
295 kerberos session setup
297 int spnego_gen_krb5_negTokenInit(TALLOC_CTX
*ctx
,
298 const char *principal
, int time_offset
,
300 DATA_BLOB
*session_key_krb5
, uint32 extra_ap_opts
,
304 DATA_BLOB tkt
, tkt_wrapped
;
305 const char *krb_mechs
[] = {OID_KERBEROS5_OLD
, OID_KERBEROS5
, OID_NTLMSSP
, NULL
};
307 /* get a kerberos ticket for the service and extract the session key */
308 retval
= cli_krb5_get_ticket(ctx
, principal
, time_offset
,
309 &tkt
, session_key_krb5
,
316 /* wrap that up in a nice GSS-API wrapping */
317 tkt_wrapped
= spnego_gen_krb5_wrap(ctx
, tkt
, TOK_ID_KRB_AP_REQ
);
319 /* and wrap that in a shiny SPNEGO wrapper */
320 *targ
= spnego_gen_negTokenInit(ctx
, krb_mechs
, &tkt_wrapped
, NULL
);
322 data_blob_free(&tkt_wrapped
);
323 data_blob_free(&tkt
);
330 parse a spnego NTLMSSP challenge packet giving two security blobs
332 bool spnego_parse_challenge(TALLOC_CTX
*ctx
, const DATA_BLOB blob
,
333 DATA_BLOB
*chal1
, DATA_BLOB
*chal2
)
341 data
= asn1_init(talloc_tos());
346 asn1_load(data
, blob
);
347 asn1_start_tag(data
,ASN1_CONTEXT(1));
348 asn1_start_tag(data
,ASN1_SEQUENCE(0));
350 asn1_start_tag(data
,ASN1_CONTEXT(0));
351 asn1_check_enumerated(data
,1);
354 asn1_start_tag(data
,ASN1_CONTEXT(1));
355 asn1_check_OID(data
, OID_NTLMSSP
);
358 asn1_start_tag(data
,ASN1_CONTEXT(2));
359 asn1_read_OctetString(data
, ctx
, chal1
);
362 /* the second challenge is optional (XP doesn't send it) */
363 if (asn1_tag_remaining(data
)) {
364 asn1_start_tag(data
,ASN1_CONTEXT(3));
365 asn1_read_OctetString(data
, ctx
, chal2
);
372 ret
= !data
->has_error
;
374 if (data
->has_error
) {
375 data_blob_free(chal1
);
376 data_blob_free(chal2
);
385 generate a SPNEGO auth packet. This will contain the encrypted passwords
387 DATA_BLOB
spnego_gen_auth(TALLOC_CTX
*ctx
, DATA_BLOB blob
)
392 data
= asn1_init(talloc_tos());
394 return data_blob_null
;
397 asn1_push_tag(data
, ASN1_CONTEXT(1));
398 asn1_push_tag(data
, ASN1_SEQUENCE(0));
399 asn1_push_tag(data
, ASN1_CONTEXT(2));
400 asn1_write_OctetString(data
,blob
.data
,blob
.length
);
405 ret
= data_blob_talloc(ctx
, data
->data
, data
->length
);
413 parse a SPNEGO auth packet. This contains the encrypted passwords
415 bool spnego_parse_auth_and_mic(TALLOC_CTX
*ctx
, DATA_BLOB blob
,
416 DATA_BLOB
*auth
, DATA_BLOB
*signature
)
419 struct spnego_data token
;
421 len
= spnego_read_data(talloc_tos(), blob
, &token
);
423 DEBUG(3,("spnego_parse_auth: spnego_read_data failed\n"));
427 if (token
.type
!= SPNEGO_NEG_TOKEN_TARG
) {
428 DEBUG(3,("spnego_parse_auth: wrong token type: %d\n",
430 spnego_free_data(&token
);
434 *auth
= data_blob_talloc(ctx
,
435 token
.negTokenTarg
.responseToken
.data
,
436 token
.negTokenTarg
.responseToken
.length
);
442 *signature
= data_blob_talloc(ctx
,
443 token
.negTokenTarg
.mechListMIC
.data
,
444 token
.negTokenTarg
.mechListMIC
.length
);
447 spnego_free_data(&token
);
452 bool spnego_parse_auth(TALLOC_CTX
*ctx
, DATA_BLOB blob
, DATA_BLOB
*auth
)
454 return spnego_parse_auth_and_mic(ctx
, blob
, auth
, NULL
);
458 generate a minimal SPNEGO response packet. Doesn't contain much.
460 DATA_BLOB
spnego_gen_auth_response_and_mic(TALLOC_CTX
*ctx
,
464 DATA_BLOB
*mechlistMIC
)
470 if (NT_STATUS_IS_OK(nt_status
)) {
471 negResult
= SPNEGO_ACCEPT_COMPLETED
;
472 } else if (NT_STATUS_EQUAL(nt_status
, NT_STATUS_MORE_PROCESSING_REQUIRED
)) {
473 negResult
= SPNEGO_ACCEPT_INCOMPLETE
;
475 negResult
= SPNEGO_REJECT
;
478 data
= asn1_init(talloc_tos());
480 return data_blob_null
;
483 asn1_push_tag(data
, ASN1_CONTEXT(1));
484 asn1_push_tag(data
, ASN1_SEQUENCE(0));
485 asn1_push_tag(data
, ASN1_CONTEXT(0));
486 asn1_write_enumerated(data
, negResult
);
490 asn1_push_tag(data
,ASN1_CONTEXT(1));
491 asn1_write_OID(data
, mechOID
);
495 if (reply
&& reply
->data
!= NULL
) {
496 asn1_push_tag(data
,ASN1_CONTEXT(2));
497 asn1_write_OctetString(data
, reply
->data
, reply
->length
);
501 if (mechlistMIC
&& mechlistMIC
->data
!= NULL
) {
502 asn1_push_tag(data
, ASN1_CONTEXT(3));
503 asn1_write_OctetString(data
,
505 mechlistMIC
->length
);
512 ret
= data_blob_talloc(ctx
, data
->data
, data
->length
);
517 DATA_BLOB
spnego_gen_auth_response(TALLOC_CTX
*ctx
, DATA_BLOB
*reply
,
518 NTSTATUS nt_status
, const char *mechOID
)
520 return spnego_gen_auth_response_and_mic(ctx
, nt_status
,
521 mechOID
, reply
, NULL
);
525 parse a SPNEGO auth packet. This contains the encrypted passwords
527 bool spnego_parse_auth_response(TALLOC_CTX
*ctx
,
528 DATA_BLOB blob
, NTSTATUS nt_status
,
535 if (NT_STATUS_IS_OK(nt_status
)) {
536 negResult
= SPNEGO_ACCEPT_COMPLETED
;
537 } else if (NT_STATUS_EQUAL(nt_status
, NT_STATUS_MORE_PROCESSING_REQUIRED
)) {
538 negResult
= SPNEGO_ACCEPT_INCOMPLETE
;
540 negResult
= SPNEGO_REJECT
;
543 data
= asn1_init(talloc_tos());
548 asn1_load(data
, blob
);
549 asn1_start_tag(data
, ASN1_CONTEXT(1));
550 asn1_start_tag(data
, ASN1_SEQUENCE(0));
551 asn1_start_tag(data
, ASN1_CONTEXT(0));
552 asn1_check_enumerated(data
, negResult
);
555 *auth
= data_blob_null
;
557 if (asn1_tag_remaining(data
)) {
558 asn1_start_tag(data
,ASN1_CONTEXT(1));
559 asn1_check_OID(data
, mechOID
);
562 if (asn1_tag_remaining(data
)) {
563 asn1_start_tag(data
,ASN1_CONTEXT(2));
564 asn1_read_OctetString(data
, ctx
, auth
);
567 } else if (negResult
== SPNEGO_ACCEPT_INCOMPLETE
) {
571 /* Binding against Win2K DC returns a duplicate of the responseToken in
572 * the optional mechListMIC field. This is a bug in Win2K. We ignore
573 * this field if it exists. Win2K8 may return a proper mechListMIC at
574 * which point we need to implement the integrity checking. */
575 if (asn1_tag_remaining(data
)) {
576 DATA_BLOB mechList
= data_blob_null
;
577 asn1_start_tag(data
, ASN1_CONTEXT(3));
578 asn1_read_OctetString(data
, ctx
, &mechList
);
580 data_blob_free(&mechList
);
581 DEBUG(5,("spnego_parse_auth_response received mechListMIC, "
588 if (data
->has_error
) {
589 DEBUG(3,("spnego_parse_auth_response failed at %d\n", (int)data
->ofs
));
591 data_blob_free(auth
);
599 bool spnego_mech_list_blob(TALLOC_CTX
*mem_ctx
,
600 char **oid_list
, DATA_BLOB
*raw_data
)
605 if (!oid_list
|| !oid_list
[0] || !raw_data
) {
609 data
= asn1_init(talloc_tos());
614 asn1_push_tag(data
, ASN1_SEQUENCE(0));
615 for (idx
= 0; oid_list
[idx
]; idx
++) {
616 asn1_write_OID(data
, oid_list
[idx
]);
620 if (data
->has_error
) {
621 DEBUG(3, (__location__
" failed at %d\n", (int)data
->ofs
));
626 *raw_data
= data_blob_talloc(mem_ctx
, data
->data
, data
->length
);
627 if (!raw_data
->data
) {
628 DEBUG(3, (__location__
": data_blob_talloc() failed!\n"));