2 * Copyright (c) 1997-2007 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
6 * Portions Copyright (c) 2009 Apple Inc. All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
19 * 3. Neither the name of the Institute nor the names of its contributors
20 * may be used to endorse or promote products derived from this software
21 * without specific prior written permission.
23 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 #include "kuser_locl.h"
39 #include <Security/Security.h>
47 #define SIGINFO SIGUSR1
50 int forwardable_flag
= -1;
51 int proxiable_flag
= -1;
52 int renewable_flag
= -1;
55 int validate_flag
= 0;
59 struct getarg_strings extra_addresses
;
60 int anonymous_flag
= 0;
61 char *lifetime
= NULL
;
62 char *renew_life
= NULL
;
63 char *server_str
= NULL
;
64 char *cred_cache
= NULL
;
65 char *start_str
= NULL
;
66 static int switch_cache_flags
= 1;
67 struct getarg_strings etype_str
;
69 char *keytab_str
= NULL
;
70 static krb5_keytab kt
= NULL
;
73 char *password_file
= NULL
;
74 char *pk_user_id
= NULL
;
75 int pk_enterprise_flag
= 0;
76 struct hx509_certs_data
*ent_user_id
= NULL
;
77 char *pk_x509_anchors
= NULL
;
78 int pk_use_enckey
= 0;
79 static int canonicalize_flag
= 0;
80 static int enterprise_flag
= 0;
81 static int ok_as_delegate_flag
= 0;
82 static char *fast_armor_cache_string
= NULL
;
83 static int use_referrals_flag
= 0;
84 static int windows_flag
= 0;
86 static char *ntlm_domain
;
90 static struct getargs args
[] = {
104 { "afslog", 0 , arg_flag
, &do_afslog
,
105 NP_("obtain afs tokens", ""), NULL
},
107 { "cache", 'c', arg_string
, &cred_cache
,
108 NP_("credentials cache", ""), "cachename" },
110 { "forwardable", 'F', arg_negative_flag
, &forwardable_flag
,
111 NP_("get tickets not forwardable", ""), NULL
},
113 { NULL
, 'f', arg_flag
, &forwardable_flag
,
114 NP_("get forwardable tickets", ""), NULL
},
116 { "keytab", 't', arg_string
, &keytab_str
,
117 NP_("keytab to use", ""), "keytabname" },
119 { "lifetime", 'l', arg_string
, &lifetime
,
120 NP_("lifetime of tickets", ""), "time" },
122 { "proxiable", 'p', arg_flag
, &proxiable_flag
,
123 NP_("get proxiable tickets", ""), NULL
},
125 { "renew", 'R', arg_flag
, &renew_flag
,
126 NP_("renew TGT", ""), NULL
},
128 { "renewable", 0, arg_flag
, &renewable_flag
,
129 NP_("get renewable tickets", ""), NULL
},
131 { "renewable-life", 'r', arg_string
, &renew_life
,
132 NP_("renewable lifetime of tickets", ""), "time" },
134 { "server", 'S', arg_string
, &server_str
,
135 NP_("server to get ticket for", ""), "principal" },
137 { "start-time", 's', arg_string
, &start_str
,
138 NP_("when ticket gets valid", ""), "time" },
140 { "use-keytab", 'k', arg_flag
, &use_keytab
,
141 NP_("get key from keytab", ""), NULL
},
143 { "validate", 'v', arg_flag
, &validate_flag
,
144 NP_("validate TGT", ""), NULL
},
146 { "enctypes", 'e', arg_strings
, &etype_str
,
147 NP_("encryption types to use", ""), "enctypes" },
149 { "fcache-version", 0, arg_integer
, &fcache_version
,
150 NP_("file cache version to create", ""), NULL
},
152 { "addresses", 'A', arg_negative_flag
, &addrs_flag
,
153 NP_("request a ticket with no addresses", ""), NULL
},
155 { "extra-addresses",'a', arg_strings
, &extra_addresses
,
156 NP_("include these extra addresses", ""), "addresses" },
158 { "anonymous", 0, arg_flag
, &anonymous_flag
,
159 NP_("request an anonymous ticket", ""), NULL
},
161 { "request-pac", 0, arg_flag
, &pac_flag
,
162 NP_("request a Windows PAC", ""), NULL
},
164 { "password-file", 0, arg_string
, &password_file
,
165 NP_("read the password from a file", ""), NULL
},
167 { "canonicalize",0, arg_flag
, &canonicalize_flag
,
168 NP_("canonicalize client principal", ""), NULL
},
170 { "enterprise",0, arg_flag
, &enterprise_flag
,
171 NP_("parse principal as a KRB5-NT-ENTERPRISE name", ""), NULL
},
173 { "pk-enterprise", 0, arg_flag
, &pk_enterprise_flag
,
174 NP_("use enterprise name from certificate", ""), NULL
},
176 { "pk-user", 'C', arg_string
, &pk_user_id
,
177 NP_("principal's public/private/certificate identifier", ""), "id" },
179 { "x509-anchors", 'D', arg_string
, &pk_x509_anchors
,
180 NP_("directory with CA certificates", ""), "directory" },
182 { "pk-use-enckey", 0, arg_flag
, &pk_use_enckey
,
183 NP_("Use RSA encrypted reply (instead of DH)", ""), NULL
},
186 { "ntlm-domain", 0, arg_string
, &ntlm_domain
,
187 NP_("NTLM domain", ""), "domain" },
190 { "change-default", 0, arg_negative_flag
, &switch_cache_flags
,
191 NP_("switch the default cache to the new credentials cache", ""), NULL
},
193 { "ok-as-delegate", 0, arg_flag
, &ok_as_delegate_flag
,
194 NP_("honor ok-as-delegate on tickets", ""), NULL
},
196 { "fast-armor-cache", 0, arg_string
, &fast_armor_cache_string
,
197 NP_("use this credential cache as FAST armor cache", ""), "cache" },
199 { "use-referrals", 0, arg_flag
, &use_referrals_flag
,
200 NP_("only use referrals, no dns canalisation", ""), NULL
},
202 { "windows", 0, arg_flag
, &windows_flag
,
203 NP_("get windows behavior", ""), NULL
},
205 { "version", 0, arg_flag
, &version_flag
, NULL
, NULL
},
206 { "help", 0, arg_flag
, &help_flag
, NULL
, NULL
}
212 arg_printusage_i18n(args
, sizeof(args
)/sizeof(*args
), N_("Usage: ", ""),
213 NULL
, "[principal [command]]", getarg_i18n
);
217 static krb5_error_code
218 get_server(krb5_context context
,
219 krb5_principal client
,
221 krb5_principal
*princ
)
223 krb5_const_realm realm
;
225 return krb5_parse_name(context
, server
, princ
);
227 realm
= krb5_principal_get_realm(context
, client
);
228 return krb5_make_principal(context
, princ
, realm
,
229 KRB5_TGS_NAME
, realm
, NULL
);
232 static krb5_error_code
233 copy_configs(krb5_context context
,
236 krb5_principal start_ticket_server
)
239 const char *cfg_names
[] = {"realm-config", "FriendlyName", NULL
};
240 const char *cfg_names_w_pname
[] = {"fast_avail", NULL
};
244 for (i
= 0; cfg_names
[i
]; i
++) {
245 ret
= krb5_cc_get_config(context
, src
, NULL
, cfg_names
[i
], &cfg_data
);
246 if (ret
== KRB5_CC_NOTFOUND
|| ret
== KRB5_CC_END
) {
249 krb5_warn(context
, ret
, "krb5_cc_get_config");
252 ret
= krb5_cc_set_config(context
, dst
, NULL
, cfg_names
[i
], &cfg_data
);
254 krb5_warn(context
, ret
, "krb5_cc_set_config");
256 for (i
= 0; start_ticket_server
&& cfg_names_w_pname
[i
]; i
++) {
257 ret
= krb5_cc_get_config(context
, src
, start_ticket_server
,
258 cfg_names_w_pname
[i
], &cfg_data
);
259 if (ret
== KRB5_CC_NOTFOUND
|| ret
== KRB5_CC_END
) {
262 krb5_warn(context
, ret
, "krb5_cc_get_config");
265 ret
= krb5_cc_set_config(context
, dst
, start_ticket_server
,
266 cfg_names_w_pname
[i
], &cfg_data
);
267 if (ret
&& ret
!= KRB5_CC_NOTFOUND
)
268 krb5_warn(context
, ret
, "krb5_cc_set_config");
271 * We don't copy cc configs for any other principals though (mostly
272 * those are per-target time offsets and the like, so it's bad to
273 * lose them, but hardly the end of the world, and as they may not
274 * expire anyways, it's good to let them go).
279 static krb5_error_code
280 renew_validate(krb5_context context
,
288 krb5_ccache tempccache
= NULL
;
289 krb5_creds in
, *out
= NULL
;
290 krb5_kdc_flags flags
;
292 memset(&in
, 0, sizeof(in
));
294 ret
= krb5_cc_get_principal(context
, cache
, &in
.client
);
296 krb5_warn(context
, ret
, "krb5_cc_get_principal");
299 ret
= get_server(context
, in
.client
, server
, &in
.server
);
301 krb5_warn(context
, ret
, "get_server");
307 * no need to check the error here, it's only to be
308 * friendly to the user
310 krb5_get_credentials(context
, KRB5_GC_CACHED
, cache
, &in
, &out
);
314 flags
.b
.renewable
= flags
.b
.renew
= renew
;
315 flags
.b
.validate
= validate
;
317 if (forwardable_flag
!= -1)
318 flags
.b
.forwardable
= forwardable_flag
;
320 flags
.b
.forwardable
= out
->flags
.b
.forwardable
;
322 if (proxiable_flag
!= -1)
323 flags
.b
.proxiable
= proxiable_flag
;
325 flags
.b
.proxiable
= out
->flags
.b
.proxiable
;
328 flags
.b
.request_anonymous
= anonymous_flag
;
330 in
.times
.endtime
= time(NULL
) + life
;
333 krb5_free_creds(context
, out
);
338 ret
= krb5_get_kdc_cred(context
,
346 krb5_warn(context
, ret
, "krb5_get_kdc_cred");
350 ret
= krb5_cc_new_unique(context
, krb5_cc_get_type(context
, cache
),
353 krb5_warn(context
, ret
, "krb5_cc_new_unique");
357 ret
= krb5_cc_initialize(context
, tempccache
, in
.client
);
359 krb5_warn(context
, ret
, "krb5_cc_initialize");
363 ret
= krb5_cc_store_cred(context
, tempccache
, out
);
365 krb5_warn(context
, ret
, "krb5_cc_store_cred");
370 * We want to preserve cc configs as some are security-relevant, and
371 * anyways it's the friendly thing to do.
373 ret
= copy_configs(context
, tempccache
, cache
, out
->server
);
377 ret
= krb5_cc_move(context
, tempccache
, cache
);
379 krb5_warn(context
, ret
, "krb5_cc_move");
386 krb5_cc_close(context
, tempccache
);
388 krb5_free_creds(context
, out
);
389 krb5_free_cred_contents(context
, &in
);
395 static krb5_error_code
396 store_ntlmkey(krb5_context context
, krb5_ccache id
,
397 const char *domain
, struct ntlm_buf
*buf
)
404 aret
= asprintf(&name
, "ntlm-key-%s", domain
);
405 if (aret
== -1 || name
== NULL
) {
406 krb5_clear_error_message(context
);
410 data
.length
= buf
->length
;
411 data
.data
= buf
->data
;
413 ret
= krb5_cc_set_config(context
, id
, NULL
, name
, &data
);
419 static krb5_error_code
420 get_new_tickets(krb5_context context
,
421 krb5_principal principal
,
423 krb5_deltat ticket_life
,
429 krb5_deltat start_time
= 0;
430 krb5_deltat renew
= 0;
431 const char *renewstr
= NULL
;
432 krb5_enctype
*enctype
= NULL
;
433 krb5_ccache tempccache
= NULL
;
434 krb5_init_creds_context ctx
= NULL
;
435 krb5_get_init_creds_opt
*opt
= NULL
;
436 krb5_prompter_fct prompter
= krb5_prompter_posix
;
438 struct ntlm_buf ntlmkey
;
439 memset(&ntlmkey
, 0, sizeof(ntlmkey
));
449 if (strcasecmp("STDIN", password_file
) == 0)
452 f
= fopen(password_file
, "r");
454 krb5_warnx(context
, "Failed to open the password file %s",
459 if (fgets(passwd
, sizeof(passwd
), f
) == NULL
) {
460 krb5_warnx(context
, N_("Failed to read password from file %s", ""),
463 return EINVAL
; /* XXX Need a better error */
467 passwd
[strcspn(passwd
, "\n")] = '\0';
471 if (passwd
[0] == '\0') {
478 realm
= krb5_principal_get_realm(context
, principal
);
480 ret
= krb5_unparse_name_flags(context
, principal
,
481 KRB5_PRINCIPAL_UNPARSE_NO_REALM
, &name
);
485 osret
= SecKeychainFindGenericPassword(NULL
, strlen(realm
), realm
,
487 &length
, &buffer
, NULL
);
489 if (osret
== noErr
&& length
< sizeof(passwd
) - 1) {
490 memcpy(passwd
, buffer
, length
);
491 passwd
[length
] = '\0';
498 memset(&cred
, 0, sizeof(cred
));
500 ret
= krb5_get_init_creds_opt_alloc(context
, &opt
);
502 krb5_warn(context
, ret
, "krb5_get_init_creds_opt_alloc");
506 krb5_get_init_creds_opt_set_default_flags(context
, "kinit",
507 krb5_principal_get_realm(context
, principal
), opt
);
509 if (forwardable_flag
!= -1)
510 krb5_get_init_creds_opt_set_forwardable(opt
, forwardable_flag
);
511 if (proxiable_flag
!= -1)
512 krb5_get_init_creds_opt_set_proxiable(opt
, proxiable_flag
);
514 krb5_get_init_creds_opt_set_anonymous(opt
, anonymous_flag
);
516 krb5_get_init_creds_opt_set_pac_request(context
, opt
,
517 pac_flag
? TRUE
: FALSE
);
518 if (canonicalize_flag
)
519 krb5_get_init_creds_opt_set_canonicalize(context
, opt
, TRUE
);
520 if (pk_enterprise_flag
|| enterprise_flag
|| canonicalize_flag
|| windows_flag
)
521 krb5_get_init_creds_opt_set_win2k(context
, opt
, TRUE
);
522 if (pk_user_id
|| ent_user_id
|| anonymous_flag
) {
523 ret
= krb5_get_init_creds_opt_set_pkinit(context
, opt
,
529 pk_use_enckey
? 2 : 0 |
530 anonymous_flag
? 4 : 0,
535 krb5_warn(context
, ret
, "krb5_get_init_creds_opt_set_pkinit");
539 krb5_get_init_creds_opt_set_pkinit_user_certs(context
, opt
, ent_user_id
);
542 if (addrs_flag
!= -1)
543 krb5_get_init_creds_opt_set_addressless(context
, opt
,
544 addrs_flag
? FALSE
: TRUE
);
546 if (renew_life
== NULL
&& renewable_flag
)
547 renewstr
= "1 month";
549 renewstr
= renew_life
;
551 renew
= parse_time(renewstr
, "s");
553 errx(1, "unparsable time: %s", renewstr
);
555 krb5_get_init_creds_opt_set_renew_life(opt
, renew
);
558 if (ticket_life
!= 0)
559 krb5_get_init_creds_opt_set_tkt_life(opt
, ticket_life
);
562 int tmp
= parse_time(start_str
, "s");
564 errx(1, N_("unparsable time: %s", ""), start_str
);
569 if (etype_str
.num_strings
) {
572 enctype
= malloc(etype_str
.num_strings
* sizeof(*enctype
));
574 errx(1, "out of memory");
575 for(i
= 0; i
< etype_str
.num_strings
; i
++) {
576 ret
= krb5_string_to_enctype(context
,
577 etype_str
.strings
[i
],
580 errx(1, "unrecognized enctype: %s", etype_str
.strings
[i
]);
582 krb5_get_init_creds_opt_set_etype_list(opt
, enctype
,
583 etype_str
.num_strings
);
586 ret
= krb5_init_creds_init(context
, principal
, prompter
, NULL
, start_time
, opt
, &ctx
);
588 krb5_warn(context
, ret
, "krb5_init_creds_init");
593 ret
= krb5_init_creds_set_service(context
, ctx
, server_str
);
595 krb5_warn(context
, ret
, "krb5_init_creds_set_service");
600 if (fast_armor_cache_string
) {
603 ret
= krb5_cc_resolve(context
, fast_armor_cache_string
, &fastid
);
605 krb5_warn(context
, ret
, "krb5_cc_resolve(FAST cache)");
609 ret
= krb5_init_creds_set_fast_ccache(context
, ctx
, fastid
);
611 krb5_warn(context
, ret
, "krb5_init_creds_set_fast_ccache");
616 if (use_keytab
|| keytab_str
) {
617 ret
= krb5_init_creds_set_keytab(context
, ctx
, kt
);
619 krb5_warn(context
, ret
, "krb5_init_creds_set_keytab");
622 } else if (pk_user_id
|| ent_user_id
|| anonymous_flag
) {
624 } else if (!interactive
&& passwd
[0] == '\0') {
625 static int already_warned
= 0;
628 krb5_warnx(context
, "Not interactive, failed to get "
630 krb5_get_init_creds_opt_free(context
, opt
);
635 if (passwd
[0] == '\0') {
639 ret
= krb5_unparse_name(context
, principal
, &p
);
641 errx(1, "failed to generate passwd prompt: not enough memory");
643 aret
= asprintf(&prompt
, N_("%s's Password: ", ""), p
);
646 errx(1, "failed to generate passwd prompt: not enough memory");
648 if (UI_UTIL_read_pw_string(passwd
, sizeof(passwd
)-1, prompt
, 0)){
649 memset(passwd
, 0, sizeof(passwd
));
650 errx(1, "failed to read password");
656 ret
= krb5_init_creds_set_password(context
, ctx
, passwd
);
658 krb5_warn(context
, ret
, "krb5_init_creds_set_password");
664 ret
= krb5_init_creds_get(context
, ctx
);
667 if (ntlm_domain
&& passwd
[0])
668 heim_ntlm_nt_key(passwd
, &ntlmkey
);
670 memset(passwd
, 0, sizeof(passwd
));
675 case KRB5_LIBOS_PWDINTR
: /* don't print anything if it was just C-c:ed */
677 case KRB5KRB_AP_ERR_BAD_INTEGRITY
:
678 case KRB5KRB_AP_ERR_MODIFIED
:
679 case KRB5KDC_ERR_PREAUTH_FAILED
:
680 case KRB5_GET_IN_TKT_LOOP
:
681 krb5_warnx(context
, N_("Password incorrect", ""));
683 case KRB5KRB_AP_ERR_V4_REPLY
:
684 krb5_warnx(context
, N_("Looks like a Kerberos 4 reply", ""));
687 krb5_warn(context
, ret
, "krb5_get_init_creds");
691 krb5_process_last_request(context
, opt
, ctx
);
693 ret
= krb5_init_creds_get_creds(context
, ctx
, &cred
);
695 krb5_warn(context
, ret
, "krb5_init_creds_get_creds");
699 if (ticket_life
!= 0) {
700 if (abs(cred
.times
.endtime
- cred
.times
.starttime
- ticket_life
) > 30) {
702 unparse_time_approx(cred
.times
.endtime
- cred
.times
.starttime
,
704 krb5_warnx(context
, N_("NOTICE: ticket lifetime is %s", ""), life
);
708 if (abs(cred
.times
.renew_till
- cred
.times
.starttime
- renew
) > 30) {
710 unparse_time_approx(cred
.times
.renew_till
- cred
.times
.starttime
,
713 N_("NOTICE: ticket renewable lifetime is %s", ""),
718 ret
= krb5_cc_new_unique(context
, krb5_cc_get_type(context
, ccache
),
721 krb5_warn(context
, ret
, "krb5_cc_new_unique");
725 ret
= krb5_init_creds_store(context
, ctx
, tempccache
);
727 krb5_warn(context
, ret
, "krb5_init_creds_store");
731 krb5_init_creds_free(context
, ctx
);
734 ret
= krb5_cc_move(context
, tempccache
, ccache
);
736 krb5_warn(context
, ret
, "krb5_cc_move");
741 if (switch_cache_flags
)
742 krb5_cc_switch(context
, ccache
);
745 if (ntlm_domain
&& ntlmkey
.data
)
746 store_ntlmkey(context
, ccache
, ntlm_domain
, &ntlmkey
);
749 if (ok_as_delegate_flag
|| windows_flag
|| use_referrals_flag
) {
753 if (ok_as_delegate_flag
|| windows_flag
)
755 if (use_referrals_flag
|| windows_flag
)
761 krb5_cc_set_config(context
, ccache
, NULL
, "realm-config", &data
);
765 krb5_get_init_creds_opt_free(context
, opt
);
767 krb5_init_creds_free(context
, ctx
);
769 krb5_cc_close(context
, tempccache
);
778 ticket_lifetime(krb5_context context
, krb5_ccache cache
, krb5_principal client
,
779 const char *server
, time_t *renew
)
781 krb5_creds in_cred
, *cred
;
786 memset(&in_cred
, 0, sizeof(in_cred
));
788 ret
= krb5_cc_get_principal(context
, cache
, &in_cred
.client
);
790 krb5_warn(context
, ret
, "krb5_cc_get_principal");
793 ret
= get_server(context
, in_cred
.client
, server
, &in_cred
.server
);
795 krb5_free_principal(context
, in_cred
.client
);
796 krb5_warn(context
, ret
, "get_server");
800 ret
= krb5_get_credentials(context
, KRB5_GC_CACHED
,
801 cache
, &in_cred
, &cred
);
802 krb5_free_principal(context
, in_cred
.client
);
803 krb5_free_principal(context
, in_cred
.server
);
805 krb5_warn(context
, ret
, "krb5_get_credentials");
808 curtime
= time(NULL
);
809 timeout
= cred
->times
.endtime
- curtime
;
813 *renew
= cred
->times
.renew_till
- curtime
;
817 krb5_free_creds(context
, cred
);
821 static time_t expire
;
823 static char siginfo_msg
[1024] = "No credentials\n";
826 update_siginfo_msg(time_t exp
, const char *srv
)
828 /* Note that exp is relative time */
829 memset(siginfo_msg
, 0, sizeof(siginfo_msg
));
830 memcpy(&siginfo_msg
, "Updating...\n", sizeof("Updating...\n"));
833 snprintf(siginfo_msg
, sizeof(siginfo_msg
),
834 N_("kinit: TGT expires in %llu seconds\n", ""),
835 (unsigned long long)expire
);
837 snprintf(siginfo_msg
, sizeof(siginfo_msg
),
838 N_("kinit: Ticket for %s expired\n", ""), srv
);
845 snprintf(siginfo_msg
, sizeof(siginfo_msg
),
846 N_("kinit: TGT expired\n", ""));
848 snprintf(siginfo_msg
, sizeof(siginfo_msg
),
849 N_("kinit: Ticket for %s expired\n", ""), srv
);
853 #ifdef HAVE_SIGACTION
855 handle_siginfo(int sig
)
859 iov
[0].iov_base
= rk_UNCONST(siginfo_msg
);
860 iov
[0].iov_len
= strlen(siginfo_msg
);
861 iov
[1].iov_base
= "\n";
864 writev(STDERR_FILENO
, iov
, sizeof(iov
)/sizeof(iov
[0]));
869 krb5_context context
;
871 krb5_principal principal
;
872 krb5_deltat ticket_life
;
877 renew_func(void *ptr
)
880 struct renew_ctx
*ctx
= ptr
;
882 static time_t exp_delay
= 1;
885 * NOTE: We count on the ccache implementation to notice changes to the
886 * actual ccache filesystem/whatever objects. There should be no ccache
887 * types for which this is not the case, but it might not hurt to
888 * re-krb5_cc_resolve() after each successful renew_validate()/
889 * get_new_tickets() call.
892 expire
= ticket_lifetime(ctx
->context
, ctx
->ccache
, ctx
->principal
,
893 server_str
, &renew_expire
);
896 * When a keytab is available to obtain new tickets, if we are within
897 * half of the original ticket lifetime of the renew limit, get a new
898 * TGT instead of renewing the existing TGT. Note, ctx->ticket_life
899 * is zero by default (without a '-l' option) and cannot be used to
900 * set the time scale on which we decide whether we're "close to the
903 if (use_keytab
|| keytab_str
)
904 expire
+= ctx
->timeout
;
905 if (renew_expire
> expire
) {
906 ret
= renew_validate(ctx
->context
, 1, validate_flag
, ctx
->ccache
,
907 server_str
, ctx
->ticket_life
);
909 ret
= get_new_tickets(ctx
->context
, ctx
->principal
, ctx
->ccache
,
910 ctx
->ticket_life
, 0);
912 expire
= ticket_lifetime(ctx
->context
, ctx
->ccache
, ctx
->principal
,
913 server_str
, &renew_expire
);
916 if (ret
== 0 && server_str
== NULL
&& do_afslog
&& k_hasafs())
917 krb5_afslog(ctx
->context
, ctx
->ccache
, NULL
, NULL
);
920 update_siginfo_msg(expire
, server_str
);
923 * If our tickets have expired and we been able to either renew them
924 * or obtain new tickets, then we still call this function but we use
925 * an exponential backoff. This should take care of the case where
926 * we are using stored credentials but the KDC has been unavailable
932 * We can't ask to keep spamming stderr but not syslog, so we warn
935 if (exp_delay
== 1) {
936 krb5_warnx(ctx
->context
, N_("NOTICE: Could not renew/refresh "
939 if (exp_delay
< 7200)
940 exp_delay
+= exp_delay
/ 2 + 1;
945 return expire
/ 2 + 1;
949 set_princ_realm(krb5_context context
,
950 krb5_principal principal
,
955 if ((ret
= krb5_principal_set_realm(context
, principal
, realm
)) != 0)
956 krb5_err(context
, 1, ret
, "krb5_principal_set_realm");
960 parse_name_realm(krb5_context context
,
964 krb5_principal
*princ
)
969 flags
|= KRB5_PRINCIPAL_PARSE_NO_DEF_REALM
;
970 if ((ret
= krb5_parse_name_flags(context
, name
, flags
, princ
)) != 0)
971 krb5_err(context
, 1, ret
, "krb5_parse_name_flags");
972 if (realm
&& krb5_principal_get_realm(context
, *princ
) == NULL
)
973 set_princ_realm(context
, *princ
, realm
);
977 get_default_realm(krb5_context context
)
982 if ((ret
= krb5_get_default_realm(context
, &realm
)) != 0)
983 krb5_err(context
, 1, ret
, "krb5_get_default_realm");
988 get_default_principal(krb5_context context
, krb5_principal
*princ
)
992 if ((ret
= krb5_get_default_principal(context
, princ
)) != 0)
993 krb5_err(context
, 1, ret
, "krb5_get_default_principal");
997 get_user_realm(krb5_context context
)
1000 char *user_realm
= NULL
;
1003 * If memory allocation fails, we don't try to use the wrong realm,
1004 * that will trigger misleading error messages complicate support.
1006 krb5_appdefault_string(context
, "kinit", NULL
, "user_realm", "",
1008 if (user_realm
== NULL
) {
1009 ret
= krb5_enomem(context
);
1010 krb5_err(context
, 1, ret
, "krb5_appdefault_string");
1013 if (*user_realm
== 0) {
1022 get_princ(krb5_context context
, krb5_principal
*principal
, const char *name
)
1024 krb5_error_code ret
;
1032 /* If credential cache provides a client principal, use that. */
1033 if (krb5_cc_default(context
, &ccache
) == 0) {
1034 ret
= krb5_cc_get_principal(context
, ccache
, principal
);
1035 krb5_cc_close(context
, ccache
);
1041 user_realm
= get_user_realm(context
);
1044 if (canonicalize_flag
|| enterprise_flag
)
1045 parseflags
|= KRB5_PRINCIPAL_PARSE_ENTERPRISE
;
1047 parse_name_realm(context
, name
, parseflags
, user_realm
, &tmp
);
1049 if (user_realm
&& krb5_principal_get_num_comp(context
, tmp
) > 1) {
1050 /* Principal is instance qualified, reparse with default realm. */
1051 krb5_free_principal(context
, tmp
);
1052 parse_name_realm(context
, name
, parseflags
, NULL
, principal
);
1057 get_default_principal(context
, principal
);
1059 set_princ_realm(context
, *principal
, user_realm
);
1067 get_princ_kt(krb5_context context
,
1068 krb5_principal
*principal
,
1071 krb5_error_code ret
;
1074 krb5_kt_cursor cursor
;
1075 krb5_keytab_entry entry
;
1080 * If the credential cache exists and specifies a client principal,
1083 if (krb5_cc_default(context
, &ccache
) == 0) {
1084 ret
= krb5_cc_get_principal(context
, ccache
, principal
);
1085 krb5_cc_close(context
, ccache
);
1092 /* If the principal specifies an explicit realm, just use that. */
1093 int parseflags
= KRB5_PRINCIPAL_PARSE_NO_DEF_REALM
;
1095 parse_name_realm(context
, name
, parseflags
, NULL
, &tmp
);
1096 if (krb5_principal_get_realm(context
, tmp
) != NULL
) {
1101 /* Otherwise, search keytab for bare name of the default principal. */
1102 get_default_principal(context
, &tmp
);
1103 set_princ_realm(context
, tmp
, NULL
);
1106 def_realm
= get_default_realm(context
);
1108 ret
= krb5_kt_start_seq_get(context
, kt
, &cursor
);
1110 krb5_err(context
, 1, ret
, "krb5_kt_start_seq_get");
1113 krb5_kt_next_entry(context
, kt
, &entry
, &cursor
) == 0) {
1116 if (!krb5_principal_compare_any_realm(context
, tmp
, entry
.principal
))
1119 krb5_principal_compare(context
, *principal
, entry
.principal
))
1121 /* The default realm takes precedence */
1122 realm
= krb5_principal_get_realm(context
, entry
.principal
);
1123 if (*principal
&& strcmp(def_realm
, realm
) == 0) {
1124 krb5_free_principal(context
, *principal
);
1125 ret
= krb5_copy_principal(context
, entry
.principal
, principal
);
1129 ret
= krb5_copy_principal(context
, entry
.principal
, principal
);
1131 if (ret
!= 0 || (ret
= krb5_kt_end_seq_get(context
, kt
, &cursor
)) != 0)
1132 krb5_err(context
, 1, ret
, "get_princ_kt");
1135 parse_name_realm(context
, name
, 0, NULL
, principal
);
1137 krb5_err(context
, 1, KRB5_CC_NOTFOUND
, "get_princ_kt");
1139 krb5_free_principal(context
, tmp
);
1143 static krb5_error_code
1144 get_switched_ccache(krb5_context context
,
1146 krb5_principal principal
,
1147 krb5_ccache
*ccache
)
1149 krb5_error_code ret
;
1152 if (strcmp(type
, "API") == 0) {
1154 * Windows stores the default ccache name in the
1155 * registry which is shared across multiple logon
1156 * sessions for the same user. The API credential
1157 * cache provides a unique name space per logon
1158 * session. Therefore there is no need to generate
1159 * a unique ccache name. Instead use the principal
1160 * name. This provides a friendlier user experience.
1162 char * unparsed_name
;
1165 ret
= krb5_unparse_name(context
, principal
,
1168 krb5_err(context
, 1, ret
,
1169 N_("unparsing principal name", ""));
1171 ret
= asprintf(&cred_cache
, "API:%s", unparsed_name
);
1172 krb5_free_unparsed_name(context
, unparsed_name
);
1173 if (ret
== -1 || cred_cache
== NULL
)
1174 krb5_err(context
, 1, ret
,
1175 N_("building credential cache name", ""));
1177 ret
= krb5_cc_resolve(context
, cred_cache
, ccache
);
1179 } else if (strcmp(type
, "MSLSA") == 0) {
1181 * The Windows MSLSA cache when it is writeable
1182 * stores tickets for multiple client principals
1183 * in a single credential cache.
1185 ret
= krb5_cc_resolve(context
, "MSLSA:", ccache
);
1187 ret
= krb5_cc_new_unique(context
, type
, NULL
, ccache
);
1190 ret
= krb5_cc_new_unique(context
, type
, NULL
, ccache
);
1197 main(int argc
, char **argv
)
1199 krb5_error_code ret
;
1200 krb5_context context
;
1202 krb5_principal principal
= NULL
;
1204 krb5_deltat ticket_life
= 0;
1205 #ifdef HAVE_SIGACTION
1206 struct sigaction sa
;
1209 setprogname(argv
[0]);
1211 setlocale(LC_ALL
, "");
1212 bindtextdomain("heimdal_kuser", HEIMDAL_LOCALEDIR
);
1213 textdomain("heimdal_kuser");
1215 ret
= krb5_init_context(&context
);
1216 if (ret
== KRB5_CONFIG_BADFORMAT
)
1217 errx(1, "krb5_init_context failed to parse configuration file");
1219 errx(1, "krb5_init_context failed: %d", ret
);
1221 if (getarg(args
, sizeof(args
) / sizeof(args
[0]), argc
, argv
, &optidx
))
1228 print_version(NULL
);
1236 * Open the keytab now, we use the keytab to determine the principal's
1237 * realm when the requested principal has no realm.
1239 if (use_keytab
|| keytab_str
) {
1241 ret
= krb5_kt_resolve(context
, keytab_str
, &kt
);
1243 ret
= krb5_kt_default(context
, &kt
);
1245 krb5_err(context
, 1, ret
, "resolving keytab");
1248 if (pk_enterprise_flag
) {
1249 ret
= krb5_pk_enterprise_cert(context
, pk_user_id
,
1250 argv
[0], &principal
,
1253 krb5_err(context
, 1, ret
, "krb5_pk_enterprise_certs");
1257 } else if (anonymous_flag
) {
1259 ret
= krb5_make_principal(context
, &principal
, argv
[0],
1260 KRB5_WELLKNOWN_NAME
, KRB5_ANON_NAME
,
1263 krb5_err(context
, 1, ret
, "krb5_make_principal");
1264 krb5_principal_set_type(context
, principal
, KRB5_NT_WELLKNOWN
);
1266 } else if (use_keytab
|| keytab_str
) {
1267 get_princ_kt(context
, &principal
, argv
[0]);
1269 get_princ(context
, &principal
, argv
[0]);
1273 krb5_set_fcache_version(context
, fcache_version
);
1275 if (renewable_flag
== -1)
1276 /* this seems somewhat pointless, but whatever */
1277 krb5_appdefault_boolean(context
, "kinit",
1278 krb5_principal_get_realm(context
, principal
),
1279 "renewable", FALSE
, &renewable_flag
);
1280 if (do_afslog
== -1)
1281 krb5_appdefault_boolean(context
, "kinit",
1282 krb5_principal_get_realm(context
, principal
),
1283 "afslog", TRUE
, &do_afslog
);
1286 ret
= krb5_cc_resolve(context
, cred_cache
, &ccache
);
1290 ret
= krb5_cc_new_unique(context
, NULL
, NULL
, &ccache
);
1292 krb5_err(context
, 1, ret
, "creating cred cache");
1293 snprintf(s
, sizeof(s
), "%s:%s",
1294 krb5_cc_get_type(context
, ccache
),
1295 krb5_cc_get_name(context
, ccache
));
1296 setenv("KRB5CCNAME", s
, 1);
1298 ret
= krb5_cc_cache_match(context
, principal
, &ccache
);
1301 ret
= krb5_cc_default(context
, &ccache
);
1303 krb5_err(context
, 1, ret
,
1304 N_("resolving credentials cache", ""));
1307 * Check if the type support switching, and we do,
1308 * then do that instead over overwriting the current
1309 * default credential
1311 type
= krb5_cc_get_type(context
, ccache
);
1312 if (krb5_cc_support_switch(context
, type
)) {
1313 krb5_cc_close(context
, ccache
);
1314 ret
= get_switched_ccache(context
, type
, principal
,
1321 krb5_err(context
, 1, ret
, N_("resolving credentials cache", ""));
1324 if (argc
> 1 && k_hasafs())
1329 int tmp
= parse_time(lifetime
, "s");
1331 errx(1, N_("unparsable time: %s", ""), lifetime
);
1336 if (addrs_flag
== 0 && extra_addresses
.num_strings
> 0)
1337 krb5_errx(context
, 1,
1338 N_("specifying both extra addresses and "
1339 "no addresses makes no sense", ""));
1342 krb5_addresses addresses
;
1343 memset(&addresses
, 0, sizeof(addresses
));
1344 for(i
= 0; i
< extra_addresses
.num_strings
; i
++) {
1345 ret
= krb5_parse_address(context
, extra_addresses
.strings
[i
],
1348 krb5_add_extra_addresses(context
, &addresses
);
1349 krb5_free_addresses(context
, &addresses
);
1352 free_getarg_strings(&extra_addresses
);
1355 if (renew_flag
|| validate_flag
) {
1356 ret
= renew_validate(context
, renew_flag
, validate_flag
,
1357 ccache
, server_str
, ticket_life
);
1360 if (ret
== 0 && server_str
== NULL
&& do_afslog
&& k_hasafs())
1361 krb5_afslog(context
, ccache
, NULL
, NULL
);
1367 ret
= get_new_tickets(context
, principal
, ccache
, ticket_life
, 1);
1372 if (ret
== 0 && server_str
== NULL
&& do_afslog
&& k_hasafs())
1373 krb5_afslog(context
, ccache
, NULL
, NULL
);
1377 struct renew_ctx ctx
;
1380 timeout
= ticket_lifetime(context
, ccache
, principal
,
1381 server_str
, NULL
) / 2;
1383 ctx
.context
= context
;
1384 ctx
.ccache
= ccache
;
1385 ctx
.principal
= principal
;
1386 ctx
.ticket_life
= ticket_life
;
1387 ctx
.timeout
= timeout
;
1389 #ifdef HAVE_SIGACTION
1390 memset(&sa
, 0, sizeof(sa
));
1391 sigemptyset(&sa
.sa_mask
);
1392 sa
.sa_handler
= handle_siginfo
;
1394 sigaction(SIGINFO
, &sa
, NULL
);
1397 ret
= simple_execvp_timed(argv
[1], argv
+1,
1398 renew_func
, &ctx
, timeout
);
1399 #define EX_NOEXEC 126
1400 #define EX_NOTFOUND 127
1401 if (ret
== EX_NOEXEC
)
1402 krb5_warnx(context
, N_("permission denied: %s", ""), argv
[1]);
1403 else if (ret
== EX_NOTFOUND
)
1404 krb5_warnx(context
, N_("command not found: %s", ""), argv
[1]);
1406 krb5_cc_destroy(context
, ccache
);
1412 krb5_cc_close(context
, ccache
);
1415 krb5_free_principal(context
, principal
);
1417 krb5_kt_close(context
, kt
);
1418 krb5_free_context(context
);