2 * Copyright (c) 1999-2005, 2007, 2010-2012
3 * Todd C. Miller <Todd.Miller@courtesan.com>
4 * Copyright (c) 2002 Michael Stroucken <michael@stroucken.org>
6 * Permission to use, copy, modify, and distribute this software for any
7 * purpose with or without fee is hereby granted, provided that the above
8 * copyright notice and this permission notice appear in all copies.
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
18 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
19 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
21 * Sponsored in part by the Defense Advanced Research Projects
22 * Agency (DARPA) and Air Force Research Laboratory, Air Force
23 * Materiel Command, USAF, under agreement number F39502-99-1-0512.
28 #include <sys/types.h>
37 #endif /* STDC_HEADERS */
40 #endif /* HAVE_STRING_H */
43 #endif /* HAVE_STRINGS_H */
46 #endif /* HAVE_UNISTD_H */
49 /* Needed for SecurID v5.0 Authentication on UNIX */
55 #include "sudo_auth.h"
58 * securid_init - Initialises communications with ACE server
61 * auth - sudo authentication structure
64 * auth - auth->data contains pointer to new SecurID handle
65 * return code - Fatal if initialization unsuccessful, otherwise
69 sudo_securid_init(struct passwd *pw, sudo_auth *auth)
71 static SDI_HANDLE sd_dat; /* SecurID handle */
72 debug_decl(sudo_securid_init, SUDO_DEBUG_AUTH)
74 auth->data = (void *) &sd_dat; /* For method-specific data */
76 /* Start communications */
77 if (AceInitialize() != SD_FALSE)
78 debug_return_int(AUTH_SUCCESS);
80 warningx(_("failed to initialise the ACE API library"));
81 debug_return_int(AUTH_FATAL);
85 * securid_setup - Initialises a SecurID transaction and locks out other
89 * pw - struct passwd for username
91 * auth - sudo authentication structure for SecurID handle
94 * return code - Success if transaction started correctly, fatal
98 sudo_securid_setup(struct passwd *pw, char **promptp, sudo_auth *auth)
100 SDI_HANDLE *sd = (SDI_HANDLE *) auth->data;
102 debug_decl(sudo_securid_setup, SUDO_DEBUG_AUTH)
104 /* Re-initialize SecurID every time. */
105 if (SD_Init(sd) != ACM_OK) {
106 warningx(_("unable to contact the SecurID server"));
107 debug_return_int(AUTH_FATAL);
110 /* Lock new PIN code */
111 retval = SD_Lock(*sd, pw->pw_name);
115 warningx(_("User ID locked for SecurID Authentication"));
116 debug_return_int(AUTH_SUCCESS);
118 case ACE_UNDEFINED_USERNAME:
119 warningx(_("invalid username length for SecurID"));
120 debug_return_int(AUTH_FATAL);
122 case ACE_ERR_INVALID_HANDLE:
123 warningx(_("invalid Authentication Handle for SecurID"));
124 debug_return_int(AUTH_FATAL);
126 case ACM_ACCESS_DENIED:
127 warningx(_("SecurID communication failed"));
128 debug_return_int(AUTH_FATAL);
131 warningx(_("unknown SecurID error"));
132 debug_return_int(AUTH_FATAL);
137 * securid_verify - Authenticates user and handles ACE responses
140 * pw - struct passwd for username
142 * auth - sudo authentication structure for SecurID handle
145 * return code - Success on successful authentication, failure on
146 * incorrect authentication, fatal on errors
149 sudo_securid_verify(struct passwd *pw, char *pass, sudo_auth *auth)
151 SDI_HANDLE *sd = (SDI_HANDLE *) auth->data;
153 debug_decl(sudo_securid_verify, SUDO_DEBUG_AUTH)
155 pass = auth_getpass("Enter your PASSCODE: ",
156 def_passwd_timeout * 60, SUDO_CONV_PROMPT_ECHO_OFF);
158 /* Have ACE verify password */
159 switch (SD_Check(*sd, pass, pw->pw_name)) {
164 case ACE_UNDEFINED_PASSCODE:
165 warningx(_("invalid passcode length for SecurID"));
169 case ACE_UNDEFINED_USERNAME:
170 warningx(_("invalid username length for SecurID"));
174 case ACE_ERR_INVALID_HANDLE:
175 warningx(_("invalid Authentication Handle for SecurID"));
179 case ACM_ACCESS_DENIED:
183 case ACM_NEXT_CODE_REQUIRED:
184 /* Sometimes (when current token close to expire?)
185 ACE challenges for the next token displayed
186 (entered without the PIN) */
187 pass = auth_getpass("\
189 Wait for the token code to change, \n\
190 then enter the new token code.\n", \
191 def_passwd_timeout * 60, SUDO_CONV_PROMPT_ECHO_OFF);
193 if (SD_Next(*sd, pass) == ACM_OK) {
201 case ACM_NEW_PIN_REQUIRED:
203 * This user's SecurID has not been activated yet,
204 * or the pin has been reset
206 /* XXX - Is setting up a new PIN within sudo's scope? */
208 fprintf(stderr, "Your SecurID access has not yet been set up.\n");
209 fprintf(stderr, "Please set up a PIN before you try to authenticate.\n");
214 warningx(_("unknown SecurID error"));
222 /* Return stored state to calling process */
223 debug_return_int(rval);