QSslCertificateExtension Class
QSslCertificateExtension 클래스는 X509 인증서의 확장 정보에 접근하기 위한 API를 제공합니다. 더 보기...
| 헤더: | #include <QSslCertificateExtension> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- 상속된 멤버를 포함한 모든 멤버 목록
- QSslCertificateExtension은 네트워크 프로그래밍 API 및 암시적 공유 클래스의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입 가능합니다.
공개 함수
| 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=(const QSslCertificateExtension &other) |
상세 설명
QSslCertificateExtension은 X509 인증서에 저장된 확장에 대한 액세스를 제공합니다. 사용 가능한 정보는 액세스하는 확장의 유형에 따라 다릅니다.
모든 X509 인증서 확장에는 다음 속성이 있습니다.
| 속성 | 설명 |
|---|---|
| name | 확장자의 사람이 읽을 수 있는 이름입니다(예: 'basicConstraints'). |
| 중요도 | 이 속성은 확장자가 인증서를 올바르게 해석하는 데 필수적인지 여부를 나타내는 부울 값입니다. |
| oid | 이 확장 기능이 어떤 것인지 지정하는 ASN.1 객체 식별자입니다. |
| supported | 이 값이 true인 경우, Qt 버전 간에 확장 기능 값의 구조가 변경되지 않습니다. |
| value | 확장 유형에 따라 구조가 달라지는 QVariant 객체입니다. |
이 클래스는 모든 유형의 확장에 대한 액세스를 제공하지만, 릴리스 간에 변함없이 유지되는 형식으로 반환되는 것은 일부에 불과합니다. isSupported() 메서드는 이러한 조건에 해당하는 확장에 대해 true 를 반환합니다.
현재 지원되는 확장 기능과 반환되는 값의 구조는 다음과 같습니다:
| 이름 | OID | 상세 정보 |
|---|---|---|
| 기본 제약 조건 | 2.5.29.19 | QVariantMap 로 반환됩니다. 키 'ca'에는 부울 값이 포함되며, 선택적 키 'pathLenConstraint'에는 정수가 포함됩니다. |
| 권한 정보 액세스 | 1.3.6.1.5.5.7.1.1 | QVariantMap 로 반환됩니다. 각 액세스 방법마다 키가 하나씩 있으며, 값은 URI입니다. |
| subjectKeyIdentifier | 2.5.29.14 | QString 를 포함하는 QVariant 형태로 반환됩니다. 이 문자열은 키 식별자입니다. |
| authorityKeyIdentifier | 2.5.29.35 | QVariantMap 로 반환됩니다. 선택적 키 'keyid'는 QByteArray 에 저장된 16진수 문자열 형태의 키 식별자를 포함합니다. 선택적 키 'serial'은 qlonglong 형식의 권한 키 일련번호를 포함합니다. 현재 이 확장의 general names 필드는 지원되지 않습니다. |
위에서 언급한 지원되는 확장자 외에도, 다른 많은 일반적인 확장자들이 합리적으로 구조화된 방식으로 반환됩니다. SSL 백엔드가 전혀 지원하지 않는 확장자는 QByteArray 로 반환됩니다.
인증서에 포함될 수 있는 확장자 유형에 대한 자세한 내용은 RFC 5280에서 확인할 수 있습니다.
QSslCertificate::extensions()도 참조하십시오 .
멤버 함수 문서
QSslCertificateExtension::QSslCertificateExtension()
QSslCertificateExtension 객체를 생성합니다.
QSslCertificateExtension::QSslCertificateExtension(const QSslCertificateExtension &other)
other 의 복사본을 생성합니다.
[noexcept] QSslCertificateExtension::~QSslCertificateExtension()
확장 기능을 삭제합니다.
bool QSslCertificateExtension::isCritical() const
확장의 중요도를 반환합니다.
bool QSslCertificateExtension::isSupported() const
이 확장이 지원되는 경우 true를 반환합니다. 이 경우, ‘지원됨’이란 단순히 value() 액세서리가 반환하는 QVariant 의 구조가 버전 간에 변하지 않을 것임을 의미합니다. 지원되지 않는 확장은 자유롭게 사용할 수 있지만, 반환된 데이터의 구조가 버전 간에 동일할 것이라는 보장은 없습니다.
QString QSslCertificateExtension::name() const
확장자의 이름을 반환합니다. 확장자에 대한 이름이 알려지지 않은 경우 OID가 반환됩니다.
QString QSslCertificateExtension::oid() const
이 확장의 ASN.1 OID를 반환합니다.
[noexcept] void QSslCertificateExtension::swap(QSslCertificateExtension &other)
이 인증서 확장 인스턴스를 other 로 교체합니다. 이 작업은 매우 빠르게 수행되며 실패하는 일이 없습니다.
QVariant QSslCertificateExtension::value() const
확장자의 값을 반환합니다. 반환되는 값의 구조는 확장자 유형에 따라 다릅니다.
QSslCertificateExtension &QSslCertificateExtension::operator=(const QSslCertificateExtension &other)
other 를 이 확장 기능에 할당하고, 이 확장 기능에 대한 참조를 반환합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
