QSslCertificate Class Reference · PyQt4 中文文檔

# QSslCertificate Class Reference ## [[QtNetwork](index.htm) module] 該QSslCertificate類提供了一個X509證書了方便的API 。[More...](#details) ### Types * `enum SubjectInfo { Organization, CommonName, LocalityName, OrganizationalUnitName, CountryName, StateOrProvinceName }` ### Methods * `__init__ (self, QIODevice?device, QSsl.EncodingFormat?format?=?QSsl.Pem)` * `__init__ (self, QByteArray?data?=?QByteArray(), QSsl.EncodingFormat?format?=?QSsl.Pem)` * `__init__ (self, QSslCertificate?other)` * `dict-of-QSsl.AlternateNameEntryType-list-of-QString alternateSubjectNames (self)` * `clear (self)` * `QByteArray digest (self, QCryptographicHash.Algorithm?algorithm?=?QCryptographicHash.Md5)` * `QDateTime effectiveDate (self)` * `QDateTime expiryDate (self)` * `int handle (self)` * `bool isNull (self)` * `QString issuerInfo (self, SubjectInfo?info)` * `QString issuerInfo (self, QByteArray?tag)` * `bool isValid (self)` * `QSslKey publicKey (self)` * `QByteArray serialNumber (self)` * `QString subjectInfo (self, SubjectInfo?info)` * `QString subjectInfo (self, QByteArray?tag)` * `QByteArray toDer (self)` * `QByteArray toPem (self)` * `QByteArray version (self)` ### Static Methods * `list-of-QSslCertificate fromData (QByteArray?data, QSsl.EncodingFormat?format?=?QSsl.Pem)` * `list-of-QSslCertificate fromDevice (QIODevice?device, QSsl.EncodingFormat?format?=?QSsl.Pem)` * `list-of-QSslCertificate fromPath (QString?path, QSsl.EncodingFormat?format?=?QSsl.Pem, QRegExp.PatternSyntax?syntax?=?QRegExp.FixedString)` ### Special Methods * `bool __eq__ (self, QSslCertificate?other)` * `bool __ne__ (self, QSslCertificate?other)` * * * ## Detailed Description 該QSslCertificate類提供了一個X509證書了方便的API 。 QSslCertificate存儲X509證書，并且通常用于驗證有關本地主機，遠程連接等，或可信任的第三方認證機構的標識和存儲信息。有許多方法來構造一個QSslCertificate 。最常見的方法是調用[QSslSocket.peerCertificate](qsslsocket.html#peerCertificate)（），它返回一個QSslCertificate對象，或[QSslSocket.peerCertificateChain](qsslsocket.html#peerCertificateChain)（），它返回它們的列表。您也可以加載一個DER證書（二進制）或PEM （ Base64編碼）編碼的捆綁，通常存儲為一個或多個本地文件，或在Qt的資源。您可以致電[isNull](qsslcertificate.html#isNull)（）來檢查，如果你的證書為null 。默認情況下， QSslCertificate構造一個空證書。要檢查證書是否有效，呼叫[isValid](qsslcertificate.html#isValid)（）。空證書是無效的，但一個無效的證書不一定空。如果你想重置所有內容的憑證，請致電[clear](qsslcertificate.html#clear)（）。加載證書后，您可以找到有關證書，它的主題，它的發行者信息，通過調用許多存取功能之一，包括[version](qsslcertificate.html#version)（）[serialNumber](qsslcertificate.html#serialNumber)（）[issuerInfo](qsslcertificate.html#issuerInfo)（）和[subjectInfo](qsslcertificate.html#subjectInfo)（）。您可以致電[effectiveDate](qsslcertificate.html#effectiveDate)（）和[expiryDate](qsslcertificate.html#expiryDate)（）來檢查時，啟動證書是有效，當它過期。該[publicKey](qsslcertificate.html#publicKey)（）函數返回證書主題的公鑰作為[QSslKey](qsslkey.html)。您可以致電[issuerInfo](qsslcertificate.html#issuerInfo)（）或[subjectInfo](qsslcertificate.html#subjectInfo)（）來獲取有關證書頒發者和它的主題的詳細信息。在內部， QSslCertificate被存儲為一個X509結構。您可以通過調用訪問此手柄[handle](qsslcertificate.html#handle)（），但結果可能不是可移植的。 * * * ## Type Documentation ``` QSslCertificate.SubjectInfo ``` 介紹了可以傳遞給鑰匙[QSslCertificate.issuerInfo](qsslcertificate.html#issuerInfo)（）或[QSslCertificate.subjectInfo](qsslcertificate.html#subjectInfo)（）來獲取有關證書頒發者或主題的信息。 | Constant | Value | Description | | --- | --- | --- | | `QSslCertificate.Organization` | `0` | “O”的組織的名稱。 | | `QSslCertificate.CommonName` | `1` | “CN”的通用名稱;最常這是用來存儲主機名。 | | `QSslCertificate.LocalityName` | `2` | “L”的地方。 | | `QSslCertificate.OrganizationalUnitName` | `3` | 「其他指定用途“的組織單位名稱。 | | `QSslCertificate.CountryName` | `4` | “C”的國家。 | | `QSslCertificate.StateOrProvinceName` | `5` | “ST”的州或省。 | * * * ## Method Documentation ``` QSslCertificate.__init__ (self, QIODevice?device, QSsl.EncodingFormat?format?=?QSsl.Pem) ``` 構造一個[QSslCertificate](qsslcertificate.html)閱讀_format_從編碼數據_device_并使用找到的第一個證書。您可以稍后致電[isNull](qsslcertificate.html#isNull)（），以查看是否_device_包含一個證書，如果加載成功后，該證書。 ``` QSslCertificate.__init__ (self, QByteArray?data?=?QByteArray(), QSsl.EncodingFormat?format?=?QSsl.Pem) ``` 構造一個[QSslCertificate](qsslcertificate.html)通過解析_format_編碼_data_并使用找到的第一個可用的證書。您可以稍后致電[isNull](qsslcertificate.html#isNull)（），以查看是否_data_包含一個證書，如果加載成功后，該證書。 ``` QSslCertificate.__init__ (self, QSslCertificate?other) ``` 構造完全相同的副本_other_。 ``` dict-of-QSsl.AlternateNameEntryType-list-of-QString QSslCertificate.alternateSubjectNames (self) ``` 返回此證書備用主題名的列表。備選主題名稱通常包含主機名，可以使用通配符，即有效期為這個??證書。這些名稱對所連接的對端的主機名進行測試，如果任一標的信息[CommonName](qsslcertificate.html#SubjectInfo-enum)沒有定義一個有效的主機名，或拍攝主體信息名稱不匹配對端的主機名。 **See also** [subjectInfo](qsslcertificate.html#subjectInfo)（）。 ``` QSslCertificate.clear (self) ``` 清除該證書的內容，使之成為一個空證書。 **See also** [isNull](qsslcertificate.html#isNull)（）。 ``` QByteArray QSslCertificate.digest (self, QCryptographicHash.Algorithm?algorithm?=?QCryptographicHash.Md5) ``` [ 返回此證書的加密摘要。默認情況下，一個MD5摘要將會產生，但您也可以指定自定義_algorithm_。 ](qbytearray.html) ``` QDateTime QSslCertificate.effectiveDate (self) ``` [](qdatetime.html) [返回的日期，時間，該證書生效，或空](qdatetime.html)[QDateTime](qdatetime.html)如果這是一個無效的證書。 **See also** [expiryDate](qsslcertificate.html#expiryDate)（）。 ``` QDateTime QSslCertificate.expiryDate (self) ``` [](qdatetime.html) [返回日期時間的證書過期，或空](qdatetime.html)[QDateTime](qdatetime.html)如果這是一個無效的證書。 **See also** [effectiveDate](qsslcertificate.html#effectiveDate)（）。 ``` list-of-QSslCertificate QSslCertificate.fromData (QByteArray?data, QSsl.EncodingFormat?format?=?QSsl.Pem) ``` 搜索和分析所有證書_data_被編碼在指定_format_并返回他們的證書的列表。 **See also** [fromDevice](qsslcertificate.html#fromDevice)（）。 ``` list-of-QSslCertificate QSslCertificate.fromDevice (QIODevice?device, QSsl.EncodingFormat?format?=?QSsl.Pem) ``` 搜索和分析所有證書_device_被編碼在指定_format_并返回他們的證書的列表。 **See also** [fromData](qsslcertificate.html#fromData)（）。 ``` list-of-QSslCertificate QSslCertificate.fromPath (QString?path, QSsl.EncodingFormat?format?=?QSsl.Pem, QRegExp.PatternSyntax?syntax?=?QRegExp.FixedString) ``` 搜索中的所有文件_path_對于證書編碼指定_format_并返回它們在列表中。_must_是一個文件或一個圖案匹配一個或多個文件，所指定的_syntax_。例如： ``` foreach (const [QSslCertificate](qsslcertificate.html) &cert, [QSslCertificate](qsslcertificate.html).fromPath("C:/ssl/certificate.*.pem", [QSsl](qssl.html).Pem, [QRegExp](qregexp.html).Wildcard)) { qDebug() << cert.issuerInfo([QSslCertificate](qsslcertificate.html).Organization); } ``` **See also** [fromData](qsslcertificate.html#fromData)（）。 ``` int QSslCertificate.handle (self) ``` 返回一個指向本地證書手柄，如果有一個或一個空指針，否則。你可以使用這個句柄，與原生API一起，訪問有關證書的擴展信息。 **Warning:**使用此功能有被非便攜式的概率很高，它的返回值可能會有所不同從平臺到平臺或次要版本變更次要版本。 ``` bool QSslCertificate.isNull (self) ``` 返回True如果這是一個空證書（即一個沒有內容的證書），否則返回False 。默認情況下，[QSslCertificate](qsslcertificate.html)構造一個空證書。 **See also** [isValid](qsslcertificate.html#isValid)（）和[clear](qsslcertificate.html#clear)（）。 ``` QString QSslCertificate.issuerInfo (self, SubjectInfo?info) ``` 返回發行人信息的_subject_從證書，或空字符串，如果沒有信息_subject_在證書中。 **See also** [subjectInfo](qsslcertificate.html#subjectInfo)（）。 ``` QString QSslCertificate.issuerInfo (self, QByteArray?tag) ``` 返回發行人信息_tag_從證書，或空字符串，如果沒有信息_tag_在證書中。 **See also** [subjectInfo](qsslcertificate.html#subjectInfo)（）。 ``` bool QSslCertificate.isValid (self) ``` 返回True如果該證書是有效的，否則返回False 。注：目前，該功能會檢查當前的數據時間是在此期間，該證書被認為有效的日期時間范圍內，并檢查該證書是不是在欺詐證書的黑名單。 **See also** [isNull](qsslcertificate.html#isNull)（）。 ``` QSslKey QSslCertificate.publicKey (self) ``` [ 返回證書主題的公鑰。 ](qsslkey.html) ``` QByteArray QSslCertificate.serialNumber (self) ``` [ 以十進制格式返回該證書的序列號字符串。若序列號不能轉換為十進制格式（例如，如果它大于4294967295 ，這意味著它不適合4個字節），則返回其十六進制的版本。 ``` QString QSslCertificate.subjectInfo (self, SubjectInfo?info) ``` 返回的信息為_subject_，或空字符串，如果沒有信息_subject_在證書中。 ](qbytearray.html) [**See also**](qbytearray.html) [issuerInfo](qsslcertificate.html#issuerInfo)（）。 ``` QString QSslCertificate.subjectInfo (self, QByteArray?tag) ``` 返回主題信息_tag_，或空字符串，如果沒有信息_tag_在證書中。 **See also** [issuerInfo](qsslcertificate.html#issuerInfo)（）。 ``` QByteArray QSslCertificate.toDer (self) ``` [ 返回此證書轉換為DER （二進制）編碼表示。 ](qbytearray.html) ``` QByteArray QSslCertificate.toPem (self) ``` [ 返回此證書轉換為PEM （ Base64編碼）編碼表示。 ](qbytearray.html) ``` QByteArray QSslCertificate.version (self) ``` [ 返回證書的版本字符串。 ``` bool QSslCertificate.__eq__ (self, QSslCertificate?other) ``` ``` bool QSslCertificate.__ne__ (self, QSslCertificate?other) ``` ](qbytearray.html)