/usr/share/pyshared/twisted/web2/auth/interfaces.py is in python-twisted-web2 8.1.0-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 | from zope.interface import Interface, Attribute
class ICredentialFactory(Interface):
"""
A credential factory provides state between stages in HTTP
authentication. It is ultimately in charge of creating an
ICredential for the specified scheme, that will be used by
cred to complete authentication.
"""
scheme = Attribute(("string indicating the authentication scheme "
"this factory is associated with."))
def getChallenge(peer):
"""
Generate a challenge the client may respond to.
@type peer: L{twisted.internet.interfaces.IAddress}
@param peer: The client's address
@rtype: C{dict}
@return: dictionary of challenge arguments
"""
def decode(response, request):
"""
Create a credentials object from the given response.
May raise twisted.cred.error.LoginFailed if the response is invalid.
@type response: C{str}
@param response: scheme specific response string
@type request: L{twisted.web2.server.Request}
@param request: the request being processed
@return: ICredentials
"""
class IAuthenticatedRequest(Interface):
"""
A request that has been authenticated with the use of Cred,
and holds a reference to the avatar returned by portal.login
"""
avatarInterface = Attribute(("The credential interface implemented by "
"the avatar"))
avatar = Attribute("The application specific avatar returned by "
"the application's realm")
class IHTTPUser(Interface):
"""
A generic interface that can implemented by an avatar to provide
access to the username used when authenticating.
"""
username = Attribute(("A string representing the username portion of "
"the credentials used for authentication"))
|