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 2 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, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
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 memset(&data
, 0, sizeof(data
));
39 asn1_write(&data
, guid
, 16);
40 asn1_push_tag(&data
,ASN1_APPLICATION(0));
41 asn1_write_OID(&data
,OID_SPNEGO
);
42 asn1_push_tag(&data
,ASN1_CONTEXT(0));
43 asn1_push_tag(&data
,ASN1_SEQUENCE(0));
45 asn1_push_tag(&data
,ASN1_CONTEXT(0));
46 asn1_push_tag(&data
,ASN1_SEQUENCE(0));
47 for (i
=0; OIDs
[i
]; i
++) {
48 asn1_write_OID(&data
,OIDs
[i
]);
53 asn1_push_tag(&data
, ASN1_CONTEXT(3));
54 asn1_push_tag(&data
, ASN1_SEQUENCE(0));
55 asn1_push_tag(&data
, ASN1_CONTEXT(0));
56 asn1_write_GeneralString(&data
,principal
);
67 DEBUG(1,("Failed to build negTokenInit at offset %d\n", (int)data
.ofs
));
71 ret
= data_blob(data
.data
, data
.length
);
78 Generate a negTokenInit as used by the client side ... It has a mechType
79 (OID), and a mechToken (a security blob) ...
81 Really, we need to break out the NTLMSSP stuff as well, because it could be
84 DATA_BLOB
gen_negTokenInit(const char *OID
, DATA_BLOB blob
)
89 memset(&data
, 0, sizeof(data
));
91 asn1_push_tag(&data
, ASN1_APPLICATION(0));
92 asn1_write_OID(&data
,OID_SPNEGO
);
93 asn1_push_tag(&data
, ASN1_CONTEXT(0));
94 asn1_push_tag(&data
, ASN1_SEQUENCE(0));
96 asn1_push_tag(&data
, ASN1_CONTEXT(0));
97 asn1_push_tag(&data
, ASN1_SEQUENCE(0));
98 asn1_write_OID(&data
, OID
);
102 asn1_push_tag(&data
, ASN1_CONTEXT(2));
103 asn1_write_OctetString(&data
,blob
.data
,blob
.length
);
111 if (data
.has_error
) {
112 DEBUG(1,("Failed to build negTokenInit at offset %d\n", (int)data
.ofs
));
116 ret
= data_blob(data
.data
, data
.length
);
123 parse a negTokenInit packet giving a GUID, a list of supported
124 OIDs (the mechanisms) and a principal name string
126 BOOL
spnego_parse_negTokenInit(DATA_BLOB blob
,
127 char *OIDs
[ASN1_MAX_OIDS
],
134 asn1_load(&data
, blob
);
136 asn1_start_tag(&data
,ASN1_APPLICATION(0));
137 asn1_check_OID(&data
,OID_SPNEGO
);
138 asn1_start_tag(&data
,ASN1_CONTEXT(0));
139 asn1_start_tag(&data
,ASN1_SEQUENCE(0));
141 asn1_start_tag(&data
,ASN1_CONTEXT(0));
142 asn1_start_tag(&data
,ASN1_SEQUENCE(0));
143 for (i
=0; asn1_tag_remaining(&data
) > 0 && i
< ASN1_MAX_OIDS
-1; i
++) {
144 char *oid_str
= NULL
;
145 asn1_read_OID(&data
,&oid_str
);
152 asn1_start_tag(&data
, ASN1_CONTEXT(3));
153 asn1_start_tag(&data
, ASN1_SEQUENCE(0));
154 asn1_start_tag(&data
, ASN1_CONTEXT(0));
155 asn1_read_GeneralString(&data
,principal
);
165 ret
= !data
.has_error
;
166 if (data
.has_error
) {
168 SAFE_FREE(principal
);
169 for(j
= 0; j
< i
&& j
< ASN1_MAX_OIDS
-1; j
++) {
179 generate a negTokenTarg packet given a list of OIDs and a security blob
181 DATA_BLOB
gen_negTokenTarg(const char *OIDs
[], DATA_BLOB blob
)
187 memset(&data
, 0, sizeof(data
));
189 asn1_push_tag(&data
, ASN1_APPLICATION(0));
190 asn1_write_OID(&data
,OID_SPNEGO
);
191 asn1_push_tag(&data
, ASN1_CONTEXT(0));
192 asn1_push_tag(&data
, ASN1_SEQUENCE(0));
194 asn1_push_tag(&data
, ASN1_CONTEXT(0));
195 asn1_push_tag(&data
, ASN1_SEQUENCE(0));
196 for (i
=0; OIDs
[i
]; i
++) {
197 asn1_write_OID(&data
,OIDs
[i
]);
202 asn1_push_tag(&data
, ASN1_CONTEXT(2));
203 asn1_write_OctetString(&data
,blob
.data
,blob
.length
);
211 if (data
.has_error
) {
212 DEBUG(1,("Failed to build negTokenTarg at offset %d\n", (int)data
.ofs
));
216 ret
= data_blob(data
.data
, data
.length
);
223 parse a negTokenTarg packet giving a list of OIDs and a security blob
225 BOOL
parse_negTokenTarg(DATA_BLOB blob
, char *OIDs
[ASN1_MAX_OIDS
], DATA_BLOB
*secblob
)
230 asn1_load(&data
, blob
);
231 asn1_start_tag(&data
, ASN1_APPLICATION(0));
232 asn1_check_OID(&data
,OID_SPNEGO
);
233 asn1_start_tag(&data
, ASN1_CONTEXT(0));
234 asn1_start_tag(&data
, ASN1_SEQUENCE(0));
236 asn1_start_tag(&data
, ASN1_CONTEXT(0));
237 asn1_start_tag(&data
, ASN1_SEQUENCE(0));
238 for (i
=0; asn1_tag_remaining(&data
) > 0 && i
< ASN1_MAX_OIDS
-1; i
++) {
239 char *oid_str
= NULL
;
240 asn1_read_OID(&data
,&oid_str
);
247 asn1_start_tag(&data
, ASN1_CONTEXT(2));
248 asn1_read_OctetString(&data
,secblob
);
256 if (data
.has_error
) {
258 data_blob_free(secblob
);
259 for(j
= 0; j
< i
&& j
< ASN1_MAX_OIDS
-1; j
++) {
262 DEBUG(1,("Failed to parse negTokenTarg at offset %d\n", (int)data
.ofs
));
272 generate a krb5 GSS-API wrapper packet given a ticket
274 DATA_BLOB
spnego_gen_krb5_wrap(const DATA_BLOB ticket
, const uint8 tok_id
[2])
279 memset(&data
, 0, sizeof(data
));
281 asn1_push_tag(&data
, ASN1_APPLICATION(0));
282 asn1_write_OID(&data
, OID_KERBEROS5
);
284 asn1_write(&data
, tok_id
, 2);
285 asn1_write(&data
, ticket
.data
, ticket
.length
);
288 if (data
.has_error
) {
289 DEBUG(1,("Failed to build krb5 wrapper at offset %d\n", (int)data
.ofs
));
293 ret
= data_blob(data
.data
, data
.length
);
300 parse a krb5 GSS-API wrapper packet giving a ticket
302 BOOL
spnego_parse_krb5_wrap(DATA_BLOB blob
, DATA_BLOB
*ticket
, uint8 tok_id
[2])
308 asn1_load(&data
, blob
);
309 asn1_start_tag(&data
, ASN1_APPLICATION(0));
310 asn1_check_OID(&data
, OID_KERBEROS5
);
312 data_remaining
= asn1_tag_remaining(&data
);
314 if (data_remaining
< 3) {
315 data
.has_error
= True
;
317 asn1_read(&data
, tok_id
, 2);
319 *ticket
= data_blob(NULL
, data_remaining
);
320 asn1_read(&data
, ticket
->data
, ticket
->length
);
325 ret
= !data
.has_error
;
327 if (data
.has_error
) {
328 data_blob_free(ticket
);
338 generate a SPNEGO negTokenTarg packet, ready for a EXTENDED_SECURITY
339 kerberos session setup
341 int spnego_gen_negTokenTarg(const char *principal
, int time_offset
,
343 DATA_BLOB
*session_key_krb5
, uint32 extra_ap_opts
)
346 DATA_BLOB tkt
, tkt_wrapped
;
347 const char *krb_mechs
[] = {OID_KERBEROS5_OLD
, OID_NTLMSSP
, NULL
};
349 /* get a kerberos ticket for the service and extract the session key */
350 retval
= cli_krb5_get_ticket(principal
, time_offset
,
351 &tkt
, session_key_krb5
, extra_ap_opts
, NULL
);
356 /* wrap that up in a nice GSS-API wrapping */
357 tkt_wrapped
= spnego_gen_krb5_wrap(tkt
, TOK_ID_KRB_AP_REQ
);
359 /* and wrap that in a shiny SPNEGO wrapper */
360 *targ
= gen_negTokenTarg(krb_mechs
, tkt_wrapped
);
362 data_blob_free(&tkt_wrapped
);
363 data_blob_free(&tkt
);
370 parse a spnego NTLMSSP challenge packet giving two security blobs
372 BOOL
spnego_parse_challenge(const DATA_BLOB blob
,
373 DATA_BLOB
*chal1
, DATA_BLOB
*chal2
)
381 asn1_load(&data
, blob
);
382 asn1_start_tag(&data
,ASN1_CONTEXT(1));
383 asn1_start_tag(&data
,ASN1_SEQUENCE(0));
385 asn1_start_tag(&data
,ASN1_CONTEXT(0));
386 asn1_check_enumerated(&data
,1);
389 asn1_start_tag(&data
,ASN1_CONTEXT(1));
390 asn1_check_OID(&data
, OID_NTLMSSP
);
393 asn1_start_tag(&data
,ASN1_CONTEXT(2));
394 asn1_read_OctetString(&data
, chal1
);
397 /* the second challenge is optional (XP doesn't send it) */
398 if (asn1_tag_remaining(&data
)) {
399 asn1_start_tag(&data
,ASN1_CONTEXT(3));
400 asn1_read_OctetString(&data
, chal2
);
407 ret
= !data
.has_error
;
409 if (data
.has_error
) {
410 data_blob_free(chal1
);
411 data_blob_free(chal2
);
420 generate a SPNEGO auth packet. This will contain the encrypted passwords
422 DATA_BLOB
spnego_gen_auth(DATA_BLOB blob
)
427 memset(&data
, 0, sizeof(data
));
429 asn1_push_tag(&data
, ASN1_CONTEXT(1));
430 asn1_push_tag(&data
, ASN1_SEQUENCE(0));
431 asn1_push_tag(&data
, ASN1_CONTEXT(2));
432 asn1_write_OctetString(&data
,blob
.data
,blob
.length
);
437 ret
= data_blob(data
.data
, data
.length
);
445 parse a SPNEGO auth packet. This contains the encrypted passwords
447 BOOL
spnego_parse_auth(DATA_BLOB blob
, DATA_BLOB
*auth
)
451 asn1_load(&data
, blob
);
452 asn1_start_tag(&data
, ASN1_CONTEXT(1));
453 asn1_start_tag(&data
, ASN1_SEQUENCE(0));
454 asn1_start_tag(&data
, ASN1_CONTEXT(2));
455 asn1_read_OctetString(&data
,auth
);
460 if (data
.has_error
) {
461 DEBUG(3,("spnego_parse_auth failed at %d\n", (int)data
.ofs
));
462 data_blob_free(auth
);
472 generate a minimal SPNEGO response packet. Doesn't contain much.
474 DATA_BLOB
spnego_gen_auth_response(DATA_BLOB
*reply
, NTSTATUS nt_status
,
481 if (NT_STATUS_IS_OK(nt_status
)) {
482 negResult
= SPNEGO_NEG_RESULT_ACCEPT
;
483 } else if (NT_STATUS_EQUAL(nt_status
, NT_STATUS_MORE_PROCESSING_REQUIRED
)) {
484 negResult
= SPNEGO_NEG_RESULT_INCOMPLETE
;
486 negResult
= SPNEGO_NEG_RESULT_REJECT
;
491 asn1_push_tag(&data
, ASN1_CONTEXT(1));
492 asn1_push_tag(&data
, ASN1_SEQUENCE(0));
493 asn1_push_tag(&data
, ASN1_CONTEXT(0));
494 asn1_write_enumerated(&data
, negResult
);
497 if (reply
->data
!= NULL
) {
498 asn1_push_tag(&data
,ASN1_CONTEXT(1));
499 asn1_write_OID(&data
, mechOID
);
502 asn1_push_tag(&data
,ASN1_CONTEXT(2));
503 asn1_write_OctetString(&data
, reply
->data
, reply
->length
);
510 ret
= data_blob(data
.data
, data
.length
);
516 parse a SPNEGO NTLMSSP auth packet. This contains the encrypted passwords
518 BOOL
spnego_parse_auth_response(DATA_BLOB blob
, NTSTATUS nt_status
,
524 if (NT_STATUS_IS_OK(nt_status
)) {
525 negResult
= SPNEGO_NEG_RESULT_ACCEPT
;
526 } else if (NT_STATUS_EQUAL(nt_status
, NT_STATUS_MORE_PROCESSING_REQUIRED
)) {
527 negResult
= SPNEGO_NEG_RESULT_INCOMPLETE
;
529 negResult
= SPNEGO_NEG_RESULT_REJECT
;
532 asn1_load(&data
, blob
);
533 asn1_start_tag(&data
, ASN1_CONTEXT(1));
534 asn1_start_tag(&data
, ASN1_SEQUENCE(0));
535 asn1_start_tag(&data
, ASN1_CONTEXT(0));
536 asn1_check_enumerated(&data
, negResult
);
539 if (negResult
== SPNEGO_NEG_RESULT_INCOMPLETE
) {
540 asn1_start_tag(&data
,ASN1_CONTEXT(1));
541 asn1_check_OID(&data
, OID_NTLMSSP
);
544 asn1_start_tag(&data
,ASN1_CONTEXT(2));
545 asn1_read_OctetString(&data
, auth
);
552 if (data
.has_error
) {
553 DEBUG(3,("spnego_parse_auth_response failed at %d\n", (int)data
.ofs
));
555 data_blob_free(auth
);