QSslKeyPrivate Class Reference

#include <qsslkey_p.h>

Public Functions
void	clear (bool deep=true)
void	decodePem (const QByteArray &pem, const QByteArray &passPhrase, bool deepClear=true)
	Allocates a new rsa or dsa struct and decodes pem into it according to the current algorithm and type. More...
QByteArray	derFromPem (const QByteArray &pem) const
	Returns a PEM key formatted as DER. More...
QByteArray	pemFooter () const
QByteArray	pemFromDer (const QByteArray &der) const
	Returns a DER key formatted as PEM. More...
QByteArray	pemHeader () const
	QSslKeyPrivate ()
	~QSslKeyPrivate ()

Public Variables
QSsl::KeyAlgorithm	algorithm
DSA *	dsa
bool	isNull
QAtomicInt	ref
RSA *	rsa
QSsl::KeyType	type

Detailed Description

Definition at line 64 of file qsslkey_p.h.

Constructors and Destructors

QSslKeyPrivate()

QSslKeyPrivate::QSslKeyPrivate ( )

inline

Definition at line 67 of file qsslkey_p.h.

        : rsa(0)
        , dsa(0)
    {
        clear();
    }

~QSslKeyPrivate()

QSslKeyPrivate::~QSslKeyPrivate ( )

inline

Definition at line 74 of file qsslkey_p.h.

    { clear(); }

Functions

clear()

void QSslKeyPrivate::clear

(

bool

deep = true

)

Warning

This function is not part of the public interface.

Definition at line 80 of file qsslkey.cpp.

Referenced by decodePem(), QSslKeyPrivate(), and ~QSslKeyPrivate().

{
    isNull = true;
    if (!QSslSocket::supportsSsl())
        return;
    if (rsa) {
        if (deep)
            q_RSA_free(rsa);
        rsa = 0;
    }
    if (dsa) {
        if (deep)
            q_DSA_free(dsa);
        dsa = 0;
    }
}

decodePem()

void QSslKeyPrivate::decodePem	(	const QByteArray &	pem,
		const QByteArray &	passPhrase,
		bool	deepClear = true
	)

Allocates a new rsa or dsa struct and decodes pem into it according to the current algorithm and type.

Warning

This function is not part of the public interface.

If deepClear is true, the rsa/dsa struct is freed if it is was already allocated, otherwise we "leak" memory (which is exactly what we want for copy construction).

If passPhrase is non-empty, it will be used for decrypting pem.

Definition at line 113 of file qsslkey.cpp.

Referenced by QSslKey::QSslKey(), and ~QSslKeyPrivate().

{
    if (pem.isEmpty())
        return;

    clear(deepClear);

    if (!QSslSocket::supportsSsl())
        return;

    BIO *bio = q_BIO_new_mem_buf(const_cast<char *>(pem.data()), pem.size());
    if (!bio)
        return;

    void *phrase = (void *)passPhrase.constData();

    if (algorithm == QSsl::Rsa) {
        RSA *result = (type == QSsl::PublicKey)
            ? q_PEM_read_bio_RSA_PUBKEY(bio, &rsa, 0, phrase)
            : q_PEM_read_bio_RSAPrivateKey(bio, &rsa, 0, phrase);
        if (rsa && rsa == result)
            isNull = false;
    } else {
        DSA *result = (type == QSsl::PublicKey)
            ? q_PEM_read_bio_DSA_PUBKEY(bio, &dsa, 0, phrase)
            : q_PEM_read_bio_DSAPrivateKey(bio, &dsa, 0, phrase);
        if (dsa && dsa == result)
            isNull = false;
    }

    q_BIO_free(bio);
}

derFromPem()

QByteArray QSslKeyPrivate::derFromPem

(

const QByteArray &

pem

)

const

Returns a PEM key formatted as DER.

Warning

This function is not part of the public interface.

Definition at line 219 of file qsslkey.cpp.

Referenced by QSslKey::toDer(), and ~QSslKeyPrivate().

{
    const QByteArray header = pemHeader();
    const QByteArray footer = pemFooter();

    QByteArray der(pem);

    const int headerIndex = der.indexOf(header);
    const int footerIndex = der.indexOf(footer);
    if (headerIndex == -1 || footerIndex == -1)
        return QByteArray();

    der = der.mid(headerIndex + header.size(), footerIndex - (headerIndex + header.size()));

    return QByteArray::fromBase64(der); // ignores newlines
}

pemFooter()

QByteArray QSslKeyPrivate::pemFooter

(

)

const

Warning

This function is not part of the public interface.

Definition at line 173 of file qsslkey.cpp.

Referenced by ~QSslKeyPrivate().

{
    // ### use QByteArray::fromRawData() instead
    if (type == QSsl::PublicKey)
        return QByteArray("-----END PUBLIC KEY-----\n");
    else if (algorithm == QSsl::Rsa)
        return QByteArray("-----END RSA PRIVATE KEY-----\n");
    return QByteArray("-----END DSA PRIVATE KEY-----\n");
}

pemFromDer()

QByteArray QSslKeyPrivate::pemFromDer

(

const QByteArray &

der

)

const

Returns a DER key formatted as PEM.

Warning

This function is not part of the public interface.

Definition at line 191 of file qsslkey.cpp.

Referenced by QSslKey::QSslKey(), and ~QSslKeyPrivate().

{
    QByteArray pem(der.toBase64());

    const int lineWidth = 64; // RFC 1421
    const int newLines = pem.size() / lineWidth;
    const bool rem = pem.size() % lineWidth;

    // ### optimize
    for (int i = 0; i < newLines; ++i)
        pem.insert((i + 1) * lineWidth + i, '\n');
    if (rem)
        pem.append('\n'); // ###

    pem.prepend(pemHeader());
    pem.append(pemFooter());

    return pem;
}

pemHeader()

QByteArray QSslKeyPrivate::pemHeader

(

)

const

Warning

This function is not part of the public interface.

Definition at line 160 of file qsslkey.cpp.

Referenced by ~QSslKeyPrivate().

{
    // ### use QByteArray::fromRawData() instead
    if (type == QSsl::PublicKey)
        return QByteArray("-----BEGIN PUBLIC KEY-----\n");
    else if (algorithm == QSsl::Rsa)
        return QByteArray("-----BEGIN RSA PRIVATE KEY-----\n");
    return QByteArray("-----BEGIN DSA PRIVATE KEY-----\n");
}

Properties

algorithm

QSsl::KeyAlgorithm QSslKeyPrivate::algorithm

Definition at line 88 of file qsslkey_p.h.

Referenced by QSslKey::algorithm(), decodePem(), QSslKey::handle(), QSslKey::length(), QSslCertificate::publicKey(), QSslKey::QSslKey(), and QSslKey::toPem().

dsa

DSA* QSslKeyPrivate::dsa

Definition at line 90 of file qsslkey_p.h.

Referenced by clear(), decodePem(), QSslKey::handle(), QSslKey::length(), QSslCertificate::publicKey(), and QSslKey::toPem().

isNull

bool QSslKeyPrivate::isNull

Definition at line 86 of file qsslkey_p.h.

Referenced by clear(), decodePem(), QSslKey::isNull(), QSslKey::length(), QSslCertificate::publicKey(), QSslKey::toDer(), and QSslKey::toPem().

ref

QAtomicInt QSslKeyPrivate::ref

Definition at line 92 of file qsslkey_p.h.

rsa

RSA* QSslKeyPrivate::rsa

Definition at line 89 of file qsslkey_p.h.

Referenced by clear(), decodePem(), QSslKey::handle(), QSslKey::length(), QSslCertificate::publicKey(), and QSslKey::toPem().

type

QSsl::KeyType QSslKeyPrivate::type

Definition at line 87 of file qsslkey_p.h.

Referenced by decodePem(), QSslCertificate::publicKey(), QSslKey::QSslKey(), QSslKey::toPem(), and QSslKey::type().

---

The documentation for this class was generated from the following files:

• /src/network/ssl/qsslkey_p.h
• /src/network/ssl/qsslkey.cpp