CherryPy Project Download

digest and LDAP authentication

I've been wondering if CherryPy is the right place for doing authorization. Because instead of _coding_ authorization it is easier to _declare_ it in the front web servers. Instead of re-inventing the wheel, let the right tool handle the job.

Looking at the Apache mod_auth digest it sais: "it has not been extensively tested and is therefore marked experimental". In lighttp mod_digest documentation, there is a limitation: "The implementation of digest method is currently not completely compliant with the standard as it still allows a replay attack". I mean no offense to CherryPy authentication modules, but I would assume more people use Apache and Lighty authentication, therefore higher probability to have the security fixed in the webservers. If hacker manages to manipulate the headers and reach CherryPy port, then this is a bug in Apache / Lighty code.

IMHO delegating authentication is the Right Thing (TM) to do, since it also makes sense to use a reverse proxy (apache/lighttpd/squid) in front of CherryPy to deal with buffer overflows, malformed URLs and other nasty things. This allows CherryPy to run in session-less mode, which allows for easier fail-over and load balancing.

For Intranet deployments, most users would appreciate not to see "Login" dialog at all. External authentication allows Single-Sign-On by using Windows Integrated Authentication (using IIS, not sure about Apache), and possibly on the Mac ("kerberized" application, Apple Open Directory)

Since digest authentication is hard, lighttpd page suggests you are better protected by SSL (even with plain text passwords on the wire), than with digest over plain http.

Here is sample configuration for Lighty (only relevant lines from lighttpd.conf):

server.modules = (
	"mod_accesslog" )
server.port = 8090
proxy.server = ( "" => ( ( "host" => "", "port" => 8080 ) ) )
auth.backend = "plain"
auth.backend.plain.userfile = "/opt/local/etc/lighttpd/lighttpd.user"
auth.require = ( "/" => (
	"method" => "digest",
	"realm" => "cubulus",
	"require" => "valid-user"
) )

CherryPy receives header 'Authorization' with content 'Digest username="a", realm="cubulus", nonce=.., uri=.. qop="auth" ..... '

Easy thing is that if authorization fails, CherryPy receives nothing, so it's enough to look for Digest username="XXX"

Here is the code:

class Layout:	
	#if you have parameter 'user', it allows USERNAME SPOOFING ATTACK
	#instead, read the validated headers 
	def index(self, params ..):
		return self.indexNoSecurity(getAuthUser(), params..)

	def indexNoSecurity(self, user=ANONYMOUS, params..):
		#default user value used ex: for testing without a webserver

And here is the helper function and constant:

ANONYMOUS = 'anonymous'
def getAuthUser():
	#get authorization from apache/lighttpd/squid
		hdr = cherrypy.request.headers['Authorization']
		start = hdr.find('Digest username="')
		end = hdr.find('"', start+17)
		return hdr[start+17:end]
	except KeyError:
		return ANONYMOUS

Cheers, Alexandru Toth

Configuring the same in Apache is more difficult. First of all, using mod_proxy will cut away the authentication related headers. There is a patch, but haven't install it yet ( ).

On Webfaction forum, Remi Delon suggested to try mod_rewrite. Here is almost usable solution with Apache:

<Location /auth >
     AuthType Digest
     AuthName "cubulus"
     #AuthDigestDomain / /index/ /data/ /data/hiers/ /data/default/

     AuthUserFile /etc/httpd/.htpasswd
     Require valid-user

RewriteEngine on
RewriteRule ^/secure/cub(.*)$1 [proxy]
RewriteRule ^/secure [next]

How to login:

-first browse to http://localhost/secure/cub . Apache acts as proxy. CherryPy receives no authorization headers, so session is "anonymous"

-browse to http://localhost/secure . This will redirect to http://localhost/auth , triggering login. Never mind the error related to inexistent page. Now browse again to http://localhost/secure/cub , and cherryPy gets correct headers.

So mod_proxy cuts away the headers. But when mod_proxy is called from mod_rewrite, magically headers stay .. ? Arrghhh

Any ideas how to fix properly?

Cheers, Alexandru

Hosted by WebFaction

Log in as guest/cherrypy to create/edit wiki pages