54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
1 ;;; url-auth.el --- Uniform Resource Locator authorization modules
|
57612
|
2
|
95612
|
3 ;; Copyright (C) 1996, 1997, 1998, 1999, 2004, 2005, 2006, 2007,
|
|
4 ;; 2008 Free Software Foundation, Inc.
|
57612
|
5
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
6 ;; Keywords: comm, data, processes, hypermedia
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
7
|
57612
|
8 ;; This file is part of GNU Emacs.
|
|
9
|
94668
|
10 ;; GNU Emacs is free software: you can redistribute it and/or modify
|
57612
|
11 ;; it under the terms of the GNU General Public License as published by
|
94668
|
12 ;; the Free Software Foundation, either version 3 of the License, or
|
|
13 ;; (at your option) any later version.
|
57612
|
14
|
|
15 ;; GNU Emacs is distributed in the hope that it will be useful,
|
|
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
18 ;; GNU General Public License for more details.
|
|
19
|
|
20 ;; You should have received a copy of the GNU General Public License
|
94668
|
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|
57612
|
22
|
|
23 ;;; Code:
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
24
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
25 (require 'url-vars)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
26 (require 'url-parse)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
27 (autoload 'url-warn "url")
|
95612
|
28 (autoload 'auth-source-user-or-password "auth-source")
|
94879
|
29
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
30 (defsubst url-auth-user-prompt (url realm)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
31 "String to usefully prompt for a username."
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
32 (concat "Username [for "
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
33 (or realm (url-truncate-url-for-viewing
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
34 (url-recreate-url url)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
35 (- (window-width) 10 20)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
36 "]: "))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
37
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
38 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
39 ;;; Basic authorization code
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
40 ;;; ------------------------
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
41 ;;; This implements the BASIC authorization type. See the online
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
42 ;;; documentation at
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
43 ;;; http://www.w3.org/hypertext/WWW/AccessAuthorization/Basic.html
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
44 ;;; for the complete documentation on this type.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
45 ;;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
46 ;;; This is very insecure, but it works as a proof-of-concept
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
47 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
48 (defvar url-basic-auth-storage 'url-http-real-basic-auth-storage
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
49 "Where usernames and passwords are stored.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
50
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
51 Must be a symbol pointing to another variable that will actually store
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
52 the information. The value of this variable is an assoc list of assoc
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
53 lists. The first assoc list is keyed by the server name. The cdr of
|
96486
|
54 this is an assoc list based on the 'directory' specified by the URL we
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
55 are looking up.")
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
56
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
57 (defun url-basic-auth (url &optional prompt overwrite realm args)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
58 "Get the username/password for the specified URL.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
59 If optional argument PROMPT is non-nil, ask for the username/password
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
60 to use for the url and its descendants. If optional third argument
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
61 OVERWRITE is non-nil, overwrite the old username/password pair if it
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
62 is found in the assoc list. If REALM is specified, use that as the realm
|
79065
|
63 instead of the filename inheritance method."
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
64 (let* ((href (if (stringp url)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
65 (url-generic-parse-url url)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
66 url))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
67 (server (url-host href))
|
94879
|
68 (type (url-type href))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
69 (port (url-port href))
|
79065
|
70 (file (url-filename href))
|
78514
|
71 (user (url-user href))
|
|
72 (pass (url-password href))
|
|
73 byserv retval data)
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
74 (setq server (format "%s:%d" server port)
|
79065
|
75 file (cond
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
76 (realm realm)
|
79065
|
77 ((string= "" file) "/")
|
|
78 ((string-match "/$" file) file)
|
|
79 (t (url-file-directory file)))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
80 byserv (cdr-safe (assoc server
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
81 (symbol-value url-basic-auth-storage))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
82 (cond
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
83 ((and prompt (not byserv))
|
95612
|
84 (setq user (or
|
94879
|
85 (auth-source-user-or-password "login" server type)
|
|
86 (read-string (url-auth-user-prompt url realm)
|
|
87 (or user (user-real-login-name))))
|
95612
|
88 pass (or
|
94879
|
89 (auth-source-user-or-password "password" server type)
|
|
90 (read-passwd "Password: " nil (or pass ""))))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
91 (set url-basic-auth-storage
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
92 (cons (list server
|
79065
|
93 (cons file
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
94 (setq retval
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
95 (base64-encode-string
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
96 (format "%s:%s" user pass)))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
97 (symbol-value url-basic-auth-storage))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
98 (byserv
|
79065
|
99 (setq retval (cdr-safe (assoc file byserv)))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
100 (if (and (not retval)
|
79065
|
101 (string-match "/" file))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
102 (while (and byserv (not retval))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
103 (setq data (car (car byserv)))
|
75519
|
104 (if (or (not (string-match "/" data)) ; It's a realm - take it!
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
105 (and
|
79065
|
106 (>= (length file) (length data))
|
|
107 (string= data (substring file 0 (length data)))))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
108 (setq retval (cdr (car byserv))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
109 (setq byserv (cdr byserv))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
110 (if (or (and (not retval) prompt) overwrite)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
111 (progn
|
95612
|
112 (setq user (or
|
94879
|
113 (auth-source-user-or-password "login" server type)
|
|
114 (read-string (url-auth-user-prompt url realm)
|
|
115 (user-real-login-name)))
|
95612
|
116 pass (or
|
94879
|
117 (auth-source-user-or-password "password" server type)
|
|
118 (read-passwd "Password: "))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
119 retval (base64-encode-string (format "%s:%s" user pass))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
120 byserv (assoc server (symbol-value url-basic-auth-storage)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
121 (setcdr byserv
|
79065
|
122 (cons (cons file retval) (cdr byserv))))))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
123 (t (setq retval nil)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
124 (if retval (setq retval (concat "Basic " retval)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
125 retval))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
126
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
127 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
128 ;;; Digest authorization code
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
129 ;;; ------------------------
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
130 ;;; This implements the DIGEST authorization type. See the internet draft
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
131 ;;; ftp://ds.internic.net/internet-drafts/draft-ietf-http-digest-aa-01.txt
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
132 ;;; for the complete documentation on this type.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
133 ;;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
134 ;;; This is very secure
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
135 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
136 (defvar url-digest-auth-storage nil
|
96486
|
137 "Where usernames and passwords are stored.
|
|
138 Its value is an assoc list of assoc lists. The first assoc list is
|
|
139 keyed by the server name. The cdr of this is an assoc list based
|
|
140 on the 'directory' specified by the url we are looking up.")
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
141
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
142 (defun url-digest-auth-create-key (username password realm method uri)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
143 "Create a key for digest authentication method"
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
144 (let* ((info (if (stringp uri)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
145 (url-generic-parse-url uri)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
146 uri))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
147 (a1 (md5 (concat username ":" realm ":" password)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
148 (a2 (md5 (concat method ":" (url-filename info)))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
149 (list a1 a2)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
150
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
151 (defun url-digest-auth (url &optional prompt overwrite realm args)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
152 "Get the username/password for the specified URL.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
153 If optional argument PROMPT is non-nil, ask for the username/password
|
96486
|
154 to use for the URL and its descendants. If optional third argument
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
155 OVERWRITE is non-nil, overwrite the old username/password pair if it
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
156 is found in the assoc list. If REALM is specified, use that as the realm
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
157 instead of hostname:portnum."
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
158 (if args
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
159 (let* ((href (if (stringp url)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
160 (url-generic-parse-url url)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
161 url))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
162 (server (url-host href))
|
94879
|
163 (type (url-type href))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
164 (port (url-port href))
|
79065
|
165 (file (url-filename href))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
166 user pass byserv retval data)
|
79065
|
167 (setq file (cond
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
168 (realm realm)
|
79065
|
169 ((string-match "/$" file) file)
|
|
170 (t (url-file-directory file)))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
171 server (format "%s:%d" server port)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
172 byserv (cdr-safe (assoc server url-digest-auth-storage)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
173 (cond
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
174 ((and prompt (not byserv))
|
94879
|
175 (setq user (or
|
|
176 (auth-source-user-or-password "login" server type)
|
|
177 (read-string (url-auth-user-prompt url realm)
|
|
178 (user-real-login-name)))
|
|
179 pass (or
|
|
180 (auth-source-user-or-password "password" server type)
|
|
181 (read-passwd "Password: "))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
182 url-digest-auth-storage
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
183 (cons (list server
|
79065
|
184 (cons file
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
185 (setq retval
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
186 (cons user
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
187 (url-digest-auth-create-key
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
188 user pass realm
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
189 (or url-request-method "GET")
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
190 url)))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
191 url-digest-auth-storage)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
192 (byserv
|
79065
|
193 (setq retval (cdr-safe (assoc file byserv)))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
194 (if (and (not retval) ; no exact match, check directories
|
79065
|
195 (string-match "/" file)) ; not looking for a realm
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
196 (while (and byserv (not retval))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
197 (setq data (car (car byserv)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
198 (if (or (not (string-match "/" data))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
199 (and
|
79065
|
200 (>= (length file) (length data))
|
|
201 (string= data (substring file 0 (length data)))))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
202 (setq retval (cdr (car byserv))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
203 (setq byserv (cdr byserv))))
|
88054
|
204 (if overwrite
|
|
205 (if (and (not retval) prompt)
|
95612
|
206 (setq user (or
|
94879
|
207 (auth-source-user-or-password "login" server type)
|
|
208 (read-string (url-auth-user-prompt url realm)
|
|
209 (user-real-login-name)))
|
95612
|
210 pass (or
|
94879
|
211 (auth-source-user-or-password "password" server type)
|
|
212 (read-passwd "Password: "))
|
88054
|
213 retval (setq retval
|
|
214 (cons user
|
|
215 (url-digest-auth-create-key
|
|
216 user pass realm
|
|
217 (or url-request-method "GET")
|
|
218 url)))
|
|
219 byserv (assoc server url-digest-auth-storage))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
220 (setcdr byserv
|
79065
|
221 (cons (cons file retval) (cdr byserv))))))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
222 (t (setq retval nil)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
223 (if retval
|
88054
|
224 (if (cdr-safe (assoc "opaque" args))
|
|
225 (let ((nonce (or (cdr-safe (assoc "nonce" args)) "nonegiven"))
|
|
226 (opaque (cdr-safe (assoc "opaque" args))))
|
|
227 (format
|
|
228 (concat "Digest username=\"%s\", realm=\"%s\","
|
|
229 "nonce=\"%s\", uri=\"%s\","
|
|
230 "response=\"%s\", opaque=\"%s\"")
|
|
231 (nth 0 retval) realm nonce (url-filename href)
|
|
232 (md5 (concat (nth 1 retval) ":" nonce ":"
|
|
233 (nth 2 retval))) opaque))
|
|
234 (let ((nonce (or (cdr-safe (assoc "nonce" args)) "nonegiven")))
|
|
235 (format
|
|
236 (concat "Digest username=\"%s\", realm=\"%s\","
|
|
237 "nonce=\"%s\", uri=\"%s\","
|
|
238 "response=\"%s\"")
|
|
239 (nth 0 retval) realm nonce (url-filename href)
|
|
240 (md5 (concat (nth 1 retval) ":" nonce ":"
|
|
241 (nth 2 retval))))))))))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
242
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
243 (defvar url-registered-auth-schemes nil
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
244 "A list of the registered authorization schemes and various and sundry
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
245 information associated with them.")
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
246
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
247 ;;;###autoload
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
248 (defun url-get-authentication (url realm type prompt &optional args)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
249 "Return an authorization string suitable for use in the WWW-Authenticate
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
250 header in an HTTP/1.0 request.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
251
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
252 URL is the url you are requesting authorization to. This can be either a
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
253 string representing the URL, or the parsed representation returned by
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
254 `url-generic-parse-url'
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
255 REALM is the realm at a specific site we are looking for. This should be a
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
256 string specifying the exact realm, or nil or the symbol 'any' to
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
257 specify that the filename portion of the URL should be used as the
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
258 realm
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
259 TYPE is the type of authentication to be returned. This is either a string
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
260 representing the type (basic, digest, etc), or nil or the symbol 'any'
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
261 to specify that any authentication is acceptable. If requesting 'any'
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
262 the strongest matching authentication will be returned. If this is
|
75519
|
263 wrong, it's no big deal, the error from the server will specify exactly
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
264 what type of auth to use
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
265 PROMPT is boolean - specifies whether to ask the user for a username/password
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
266 if one cannot be found in the cache"
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
267 (if (not realm)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
268 (setq realm (cdr-safe (assoc "realm" args))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
269 (if (stringp url)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
270 (setq url (url-generic-parse-url url)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
271 (if (or (null type) (eq type 'any))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
272 ;; Whooo doogies!
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
273 ;; Go through and get _all_ the authorization strings that could apply
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
274 ;; to this URL, store them along with the 'rating' we have in the list
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
275 ;; of schemes, then sort them so that the 'best' is at the front of the
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
276 ;; list, then get the car, then get the cdr.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
277 ;; Zooom zooom zoooooom
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
278 (cdr-safe
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
279 (car-safe
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
280 (sort
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
281 (mapcar
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
282 (function
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
283 (lambda (scheme)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
284 (if (fboundp (car (cdr scheme)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
285 (cons (cdr (cdr scheme))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
286 (funcall (car (cdr scheme)) url nil nil realm))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
287 (cons 0 nil))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
288 url-registered-auth-schemes)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
289 (function
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
290 (lambda (x y)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
291 (cond
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
292 ((null (cdr x)) nil)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
293 ((and (cdr x) (null (cdr y))) t)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
294 ((and (cdr x) (cdr y))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
295 (>= (car x) (car y)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
296 (t nil)))))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
297 (if (symbolp type) (setq type (symbol-name type)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
298 (let* ((scheme (car-safe
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
299 (cdr-safe (assoc (downcase type)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
300 url-registered-auth-schemes)))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
301 (if (and scheme (fboundp scheme))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
302 (funcall scheme url prompt
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
303 (and prompt
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
304 (funcall scheme url nil nil realm args))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
305 realm args)))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
306
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
307 ;;;###autoload
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
308 (defun url-register-auth-scheme (type &optional function rating)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
309 "Register an HTTP authentication method.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
310
|
96486
|
311 TYPE is a string or symbol specifying the name of the method.
|
|
312 This should be the same thing you expect to get returned in
|
|
313 an Authenticate header in HTTP/1.0 - it will be downcased.
|
|
314 FUNCTION is the function to call to get the authorization information.
|
|
315 This defaults to `url-?-auth', where ? is TYPE.
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
316 RATING a rating between 1 and 10 of the strength of the authentication.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
317 This is used when asking for the best authentication for a specific
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
318 URL. The item with the highest rating is returned."
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
319 (let* ((type (cond
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
320 ((stringp type) (downcase type))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
321 ((symbolp type) (downcase (symbol-name type)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
322 (t (error "Bad call to `url-register-auth-scheme'"))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
323 (function (or function (intern (concat "url-" type "-auth"))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
324 (rating (cond
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
325 ((null rating) 2)
|
62400
|
326 ((stringp rating) (string-to-number rating))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
327 (t rating)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
328 (node (assoc type url-registered-auth-schemes)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
329 (if (not (fboundp function))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
330 (url-warn 'security
|
54792
|
331 (format (concat
|
|
332 "Tried to register `%s' as an auth scheme"
|
|
333 ", but it is not a function!") function)))
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
334
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
335 (if node
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
336 (setcdr node (cons function rating))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
337 (setq url-registered-auth-schemes
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
338 (cons (cons type (cons function rating))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
339 url-registered-auth-schemes)))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
340
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
341 (defun url-auth-registered (scheme)
|
78481
|
342 "Return non-nil if SCHEME is registered as an auth type."
|
54695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
343 (assoc scheme url-registered-auth-schemes))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
344
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
345 (provide 'url-auth)
|
54699
|
346
|
84378
|
347 ;; arch-tag: 04058625-616d-44e4-9dbf-4b46b00b2a91
|
57612
|
348 ;;; url-auth.el ends here
|