Make master build on Windows
[heimdal.git] / lib / krb5 / kuserok.c
blobc6f887102b5521350b6924902af5675d04d671f9
1 /*
2 * Copyright (c) 1997 - 2005 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
4 * All rights reserved.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * 3. Neither the name of the Institute nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 * SUCH DAMAGE.
34 #include "krb5_locl.h"
35 #include "kuserok_plugin.h"
36 #include <dirent.h>
38 #ifndef SYSTEM_K5LOGIN_DIR
40 * System k5login location. File namess in this directory are expected
41 * to be usernames and to contain a list of principals allowed to login
42 * as the user named the same as the file.
44 #define SYSTEM_K5LOGIN_DIR SYSCONFDIR "/k5login.d"
45 #endif
47 /* Plugin framework bits */
49 struct plctx {
50 const char *rule;
51 const char *k5login_dir;
52 const char *luser;
53 krb5_const_principal principal;
54 unsigned int flags;
55 krb5_boolean result;
58 static krb5_error_code
59 plcallback(krb5_context context, const void *plug, void *plugctx, void *userctx)
61 const krb5plugin_kuserok_ftable *locate = plug;
62 struct plctx *plctx = userctx;
64 return locate->kuserok(plugctx, context, plctx->rule, plctx->flags,
65 plctx->k5login_dir, plctx->luser, plctx->principal,
66 &plctx->result);
69 static krb5_error_code plugin_reg_ret;
70 static krb5plugin_kuserok_ftable kuserok_simple_plug;
71 static krb5plugin_kuserok_ftable kuserok_sys_k5login_plug;
72 static krb5plugin_kuserok_ftable kuserok_user_k5login_plug;
73 static krb5plugin_kuserok_ftable kuserok_deny_plug;
75 static void
76 reg_def_plugins_once(void *ctx)
78 krb5_error_code ret;
79 krb5_context context = ctx;
81 plugin_reg_ret = krb5_plugin_register(context, PLUGIN_TYPE_DATA,
82 KRB5_PLUGIN_KUSEROK,
83 &kuserok_simple_plug);
84 ret = krb5_plugin_register(context, PLUGIN_TYPE_DATA,
85 KRB5_PLUGIN_KUSEROK, &kuserok_sys_k5login_plug);
86 if (!plugin_reg_ret)
87 plugin_reg_ret = ret;
88 ret = krb5_plugin_register(context, PLUGIN_TYPE_DATA,
89 KRB5_PLUGIN_KUSEROK, &kuserok_user_k5login_plug);
90 if (!plugin_reg_ret)
91 plugin_reg_ret = ret;
92 ret = krb5_plugin_register(context, PLUGIN_TYPE_DATA,
93 KRB5_PLUGIN_KUSEROK, &kuserok_deny_plug);
94 if (!plugin_reg_ret)
95 plugin_reg_ret = ret;
98 /**
99 * This function is designed to be portable for Win32 and POSIX. The
100 * design does lead to multiple getpwnam_r() calls, but this is probably
101 * not a big deal.
103 * Inputs:
105 * @param context A krb5_context
106 * @param filename Name of item to introspection
107 * @param is_system_location TRUE if the dir/file are system locations or
108 * FALSE if they are user home directory locations
109 * @param dir Directory (optional)
110 * @param dirlstat A pointer to struct stat for the directory (optional)
111 * @param file File (optional)
112 * @param owner Name of user that is expected to own the file
115 static krb5_error_code
116 check_owner_dir(krb5_context context,
117 const char *filename,
118 krb5_boolean is_system_location,
119 DIR *dir,
120 struct stat *dirlstat,
121 const char *owner)
123 #ifdef _WIN32
125 * XXX Implement this!
127 * The thing to do is to call _get_osfhandle() on fileno(file) and
128 * dirfd(dir) to get HANDLEs to the same, then call
129 * GetSecurityInfo() on those HANDLEs to get the security descriptor
130 * (SD), then check the owner and DACL. Checking the DACL sounds
131 * like a lot of work (what, derive a mode from the ACL the way
132 * NFSv4 servers do?). Checking the owner means doing an LSARPC
133 * lookup at least (to get the user's SID).
135 if (is_system_location || owner == NULL)
136 return 0;
137 krb5_set_error_message(context, EACCES,
138 "User k5login files not supported on Windows");
139 return EACCES;
140 #else
141 struct passwd pw, *pwd = NULL;
142 char pwbuf[2048];
143 struct stat st;
145 heim_assert(owner != NULL, "no directory owner ?");
147 if (rk_getpwnam_r(owner, &pw, pwbuf, sizeof(pwbuf), &pwd) != 0) {
148 krb5_set_error_message(context, errno,
149 "User unknown %s (getpwnam_r())", owner);
150 return EACCES;
152 if (pwd == NULL) {
153 krb5_set_error_message(context, EACCES, "no user %s", owner);
154 return EACCES;
157 if (fstat(dirfd(dir), &st) == -1) {
158 krb5_set_error_message(context, EACCES,
159 "fstat(%s) of k5login.d failed",
160 filename);
161 return EACCES;
163 if (!S_ISDIR(st.st_mode)) {
164 krb5_set_error_message(context, ENOTDIR, "%s not a directory",
165 filename);
166 return ENOTDIR;
168 if (st.st_dev != dirlstat->st_dev || st.st_ino != dirlstat->st_ino) {
169 krb5_set_error_message(context, EACCES,
170 "%s was renamed during kuserok "
171 "operation", filename);
172 return EACCES;
174 if ((st.st_mode & (S_IWGRP | S_IWOTH)) != 0) {
175 krb5_set_error_message(context, EACCES,
176 "%s has world and/or group write "
177 "permissions", filename);
178 return EACCES;
180 if (pwd->pw_uid != st.st_uid && st.st_uid != 0) {
181 krb5_set_error_message(context, EACCES,
182 "%s not owned by the user (%s) or root",
183 filename, owner);
184 return EACCES;
187 return 0;
188 #endif
191 static krb5_error_code
192 check_owner_file(krb5_context context,
193 const char *filename,
194 FILE *file, const char *owner)
196 #ifdef _WIN32
198 * XXX Implement this!
200 * The thing to do is to call _get_osfhandle() on fileno(file) and
201 * dirfd(dir) to get HANDLEs to the same, then call
202 * GetSecurityInfo() on those HANDLEs to get the security descriptor
203 * (SD), then check the owner and DACL. Checking the DACL sounds
204 * like a lot of work (what, derive a mode from the ACL the way
205 * NFSv4 servers do?). Checking the owner means doing an LSARPC
206 * lookup at least (to get the user's SID).
208 if (owner == NULL)
209 return 0;
211 krb5_set_error_message(context, EACCES,
212 "User k5login files not supported on Windows");
213 return EACCES;
214 #else
215 struct passwd pw, *pwd = NULL;
216 char pwbuf[2048];
217 struct stat st;
219 if (owner == NULL)
220 return 0;
222 if (rk_getpwnam_r(owner, &pw, pwbuf, sizeof(pwbuf), &pwd) != 0) {
223 krb5_set_error_message(context, errno,
224 "User unknown %s (getpwnam_r())", owner);
225 return EACCES;
227 if (pwd == NULL) {
228 krb5_set_error_message(context, EACCES, "no user %s", owner);
229 return EACCES;
232 if (fstat(fileno(file), &st) == -1) {
233 krb5_set_error_message(context, EACCES, "fstat(%s) of k5login failed",
234 filename);
235 return EACCES;
237 if (S_ISDIR(st.st_mode)) {
238 krb5_set_error_message(context, EISDIR, "k5login: %s is a directory",
239 filename);
240 return EISDIR;
242 if ((st.st_mode & (S_IWGRP | S_IWOTH)) != 0) {
243 krb5_set_error_message(context, EISDIR,
244 "k5login %s has world and/or group write "
245 "permissions", filename);
246 return EACCES;
248 if (pwd->pw_uid != st.st_uid && st.st_uid != 0) {
249 krb5_set_error_message(context, EACCES,
250 "k5login %s not owned by the user or root",
251 filename);
252 return EACCES;
255 return 0;
256 #endif
260 /* see if principal is mentioned in the filename access file, return
261 TRUE (in result) if so, FALSE otherwise */
263 static krb5_error_code
264 check_one_file(krb5_context context,
265 const char *filename,
266 const char *owner,
267 krb5_boolean is_system_location,
268 krb5_const_principal principal,
269 krb5_boolean *result)
271 FILE *f;
272 char buf[BUFSIZ];
273 krb5_error_code ret;
275 *result = FALSE;
277 f = fopen(filename, "r");
278 if (f == NULL)
279 return errno;
280 rk_cloexec_file(f);
282 ret = check_owner_file(context, filename, f, owner);
283 if (ret)
284 goto out;
286 while (fgets(buf, sizeof(buf), f) != NULL) {
287 krb5_principal tmp;
288 char *newline = buf + strcspn(buf, "\n");
290 if (*newline != '\n') {
291 int c;
292 c = fgetc(f);
293 if (c != EOF) {
294 while (c != EOF && c != '\n')
295 c = fgetc(f);
296 /* line was too long, so ignore it */
297 continue;
300 *newline = '\0';
301 ret = krb5_parse_name(context, buf, &tmp);
302 if (ret)
303 continue;
304 *result = krb5_principal_compare(context, principal, tmp);
305 krb5_free_principal(context, tmp);
306 if (*result) {
307 fclose (f);
308 return 0;
312 out:
313 fclose(f);
314 return 0;
317 static krb5_error_code
318 check_directory(krb5_context context,
319 const char *dirname,
320 const char *owner,
321 krb5_boolean is_system_location,
322 krb5_const_principal principal,
323 krb5_boolean *result)
325 DIR *d;
326 struct dirent *dent;
327 char filename[MAXPATHLEN];
328 krb5_error_code ret = 0;
329 struct stat st;
331 *result = FALSE;
333 if (lstat(dirname, &st) < 0)
334 return errno;
336 if (!S_ISDIR(st.st_mode)) {
337 krb5_set_error_message(context, ENOTDIR, "k5login.d not a directory");
338 return ENOTDIR;
341 if ((d = opendir(dirname)) == NULL) {
342 krb5_set_error_message(context, ENOTDIR, "Could not open k5login.d");
343 return errno;
346 ret = check_owner_dir(context, dirname, is_system_location, d, &st, owner);
347 if (ret)
348 goto out;
350 while ((dent = readdir(d)) != NULL) {
351 if (strcmp(dent->d_name, ".") == 0 ||
352 strcmp(dent->d_name, "..") == 0 ||
353 dent->d_name[0] == '#' || /* emacs autosave */
354 dent->d_name[strlen(dent->d_name) - 1] == '~') /* emacs backup */
355 continue;
356 snprintf(filename, sizeof(filename), "%s/%s", dirname, dent->d_name);
357 ret = check_one_file(context, filename, owner, is_system_location,
358 principal, result);
359 if (ret == 0 && *result == TRUE)
360 break;
361 ret = 0; /* don't propagate errors upstream */
364 out:
365 closedir(d);
366 return ret;
369 static krb5_error_code
370 check_an2ln(krb5_context context,
371 krb5_const_principal principal,
372 const char *luser,
373 krb5_boolean *result)
375 krb5_error_code ret;
376 char *lname;
378 #if 0
379 /* XXX Should we make this an option? */
380 /* multi-component principals can never match */
381 if (krb5_principal_get_comp_string(context, principal, 1) != NULL) {
382 *result = FALSE;
383 return 0;
385 #endif
387 lname = malloc(strlen(luser) + 1);
388 if (lname == NULL)
389 return krb5_enomem(context);
390 ret = krb5_aname_to_localname(context, principal, strlen(luser)+1, lname);
391 if (ret)
392 goto out;
393 if (strcmp(lname, luser) == 0)
394 *result = TRUE;
395 else
396 *result = FALSE;
398 out:
399 free(lname);
400 return 0;
405 * This function takes the name of a local user and checks if
406 * principal is allowed to log in as that user.
408 * The user may have a ~/.k5login file listing principals that are
409 * allowed to login as that user. If that file does not exist, all
410 * principals with a only one component that is identical to the
411 * username, and a realm considered local, are allowed access.
413 * The .k5login file must contain one principal per line, be owned by
414 * user and not be writable by group or other (but must be readable by
415 * anyone).
417 * Note that if the file exists, no implicit access rights are given
418 * to user@@LOCALREALM.
420 * Optionally, a set of files may be put in ~/.k5login.d (a
421 * directory), in which case they will all be checked in the same
422 * manner as .k5login. The files may be called anything, but files
423 * starting with a hash (#) , or ending with a tilde (~) are
424 * ignored. Subdirectories are not traversed. Note that this directory
425 * may not be checked by other Kerberos implementations.
427 * If no configuration file exists, match user against local domains,
428 * ie luser@@LOCAL-REALMS-IN-CONFIGURATION-FILES.
430 * @param context Kerberos 5 context.
431 * @param principal principal to check if allowed to login
432 * @param luser local user id
434 * @return returns TRUE if access should be granted, FALSE otherwise.
436 * @ingroup krb5_support
439 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
440 krb5_kuserok(krb5_context context,
441 krb5_principal principal,
442 const char *luser)
444 return _krb5_kuserok(context, principal, luser, TRUE);
448 KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
449 _krb5_kuserok(krb5_context context,
450 krb5_principal principal,
451 const char *luser,
452 krb5_boolean an2ln_ok)
454 static heim_base_once_t reg_def_plugins = HEIM_BASE_ONCE_INIT;
455 krb5_error_code ret;
456 struct plctx ctx;
457 char **rules;
460 * XXX we should have a struct with a krb5_context field and a
461 * krb5_error_code fied and pass the address of that as the ctx
462 * argument of heim_base_once_f(). For now we use a static to
463 * communicate failures. Actually, we ignore failures anyways,
464 * since we can't return them.
466 heim_base_once_f(&reg_def_plugins, context, reg_def_plugins_once);
468 ctx.flags = 0;
469 ctx.luser = luser;
470 ctx.principal = principal;
471 ctx.result = FALSE;
473 ctx.k5login_dir = krb5_config_get_string(context, NULL, "libdefaults",
474 "k5login_directory", NULL);
476 if (an2ln_ok)
477 ctx.flags |= KUSEROK_ANAME_TO_LNAME_OK;
479 if (krb5_config_get_bool_default(context, NULL, FALSE, "libdefaults",
480 "k5login_authoritative", NULL))
481 ctx.flags |= KUSEROK_K5LOGIN_IS_AUTHORITATIVE;
483 if ((ctx.flags & KUSEROK_K5LOGIN_IS_AUTHORITATIVE) && plugin_reg_ret)
484 return plugin_reg_ret; /* fail safe */
486 rules = krb5_config_get_strings(context, NULL, "libdefaults",
487 "kuserok", NULL);
488 if (rules == NULL) {
489 /* Default: check ~/.k5login */
490 ctx.rule = "USER-K5LOGIN";
492 ret = plcallback(context, &kuserok_user_k5login_plug, NULL, &ctx);
493 if (ret == 0)
494 goto out;
496 ctx.rule = "SIMPLE";
497 ret = plcallback(context, &kuserok_simple_plug, NULL, &ctx);
498 if (ret == 0)
499 goto out;
501 ctx.result = FALSE;
502 } else {
503 size_t n;
505 for (n = 0; rules[n]; n++) {
506 ctx.rule = rules[n];
508 ret = _krb5_plugin_run_f(context, "krb5", KRB5_PLUGIN_KUSEROK,
509 KRB5_PLUGIN_KUSEROK_VERSION_0, 0,
510 &ctx, plcallback);
511 if (ret != KRB5_PLUGIN_NO_HANDLE)
512 goto out;
516 out:
517 krb5_config_free_strings(rules);
519 return ctx.result;
523 * Simple kuserok: check that the lname for the aname matches luser.
526 static krb5_error_code
527 kuserok_simple_plug_f(void *plug_ctx, krb5_context context, const char *rule,
528 unsigned int flags, const char *k5login_dir,
529 const char *luser, krb5_const_principal principal,
530 krb5_boolean *result)
532 krb5_error_code ret;
534 if (strcmp(rule, "SIMPLE") != 0 || (flags & KUSEROK_ANAME_TO_LNAME_OK) == 0)
535 return KRB5_PLUGIN_NO_HANDLE;
537 ret = check_an2ln(context, principal, luser, result);
538 if (ret == 0 && *result == FALSE)
539 return KRB5_PLUGIN_NO_HANDLE;
541 return 0;
545 * Check k5login files in a system location, rather than in home
546 * directories.
549 static krb5_error_code
550 kuserok_sys_k5login_plug_f(void *plug_ctx, krb5_context context,
551 const char *rule, unsigned int flags,
552 const char *k5login_dir, const char *luser,
553 krb5_const_principal principal, krb5_boolean *result)
555 char *path = NULL;
556 const char *profile_dir = NULL;
557 krb5_error_code ret;
559 *result = FALSE;
561 if (strcmp(rule, "SYSTEM-K5LOGIN") != 0 &&
562 strncmp(rule, "SYSTEM-K5LOGIN:", strlen("SYSTEM-K5LOGIN:")) != 0)
563 return KRB5_PLUGIN_NO_HANDLE;
565 profile_dir = strchr(rule, ':');
566 if (profile_dir == NULL)
567 profile_dir = k5login_dir ? k5login_dir : SYSTEM_K5LOGIN_DIR;
568 else
569 profile_dir++;
571 ret = _krb5_expand_path_tokensv(context, profile_dir, &path,
572 "luser", luser, NULL);
573 if (ret)
574 return ret;
576 ret = check_one_file(context, path, NULL, TRUE, principal, result);
577 free(path);
579 if (ret == 0 &&
580 ((flags & KUSEROK_K5LOGIN_IS_AUTHORITATIVE) || *result == TRUE))
581 return 0;
583 *result = FALSE;
584 return KRB5_PLUGIN_NO_HANDLE;
588 * Check ~luser/.k5login and/or ~/luser/.k5login.d
591 static krb5_error_code
592 kuserok_user_k5login_plug_f(void *plug_ctx, krb5_context context,
593 const char *rule, unsigned int flags,
594 const char *k5login_dir, const char *luser,
595 krb5_const_principal principal,
596 krb5_boolean *result)
598 #ifdef _WIN32
599 return KRB5_PLUGIN_NO_HANDLE;
600 #else
601 char *path;
602 char *path_exp;
603 const char *profile_dir = NULL;
604 krb5_error_code ret;
605 krb5_boolean found_file = FALSE;
606 struct passwd pw, *pwd = NULL;
607 char pwbuf[2048];
609 if (strcmp(rule, "USER-K5LOGIN") != 0)
610 return KRB5_PLUGIN_NO_HANDLE;
612 profile_dir = k5login_dir;
613 if (profile_dir == NULL) {
614 /* Don't deadlock with gssd or anything of the sort */
615 if (!_krb5_homedir_access(context))
616 return KRB5_PLUGIN_NO_HANDLE;
618 if (getpwnam_r(luser, &pw, pwbuf, sizeof(pwbuf), &pwd) != 0) {
619 krb5_set_error_message(context, errno, "User unknown (getpwnam_r())");
620 return KRB5_PLUGIN_NO_HANDLE;
622 if (pwd == NULL) {
623 krb5_set_error_message(context, errno, "User unknown (getpwnam())");
624 return KRB5_PLUGIN_NO_HANDLE;
626 profile_dir = pwd->pw_dir;
629 #define KLOGIN "/.k5login"
631 if (asprintf(&path, "%s/.k5login.d", profile_dir) == -1)
632 return krb5_enomem(context);
634 ret = _krb5_expand_path_tokensv(context, path, &path_exp,
635 "luser", luser, NULL);
636 free(path);
637 if (ret)
638 return ret;
639 path = path_exp;
641 /* check user's ~/.k5login */
642 path[strlen(path) - strlen(".d")] = '\0';
643 ret = check_one_file(context, path, luser, FALSE, principal, result);
645 if (ret == 0 &&
646 ((flags & KUSEROK_K5LOGIN_IS_AUTHORITATIVE) || *result == TRUE)) {
647 free(path);
648 return 0;
651 if (ret != ENOENT)
652 found_file = TRUE;
654 path[strlen(path)] = '.'; /* put back the .d; clever|hackish? you decide */
655 ret = check_directory(context, path, luser, FALSE, principal, result);
656 free(path);
657 if (ret == 0 &&
658 ((flags & KUSEROK_K5LOGIN_IS_AUTHORITATIVE) || *result == TRUE))
659 return 0;
661 if (ret != ENOENT && ret != ENOTDIR)
662 found_file = TRUE;
664 *result = FALSE;
665 if (found_file == FALSE)
666 return KRB5_PLUGIN_NO_HANDLE;
668 return 0;
669 #endif
672 static krb5_error_code
673 kuserok_deny_plug_f(void *plug_ctx, krb5_context context, const char *rule,
674 unsigned int flags, const char *k5login_dir,
675 const char *luser, krb5_const_principal principal,
676 krb5_boolean *result)
678 if (strcmp(rule, "DENY") != 0)
679 return KRB5_PLUGIN_NO_HANDLE;
681 *result = FALSE;
682 return 0;
685 static krb5_error_code
686 kuser_ok_null_plugin_init(krb5_context context, void **ctx)
688 *ctx = NULL;
689 return 0;
692 static void
693 kuser_ok_null_plugin_fini(void *ctx)
695 return;
698 static krb5plugin_kuserok_ftable kuserok_simple_plug = {
699 KRB5_PLUGIN_KUSEROK_VERSION_0,
700 kuser_ok_null_plugin_init,
701 kuser_ok_null_plugin_fini,
702 kuserok_simple_plug_f,
705 static krb5plugin_kuserok_ftable kuserok_sys_k5login_plug = {
706 KRB5_PLUGIN_KUSEROK_VERSION_0,
707 kuser_ok_null_plugin_init,
708 kuser_ok_null_plugin_fini,
709 kuserok_sys_k5login_plug_f,
712 static krb5plugin_kuserok_ftable kuserok_user_k5login_plug = {
713 KRB5_PLUGIN_KUSEROK_VERSION_0,
714 kuser_ok_null_plugin_init,
715 kuser_ok_null_plugin_fini,
716 kuserok_user_k5login_plug_f,
719 static krb5plugin_kuserok_ftable kuserok_deny_plug = {
720 KRB5_PLUGIN_KUSEROK_VERSION_0,
721 kuser_ok_null_plugin_init,
722 kuser_ok_null_plugin_fini,
723 kuserok_deny_plug_f,