~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/http_utils.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2011-05-04 12:10:51 UTC
  • mfrom: (5819.1.4 777007-developer-doc)
  • Revision ID: pqm@pqm.ubuntu.com-20110504121051-aovlsmqiivjmc4fc
(jelmer) Small fixes to developer documentation. (Jonathan Riddell)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005 Canonical Ltd
 
1
# Copyright (C) 2005-2011 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
from cStringIO import StringIO
18
 
import errno
19
 
from SimpleHTTPServer import SimpleHTTPRequestHandler
20
 
import socket
21
 
 
22
 
from bzrlib.tests import TestCaseWithTransport
23
 
from bzrlib.tests.HttpServer import (
24
 
    HttpServer,
25
 
    TestingHTTPRequestHandler,
26
 
    )
27
 
from bzrlib.transport import (
28
 
    get_transport,
29
 
    smart,
30
 
    )
31
 
 
32
 
 
33
 
class WallRequestHandler(TestingHTTPRequestHandler):
34
 
    """Whatever request comes in, close the connection"""
35
 
 
36
 
    def handle_one_request(self):
37
 
        """Handle a single HTTP request, by abruptly closing the connection"""
38
 
        self.close_connection = 1
39
 
 
40
 
 
41
 
class BadStatusRequestHandler(TestingHTTPRequestHandler):
42
 
    """Whatever request comes in, returns a bad status"""
43
 
 
44
 
    def parse_request(self):
45
 
        """Fakes handling a single HTTP request, returns a bad status"""
46
 
        ignored = TestingHTTPRequestHandler.parse_request(self)
47
 
        try:
48
 
            self.send_response(0, "Bad status")
49
 
            self.end_headers()
50
 
        except socket.error, e:
51
 
            if (len(e.args) > 0) and (e.args[0] == errno.EPIPE):
52
 
                # We don't want to pollute the test reuslts with
53
 
                # spurious server errors while test succeed. In
54
 
                # our case, it may occur that the test have
55
 
                # already read the 'Bad Status' and closed the
56
 
                # socket while we are still trying to send some
57
 
                # headers... So the test is ok but if we raise
58
 
                # the exception the output is dirty. So we don't
59
 
                # raise, but we close the connection, just to be
60
 
                # safe :)
61
 
                self.close_connection = 1
62
 
                pass
63
 
            else:
64
 
                raise
65
 
        return False
66
 
 
67
 
 
68
 
class InvalidStatusRequestHandler(TestingHTTPRequestHandler):
69
 
    """Whatever request comes in, returns am invalid status"""
70
 
 
71
 
    def parse_request(self):
72
 
        """Fakes handling a single HTTP request, returns a bad status"""
73
 
        ignored = TestingHTTPRequestHandler.parse_request(self)
74
 
        self.wfile.write("Invalid status line\r\n")
75
 
        return False
76
 
 
77
 
 
78
 
class BadProtocolRequestHandler(TestingHTTPRequestHandler):
79
 
    """Whatever request comes in, returns a bad protocol version"""
80
 
 
81
 
    def parse_request(self):
82
 
        """Fakes handling a single HTTP request, returns a bad status"""
83
 
        ignored = TestingHTTPRequestHandler.parse_request(self)
84
 
        # Returns an invalid protocol version, but curl just
85
 
        # ignores it and those cannot be tested.
86
 
        self.wfile.write("%s %d %s\r\n" % ('HTTP/0.0',
87
 
                                           404,
88
 
                                           'Look at my protocol version'))
89
 
        return False
90
 
 
91
 
 
92
 
class ForbiddenRequestHandler(TestingHTTPRequestHandler):
93
 
    """Whatever request comes in, returns a 403 code"""
94
 
 
95
 
    def parse_request(self):
96
 
        """Handle a single HTTP request, by replying we cannot handle it"""
97
 
        ignored = TestingHTTPRequestHandler.parse_request(self)
98
 
        self.send_error(403)
99
 
        return False
100
 
 
101
 
 
102
 
class HTTPServerWithSmarts(HttpServer):
 
18
import re
 
19
import urllib2
 
20
 
 
21
 
 
22
from bzrlib import (
 
23
    errors,
 
24
    osutils,
 
25
    tests,
 
26
    transport,
 
27
    )
 
28
from bzrlib.smart import (
 
29
    medium,
 
30
    )
 
31
from bzrlib.tests import http_server
 
32
from bzrlib.transport import chroot
 
33
 
 
34
 
 
35
class HTTPServerWithSmarts(http_server.HttpServer):
103
36
    """HTTPServerWithSmarts extends the HttpServer with POST methods that will
104
37
    trigger a smart server to execute with a transport rooted at the rootdir of
105
38
    the HTTP server.
106
39
    """
107
40
 
108
 
    def __init__(self):
109
 
        HttpServer.__init__(self, SmartRequestHandler)
110
 
 
111
 
 
112
 
class SmartRequestHandler(TestingHTTPRequestHandler):
113
 
    """Extend TestingHTTPRequestHandler to support smart client POSTs."""
 
41
    def __init__(self, protocol_version=None):
 
42
        http_server.HttpServer.__init__(self, SmartRequestHandler,
 
43
                                        protocol_version=protocol_version)
 
44
 
 
45
 
 
46
class SmartRequestHandler(http_server.TestingHTTPRequestHandler):
 
47
    """Extend TestingHTTPRequestHandler to support smart client POSTs.
 
48
 
 
49
    XXX: This duplicates a fair bit of the logic in bzrlib.transport.http.wsgi.
 
50
    """
114
51
 
115
52
    def do_POST(self):
116
53
        """Hand the request off to a smart server instance."""
 
54
        backing = transport.get_transport(
 
55
            self.server.test_case_server._home_dir)
 
56
        chroot_server = chroot.ChrootServer(backing)
 
57
        chroot_server.start_server()
 
58
        try:
 
59
            t = transport.get_transport(chroot_server.get_url())
 
60
            self.do_POST_inner(t)
 
61
        finally:
 
62
            chroot_server.stop_server()
 
63
 
 
64
    def do_POST_inner(self, chrooted_transport):
117
65
        self.send_response(200)
118
66
        self.send_header("Content-type", "application/octet-stream")
119
 
        transport = get_transport(self.server.test_case._home_dir)
 
67
        if not self.path.endswith('.bzr/smart'):
 
68
            raise AssertionError(
 
69
                'POST to path not ending in .bzr/smart: %r' % (self.path,))
 
70
        t = chrooted_transport.clone(self.path[:-len('.bzr/smart')])
 
71
        # if this fails, we should return 400 bad request, but failure is
 
72
        # failure for now - RBC 20060919
 
73
        data_length = int(self.headers['Content-Length'])
120
74
        # TODO: We might like to support streaming responses.  1.0 allows no
121
75
        # Content-length in this case, so for integrity we should perform our
122
76
        # own chunking within the stream.
124
78
        # the HTTP chunking as this will allow HTTP persistence safely, even if
125
79
        # we have to stop early due to error, but we would also have to use the
126
80
        # HTTP trailer facility which may not be widely available.
 
81
        request_bytes = self.rfile.read(data_length)
 
82
        protocol_factory, unused_bytes = medium._get_protocol_factory_for_bytes(
 
83
            request_bytes)
127
84
        out_buffer = StringIO()
128
 
        smart_protocol_request = smart.SmartServerRequestProtocolOne(
129
 
                transport, out_buffer.write)
130
 
        # if this fails, we should return 400 bad request, but failure is
131
 
        # failure for now - RBC 20060919
132
 
        data_length = int(self.headers['Content-Length'])
 
85
        smart_protocol_request = protocol_factory(t, out_buffer.write, '/')
133
86
        # Perhaps there should be a SmartServerHTTPMedium that takes care of
134
87
        # feeding the bytes in the http request to the smart_protocol_request,
135
88
        # but for now it's simpler to just feed the bytes directly.
136
 
        smart_protocol_request.accept_bytes(self.rfile.read(data_length))
137
 
        assert smart_protocol_request.next_read_size() == 0, (
138
 
            "not finished reading, but all data sent to protocol.")
 
89
        smart_protocol_request.accept_bytes(unused_bytes)
 
90
        if not (smart_protocol_request.next_read_size() == 0):
 
91
            raise errors.SmartProtocolError(
 
92
                "not finished reading, but all data sent to protocol.")
139
93
        self.send_header("Content-Length", str(len(out_buffer.getvalue())))
140
94
        self.end_headers()
141
95
        self.wfile.write(out_buffer.getvalue())
142
96
 
143
97
 
144
 
class SingleRangeRequestHandler(TestingHTTPRequestHandler):
145
 
    """Always reply to range request as if they were single.
146
 
 
147
 
    Don't be explicit about it, just to annoy the clients.
148
 
    """
149
 
 
150
 
    def get_multiple_ranges(self, file, file_size, ranges):
151
 
        """Answer as if it was a single range request and ignores the rest"""
152
 
        (start, end) = ranges[0]
153
 
        return self.get_single_range(file, file_size, start, end)
154
 
 
155
 
 
156
 
class NoRangeRequestHandler(TestingHTTPRequestHandler):
157
 
    """Ignore range requests without notice"""
158
 
 
159
 
    # Just bypass the range handling done by TestingHTTPRequestHandler
160
 
    do_GET = SimpleHTTPRequestHandler.do_GET
161
 
 
162
 
 
163
 
class TestCaseWithWebserver(TestCaseWithTransport):
 
98
class TestCaseWithWebserver(tests.TestCaseWithTransport):
164
99
    """A support class that provides readonly urls that are http://.
165
100
 
166
101
    This is done by forcing the readonly server to be an http
167
102
    one. This will currently fail if the primary transport is not
168
103
    backed by regular disk files.
169
104
    """
 
105
 
 
106
    # These attributes can be overriden or parametrized by daughter clasess if
 
107
    # needed, but must exist so that the create_transport_readonly_server()
 
108
    # method (or any method creating an http(s) server) can propagate it.
 
109
    _protocol_version = None
 
110
    _url_protocol = 'http'
 
111
 
170
112
    def setUp(self):
171
113
        super(TestCaseWithWebserver, self).setUp()
172
 
        self.transport_readonly_server = HttpServer
 
114
        self.transport_readonly_server = http_server.HttpServer
 
115
 
 
116
    def create_transport_readonly_server(self):
 
117
        server = self.transport_readonly_server(
 
118
            protocol_version=self._protocol_version)
 
119
        server._url_protocol = self._url_protocol
 
120
        return server
 
121
 
 
122
 
 
123
class TestCaseWithTwoWebservers(TestCaseWithWebserver):
 
124
    """A support class providing readonly urls on two servers that are http://.
 
125
 
 
126
    We set up two webservers to allows various tests involving
 
127
    proxies or redirections from one server to the other.
 
128
    """
 
129
    def setUp(self):
 
130
        super(TestCaseWithTwoWebservers, self).setUp()
 
131
        self.transport_secondary_server = http_server.HttpServer
 
132
        self.__secondary_server = None
 
133
 
 
134
    def create_transport_secondary_server(self):
 
135
        """Create a transport server from class defined at init.
 
136
 
 
137
        This is mostly a hook for daughter classes.
 
138
        """
 
139
        server = self.transport_secondary_server(
 
140
            protocol_version=self._protocol_version)
 
141
        server._url_protocol = self._url_protocol
 
142
        return server
 
143
 
 
144
    def get_secondary_server(self):
 
145
        """Get the server instance for the secondary transport."""
 
146
        if self.__secondary_server is None:
 
147
            self.__secondary_server = self.create_transport_secondary_server()
 
148
            self.start_server(self.__secondary_server)
 
149
        return self.__secondary_server
 
150
 
 
151
    def get_secondary_url(self, relpath=None):
 
152
        base = self.get_secondary_server().get_url()
 
153
        return self._adjust_url(base, relpath)
 
154
 
 
155
    def get_secondary_transport(self, relpath=None):
 
156
        t = transport.get_transport(self.get_secondary_url(relpath))
 
157
        self.assertTrue(t.is_readonly())
 
158
        return t
 
159
 
 
160
 
 
161
class ProxyServer(http_server.HttpServer):
 
162
    """A proxy test server for http transports."""
 
163
 
 
164
    proxy_requests = True
 
165
 
 
166
 
 
167
class RedirectRequestHandler(http_server.TestingHTTPRequestHandler):
 
168
    """Redirect all request to the specified server"""
 
169
 
 
170
    def parse_request(self):
 
171
        """Redirect a single HTTP request to another host"""
 
172
        valid = http_server.TestingHTTPRequestHandler.parse_request(self)
 
173
        if valid:
 
174
            tcs = self.server.test_case_server
 
175
            code, target = tcs.is_redirected(self.path)
 
176
            if code is not None and target is not None:
 
177
                # Redirect as instructed
 
178
                self.send_response(code)
 
179
                self.send_header('Location', target)
 
180
                # We do not send a body
 
181
                self.send_header('Content-Length', '0')
 
182
                self.end_headers()
 
183
                return False # The job is done
 
184
            else:
 
185
                # We leave the parent class serve the request
 
186
                pass
 
187
        return valid
 
188
 
 
189
 
 
190
class HTTPServerRedirecting(http_server.HttpServer):
 
191
    """An HttpServer redirecting to another server """
 
192
 
 
193
    def __init__(self, request_handler=RedirectRequestHandler,
 
194
                 protocol_version=None):
 
195
        http_server.HttpServer.__init__(self, request_handler,
 
196
                                        protocol_version=protocol_version)
 
197
        # redirections is a list of tuples (source, target, code)
 
198
        # - source is a regexp for the paths requested
 
199
        # - target is a replacement for re.sub describing where
 
200
        #   the request will be redirected
 
201
        # - code is the http error code associated to the
 
202
        #   redirection (301 permanent, 302 temporarry, etc
 
203
        self.redirections = []
 
204
 
 
205
    def redirect_to(self, host, port):
 
206
        """Redirect all requests to a specific host:port"""
 
207
        self.redirections = [('(.*)',
 
208
                              r'http://%s:%s\1' % (host, port) ,
 
209
                              301)]
 
210
 
 
211
    def is_redirected(self, path):
 
212
        """Is the path redirected by this server.
 
213
 
 
214
        :param path: the requested relative path
 
215
 
 
216
        :returns: a tuple (code, target) if a matching
 
217
             redirection is found, (None, None) otherwise.
 
218
        """
 
219
        code = None
 
220
        target = None
 
221
        for (rsource, rtarget, rcode) in self.redirections:
 
222
            target, match = re.subn(rsource, rtarget, path)
 
223
            if match:
 
224
                code = rcode
 
225
                break # The first match wins
 
226
            else:
 
227
                target = None
 
228
        return code, target
 
229
 
 
230
 
 
231
class TestCaseWithRedirectedWebserver(TestCaseWithTwoWebservers):
 
232
   """A support class providing redirections from one server to another.
 
233
 
 
234
   We set up two webservers to allows various tests involving
 
235
   redirections.
 
236
   The 'old' server is redirected to the 'new' server.
 
237
   """
 
238
 
 
239
   def setUp(self):
 
240
       super(TestCaseWithRedirectedWebserver, self).setUp()
 
241
       # The redirections will point to the new server
 
242
       self.new_server = self.get_readonly_server()
 
243
       # The requests to the old server will be redirected to the new server
 
244
       self.old_server = self.get_secondary_server()
 
245
 
 
246
   def create_transport_secondary_server(self):
 
247
       """Create the secondary server redirecting to the primary server"""
 
248
       new = self.get_readonly_server()
 
249
       redirecting = HTTPServerRedirecting(
 
250
           protocol_version=self._protocol_version)
 
251
       redirecting.redirect_to(new.host, new.port)
 
252
       redirecting._url_protocol = self._url_protocol
 
253
       return redirecting
 
254
 
 
255
   def get_old_url(self, relpath=None):
 
256
        base = self.old_server.get_url()
 
257
        return self._adjust_url(base, relpath)
 
258
 
 
259
   def get_old_transport(self, relpath=None):
 
260
        t = transport.get_transport(self.get_old_url(relpath))
 
261
        self.assertTrue(t.is_readonly())
 
262
        return t
 
263
 
 
264
   def get_new_url(self, relpath=None):
 
265
        base = self.new_server.get_url()
 
266
        return self._adjust_url(base, relpath)
 
267
 
 
268
   def get_new_transport(self, relpath=None):
 
269
        t = transport.get_transport(self.get_new_url(relpath))
 
270
        self.assertTrue(t.is_readonly())
 
271
        return t
 
272
 
 
273
 
 
274
class AuthRequestHandler(http_server.TestingHTTPRequestHandler):
 
275
    """Requires an authentication to process requests.
 
276
 
 
277
    This is intended to be used with a server that always and
 
278
    only use one authentication scheme (implemented by daughter
 
279
    classes).
 
280
    """
 
281
 
 
282
    # The following attributes should be defined in the server
 
283
    # - auth_header_sent: the header name sent to require auth
 
284
    # - auth_header_recv: the header received containing auth
 
285
    # - auth_error_code: the error code to indicate auth required
 
286
 
 
287
    def do_GET(self):
 
288
        if self.authorized():
 
289
            return http_server.TestingHTTPRequestHandler.do_GET(self)
 
290
        else:
 
291
            # Note that we must update test_case_server *before*
 
292
            # sending the error or the client may try to read it
 
293
            # before we have sent the whole error back.
 
294
            tcs = self.server.test_case_server
 
295
            tcs.auth_required_errors += 1
 
296
            self.send_response(tcs.auth_error_code)
 
297
            self.send_header_auth_reqed()
 
298
            # We do not send a body
 
299
            self.send_header('Content-Length', '0')
 
300
            self.end_headers()
 
301
            return
 
302
 
 
303
 
 
304
class BasicAuthRequestHandler(AuthRequestHandler):
 
305
    """Implements the basic authentication of a request"""
 
306
 
 
307
    def authorized(self):
 
308
        tcs = self.server.test_case_server
 
309
        if tcs.auth_scheme != 'basic':
 
310
            return False
 
311
 
 
312
        auth_header = self.headers.get(tcs.auth_header_recv, None)
 
313
        if auth_header:
 
314
            scheme, raw_auth = auth_header.split(' ', 1)
 
315
            if scheme.lower() == tcs.auth_scheme:
 
316
                user, password = raw_auth.decode('base64').split(':')
 
317
                return tcs.authorized(user, password)
 
318
 
 
319
        return False
 
320
 
 
321
    def send_header_auth_reqed(self):
 
322
        tcs = self.server.test_case_server
 
323
        self.send_header(tcs.auth_header_sent,
 
324
                         'Basic realm="%s"' % tcs.auth_realm)
 
325
 
 
326
 
 
327
# FIXME: We could send an Authentication-Info header too when
 
328
# the authentication is succesful
 
329
 
 
330
class DigestAuthRequestHandler(AuthRequestHandler):
 
331
    """Implements the digest authentication of a request.
 
332
 
 
333
    We need persistence for some attributes and that can't be
 
334
    achieved here since we get instantiated for each request. We
 
335
    rely on the DigestAuthServer to take care of them.
 
336
    """
 
337
 
 
338
    def authorized(self):
 
339
        tcs = self.server.test_case_server
 
340
 
 
341
        auth_header = self.headers.get(tcs.auth_header_recv, None)
 
342
        if auth_header is None:
 
343
            return False
 
344
        scheme, auth = auth_header.split(None, 1)
 
345
        if scheme.lower() == tcs.auth_scheme:
 
346
            auth_dict = urllib2.parse_keqv_list(urllib2.parse_http_list(auth))
 
347
 
 
348
            return tcs.digest_authorized(auth_dict, self.command)
 
349
 
 
350
        return False
 
351
 
 
352
    def send_header_auth_reqed(self):
 
353
        tcs = self.server.test_case_server
 
354
        header = 'Digest realm="%s", ' % tcs.auth_realm
 
355
        header += 'nonce="%s", algorithm="%s", qop="auth"' % (tcs.auth_nonce,
 
356
                                                              'MD5')
 
357
        self.send_header(tcs.auth_header_sent,header)
 
358
 
 
359
 
 
360
class DigestAndBasicAuthRequestHandler(DigestAuthRequestHandler):
 
361
    """Implements a digest and basic authentication of a request.
 
362
 
 
363
    I.e. the server proposes both schemes and the client should choose the best
 
364
    one it can handle, which, in that case, should be digest, the only scheme
 
365
    accepted here.
 
366
    """
 
367
 
 
368
    def send_header_auth_reqed(self):
 
369
        tcs = self.server.test_case_server
 
370
        self.send_header(tcs.auth_header_sent,
 
371
                         'Basic realm="%s"' % tcs.auth_realm)
 
372
        header = 'Digest realm="%s", ' % tcs.auth_realm
 
373
        header += 'nonce="%s", algorithm="%s", qop="auth"' % (tcs.auth_nonce,
 
374
                                                              'MD5')
 
375
        self.send_header(tcs.auth_header_sent,header)
 
376
 
 
377
 
 
378
class AuthServer(http_server.HttpServer):
 
379
    """Extends HttpServer with a dictionary of passwords.
 
380
 
 
381
    This is used as a base class for various schemes which should
 
382
    all use or redefined the associated AuthRequestHandler.
 
383
 
 
384
    Note that no users are defined by default, so add_user should
 
385
    be called before issuing the first request.
 
386
    """
 
387
 
 
388
    # The following attributes should be set dy daughter classes
 
389
    # and are used by AuthRequestHandler.
 
390
    auth_header_sent = None
 
391
    auth_header_recv = None
 
392
    auth_error_code = None
 
393
    auth_realm = "Thou should not pass"
 
394
 
 
395
    def __init__(self, request_handler, auth_scheme,
 
396
                 protocol_version=None):
 
397
        http_server.HttpServer.__init__(self, request_handler,
 
398
                                        protocol_version=protocol_version)
 
399
        self.auth_scheme = auth_scheme
 
400
        self.password_of = {}
 
401
        self.auth_required_errors = 0
 
402
 
 
403
    def add_user(self, user, password):
 
404
        """Declare a user with an associated password.
 
405
 
 
406
        password can be empty, use an empty string ('') in that
 
407
        case, not None.
 
408
        """
 
409
        self.password_of[user] = password
 
410
 
 
411
    def authorized(self, user, password):
 
412
        """Check that the given user provided the right password"""
 
413
        expected_password = self.password_of.get(user, None)
 
414
        return expected_password is not None and password == expected_password
 
415
 
 
416
 
 
417
# FIXME: There is some code duplication with
 
418
# _urllib2_wrappers.py.DigestAuthHandler. If that duplication
 
419
# grows, it may require a refactoring. Also, we don't implement
 
420
# SHA algorithm nor MD5-sess here, but that does not seem worth
 
421
# it.
 
422
class DigestAuthServer(AuthServer):
 
423
    """A digest authentication server"""
 
424
 
 
425
    auth_nonce = 'now!'
 
426
 
 
427
    def __init__(self, request_handler, auth_scheme,
 
428
                 protocol_version=None):
 
429
        AuthServer.__init__(self, request_handler, auth_scheme,
 
430
                            protocol_version=protocol_version)
 
431
 
 
432
    def digest_authorized(self, auth, command):
 
433
        nonce = auth['nonce']
 
434
        if nonce != self.auth_nonce:
 
435
            return False
 
436
        realm = auth['realm']
 
437
        if realm != self.auth_realm:
 
438
            return False
 
439
        user = auth['username']
 
440
        if not self.password_of.has_key(user):
 
441
            return False
 
442
        algorithm= auth['algorithm']
 
443
        if algorithm != 'MD5':
 
444
            return False
 
445
        qop = auth['qop']
 
446
        if qop != 'auth':
 
447
            return False
 
448
 
 
449
        password = self.password_of[user]
 
450
 
 
451
        # Recalculate the response_digest to compare with the one
 
452
        # sent by the client
 
453
        A1 = '%s:%s:%s' % (user, realm, password)
 
454
        A2 = '%s:%s' % (command, auth['uri'])
 
455
 
 
456
        H = lambda x: osutils.md5(x).hexdigest()
 
457
        KD = lambda secret, data: H("%s:%s" % (secret, data))
 
458
 
 
459
        nonce_count = int(auth['nc'], 16)
 
460
 
 
461
        ncvalue = '%08x' % nonce_count
 
462
 
 
463
        cnonce = auth['cnonce']
 
464
        noncebit = '%s:%s:%s:%s:%s' % (nonce, ncvalue, cnonce, qop, H(A2))
 
465
        response_digest = KD(H(A1), noncebit)
 
466
 
 
467
        return response_digest == auth['response']
 
468
 
 
469
 
 
470
class HTTPAuthServer(AuthServer):
 
471
    """An HTTP server requiring authentication"""
 
472
 
 
473
    def init_http_auth(self):
 
474
        self.auth_header_sent = 'WWW-Authenticate'
 
475
        self.auth_header_recv = 'Authorization'
 
476
        self.auth_error_code = 401
 
477
 
 
478
 
 
479
class ProxyAuthServer(AuthServer):
 
480
    """A proxy server requiring authentication"""
 
481
 
 
482
    def init_proxy_auth(self):
 
483
        self.proxy_requests = True
 
484
        self.auth_header_sent = 'Proxy-Authenticate'
 
485
        self.auth_header_recv = 'Proxy-Authorization'
 
486
        self.auth_error_code = 407
 
487
 
 
488
 
 
489
class HTTPBasicAuthServer(HTTPAuthServer):
 
490
    """An HTTP server requiring basic authentication"""
 
491
 
 
492
    def __init__(self, protocol_version=None):
 
493
        HTTPAuthServer.__init__(self, BasicAuthRequestHandler, 'basic',
 
494
                                protocol_version=protocol_version)
 
495
        self.init_http_auth()
 
496
 
 
497
 
 
498
class HTTPDigestAuthServer(DigestAuthServer, HTTPAuthServer):
 
499
    """An HTTP server requiring digest authentication"""
 
500
 
 
501
    def __init__(self, protocol_version=None):
 
502
        DigestAuthServer.__init__(self, DigestAuthRequestHandler, 'digest',
 
503
                                  protocol_version=protocol_version)
 
504
        self.init_http_auth()
 
505
 
 
506
 
 
507
class HTTPBasicAndDigestAuthServer(DigestAuthServer, HTTPAuthServer):
 
508
    """An HTTP server requiring basic or digest authentication"""
 
509
 
 
510
    def __init__(self, protocol_version=None):
 
511
        DigestAuthServer.__init__(self, DigestAndBasicAuthRequestHandler,
 
512
                                  'basicdigest',
 
513
                                  protocol_version=protocol_version)
 
514
        self.init_http_auth()
 
515
        # We really accept Digest only
 
516
        self.auth_scheme = 'digest'
 
517
 
 
518
 
 
519
class ProxyBasicAuthServer(ProxyAuthServer):
 
520
    """A proxy server requiring basic authentication"""
 
521
 
 
522
    def __init__(self, protocol_version=None):
 
523
        ProxyAuthServer.__init__(self, BasicAuthRequestHandler, 'basic',
 
524
                                 protocol_version=protocol_version)
 
525
        self.init_proxy_auth()
 
526
 
 
527
 
 
528
class ProxyDigestAuthServer(DigestAuthServer, ProxyAuthServer):
 
529
    """A proxy server requiring basic authentication"""
 
530
 
 
531
    def __init__(self, protocol_version=None):
 
532
        ProxyAuthServer.__init__(self, DigestAuthRequestHandler, 'digest',
 
533
                                 protocol_version=protocol_version)
 
534
        self.init_proxy_auth()
 
535
 
 
536
 
 
537
class ProxyBasicAndDigestAuthServer(DigestAuthServer, ProxyAuthServer):
 
538
    """An proxy server requiring basic or digest authentication"""
 
539
 
 
540
    def __init__(self, protocol_version=None):
 
541
        DigestAuthServer.__init__(self, DigestAndBasicAuthRequestHandler,
 
542
                                  'basicdigest',
 
543
                                  protocol_version=protocol_version)
 
544
        self.init_proxy_auth()
 
545
        # We really accept Digest only
 
546
        self.auth_scheme = 'digest'
 
547
 
 
548