QSslCertificateExtension Class
QSslCertificateExtension クラスは、X.509 証明書の拡張機能にアクセスするための 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 | 詳細 |
|---|---|---|
| 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 | 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.
