source: openpam/trunk/lib/openpam_dispatch.c @ 33

Last change on this file since 33 was 33, checked in by Dag-Erling Smørgrav, 18 years ago

Behave more like Solaris when faced with an empty chain, or a chain
that lists modules that don't implement the required functionality.

Sponsored by: DARPA, NAI Labs

  • Property svn:keywords set to Id LastChangedRevision HeadURL LastChangedDate LastChangedBy
File size: 5.4 KB
Line 
1/*-
2 * Copyright (c) 2002 Networks Associates Technologies, Inc.
3 * All rights reserved.
4 *
5 * This software was developed for the FreeBSD Project by ThinkSec AS and
6 * NAI Labs, the Security Research Division of Network Associates, Inc.
7 * under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
8 * DARPA CHATS research program.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 *    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.
18 * 3. The name of the author may not be used to endorse or promote
19 *    products derived from this software without specific prior written
20 *    permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 * SUCH DAMAGE.
33 *
34 * $Id: openpam_dispatch.c 33 2002-02-04 23:36:07Z des $
35 */
36
37#include <sys/param.h>
38
39#include <security/pam_appl.h>
40
41#include "openpam_impl.h"
42
43#if !defined(OPENPAM_RELAX_CHECKS)
44static void _openpam_check_error_code(int, int);
45#else
46#define _openpam_check_error_code(a, b)
47#endif /* !defined(OPENPAM_RELAX_CHECKS) */
48
49/*
50 * Execute a module chain
51 */
52
53int
54openpam_dispatch(pam_handle_t *pamh,
55        int primitive,
56        int flags)
57{
58        pam_chain_t *chain;
59        int err, fail, r;
60
61        if (pamh == NULL)
62                return (PAM_SYSTEM_ERR);
63
64        /* prevent recursion */
65        if (pamh->current != NULL) {
66                openpam_log(PAM_LOG_ERROR, "indirect recursion");
67                return (PAM_ABORT);
68        }
69
70        /* pick a chain */
71        switch (primitive) {
72        case PAM_SM_AUTHENTICATE:
73        case PAM_SM_SETCRED:
74                chain = pamh->chains[PAM_AUTH];
75                break;
76        case PAM_SM_ACCT_MGMT:
77                chain = pamh->chains[PAM_ACCOUNT];
78                break;
79        case PAM_SM_OPEN_SESSION:
80        case PAM_SM_CLOSE_SESSION:
81                chain = pamh->chains[PAM_SESSION];
82                break;
83        case PAM_SM_CHAUTHTOK:
84                chain = pamh->chains[PAM_PASSWORD];
85                break;
86        default:
87                return (PAM_SYSTEM_ERR);
88        }
89
90        /* execute */
91        for (err = fail = 0; chain != NULL; chain = chain->next) {
92                if (chain->module->func[primitive] == NULL) {
93                        openpam_log(PAM_LOG_ERROR, "%s: no %s()",
94                            chain->module->path, _pam_sm_func_name[primitive]);
95                        continue;
96                } else {
97                        pamh->current = chain;
98                        r = (chain->module->func[primitive])(pamh, flags,
99                            chain->optc, (const char **)chain->optv);
100                        pamh->current = NULL;
101                        openpam_log(PAM_LOG_DEBUG, "%s: %s(): %s",
102                            chain->module->path, _pam_sm_func_name[primitive],
103                            pam_strerror(pamh, r));
104                }
105
106                if (r == PAM_IGNORE)
107                        continue;
108                if (r == PAM_SUCCESS) {
109                        /*
110                         * For pam_setcred(), treat "sufficient" as
111                         * "optional".
112                         *
113                         * Note that Solaris libpam does not terminate
114                         * the chain here if a required module has
115                         * previously failed.  I'm not sure why.
116                         */
117                        if (chain->flag == PAM_SUFFICIENT &&
118                            primitive != PAM_SM_SETCRED)
119                                break;
120                }
121
122                _openpam_check_error_code(primitive, r);
123
124                /*
125                 * Record the return code from the first module to
126                 * fail.  If a required module fails, record the
127                 * return code from the first required module to fail.
128                 */
129                if (err == 0)
130                        err = r;
131                if (chain->flag == PAM_REQUIRED && !fail) {
132                        fail = 1;
133                        err = r;
134                }
135
136                /*
137                 * If a requisite module fails, terminate the chain
138                 * immediately.
139                 */
140                if (chain->flag == PAM_REQUISITE) {
141                        fail = 1;
142                        break;
143                }
144        }
145
146        return (fail ? err : PAM_SUCCESS);
147}
148
149#if !defined(OPENPAM_RELAX_CHECKS)
150static void
151_openpam_check_error_code(int primitive, int r)
152{
153        /* common error codes */
154        if (r == PAM_SERVICE_ERR ||
155            r == PAM_BUF_ERR ||
156            r == PAM_BUF_ERR ||
157            r == PAM_CONV_ERR ||
158            r == PAM_PERM_DENIED)
159                return;
160
161        /* specific error codes */
162        switch (primitive) {
163        case PAM_SM_AUTHENTICATE:
164                if (r == PAM_AUTH_ERR ||
165                    r == PAM_CRED_INSUFFICIENT ||
166                    r == PAM_AUTHINFO_UNAVAIL ||
167                    r == PAM_USER_UNKNOWN ||
168                    r == PAM_MAXTRIES)
169                        return;
170                break;
171        case PAM_SM_SETCRED:
172                if (r == PAM_CRED_UNAVAIL ||
173                    r == PAM_CRED_EXPIRED ||
174                    r == PAM_USER_UNKNOWN ||
175                    r == PAM_CRED_ERR)
176                        return;
177                break;
178        case PAM_SM_ACCT_MGMT:
179                if (r == PAM_USER_UNKNOWN ||
180                    r == PAM_AUTH_ERR ||
181                    r == PAM_NEW_AUTHTOK_REQD ||
182                    r == PAM_ACCT_EXPIRED)
183                        return;
184                break;
185        case PAM_SM_OPEN_SESSION:
186        case PAM_SM_CLOSE_SESSION:
187                if (r == PAM_SESSION_ERR)
188                        return;
189                break;
190        case PAM_SM_CHAUTHTOK:
191                if (r == PAM_PERM_DENIED ||
192                    r == PAM_AUTHTOK_ERR ||
193                    r == PAM_AUTHTOK_RECOVERY_ERR ||
194                    r == PAM_AUTHTOK_LOCK_BUSY ||
195                    r == PAM_AUTHTOK_DISABLE_AGING)
196                        return;
197                break;
198        }
199
200        openpam_log(PAM_LOG_ERROR, "%s(): unexpected return value %d",
201            _pam_sm_func_name[primitive], r);
202}
203#endif /* !defined(OPENPAM_RELAX_CHECKS) */
Note: See TracBrowser for help on using the repository browser.