KIO
#include <ksslcertificate.h>
Static Public Member Functions | |
static KSSLCertificate * | fromString (const QByteArray &cert) |
static KSSLCertificate * | fromX509 (X509 *x5) |
static QString | getMD5DigestFromKDEKey (const QString &k) |
static QString | verifyText (KSSLValidation x) |
Protected Member Functions | |
KSSLCertificate () | |
X509 * | getCert () |
KSSLValidation | processError (int ec) |
void | setCert (X509 *c) |
void | setChain (void *c) |
Friends | |
int | operator!= (KSSLCertificate &x, KSSLCertificate &y) |
int | operator== (KSSLCertificate &x, KSSLCertificate &y) |
Detailed Description
KDE X.509 Certificate.
This class represents an X.509 (SSL) certificate. Note: this object is VERY HEAVY TO COPY. Please try to use reference or pointer whenever possible
Definition at line 74 of file ksslcertificate.h.
Member Typedef Documentation
typedef QList<KSSLValidation> KSSLCertificate::KSSLValidationList |
Definition at line 149 of file ksslcertificate.h.
Member Enumeration Documentation
Definition at line 146 of file ksslcertificate.h.
Result of the validate() call.
A CA certificate can be validated as Irrelevant when it was not used to sign any other relevant certificate.
- Enumerator:
Definition at line 119 of file ksslcertificate.h.
Constructor & Destructor Documentation
KSSLCertificate::~KSSLCertificate | ( | ) |
Destroy this X.509 certificate.
Definition at line 118 of file ksslcertificate.cpp.
KSSLCertificate::KSSLCertificate | ( | const KSSLCertificate & | x | ) |
Copy constructor.
Beware, this is very expensive.
- Parameters:
-
x the object to copy from
Definition at line 103 of file ksslcertificate.cpp.
|
protected |
Definition at line 93 of file ksslcertificate.cpp.
Member Function Documentation
KSSLCertChain & KSSLCertificate::chain | ( | ) |
Get a reference to the certificate chain.
- Returns:
- reference to the chain
Definition at line 128 of file ksslcertificate.cpp.
|
static |
Create an X.509 certificate from a base64 encoded string.
- Parameters:
-
cert the certificate in base64 form
- Returns:
- the X.509 certificate, or NULL
Definition at line 145 of file ksslcertificate.cpp.
|
static |
Create an X.509 certificate from the internal representation.
This one duplicates the X509 object for itself.
- Parameters:
-
x5 the OpenSSL representation of the certificate
- Returns:
- the X.509 certificate, or NULL
Definition at line 133 of file ksslcertificate.cpp.
|
protected |
Definition at line 569 of file ksslcertificate.cpp.
void KSSLCertificate::getEmails | ( | QStringList & | to | ) | const |
FIXME: document.
Definition at line 228 of file ksslcertificate.cpp.
QString KSSLCertificate::getIssuer | ( | ) | const |
Get the issuer of the certificate (X.509 map).
- Returns:
- the issuer
Definition at line 444 of file ksslcertificate.cpp.
QString KSSLCertificate::getKDEKey | ( | ) | const |
KDEKey is a concatenation "Subject (MD5)", mostly needed for SMIME.
The result of getKDEKey might change and should not be used for persistant storage.
Definition at line 246 of file ksslcertificate.cpp.
QString KSSLCertificate::getKeyType | ( | ) | const |
Get the key type (RSA, DSA, etc).
- Returns:
- the key type as a string
Definition at line 313 of file ksslcertificate.cpp.
QString KSSLCertificate::getMD5Digest | ( | ) | const |
Get the MD5 digest of the certificate.
- Returns:
- the MD5 digest in a hexidecimal string
Definition at line 290 of file ksslcertificate.cpp.
Aegypten semantics force us to search by MD5Digest only.
Definition at line 251 of file ksslcertificate.cpp.
QString KSSLCertificate::getMD5DigestText | ( | ) | const |
Get the MD5 digest of the certificate.
Result is padded with : to separate bytes - it's a text version!
- Returns:
- the MD5 digest in a hexidecimal string
Definition at line 264 of file ksslcertificate.cpp.
QString KSSLCertificate::getNotAfter | ( | ) | const |
Get the date that the certificate is valid until.
- Returns:
- the date as a string, localised
Definition at line 988 of file ksslcertificate.cpp.
QString KSSLCertificate::getNotBefore | ( | ) | const |
Get the date that the certificate becomes valid on.
- Returns:
- the date as a string, localised
Definition at line 979 of file ksslcertificate.cpp.
QString KSSLCertificate::getPublicKeyText | ( | ) | const |
Get the public key.
- Returns:
- the public key as a hexidecimal string
Definition at line 341 of file ksslcertificate.cpp.
QDateTime KSSLCertificate::getQDTNotAfter | ( | ) | const |
Get the date that the certificate is valid until.
- Returns:
- the date
Definition at line 1006 of file ksslcertificate.cpp.
QDateTime KSSLCertificate::getQDTNotBefore | ( | ) | const |
Get the date that the certificate becomes valid on.
- Returns:
- the date
Definition at line 997 of file ksslcertificate.cpp.
QString KSSLCertificate::getSerialNumber | ( | ) | const |
Get the serial number of the certificate.
- Returns:
- the serial number as a string
Definition at line 182 of file ksslcertificate.cpp.
QString KSSLCertificate::getSignatureText | ( | ) | const |
Get the signature.
- Returns:
- the signature in text format
Definition at line 196 of file ksslcertificate.cpp.
QString KSSLCertificate::getSubject | ( | ) | const |
Get the subject of the certificate (X.509 map).
- Returns:
- the subject
Definition at line 167 of file ksslcertificate.cpp.
bool KSSLCertificate::isSigner | ( | ) |
Check if this is a signer certificate.
- Returns:
- true if this is a signer certificate
Definition at line 1280 of file ksslcertificate.cpp.
bool KSSLCertificate::isValid | ( | ) |
Check if this is a valid certificate.
Will use cached data.
- Returns:
- true if it is valid
Definition at line 587 of file ksslcertificate.cpp.
bool KSSLCertificate::isValid | ( | KSSLCertificate::KSSLPurpose | p | ) |
Check if this is a valid certificate.
Will use cached data.
- Parameters:
-
p the purpose to validate for
- Returns:
- true if it is valid
Definition at line 582 of file ksslcertificate.cpp.
|
protected |
Definition at line 788 of file ksslcertificate.cpp.
KSSLCertificate * KSSLCertificate::replicate | ( | ) |
Explicitly make a copy of this certificate.
- Returns:
- a copy of the certificate
Definition at line 1027 of file ksslcertificate.cpp.
KSSLCertificate::KSSLValidation KSSLCertificate::revalidate | ( | ) |
Check if this is a valid certificate.
Will NOT use cached data.
- Returns:
- the result of the validation
Definition at line 777 of file ksslcertificate.cpp.
KSSLCertificate::KSSLValidation KSSLCertificate::revalidate | ( | KSSLCertificate::KSSLPurpose | p | ) |
Check if this is a valid certificate.
Will NOT use cached data.
- Parameters:
-
p the purpose to validate for
- Returns:
- the result of the validation
Definition at line 782 of file ksslcertificate.cpp.
Re-set the certificate from a base64 string.
- Parameters:
-
cert the certificate to set to
- Returns:
- true on success
Definition at line 1260 of file ksslcertificate.cpp.
|
protected |
Definition at line 469 of file ksslcertificate.cpp.
|
protected |
Definition at line 461 of file ksslcertificate.cpp.
QStringList KSSLCertificate::subjAltNames | ( | ) | const |
The alternate subject name.
- Returns:
- string list with subjectAltName
Definition at line 1285 of file ksslcertificate.cpp.
QByteArray KSSLCertificate::toDer | ( | ) |
Convert the certificate to DER (ASN.1) format.
- Returns:
- the binary data of the DER encoding
Definition at line 1149 of file ksslcertificate.cpp.
QByteArray KSSLCertificate::toNetscape | ( | ) |
Convert the certificate to Netscape format.
- Returns:
- the binary data of the Netscape encoding
Definition at line 1211 of file ksslcertificate.cpp.
QByteArray KSSLCertificate::toPem | ( | ) |
Convert the certificate to PEM (base64) format.
- Returns:
- the binary data of the PEM encoding
Definition at line 1171 of file ksslcertificate.cpp.
QString KSSLCertificate::toString | ( | ) |
Convert this certificate to a string.
- Returns:
- the certificate in base64 format
Definition at line 1041 of file ksslcertificate.cpp.
QString KSSLCertificate::toText | ( | ) |
Convert the certificate to OpenSSL plain text format.
- Returns:
- the OpenSSL text encoding
Definition at line 1238 of file ksslcertificate.cpp.
KSSLCertificate::KSSLValidation KSSLCertificate::validate | ( | ) |
Check if this is a valid certificate.
Will use cached data.
- Returns:
- the result of the validation
Definition at line 612 of file ksslcertificate.cpp.
KSSLCertificate::KSSLValidation KSSLCertificate::validate | ( | KSSLCertificate::KSSLPurpose | purpose | ) |
Check if this is a valid certificate.
Will use cached data.
- Parameters:
-
p the purpose to validate for
- Returns:
- the result of the validation
Definition at line 616 of file ksslcertificate.cpp.
KSSLCertificate::KSSLValidationList KSSLCertificate::validateVerbose | ( | KSSLCertificate::KSSLPurpose | purpose | ) |
Check if this is a valid certificate.
Will use cached data.
- Parameters:
-
p the purpose to validate for
- Returns:
- all problems encountered during validation
Definition at line 631 of file ksslcertificate.cpp.
KSSLCertificate::KSSLValidationList KSSLCertificate::validateVerbose | ( | KSSLCertificate::KSSLPurpose | purpose, |
KSSLCertificate * | ca | ||
) |
Check if the certificate ca is a proper CA for this certificate.
- Parameters:
-
p the purpose to validate for ca the certificate to check
- Returns:
- all problems encountered during validation
Definition at line 636 of file ksslcertificate.cpp.
|
static |
Obtain the localized message that corresponds to a validation result.
- Parameters:
-
x the code to look up
- Returns:
- the message text corresponding to the validation code
Definition at line 1047 of file ksslcertificate.cpp.
KSSLX509V3 & KSSLCertificate::x509V3Extensions | ( | ) |
Access the X.509v3 parameters.
- Returns:
- reference to the extension object
- See also:
- KSSLX509V3
Definition at line 1275 of file ksslcertificate.cpp.
Friends And Related Function Documentation
|
friend |
Definition at line 397 of file ksslcertificate.h.
|
friend |
Definition at line 1015 of file ksslcertificate.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2013 The KDE developers.
Generated on Tue Jul 23 2013 22:01:04 by doxygen 1.8.1.1 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.