QWebEngineCertificateError Class
QWebEngineCertificateError 클래스는 인증서 오류에 대한 정보를 제공합니다. 더 보기...
| 헤더: | #include <QWebEngineCertificateError> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| QML에서: | webEngineCertificateError |
공용 유형
| enum | Type { Ok, SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, …, CertificateSymantecLegacy } |
속성
|
공공 기능
| void | acceptCertificate() |
| QList<QSslCertificate> | certificateChain() const |
| void | defer() |
| QString | description() const |
| bool | isMainFrame() const |
| bool | isOverridable() const |
| void | rejectCertificate() |
| QWebEngineCertificateError::Type | type() const |
| QUrl | url() const |
상세 설명
인증서 오류에 대한 정보를 제공합니다. 이 클래스는 QWebEnginePage::certificateError()의 파라미터로 사용됩니다.
멤버 유형 문서
enum QWebEngineCertificateError::Type
이 열거형은 발생한 인증서 오류의 유형을 설명합니다.
이 열거 형의 값은 Chromium에서 제공하는 SSL 오류와 일치합니다. QSslError::SslError 값은 Qt 오류 범주를 Chromium 오류 범주에 매핑할 수 없으므로 직접 사용되지 않습니다.
| Constant | 값 | 설명 |
|---|---|---|
QWebEngineCertificateError::Ok | 0 | 실제 인증서 오류가 없습니다. |
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain | -150 | 인증서가 호스트 이름에 대해 고정된 기본 제공 공개 키와 일치하지 않습니다. |
QWebEngineCertificateError::CertificateCommonNameInvalid | -200 | 인증서의 일반 이름이 호스트 이름과 일치하지 않습니다. |
QWebEngineCertificateError::CertificateDateInvalid | -201 | 인증서가 현재 날짜 및 시간에 유효하지 않습니다. |
QWebEngineCertificateError::CertificateAuthorityInvalid | -202 | 인증서가 신뢰할 수 있는 기관에서 서명하지 않았습니다. |
QWebEngineCertificateError::CertificateContainsErrors | -203 | 인증서에 오류가 있습니다. |
QWebEngineCertificateError::CertificateNoRevocationMechanism | -204 | 인증서가 해지되었는지 확인하는 메커니즘이 없습니다. |
QWebEngineCertificateError::CertificateUnableToCheckRevocation | -205 | 인증서에 대한 해지 정보를 사용할 수 없습니다. |
QWebEngineCertificateError::CertificateRevoked | -206 | 인증서가 해지되었습니다. |
QWebEngineCertificateError::CertificateInvalid | -207 | 인증서가 유효하지 않습니다. |
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm | -208 | 인증서가 약한 서명 알고리즘을 사용하여 서명되었습니다. |
QWebEngineCertificateError::CertificateNonUniqueName | -210 | 인증서에 지정된 호스트 이름이 고유하지 않습니다. |
QWebEngineCertificateError::CertificateWeakKey | -211 | 인증서에 약한 키가 포함되어 있습니다. |
QWebEngineCertificateError::CertificateNameConstraintViolation | -212 | 인증서가 이름 제약 조건을 위반하는 DNS 이름을 요청했습니다. |
QWebEngineCertificateError::CertificateValidityTooLong (since Qt 5.7) | -213 | 인증서의 유효 기간이 너무 깁니다. |
QWebEngineCertificateError::CertificateTransparencyRequired (since Qt 5.8) | -214 | 이 연결에 인증서 투명성이 필요했지만 서버가 정책을 준수하는 CT 정보를 제공하지 않았습니다. |
QWebEngineCertificateError::CertificateKnownInterceptionBlocked (since Qt 5.15) | -217 | 이 인증서는 장치 소유자가 아닌 다른 엔터티에 의해 가로채는 데 사용되는 것으로 알려져 있습니다. |
QWebEngineCertificateError::SslObsoleteVersion (since Qt 6.2, deprecated in Qt 6.4) | -218 | 이 연결은 더 이상 사용되지 않는 SSL/TLS 버전을 사용합니다. |
QWebEngineCertificateError::CertificateSymantecLegacy (since Qt 6.2, deprecated in Qt 6.11) | -215 | 인증서가 더 이상 유효하지 않은 기존 시만텍 인증서입니다. |
속성 문서
[read-only] description : const QString
이 속성에는 사람이 읽을 수 있는 짧은 현지화된 오류 설명이 저장됩니다.
액세스 함수:
| QString | description() const |
url() 및 isOverridable()도 참조하세요 .
[read-only, since 6.8] isMainFrame : const bool
인증서 오류가 메인 프레임에서 발생했는지 여부를 반환합니다. 거짓이면, 오류는 하위 리소스에서 발생하며 사용자 입력 없이 거부해야 할 가능성이 높습니다.
이 프로퍼티는 Qt 6.8에 도입되었습니다.
액세스 함수:
| bool | isMainFrame() const |
[read-only] overridable : const bool
이 프로퍼티에는 이 오류를 재정의하고 허용할 수 있는지 여부가 저장됩니다.
액세스 함수:
| bool | isOverridable() const |
description()도 참조하세요 .
[read-only] type : const Type
이 속성에는 오류 유형이 저장됩니다.
액세스 함수:
| QWebEngineCertificateError::Type | type() const |
description() 및 isOverridable()도 참조하세요 .
[read-only] url : const QUrl
이 속성에는 오류를 트리거한 URL이 저장됩니다.
함수에 액세스합니다:
| QUrl | url() const |
description()도 참조하세요 .
멤버 함수 문서
[invokable] void QWebEngineCertificateError::acceptCertificate()
인증서를 수락하고 요청된 URL의 로딩을 계속합니다.
참고: 이 함수는 메타객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
QList<QSslCertificate> QWebEngineCertificateError::certificateChain() const
피어의 디지털 인증서 체인을 반환합니다.
체인은 피어의 즉시 인증서로 시작하여 CA의 인증서로 끝납니다.
[invokable] void QWebEngineCertificateError::defer()
인증서 오류를 지연된 처리로 표시합니다.
이 함수는 예를 들어 사용자 입력을 기다리는 동안 인증서 수락 여부 결정을 연기해야 할 때 호출해야 합니다. 이 함수가 호출되면 acceptCertificate() 또는 rejectCertificate()가 호출될 때까지 URL 요청을 일시 중지합니다.
참고: 재정의 가능한 인증서 오류만 연기할 수 있습니다.
참고: 이 함수는 메타객체 시스템 및 QML에서 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
isOverridable()도 참조하세요 .
[invokable] void QWebEngineCertificateError::rejectCertificate()
인증서를 거부하고 요청된 URL의 로딩을 중단합니다.
참고: 이 함수는 메타객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
© 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.
