QCA::CRL Class Reference

Certificate Revocation List More...

#include <QtCrypto>

Inheritance diagram for QCA::CRL:

QCA::Algorithm Collaboration diagram for QCA::CRL:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 CRL (const CRL &from)
CRL & operator= (const CRL &from)
bool isNull () const
CertificateInfo issuerInfo () const
CertificateInfoOrdered issuerInfoOrdered () const
int number () const
QDateTime thisUpdate () const
QDateTime nextUpdate () const
QList< CRLEntry > revoked () const
SignatureAlgorithm signatureAlgorithm () const
QByteArray issuerKeyId () const
bool operator== (const CRL &a) const
bool operator!= (const CRL &other) const
QByteArray toDER () const
QString toPEM () const
bool toPEMFile (const QString &fileName) const
void change (CRLContext *c)

Static Public Member Functions

static CRL fromDER (const QByteArray &a, ConvertResult *result=0, const QString &provider=QString())
static CRL fromPEM (const QString &s, ConvertResult *result=0, const QString &provider=QString())
static CRL fromPEMFile (const QString &fileName, ConvertResult *result=0, const QString &provider=QString())

Friends

class Private

Detailed Description

Certificate Revocation List

A CRL is a list of certificates that are special in some way. The normal reason for including a certificate on a CRL is that the certificate should no longer be used. For example, if a key is compromised, then the associated certificate may no longer provides appropriate security. There are other reasons why a certificate may be placed on a CRL, as shown in the CRLEntry::Reason enumeration.

See also:
CertificateCollection for a way to handle Certificates and CRLs as a single entity.

CRLEntry for the CRL segment representing a single Certificate.


Constructor & Destructor Documentation

QCA::CRL::CRL (  const CRL &  from  ) 
 

Standard copy constructor.


Member Function Documentation

CRL& QCA::CRL::operator= (  const CRL &  from  ) 
 

Standard assignment operator.

bool QCA::CRL::isNull (   )  const
 

Test if the CRL is empty.

Returns:
true if the CRL is entry, otherwise return false

CertificateInfo QCA::CRL::issuerInfo (   )  const
 

Information on the issuer of the CRL as a QMultiMap.

See also:
issuerInfoOrdered for a version that maintains the order of information fields as per the underlying CRL.

CertificateInfoOrdered QCA::CRL::issuerInfoOrdered (   )  const
 

Information on the issuer of the CRL as an ordered list (QList of CertificateInfoPair).

See also:
issuerInfo for a version that allows lookup based on a multimap.

CertificateInfoPair for the elements in the list

int QCA::CRL::number (   )  const
 

The CRL serial number.

Note that serial numbers are a CRL extension, and not all certificates have one.

Returns:
the CRL serial number, or -1 if there is no serial number

QDateTime QCA::CRL::thisUpdate (   )  const
 

the time that this CRL became (or becomes) valid

QDateTime QCA::CRL::nextUpdate (   )  const
 

the time that this CRL will be obsoleted

you should obtain an updated CRL at this time

QList<CRLEntry> QCA::CRL::revoked (   )  const
 

a list of the revoked certificates in this CRL

SignatureAlgorithm QCA::CRL::signatureAlgorithm (   )  const
 

The signature algorithm used for the signature on this CRL.

QByteArray QCA::CRL::issuerKeyId (   )  const
 

The key identification of the CRL issuer.

bool QCA::CRL::operator== (  const CRL &  a  )  const
 

Test for equality of two Certificate Revocation Lists.

Returns:
true if the two CRLs are the same

bool QCA::CRL::operator!= (  const CRL &  other  )  const [inline]
 

Inequality operator.

QByteArray QCA::CRL::toDER (   )  const
 

Export the Certificate Revocation List (CRL) in DER format.

Returns:
an array containing the CRL in DER format

QString QCA::CRL::toPEM (   )  const
 

Export the Certificate Revocation List (CRL) in PEM format.

Returns:
a string containing the CRL in PEM format

bool QCA::CRL::toPEMFile (  const QString &  fileName  )  const
 

Export the Certificate Revocation List (CRL) into PEM format in a file.

Parameters:
fileName the name of the file to use

static CRL QCA::CRL::fromDER (  const QByteArray &  a,
ConvertResult *  result = 0,
const QString &  provider = QString()
)  [static]
 

Import a DER encoded Certificate Revocation List (CRL).

Parameters:
a the array containing the CRL 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
Returns:
the CRL corresponding to the contents of the array

static CRL QCA::CRL::fromPEM (  const QString &  s,
ConvertResult *  result = 0,
const QString &  provider = QString()
)  [static]
 

Import a PEM encoded Certificate Revocation List (CRL).

Parameters:
s the string containing the CRL 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
Returns:
the CRL corresponding to the contents of the string

static CRL QCA::CRL::fromPEMFile (  const QString &  fileName,
ConvertResult *  result = 0,
const QString &  provider = QString()
)  [static]
 

Import a PEM encoded Certificate Revocation List (CRL) from a file.

Parameters:
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
Returns:
the CRL in the file

void QCA::CRL::change (  CRLContext *  c  ) 
 

For internal use only.


The documentation for this class was generated from the following file:
Generated on Fri Jul 6 13:23:35 2007 for Qt Cryptographic Architecture by  doxygen 1.4.6