authenticate

Description:

public signal bool authenticate (Auth auth, bool retrying)

Emitted when the message requires authentication.

If credentials are available call [[email protected]] on auth. If these credentials fail, the signal will be emitted again, with retrying set to true, which will continue until you return without calling [ [email protected]] on auth.

Note that this may be emitted before msg's body has been fully read.

You can authenticate auth asynchronously by calling [[email protected]] on auth and returning true. The operation will complete once either [[email protected]] or [[email protected]] are called.

Parameters:

auth	the Auth to authenticate
retrying	true if this is the second (or later) attempt

Returns:

true to stop other handlers from being invoked or false to propagate the event further.