Класс QSslCertificateExtension
Класс QSslCertificateExtension предоставляет API для доступа к расширениям сертификата X509. Подробнее...
| Заголовок: | #include <QSslCertificateExtension> |
| qmake: | QT += network |
| С момента: | Qt 5.0 |
Примечание: Все функции в этом классе являются перевходными.
Открытые функции
| QSslCertificateExtension() | |
| QSslCertificateExtension(const QSslCertificateExtension &other) | |
| ~QSslCertificateExtension() | |
| bool | isCritical() const |
| bool | isSupported() const |
| QString | name() const |
| QString | oid() const |
| void | swap(QSslCertificateExtension &other) |
| QVariant | value() const |
| QSslCertificateExtension & | operator=(QSslCertificateExtension &&other) |
| QSslCertificateExtension & | operator=(const QSslCertificateExtension &other) |
Подробное описание
Класс QSslCertificateExtension предоставляет API для доступа к расширениям сертификата X509.
QSslCertificateExtension обеспечивает доступ к расширению, хранящемуся в сертификате X509. Доступная информация зависит от типа доступного расширения.
Все расширения сертификатов X509 имеют следующие свойства:
| Свойство | Описание |
|---|---|
| name | Человекочитаемое имя расширения, например, 'basicConstraints'. |
| criticality | Это логическое значение, указывающее, является ли расширение критическим для правильной интерпретации сертификата. |
| oid | Идентификатор объекта ASN.1, который определяет это расширение. |
| supported | Если это true, структура значения расширения не будет изменяться между версиями Qt. |
| value | QVariant со структурой, зависящей от типа расширения. |
Хотя этот класс предоставляет доступ к любому типу расширения, только некоторые гарантированно будут возвращены в формате, который останется неизменным между выпусками. Метод isSupported() возвращает true для расширений, в которых это имеет место.
Ниже приведены поддерживаемые расширения и структура возвращаемого значения:
| Имя | OID | Подробности |
|---|---|---|
| basicConstraints | 2.5.29.19 | Возвращается как QVariantMap. Ключ 'ca' содержит логическое значение, необязательный ключ 'pathLenConstraint' содержит целое число. |
| authorityInfoAccess | 1.3.6.1.5.5.7.1.1 | Возвращается как QVariantMap. Для каждого метода доступа есть ключ, значением которого является URI. |
| subjectKeyIdentifier | 2.5.29.14 | Возвращается как QVariant, содержащий QString. Строка — это идентификатор ключа. |
| authorityKeyIdentifier | 2.5.29.35 | Возвращается как QVariantMap. Необязательный ключ 'keyid' содержит идентификатор ключа как строку в шестнадцатеричном формате, хранящуюся в QByteArray. Необязательный ключ 'serial' содержит порядковый номер ключа авторитета в виде qlonglong. В настоящее время нет поддержки поля имен общего назначения этого расширения. |
Помимо поддерживаемых выше расширений, многие другие распространённые расширения будут возвращены в достаточно структурированном виде. Расширения, для которых у SSL-бекенда нет поддержки вообще, будут возвращены в виде QByteArray.
Дополнительную информацию о типах расширений, которые могут содержать сертификаты, можно найти в RFC 5280.
См. также QSslCertificate::extensions().
Документация по функциям-членам
QSslCertificateExtension::QSslCertificateExtension()
Конструирует QSslCertificateExtension.
QSslCertificateExtension::QSslCertificateExtension(const QSslCertificateExtension &other)
Конструирует копию other.
QSslCertificateExtension::~QSslCertificateExtension()
Удаляет расширение.
bool QSslCertificateExtension::isCritical() const
Возвращает критичность расширения.
bool QSslCertificateExtension::isSupported() const
Возвращает true, если это расширение поддерживается. В данном случае поддержка означает, что структура QVariant, возвращаемая методом value(), останется неизменной между версиями. Неподдерживаемые расширения могут быть свободно использованы, однако нет гарантии, что возвращаемые данные будут иметь одинаковую структуру между версиями.
QString QSslCertificateExtension::name() const
Возвращает имя расширения. Если имя расширения неизвестно, возвращается OID.
QString QSslCertificateExtension::oid() const
Возвращает ASN.1 OID этого расширения.
void QSslCertificateExtension::swap(QSslCertificateExtension &other)
Меняет местами этот экземпляр расширения сертификата с other. Эта функция очень быстрая и никогда не терпит неудачу.
QVariant QSslCertificateExtension::value() const
Возвращает значение расширения. Структура возвращаемого значения зависит от типа расширения.
QSslCertificateExtension &QSslCertificateExtension::operator=(QSslCertificateExtension &&other)
Оператор присваивания перемещения.
QSslCertificateExtension &QSslCertificateExtension::operator=(const QSslCertificateExtension &other)
Присваивает other этому расширению и возвращает ссылку на это расширение.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qsslcertificateextension.html
