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; 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;
172 generate a negTokenTarg packet given a list of OIDs and a security blob
174 DATA_BLOB gen_negTokenTarg(const char *OIDs[], DATA_BLOB blob)
180 memset(&data, 0, sizeof(data));
182 asn1_push_tag(&data, ASN1_APPLICATION(0));
183 asn1_write_OID(&data,OID_SPNEGO);
184 asn1_push_tag(&data, ASN1_CONTEXT(0));
185 asn1_push_tag(&data, ASN1_SEQUENCE(0));
187 asn1_push_tag(&data, ASN1_CONTEXT(0));
188 asn1_push_tag(&data, ASN1_SEQUENCE(0));
189 for (i=0; OIDs[i]; i++) {
190 asn1_write_OID(&data,OIDs[i]);
195 asn1_push_tag(&data, ASN1_CONTEXT(2));
196 asn1_write_OctetString(&data,blob.data,blob.length);
204 if (data.has_error) {
205 DEBUG(1,("Failed to build negTokenTarg at offset %d\n", (int)data.ofs));
209 ret = data_blob(data.data, data.length);
217 parse a negTokenTarg packet giving a list of OIDs and a security blob
219 BOOL parse_negTokenTarg(DATA_BLOB blob, char *OIDs[ASN1_MAX_OIDS], DATA_BLOB *secblob)
224 asn1_load(&data, blob);
225 asn1_start_tag(&data, ASN1_APPLICATION(0));
226 asn1_check_OID(&data,OID_SPNEGO);
227 asn1_start_tag(&data, ASN1_CONTEXT(0));
228 asn1_start_tag(&data, ASN1_SEQUENCE(0));
230 asn1_start_tag(&data, ASN1_CONTEXT(0));
231 asn1_start_tag(&data, ASN1_SEQUENCE(0));
232 for (i=0; asn1_tag_remaining(&data) > 0 && i < ASN1_MAX_OIDS; i++) {
233 char *oid_str = NULL;
234 asn1_read_OID(&data,&oid_str);
241 asn1_start_tag(&data, ASN1_CONTEXT(2));
242 asn1_read_OctetString(&data,secblob);
250 if (data.has_error) {
251 DEBUG(1,("Failed to parse negTokenTarg at offset %d\n", (int)data.ofs));
261 generate a krb5 GSS-API wrapper packet given a ticket
263 DATA_BLOB spnego_gen_krb5_wrap(const DATA_BLOB ticket, const uint8 tok_id[2])
268 memset(&data, 0, sizeof(data));
270 asn1_push_tag(&data, ASN1_APPLICATION(0));
271 asn1_write_OID(&data, OID_KERBEROS5);
273 asn1_write(&data, tok_id, 2);
274 asn1_write(&data, ticket.data, ticket.length);
277 if (data.has_error) {
278 DEBUG(1,("Failed to build krb5 wrapper at offset %d\n", (int)data.ofs));
282 ret = data_blob(data.data, data.length);
289 parse a krb5 GSS-API wrapper packet giving a ticket
291 BOOL spnego_parse_krb5_wrap(DATA_BLOB blob, DATA_BLOB *ticket, uint8 tok_id[2])
297 asn1_load(&data, blob);
298 asn1_start_tag(&data, ASN1_APPLICATION(0));
299 asn1_check_OID(&data, OID_KERBEROS5);
301 data_remaining = asn1_tag_remaining(&data);
303 if (data_remaining < 3) {
304 data.has_error = True;
306 asn1_read(&data, tok_id, 2);
308 *ticket = data_blob(NULL, data_remaining);
309 asn1_read(&data, ticket->data, ticket->length);
314 ret = !data.has_error;
323 generate a SPNEGO negTokenTarg packet, ready for a EXTENDED_SECURITY
324 kerberos session setup
326 int spnego_gen_negTokenTarg(const char *principal, int time_offset,
328 DATA_BLOB *session_key_krb5, uint32 extra_ap_opts)
331 DATA_BLOB tkt, tkt_wrapped;
332 const char *krb_mechs[] = {OID_KERBEROS5_OLD, OID_NTLMSSP, NULL};
334 /* get a kerberos ticket for the service and extract the session key */
335 retval = cli_krb5_get_ticket(principal, time_offset,
336 &tkt, session_key_krb5, extra_ap_opts, NULL);
341 /* wrap that up in a nice GSS-API wrapping */
342 tkt_wrapped = spnego_gen_krb5_wrap(tkt, TOK_ID_KRB_AP_REQ);
344 /* and wrap that in a shiny SPNEGO wrapper */
345 *targ = gen_negTokenTarg(krb_mechs, tkt_wrapped);
347 data_blob_free(&tkt_wrapped);
348 data_blob_free(&tkt);
355 parse a spnego NTLMSSP challenge packet giving two security blobs
357 BOOL spnego_parse_challenge(const DATA_BLOB blob,
358 DATA_BLOB *chal1, DATA_BLOB *chal2)
366 asn1_load(&data, blob);
367 asn1_start_tag(&data,ASN1_CONTEXT(1));
368 asn1_start_tag(&data,ASN1_SEQUENCE(0));
370 asn1_start_tag(&data,ASN1_CONTEXT(0));
371 asn1_check_enumerated(&data,1);
374 asn1_start_tag(&data,ASN1_CONTEXT(1));
375 asn1_check_OID(&data, OID_NTLMSSP);
378 asn1_start_tag(&data,ASN1_CONTEXT(2));
379 asn1_read_OctetString(&data, chal1);
382 /* the second challenge is optional (XP doesn't send it) */
383 if (asn1_tag_remaining(&data)) {
384 asn1_start_tag(&data,ASN1_CONTEXT(3));
385 asn1_read_OctetString(&data, chal2);
392 ret = !data.has_error;
399 generate a SPNEGO auth packet. This will contain the encrypted passwords
401 DATA_BLOB spnego_gen_auth(DATA_BLOB blob)
406 memset(&data, 0, sizeof(data));
408 asn1_push_tag(&data, ASN1_CONTEXT(1));
409 asn1_push_tag(&data, ASN1_SEQUENCE(0));
410 asn1_push_tag(&data, ASN1_CONTEXT(2));
411 asn1_write_OctetString(&data,blob.data,blob.length);
416 ret = data_blob(data.data, data.length);
424 parse a SPNEGO auth packet. This contains the encrypted passwords
426 BOOL spnego_parse_auth(DATA_BLOB blob, DATA_BLOB *auth)
430 asn1_load(&data, blob);
431 asn1_start_tag(&data, ASN1_CONTEXT(1));
432 asn1_start_tag(&data, ASN1_SEQUENCE(0));
433 asn1_start_tag(&data, ASN1_CONTEXT(2));
434 asn1_read_OctetString(&data,auth);
439 if (data.has_error) {
440 DEBUG(3,("spnego_parse_auth failed at %d\n", (int)data.ofs));
450 generate a minimal SPNEGO response packet. Doesn't contain much.
452 DATA_BLOB spnego_gen_auth_response(DATA_BLOB *reply, NTSTATUS nt_status,
459 if (NT_STATUS_IS_OK(nt_status)) {
460 negResult = SPNEGO_NEG_RESULT_ACCEPT;
461 } else if (NT_STATUS_EQUAL(nt_status, NT_STATUS_MORE_PROCESSING_REQUIRED)) {
462 negResult = SPNEGO_NEG_RESULT_INCOMPLETE;
464 negResult = SPNEGO_NEG_RESULT_REJECT;
469 asn1_push_tag(&data, ASN1_CONTEXT(1));
470 asn1_push_tag(&data, ASN1_SEQUENCE(0));
471 asn1_push_tag(&data, ASN1_CONTEXT(0));
472 asn1_write_enumerated(&data, negResult);
475 if (reply->data != NULL) {
476 asn1_push_tag(&data,ASN1_CONTEXT(1));
477 asn1_write_OID(&data, mechOID);
480 asn1_push_tag(&data,ASN1_CONTEXT(2));
481 asn1_write_OctetString(&data, reply->data, reply->length);
488 ret = data_blob(data.data, data.length);
494 parse a SPNEGO NTLMSSP auth packet. This contains the encrypted passwords
496 BOOL spnego_parse_auth_response(DATA_BLOB blob, NTSTATUS nt_status,
502 if (NT_STATUS_IS_OK(nt_status)) {
503 negResult = SPNEGO_NEG_RESULT_ACCEPT;
504 } else if (NT_STATUS_EQUAL(nt_status, NT_STATUS_MORE_PROCESSING_REQUIRED)) {
505 negResult = SPNEGO_NEG_RESULT_INCOMPLETE;
507 negResult = SPNEGO_NEG_RESULT_REJECT;
510 asn1_load(&data, blob);
511 asn1_start_tag(&data, ASN1_CONTEXT(1));
512 asn1_start_tag(&data, ASN1_SEQUENCE(0));
513 asn1_start_tag(&data, ASN1_CONTEXT(0));
514 asn1_check_enumerated(&data, negResult);
517 if (negResult == SPNEGO_NEG_RESULT_INCOMPLETE) {
518 asn1_start_tag(&data,ASN1_CONTEXT(1));
519 asn1_check_OID(&data, OID_NTLMSSP);
522 asn1_start_tag(&data,ASN1_CONTEXT(2));
523 asn1_read_OctetString(&data, auth);
530 if (data.has_error) {
531 DEBUG(3,("spnego_parse_auth_response failed at %d\n", (int)data.ofs));
533 data_blob_free(auth);