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

Static Methods

[hide private]

is_certificate_valid(stream, cert)
Default certificate verification callback for TLS connections.

Class Variables

[hide private]

Inherited from interfaces.StreamFeatureHandler: __abstractmethods__

Inherited from interfaces.StreamFeatureHandler (private): _abc_cache, _abc_negative_cache, _abc_negative_cache_version, _abc_registry

Properties

[hide private]

Inherited from object: __class__

Method Details

[hide private]

init(self, settings=None)
(Constructor)

Initialize the TLS handler.

Parameters:

settings (XMPPSettings) - settings for StartTLS.

Overrides: object.__init__

make_stream_tls_features(self, stream, features)

Update the <features/> element with StartTLS feature.

[receving entity only]

Parameters:

features (ElementTree.Element) - the <features/> element of the stream.

Returns: ElementTree.Element

update <features/> element.

handle_stream_features(self, stream, features)

Process incoming StartTLS related element of <stream:features/>.

[initiating entity only]

Parameters:

stream - the stream
features - the features element just received

Returns:

StreamFeatureHandled instance if a feature was recognized and handled
StreamFeatureNotHandled instance if a feature was recognized but not handled
None if no feature was recognized

Overrides: interfaces.StreamFeatureHandler.handle_stream_features

_request_tls(self)

Request a TLS-encrypted connection.

[initiating entity only]

_process_tls_failure(self, stream, element)

Handle the <failure /> element.

Decorators:

@stream_element_handler(FAILURE_TAG, "initiator")

_process_tls_proceed(self, stream, element)

Handle the <proceed /> element.

Decorators:

@stream_element_handler(PROCEED_TAG, "initiator")

_process_tls_starttls(self, stream, element)

Handle <starttls/> element.

Decorators:

@stream_element_handler(STARTTLS_TAG, "receiver")

_make_tls_connection(self)

Initiate TLS connection.

[initiating entity only]

handle_tls_connected_event(self, event)

Verify the peer certificate on the TLSConnectedEvent.

Decorators:

@event_handler(TLSConnectedEvent)

is_certificate_valid(stream, cert)
Static Method

Default certificate verification callback for TLS connections.

Parameters:

cert - certificate information, as returned by ssl.SSLSocket.getpeercert

Returns:

computed verification result.

Class StreamTLSHandler

__init__(self, settings=None) (Constructor)

make_stream_tls_features(self, stream, features)

handle_stream_features(self, stream, features)

_request_tls(self)

_process_tls_failure(self, stream, element)

_process_tls_proceed(self, stream, element)

_process_tls_starttls(self, stream, element)

_make_tls_connection(self)

handle_tls_connected_event(self, event)

is_certificate_valid(stream, cert) Static Method

init(self, settings=None)
(Constructor)

is_certificate_valid(stream, cert)
Static Method