Package pyxmpp2 :: Package sasl :: Module digest_md5 :: Class DigestMD5ClientAuthenticator
[hide private]

Class DigestMD5ClientAuthenticator


Provides DIGEST-MD5 SASL authentication for a client.

Authentication properties used:

Authentication properties returned:

Nested Classes [hide private]

Inherited from core.ClientAuthenticator: __metaclass__

Instance Methods [hide private]
 
__init__(self)
Initialize a DigestMD5ClientAuthenticator object.
 
start(self, properties)
Start the authentication process.
sasl.Response or sasl.Failure
challenge(self, challenge)
Process a challenge and return the response.
sasl.Response or sasl.Failure
_make_response(self, charset, realms, nonce)
Make a response for the first challenge from the server.
bytes or Failure
_get_realm(self, realms, charset)
Choose a realm from the list specified by the server.
sasl.Response or sasl.Failure
_final_challenge(self, challenge)
Process the second challenge from the server and return the response.
sasl.Success or sasl.Failure
finish(self, data)
Process success indicator from the server.

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Class Methods [hide private]
 
are_properties_sufficient(cls, properties)
Check if the provided properties are sufficient for this authentication mechanism.
Class Variables [hide private]
  __abstractmethods__ = frozenset([])
  _abc_cache = <_weakrefset.WeakSet object at 0x7f52caa6bf10>
  _abc_negative_cache = <_weakrefset.WeakSet object at 0x7f52caa...
  _pyxmpp_sasl_preference = 50
  _pyxmpp_sasl_secure = 70
Properties [hide private]

Inherited from object: __class__

Method Details [hide private]

__init__(self)
(Constructor)

 
Initialize a DigestMD5ClientAuthenticator object.
Overrides: object.__init__

are_properties_sufficient(cls, properties)
Class Method

 
Check if the provided properties are sufficient for
this authentication mechanism.

If `are_properties_sufficient` returns False for given `properties`
mapping, the `start` method of `cls` instance will also fail with
such argument.

:Parameters:
    - `properties`: the `authentication properties`_
:Types:
    - `properties`: mapping

:Return: if the mechanism can be used with those properties

Overrides: core.ClientAuthenticator.are_properties_sufficient
(inherited documentation)

start(self, properties)

 
Start the authentication process.

:Parameters:
    - `properties`: the `authentication properties`_
:Types:
    - `properties`: mapping

:return: the initial response to send to the server or a failuer
    indicator.
:returntype: `Response` or `Failure`

Overrides: core.ClientAuthenticator.start
(inherited documentation)

challenge(self, challenge)

 
Process a challenge and return the response.
Parameters:
  • challenge (bytes) - the challenge from server.
Returns: sasl.Response or sasl.Failure
the response or a failure indicator.
Overrides: core.ClientAuthenticator.challenge

_make_response(self, charset, realms, nonce)

 
Make a response for the first challenge from the server.
Parameters:
  • charset (bytes) - charset name from the challenge.
  • realms (bytes) - realms list from the challenge.
  • nonce (bytes) - nonce value from the challenge.
Returns: sasl.Response or sasl.Failure
the response or a failure indicator.

_get_realm(self, realms, charset)

 
Choose a realm from the list specified by the server.
Parameters:
  • realms (list of bytes) - the realm list.
  • charset (bytes) - encoding of realms on the list.
Returns: bytes or Failure
the realm chosen or a failure indicator.

_final_challenge(self, challenge)

 
Process the second challenge from the server and return the response.
Parameters:
  • challenge (bytes) - the challenge from server.
Returns: sasl.Response or sasl.Failure
the response or a failure indicator.

finish(self, data)

 

Process success indicator from the server.

Process any addiitional data passed with the success. Fail if the server was not authenticated.

Parameters:
  • data (bytes) - an optional additional data with success.
Returns: sasl.Success or sasl.Failure
success or failure indicator.
Overrides: core.ClientAuthenticator.finish

Class Variable Details [hide private]

_abc_negative_cache

Value:
<_weakrefset.WeakSet object at 0x7f52caa6bf90>