1 /* $NetBSD: init_creds.c,v 1.1.1.2 2014/04/24 12:45:50 pettai Exp $ */
4 * Copyright (c) 1997 - 2004 Kungliga Tekniska Högskolan
5 * (Royal Institute of Technology, Stockholm, Sweden).
8 * Portions Copyright (c) 2009 Apple Inc. All rights reserved.
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
21 * 3. Neither the name of the Institute nor the names of its contributors
22 * may be used to endorse or promote products derived from this software
23 * without specific prior written permission.
25 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 #include "krb5_locl.h"
41 #define __attribute__(x)
44 * @page krb5_init_creds_intro The initial credential handing functions
45 * @section section_krb5_init_creds Initial credential
47 * Functions to get initial credentials: @ref krb5_credential .
51 * Allocate a new krb5_get_init_creds_opt structure, free with
52 * krb5_get_init_creds_opt_free().
54 * @ingroup krb5_credential
57 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
58 krb5_get_init_creds_opt_alloc(krb5_context context
,
59 krb5_get_init_creds_opt
**opt
)
61 krb5_get_init_creds_opt
*o
;
64 o
= calloc(1, sizeof(*o
));
66 krb5_set_error_message(context
, ENOMEM
,
67 N_("malloc: out of memory", ""));
71 o
->opt_private
= calloc(1, sizeof(*o
->opt_private
));
72 if (o
->opt_private
== NULL
) {
73 krb5_set_error_message(context
, ENOMEM
,
74 N_("malloc: out of memory", ""));
78 o
->opt_private
->refcount
= 1;
84 * Free krb5_get_init_creds_opt structure.
86 * @ingroup krb5_credential
89 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
90 krb5_get_init_creds_opt_free(krb5_context context
,
91 krb5_get_init_creds_opt
*opt
)
93 if (opt
== NULL
|| opt
->opt_private
== NULL
)
95 if (opt
->opt_private
->refcount
< 1) /* abort ? */
97 if (--opt
->opt_private
->refcount
== 0) {
98 _krb5_get_init_creds_opt_free_pkinit(opt
);
99 free(opt
->opt_private
);
101 memset(opt
, 0, sizeof(*opt
));
106 get_config_time (krb5_context context
,
113 ret
= krb5_config_get_time (context
, NULL
,
120 ret
= krb5_config_get_time (context
, NULL
,
130 get_config_bool (krb5_context context
,
131 krb5_boolean def_value
,
137 b
= krb5_config_get_bool_default(context
, NULL
, def_value
,
138 "realms", realm
, name
, NULL
);
141 b
= krb5_config_get_bool_default (context
, NULL
, def_value
,
142 "libdefaults", name
, NULL
);
149 * set all the values in `opt' to the appropriate values for
150 * application `appname' (default to getprogname() if NULL), and realm
151 * `realm'. First looks in [appdefaults] but falls back to
152 * [realms] or [libdefaults] for some of the values.
155 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
156 krb5_get_init_creds_opt_set_default_flags(krb5_context context
,
158 krb5_const_realm realm
,
159 krb5_get_init_creds_opt
*opt
)
164 b
= get_config_bool (context
, KRB5_FORWARDABLE_DEFAULT
,
165 realm
, "forwardable");
166 krb5_appdefault_boolean(context
, appname
, realm
, "forwardable", b
, &b
);
167 krb5_get_init_creds_opt_set_forwardable(opt
, b
);
169 b
= get_config_bool (context
, FALSE
, realm
, "proxiable");
170 krb5_appdefault_boolean(context
, appname
, realm
, "proxiable", b
, &b
);
171 krb5_get_init_creds_opt_set_proxiable (opt
, b
);
173 krb5_appdefault_time(context
, appname
, realm
, "ticket_lifetime", 0, &t
);
175 t
= get_config_time (context
, realm
, "ticket_lifetime", 0);
177 krb5_get_init_creds_opt_set_tkt_life(opt
, t
);
179 krb5_appdefault_time(context
, appname
, realm
, "renew_lifetime", 0, &t
);
181 t
= get_config_time (context
, realm
, "renew_lifetime", 0);
183 krb5_get_init_creds_opt_set_renew_life(opt
, t
);
185 krb5_appdefault_boolean(context
, appname
, realm
, "no-addresses",
186 KRB5_ADDRESSLESS_DEFAULT
, &b
);
187 krb5_get_init_creds_opt_set_addressless (context
, opt
, b
);
190 krb5_appdefault_boolean(context
, appname
, realm
, "anonymous", FALSE
, &b
);
191 krb5_get_init_creds_opt_set_anonymous (opt
, b
);
193 krb5_get_init_creds_opt_set_etype_list(opt
, enctype
,
194 etype_str
.num_strings
);
196 krb5_get_init_creds_opt_set_salt(krb5_get_init_creds_opt
*opt
,
199 krb5_get_init_creds_opt_set_preauth_list(krb5_get_init_creds_opt
*opt
,
200 krb5_preauthtype
*preauth_list
,
201 int preauth_list_length
);
206 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
207 krb5_get_init_creds_opt_set_tkt_life(krb5_get_init_creds_opt
*opt
,
208 krb5_deltat tkt_life
)
210 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_TKT_LIFE
;
211 opt
->tkt_life
= tkt_life
;
214 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
215 krb5_get_init_creds_opt_set_renew_life(krb5_get_init_creds_opt
*opt
,
216 krb5_deltat renew_life
)
218 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_RENEW_LIFE
;
219 opt
->renew_life
= renew_life
;
222 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
223 krb5_get_init_creds_opt_set_forwardable(krb5_get_init_creds_opt
*opt
,
226 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_FORWARDABLE
;
227 opt
->forwardable
= forwardable
;
230 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
231 krb5_get_init_creds_opt_set_proxiable(krb5_get_init_creds_opt
*opt
,
234 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_PROXIABLE
;
235 opt
->proxiable
= proxiable
;
238 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
239 krb5_get_init_creds_opt_set_etype_list(krb5_get_init_creds_opt
*opt
,
240 krb5_enctype
*etype_list
,
241 int etype_list_length
)
243 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_ETYPE_LIST
;
244 opt
->etype_list
= etype_list
;
245 opt
->etype_list_length
= etype_list_length
;
248 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
249 krb5_get_init_creds_opt_set_address_list(krb5_get_init_creds_opt
*opt
,
250 krb5_addresses
*addresses
)
252 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_ADDRESS_LIST
;
253 opt
->address_list
= addresses
;
256 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
257 krb5_get_init_creds_opt_set_preauth_list(krb5_get_init_creds_opt
*opt
,
258 krb5_preauthtype
*preauth_list
,
259 int preauth_list_length
)
261 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_PREAUTH_LIST
;
262 opt
->preauth_list_length
= preauth_list_length
;
263 opt
->preauth_list
= preauth_list
;
266 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
267 krb5_get_init_creds_opt_set_salt(krb5_get_init_creds_opt
*opt
,
270 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_SALT
;
274 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
275 krb5_get_init_creds_opt_set_anonymous(krb5_get_init_creds_opt
*opt
,
278 opt
->flags
|= KRB5_GET_INIT_CREDS_OPT_ANONYMOUS
;
279 opt
->anonymous
= anonymous
;
282 static krb5_error_code
283 require_ext_opt(krb5_context context
,
284 krb5_get_init_creds_opt
*opt
,
287 if (opt
->opt_private
== NULL
) {
288 krb5_set_error_message(context
, EINVAL
,
289 N_("%s on non extendable opt", ""), type
);
295 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
296 krb5_get_init_creds_opt_set_pa_password(krb5_context context
,
297 krb5_get_init_creds_opt
*opt
,
298 const char *password
,
299 krb5_s2k_proc key_proc
)
302 ret
= require_ext_opt(context
, opt
, "init_creds_opt_set_pa_password");
305 opt
->opt_private
->password
= password
;
306 opt
->opt_private
->key_proc
= key_proc
;
310 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
311 krb5_get_init_creds_opt_set_pac_request(krb5_context context
,
312 krb5_get_init_creds_opt
*opt
,
313 krb5_boolean req_pac
)
316 ret
= require_ext_opt(context
, opt
, "init_creds_opt_set_pac_req");
319 opt
->opt_private
->req_pac
= req_pac
?
320 KRB5_INIT_CREDS_TRISTATE_TRUE
:
321 KRB5_INIT_CREDS_TRISTATE_FALSE
;
325 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
326 krb5_get_init_creds_opt_set_addressless(krb5_context context
,
327 krb5_get_init_creds_opt
*opt
,
328 krb5_boolean addressless
)
331 ret
= require_ext_opt(context
, opt
, "init_creds_opt_set_pac_req");
335 opt
->opt_private
->addressless
= KRB5_INIT_CREDS_TRISTATE_TRUE
;
337 opt
->opt_private
->addressless
= KRB5_INIT_CREDS_TRISTATE_FALSE
;
341 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
342 krb5_get_init_creds_opt_set_canonicalize(krb5_context context
,
343 krb5_get_init_creds_opt
*opt
,
347 ret
= require_ext_opt(context
, opt
, "init_creds_opt_set_canonicalize");
351 opt
->opt_private
->flags
|= KRB5_INIT_CREDS_CANONICALIZE
;
353 opt
->opt_private
->flags
&= ~KRB5_INIT_CREDS_CANONICALIZE
;
357 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
358 krb5_get_init_creds_opt_set_win2k(krb5_context context
,
359 krb5_get_init_creds_opt
*opt
,
363 ret
= require_ext_opt(context
, opt
, "init_creds_opt_set_win2k");
367 opt
->opt_private
->flags
|= KRB5_INIT_CREDS_NO_C_CANON_CHECK
;
368 opt
->opt_private
->flags
|= KRB5_INIT_CREDS_NO_C_NO_EKU_CHECK
;
370 opt
->opt_private
->flags
&= ~KRB5_INIT_CREDS_NO_C_CANON_CHECK
;
371 opt
->opt_private
->flags
&= ~KRB5_INIT_CREDS_NO_C_NO_EKU_CHECK
;
377 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
378 krb5_get_init_creds_opt_set_process_last_req(krb5_context context
,
379 krb5_get_init_creds_opt
*opt
,
380 krb5_gic_process_last_req func
,
384 ret
= require_ext_opt(context
, opt
, "init_creds_opt_set_win2k");
388 opt
->opt_private
->lr
.func
= func
;
389 opt
->opt_private
->lr
.ctx
= ctx
;
395 #ifndef HEIMDAL_SMALLER
398 * Deprecated: use krb5_get_init_creds_opt_alloc().
400 * The reason krb5_get_init_creds_opt_init() is deprecated is that
401 * krb5_get_init_creds_opt is a static structure and for ABI reason it
402 * can't grow, ie can't add new functionality.
404 * @ingroup krb5_deprecated
407 KRB5_LIB_FUNCTION
void KRB5_LIB_CALL
408 krb5_get_init_creds_opt_init(krb5_get_init_creds_opt
*opt
)
409 KRB5_DEPRECATED_FUNCTION("Use X instead")
411 memset (opt
, 0, sizeof(*opt
));
415 * Deprecated: use the new krb5_init_creds_init() and
416 * krb5_init_creds_get_error().
418 * @ingroup krb5_deprecated
421 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
422 krb5_get_init_creds_opt_get_error(krb5_context context
,
423 krb5_get_init_creds_opt
*opt
,
425 KRB5_DEPRECATED_FUNCTION("Use X instead")
427 *error
= calloc(1, sizeof(**error
));
428 if (*error
== NULL
) {
429 krb5_set_error_message(context
, ENOMEM
, N_("malloc: out of memory", ""));
436 #endif /* HEIMDAL_SMALLER */