/**************************************************************************** ** ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). ** Contact: Qt Software Information (qt-info@nokia.com) ** ** This file is part of the QtNetwork module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** No Commercial Usage ** This file contains pre-release code and may not be distributed. ** You may use this file in accordance with the terms and conditions ** contained in the either Technology Preview License Agreement or the ** Beta Release License Agreement. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain ** additional rights. These rights are described in the Nokia Qt LGPL ** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this ** package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** If you are unsure which license is appropriate for your use, please ** contact the sales department at qt-sales@nokia.com. ** $QT_END_LICENSE$ ** ****************************************************************************/ /*! \class QSslCertificate \brief The QSslCertificate class provides a convenient API for an X509 certificate. \since 4.3 \reentrant \ingroup io \ingroup ssl \inmodule QtNetwork QSslCertificate stores an X509 certificate, and is commonly used to verify the identity and store information about the local host, a remotely connected peer, or a trusted third party Certificate Authority. There are many ways to construct a QSslCertificate. The most common way is to call QSslSocket::peerCertificate(), which returns a QSslCertificate object, or QSslSocket::peerCertificateChain(), which returns a list of them. You can also load certificates from a DER (binary) or PEM (Base64) encoded bundle, typically stored as one or more local files, or in a Qt Resource. You can call isNull() to check if your certificate is null. By default, QSslCertificate constructs a null certificate. To check if the certificate is valid, call isValid(). A null certificate is invalid, but an invalid certificate is not necessarily null. If you want to reset all contents in a certificate, call clear(). After loading a certificate, you can find information about the certificate, its subject, and its issuer, by calling one of the many accessor functions, including version(), serialNumber(), issuerInfo() and subjectInfo(). You can call notValidBefore() and notValidAfter() to check when the certificate was issued, and when it expires. The publicKey() function returns the certificate subject's public key as a QSslKey. You can call issuerInfo() or subjectInfo() to get detailed information about the certificate issuer and its subject. Internally, QSslCertificate is stored as an X509 structure. You can access this handle by calling handle(), but the results are likely to not be portable. \sa QSslSocket, QSslKey, QSslCipher, QSslError */ /*! \enum QSslCertificate::SubjectInfo Describes keys that you can pass to QSslCertificate::issuerInfo() or QSslCertificate::subjectInfo() to get information about the certificate issuer or subject. \value Organization "O" The name of the organization. \value CommonName "CN" The common name; most often this is used to store the host name. \value LocalityName "L" The locality. \value OrganizationalUnitName "OU" The organizational unit name. \value CountryName "C" The country. \value StateOrProvinceName "ST" The state or province. */ #include "qsslsocket_openssl_symbols_p.h" #include "qsslcertificate.h" #include "qsslcertificate_p.h" #include "qsslkey.h" #include "qsslkey_p.h" #include #include #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE /*! Constructs a QSslCertificate by reading \a format encoded data from \a device and using the first certificate found. You can later call isNull() to see if \a device contained a certificate, and if this certificate was loaded successfully. */ QSslCertificate::QSslCertificate(QIODevice *device, QSsl::EncodingFormat format) : d(new QSslCertificatePrivate) { QSslSocketPrivate::ensureInitialized(); if (device) d->init(device->readAll(), format); } /*! Constructs a QSslCertificate by parsing the \a format encoded \a data and using the first available certificate found. You can later call isNull() to see if \a data contained a certificate, and if this certificate was loaded successfully. */ QSslCertificate::QSslCertificate(const QByteArray &data, QSsl::EncodingFormat format) : d(new QSslCertificatePrivate) { QSslSocketPrivate::ensureInitialized(); d->init(data, format); } /*! Constructs an identical copy of \a other. */ QSslCertificate::QSslCertificate(const QSslCertificate &other) : d(other.d) { d->ref.ref(); } /*! Destroys the QSslCertificate. */ QSslCertificate::~QSslCertificate() { if (!d->ref.deref()) delete d; } /*! Copies the contents of \a other into this certificate, making the two certificates identical. */ QSslCertificate &QSslCertificate::operator=(const QSslCertificate &other) { qAtomicAssign(d, other.d); return *this; } /*! Returns true if this certificate is the same as \a other; otherwise returns false. */ bool QSslCertificate::operator==(const QSslCertificate &other) const { if (d == other.d) return true; if (d->null && other.d->null) return true; if (d->x509 && other.d->x509) return q_X509_cmp(d->x509, other.d->x509) == 0; return false; } /*! \fn bool QSslCertificate::operator!=(const QSslCertificate &other) const Returns true if this certificate is not the same as \a other; otherwise returns false. */ /*! Returns true if this is a null certificate (i.e., a certificate with no contents); otherwise returns false. By default, QSslCertificate constructs a null certificate. \sa isValid(), clear() */ bool QSslCertificate::isNull() const { return d->null; } /*! Returns true if this certificate is valid; otherwise returns false. Note: Currently, this function only checks that the current data-time is within the date-time range during which the certificate is considered valid. No other checks are currently performed. \sa isNull() */ bool QSslCertificate::isValid() const { const QDateTime currentTime = QDateTime::currentDateTime(); return currentTime >= d->notValidBefore && currentTime <= d->notValidAfter; } /*! Clears the contents of this certificate, making it a null certificate. \sa isNull() */ void QSslCertificate::clear() { if (isNull()) return; if (d->ref == 1) delete d; else d->ref.deref(); d = new QSslCertificatePrivate; } /*! Returns the certificate's version string. */ QByteArray QSslCertificate::version() const { return d->versionString; } /*! Returns the certificate's serial number string. */ QByteArray QSslCertificate::serialNumber() const { return d->serialNumberString; } /*! Returns a cryptographic digest of this certificate. By default, and MD5 digest will be generated, but you can also specify a custom \a algorithm. */ QByteArray QSslCertificate::digest(QCryptographicHash::Algorithm algorithm) const { return QCryptographicHash::hash(toDer(), algorithm); } static QString _q_SubjectInfoToString(QSslCertificate::SubjectInfo info) { QString str; switch (info) { case QSslCertificate::Organization: str = QLatin1String("O"); break; case QSslCertificate::CommonName: str = QLatin1String("CN"); break; case QSslCertificate::LocalityName: str = QLatin1String("L"); break; case QSslCertificate::OrganizationalUnitName: str = QLatin1String("OU"); break; case QSslCertificate::CountryName: str = QLatin1String("C"); break; case QSslCertificate::StateOrProvinceName: str = QLatin1String("ST"); break; } return str; } /*! \fn QString QSslCertificate::issuerInfo(SubjectInfo subject) const Returns the issuer information for the \a subject from the certificate, or an empty string if there is no information for \a subject in the certificate. \sa subjectInfo() */ QString QSslCertificate::issuerInfo(SubjectInfo info) const { return d->issuerInfo.value(_q_SubjectInfoToString(info)); } /*! Returns the issuer information for \a tag from the certificate, or an empty string if there is no information for \a tag in the certificate. \sa subjectInfo() */ QString QSslCertificate::issuerInfo(const QByteArray &tag) const { // ### Use a QByteArray for the keys in the map return d->issuerInfo.value(QString::fromLatin1(tag)); } /*! \fn QString QSslCertificate::subjectInfo(SubjectInfo subject) const Returns the information for the \a subject, or an empty string if there is no information for \a subject in the certificate. \sa issuerInfo() */ QString QSslCertificate::subjectInfo(SubjectInfo info) const { return d->subjectInfo.value(_q_SubjectInfoToString(info)); } /*! Returns the subject information for \a tag, or an empty string if there is no information for \a tag in the certificate. \sa issuerInfo() */ QString QSslCertificate::subjectInfo(const QByteArray &tag) const { // ### Use a QByteArray for the keys in the map return d->subjectInfo.value(QString::fromLatin1(tag)); } /*! Returns the list of alternative subject names for this certificate. The alternate subject names typically contain host names, optionally with wildcards, that are valid for this certificate. These names are tested against the connected peer's host name, if either the subject information for \l CommonName doesn't define a valid host name, or the subject info name doesn't match the peer's host name. \sa subjectInfo() */ QMultiMap QSslCertificate::alternateSubjectNames() const { QMultiMap result; if (!d->x509) return result; STACK *altNames = (STACK *)q_X509_get_ext_d2i(d->x509, NID_subject_alt_name, 0, 0); if (altNames) { for (int i = 0; i < q_sk_GENERAL_NAME_num(altNames); ++i) { const GENERAL_NAME *genName = q_sk_GENERAL_NAME_value(altNames, i); if (genName->type != GEN_DNS && genName->type != GEN_EMAIL) continue; int len = q_ASN1_STRING_length(genName->d.ia5); if (len < 0 || len >= 8192) { // broken name continue; } const char *altNameStr = reinterpret_cast(q_ASN1_STRING_data(genName->d.ia5)); const QString altName = QLatin1String(QByteArray(altNameStr, len)); if (genName->type == GEN_DNS) result.insert(QSsl::DnsEntry, altName); else if (genName->type == GEN_EMAIL) result.insert(QSsl::EmailEntry, altName); } q_sk_free(altNames); } return result; } /*! Returns the date-time that the certificate becomes valid, or an empty QDateTime if this is a null certificate. \sa expiryDate() */ QDateTime QSslCertificate::effectiveDate() const { return d->notValidBefore; } /*! Returns the date-time that the certificate expires, or an empty QDateTime if this is a null certificate. \sa effectiveDate() */ QDateTime QSslCertificate::expiryDate() const { return d->notValidAfter; } /*! Returns a pointer to the native certificate handle, if there is one, or a null pointer otherwise. You can use this handle, together with the native API, to access extended information about the certificate. \warning Use of this function has a high probability of being non-portable, and its return value may vary from platform to platform or change from minor release to minor release. */ Qt::HANDLE QSslCertificate::handle() const { return Qt::HANDLE(d->x509); } /*! Returns the certificate subject's public key. */ QSslKey QSslCertificate::publicKey() const { if (!d->x509) return QSslKey(); QSslKey key; key.d->type = QSsl::PublicKey; X509_PUBKEY *xkey = d->x509->cert_info->key; EVP_PKEY *pkey = q_X509_PUBKEY_get(xkey); Q_ASSERT(pkey); if (q_EVP_PKEY_type(pkey->type) == EVP_PKEY_RSA) { key.d->rsa = q_EVP_PKEY_get1_RSA(pkey); key.d->algorithm = QSsl::Rsa; key.d->isNull = false; } else if (q_EVP_PKEY_type(pkey->type) == EVP_PKEY_DSA) { key.d->dsa = q_EVP_PKEY_get1_DSA(pkey); key.d->algorithm = QSsl::Dsa; key.d->isNull = false; } else if (q_EVP_PKEY_type(pkey->type) == EVP_PKEY_DH) { // DH unsupported } else { // error? } q_EVP_PKEY_free(pkey); return key; } /*! Returns this certificate converted to a PEM (Base64) encoded representation. */ QByteArray QSslCertificate::toPem() const { if (!d->x509) return QByteArray(); return d->QByteArray_from_X509(d->x509, QSsl::Pem); } /*! Returns this certificate converted to a DER (binary) encoded representation. */ QByteArray QSslCertificate::toDer() const { if (!d->x509) return QByteArray(); return d->QByteArray_from_X509(d->x509, QSsl::Der); } /*! Searches all files in the \a path for certificates encoded in the specified \a format and returns them in a list. \e must be a file or a pattern matching one or more files, as specified by \a syntax. Example: \snippet doc/src/snippets/code/src_network_ssl_qsslcertificate.cpp 0 \sa fromData() */ QList QSslCertificate::fromPath(const QString &path, QSsl::EncodingFormat format, QRegExp::PatternSyntax syntax) { // $, (,), *, +, ., ?, [, ,], ^, {, | and }. int pos = -1; if (syntax == QRegExp::Wildcard) pos = path.indexOf(QRegExp(QLatin1String("[^\\][\\*\\?\\[\\]]"))); else if (syntax != QRegExp::FixedString) pos = path.indexOf(QRegExp(QLatin1String("[^\\][\\$\\(\\)\\*\\+\\.\\?\\[\\]\\^\\{\\}\\|]"))); QString pathPrefix = path.left(pos); // == path if pos < 0 if (pos != -1) pathPrefix = pathPrefix.left(pathPrefix.lastIndexOf(QLatin1Char('/'))); // Special case - if the prefix ends up being nothing, use "." instead and // chop off the first two characters from the glob'ed paths. int startIndex = 0; if (pathPrefix.trimmed().isEmpty()) { startIndex = 2; pathPrefix = QLatin1String("."); } // The path is a file. if (pos == -1 && QFileInfo(pathPrefix).isFile()) { QFile file(pathPrefix); if (file.open(QIODevice::ReadOnly | QIODevice::Text)) return QSslCertificate::fromData(file.readAll(),format); return QList(); } // The path can be a file or directory. QList certs; QRegExp pattern(path, Qt::CaseSensitive, syntax); QDirIterator it(pathPrefix, QDir::Files, QDirIterator::FollowSymlinks | QDirIterator::Subdirectories); while (it.hasNext()) { QString filePath = startIndex == 0 ? it.next() : it.next().mid(startIndex); if (!pattern.exactMatch(filePath)) continue; QFile file(filePath); if (file.open(QIODevice::ReadOnly | QIODevice::Text)) certs += QSslCertificate::fromData(file.readAll(),format); } return certs; } /*! Searches for and parses all certificates in \a device that are encoded in the specified \a format and returns them in a list of certificates. \sa fromData() */ QList QSslCertificate::fromDevice(QIODevice *device, QSsl::EncodingFormat format) { if (!device) { qWarning("QSslCertificate::fromDevice: cannot read from a null device"); return QList(); } return fromData(device->readAll(), format); } /*! Searches for and parses all certificates in \a data that are encoded in the specified \a format and returns them in a list of certificates. \sa fromDevice() */ QList QSslCertificate::fromData(const QByteArray &data, QSsl::EncodingFormat format) { return (format == QSsl::Pem) ? QSslCertificatePrivate::certificatesFromPem(data) : QSslCertificatePrivate::certificatesFromDer(data); } void QSslCertificatePrivate::init(const QByteArray &data, QSsl::EncodingFormat format) { if (!data.isEmpty()) { QList certs = (format == QSsl::Pem) ? certificatesFromPem(data, 1) : certificatesFromDer(data, 1); if (!certs.isEmpty()) { *this = *certs.first().d; if (x509) x509 = q_X509_dup(x509); } } } #define BEGINCERTSTRING "-----BEGIN CERTIFICATE-----" #define ENDCERTSTRING "-----END CERTIFICATE-----" // ### refactor against QSsl::pemFromDer() etc. (to avoid redundant implementations) QByteArray QSslCertificatePrivate::QByteArray_from_X509(X509 *x509, QSsl::EncodingFormat format) { if (!x509) { qWarning("QSslSocketBackendPrivate::X509_to_QByteArray: null X509"); return QByteArray(); } // Use i2d_X509 to convert the X509 to an array. int length = q_i2d_X509(x509, 0); QByteArray array; array.resize(length); char *data = array.data(); char **dataP = &data; unsigned char **dataPu = (unsigned char **)dataP; if (q_i2d_X509(x509, dataPu) < 0) return QByteArray(); if (format == QSsl::Der) return array; // Convert to Base64 - wrap at 64 characters. array = array.toBase64(); QByteArray tmp; for (int i = 0; i < array.size() - 64; i += 64) { tmp += QByteArray::fromRawData(array.data() + i, 64); tmp += "\n"; } if (int remainder = array.size() % 64) { tmp += QByteArray::fromRawData(array.data() + array.size() - remainder, remainder); tmp += "\n"; } return BEGINCERTSTRING "\n" + tmp + ENDCERTSTRING "\n"; } static QMap _q_mapFromOnelineName(char *name) { QMap info; QString infoStr = QString::fromLocal8Bit(name); q_CRYPTO_free(name); // ### The right-hand encoding seems to allow hex (Regulierungsbeh\xC8orde) //entry.replace(QLatin1String("\\x"), QLatin1String("%")); //entry = QUrl::fromPercentEncoding(entry.toLatin1()); // ### See RFC-4630 for more details! QRegExp rx(QLatin1String("/([A-Za-z]+)=(.+)")); int pos = 0; while ((pos = rx.indexIn(infoStr, pos)) != -1) { const QString name = rx.cap(1); QString value = rx.cap(2); const int valuePos = rx.pos(2); const int next = rx.indexIn(value); if (next == -1) { info.insert(name, value); break; } value = value.left(next); info.insert(name, value); pos = valuePos + value.length(); } return info; } QSslCertificate QSslCertificatePrivate::QSslCertificate_from_X509(X509 *x509) { QSslCertificate certificate; if (!x509 || !QSslSocket::supportsSsl()) return certificate; certificate.d->issuerInfo = _q_mapFromOnelineName(q_X509_NAME_oneline(q_X509_get_issuer_name(x509), 0, 0)); certificate.d->subjectInfo = _q_mapFromOnelineName(q_X509_NAME_oneline(q_X509_get_subject_name(x509), 0, 0)); ASN1_TIME *nbef = q_X509_get_notBefore(x509); ASN1_TIME *naft = q_X509_get_notAfter(x509); certificate.d->notValidBefore = q_getTimeFromASN1(nbef); certificate.d->notValidAfter = q_getTimeFromASN1(naft); certificate.d->null = false; certificate.d->x509 = q_X509_dup(x509); return certificate; } static bool matchLineFeed(const QByteArray &pem, int *offset) { char ch = pem.at(*offset); // ignore extra whitespace at the end of the line while (ch == ' ' && *offset < pem.size()) ch = pem.at(++*offset); if (ch == '\n') { *offset++; return true; } if (ch == '\r' && pem.size() > (*offset + 1) && pem.at(*offset + 1) == '\n') { *offset += 2; return true; } return false; } QList QSslCertificatePrivate::certificatesFromPem(const QByteArray &pem, int count) { QList certificates; QSslSocketPrivate::ensureInitialized(); int offset = 0; while (count == -1 || certificates.size() < count) { int startPos = pem.indexOf(BEGINCERTSTRING, offset); if (startPos == -1) break; startPos += sizeof(BEGINCERTSTRING) - 1; if (!matchLineFeed(pem, &startPos)) break; int endPos = pem.indexOf(ENDCERTSTRING, startPos); if (endPos == -1) break; offset = endPos + sizeof(ENDCERTSTRING) - 1; if (!matchLineFeed(pem, &offset)) break; QByteArray decoded = QByteArray::fromBase64( QByteArray::fromRawData(pem.data() + startPos, endPos - startPos)); #if OPENSSL_VERSION_NUMBER >= 0x00908000L const unsigned char *data = (const unsigned char *)decoded.data(); #else unsigned char *data = (unsigned char *)decoded.data(); #endif if (X509 *x509 = q_d2i_X509(0, &data, decoded.size())) { certificates << QSslCertificate_from_X509(x509); q_X509_free(x509); } } return certificates; } QList QSslCertificatePrivate::certificatesFromDer(const QByteArray &der, int count) { QList certificates; QSslSocketPrivate::ensureInitialized(); #if OPENSSL_VERSION_NUMBER >= 0x00908000L const unsigned char *data = (const unsigned char *)der.data(); #else unsigned char *data = (unsigned char *)der.data(); #endif int size = der.size(); while (count == -1 || certificates.size() < count) { if (X509 *x509 = q_d2i_X509(0, &data, size)) { certificates << QSslCertificate_from_X509(x509); q_X509_free(x509); } else { break; } size -= ((char *)data - der.data()); } return certificates; } #ifndef QT_NO_DEBUG_STREAM QDebug operator<<(QDebug debug, const QSslCertificate &certificate) { debug << "QSslCertificate(" << certificate.version() << "," << certificate.serialNumber() << "," << certificate.digest().toBase64() << "," << certificate.issuerInfo(QSslCertificate::Organization) << "," << certificate.subjectInfo(QSslCertificate::Organization) << "," << certificate.alternateSubjectNames() #ifndef QT_NO_TEXTSTREAM << "," << certificate.effectiveDate() << "," << certificate.expiryDate() #endif << ")"; return debug; } QDebug operator<<(QDebug debug, QSslCertificate::SubjectInfo info) { switch (info) { case QSslCertificate::Organization: debug << "Organization"; break; case QSslCertificate::CommonName: debug << "CommonName"; break; case QSslCertificate::CountryName: debug << "CountryName"; break; case QSslCertificate::LocalityName: debug << "LocalityName"; break; case QSslCertificate::OrganizationalUnitName: debug << "OrganizationalUnitName"; break; case QSslCertificate::StateOrProvinceName: debug << "StateOrProvinceName"; break; } return debug; } #endif QT_END_NAMESPACE