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 인증서 확장에는 다음과 같은 속성이 있습니다:
| 속성 | 설명 |
|---|---|
| 이름 | 확장자의 사람이 읽을 수 있는 이름(예: '기본제약조건')입니다. |
| 중요도 | 이 확장이 인증서를 올바르게 해석하는 데 중요한지 여부를 나타내는 부울 값입니다. |
| oid | 어떤 확장인지 지정하는 ASN.1 개체 식별자입니다. |
| supported | 이 값이 참이면 확장 값의 구조가 Qt 버전 간에 변경되지 않습니다. |
| value | 확장 유형에 따라 구조가 달라지는 QVariant. |
이 클래스는 모든 유형의 확장에 대한 액세스를 제공하지만, 일부만 릴리스 간에 변경되지 않는 형식으로 반환되도록 보장됩니다. isSupported () 메서드는 이 경우에 해당하는 확장의 경우 true 을 반환합니다.
현재 지원되는 확장과 반환되는 값의 구조는 다음과 같습니다:
| 이름 | OID | 세부 정보 |
|---|---|---|
| 기본 제약 조건 | 2.5.29.19 | QVariantMap 로 반환됩니다. 키 'ca'는 부울 값을 포함하고, 선택적 키 'pathLenConstraint'는 정수를 포함합니다. |
| authorityInfoAccess | 1.3.6.1.5.5.7.1.1 | QVariantMap 로 반환됩니다. 각 액세스 방법마다 키가 있으며, 값은 URI입니다. |
| subjectKeyIdentifier | 2.5.29.14 | QString 을 포함하는 QVariant 으로 반환되며, 문자열은 키 식별자입니다. |
| 권한 키 식별자 | 2.5.29.35 | QVariantMap 로 반환됩니다. 선택적 키 'keyid'는 QByteArray 에 저장된 16진수 문자열로 키 식별자를 포함합니다. 선택적 키 'serial'은 권한 키 일련 번호가 qlonglong으로 포함됩니다. 현재 이 확장의 일반 이름 필드는 지원되지 않습니다. |
위에서 지원되는 확장자 외에도 다른 많은 일반적인 확장자가 합리적으로 구조화된 방식으로 반환됩니다. 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 을 할당하고 이 확장에 대한 참조를 반환합니다.
© 2025 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.
