Damien Miller | 8dbffe7 | 2006-08-05 11:02:17 +1000 | [diff] [blame^] | 1 | /* $OpenBSD: auth.c,v 1.73 2006/07/26 02:35:17 stevesk Exp $ */ |
Damien Miller | 116e6df | 2002-05-22 15:06:28 +1000 | [diff] [blame] | 2 | /* |
Ben Lindstrom | 92a2e38 | 2001-03-05 06:59:27 +0000 | [diff] [blame] | 3 | * Copyright (c) 2000 Markus Friedl. All rights reserved. |
Damien Miller | e4340be | 2000-09-16 13:29:08 +1100 | [diff] [blame] | 4 | * |
| 5 | * Redistribution and use in source and binary forms, with or without |
| 6 | * modification, are permitted provided that the following conditions |
| 7 | * are met: |
| 8 | * 1. Redistributions of source code must retain the above copyright |
| 9 | * notice, this list of conditions and the following disclaimer. |
| 10 | * 2. Redistributions in binary form must reproduce the above copyright |
| 11 | * notice, this list of conditions and the following disclaimer in the |
| 12 | * documentation and/or other materials provided with the distribution. |
| 13 | * |
| 14 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
| 15 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| 16 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
| 17 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
| 18 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
| 19 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 20 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 21 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 22 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
| 23 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 24 | */ |
| 25 | |
| 26 | #include "includes.h" |
Damien Miller | f17883e | 2006-03-15 11:45:54 +1100 | [diff] [blame] | 27 | |
| 28 | #include <sys/types.h> |
| 29 | #include <sys/stat.h> |
Damien Miller | 8dbffe7 | 2006-08-05 11:02:17 +1000 | [diff] [blame^] | 30 | #include <sys/param.h> |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 31 | |
Darren Tucker | 3997249 | 2006-07-12 22:22:46 +1000 | [diff] [blame] | 32 | #include <errno.h> |
Damien Miller | 03e2003 | 2006-03-15 11:16:59 +1100 | [diff] [blame] | 33 | #ifdef HAVE_PATHS_H |
Damien Miller | a9263d0 | 2006-03-15 11:18:26 +1100 | [diff] [blame] | 34 | # include <paths.h> |
Damien Miller | 03e2003 | 2006-03-15 11:16:59 +1100 | [diff] [blame] | 35 | #endif |
Damien Miller | 9f2abc4 | 2006-07-10 20:53:08 +1000 | [diff] [blame] | 36 | #include <pwd.h> |
Damien Miller | d2c208a | 2000-05-17 22:00:02 +1000 | [diff] [blame] | 37 | #ifdef HAVE_LOGIN_H |
| 38 | #include <login.h> |
| 39 | #endif |
Darren Tucker | 15ee748 | 2004-02-22 09:43:15 +1100 | [diff] [blame] | 40 | #ifdef USE_SHADOW |
Damien Miller | 1f335fb | 2000-06-26 11:31:33 +1000 | [diff] [blame] | 41 | #include <shadow.h> |
Darren Tucker | 15ee748 | 2004-02-22 09:43:15 +1100 | [diff] [blame] | 42 | #endif |
Ben Lindstrom | 68c3ce1 | 2001-06-10 17:24:51 +0000 | [diff] [blame] | 43 | #ifdef HAVE_LIBGEN_H |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 44 | #include <libgen.h> |
Ben Lindstrom | 68c3ce1 | 2001-06-10 17:24:51 +0000 | [diff] [blame] | 45 | #endif |
Darren Tucker | 5d19626 | 2006-07-12 22:15:16 +1000 | [diff] [blame] | 46 | #include <stdarg.h> |
Damien Miller | e3476ed | 2006-07-24 14:13:33 +1000 | [diff] [blame] | 47 | #include <string.h> |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 48 | |
Ben Lindstrom | 226cfa0 | 2001-01-22 05:34:40 +0000 | [diff] [blame] | 49 | #include "xmalloc.h" |
| 50 | #include "match.h" |
| 51 | #include "groupaccess.h" |
| 52 | #include "log.h" |
| 53 | #include "servconf.h" |
Damien Miller | efb4afe | 2000-04-12 18:45:05 +1000 | [diff] [blame] | 54 | #include "auth.h" |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 55 | #include "auth-options.h" |
Ben Lindstrom | 226cfa0 | 2001-01-22 05:34:40 +0000 | [diff] [blame] | 56 | #include "canohost.h" |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 57 | #include "buffer.h" |
| 58 | #include "bufaux.h" |
Ben Lindstrom | 83647ce | 2001-06-25 04:30:16 +0000 | [diff] [blame] | 59 | #include "uidswap.h" |
Ben Lindstrom | 7ebb635 | 2002-03-22 03:04:08 +0000 | [diff] [blame] | 60 | #include "misc.h" |
Ben Lindstrom | a574cda | 2002-05-15 16:16:14 +0000 | [diff] [blame] | 61 | #include "bufaux.h" |
| 62 | #include "packet.h" |
Darren Tucker | 42d9dc7 | 2005-02-02 17:10:11 +1100 | [diff] [blame] | 63 | #include "loginrec.h" |
Darren Tucker | 269a1ea | 2005-02-03 00:20:53 +1100 | [diff] [blame] | 64 | #include "monitor_wrap.h" |
Damien Miller | efb4afe | 2000-04-12 18:45:05 +1000 | [diff] [blame] | 65 | |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 66 | /* import */ |
| 67 | extern ServerOptions options; |
Damien Miller | 7a8f5b3 | 2006-03-31 23:14:23 +1100 | [diff] [blame] | 68 | extern int use_privsep; |
Darren Tucker | b9aa0a0 | 2003-07-08 22:59:59 +1000 | [diff] [blame] | 69 | extern Buffer loginmsg; |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 70 | |
Ben Lindstrom | a574cda | 2002-05-15 16:16:14 +0000 | [diff] [blame] | 71 | /* Debugging messages */ |
| 72 | Buffer auth_debug; |
| 73 | int auth_debug_init; |
| 74 | |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 75 | /* |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 76 | * Check if the user is allowed to log in via ssh. If user is listed |
| 77 | * in DenyUsers or one of user's groups is listed in DenyGroups, false |
| 78 | * will be returned. If AllowUsers isn't empty and user isn't listed |
| 79 | * there, or if AllowGroups isn't empty and one of user's groups isn't |
| 80 | * listed there, false will be returned. |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 81 | * If the user's shell is not executable, false will be returned. |
Damien Miller | 4af5130 | 2000-04-16 11:18:38 +1000 | [diff] [blame] | 82 | * Otherwise true is returned. |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 83 | */ |
Damien Miller | eba71ba | 2000-04-29 23:57:08 +1000 | [diff] [blame] | 84 | int |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 85 | allowed_user(struct passwd * pw) |
| 86 | { |
| 87 | struct stat st; |
Darren Tucker | 43a0dc6 | 2003-08-26 14:22:12 +1000 | [diff] [blame] | 88 | const char *hostname = NULL, *ipaddr = NULL, *passwd = NULL; |
Damien Miller | e7cf07c | 2001-03-20 09:15:57 +1100 | [diff] [blame] | 89 | char *shell; |
Damien Miller | eccb9de | 2005-06-17 12:59:34 +1000 | [diff] [blame] | 90 | u_int i; |
Darren Tucker | 15ee748 | 2004-02-22 09:43:15 +1100 | [diff] [blame] | 91 | #ifdef USE_SHADOW |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 92 | struct spwd *spw = NULL; |
Tim Rice | 458c6bf | 2003-01-08 20:04:27 -0800 | [diff] [blame] | 93 | #endif |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 94 | |
| 95 | /* Shouldn't be called if pw is NULL, but better safe than sorry... */ |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 96 | if (!pw || !pw->pw_name) |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 97 | return 0; |
| 98 | |
Darren Tucker | 15ee748 | 2004-02-22 09:43:15 +1100 | [diff] [blame] | 99 | #ifdef USE_SHADOW |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 100 | if (!options.use_pam) |
| 101 | spw = getspnam(pw->pw_name); |
| 102 | #ifdef HAS_SHADOW_EXPIRE |
Darren Tucker | 15ee748 | 2004-02-22 09:43:15 +1100 | [diff] [blame] | 103 | if (!options.use_pam && spw != NULL && auth_shadow_acctexpired(spw)) |
| 104 | return 0; |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 105 | #endif /* HAS_SHADOW_EXPIRE */ |
Darren Tucker | 15ee748 | 2004-02-22 09:43:15 +1100 | [diff] [blame] | 106 | #endif /* USE_SHADOW */ |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 107 | |
Damien Miller | a8e06ce | 2003-11-21 23:48:55 +1100 | [diff] [blame] | 108 | /* grab passwd field for locked account check */ |
Darren Tucker | 15ee748 | 2004-02-22 09:43:15 +1100 | [diff] [blame] | 109 | #ifdef USE_SHADOW |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 110 | if (spw != NULL) |
Tim Rice | 66fd217 | 2005-08-31 09:59:49 -0700 | [diff] [blame] | 111 | #if defined(HAVE_LIBIAF) && !defined(BROKEN_LIBIAF) |
Tim Rice | 2291c00 | 2005-08-26 13:15:19 -0700 | [diff] [blame] | 112 | passwd = get_iaf_password(pw); |
| 113 | #else |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 114 | passwd = spw->sp_pwdp; |
Tim Rice | 66fd217 | 2005-08-31 09:59:49 -0700 | [diff] [blame] | 115 | #endif /* HAVE_LIBIAF && !BROKEN_LIBIAF */ |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 116 | #else |
| 117 | passwd = pw->pw_passwd; |
Damien Miller | 06817f9 | 2003-01-07 23:55:59 +1100 | [diff] [blame] | 118 | #endif |
| 119 | |
Damien Miller | a8e06ce | 2003-11-21 23:48:55 +1100 | [diff] [blame] | 120 | /* check for locked account */ |
Darren Tucker | 43a0dc6 | 2003-08-26 14:22:12 +1000 | [diff] [blame] | 121 | if (!options.use_pam && passwd && *passwd) { |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 122 | int locked = 0; |
| 123 | |
| 124 | #ifdef LOCKED_PASSWD_STRING |
| 125 | if (strcmp(passwd, LOCKED_PASSWD_STRING) == 0) |
| 126 | locked = 1; |
| 127 | #endif |
| 128 | #ifdef LOCKED_PASSWD_PREFIX |
| 129 | if (strncmp(passwd, LOCKED_PASSWD_PREFIX, |
| 130 | strlen(LOCKED_PASSWD_PREFIX)) == 0) |
| 131 | locked = 1; |
| 132 | #endif |
| 133 | #ifdef LOCKED_PASSWD_SUBSTR |
| 134 | if (strstr(passwd, LOCKED_PASSWD_SUBSTR)) |
| 135 | locked = 1; |
| 136 | #endif |
Tim Rice | 66fd217 | 2005-08-31 09:59:49 -0700 | [diff] [blame] | 137 | #if defined(HAVE_LIBIAF) && !defined(BROKEN_LIBIAF) |
| 138 | free(passwd); |
| 139 | #endif /* HAVE_LIBIAF && !BROKEN_LIBIAF */ |
Darren Tucker | e41bba5 | 2003-08-25 11:51:19 +1000 | [diff] [blame] | 140 | if (locked) { |
| 141 | logit("User %.100s not allowed because account is locked", |
| 142 | pw->pw_name); |
| 143 | return 0; |
| 144 | } |
| 145 | } |
| 146 | |
Damien Miller | ef7df54 | 2000-05-19 00:03:23 +1000 | [diff] [blame] | 147 | /* |
| 148 | * Get the shell from the password data. An empty shell field is |
| 149 | * legal, and means /bin/sh. |
| 150 | */ |
| 151 | shell = (pw->pw_shell[0] == '\0') ? _PATH_BSHELL : pw->pw_shell; |
| 152 | |
| 153 | /* deny if shell does not exists or is not executable */ |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 154 | if (stat(shell, &st) != 0) { |
Damien Miller | 996acd2 | 2003-04-09 20:59:48 +1000 | [diff] [blame] | 155 | logit("User %.100s not allowed because shell %.100s does not exist", |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 156 | pw->pw_name, shell); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 157 | return 0; |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 158 | } |
Ben Lindstrom | b61e6df | 2002-03-22 01:15:33 +0000 | [diff] [blame] | 159 | if (S_ISREG(st.st_mode) == 0 || |
| 160 | (st.st_mode & (S_IXOTH|S_IXUSR|S_IXGRP)) == 0) { |
Damien Miller | 996acd2 | 2003-04-09 20:59:48 +1000 | [diff] [blame] | 161 | logit("User %.100s not allowed because shell %.100s is not executable", |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 162 | pw->pw_name, shell); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 163 | return 0; |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 164 | } |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 165 | |
Darren Tucker | a8f553d | 2005-03-14 23:17:27 +1100 | [diff] [blame] | 166 | if (options.num_deny_users > 0 || options.num_allow_users > 0 || |
| 167 | options.num_deny_groups > 0 || options.num_allow_groups > 0) { |
Damien Miller | 3a961dc | 2003-06-03 10:25:48 +1000 | [diff] [blame] | 168 | hostname = get_canonical_hostname(options.use_dns); |
Ben Lindstrom | 3fb5d00 | 2002-03-05 01:42:42 +0000 | [diff] [blame] | 169 | ipaddr = get_remote_ipaddr(); |
| 170 | } |
| 171 | |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 172 | /* Return false if user is listed in DenyUsers */ |
| 173 | if (options.num_deny_users > 0) { |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 174 | for (i = 0; i < options.num_deny_users; i++) |
Ben Lindstrom | 6328ab3 | 2002-03-22 02:54:23 +0000 | [diff] [blame] | 175 | if (match_user(pw->pw_name, hostname, ipaddr, |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 176 | options.deny_users[i])) { |
Darren Tucker | 094cd0b | 2005-01-24 21:56:48 +1100 | [diff] [blame] | 177 | logit("User %.100s from %.100s not allowed " |
| 178 | "because listed in DenyUsers", |
| 179 | pw->pw_name, hostname); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 180 | return 0; |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 181 | } |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 182 | } |
| 183 | /* Return false if AllowUsers isn't empty and user isn't listed there */ |
| 184 | if (options.num_allow_users > 0) { |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 185 | for (i = 0; i < options.num_allow_users; i++) |
Ben Lindstrom | 6328ab3 | 2002-03-22 02:54:23 +0000 | [diff] [blame] | 186 | if (match_user(pw->pw_name, hostname, ipaddr, |
Ben Lindstrom | 6026002 | 2001-07-04 04:56:44 +0000 | [diff] [blame] | 187 | options.allow_users[i])) |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 188 | break; |
| 189 | /* i < options.num_allow_users iff we break for loop */ |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 190 | if (i >= options.num_allow_users) { |
Darren Tucker | 094cd0b | 2005-01-24 21:56:48 +1100 | [diff] [blame] | 191 | logit("User %.100s from %.100s not allowed because " |
| 192 | "not listed in AllowUsers", pw->pw_name, hostname); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 193 | return 0; |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 194 | } |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 195 | } |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 196 | if (options.num_deny_groups > 0 || options.num_allow_groups > 0) { |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 197 | /* Get the user's group access list (primary and supplementary) */ |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 198 | if (ga_init(pw->pw_name, pw->pw_gid) == 0) { |
Darren Tucker | 094cd0b | 2005-01-24 21:56:48 +1100 | [diff] [blame] | 199 | logit("User %.100s from %.100s not allowed because " |
| 200 | "not in any group", pw->pw_name, hostname); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 201 | return 0; |
Ben Lindstrom | 6ef9ec6 | 2002-03-05 01:40:37 +0000 | [diff] [blame] | 202 | } |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 203 | |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 204 | /* Return false if one of user's groups is listed in DenyGroups */ |
| 205 | if (options.num_deny_groups > 0) |
| 206 | if (ga_match(options.deny_groups, |
| 207 | options.num_deny_groups)) { |
| 208 | ga_free(); |
Darren Tucker | 094cd0b | 2005-01-24 21:56:48 +1100 | [diff] [blame] | 209 | logit("User %.100s from %.100s not allowed " |
| 210 | "because a group is listed in DenyGroups", |
| 211 | pw->pw_name, hostname); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 212 | return 0; |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 213 | } |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 214 | /* |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 215 | * Return false if AllowGroups isn't empty and one of user's groups |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 216 | * isn't listed there |
| 217 | */ |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 218 | if (options.num_allow_groups > 0) |
| 219 | if (!ga_match(options.allow_groups, |
| 220 | options.num_allow_groups)) { |
| 221 | ga_free(); |
Darren Tucker | 094cd0b | 2005-01-24 21:56:48 +1100 | [diff] [blame] | 222 | logit("User %.100s from %.100s not allowed " |
| 223 | "because none of user's groups are listed " |
| 224 | "in AllowGroups", pw->pw_name, hostname); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 225 | return 0; |
Kevin Steves | 7b61cfa | 2001-01-14 19:11:00 +0000 | [diff] [blame] | 226 | } |
| 227 | ga_free(); |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 228 | } |
| 229 | |
Darren Tucker | 0a9d43d | 2004-06-23 13:45:24 +1000 | [diff] [blame] | 230 | #ifdef CUSTOM_SYS_AUTH_ALLOWED_USER |
Darren Tucker | 691d523 | 2005-02-15 21:45:57 +1100 | [diff] [blame] | 231 | if (!sys_auth_allowed_user(pw, &loginmsg)) |
Darren Tucker | 0a9d43d | 2004-06-23 13:45:24 +1000 | [diff] [blame] | 232 | return 0; |
| 233 | #endif |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 234 | |
| 235 | /* We found no reason not to let this user try to log on... */ |
| 236 | return 1; |
| 237 | } |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 238 | |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 239 | void |
| 240 | auth_log(Authctxt *authctxt, int authenticated, char *method, char *info) |
| 241 | { |
| 242 | void (*authlog) (const char *fmt,...) = verbose; |
| 243 | char *authmsg; |
| 244 | |
Damien Miller | 7a8f5b3 | 2006-03-31 23:14:23 +1100 | [diff] [blame] | 245 | if (use_privsep && !mm_is_monitor() && !authctxt->postponed) |
| 246 | return; |
| 247 | |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 248 | /* Raise logging level */ |
| 249 | if (authenticated == 1 || |
| 250 | !authctxt->valid || |
Darren Tucker | 89413db | 2004-05-24 10:36:23 +1000 | [diff] [blame] | 251 | authctxt->failures >= options.max_authtries / 2 || |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 252 | strcmp(method, "password") == 0) |
Damien Miller | 2a3f20e | 2003-04-09 21:12:00 +1000 | [diff] [blame] | 253 | authlog = logit; |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 254 | |
| 255 | if (authctxt->postponed) |
| 256 | authmsg = "Postponed"; |
| 257 | else |
| 258 | authmsg = authenticated ? "Accepted" : "Failed"; |
| 259 | |
| 260 | authlog("%s %s for %s%.100s from %.200s port %d%s", |
| 261 | authmsg, |
| 262 | method, |
Darren Tucker | 5cb30ad | 2004-08-12 22:40:24 +1000 | [diff] [blame] | 263 | authctxt->valid ? "" : "invalid user ", |
Damien Miller | f655207 | 2001-11-12 11:06:06 +1100 | [diff] [blame] | 264 | authctxt->user, |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 265 | get_remote_ipaddr(), |
| 266 | get_remote_port(), |
| 267 | info); |
Ben Lindstrom | e06eb68 | 2002-07-04 00:27:21 +0000 | [diff] [blame] | 268 | |
Darren Tucker | 97363a8 | 2003-05-02 23:42:25 +1000 | [diff] [blame] | 269 | #ifdef CUSTOM_FAILED_LOGIN |
Darren Tucker | 2fba993 | 2005-02-02 23:30:24 +1100 | [diff] [blame] | 270 | if (authenticated == 0 && !authctxt->postponed && |
| 271 | (strcmp(method, "password") == 0 || |
Darren Tucker | 40d9a63 | 2005-02-04 15:19:44 +1100 | [diff] [blame] | 272 | strncmp(method, "keyboard-interactive", 20) == 0 || |
| 273 | strcmp(method, "challenge-response") == 0)) |
Darren Tucker | 42d9dc7 | 2005-02-02 17:10:11 +1100 | [diff] [blame] | 274 | record_failed_login(authctxt->user, |
| 275 | get_canonical_hostname(options.use_dns), "ssh"); |
Darren Tucker | 97363a8 | 2003-05-02 23:42:25 +1000 | [diff] [blame] | 276 | #endif |
Darren Tucker | 2e0cf0d | 2005-02-08 21:52:47 +1100 | [diff] [blame] | 277 | #ifdef SSH_AUDIT_EVENTS |
Darren Tucker | f14b2aa | 2006-05-21 18:26:40 +1000 | [diff] [blame] | 278 | if (authenticated == 0 && !authctxt->postponed) |
| 279 | audit_event(audit_classify_auth(method)); |
Darren Tucker | 269a1ea | 2005-02-03 00:20:53 +1100 | [diff] [blame] | 280 | #endif |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 281 | } |
| 282 | |
| 283 | /* |
Ben Lindstrom | d8a9021 | 2001-02-15 03:08:27 +0000 | [diff] [blame] | 284 | * Check whether root logins are disallowed. |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 285 | */ |
| 286 | int |
Ben Lindstrom | d8a9021 | 2001-02-15 03:08:27 +0000 | [diff] [blame] | 287 | auth_root_allowed(char *method) |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 288 | { |
Ben Lindstrom | d8a9021 | 2001-02-15 03:08:27 +0000 | [diff] [blame] | 289 | switch (options.permit_root_login) { |
| 290 | case PERMIT_YES: |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 291 | return 1; |
Ben Lindstrom | d8a9021 | 2001-02-15 03:08:27 +0000 | [diff] [blame] | 292 | case PERMIT_NO_PASSWD: |
| 293 | if (strcmp(method, "password") != 0) |
| 294 | return 1; |
| 295 | break; |
| 296 | case PERMIT_FORCED_ONLY: |
| 297 | if (forced_command) { |
Damien Miller | 996acd2 | 2003-04-09 20:59:48 +1000 | [diff] [blame] | 298 | logit("Root login accepted for forced command."); |
Ben Lindstrom | d8a9021 | 2001-02-15 03:08:27 +0000 | [diff] [blame] | 299 | return 1; |
| 300 | } |
| 301 | break; |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 302 | } |
Damien Miller | 996acd2 | 2003-04-09 20:59:48 +1000 | [diff] [blame] | 303 | logit("ROOT LOGIN REFUSED FROM %.200s", get_remote_ipaddr()); |
Ben Lindstrom | d8a9021 | 2001-02-15 03:08:27 +0000 | [diff] [blame] | 304 | return 0; |
Ben Lindstrom | db65e8f | 2001-01-19 04:26:52 +0000 | [diff] [blame] | 305 | } |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 306 | |
| 307 | |
| 308 | /* |
| 309 | * Given a template and a passwd structure, build a filename |
| 310 | * by substituting % tokenised options. Currently, %% becomes '%', |
| 311 | * %h becomes the home directory and %u the username. |
| 312 | * |
| 313 | * This returns a buffer allocated by xmalloc. |
| 314 | */ |
Damien Miller | 6476cad | 2005-06-16 13:18:34 +1000 | [diff] [blame] | 315 | static char * |
| 316 | expand_authorized_keys(const char *filename, struct passwd *pw) |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 317 | { |
Damien Miller | 07d86be | 2006-03-26 14:19:21 +1100 | [diff] [blame] | 318 | char *file, ret[MAXPATHLEN]; |
| 319 | int i; |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 320 | |
Damien Miller | 6476cad | 2005-06-16 13:18:34 +1000 | [diff] [blame] | 321 | file = percent_expand(filename, "h", pw->pw_dir, |
| 322 | "u", pw->pw_name, (char *)NULL); |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 323 | |
| 324 | /* |
| 325 | * Ensure that filename starts anchored. If not, be backward |
| 326 | * compatible and prepend the '%h/' |
| 327 | */ |
Damien Miller | 6476cad | 2005-06-16 13:18:34 +1000 | [diff] [blame] | 328 | if (*file == '/') |
| 329 | return (file); |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 330 | |
Damien Miller | 07d86be | 2006-03-26 14:19:21 +1100 | [diff] [blame] | 331 | i = snprintf(ret, sizeof(ret), "%s/%s", pw->pw_dir, file); |
| 332 | if (i < 0 || (size_t)i >= sizeof(ret)) |
Damien Miller | 6476cad | 2005-06-16 13:18:34 +1000 | [diff] [blame] | 333 | fatal("expand_authorized_keys: path too long"); |
Damien Miller | 6476cad | 2005-06-16 13:18:34 +1000 | [diff] [blame] | 334 | xfree(file); |
Damien Miller | 07d86be | 2006-03-26 14:19:21 +1100 | [diff] [blame] | 335 | return (xstrdup(ret)); |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 336 | } |
| 337 | |
| 338 | char * |
| 339 | authorized_keys_file(struct passwd *pw) |
| 340 | { |
Damien Miller | 6476cad | 2005-06-16 13:18:34 +1000 | [diff] [blame] | 341 | return expand_authorized_keys(options.authorized_keys_file, pw); |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 342 | } |
| 343 | |
| 344 | char * |
| 345 | authorized_keys_file2(struct passwd *pw) |
| 346 | { |
Damien Miller | 6476cad | 2005-06-16 13:18:34 +1000 | [diff] [blame] | 347 | return expand_authorized_keys(options.authorized_keys_file2, pw); |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 348 | } |
| 349 | |
Ben Lindstrom | 83647ce | 2001-06-25 04:30:16 +0000 | [diff] [blame] | 350 | /* return ok if key exists in sysfile or userfile */ |
| 351 | HostStatus |
| 352 | check_key_in_hostfiles(struct passwd *pw, Key *key, const char *host, |
| 353 | const char *sysfile, const char *userfile) |
| 354 | { |
| 355 | Key *found; |
| 356 | char *user_hostfile; |
| 357 | struct stat st; |
Ben Lindstrom | 65366a8 | 2001-12-06 16:32:47 +0000 | [diff] [blame] | 358 | HostStatus host_status; |
Ben Lindstrom | 83647ce | 2001-06-25 04:30:16 +0000 | [diff] [blame] | 359 | |
| 360 | /* Check if we know the host and its host key. */ |
| 361 | found = key_new(key->type); |
| 362 | host_status = check_host_in_hostfile(sysfile, host, key, found, NULL); |
| 363 | |
| 364 | if (host_status != HOST_OK && userfile != NULL) { |
| 365 | user_hostfile = tilde_expand_filename(userfile, pw->pw_uid); |
| 366 | if (options.strict_modes && |
| 367 | (stat(user_hostfile, &st) == 0) && |
| 368 | ((st.st_uid != 0 && st.st_uid != pw->pw_uid) || |
Damien Miller | 9f0f5c6 | 2001-12-21 14:45:46 +1100 | [diff] [blame] | 369 | (st.st_mode & 022) != 0)) { |
Damien Miller | 996acd2 | 2003-04-09 20:59:48 +1000 | [diff] [blame] | 370 | logit("Authentication refused for %.100s: " |
Ben Lindstrom | 83647ce | 2001-06-25 04:30:16 +0000 | [diff] [blame] | 371 | "bad owner or modes for %.200s", |
| 372 | pw->pw_name, user_hostfile); |
| 373 | } else { |
| 374 | temporarily_use_uid(pw); |
| 375 | host_status = check_host_in_hostfile(user_hostfile, |
| 376 | host, key, found, NULL); |
| 377 | restore_uid(); |
| 378 | } |
| 379 | xfree(user_hostfile); |
| 380 | } |
| 381 | key_free(found); |
| 382 | |
| 383 | debug2("check_key_in_hostfiles: key %s for %s", host_status == HOST_OK ? |
| 384 | "ok" : "not found", host); |
| 385 | return host_status; |
| 386 | } |
| 387 | |
| 388 | |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 389 | /* |
| 390 | * Check a given file for security. This is defined as all components |
Ben Lindstrom | d4ee349 | 2002-08-20 18:42:13 +0000 | [diff] [blame] | 391 | * of the path to the file must be owned by either the owner of |
Ben Lindstrom | 60567ff | 2001-06-05 20:27:53 +0000 | [diff] [blame] | 392 | * of the file or root and no directories must be group or world writable. |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 393 | * |
| 394 | * XXX Should any specific check be done for sym links ? |
| 395 | * |
| 396 | * Takes an open file descriptor, the file name, a uid and and |
| 397 | * error buffer plus max size as arguments. |
| 398 | * |
| 399 | * Returns 0 on success and -1 on failure |
| 400 | */ |
| 401 | int |
Ben Lindstrom | 248c078 | 2001-07-04 03:40:39 +0000 | [diff] [blame] | 402 | secure_filename(FILE *f, const char *file, struct passwd *pw, |
| 403 | char *err, size_t errlen) |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 404 | { |
Ben Lindstrom | 248c078 | 2001-07-04 03:40:39 +0000 | [diff] [blame] | 405 | uid_t uid = pw->pw_uid; |
Ben Lindstrom | c3e49e7 | 2001-10-03 17:55:26 +0000 | [diff] [blame] | 406 | char buf[MAXPATHLEN], homedir[MAXPATHLEN]; |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 407 | char *cp; |
Ben Lindstrom | 485075e | 2002-11-09 15:45:12 +0000 | [diff] [blame] | 408 | int comparehome = 0; |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 409 | struct stat st; |
| 410 | |
| 411 | if (realpath(file, buf) == NULL) { |
| 412 | snprintf(err, errlen, "realpath %s failed: %s", file, |
| 413 | strerror(errno)); |
| 414 | return -1; |
| 415 | } |
Ben Lindstrom | 485075e | 2002-11-09 15:45:12 +0000 | [diff] [blame] | 416 | if (realpath(pw->pw_dir, homedir) != NULL) |
| 417 | comparehome = 1; |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 418 | |
| 419 | /* check the open file to avoid races */ |
| 420 | if (fstat(fileno(f), &st) < 0 || |
| 421 | (st.st_uid != 0 && st.st_uid != uid) || |
| 422 | (st.st_mode & 022) != 0) { |
| 423 | snprintf(err, errlen, "bad ownership or modes for file %s", |
| 424 | buf); |
| 425 | return -1; |
| 426 | } |
| 427 | |
| 428 | /* for each component of the canonical path, walking upwards */ |
| 429 | for (;;) { |
| 430 | if ((cp = dirname(buf)) == NULL) { |
| 431 | snprintf(err, errlen, "dirname() failed"); |
| 432 | return -1; |
| 433 | } |
| 434 | strlcpy(buf, cp, sizeof(buf)); |
| 435 | |
| 436 | debug3("secure_filename: checking '%s'", buf); |
| 437 | if (stat(buf, &st) < 0 || |
| 438 | (st.st_uid != 0 && st.st_uid != uid) || |
| 439 | (st.st_mode & 022) != 0) { |
Damien Miller | 9f0f5c6 | 2001-12-21 14:45:46 +1100 | [diff] [blame] | 440 | snprintf(err, errlen, |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 441 | "bad ownership or modes for directory %s", buf); |
| 442 | return -1; |
| 443 | } |
| 444 | |
Damien Miller | 0ae6e00 | 2001-07-14 12:21:34 +1000 | [diff] [blame] | 445 | /* If are passed the homedir then we can stop */ |
Ben Lindstrom | 485075e | 2002-11-09 15:45:12 +0000 | [diff] [blame] | 446 | if (comparehome && strcmp(homedir, buf) == 0) { |
Damien Miller | 0ae6e00 | 2001-07-14 12:21:34 +1000 | [diff] [blame] | 447 | debug3("secure_filename: terminating check at '%s'", |
| 448 | buf); |
| 449 | break; |
| 450 | } |
Ben Lindstrom | bfb3a0e | 2001-06-05 20:25:05 +0000 | [diff] [blame] | 451 | /* |
| 452 | * dirname should always complete with a "/" path, |
| 453 | * but we can be paranoid and check for "." too |
| 454 | */ |
| 455 | if ((strcmp("/", buf) == 0) || (strcmp(".", buf) == 0)) |
| 456 | break; |
| 457 | } |
| 458 | return 0; |
| 459 | } |
Ben Lindstrom | 2ae18f4 | 2002-03-22 01:24:38 +0000 | [diff] [blame] | 460 | |
| 461 | struct passwd * |
| 462 | getpwnamallow(const char *user) |
| 463 | { |
Ben Lindstrom | b481e13 | 2002-03-22 01:35:47 +0000 | [diff] [blame] | 464 | #ifdef HAVE_LOGIN_CAP |
| 465 | extern login_cap_t *lc; |
| 466 | #ifdef BSD_AUTH |
| 467 | auth_session_t *as; |
| 468 | #endif |
| 469 | #endif |
Ben Lindstrom | 2ae18f4 | 2002-03-22 01:24:38 +0000 | [diff] [blame] | 470 | struct passwd *pw; |
| 471 | |
Darren Tucker | 4515047 | 2006-07-12 22:34:17 +1000 | [diff] [blame] | 472 | parse_server_match_config(&options, user, |
| 473 | get_canonical_hostname(options.use_dns), get_remote_ipaddr()); |
| 474 | |
Ben Lindstrom | 2ae18f4 | 2002-03-22 01:24:38 +0000 | [diff] [blame] | 475 | pw = getpwnam(user); |
Damien Miller | 6f0a188 | 2002-09-22 01:26:51 +1000 | [diff] [blame] | 476 | if (pw == NULL) { |
Damien Miller | a22f2d7 | 2004-07-21 20:48:24 +1000 | [diff] [blame] | 477 | logit("Invalid user %.100s from %.100s", |
Damien Miller | 6f0a188 | 2002-09-22 01:26:51 +1000 | [diff] [blame] | 478 | user, get_remote_ipaddr()); |
Darren Tucker | 97363a8 | 2003-05-02 23:42:25 +1000 | [diff] [blame] | 479 | #ifdef CUSTOM_FAILED_LOGIN |
Darren Tucker | 42d9dc7 | 2005-02-02 17:10:11 +1100 | [diff] [blame] | 480 | record_failed_login(user, |
| 481 | get_canonical_hostname(options.use_dns), "ssh"); |
Ben Lindstrom | f5397c0 | 2002-11-09 16:11:10 +0000 | [diff] [blame] | 482 | #endif |
Darren Tucker | 2e0cf0d | 2005-02-08 21:52:47 +1100 | [diff] [blame] | 483 | #ifdef SSH_AUDIT_EVENTS |
| 484 | audit_event(SSH_INVALID_USER); |
| 485 | #endif /* SSH_AUDIT_EVENTS */ |
Damien Miller | 6f0a188 | 2002-09-22 01:26:51 +1000 | [diff] [blame] | 486 | return (NULL); |
| 487 | } |
| 488 | if (!allowed_user(pw)) |
Ben Lindstrom | b481e13 | 2002-03-22 01:35:47 +0000 | [diff] [blame] | 489 | return (NULL); |
| 490 | #ifdef HAVE_LOGIN_CAP |
| 491 | if ((lc = login_getclass(pw->pw_class)) == NULL) { |
| 492 | debug("unable to get login class: %s", user); |
| 493 | return (NULL); |
| 494 | } |
| 495 | #ifdef BSD_AUTH |
| 496 | if ((as = auth_open()) == NULL || auth_setpwd(as, pw) != 0 || |
Damien Miller | 13e35a0 | 2002-05-22 14:04:11 +1000 | [diff] [blame] | 497 | auth_approval(as, lc, pw->pw_name, "ssh") <= 0) { |
Ben Lindstrom | b481e13 | 2002-03-22 01:35:47 +0000 | [diff] [blame] | 498 | debug("Approval failure for %s", user); |
Ben Lindstrom | 2ae18f4 | 2002-03-22 01:24:38 +0000 | [diff] [blame] | 499 | pw = NULL; |
Ben Lindstrom | b481e13 | 2002-03-22 01:35:47 +0000 | [diff] [blame] | 500 | } |
| 501 | if (as != NULL) |
| 502 | auth_close(as); |
| 503 | #endif |
| 504 | #endif |
Ben Lindstrom | f34e4eb | 2002-03-22 03:08:30 +0000 | [diff] [blame] | 505 | if (pw != NULL) |
| 506 | return (pwcopy(pw)); |
| 507 | return (NULL); |
Ben Lindstrom | 2ae18f4 | 2002-03-22 01:24:38 +0000 | [diff] [blame] | 508 | } |
Ben Lindstrom | a574cda | 2002-05-15 16:16:14 +0000 | [diff] [blame] | 509 | |
| 510 | void |
| 511 | auth_debug_add(const char *fmt,...) |
| 512 | { |
| 513 | char buf[1024]; |
| 514 | va_list args; |
| 515 | |
| 516 | if (!auth_debug_init) |
| 517 | return; |
| 518 | |
| 519 | va_start(args, fmt); |
| 520 | vsnprintf(buf, sizeof(buf), fmt, args); |
| 521 | va_end(args); |
| 522 | buffer_put_cstring(&auth_debug, buf); |
| 523 | } |
| 524 | |
| 525 | void |
| 526 | auth_debug_send(void) |
| 527 | { |
| 528 | char *msg; |
| 529 | |
| 530 | if (!auth_debug_init) |
| 531 | return; |
| 532 | while (buffer_len(&auth_debug)) { |
| 533 | msg = buffer_get_string(&auth_debug, NULL); |
| 534 | packet_send_debug("%s", msg); |
| 535 | xfree(msg); |
| 536 | } |
| 537 | } |
| 538 | |
| 539 | void |
| 540 | auth_debug_reset(void) |
| 541 | { |
| 542 | if (auth_debug_init) |
| 543 | buffer_clear(&auth_debug); |
| 544 | else { |
| 545 | buffer_init(&auth_debug); |
| 546 | auth_debug_init = 1; |
| 547 | } |
| 548 | } |
Damien Miller | 856f0be | 2003-09-03 07:32:45 +1000 | [diff] [blame] | 549 | |
| 550 | struct passwd * |
| 551 | fakepw(void) |
| 552 | { |
| 553 | static struct passwd fake; |
| 554 | |
| 555 | memset(&fake, 0, sizeof(fake)); |
| 556 | fake.pw_name = "NOUSER"; |
| 557 | fake.pw_passwd = |
Damien Miller | 787b2ec | 2003-11-21 23:56:47 +1100 | [diff] [blame] | 558 | "$2a$06$r3.juUaHZDlIbQaO2dS9FuYxL1W9M81R1Tc92PoSNmzvpEqLkLGrK"; |
Damien Miller | 856f0be | 2003-09-03 07:32:45 +1000 | [diff] [blame] | 559 | fake.pw_gecos = "NOUSER"; |
Darren Tucker | 1f8311c | 2004-05-13 16:39:33 +1000 | [diff] [blame] | 560 | fake.pw_uid = (uid_t)-1; |
| 561 | fake.pw_gid = (gid_t)-1; |
Damien Miller | 856f0be | 2003-09-03 07:32:45 +1000 | [diff] [blame] | 562 | #ifdef HAVE_PW_CLASS_IN_PASSWD |
| 563 | fake.pw_class = ""; |
| 564 | #endif |
| 565 | fake.pw_dir = "/nonexist"; |
| 566 | fake.pw_shell = "/nonexist"; |
| 567 | |
| 568 | return (&fake); |
| 569 | } |