Класс QSslCertificateExtension

Класс QSslCertificateExtension предоставляет API для доступа к расширениям сертификата X509. Подробнее...

Заголовок:	#include <QSslCertificateExtension>
CMake:	find_package(Qt6 COMPONENTS Network REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake:	QT += network
С тех пор:	Qt 5.0

Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются перевходными.

Открытые функции

	QSslCertificateExtension(const QSslCertificateExtension &other)
	QSslCertificateExtension()
QSslCertificateExtension &	operator=(const QSslCertificateExtension &other)
	~QSslCertificateExtension()
bool	isCritical() const
bool	isSupported() const
QString	name() const
QString	oid() const
void	swap(QSslCertificateExtension &other)
QVariant	value() const

Подробное описание

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(const QSslCertificateExtension &other)

Создает копию other.

QSslCertificateExtension::QSslCertificateExtension()

Создает QSslCertificateExtension.

QSslCertificateExtension &QSslCertificateExtension::operator=(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

Возвращает значение расширения. Структура возвращаемого значения зависит от типа расширения.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qsslcertificateextension.html