2 * "$Id: auth.c 5961 2006-09-16 19:08:36Z mike $"
4 * Authentication functions for the Common UNIX Printing System (CUPS).
6 * Copyright 1997-2006 by Easy Software Products.
8 * These coded instructions, statements, and computer programs are the
9 * property of Easy Software Products and are protected by Federal
10 * copyright law. Distribution and use rights are outlined in the file
11 * "LICENSE.txt" which should have been included with this file. If this
12 * file is missing or damaged please contact Easy Software Products
15 * Attn: CUPS Licensing Information
16 * Easy Software Products
17 * 44141 Airport View Drive, Suite 204
18 * Hollywood, Maryland 20636 USA
20 * Voice: (301) 373-9600
21 * EMail: cups-info@cups.org
22 * WWW: http://www.cups.org
24 * This file is subject to the Apple OS-Developed Software exception.
28 * cupsDoAuthentication() - Authenticate a request.
29 * cups_local_auth() - Get the local authorization certificate if
30 * available/applicable...
34 * Include necessary headers...
44 #if defined(WIN32) || defined(__EMX__)
48 #endif /* WIN32 || __EMX__ */
55 static int cups_local_auth(http_t
*http
);
59 * 'cupsDoAuthentication()' - Authenticate a request.
61 * This function should be called in response to a HTTP_UNAUTHORIZED
62 * status, prior to resubmitting your request.
67 int /* O - 0 on success, -1 on error */
68 cupsDoAuthentication(http_t
*http
, /* I - HTTP connection to server */
69 const char *method
,/* I - Request method (GET, POST, PUT) */
71 /* I - Resource path */
73 const char *password
; /* Password string */
74 char prompt
[1024], /* Prompt for user */
75 realm
[HTTP_MAX_VALUE
], /* realm="xyz" string */
76 nonce
[HTTP_MAX_VALUE
], /* nonce="xyz" string */
77 encode
[512]; /* Encoded username:password */
80 DEBUG_printf(("cupsDoAuthentication(http=%p, method=\"%s\", resource=\"%s\")\n",
81 http
, method
, resource
));
82 DEBUG_printf(("cupsDoAuthentication: digest_tries=%d, userpass=\"%s\"\n",
83 http
->digest_tries
, http
->userpass
));
84 DEBUG_printf(("cupsDoAuthentication: WWW-Authenticate=\"%s\"\n",
85 httpGetField(http
, HTTP_FIELD_WWW_AUTHENTICATE
)));
88 * Clear the current authentication string...
91 http
->authstring
[0] = '\0';
94 * See if we can do local authentication...
97 if (http
->digest_tries
< 3 && !cups_local_auth(http
))
99 DEBUG_printf(("cupsDoAuthentication: authstring=\"%s\"\n", http
->authstring
));
101 if (http
->status
== HTTP_UNAUTHORIZED
)
102 http
->digest_tries
++;
108 * Nope, see if we should retry the current username:password...
111 if (http
->digest_tries
> 1 || !http
->userpass
[0])
114 * Nope - get a new password from the user...
117 snprintf(prompt
, sizeof(prompt
), _("Password for %s on %s? "), cupsUser(),
118 http
->hostname
[0] == '/' ? "localhost" : http
->hostname
);
120 http
->digest_tries
= strncasecmp(http
->fields
[HTTP_FIELD_WWW_AUTHENTICATE
],
122 http
->userpass
[0] = '\0';
124 if ((password
= cupsGetPassword(prompt
)) == NULL
)
130 snprintf(http
->userpass
, sizeof(http
->userpass
), "%s:%s", cupsUser(),
133 else if (http
->status
== HTTP_UNAUTHORIZED
)
134 http
->digest_tries
++;
137 * Got a password; encode it for the server...
140 if (strncmp(http
->fields
[HTTP_FIELD_WWW_AUTHENTICATE
], "Digest", 6))
143 * Basic authentication...
146 httpEncode64_2(encode
, sizeof(encode
), http
->userpass
,
147 strlen(http
->userpass
));
148 snprintf(http
->authstring
, sizeof(http
->authstring
), "Basic %s", encode
);
153 * Digest authentication...
156 httpGetSubField(http
, HTTP_FIELD_WWW_AUTHENTICATE
, "realm", realm
);
157 httpGetSubField(http
, HTTP_FIELD_WWW_AUTHENTICATE
, "nonce", nonce
);
159 httpMD5(cupsUser(), realm
, strchr(http
->userpass
, ':') + 1, encode
);
160 httpMD5Final(nonce
, method
, resource
, encode
);
161 snprintf(http
->authstring
, sizeof(http
->authstring
),
162 "Digest username=\"%s\", realm=\"%s\", nonce=\"%s\", "
163 "uri=\"%s\", response=\"%s\"", cupsUser(), realm
, nonce
,
167 DEBUG_printf(("cupsDoAuthentication: authstring=\"%s\"\n", http
->authstring
));
174 * 'cups_local_auth()' - Get the local authorization certificate if
175 * available/applicable...
178 static int /* O - 0 if available, -1 if not */
179 cups_local_auth(http_t
*http
) /* I - HTTP connection to server */
181 #if defined(WIN32) || defined(__EMX__)
183 * Currently WIN32 and OS-2 do not support the CUPS server...
188 int pid
; /* Current process ID */
189 FILE *fp
; /* Certificate file */
190 char filename
[1024], /* Certificate filename */
191 certificate
[33]; /* Certificate string */
192 _cups_globals_t
*cg
= _cupsGlobals(); /* Global data */
195 DEBUG_printf(("cups_local_auth(http=%p) hostaddr=%s, hostname=\"%s\"\n",
196 http
, httpAddrString(http
->hostaddr
, filename
, sizeof(filename
)), http
->hostname
));
199 * See if we are accessing localhost...
202 if (!httpAddrLocalhost(http
->hostaddr
) &&
203 strcasecmp(http
->hostname
, "localhost") != 0)
205 DEBUG_puts("cups_local_auth: Not a local connection!");
210 * Try opening a certificate file for this PID. If that fails,
211 * try the root certificate...
215 snprintf(filename
, sizeof(filename
), "%s/certs/%d", cg
->cups_statedir
, pid
);
216 if ((fp
= fopen(filename
, "r")) == NULL
&& pid
> 0)
218 DEBUG_printf(("cups_local_auth: Unable to open file %s: %s\n",
219 filename
, strerror(errno
)));
221 snprintf(filename
, sizeof(filename
), "%s/certs/0", cg
->cups_statedir
);
222 fp
= fopen(filename
, "r");
227 DEBUG_printf(("cups_local_auth: Unable to open file %s: %s\n",
228 filename
, strerror(errno
)));
233 * Read the certificate from the file...
236 fgets(certificate
, sizeof(certificate
), fp
);
240 * Set the authorization string and return...
243 snprintf(http
->authstring
, sizeof(http
->authstring
), "Local %s", certificate
);
245 DEBUG_printf(("cups_local_auth: Returning authstring = \"%s\"\n",
249 #endif /* WIN32 || __EMX__ */
254 * End of "$Id: auth.c 5961 2006-09-16 19:08:36Z mike $".