2 Unix SMB/CIFS implementation.
3 kerberos keytab utility library
4 Copyright (C) Andrew Tridgell 2001
5 Copyright (C) Remus Koos 2001
6 Copyright (C) Luke Howard 2003
7 Copyright (C) Jim McDonough (jmcd@us.ibm.com) 2003
8 Copyright (C) Guenther Deschner 2003
9 Copyright (C) Rakesh Patel 2004
10 Copyright (C) Dan Perry 2004
11 Copyright (C) Jeremy Allison 2004
13 This program is free software; you can redistribute it and/or modify
14 it under the terms of the GNU General Public License as published by
15 the Free Software Foundation; either version 2 of the License, or
16 (at your option) any later version.
18 This program is distributed in the hope that it will be useful,
19 but WITHOUT ANY WARRANTY; without even the implied warranty of
20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 GNU General Public License for more details.
23 You should have received a copy of the GNU General Public License
24 along with this program; if not, write to the Free Software
25 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
32 /**********************************************************************
33 Adds a single service principal, i.e. 'host' to the system keytab
34 ***********************************************************************/
36 int ads_keytab_add_entry(ADS_STRUCT *ads, const char *srvPrinc)
38 krb5_error_code ret = 0;
39 krb5_context context = NULL;
40 krb5_keytab keytab = NULL;
41 krb5_kt_cursor cursor = NULL;
42 krb5_keytab_entry kt_entry;
43 krb5_principal princ = NULL;
45 krb5_enctype *enctypes = NULL;
48 char *principal = NULL;
50 char *password_s = NULL;
51 char keytab_name[MAX_KEYTAB_NAME_LEN]; /* This MAX_NAME_LEN is a constant defined in krb5.h */
56 ZERO_STRUCT(kt_entry);
57 initialize_krb5_error_table();
58 ret = krb5_init_context(&context);
60 DEBUG(1,("ads_keytab_add_entry: could not krb5_init_context: %s\n",error_message(ret)));
63 #ifdef HAVE_WRFILE_KEYTAB /* MIT */
66 ret = krb5_kt_default_name(context, (char *) &keytab_name[2], MAX_KEYTAB_NAME_LEN - 4);
68 ret = krb5_kt_default_name(context, (char *) &keytab_name[0], MAX_KEYTAB_NAME_LEN - 2);
71 DEBUG(1,("ads_keytab_add_entry: krb5_kt_default_name failed (%s)\n", error_message(ret)));
74 DEBUG(2,("ads_keytab_add_entry: Using default system keytab: %s\n", (char *) &keytab_name));
75 ret = krb5_kt_resolve(context, (char *) &keytab_name, &keytab);
77 DEBUG(1,("ads_keytab_add_entry: krb5_kt_resolve failed (%s)\n", error_message(ret)));
81 /* retrieve the password */
82 if (!secrets_init()) {
83 DEBUG(1,("ads_keytab_add_entry: secrets_init failed\n"));
87 password_s = secrets_fetch_machine_password(lp_workgroup(), NULL, NULL);
89 DEBUG(1,("ads_keytab_add_entry: failed to fetch machine password\n"));
93 password.data = password_s;
94 password.length = strlen(password_s);
96 /* Construct our principal */
97 name_to_fqdn(my_fqdn, global_myname());
99 asprintf(&princ_s, "%s/%s@%s", srvPrinc, my_fqdn, lp_realm());
101 ret = krb5_parse_name(context, princ_s, &princ);
103 DEBUG(1,("ads_keytab_add_entry: krb5_parse_name(%s) failed (%s)\n", princ_s, error_message(ret)));
107 kvno = (krb5_kvno) ads_get_kvno(ads, global_myname());
108 if (kvno == -1) { /* -1 indicates failure, everything else is OK */
109 DEBUG(1,("ads_keytab_add_entry: ads_get_kvno failed to determine the system's kvno.\n"));
114 /* Seek and delete old keytab entries */
115 ret = krb5_kt_start_seq_get(context, keytab, &cursor);
116 if (ret != KRB5_KT_END && ret != ENOENT ) {
117 DEBUG(3,("ads_keytab_add_entry: Will try to delete old keytab entries\n"));
118 while(!krb5_kt_next_entry(context, keytab, &kt_entry, &cursor)) {
119 BOOL compare_ok = False;
121 ret = krb5_unparse_name(context, kt_entry.principal, &ktprinc);
123 DEBUG(1,("ads_keytab_add_entry: krb5_unparse_name failed (%s)\n", error_message(ret)));
127 /*---------------------------------------------------------------------------
128 * Save the entries with kvno - 1. This is what microsoft does
129 * to allow people with existing sessions that have kvno - 1 to still
130 * work. Otherwise, when the password for the machine changes, all
131 * kerberizied sessions will 'break' until either the client reboots or
132 * the client's session key expires and they get a new session ticket
136 #ifdef HAVE_KRB5_KT_COMPARE
137 compare_ok = ((krb5_kt_compare(context, &kt_entry, princ, 0, 0) == True) && (kt_entry.vno != kvno - 1));
139 compare_ok = ((strcmp(ktprinc, princ_s) == 0) && (kt_entry.vno != kvno - 1));
141 krb5_free_unparsed_name(context, ktprinc);
145 DEBUG(3,("ads_keytab_add_entry: Found old entry for principal: %s (kvno %d) - trying to remove it.\n",
146 princ_s, kt_entry.vno));
147 ret = krb5_kt_end_seq_get(context, keytab, &cursor);
150 DEBUG(1,("ads_keytab_add_entry: krb5_kt_end_seq_get() failed (%s)\n",
151 error_message(ret)));
154 ret = krb5_kt_remove_entry(context, keytab, &kt_entry);
156 DEBUG(1,("ads_keytab_add_entry: krb5_kt_remove_entry failed (%s)\n",
157 error_message(ret)));
160 ret = krb5_kt_start_seq_get(context, keytab, &cursor);
162 DEBUG(1,("ads_keytab_add_entry: krb5_kt_start_seq failed (%s)\n",
163 error_message(ret)));
166 ret = krb5_free_keytab_entry_contents(context, &kt_entry);
167 ZERO_STRUCT(kt_entry);
169 DEBUG(1,("ads_keytab_add_entry: krb5_kt_remove_entry failed (%s)\n",
170 error_message(ret)));
176 /* Not a match, just free this entry and continue. */
177 ret = krb5_free_keytab_entry_contents(context, &kt_entry);
178 ZERO_STRUCT(kt_entry);
180 DEBUG(1,("ads_keytab_add_entry: krb5_free_keytab_entry_contents failed (%s)\n", error_message(ret)));
185 ret = krb5_kt_end_seq_get(context, keytab, &cursor);
188 DEBUG(1,("ads_keytab_add_entry: krb5_kt_end_seq_get failed (%s)\n",error_message(ret)));
193 /* Ensure we don't double free. */
194 ZERO_STRUCT(kt_entry);
197 /* If we get here, we have deleted all the old entries with kvno's not equal to the current kvno-1. */
199 ret = get_kerberos_allowed_etypes(context,&enctypes);
201 DEBUG(1,("ads_keytab_add_entry: get_kerberos_allowed_etypes failed (%s)\n",error_message(ret)));
205 /* Now add keytab entries for all encryption types */
206 for (i = 0; enctypes[i]; i++) {
209 #if !defined(HAVE_KRB5_KEYTAB_ENTRY_KEY) && !defined(HAVE_KRB5_KEYTAB_ENTRY_KEYBLOCK)
210 #error krb5_keytab_entry has no key or keyblock member
212 #ifdef HAVE_KRB5_KEYTAB_ENTRY_KEY /* MIT */
213 keyp = &kt_entry.key;
215 #ifdef HAVE_KRB5_KEYTAB_ENTRY_KEYBLOCK /* Heimdal */
216 keyp = &kt_entry.keyblock;
218 if (create_kerberos_key_from_string(context, princ, &password, keyp, enctypes[i])) {
222 kt_entry.principal = princ;
225 DEBUG(3,("ads_keytab_add_entry: adding keytab entry for (%s) with encryption type (%d) and version (%d)\n",
226 princ_s, enctypes[i], kt_entry.vno));
227 ret = krb5_kt_add_entry(context, keytab, &kt_entry);
228 krb5_free_keyblock(context, keyp);
229 ZERO_STRUCT(kt_entry);
231 DEBUG(1,("ads_keytab_add_entry: adding entry to keytab failed (%s)\n", error_message(ret)));
236 krb5_kt_close(context, keytab);
237 keytab = NULL; /* Done with keytab now. No double free. */
239 /* Update the LDAP with the SPN */
240 DEBUG(3,("ads_keytab_add_entry: Attempting to add/update '%s'\n", princ_s));
241 if (!ADS_ERR_OK(ads_add_service_principal_name(ads, global_myname(), srvPrinc))) {
242 DEBUG(1,("ads_keytab_add_entry: ads_add_service_principcal_name failed.\n"));
248 SAFE_FREE(principal);
249 SAFE_FREE(password_s);
253 krb5_keytab_entry zero_kt_entry;
254 ZERO_STRUCT(zero_kt_entry);
255 if (memcmp(&zero_kt_entry, &kt_entry, sizeof(krb5_keytab_entry))) {
256 krb5_free_keytab_entry_contents(context, &kt_entry);
260 krb5_free_principal(context, princ);
263 free_kerberos_etypes(context, enctypes);
265 if (cursor && keytab) {
266 krb5_kt_end_seq_get(context, keytab, &cursor);
269 krb5_kt_close(context, keytab);
272 krb5_free_context(context);
277 /**********************************************************************
278 Flushes all entries from the system keytab.
279 ***********************************************************************/
281 int ads_keytab_flush(ADS_STRUCT *ads)
283 krb5_error_code ret = 0;
284 krb5_context context = NULL;
285 krb5_keytab keytab = NULL;
286 krb5_kt_cursor cursor = NULL;
287 krb5_keytab_entry kt_entry;
289 char keytab_name[MAX_KEYTAB_NAME_LEN];
291 ZERO_STRUCT(kt_entry);
292 initialize_krb5_error_table();
293 ret = krb5_init_context(&context);
295 DEBUG(1,("ads_keytab_flush: could not krb5_init_context: %s\n",error_message(ret)));
298 #ifdef HAVE_WRFILE_KEYTAB
299 keytab_name[0] = 'W';
300 keytab_name[1] = 'R';
301 ret = krb5_kt_default_name(context, (char *) &keytab_name[2], MAX_KEYTAB_NAME_LEN - 4);
303 ret = krb5_kt_default_name(context, (char *) &keytab_name[0], MAX_KEYTAB_NAME_LEN - 2);
306 DEBUG(1,("ads_keytab_flush: krb5_kt_default failed (%s)\n", error_message(ret)));
309 DEBUG(3,("ads_keytab_flush: Using default keytab: %s\n", (char *) &keytab_name));
310 ret = krb5_kt_resolve(context, (char *) &keytab_name, &keytab);
312 DEBUG(1,("ads_keytab_flush: krb5_kt_default failed (%s)\n", error_message(ret)));
315 ret = krb5_kt_resolve(context, (char *) &keytab_name, &keytab);
317 DEBUG(1,("ads_keytab_flush: krb5_kt_default failed (%s)\n", error_message(ret)));
321 kvno = (krb5_kvno) ads_get_kvno(ads, global_myname());
322 if (kvno == -1) { /* -1 indicates a failure */
323 DEBUG(1,("ads_keytab_flush: Error determining the system's kvno.\n"));
327 ret = krb5_kt_start_seq_get(context, keytab, &cursor);
328 if (ret != KRB5_KT_END && ret != ENOENT) {
329 while (!krb5_kt_next_entry(context, keytab, &kt_entry, &cursor)) {
330 ret = krb5_kt_end_seq_get(context, keytab, &cursor);
333 DEBUG(1,("ads_keytab_flush: krb5_kt_end_seq_get() failed (%s)\n",error_message(ret)));
336 ret = krb5_kt_remove_entry(context, keytab, &kt_entry);
338 DEBUG(1,("ads_keytab_flush: krb5_kt_remove_entry failed (%s)\n",error_message(ret)));
341 ret = krb5_kt_start_seq_get(context, keytab, &cursor);
343 DEBUG(1,("ads_keytab_flush: krb5_kt_start_seq failed (%s)\n",error_message(ret)));
346 ret = krb5_free_keytab_entry_contents(context, &kt_entry);
347 ZERO_STRUCT(kt_entry);
349 DEBUG(1,("ads_keytab_flush: krb5_kt_remove_entry failed (%s)\n",error_message(ret)));
355 /* Ensure we don't double free. */
356 ZERO_STRUCT(kt_entry);
359 if (!ADS_ERR_OK(ads_clear_service_principal_names(ads, global_myname()))) {
360 DEBUG(1,("ads_keytab_flush: Error while clearing service principal listings in LDAP.\n"));
367 krb5_keytab_entry zero_kt_entry;
368 ZERO_STRUCT(zero_kt_entry);
369 if (memcmp(&zero_kt_entry, &kt_entry, sizeof(krb5_keytab_entry))) {
370 krb5_free_keytab_entry_contents(context, &kt_entry);
373 if (cursor && keytab) {
374 krb5_kt_end_seq_get(context, keytab, &cursor);
377 krb5_kt_close(context, keytab);
380 krb5_free_context(context);
385 /**********************************************************************
386 Adds all the required service principals to the system keytab.
387 ***********************************************************************/
389 int ads_keytab_create_default(ADS_STRUCT *ads)
391 krb5_error_code ret = 0;
392 krb5_context context = NULL;
393 krb5_keytab keytab = NULL;
394 krb5_kt_cursor cursor = NULL;
395 krb5_keytab_entry kt_entry;
398 char **oldEntries = NULL;
400 ret = ads_keytab_add_entry(ads, "host");
402 DEBUG(1,("ads_keytab_create_default: ads_keytab_add_entry failed while adding 'host'.\n"));
405 ret = ads_keytab_add_entry(ads, "cifs");
407 DEBUG(1,("ads_keytab_create_default: ads_keytab_add_entry failed while adding 'cifs'.\n"));
411 kvno = (krb5_kvno) ads_get_kvno(ads, global_myname());
413 DEBUG(1,("ads_keytab_create_default: ads_get_kvno failed to determine the system's kvno.\n"));
417 DEBUG(3,("ads_keytab_create_default: Searching for keytab entries to preserve and update.\n"));
418 /* Now loop through the keytab and update any other existing entries... */
420 ZERO_STRUCT(kt_entry);
422 initialize_krb5_error_table();
423 ret = krb5_init_context(&context);
425 DEBUG(1,("ads_keytab_create_default: could not krb5_init_context: %s\n",error_message(ret)));
428 ret = krb5_kt_default(context, &keytab);
430 DEBUG(1,("ads_keytab_create_default: krb5_kt_default failed (%s)\n",error_message(ret)));
434 ret = krb5_kt_start_seq_get(context, keytab, &cursor);
435 if (ret != KRB5_KT_END && ret != ENOENT ) {
436 while ((ret = krb5_kt_next_entry(context, keytab, &kt_entry, &cursor)) == 0) {
437 krb5_free_keytab_entry_contents(context, &kt_entry);
438 ZERO_STRUCT(kt_entry);
442 krb5_kt_end_seq_get(context, keytab, &cursor);
446 * Hmmm. There is no "rewind" function for the keytab. This means we have a race condition
447 * where someone else could add entries after we've counted them. Re-open asap to minimise
451 DEBUG(3, ("ads_keytab_create_default: Found %d entries in the keytab.\n", found));
455 oldEntries = (char **) malloc(found * sizeof(char *));
457 DEBUG(1,("ads_keytab_create_default: Failed to allocate space to store the old keytab entries (malloc failed?).\n"));
461 memset(oldEntries, '\0', found * sizeof(char *));
463 ret = krb5_kt_start_seq_get(context, keytab, &cursor);
464 if (ret != KRB5_KT_END && ret != ENOENT ) {
465 while ((ret = krb5_kt_next_entry(context, keytab, &kt_entry, &cursor)) == 0) {
466 if (kt_entry.vno != kvno) {
467 char *ktprinc = NULL;
470 /* This returns a malloc'ed string in ktprinc. */
471 ret = krb5_unparse_name(context, kt_entry.principal, &ktprinc);
473 DEBUG(1,("krb5_unparse_name failed (%s)\n", error_message(ret)));
477 * From looking at the krb5 source they don't seem to take locale
478 * or mb strings into account. Maybe this is because they assume utf8 ?
479 * In this case we may need to convert from utf8 to mb charset here ? JRA.
481 p = strchr_m(ktprinc, '/');
485 for (i = 0; i < found; i++) {
486 if (!oldEntries[i]) {
487 oldEntries[i] = ktprinc;
490 if (!strcmp(oldEntries[i], ktprinc)) {
495 krb5_free_keytab_entry_contents(context, &kt_entry);
496 ZERO_STRUCT(kt_entry);
498 for (i = 0; oldEntries[i]; i++) {
499 ret |= ads_keytab_add_entry(ads, oldEntries[i]);
500 krb5_free_unparsed_name(context, oldEntries[i]);
502 krb5_kt_end_seq_get(context, keytab, &cursor);
508 SAFE_FREE(oldEntries);
511 krb5_keytab_entry zero_kt_entry;
512 ZERO_STRUCT(zero_kt_entry);
513 if (memcmp(&zero_kt_entry, &kt_entry, sizeof(krb5_keytab_entry))) {
514 krb5_free_keytab_entry_contents(context, &kt_entry);
517 if (cursor && keytab) {
518 krb5_kt_end_seq_get(context, keytab, &cursor);
521 krb5_kt_close(context, keytab);
524 krb5_free_context(context);
528 #endif /* HAVE_KRB5 */