Package tlslite :: Package integration :: Module pop3_tls :: Class POP3_TLS
[hide private]
[frames] | no frames]

type POP3_TLS

source code


This class extends poplib.POP3 with TLS support.

Instance Methods [hide private]
 
__init__(self, host, port=995, timeout=<object object at 0x7fadd7d7d170>, username=None, password=None, certChain=None, privateKey=None, checker=None, settings=None)
Create a new POP3_TLS.
source code

Inherited from poplib.POP3: apop, dele, getwelcome, list, noop, pass_, quit, retr, rpop, rset, set_debuglevel, stat, top, uidl, user

Inherited from poplib.POP3 (private): _getline, _getlongresp, _getresp, _longcmd, _putcmd, _putline, _shortcmd

Inherited from clienthelper.ClientHelper (private): _handshake

Static Methods [hide private]

Inherited from clienthelper.ClientHelper (private): _isIP

Class Variables [hide private]

Inherited from poplib.POP3: timestamp

Method Details [hide private]

__init__(self, host, port=995, timeout=<object object at 0x7fadd7d7d170>, username=None, password=None, certChain=None, privateKey=None, checker=None, settings=None)
(Constructor)

source code 

Create a new POP3_TLS.

For client authentication, use one of these argument combinations:

  • username, password (SRP)
  • certChain, privateKey (certificate)

For server authentication, you can either rely on the implicit mutual authentication performed by SRP or you can do certificate-based server authentication with one of these argument combinations:

  • x509Fingerprint

Certificate-based server authentication is compatible with SRP or certificate-based client authentication.

The caller should be prepared to handle TLS-specific exceptions. See the client handshake functions in tlslite.TLSConnection.TLSConnection for details on which exceptions might be raised.

Parameters:
  • host (str) - Server to connect to.
  • port (int) - Port to connect to.
  • username (str) - SRP username.
  • password (str) - SRP password for mutual authentication. Requires the 'username' argument.
  • certChain (tlslite.x509certchain.X509CertChain) - Certificate chain for client authentication. Requires the 'privateKey' argument. Excludes the SRP argument.
  • privateKey (tlslite.utils.rsakey.RSAKey) - Private key for client authentication. Requires the 'certChain' argument. Excludes the SRP argument.
  • checker (tlslite.checker.Checker) - Callable object called after handshaking to evaluate the connection and raise an Exception if necessary.
  • settings (tlslite.handshakesettings.HandshakeSettings) - Various settings which can be used to control the ciphersuites, certificate types, and SSL/TLS versions offered by the client.
Overrides: clienthelper.ClientHelper.__init__