|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
|
|
|
|
"""
|
|
|
|
requests.auth
|
|
|
|
~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
This module contains the authentication handlers for Requests.
|
|
|
|
"""
|
|
|
|
|
|
|
|
from __future__ import unicode_literals
|
|
|
|
|
|
|
|
import time
|
|
|
|
import hashlib
|
|
|
|
|
|
|
|
from base64 import b64encode
|
|
|
|
from .compat import urlparse, str, bytes
|
|
|
|
from .utils import randombytes, parse_dict_header
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _basic_auth_str(username, password):
|
|
|
|
"""Returns a Basic Auth string."""
|
|
|
|
|
|
|
|
return 'Basic ' + b64encode(("%s:%s" % (username, password)).encode('utf-8')).strip().decode('utf-8')
|
|
|
|
|
|
|
|
|
|
|
|
class AuthBase(object):
|
|
|
|
"""Base class that all auth implementations derive from"""
|
|
|
|
|
|
|
|
def __call__(self, r):
|
|
|
|
raise NotImplementedError('Auth hooks must be callable.')
|
|
|
|
|
|
|
|
|
|
|
|
class HTTPBasicAuth(AuthBase):
|
|
|
|
"""Attaches HTTP Basic Authentication to the given Request object."""
|
|
|
|
def __init__(self, username, password):
|
|
|
|
self.username = username
|
|
|
|
self.password = password
|
|
|
|
|
|
|
|
def __call__(self, r):
|
|
|
|
r.headers['Authorization'] = _basic_auth_str(self.username, self.password)
|
|
|
|
return r
|
|
|
|
|
|
|
|
|
|
|
|
class HTTPProxyAuth(HTTPBasicAuth):
|
|
|
|
"""Attaches HTTP Proxy Authenetication to a given Request object."""
|
|
|
|
def __call__(self, r):
|
|
|
|
r.headers['Proxy-Authorization'] = _basic_auth_str(self.username, self.password)
|
|
|
|
return r
|
|
|
|
|
|
|
|
|
|
|
|
class HTTPDigestAuth(AuthBase):
|
|
|
|
"""Attaches HTTP Digest Authentication to the given Request object."""
|
|
|
|
def __init__(self, username, password):
|
|
|
|
self.username = username
|
|
|
|
self.password = password
|
|
|
|
|
|
|
|
def handle_401(self, r):
|
|
|
|
"""Takes the given response and tries digest-auth, if needed."""
|
|
|
|
|
|
|
|
s_auth = r.headers.get('www-authenticate', '')
|
|
|
|
|
|
|
|
if 'digest' in s_auth.lower():
|
|
|
|
|
|
|
|
last_nonce = ''
|
|
|
|
nonce_count = 0
|
|
|
|
|
|
|
|
chal = parse_dict_header(s_auth.replace('Digest ', ''))
|
|
|
|
|
|
|
|
realm = chal['realm']
|
|
|
|
nonce = chal['nonce']
|
|
|
|
qop = chal.get('qop')
|
|
|
|
algorithm = chal.get('algorithm', 'MD5')
|
|
|
|
opaque = chal.get('opaque', None)
|
|
|
|
|
|
|
|
algorithm = algorithm.upper()
|
|
|
|
# lambdas assume digest modules are imported at the top level
|
|
|
|
if algorithm == 'MD5':
|
|
|
|
def h(x):
|
|
|
|
if isinstance(x, str):
|
|
|
|
x = x.encode('utf-8')
|
|
|
|
return hashlib.md5(x).hexdigest()
|
|
|
|
H = h
|
|
|
|
elif algorithm == 'SHA':
|
|
|
|
def h(x):
|
|
|
|
if isinstance(x, str):
|
|
|
|
x = x.encode('utf-8')
|
|
|
|
return hashlib.sha1(x).hexdigest()
|
|
|
|
H = h
|
|
|
|
# XXX MD5-sess
|
|
|
|
KD = lambda s, d: H("%s:%s" % (s, d))
|
|
|
|
|
|
|
|
if H is None:
|
|
|
|
return None
|
|
|
|
|
|
|
|
# XXX not implemented yet
|
|
|
|
entdig = None
|
|
|
|
p_parsed = urlparse(r.request.url)
|
|
|
|
path = p_parsed.path
|
|
|
|
if p_parsed.query:
|
|
|
|
path += '?' + p_parsed.query
|
|
|
|
|
|
|
|
A1 = '%s:%s:%s' % (self.username, realm, self.password)
|
|
|
|
A2 = '%s:%s' % (r.request.method, path)
|
|
|
|
|
|
|
|
if qop == 'auth':
|
|
|
|
if nonce == last_nonce:
|
|
|
|
nonce_count += 1
|
|
|
|
else:
|
|
|
|
nonce_count = 1
|
|
|
|
last_nonce = nonce
|
|
|
|
|
|
|
|
ncvalue = '%08x' % nonce_count
|
|
|
|
s = str(nonce_count).encode('utf-8')
|
|
|
|
s += nonce.encode('utf-8')
|
|
|
|
s += time.ctime().encode('utf-8')
|
|
|
|
s += randombytes(8)
|
|
|
|
|
|
|
|
cnonce = (hashlib.sha1(s).hexdigest()[:16])
|
|
|
|
noncebit = "%s:%s:%s:%s:%s" % (nonce, ncvalue, cnonce, qop, H(A2))
|
|
|
|
respdig = KD(H(A1), noncebit)
|
|
|
|
elif qop is None:
|
|
|
|
respdig = KD(H(A1), "%s:%s" % (nonce, H(A2)))
|
|
|
|
else:
|
|
|
|
# XXX handle auth-int.
|
|
|
|
return None
|
|
|
|
|
|
|
|
# XXX should the partial digests be encoded too?
|
|
|
|
base = 'username="%s", realm="%s", nonce="%s", uri="%s", ' \
|
|
|
|
'response="%s"' % (self.username, realm, nonce, path, respdig)
|
|
|
|
if opaque:
|
|
|
|
base += ', opaque="%s"' % opaque
|
|
|
|
if entdig:
|
|
|
|
base += ', digest="%s"' % entdig
|
|
|
|
base += ', algorithm="%s"' % algorithm
|
|
|
|
if qop:
|
|
|
|
base += ', qop=auth, nc=%s, cnonce="%s"' % (ncvalue, cnonce)
|
|
|
|
|
|
|
|
r.request.headers['Authorization'] = 'Digest %s' % (base)
|
|
|
|
r.request.send(anyway=True)
|
|
|
|
_r = r.request.response
|
|
|
|
_r.history.append(r)
|
|
|
|
|
|
|
|
return _r
|
|
|
|
|
|
|
|
return r
|
|
|
|
|
|
|
|
def __call__(self, r):
|
|
|
|
r.register_hook('response', self.handle_401)
|
|
|
|
return r
|