#include <QtCrypto>
Inheritance diagram for QCA::Certificate:
This class contains one X.509 certificate
certtest.cpp, cmssigner/main.cpp, publickeyexample.cpp, sslservtest.cpp, and ssltest.cpp.
| QCA::Certificate::Certificate | ( | ) |
Create an empty Certificate.
| QCA::Certificate::Certificate | ( | const QString & | fileName | ) |
Create a Certificate from a PEM encoded file.
| fileName | the name (and path, if required) of the file that contains the PEM encoded certificate |
| QCA::Certificate::Certificate | ( | const CertificateOptions & | opts, | |
| const PrivateKey & | key, | |||
| const QString & | provider = QString() | |||
| ) |
Create a Certificate with specified options and a specified private key.
| opts | the options to use | |
| key | the private key for this certificate | |
| provider | the provider to use to create this key, if a particular provider is required |
| QCA::Certificate::Certificate | ( | const Certificate & | from | ) |
Standard copy constructor.
| Certificate& QCA::Certificate::operator= | ( | const Certificate & | from | ) |
Standard assignment operator.
| bool QCA::Certificate::isNull | ( | ) | const |
Test if the certificate is empty (null).
| QDateTime QCA::Certificate::notValidBefore | ( | ) | const |
The earliest date that the certificate is valid.
| QDateTime QCA::Certificate::notValidAfter | ( | ) | const |
The latest date that the certificate is valid.
| CertificateInfo QCA::Certificate::subjectInfo | ( | ) | const |
Properties of the subject of the certificate, as a QMultiMap.
This is the method that provides information on the subject organisation, common name, DNS name, and so on. The list of information types (i.e. the key to the multi-map) is a CertificateInfoType. The values are a list of QString.
An example of how you can iterate over the list is:
| CertificateInfoOrdered QCA::Certificate::subjectInfoOrdered | ( | ) | const |
Properties of the subject of the certificate, as an ordered list (QList of CertificateInfoPair).
This allows access to the certificate information in the same order as they appear in a certificate. Each pair in the list has a type and a value.
For example:
CertificateInfoOrdered info = cert.subjectInfoOrdered(); // info[0].type == CommonName // info[0].value == "example.com"
issuerInfoOrdered for the ordered information on the issuer
CertificateInfoPair for the elements in the list
| CertificateInfo QCA::Certificate::issuerInfo | ( | ) | const |
Properties of the issuer of the certificate.
| CertificateInfoOrdered QCA::Certificate::issuerInfoOrdered | ( | ) | const |
Properties of the issuer of the certificate, as an ordered list (QList of CertificateInfoPair).
This allows access to the certificate information in the same order as they appear in a certificate. Each pair in the list has a type and a value.
subjectInfoOrdered for the ordered information on the subject
CertificateInfoPair for the elements in the list
| Constraints QCA::Certificate::constraints | ( | ) | const |
The constraints that apply to this certificate.
| QStringList QCA::Certificate::policies | ( | ) | const |
The policies that apply to this certificate.
Policies are specified as strings containing OIDs
| QStringList QCA::Certificate::crlLocations | ( | ) | const |
| QStringList QCA::Certificate::issuerLocations | ( | ) | const |
list of URI locations for issuer certificate files
each URI refers to the same issuer file
| QStringList QCA::Certificate::ocspLocations | ( | ) | const |
list of URI locations for OCSP services
| QString QCA::Certificate::commonName | ( | ) | const |
The common name of the subject of the certificate.
Common names are normally the name of a person, company or organisation
| BigInteger QCA::Certificate::serialNumber | ( | ) | const |
| PublicKey QCA::Certificate::subjectPublicKey | ( | ) | const |
The public key associated with the subject of the certificate.
| bool QCA::Certificate::isCA | ( | ) | const |
Test if the Certificate is valid as a Certificate Authority.
| bool QCA::Certificate::isSelfSigned | ( | ) | const |
Test if the Certificate is self-signed.
| bool QCA::Certificate::isIssuerOf | ( | const Certificate & | other | ) | const |
Test if the Certificate has signed another Certificate object and is therefore the issuer.
| int QCA::Certificate::pathLimit | ( | ) | const |
The upper bound of the number of links in the certificate chain, if any.
| SignatureAlgorithm QCA::Certificate::signatureAlgorithm | ( | ) | const |
The signature algorithm used for the signature on this certificate.
| QByteArray QCA::Certificate::subjectKeyId | ( | ) | const |
The key identifier associated with the subject.
| QByteArray QCA::Certificate::issuerKeyId | ( | ) | const |
The key identifier associated with the issuer.
| Validity QCA::Certificate::validate | ( | const CertificateCollection & | trusted, | |
| const CertificateCollection & | untrusted, | |||
| UsageMode | u = UsageAny, |
|||
| ValidateFlags | vf = ValidateAll | |||
| ) | const |
Check the validity of a certificate.
| trusted | a collection of trusted certificates | |
| untrusted | a collection of additional certificates, not necessarily trusted | |
| u | the use required for the certificate | |
| vf | the conditions to validate |
| QByteArray QCA::Certificate::toDER | ( | ) | const |
| QString QCA::Certificate::toPEM | ( | ) | const |
| bool QCA::Certificate::toPEMFile | ( | const QString & | fileName | ) | const |
| static Certificate QCA::Certificate::fromDER | ( | const QByteArray & | a, | |
| ConvertResult * | result = 0, |
|||
| const QString & | provider = QString() | |||
| ) | [static] |
Import the certificate from DER.
| a | the array containing the certificate in DER format | |
| result | a pointer to a ConvertResult, which if not-null will be set to the conversion status | |
| provider | the provider to use, if a specific provider is required |
| static Certificate QCA::Certificate::fromPEM | ( | const QString & | s, | |
| ConvertResult * | result = 0, |
|||
| const QString & | provider = QString() | |||
| ) | [static] |
Import the certificate from PEM format.
| s | the string containing the certificate in PEM format | |
| result | a pointer to a ConvertResult, which if not-null will be set to the conversion status | |
| provider | the provider to use, if a specific provider is required |
| static Certificate QCA::Certificate::fromPEMFile | ( | const QString & | fileName, | |
| ConvertResult * | result = 0, |
|||
| const QString & | provider = QString() | |||
| ) | [static] |
Import the certificate from a file.
| fileName | the name (and path, if required) of the file containing the certificate in PEM format | |
| result | a pointer to a ConvertResult, which if not-null will be set to the conversion status | |
| provider | the provider to use, if a specific provider is required |
| bool QCA::Certificate::matchesHostName | ( | const QString & | host | ) | const |
Test if the subject of the certificate matches a specified host name.
This will return true (indicating a match), if the specified host name meets the RFC 2818 validation rules with this certificate.
If the host is an internationalized domain name, then it must be provided in unicode format, not in IDNA ACE/punycode format.
| host | the name of the host to compare to |
| bool QCA::Certificate::operator== | ( | const Certificate & | a | ) | const |
Test for equality of two certificates.
| bool QCA::Certificate::operator!= | ( | const Certificate & | other | ) | const [inline] |
Inequality operator.
| void QCA::Certificate::change | ( | CertContext * | c | ) |
For internal use only.
1.5.2