Qt Cryptographic Architecture
Public Member Functions | Static Public Member Functions | Friends | List of all members
QCA::CertificateRequest Class Reference

#include <QtCrypto>

Collaboration diagram for QCA::CertificateRequest:
Collaboration graph
[legend]

Public Member Functions

 CertificateRequest ()
 
 CertificateRequest (const CertificateOptions &opts, const PrivateKey &key, const QString &provider=QString())
 
 CertificateRequest (const CertificateRequest &from)
 
 CertificateRequest (const QString &fileName)
 
QString challenge () const
 
void change (CSRContext *c)
 
Constraints constraints () const
 
CertificateRequestFormat format () const
 
bool isCA () const
 
bool isNull () const
 
bool operator!= (const CertificateRequest &other) const
 
CertificateRequestoperator= (const CertificateRequest &from)
 
bool operator== (const CertificateRequest &csr) const
 
int pathLimit () const
 
QStringList policies () const
 
SignatureAlgorithm signatureAlgorithm () const
 
CertificateInfo subjectInfo () const
 
CertificateInfoOrdered subjectInfoOrdered () const
 
PublicKey subjectPublicKey () const
 
QByteArray toDER () const
 
QString toPEM () const
 
bool toPEMFile (const QString &fileName) const
 
QString toString () 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::Contextcontext ()
 
const Provider::Contextcontext () const
 
Algorithmoperator= (const Algorithm &from)
 
Providerprovider () const
 
Provider::ContexttakeContext ()
 
QString type () const
 

Static Public Member Functions

static bool canUseFormat (CertificateRequestFormat f, const QString &provider=QString())
 
static CertificateRequest fromDER (const QByteArray &a, ConvertResult *result=nullptr, const QString &provider=QString())
 
static CertificateRequest fromPEM (const QString &s, ConvertResult *result=nullptr, const QString &provider=QString())
 
static CertificateRequest fromPEMFile (const QString &fileName, ConvertResult *result=nullptr, const QString &provider=QString())
 
static CertificateRequest fromString (const QString &s, ConvertResult *result=nullptr, const QString &provider=QString())
 

Friends

class Private
 

Additional Inherited Members

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

Detailed Description

Certificate Request

A CertificateRequest is a unsigned request for a Certificate

Constructor & Destructor Documentation

◆ CertificateRequest() [1/4]

QCA::CertificateRequest::CertificateRequest ( )

Create an empty certificate request.

◆ CertificateRequest() [2/4]

QCA::CertificateRequest::CertificateRequest ( const QString &  fileName)

Create a certificate request based on the contents of a file.

Parameters
fileNamethe file (and path, if necessary) containing a PEM encoded certificate request

◆ CertificateRequest() [3/4]

QCA::CertificateRequest::CertificateRequest ( const CertificateOptions opts,
const PrivateKey key,
const QString &  provider = QString() 
)

Create a certificate request based on specified options.

Parameters
optsthe options to use in the certificate request
keythe private key that matches the certificate being requested
providerthe provider to use, if a specific provider is required

◆ CertificateRequest() [4/4]

QCA::CertificateRequest::CertificateRequest ( const CertificateRequest from)

Standard copy constructor.

Parameters
fromthe request to copy from

Member Function Documentation

◆ operator=()

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

Standard assignment operator.

Parameters
fromthe request to assign from

◆ isNull()

bool QCA::CertificateRequest::isNull ( ) const

test if the certificate request is empty

Returns
true if the certificate request is empty, otherwise false

◆ canUseFormat()

static bool QCA::CertificateRequest::canUseFormat ( CertificateRequestFormat  f,
const QString &  provider = QString() 
)
static

Test if the certificate request can use a specified format.

Parameters
fthe format to test for
providerthe provider to use, if a specific provider is required
Returns
true if the certificate request can use the specified format

◆ format()

CertificateRequestFormat QCA::CertificateRequest::format ( ) const

the format that this Certificate request is in

◆ subjectInfo()

CertificateInfo QCA::CertificateRequest::subjectInfo ( ) const

Information on the subject of the certificate being requested.

Note
this only applies to PKCS#10 format certificate requests
See also
subjectInfoOrdered for a version that maintains order in the subject information.

◆ subjectInfoOrdered()

CertificateInfoOrdered QCA::CertificateRequest::subjectInfoOrdered ( ) const

Information on the subject of the certificate being requested, as an ordered list (QList of CertificateInfoPair).

Note
this only applies to PKCS#10 format certificate requests
See also
subjectInfo for a version that does not maintain order, but allows access based on a multimap.
CertificateInfoPair for the elements in the list

◆ constraints()

Constraints QCA::CertificateRequest::constraints ( ) const

The constraints that apply to this certificate request.

Note
this only applies to PKCS#10 format certificate requests

◆ policies()

QStringList QCA::CertificateRequest::policies ( ) const

The policies that apply to this certificate request.

Note
this only applies to PKCS#10 format certificate requests

◆ subjectPublicKey()

PublicKey QCA::CertificateRequest::subjectPublicKey ( ) const

The public key belonging to the issuer.

◆ isCA()

bool QCA::CertificateRequest::isCA ( ) const

Test if this Certificate Request is for a Certificate Authority certificate.

Note
this only applies to PKCS#10 format certificate requests

◆ pathLimit()

int QCA::CertificateRequest::pathLimit ( ) const

The path limit for the certificate in this Certificate Request.

Note
this only applies to PKCS#10 format certificate requests

◆ challenge()

QString QCA::CertificateRequest::challenge ( ) const

The challenge associated with this certificate request.

◆ signatureAlgorithm()

SignatureAlgorithm QCA::CertificateRequest::signatureAlgorithm ( ) const

The algorithm used to make the signature on this certificate request.

◆ operator==()

bool QCA::CertificateRequest::operator== ( const CertificateRequest csr) const

Test for equality of two certificate requests.

Parameters
csrthe certificate request to be compared to this certificate request
Returns
true if the two certificate requests are the same

◆ operator!=()

bool QCA::CertificateRequest::operator!= ( const CertificateRequest other) const
inline

Inequality operator.

Parameters
otherthe certificate request to be compared to this certificate request

◆ toDER()

QByteArray QCA::CertificateRequest::toDER ( ) const

Export the Certificate Request into a DER format.

Note
this only applies to PKCS#10 format certificate requests

◆ toPEM()

QString QCA::CertificateRequest::toPEM ( ) const

Export the Certificate Request into a PEM format.

Note
this only applies to PKCS#10 format certificate requests

◆ toPEMFile()

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

Export the Certificate into PEM format in a file.

Parameters
fileNamethe name of the file to use
Note
this only applies to PKCS#10 format certificate requests

◆ fromDER()

static CertificateRequest QCA::CertificateRequest::fromDER ( const QByteArray &  a,
ConvertResult result = nullptr,
const QString &  provider = QString() 
)
static

Import the certificate request from DER.

Parameters
athe array containing the certificate request in DER format
resulta pointer to a ConvertResult, which if not-null will be set to the conversion status
providerthe provider to use, if a specific provider is required
Returns
the CertificateRequest corresponding to the certificate request in the provided array
Note
this only applies to PKCS#10 format certificate requests

◆ fromPEM()

static CertificateRequest QCA::CertificateRequest::fromPEM ( const QString &  s,
ConvertResult result = nullptr,
const QString &  provider = QString() 
)
static

Import the certificate request from PEM format.

Parameters
sthe string containing the certificate request in PEM format
resulta pointer to a ConvertResult, which if not-null will be set to the conversion status
providerthe provider to use, if a specific provider is required
Returns
the CertificateRequest corresponding to the certificate request in the provided string
Note
this only applies to PKCS#10 format certificate requests

◆ fromPEMFile()

static CertificateRequest QCA::CertificateRequest::fromPEMFile ( const QString &  fileName,
ConvertResult result = nullptr,
const QString &  provider = QString() 
)
static

Import the certificate request from a file.

Parameters
fileNamethe name (and path, if required) of the file containing the certificate request in PEM format
resulta pointer to a ConvertResult, which if not-null will be set to the conversion status
providerthe provider to use, if a specific provider is required
Returns
the CertificateRequest corresponding to the certificate request in the provided string
Note
this only applies to PKCS#10 format certificate requests

◆ toString()

QString QCA::CertificateRequest::toString ( ) const

Export the CertificateRequest to a string.

Returns
the string corresponding to the certificate request
Note
this only applies to SPKAC format certificate requests

◆ fromString()

static CertificateRequest QCA::CertificateRequest::fromString ( const QString &  s,
ConvertResult result = nullptr,
const QString &  provider = QString() 
)
static

Import the CertificateRequest from a string.

Parameters
sthe string containing to the certificate request
resulta pointer to a ConvertResult, which if not-null will be set to the conversion status
providerthe provider to use, if a specific provider is required
Returns
the CertificateRequest corresponding to the certificate request in the provided string
Note
this only applies to SPKAC format certificate requests

◆ change()

void QCA::CertificateRequest::change ( CSRContext c)
Parameters
ccontext (internal)

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