2 Unix SMB/CIFS implementation.
3 simple kerberos5 routines for active directory
4 Copyright (C) Andrew Tridgell 2001
5 Copyright (C) Luke Howard 2002-2003
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.
26 #ifdef HAVE_KRB5_KEYBLOCK_KEYVALUE
27 #define KRB5_KEY_TYPE(k) ((k)->keytype)
28 #define KRB5_KEY_LENGTH(k) ((k)->keyvalue.length)
29 #define KRB5_KEY_DATA(k) ((k)->keyvalue.data)
31 #define KRB5_KEY_TYPE(k) ((k)->enctype)
32 #define KRB5_KEY_LENGTH(k) ((k)->length)
33 #define KRB5_KEY_DATA(k) ((k)->contents)
34 #endif /* HAVE_KRB5_KEYBLOCK_KEYVALUE */
36 #ifndef HAVE_KRB5_SET_REAL_TIME
38 * This function is not in the Heimdal mainline.
40 krb5_error_code
krb5_set_real_time(krb5_context context
, int32_t seconds
, int32_t microseconds
)
45 ret
= krb5_us_timeofday(context
, &sec
, &usec
);
49 context
->kdc_sec_offset
= seconds
- sec
;
50 context
->kdc_usec_offset
= microseconds
- usec
;
56 #if defined(HAVE_KRB5_SET_DEFAULT_IN_TKT_ETYPES) && !defined(HAVE_KRB5_SET_DEFAULT_TGS_KTYPES)
57 krb5_error_code
krb5_set_default_tgs_ktypes(krb5_context ctx
, const krb5_enctype
*enc
)
59 return krb5_set_default_in_tkt_etypes(ctx
, enc
);
63 #if defined(HAVE_ADDR_TYPE_IN_KRB5_ADDRESS)
65 void setup_kaddr( krb5_address
*pkaddr
, struct sockaddr
*paddr
)
67 pkaddr
->addr_type
= KRB5_ADDRESS_INET
;
68 pkaddr
->address
.length
= sizeof(((struct sockaddr_in
*)paddr
)->sin_addr
);
69 pkaddr
->address
.data
= (char *)&(((struct sockaddr_in
*)paddr
)->sin_addr
);
71 #elif defined(HAVE_ADDRTYPE_IN_KRB5_ADDRESS)
73 void setup_kaddr( krb5_address
*pkaddr
, struct sockaddr
*paddr
)
75 pkaddr
->addrtype
= ADDRTYPE_INET
;
76 pkaddr
->length
= sizeof(((struct sockaddr_in
*)paddr
)->sin_addr
);
77 pkaddr
->contents
= (krb5_octet
*)&(((struct sockaddr_in
*)paddr
)->sin_addr
);
80 #error UNKNOWN_ADDRTYPE
83 #if defined(HAVE_KRB5_PRINCIPAL2SALT) && defined(HAVE_KRB5_USE_ENCTYPE) && defined(HAVE_KRB5_STRING_TO_KEY) && defined(HAVE_KRB5_ENCRYPT_BLOCK)
84 int create_kerberos_key_from_string_direct(krb5_context context
,
85 krb5_principal host_princ
,
92 krb5_encrypt_block eblock
;
94 ret
= krb5_principal2salt(context
, host_princ
, &salt
);
96 DEBUG(1,("krb5_principal2salt failed (%s)\n", error_message(ret
)));
99 krb5_use_enctype(context
, &eblock
, enctype
);
100 ret
= krb5_string_to_key(context
, &eblock
, key
, password
, &salt
);
101 SAFE_FREE(salt
.data
);
104 #elif defined(HAVE_KRB5_GET_PW_SALT) && defined(HAVE_KRB5_STRING_TO_KEY_SALT)
105 int create_kerberos_key_from_string_direct(krb5_context context
,
106 krb5_principal host_princ
,
109 krb5_enctype enctype
)
114 ret
= krb5_get_pw_salt(context
, host_princ
, &salt
);
116 DEBUG(1,("krb5_get_pw_salt failed (%s)\n", error_message(ret
)));
119 return krb5_string_to_key_salt(context
, enctype
, password
->data
,
123 #error UNKNOWN_CREATE_KEY_FUNCTIONS
126 int create_kerberos_key_from_string(krb5_context context
,
127 krb5_principal host_princ
,
130 krb5_enctype enctype
)
132 krb5_principal salt_princ
= NULL
;
135 * Check if we've determined that the KDC is salting keys for this
136 * principal/enctype in a non-obvious way. If it is, try to match
139 salt_princ
= kerberos_fetch_salt_princ_for_host_princ(context
, host_princ
, enctype
);
140 ret
= create_kerberos_key_from_string_direct(context
, salt_princ
? salt_princ
: host_princ
, password
, key
, enctype
);
142 krb5_free_principal(context
, salt_princ
);
147 #if defined(HAVE_KRB5_GET_PERMITTED_ENCTYPES)
148 krb5_error_code
get_kerberos_allowed_etypes(krb5_context context
,
149 krb5_enctype
**enctypes
)
151 return krb5_get_permitted_enctypes(context
, enctypes
);
153 #elif defined(HAVE_KRB5_GET_DEFAULT_IN_TKT_ETYPES)
154 krb5_error_code
get_kerberos_allowed_etypes(krb5_context context
,
155 krb5_enctype
**enctypes
)
157 return krb5_get_default_in_tkt_etypes(context
, enctypes
);
160 #error UNKNOWN_GET_ENCTYPES_FUNCTIONS
163 void free_kerberos_etypes(krb5_context context
,
164 krb5_enctype
*enctypes
)
166 #if defined(HAVE_KRB5_FREE_KTYPES)
167 krb5_free_ktypes(context
, enctypes
);
175 #if defined(HAVE_KRB5_AUTH_CON_SETKEY) && !defined(HAVE_KRB5_AUTH_CON_SETUSERUSERKEY)
176 krb5_error_code
krb5_auth_con_setuseruserkey(krb5_context context
,
177 krb5_auth_context auth_context
,
178 krb5_keyblock
*keyblock
)
180 return krb5_auth_con_setkey(context
, auth_context
, keyblock
);
184 void get_auth_data_from_tkt(DATA_BLOB
*auth_data
, krb5_ticket
*tkt
)
186 #if defined(HAVE_KRB5_TKT_ENC_PART2)
187 if (tkt
->enc_part2
&& tkt
->enc_part2
->authorization_data
&& tkt
->enc_part2
->authorization_data
[0] && tkt
->enc_part2
->authorization_data
[0]->length
)
188 *auth_data
= data_blob(tkt
->enc_part2
->authorization_data
[0]->contents
,
189 tkt
->enc_part2
->authorization_data
[0]->length
);
191 if (tkt
->ticket
.authorization_data
&& tkt
->ticket
.authorization_data
->len
)
192 *auth_data
= data_blob(tkt
->ticket
.authorization_data
->val
->ad_data
.data
,
193 tkt
->ticket
.authorization_data
->val
->ad_data
.length
);
197 krb5_const_principal
get_principal_from_tkt(krb5_ticket
*tkt
)
199 #if defined(HAVE_KRB5_TKT_ENC_PART2)
200 return tkt
->enc_part2
->client
;
206 #if !defined(HAVE_KRB5_LOCATE_KDC)
207 krb5_error_code
krb5_locate_kdc(krb5_context ctx
, const krb5_data
*realm
, struct sockaddr
**addr_pp
, int *naddrs
, int get_masters
)
209 krb5_krbhst_handle hnd
;
210 krb5_krbhst_info
*hinfo
;
219 rc
= krb5_krbhst_init(ctx
, realm
->data
, KRB5_KRBHST_KDC
, &hnd
);
221 DEBUG(0, ("krb5_locate_kdc: krb5_krbhst_init failed (%s)\n", error_message(rc
)));
225 for ( num_kdcs
= 0; (rc
= krb5_krbhst_next(ctx
, hnd
, &hinfo
) == 0); num_kdcs
++)
228 krb5_krbhst_reset(ctx
, hnd
);
231 DEBUG(0, ("krb5_locate_kdc: zero kdcs found !\n"));
232 krb5_krbhst_free(ctx
, hnd
);
236 sa
= SMB_MALLOC_ARRAY( struct sockaddr
, num_kdcs
);
238 DEBUG(0, ("krb5_locate_kdc: malloc failed\n"));
239 krb5_krbhst_free(ctx
, hnd
);
244 memset(sa
, '\0', sizeof(struct sockaddr
) * num_kdcs
);
246 for (i
= 0; i
< num_kdcs
&& (rc
= krb5_krbhst_next(ctx
, hnd
, &hinfo
) == 0); i
++) {
248 #if defined(HAVE_KRB5_KRBHST_GET_ADDRINFO)
249 rc
= krb5_krbhst_get_addrinfo(ctx
, hinfo
, &ai
);
251 DEBUG(0,("krb5_krbhst_get_addrinfo failed: %s\n", error_message(rc
)));
255 if (hinfo
->ai
&& hinfo
->ai
->ai_family
== AF_INET
)
256 memcpy(&sa
[i
], hinfo
->ai
->ai_addr
, sizeof(struct sockaddr
));
259 krb5_krbhst_free(ctx
, hnd
);
267 #if !defined(HAVE_KRB5_FREE_UNPARSED_NAME)
268 void krb5_free_unparsed_name(krb5_context context
, char *val
)
274 void kerberos_free_data_contents(krb5_context context
, krb5_data
*pdata
)
276 #if defined(HAVE_KRB5_FREE_DATA_CONTENTS)
278 krb5_free_data_contents(context
, pdata
);
281 SAFE_FREE(pdata
->data
);
285 void kerberos_set_creds_enctype(krb5_creds
*pcreds
, int enctype
)
287 #if defined(HAVE_KRB5_KEYBLOCK_IN_CREDS)
288 KRB5_KEY_TYPE((&pcreds
->keyblock
)) = enctype
;
289 #elif defined(HAVE_KRB5_SESSION_IN_CREDS)
290 KRB5_KEY_TYPE((&pcreds
->session
)) = enctype
;
292 #error UNKNOWN_KEYBLOCK_MEMBER_IN_KRB5_CREDS_STRUCT
296 BOOL
kerberos_compatible_enctypes(krb5_context context
,
297 krb5_enctype enctype1
,
298 krb5_enctype enctype2
)
300 #if defined(HAVE_KRB5_C_ENCTYPE_COMPARE)
301 krb5_boolean similar
= 0;
303 krb5_c_enctype_compare(context
, enctype1
, enctype2
, &similar
);
304 return similar
? True
: False
;
305 #elif defined(HAVE_KRB5_ENCTYPES_COMPATIBLE_KEYS)
306 return krb5_enctypes_compatible_keys(context
, enctype1
, enctype2
) ? True
: False
;
310 static BOOL
ads_cleanup_expired_creds(krb5_context context
,
314 krb5_error_code retval
;
316 DEBUG(3, ("Ticket in ccache[%s] expiration %s\n",
317 krb5_cc_default_name(context
),
318 http_timestring(credsp
->times
.endtime
)));
320 /* we will probably need new tickets if the current ones
321 will expire within 10 seconds.
323 if (credsp
->times
.endtime
>= (time(NULL
) + 10))
326 /* heimdal won't remove creds from a file ccache, and
327 perhaps we shouldn't anyway, since internally we
328 use memory ccaches, and a FILE one probably means that
329 we're using creds obtained outside of our exectuable
331 if (StrCaseCmp(krb5_cc_get_type(context
, ccache
), "FILE") == 0) {
332 DEBUG(5, ("ads_cleanup_expired_creds: We do not remove creds from a FILE ccache\n"));
336 retval
= krb5_cc_remove_cred(context
, ccache
, 0, credsp
);
338 DEBUG(1, ("ads_cleanup_expired_creds: krb5_cc_remove_cred failed, err %s\n",
339 error_message(retval
)));
340 /* If we have an error in this, we want to display it,
341 but continue as though we deleted it */
347 we can't use krb5_mk_req because w2k wants the service to be in a particular format
349 static krb5_error_code
ads_krb5_mk_req(krb5_context context
,
350 krb5_auth_context
*auth_context
,
351 const krb5_flags ap_req_options
,
352 const char *principal
,
356 krb5_error_code retval
;
357 krb5_principal server
;
361 BOOL creds_ready
= False
;
363 retval
= krb5_parse_name(context
, principal
, &server
);
365 DEBUG(1,("ads_krb5_mk_req: Failed to parse principal %s\n", principal
));
369 /* obtain ticket & session key */
371 if ((retval
= krb5_copy_principal(context
, server
, &creds
.server
))) {
372 DEBUG(1,("krb5_copy_principal failed (%s)\n",
373 error_message(retval
)));
377 if ((retval
= krb5_cc_get_principal(context
, ccache
, &creds
.client
))) {
378 /* This can commonly fail on smbd startup with no ticket in the cache.
379 * Report at higher level than 1. */
380 DEBUG(3,("ads_krb5_mk_req: krb5_cc_get_principal failed (%s)\n",
381 error_message(retval
)));
385 while(!creds_ready
) {
386 if ((retval
= krb5_get_credentials(context
, 0, ccache
,
388 DEBUG(1,("ads_krb5_mk_req: krb5_get_credentials failed for %s (%s)\n",
389 principal
, error_message(retval
)));
393 /* cope with ticket being in the future due to clock skew */
394 if ((unsigned)credsp
->times
.starttime
> time(NULL
)) {
395 time_t t
= time(NULL
);
396 int time_offset
=(unsigned)credsp
->times
.starttime
-t
;
397 DEBUG(4,("ads_krb5_mk_req: Advancing clock by %d seconds to cope with clock skew\n", time_offset
));
398 krb5_set_real_time(context
, t
+ time_offset
+ 1, 0);
401 if (!ads_cleanup_expired_creds(context
, ccache
, credsp
))
405 DEBUG(10,("ads_krb5_mk_req: Ticket (%s) in ccache (%s) is valid until: (%s - %d)\n",
406 principal
, krb5_cc_default_name(context
),
407 http_timestring((unsigned)credsp
->times
.endtime
),
408 (unsigned)credsp
->times
.endtime
));
411 retval
= krb5_mk_req_extended(context
, auth_context
, ap_req_options
,
412 &in_data
, credsp
, outbuf
);
414 DEBUG(1,("ads_krb5_mk_req: krb5_mk_req_extended failed (%s)\n",
415 error_message(retval
)));
418 krb5_free_creds(context
, credsp
);
421 krb5_free_cred_contents(context
, &creds
);
424 krb5_free_principal(context
, server
);
430 get a kerberos5 ticket for the given service
432 int cli_krb5_get_ticket(const char *principal
, time_t time_offset
,
433 DATA_BLOB
*ticket
, DATA_BLOB
*session_key_krb5
)
435 krb5_error_code retval
;
437 krb5_context context
= NULL
;
438 krb5_ccache ccdef
= NULL
;
439 krb5_auth_context auth_context
= NULL
;
440 krb5_enctype enc_types
[] = {
441 #ifdef ENCTYPE_ARCFOUR_HMAC
442 ENCTYPE_ARCFOUR_HMAC
,
448 retval
= krb5_init_context(&context
);
450 DEBUG(1,("cli_krb5_get_ticket: krb5_init_context failed (%s)\n",
451 error_message(retval
)));
455 if (time_offset
!= 0) {
456 krb5_set_real_time(context
, time(NULL
) + time_offset
, 0);
459 if ((retval
= krb5_cc_default(context
, &ccdef
))) {
460 DEBUG(1,("cli_krb5_get_ticket: krb5_cc_default failed (%s)\n",
461 error_message(retval
)));
465 if ((retval
= krb5_set_default_tgs_ktypes(context
, enc_types
))) {
466 DEBUG(1,("cli_krb5_get_ticket: krb5_set_default_tgs_ktypes failed (%s)\n",
467 error_message(retval
)));
471 if ((retval
= ads_krb5_mk_req(context
,
479 get_krb5_smb_session_key(context
, auth_context
, session_key_krb5
, False
);
481 *ticket
= data_blob(packet
.data
, packet
.length
);
483 kerberos_free_data_contents(context
, &packet
);
489 krb5_cc_close(context
, ccdef
);
491 krb5_auth_con_free(context
, auth_context
);
492 krb5_free_context(context
);
498 BOOL
get_krb5_smb_session_key(krb5_context context
, krb5_auth_context auth_context
, DATA_BLOB
*session_key
, BOOL remote
)
505 err
= krb5_auth_con_getremotesubkey(context
, auth_context
, &skey
);
507 err
= krb5_auth_con_getlocalsubkey(context
, auth_context
, &skey
);
508 if (err
== 0 && skey
!= NULL
) {
509 DEBUG(10, ("Got KRB5 session key of length %d\n", KRB5_KEY_LENGTH(skey
)));
510 *session_key
= data_blob(KRB5_KEY_DATA(skey
), KRB5_KEY_LENGTH(skey
));
511 dump_data_pw("KRB5 Session Key:\n", session_key
->data
, session_key
->length
);
515 krb5_free_keyblock(context
, skey
);
517 DEBUG(10, ("KRB5 error getting session key %d\n", err
));
524 #if defined(HAVE_KRB5_PRINCIPAL_GET_COMP_STRING) && !defined(HAVE_KRB5_PRINC_COMPONENT)
525 const krb5_data
*krb5_princ_component(krb5_context context
, krb5_principal principal
, int i
)
527 static krb5_data kdata
;
529 kdata
.data
= krb5_principal_get_comp_string(context
, principal
, i
);
530 kdata
.length
= strlen(kdata
.data
);
535 krb5_error_code
smb_krb5_kt_free_entry(krb5_context context
, krb5_keytab_entry
*kt_entry
)
537 #if defined(HAVE_KRB5_KT_FREE_ENTRY)
538 return krb5_kt_free_entry(context
, kt_entry
);
539 #elif defined(HAVE_KRB5_FREE_KEYTAB_ENTRY_CONTENTS)
540 return krb5_free_keytab_entry_contents(context
, kt_entry
);
542 #error UNKNOWN_KT_FREE_FUNCTION
546 #else /* HAVE_KRB5 */
547 /* this saves a few linking headaches */
548 int cli_krb5_get_ticket(const char *principal
, time_t time_offset
,
549 DATA_BLOB
*ticket
, DATA_BLOB
*session_key_krb5
)
551 DEBUG(0,("NO KERBEROS SUPPORT\n"));