__init__(self, password_manager)
(Constructor)

Initialize a `DigestMD5ServerAuthenticator` object.

:Parameters:
    - `password_manager`: name of the password manager object providing
      authentication credential verification.
:Types:
    - `password_manager`: `PasswordManager`

Overrides:

pyxmpp.sasl.core.ServerAuthenticator.__init__

response(self, response)

Process a client reponse.

:Parameters:
    - `response`: the response from the client.
:Types:
    - `response`: `str`

:return: a challenge, a success indicator or a failure indicator.
:returntype: `sasl.Challenge`, `sasl.Success` or `sasl.Failure`

Overrides:

pyxmpp.sasl.core.ServerAuthenticator.response

start(self, response)

Start the authentication process.

:Parameters:
    - `response`: the initial response from the client (empty for
      DIGEST-MD5).
:Types:
    - `response`: `str`

:return: a challenge, a success indicator or a failure indicator.
:returntype: `sasl.Challenge`, `sasl.Success` or `sasl.Failure`

Overrides:

pyxmpp.sasl.core.ServerAuthenticator.start

_check_params(self, username, realm, cnonce, digest_uri, response_val, authzid, nonce_count)

Check parameters of a client reponse and pass them to further
processing.

:Parameters:
    - `username`: user name.
    - `realm`: realm.
    - `cnonce`: cnonce value.
    - `digest_uri`: digest-uri value.
    - `response_val`: response value computed by the client.
    - `authzid`: authorization id.
    - `nonce_count`: nonce count value.
:Types:
    - `username`: `str`
    - `realm`: `str`
    - `cnonce`: `str`
    - `digest_uri`: `str`
    - `response_val`: `str`
    - `authzid`: `str`
    - `nonce_count`: `int`

:return: a challenge, a success indicator or a failure indicator.
:returntype: `sasl.Challenge`, `sasl.Success` or `sasl.Failure`

_make_final_challenge(self, username, realm, cnonce, digest_uri, response_val, authzid, nonce_count)

Send the second challenge in reply to the client response.

:Parameters:
    - `username`: user name.
    - `realm`: realm.
    - `cnonce`: cnonce value.
    - `digest_uri`: digest-uri value.
    - `response_val`: response value computed by the client.
    - `authzid`: authorization id.
    - `nonce_count`: nonce count value.
:Types:
    - `username`: `str`
    - `realm`: `str`
    - `cnonce`: `str`
    - `digest_uri`: `str`
    - `response_val`: `str`
    - `authzid`: `str`
    - `nonce_count`: `int`

:return: a challenge, a success indicator or a failure indicator.
:returntype: `sasl.Challenge`, `sasl.Success` or `sasl.Failure`

_parse_response(self, response)

Parse a client reponse and pass to further processing.

:Parameters:
    - `response`: the response from the client.
:Types:
    - `response`: `str`

:return: a challenge, a success indicator or a failure indicator.
:returntype: `sasl.Challenge`, `sasl.Success` or `sasl.Failure`