QWebEngineCertificateError Class
QWebEngineCertificateError クラスは、証明書エラーに関する情報を提供します。詳細...
Header: | #include <QWebEngineCertificateError> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
qmake: | QT += webenginecore |
In QML: | WebEngineCertificateError |
パブリックタイプ
enum | Type { SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, CertificateContainsErrors, …, CertificateSymantecLegacy } |
プロパティ
(since 6.8)
isMainFrame : const bool- overridable : const bool
パブリック関数
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
この列挙型は、発生した証明書エラーのタイプを記述します。
この enum 型の値は Chromium が提供する SSL エラーと一致します。QSslError::SslError の値は直接使用されません。Qt のエラーカテゴリは Chromium のエラーカテゴリにマッピングできないからです。
定数 | 値 | 説明 |
---|---|---|
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 | -213 | 証明書の有効期間が長すぎる。(Qt 5.7 で追加) |
QWebEngineCertificateError::CertificateTransparencyRequired | -214 | この接続には証明書の透明性が必要ですが、サーバーはポリシーに準拠した CT 情報を提供しませんでした。(Qt 5.8で追加) |
QWebEngineCertificateError::CertificateKnownInterceptionBlocked | -217 | 証明書がデバイス所有者以外のエンティティによる傍受に使用されていることが判明した。(5.15で追加) |
QWebEngineCertificateError::SslObsoleteVersion | -218 | 古いバージョンの SSL/TLS を使用している。(Qt 6.2 で追加、Qt 6.4 で非推奨) |
QWebEngineCertificateError::CertificateSymantecLegacy | -215 | 証明書がレガシーな Symantec のもので、もはや有効ではありません。(Qt 6.2 で追加されました) |
プロパティの説明
[read-only, since 6.8]
isMainFrame : const bool
証明書エラーがメインフレームから発生しているかどうかを返します。false の場合、エラーはサブリソースから来ており、ほとんどの場合、ユーザー入力なしで拒否する必要があります。
このプロパティは Qt 6.8 で導入されました。
アクセス関数:
bool | isMainFrame() const |
[read-only]
overridable : const bool
このプロパティは、このエラーをオーバーライドして受け入れることができるかどうかを保持します。
アクセス関数:
bool | isOverridable() 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()も参照 。
QString QWebEngineCertificateError::description() const
地域化された、人間が読める短いエラーの説明を返す。
注: プロパティ説明のゲッター関数です。
url() およびisOverridable() も参照 。
[invokable]
void QWebEngineCertificateError::rejectCertificate()
証明書を拒否し、要求された URL のロードを中止する。
注: この関数はメタオブジェクトシステムやQMLから呼び出すことができる。Q_INVOKABLE を参照してください。
QWebEngineCertificateError::Type QWebEngineCertificateError::type() const
エラーのタイプを返します。
注: プロパティタイプのゲッター関数。
description() およびisOverridable()も参照 。
QUrl QWebEngineCertificateError::url() const
エラーが発生した URL を返す。
注釈 : プロパティ url のゲッター関数。
description()も参照して ください。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。