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
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
26 generate a negTokenInit packet given a GUID, a list of supported
27 OIDs (the mechanisms) and a principal name string
29 DATA_BLOB
spnego_gen_negTokenInit(char guid
[16],
31 const char *principal
)
37 data
= asn1_init(talloc_tos());
39 return data_blob_null
;
42 asn1_write(data
, guid
, 16);
43 asn1_push_tag(data
,ASN1_APPLICATION(0));
44 asn1_write_OID(data
,OID_SPNEGO
);
45 asn1_push_tag(data
,ASN1_CONTEXT(0));
46 asn1_push_tag(data
,ASN1_SEQUENCE(0));
48 asn1_push_tag(data
,ASN1_CONTEXT(0));
49 asn1_push_tag(data
,ASN1_SEQUENCE(0));
50 for (i
=0; OIDs
[i
]; i
++) {
51 asn1_write_OID(data
,OIDs
[i
]);
56 asn1_push_tag(data
, ASN1_CONTEXT(3));
57 asn1_push_tag(data
, ASN1_SEQUENCE(0));
58 asn1_push_tag(data
, ASN1_CONTEXT(0));
59 asn1_write_GeneralString(data
,principal
);
69 if (data
->has_error
) {
70 DEBUG(1,("Failed to build negTokenInit at offset %d\n", (int)data
->ofs
));
73 ret
= data_blob(data
->data
, data
->length
);
80 Generate a negTokenInit as used by the client side ... It has a mechType
81 (OID), and a mechToken (a security blob) ...
83 Really, we need to break out the NTLMSSP stuff as well, because it could be
86 DATA_BLOB
gen_negTokenInit(const char *OID
, DATA_BLOB blob
)
91 data
= asn1_init(talloc_tos());
93 return data_blob_null
;
96 asn1_push_tag(data
, ASN1_APPLICATION(0));
97 asn1_write_OID(data
,OID_SPNEGO
);
98 asn1_push_tag(data
, ASN1_CONTEXT(0));
99 asn1_push_tag(data
, ASN1_SEQUENCE(0));
101 asn1_push_tag(data
, ASN1_CONTEXT(0));
102 asn1_push_tag(data
, ASN1_SEQUENCE(0));
103 asn1_write_OID(data
, OID
);
107 asn1_push_tag(data
, ASN1_CONTEXT(2));
108 asn1_write_OctetString(data
,blob
.data
,blob
.length
);
116 if (data
->has_error
) {
117 DEBUG(1,("Failed to build negTokenInit at offset %d\n", (int)data
->ofs
));
120 ret
= data_blob(data
->data
, data
->length
);
127 parse a negTokenInit packet giving a GUID, a list of supported
128 OIDs (the mechanisms) and a principal name string
130 bool spnego_parse_negTokenInit(DATA_BLOB blob
,
131 char *OIDs
[ASN1_MAX_OIDS
],
138 data
= asn1_init(talloc_tos());
143 asn1_load(data
, blob
);
145 asn1_start_tag(data
,ASN1_APPLICATION(0));
147 asn1_check_OID(data
,OID_SPNEGO
);
149 /* negTokenInit [0] NegTokenInit */
150 asn1_start_tag(data
,ASN1_CONTEXT(0));
151 asn1_start_tag(data
,ASN1_SEQUENCE(0));
153 /* mechTypes [0] MechTypeList OPTIONAL */
155 /* Not really optional, we depend on this to decide
156 * what mechanisms we have to work with. */
158 asn1_start_tag(data
,ASN1_CONTEXT(0));
159 asn1_start_tag(data
,ASN1_SEQUENCE(0));
160 for (i
=0; asn1_tag_remaining(data
) > 0 && i
< ASN1_MAX_OIDS
-1; i
++) {
161 const char *oid_str
= NULL
;
162 asn1_read_OID(data
,NULL
,&oid_str
);
163 OIDs
[i
] = CONST_DISCARD(char *, oid_str
);
173 Win7 + Live Sign-in Assistant attaches a mechToken
174 ASN1_CONTEXT(2) to the negTokenInit packet
175 which breaks our negotiation if we just assume
176 the next tag is ASN1_CONTEXT(3).
179 if (asn1_peek_tag(data
, ASN1_CONTEXT(1))) {
182 /* reqFlags [1] ContextFlags OPTIONAL */
183 asn1_start_tag(data
, ASN1_CONTEXT(1));
184 asn1_start_tag(data
, ASN1_BITFIELD
);
185 while (asn1_tag_remaining(data
) > 0) {
186 asn1_read_uint8(data
, &flags
);
192 if (asn1_peek_tag(data
, ASN1_CONTEXT(2))) {
193 /* mechToken [2] OCTET STRING OPTIONAL */
195 asn1_start_tag(data
, ASN1_CONTEXT(2));
196 asn1_read_OctetString(data
, NULL
, &token
);
198 /* Throw away the token - not used. */
199 data_blob_free(&token
);
202 if (asn1_peek_tag(data
, ASN1_CONTEXT(3))) {
203 /* mechListMIC [3] OCTET STRING OPTIONAL */
204 asn1_start_tag(data
, ASN1_CONTEXT(3));
205 asn1_start_tag(data
, ASN1_SEQUENCE(0));
206 asn1_start_tag(data
, ASN1_CONTEXT(0));
207 asn1_read_GeneralString(data
,NULL
,principal
);
218 ret
= !data
->has_error
;
219 if (data
->has_error
) {
221 TALLOC_FREE(*principal
);
222 for(j
= 0; j
< i
&& j
< ASN1_MAX_OIDS
-1; j
++) {
223 TALLOC_FREE(OIDs
[j
]);
232 generate a negTokenTarg packet given a list of OIDs and a security blob
234 DATA_BLOB
gen_negTokenTarg(const char *OIDs
[], DATA_BLOB blob
)
240 data
= asn1_init(talloc_tos());
242 return data_blob_null
;
245 asn1_push_tag(data
, ASN1_APPLICATION(0));
246 asn1_write_OID(data
,OID_SPNEGO
);
247 asn1_push_tag(data
, ASN1_CONTEXT(0));
248 asn1_push_tag(data
, ASN1_SEQUENCE(0));
250 asn1_push_tag(data
, ASN1_CONTEXT(0));
251 asn1_push_tag(data
, ASN1_SEQUENCE(0));
252 for (i
=0; OIDs
[i
]; i
++) {
253 asn1_write_OID(data
,OIDs
[i
]);
258 asn1_push_tag(data
, ASN1_CONTEXT(2));
259 asn1_write_OctetString(data
,blob
.data
,blob
.length
);
267 if (data
->has_error
) {
268 DEBUG(1,("Failed to build negTokenTarg at offset %d\n", (int)data
->ofs
));
271 ret
= data_blob(data
->data
, data
->length
);
278 parse a negTokenTarg packet giving a list of OIDs and a security blob
280 bool parse_negTokenTarg(DATA_BLOB blob
, char *OIDs
[ASN1_MAX_OIDS
], DATA_BLOB
*secblob
)
285 data
= asn1_init(talloc_tos());
290 asn1_load(data
, blob
);
291 asn1_start_tag(data
, ASN1_APPLICATION(0));
292 asn1_check_OID(data
,OID_SPNEGO
);
293 asn1_start_tag(data
, ASN1_CONTEXT(0));
294 asn1_start_tag(data
, ASN1_SEQUENCE(0));
296 asn1_start_tag(data
, ASN1_CONTEXT(0));
297 asn1_start_tag(data
, ASN1_SEQUENCE(0));
298 for (i
=0; asn1_tag_remaining(data
) > 0 && i
< ASN1_MAX_OIDS
-1; i
++) {
299 const char *oid_str
= NULL
;
300 asn1_read_OID(data
,NULL
,&oid_str
);
301 OIDs
[i
] = CONST_DISCARD(char *, oid_str
);
307 /* Skip any optional req_flags that are sent per RFC 4178 */
308 if (asn1_peek_tag(data
, ASN1_CONTEXT(1))) {
311 asn1_start_tag(data
, ASN1_CONTEXT(1));
312 asn1_start_tag(data
, ASN1_BITFIELD
);
313 while (asn1_tag_remaining(data
) > 0)
314 asn1_read_uint8(data
, &flags
);
319 asn1_start_tag(data
, ASN1_CONTEXT(2));
320 asn1_read_OctetString(data
,NULL
,secblob
);
328 if (data
->has_error
) {
330 data_blob_free(secblob
);
331 for(j
= 0; j
< i
&& j
< ASN1_MAX_OIDS
-1; j
++) {
332 TALLOC_FREE(OIDs
[j
]);
334 DEBUG(1,("Failed to parse negTokenTarg at offset %d\n", (int)data
->ofs
));
344 generate a krb5 GSS-API wrapper packet given a ticket
346 DATA_BLOB
spnego_gen_krb5_wrap(const DATA_BLOB ticket
, const uint8 tok_id
[2])
351 data
= asn1_init(talloc_tos());
353 return data_blob_null
;
356 asn1_push_tag(data
, ASN1_APPLICATION(0));
357 asn1_write_OID(data
, OID_KERBEROS5
);
359 asn1_write(data
, tok_id
, 2);
360 asn1_write(data
, ticket
.data
, ticket
.length
);
363 if (data
->has_error
) {
364 DEBUG(1,("Failed to build krb5 wrapper at offset %d\n", (int)data
->ofs
));
367 ret
= data_blob(data
->data
, data
->length
);
374 parse a krb5 GSS-API wrapper packet giving a ticket
376 bool spnego_parse_krb5_wrap(DATA_BLOB blob
, DATA_BLOB
*ticket
, uint8 tok_id
[2])
382 data
= asn1_init(talloc_tos());
387 asn1_load(data
, blob
);
388 asn1_start_tag(data
, ASN1_APPLICATION(0));
389 asn1_check_OID(data
, OID_KERBEROS5
);
391 data_remaining
= asn1_tag_remaining(data
);
393 if (data_remaining
< 3) {
394 data
->has_error
= True
;
396 asn1_read(data
, tok_id
, 2);
398 *ticket
= data_blob(NULL
, data_remaining
);
399 asn1_read(data
, ticket
->data
, ticket
->length
);
404 ret
= !data
->has_error
;
406 if (data
->has_error
) {
407 data_blob_free(ticket
);
417 generate a SPNEGO negTokenTarg packet, ready for a EXTENDED_SECURITY
418 kerberos session setup
420 int spnego_gen_negTokenTarg(const char *principal
, int time_offset
,
422 DATA_BLOB
*session_key_krb5
, uint32 extra_ap_opts
,
426 DATA_BLOB tkt
, tkt_wrapped
;
427 const char *krb_mechs
[] = {OID_KERBEROS5_OLD
, OID_KERBEROS5
, OID_NTLMSSP
, NULL
};
429 /* get a kerberos ticket for the service and extract the session key */
430 retval
= cli_krb5_get_ticket(principal
, time_offset
,
431 &tkt
, session_key_krb5
, extra_ap_opts
, NULL
,
437 /* wrap that up in a nice GSS-API wrapping */
438 tkt_wrapped
= spnego_gen_krb5_wrap(tkt
, TOK_ID_KRB_AP_REQ
);
440 /* and wrap that in a shiny SPNEGO wrapper */
441 *targ
= gen_negTokenTarg(krb_mechs
, tkt_wrapped
);
443 data_blob_free(&tkt_wrapped
);
444 data_blob_free(&tkt
);
451 parse a spnego NTLMSSP challenge packet giving two security blobs
453 bool spnego_parse_challenge(const DATA_BLOB blob
,
454 DATA_BLOB
*chal1
, DATA_BLOB
*chal2
)
462 data
= asn1_init(talloc_tos());
467 asn1_load(data
, blob
);
468 asn1_start_tag(data
,ASN1_CONTEXT(1));
469 asn1_start_tag(data
,ASN1_SEQUENCE(0));
471 asn1_start_tag(data
,ASN1_CONTEXT(0));
472 asn1_check_enumerated(data
,1);
475 asn1_start_tag(data
,ASN1_CONTEXT(1));
476 asn1_check_OID(data
, OID_NTLMSSP
);
479 asn1_start_tag(data
,ASN1_CONTEXT(2));
480 asn1_read_OctetString(data
, NULL
, chal1
);
483 /* the second challenge is optional (XP doesn't send it) */
484 if (asn1_tag_remaining(data
)) {
485 asn1_start_tag(data
,ASN1_CONTEXT(3));
486 asn1_read_OctetString(data
, NULL
, chal2
);
493 ret
= !data
->has_error
;
495 if (data
->has_error
) {
496 data_blob_free(chal1
);
497 data_blob_free(chal2
);
506 generate a SPNEGO auth packet. This will contain the encrypted passwords
508 DATA_BLOB
spnego_gen_auth(DATA_BLOB blob
)
513 data
= asn1_init(talloc_tos());
515 return data_blob_null
;
518 asn1_push_tag(data
, ASN1_CONTEXT(1));
519 asn1_push_tag(data
, ASN1_SEQUENCE(0));
520 asn1_push_tag(data
, ASN1_CONTEXT(2));
521 asn1_write_OctetString(data
,blob
.data
,blob
.length
);
526 ret
= data_blob(data
->data
, data
->length
);
534 parse a SPNEGO auth packet. This contains the encrypted passwords
536 bool spnego_parse_auth(DATA_BLOB blob
, DATA_BLOB
*auth
)
541 len
= read_spnego_data(talloc_tos(), blob
, &token
);
543 DEBUG(3,("spnego_parse_auth: read_spnego_data failed\n"));
547 if (token
.type
!= SPNEGO_NEG_TOKEN_TARG
) {
548 DEBUG(3,("spnego_parse_auth: wrong token type: %d\n",
550 free_spnego_data(&token
);
554 *auth
= data_blob_talloc(talloc_tos(),
555 token
.negTokenTarg
.responseToken
.data
,
556 token
.negTokenTarg
.responseToken
.length
);
557 free_spnego_data(&token
);
563 generate a minimal SPNEGO response packet. Doesn't contain much.
565 DATA_BLOB
spnego_gen_auth_response(DATA_BLOB
*reply
, NTSTATUS nt_status
,
572 if (NT_STATUS_IS_OK(nt_status
)) {
573 negResult
= SPNEGO_NEG_RESULT_ACCEPT
;
574 } else if (NT_STATUS_EQUAL(nt_status
, NT_STATUS_MORE_PROCESSING_REQUIRED
)) {
575 negResult
= SPNEGO_NEG_RESULT_INCOMPLETE
;
577 negResult
= SPNEGO_NEG_RESULT_REJECT
;
580 data
= asn1_init(talloc_tos());
582 return data_blob_null
;
585 asn1_push_tag(data
, ASN1_CONTEXT(1));
586 asn1_push_tag(data
, ASN1_SEQUENCE(0));
587 asn1_push_tag(data
, ASN1_CONTEXT(0));
588 asn1_write_enumerated(data
, negResult
);
592 asn1_push_tag(data
,ASN1_CONTEXT(1));
593 asn1_write_OID(data
, mechOID
);
597 if (reply
&& reply
->data
!= NULL
) {
598 asn1_push_tag(data
,ASN1_CONTEXT(2));
599 asn1_write_OctetString(data
, reply
->data
, reply
->length
);
606 ret
= data_blob(data
->data
, data
->length
);
612 parse a SPNEGO auth packet. This contains the encrypted passwords
614 bool spnego_parse_auth_response(DATA_BLOB blob
, NTSTATUS nt_status
,
621 if (NT_STATUS_IS_OK(nt_status
)) {
622 negResult
= SPNEGO_NEG_RESULT_ACCEPT
;
623 } else if (NT_STATUS_EQUAL(nt_status
, NT_STATUS_MORE_PROCESSING_REQUIRED
)) {
624 negResult
= SPNEGO_NEG_RESULT_INCOMPLETE
;
626 negResult
= SPNEGO_NEG_RESULT_REJECT
;
629 data
= asn1_init(talloc_tos());
634 asn1_load(data
, blob
);
635 asn1_start_tag(data
, ASN1_CONTEXT(1));
636 asn1_start_tag(data
, ASN1_SEQUENCE(0));
637 asn1_start_tag(data
, ASN1_CONTEXT(0));
638 asn1_check_enumerated(data
, negResult
);
641 *auth
= data_blob_null
;
643 if (asn1_tag_remaining(data
)) {
644 asn1_start_tag(data
,ASN1_CONTEXT(1));
645 asn1_check_OID(data
, mechOID
);
648 if (asn1_tag_remaining(data
)) {
649 asn1_start_tag(data
,ASN1_CONTEXT(2));
650 asn1_read_OctetString(data
, NULL
, auth
);
653 } else if (negResult
== SPNEGO_NEG_RESULT_INCOMPLETE
) {
657 /* Binding against Win2K DC returns a duplicate of the responseToken in
658 * the optional mechListMIC field. This is a bug in Win2K. We ignore
659 * this field if it exists. Win2K8 may return a proper mechListMIC at
660 * which point we need to implement the integrity checking. */
661 if (asn1_tag_remaining(data
)) {
662 DATA_BLOB mechList
= data_blob_null
;
663 asn1_start_tag(data
, ASN1_CONTEXT(3));
664 asn1_read_OctetString(data
, NULL
, &mechList
);
666 data_blob_free(&mechList
);
667 DEBUG(5,("spnego_parse_auth_response received mechListMIC, "
674 if (data
->has_error
) {
675 DEBUG(3,("spnego_parse_auth_response failed at %d\n", (int)data
->ofs
));
677 data_blob_free(auth
);