class documentation

class twisted.words.protocols.jabber.client.XMPPAuthenticator(xmlstream.ConnectAuthenticator): (source)

View In Hierarchy

Initializes an XmlStream connecting to an XMPP server as a Client.

This authenticator performs the initialization steps needed to start exchanging XML stanzas with an XMPP server as an XMPP client. It checks if the server advertises XML stream version 1.0, negotiates TLS (when available), performs SASL authentication, binds a resource and establishes a session.

Upon successful stream initialization, the xmlstream.STREAM_AUTHD_EVENT event will be dispatched through the XML stream object. Otherwise, the xmlstream.INIT_FAILED_EVENT event will be dispatched with a failure object.

After inspection of the failure, initialization can then be restarted by calling ConnectAuthenticator.initializeStream. For example, in case of authentication failure, a user may be given the opportunity to input the correct password. By setting the password instance variable and restarting initialization, the stream authentication step is then retried, and subsequent steps are performed if successful.

Instance Variable jid Jabber ID to authenticate with. This may contain a resource part, as a suggestion to the server for resource binding. A server may override this, though. If the resource part is left off, the server will generate a unique resource identifier. The server will always return the full Jabber ID in the resource binding step, and this is stored in this instance variable.
Instance Variable password password to be used during SASL authentication.
Class Variable namespace Undocumented
Method __init__ No summary
Method associateWithStream Register with the XML stream.
Instance Variable _configurationForTLS Undocumented

Inherited from ConnectAuthenticator:

Instance Variable otherHost Undocumented
Method connectionMade Called by the XmlStream when the underlying socket connection is in place.
Method initializeStream Perform stream initialization procedures.
Method streamStarted Called by the XmlStream when the stream has started.

Inherited from Authenticator (via ConnectAuthenticator):

Instance Variable xmlstream The XmlStream that needs authentication
Jabber ID to authenticate with. This may contain a resource part, as a suggestion to the server for resource binding. A server may override this, though. If the resource part is left off, the server will generate a unique resource identifier. The server will always return the full Jabber ID in the resource binding step, and this is stored in this instance variable.
(type: jid.JID)
password = (source)
password to be used during SASL authentication.
(type: unicode)
def __init__(self, jid, password, configurationForTLS=None): (source)
ParametersjidUndocumented
passwordUndocumented
configurationForTLSAn object which creates appropriately configured TLS connections. This is passed to startTLS on the transport and is preferably created using twisted.internet.ssl.optionsForClientTLS. If None, the default is to verify the server certificate against the trust roots as provided by the platform. See twisted.internet._sslverify.platformTrust. (type: IOpenSSLClientConnectionCreator or None)
_configurationForTLS = (source)

Undocumented

def associateWithStream(self, xs): (source)

Register with the XML stream.

Populates stream's list of initializers, along with their requiredness. This list is used by ConnectAuthenticator.initializeStream to perform the initialization steps.

API Documentation for Twisted, generated by pydoctor 20.12.1 at 2021-02-28 19:53:36.