| /**************************************************************************** |
| ** |
| ** Copyright (C) 2011 Richard J. Moore <rich@kde.org> |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtNetwork module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| /*! |
| \class QSslCertificateExtension |
| \brief The QSslCertificateExtension class provides an API for accessing the |
| extensions of an X509 certificate. |
| \since 5.0 |
| |
| \reentrant |
| \ingroup network |
| \ingroup ssl |
| \ingroup shared |
| \inmodule QtNetwork |
| |
| QSslCertificateExtension provides access to an extension stored in |
| an X509 certificate. The information available depends on the type |
| of extension being accessed. |
| |
| All X509 certificate extensions have the following properties: |
| |
| \table |
| \header |
| \li Property |
| \li Description |
| \row |
| \li name |
| \li The human readable name of the extension, eg. 'basicConstraints'. |
| \row |
| \li criticality |
| \li This is a boolean value indicating if the extension is critical |
| to correctly interpreting the certificate. |
| \row |
| \li oid |
| \li The ASN.1 object identifier that specifies which extension this |
| is. |
| \row |
| \li supported |
| \li If this is true the structure of the extension's value will not |
| change between Qt versions. |
| \row |
| \li value |
| \li A QVariant with a structure dependent on the type of extension. |
| \endtable |
| |
| Whilst this class provides access to any type of extension, only |
| some are guaranteed to be returned in a format that will remain |
| unchanged between releases. The isSupported() method returns \c true |
| for extensions where this is the case. |
| |
| The extensions currently supported, and the structure of the value |
| returned are as follows: |
| |
| \table |
| \header |
| \li Name |
| \li OID |
| \li Details |
| \row |
| \li basicConstraints |
| \li 2.5.29.19 |
| \li Returned as a QVariantMap. The key 'ca' contains a boolean value, |
| the optional key 'pathLenConstraint' contains an integer. |
| \row |
| \li authorityInfoAccess |
| \li 1.3.6.1.5.5.7.1.1 |
| \li Returned as a QVariantMap. There is a key for each access method, |
| with the value being a URI. |
| \row |
| \li subjectKeyIdentifier |
| \li 2.5.29.14 |
| \li Returned as a QVariant containing a QString. The string is the key |
| identifier. |
| \row |
| \li authorityKeyIdentifier |
| \li 2.5.29.35 |
| \li Returned as a QVariantMap. The optional key 'keyid' contains the key |
| identifier as a hex string stored in a QByteArray. The optional key |
| 'serial' contains the authority key serial number as a qlonglong. |
| Currently there is no support for the general names field of this |
| extension. |
| \endtable |
| |
| In addition to the supported extensions above, many other common extensions |
| will be returned in a reasonably structured way. Extensions that the SSL |
| backend has no support for at all will be returned as a QByteArray. |
| |
| Further information about the types of extensions certificates can |
| contain can be found in RFC 5280. |
| |
| \sa QSslCertificate::extensions() |
| */ |
| |
| #include "qsslcertificateextension.h" |
| #include "qsslcertificateextension_p.h" |
| |
| QT_BEGIN_NAMESPACE |
| |
| /*! |
| Constructs a QSslCertificateExtension. |
| */ |
| QSslCertificateExtension::QSslCertificateExtension() |
| : d(new QSslCertificateExtensionPrivate) |
| { |
| } |
| |
| /*! |
| Constructs a copy of \a other. |
| */ |
| QSslCertificateExtension::QSslCertificateExtension(const QSslCertificateExtension &other) |
| : d(other.d) |
| { |
| } |
| |
| /*! |
| Destroys the extension. |
| */ |
| QSslCertificateExtension::~QSslCertificateExtension() |
| { |
| } |
| |
| /*! |
| Assigns \a other to this extension and returns a reference to this extension. |
| */ |
| QSslCertificateExtension &QSslCertificateExtension::operator=(const QSslCertificateExtension &other) |
| { |
| d = other.d; |
| return *this; |
| } |
| |
| /*! |
| \fn void QSslCertificateExtension::swap(QSslCertificateExtension &other) |
| |
| Swaps this certificate extension instance with \a other. This |
| function is very fast and never fails. |
| */ |
| |
| /*! |
| Returns the ASN.1 OID of this extension. |
| */ |
| QString QSslCertificateExtension::oid() const |
| { |
| return d->oid; |
| } |
| |
| /*! |
| Returns the name of the extension. If no name is known for the |
| extension then the OID will be returned. |
| */ |
| QString QSslCertificateExtension::name() const |
| { |
| return d->name; |
| } |
| |
| /*! |
| Returns the value of the extension. The structure of the value |
| returned depends on the extension type. |
| */ |
| QVariant QSslCertificateExtension::value() const |
| { |
| return d->value; |
| } |
| |
| /*! |
| Returns the criticality of the extension. |
| */ |
| bool QSslCertificateExtension::isCritical() const |
| { |
| return d->critical; |
| } |
| |
| /*! |
| Returns the true if this extension is supported. In this case, |
| supported simply means that the structure of the QVariant returned |
| by the value() accessor will remain unchanged between versions. |
| Unsupported extensions can be freely used, however there is no |
| guarantee that the returned data will have the same structure |
| between versions. |
| */ |
| bool QSslCertificateExtension::isSupported() const |
| { |
| return d->supported; |
| } |
| |
| QT_END_NAMESPACE |