QCA::CRL Class Reference

#include <QtCrypto>

Inheritance diagram for QCA::CRL:

Public Member Functions
	CRL (const CRL &from)
void	change (CRLContext *c)
bool	isNull () const
CertificateInfo	issuerInfo () const
CertificateInfoOrdered	issuerInfoOrdered () const
QByteArray	issuerKeyId () const
QDateTime	nextUpdate () const
int	number () const
bool	operator!= (const CRL &other) const
CRL &	operator= (const CRL &from)
bool	operator== (const CRL &a) const
QList< CRLEntry >	revoked () const
SignatureAlgorithm	signatureAlgorithm () const
QDateTime	thisUpdate () const
QByteArray	toDER () const
QString	toPEM () const
bool	toPEMFile (const QString &fileName) const
Public Member Functions inherited from QCA::Algorithm
	Algorithm (const Algorithm &from)
void	change (const QString &type, const QString &provider)
void	change (Provider::Context *c)
Provider::Context *	context ()
const Provider::Context *	context () const
Algorithm &	operator= (const Algorithm &from)
Provider *	provider () const
Provider::Context *	takeContext ()
QString	type () const

Static Public Member Functions
static CRL	fromDER (const QByteArray &a, ConvertResult *result=nullptr, const QString &provider=QString())
static CRL	fromPEM (const QString &s, ConvertResult *result=nullptr, const QString &provider=QString())
static CRL	fromPEMFile (const QString &fileName, ConvertResult *result=nullptr, const QString &provider=QString())

Additional Inherited Members
Protected Member Functions inherited from QCA::Algorithm
	Algorithm ()
	Algorithm (const QString &type, const QString &provider)

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.

Definition at line 1739 of file qca_cert.h.

Constructor & Destructor Documentation

CRL()

QCA::CRL::CRL

(

const CRL &

from

)

Standard copy constructor.

Parameters

from	the revocation list to copy from

Member Function Documentation

change()

void QCA::CRL::change

(

CRLContext *

c

)

Parameters

c	context (internal)

fromDER()

static CRL QCA::CRL::fromDER ( const QByteArray & a, ConvertResult * result = nullptr, 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

fromPEM()

static CRL QCA::CRL::fromPEM ( const QString & s, ConvertResult * result = nullptr, 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

fromPEMFile()

static CRL QCA::CRL::fromPEMFile ( const QString & fileName, ConvertResult * result = nullptr, 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

isNull()

bool QCA::CRL::isNull

(

)

const

Test if the CRL is empty.

Returns

true if the CRL is empty, otherwise return false

issuerInfo()

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.

issuerInfoOrdered()

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

issuerKeyId()

QByteArray QCA::CRL::issuerKeyId

(

)

const

The key identification of the CRL issuer.

nextUpdate()

QDateTime QCA::CRL::nextUpdate

(

)

const

the time that this CRL will be obsoleted

you should obtain an updated CRL at this time

number()

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

operator!=()

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

inline

Inequality operator.

Parameters

other

the CRL to be compared to this CRL

Definition at line 1834 of file qca_cert.h.

operator=()

CRL & QCA::CRL::operator=

(

const CRL &

from

)

Standard assignment operator.

Parameters

from	the revocation list to assign from

operator==()

bool QCA::CRL::operator==

(

const CRL &

a

)

const

Test for equality of two Certificate Revocation Lists.

Parameters

a	the CRL to be compared to this CRL

Returns

true if the two CRLs are the same

revoked()

QList< CRLEntry > QCA::CRL::revoked

(

)

const

a list of the revoked certificates in this CRL

signatureAlgorithm()

SignatureAlgorithm QCA::CRL::signatureAlgorithm

(

)

const

The signature algorithm used for the signature on this CRL.

thisUpdate()

QDateTime QCA::CRL::thisUpdate

(

)

const

the time that this CRL became (or becomes) valid

toDER()

QByteArray QCA::CRL::toDER

(

)

const

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

Returns

an array containing the CRL in DER format

toPEM()

QString QCA::CRL::toPEM

(

)

const

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

Returns

a string containing the CRL in PEM format

toPEMFile()

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

---

The documentation for this class was generated from the following file:

• qca_cert.h