twisted.words.protocols.jabber.xmlstreamView Source (View In Hierarchy)
TLS stream initializer for the initiating entity.
It is strongly required to include this initializer in the list of
initializers for an XMPP stream. By default it will try to negotiate TLS.
An XMPP server may indicate that TLS is required. If TLS is not desired,
wanted attribute to False instead of removing it from
the list of initializers, so a proper exception
can be raised.
|Instance Variable||wanted||indicates if TLS negotiation is wanted. (type:
|Method||onProceed||Proceed with TLS negotiation and reset the XML stream.|
|Method||start||Start TLS negotiation.|
Inherited from BaseFeatureInitiatingInitializer:
|Class Variable||feature||tuple of (uri, name) of the stream feature root element. (type: tuple of (
|Instance Variable||required||whether the stream feature is required to be advertized by the receiving
|Method||initialize||Initiate the initialization.|
|Parameters||configurationForTLS||An object which creates appropriately configured TLS connections. This is
passed to |
Proceed with TLS negotiation and reset the XML stream.
Start TLS negotiation.
This checks if the receiving entity requires TLS, the SSL library is
available and uses the
instance variables to determine what to do in the various different
For example, if the SSL library is not available, and wanted and required by the user, it raises an exception. However if it is not required by both parties, initialization silently succeeds, moving on to the next step.