SiCertificate Class Reference

a class representing X.509 public key certificates. More...

Public Member Functions
	SiCertificate ()
	default constructor
virtual	~SiCertificate ()
	destructor
OFCondition	loadCertificate (const char *filename, int filetype)
	loads an X.509 certificate from file. More...
OFCondition	read (DcmItem &item)
	reads an X.509 certificate from an item of the Digital Signatures Sequence and checks the certificate type information in the item. More...
OFCondition	write (DcmItem &item)
	writes the current X.509 certificate into an item of the Digital Signatures Sequence and creates the certificate type information in the item. More...
E_KeyType	getKeyType ()
	returns the type of public key stored in this certificate
SiAlgorithm *	createAlgorithmForPublicKey ()
	creates an SiAlgorithm object for the public key contained in this certificate. More...
long	getX509Version ()
	returns the format version of the X.509 certificate. More...
void	getCertSubjectName (OFString &str)
	returns the subject name (distinguished name) of the current certificate. More...
void	getCertIssuerName (OFString &str)
	returns the issuer name (distinguished name) of the current certificate. More...
long	getCertSerialNo ()
	returns the serial number of the X.509 certificate. More...
void	getCertValidityNotBefore (OFString &str)
	returns the start of validity of the current certificate in human readable form. More...
void	getCertValidityNotAfter (OFString &str)
	returns the end of validity of the current certificate in human readable form. More...
long	getCertKeyBits ()
	returns the strength (number of bits) of the public key contained in the current certificate. More...
X509 *	getRawCertificate ()
	returns a pointer to the raw certificate structure or NULL if no certificate present. More...

Private Member Functions
	SiCertificate (SiCertificate &arg)
	private undefined copy constructor
SiCertificate &	operator= (SiCertificate &arg)
	private undefined copy assignment operator

Private Attributes
X509 *	x509
	OpenSSL X.509 structure.

Detailed Description

a class representing X.509 public key certificates.

Member Function Documentation

createAlgorithmForPublicKey()

SiAlgorithm* SiCertificate::createAlgorithmForPublicKey

(

)

creates an SiAlgorithm object for the public key contained in this certificate.

If no certificate loaded or operation fails, returns NULL. New SiAlgorithm object must be deleted by caller.

Returns

pointer to new SiAlgorithm object

getCertIssuerName()

void SiCertificate::getCertIssuerName

(

OFString &

str

)

returns the issuer name (distinguished name) of the current certificate.

If no certificate is loaded, returns an empty string.

Parameters

str	issuer name returned in this string.

getCertKeyBits()

long SiCertificate::getCertKeyBits

(

)

returns the strength (number of bits) of the public key contained in the current certificate.

If no certificate is loaded, returns 0.

Returns

key strength in bits.

getCertSerialNo()

long SiCertificate::getCertSerialNo

(

)

returns the serial number of the X.509 certificate.

If no certificate is loaded, returns -1.

Returns

X.509 certificate serial number

getCertSubjectName()

void SiCertificate::getCertSubjectName

(

OFString &

str

)

returns the subject name (distinguished name) of the current certificate.

If no certificate is loaded, returns an empty string.

Parameters

str	subject name returned in this string.

getCertValidityNotAfter()

void SiCertificate::getCertValidityNotAfter

(

OFString &

str

)

returns the end of validity of the current certificate in human readable form.

If no certificate is loaded, returns an empty string.

Parameters

str	end of validity returned in this string.

getCertValidityNotBefore()

void SiCertificate::getCertValidityNotBefore

(

OFString &

str

)

returns the start of validity of the current certificate in human readable form.

If no certificate is loaded, returns an empty string.

Parameters

str	start of validity returned in this string.

getRawCertificate()

X509* SiCertificate::getRawCertificate

(

)

returns a pointer to the raw certificate structure or NULL if no certificate present.

Should not be called by users of this library.

getX509Version()

long SiCertificate::getX509Version

(

)

returns the format version of the X.509 certificate.

If no certificate is loaded, returns 0.

Returns

X.509 certificate version

loadCertificate()

OFCondition SiCertificate::loadCertificate	(	const char *	filename,
		int	filetype
	)

loads an X.509 certificate from file.

Parameters

filename	file name of X.509 certificate
filetype	file format: X509_FILETYPE_PEM or X509_FILETYPE_ASN1

Returns

status code

read()

OFCondition SiCertificate::read

(

DcmItem &

item

)

reads an X.509 certificate from an item of the Digital Signatures Sequence and checks the certificate type information in the item.

Parameters

item	item of the DigitalSignatureSQ from which the certificate is read

Returns

status code

write()

OFCondition SiCertificate::write

(

DcmItem &

item

)

writes the current X.509 certificate into an item of the Digital Signatures Sequence and creates the certificate type information in the item.

Parameters

item	item of the DigitalSignatureSQ to which the certificate is written

Returns

dcmdata OFCondition status code

---

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

• dcmsign/include/dcmtk/dcmsign/sicert.h