t.w.i.ICredentialFactory(Interface) : interface documentation

Part of twisted.web.iweb View Source View In Hierarchy

Known implementations: twisted.web._auth.basic.BasicCredentialFactory, twisted.web._auth.digest.DigestCredentialFactory

A credential factory defines a way to generate a particular kind of authentication challenge and a way to interpret the responses to these challenges. It creates ICredentials providers from responses. These objects will be used with twisted.cred to authenticate an authorize requests.

Attribute	scheme	A `str` giving the name of the authentication scheme with which this factory is associated. For example, `'basic'` or `'digest'`.
Method	getChallenge	Generate a new challenge to be sent to a client.
Method	decode	Create a credentials object from the given response.

scheme =

A str giving the name of the authentication scheme with which this factory is associated. For example, 'basic' or 'digest'.

def getChallenge(request): (source)

Generate a new challenge to be sent to a client.

Parameters	peer	The request the response to which this challenge will be included. (type: `twisted.web.http.Request`)
Returns	A mapping from `str` challenge fields to associated `str` values. (type: `dict`)

def decode(response, request): (source)

Create a credentials object from the given response.

Parameters	response	scheme specific response string (type: `str`)
	request	The request being processed (from which the response was taken). (type: `twisted.web.http.Request`)
Returns	The credentials represented by the given response. (type: `twisted.cred.credentials.ICredentials` provider)
Raises	twisted.cred.error.LoginFailed	If the response is invalid.

API Documentation for Twisted, generated by pydoctor at 2012-06-04 17:20:01.