DVSignatureHandler Class Reference

handler for all digital signature related functions in dcmpstat More...

List of all members.

Public Member Functions

DVSignatureHandler (DVConfiguration &cfg)

constructor

virtual ~DVSignatureHandler ()

destructor

const char * getCurrentSignatureValidationHTML (DVPSObjectType objtype) const

returns a string containing a complete HTML page with the signature validation results for the last object of the given type.

const char * getCurrentSignatureValidationOverview () const

returns a string containing a complete HTML page with the signature validation overview.

void updateDigitalSignatureInformation (DcmItem &dataset, DVPSObjectType objtype, OFBool onRead)

updates the digital signature information for the given object type.

void disableDigitalSignatureInformation (DVPSObjectType objtype)

disables the digital signature information for the given object type.

DVPSSignatureStatus getCurrentSignatureStatus (DVPSObjectType objtype) const

returns the status flag for the current object of given type.

unsigned long getNumberOfCorrectSignatures (DVPSObjectType objtype) const

returns number of correct signatures for given object type.

unsigned long getNumberOfUntrustworthySignatures (DVPSObjectType objtype) const

returns number of untrustworthy signatures for given object type.

unsigned long getNumberOfCorruptSignatures (DVPSObjectType objtype) const

returns number of corrupt signatures for given object type.

DVPSSignatureStatus getCombinedImagePStateSignatureStatus () const

returns the combined status flag for the current image and presentation state.

void disableImageAndPState ()

disables internal settings for image and presentation state.

OFBool attributesSigned (DcmItem &item, DcmAttributeTag &tagList) const

checks whether any attribute mentioned in the tag list is affected by digital signatures.

OFCondition createSignature (DcmItem &mainDataset, const DcmStack &itemStack, DcmAttributeTag &attributesNotToSignInMainDataset, const char *userID, const char *passwd)

adds one or more new digital signatures to the given dataset.

Private Member Functions

DVSignatureHandler (const DVSignatureHandler &copy)

private undefined copy constructor

DVSignatureHandler & operator= (const DVSignatureHandler &)

private undefined assignment operator

void replaceString (DVPSObjectType objtype, const char *str)

replaces the current HTML page for the given object type by the new string.

void updateSignatureValidationOverview ()

updates the overview HTML page.

Static Private Member Functions

static void printSignatureItemPosition (DcmStack &stack, ostream &os)

Private Attributes

OFString htmlSR

current SR html page

OFString htmlImage

current image html page

OFString htmlPState

current presentation state html page

OFString htmlOverview

current overview

unsigned long correctSignaturesSR

number of correct signatures in current SR

unsigned long corruptSignaturesSR

number of corrupt signatures in current SR

unsigned long untrustSignaturesSR

number of untrustworthy signatures in current SR

unsigned long correctSignaturesImage

number of correct signatures in current Image

unsigned long corruptSignaturesImage

number of corrupt signatures in current Image

unsigned long untrustSignaturesImage

number of untrustworthy signatures in current Image

unsigned long correctSignaturesPState

number of correct signatures in current PState

unsigned long corruptSignaturesPState

number of corrupt signatures in current PState

unsigned long untrustSignaturesPState

number of untrustworthy signatures in current PState

SiCertificateVerifier certVerifier

the certificate verifier, available only if compiled with OpenSSL support

DVConfiguration & config

reference to object maintaining the system configuration

Detailed Description

handler for all digital signature related functions in dcmpstat

Definition at line 55 of file dvsighdl.h.

Constructor & Destructor Documentation

DVSignatureHandler::DVSignatureHandler ( DVConfiguration & cfg )

constructor

Parameters:

cfg system configuration

Member Function Documentation

OFBool DVSignatureHandler::attributesSigned ( DcmItem & item,

DcmAttributeTag & tagList

) const

checks whether any attribute mentioned in the tag list is affected by digital signatures.
Returns true if either any of the attributes is signed by a digital signature on the dataset level, or if any of the attributes is a sequence that contains one or more signatures in its items. Otherwise returns false. If compiled without WITH_OPENSSL, always returns false.
Parameters:

item item or dataset to be tested

tagList list of attributes (tags) to be looked up inside the dataset

Returns:
true if any of the given attributes is affected by a digital signature, false otherwise.

OFCondition DVSignatureHandler::createSignature ( DcmItem & mainDataset,

const DcmStack & itemStack,

DcmAttributeTag & attributesNotToSignInMainDataset,

const char * userID,

const char * passwd

)

adds one or more new digital signatures to the given dataset.
If compiled without WITH_OPENSSL, always returns EC_IllegalCall.
Parameters:

mainDataset reference to main dataset in which signature(s) are to be added

itemStack stack of items within the main dataset that are to be signed separately. If main dataset is to be signed, it must be included in this stack.

attributesNotToSignInMainDataset list of attribute tags that should be omitted from the signature on the main dataset level

usedID user ID in configuration file, must not be NULL

passwd passwd password for private key, may be NULL

Returns:
EC_Normal if successful, an error code otherwise.

void DVSignatureHandler::disableDigitalSignatureInformation ( DVPSObjectType objtype )

disables the digital signature information for the given object type.

Parameters:

objtype object type

void DVSignatureHandler::disableImageAndPState ( )

disables internal settings for image and presentation state.
Called when a new SR object is loaded and the current image/presentation state are hidden consequently.

DVPSSignatureStatus DVSignatureHandler::getCombinedImagePStateSignatureStatus ( ) const

returns the combined status flag for the current image and presentation state.

Returns:
digital signature status for image and presentation state

DVPSSignatureStatus DVSignatureHandler::getCurrentSignatureStatus ( DVPSObjectType objtype ) const

returns the status flag for the current object of given type.

Parameters:

objtype object type

Returns:
digital signature status for object

const char* DVSignatureHandler::getCurrentSignatureValidationHTML ( DVPSObjectType objtype ) const

returns a string containing a complete HTML page with the signature validation results for the last object of the given type.
Never returns NULL.
Parameters:

objtype object type

Returns:
pointer to string with HTML page

const char* DVSignatureHandler::getCurrentSignatureValidationOverview ( ) const

returns a string containing a complete HTML page with the signature validation overview.
Never returns NULL.
Returns:
pointer to string with HTML page

unsigned long DVSignatureHandler::getNumberOfCorrectSignatures ( DVPSObjectType objtype ) const

returns number of correct signatures for given object type.

Parameters:

objtype object type

Returns:
number of digital signatures

unsigned long DVSignatureHandler::getNumberOfCorruptSignatures ( DVPSObjectType objtype ) const

returns number of corrupt signatures for given object type.

Parameters:

objtype object type

Returns:
number of digital signatures

unsigned long DVSignatureHandler::getNumberOfUntrustworthySignatures ( DVPSObjectType objtype ) const

returns number of untrustworthy signatures for given object type.

Parameters:

objtype object type

Returns:
number of digital signatures

void DVSignatureHandler::replaceString ( DVPSObjectType objtype,

const char * str

) [private]

replaces the current HTML page for the given object type by the new string.

Parameters:

objtype object type

str string, must not be NULL

void DVSignatureHandler::updateDigitalSignatureInformation ( DcmItem & dataset,

DVPSObjectType objtype,

OFBool onRead

)

updates the digital signature information for the given object type.
If compiled without WITH_OPENSSL, always reports that no signatures were found in the object.
Parameters:

dataset dataset to be checked for digital signatures

objtype object type of dataset

onRead true if the dataset is just being read, false if it is being written

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

dcmpstat/include/dcmtk/dcmpstat/dvsighdl.h

Generated on 20 Dec 2005 for OFFIS DCMTK Version 3.5.4 by Doxygen 1.4.5


Public Member Functions
	DVSignatureHandler (DVConfiguration &cfg)
	constructor
virtual	~DVSignatureHandler ()
	destructor
const char *	getCurrentSignatureValidationHTML (DVPSObjectType objtype) const
	returns a string containing a complete HTML page with the signature validation results for the last object of the given type.
const char *	getCurrentSignatureValidationOverview () const
	returns a string containing a complete HTML page with the signature validation overview.
void	updateDigitalSignatureInformation (DcmItem &dataset, DVPSObjectType objtype, OFBool onRead)
	updates the digital signature information for the given object type.
void	disableDigitalSignatureInformation (DVPSObjectType objtype)
	disables the digital signature information for the given object type.
DVPSSignatureStatus	getCurrentSignatureStatus (DVPSObjectType objtype) const
	returns the status flag for the current object of given type.
unsigned long	getNumberOfCorrectSignatures (DVPSObjectType objtype) const
	returns number of correct signatures for given object type.
unsigned long	getNumberOfUntrustworthySignatures (DVPSObjectType objtype) const
	returns number of untrustworthy signatures for given object type.
unsigned long	getNumberOfCorruptSignatures (DVPSObjectType objtype) const
	returns number of corrupt signatures for given object type.
DVPSSignatureStatus	getCombinedImagePStateSignatureStatus () const
	returns the combined status flag for the current image and presentation state.
void	disableImageAndPState ()
	disables internal settings for image and presentation state.
OFBool	attributesSigned (DcmItem &item, DcmAttributeTag &tagList) const
	checks whether any attribute mentioned in the tag list is affected by digital signatures.
OFCondition	createSignature (DcmItem &mainDataset, const DcmStack &itemStack, DcmAttributeTag &attributesNotToSignInMainDataset, const char userID, const char passwd)
	adds one or more new digital signatures to the given dataset.
Private Member Functions
	DVSignatureHandler (const DVSignatureHandler &copy)
	private undefined copy constructor
DVSignatureHandler &	operator= (const DVSignatureHandler &)
	private undefined assignment operator
void	replaceString (DVPSObjectType objtype, const char *str)
	replaces the current HTML page for the given object type by the new string.
void	updateSignatureValidationOverview ()
	updates the overview HTML page.
Static Private Member Functions
static void	printSignatureItemPosition (DcmStack &stack, ostream &os)
Private Attributes
OFString	htmlSR
	current SR html page
OFString	htmlImage
	current image html page
OFString	htmlPState
	current presentation state html page
OFString	htmlOverview
	current overview
unsigned long	correctSignaturesSR
	number of correct signatures in current SR
unsigned long	corruptSignaturesSR
	number of corrupt signatures in current SR
unsigned long	untrustSignaturesSR
	number of untrustworthy signatures in current SR
unsigned long	correctSignaturesImage
	number of correct signatures in current Image
unsigned long	corruptSignaturesImage
	number of corrupt signatures in current Image
unsigned long	untrustSignaturesImage
	number of untrustworthy signatures in current Image
unsigned long	correctSignaturesPState
	number of correct signatures in current PState
unsigned long	corruptSignaturesPState
	number of corrupt signatures in current PState
unsigned long	untrustSignaturesPState
	number of untrustworthy signatures in current PState
SiCertificateVerifier	certVerifier
	the certificate verifier, available only if compiled with OpenSSL support
DVConfiguration &	config
	reference to object maintaining the system configuration