SSL Socket

The QtSSLSocket component provides SSL encryption support for QSocket controlled network connections.

SSL is a standard way to encrypt network connections. This component allows developers to use SSL together with the QSocket class in Qt. It requires the 3rd party library OpenSSL.

The class works on top of QSocket, encrypting data before it is sent to writeBlock() and decrypting it after if is received by readBlock(). The interface is similar to that of QSocket.

This Qt Solutions component is for Qt 3. For Qt 4 Solutions, please visit the Qt 4 Solutions Catalog.

Documentation:

Classes

• QtSSLSocket

• SSL client example
• SSL server example

• Guide to SSL and QtSSLSocket

Tested on:

• Qt 3.3.6 / Windows XP / MSVC.NET 2003
• Qt 3.3.6 / Linux / gcc
• Qt 3.3.6 / MacOS X 10.4 / gcc

Unsupported platforms:

• Qt 3.3.3 AIX 5.1 / xlC 6

Download Commercial Edition:

• qtsslsocket-1.6-enterprise.zip
• qtsslsocket-1.6-enterprise.tar.gz

Changes:

• 1.6: QFile::encodeName() is now used when passing the cert file and path to OpenSSL. This allows non-latin1 characters to be used in these paths.
• 1.6: Some warning messages were fixed, where the certificate and key file names were mixed up.
• 1.6: QtSSLSocket::privateKey() now returns the key instead of the certificate.
• 1.6: QtSSLSocket now emits bytesWritten().
• 1.5: Fixed a bug in the internal buffer which made it return the wrong size.
• 1.4: Fixed a data corruption bug that occurred when large payloads of data were downloaded.
• 1.4: Fixed putch().
• 1.4: The date fields in the certificate functions are now stored using Qt::ISODate.
• 1.3: The OpenSSL libraries and include files are searched for in the pri file.
• 1.3: The readyRead() signal is no longer emitted if the socket is closing.
• 1.3: Removed the QtSSLCertificate class, and replaced it with a QString with delimited key-value pairs.
• 1.3: Now inherits QSocket
• 1.3: Fixed a bug in readLine()
• 1.2: Fixed memory leaks
• 1.2: New class: QtSSLCertificate
• 1.2: Now inherits QIODevice
• 1.2: Cert failures are handled properly