DCMTK  Version 3.6.1 20170228
OFFIS DICOM Toolkit
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
Public Member Functions | Private Member Functions | Private Attributes | List of all members
DVSignatureHandler Class Reference

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

Public Member Functions

 DVSignatureHandler (DVConfiguration &cfg)
 constructor More...
 
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. More...
 
const char * getCurrentSignatureValidationOverview () const
 returns a string containing a complete HTML page with the signature validation overview. More...
 
void updateDigitalSignatureInformation (DcmItem &dataset, DVPSObjectType objtype, OFBool onRead)
 updates the digital signature information for the given object type. More...
 
void disableDigitalSignatureInformation (DVPSObjectType objtype)
 disables the digital signature information for the given object type. More...
 
DVPSSignatureStatus getCurrentSignatureStatus (DVPSObjectType objtype) const
 returns the status flag for the current object of given type. More...
 
unsigned long getNumberOfCorrectSignatures (DVPSObjectType objtype) const
 returns number of correct signatures for given object type. More...
 
unsigned long getNumberOfUntrustworthySignatures (DVPSObjectType objtype) const
 returns number of untrustworthy signatures for given object type. More...
 
unsigned long getNumberOfCorruptSignatures (DVPSObjectType objtype) const
 returns number of corrupt signatures for given object type. More...
 
DVPSSignatureStatus getCombinedImagePStateSignatureStatus () const
 returns the combined status flag for the current image and presentation state. More...
 
void disableImageAndPState ()
 disables internal settings for image and presentation state. More...
 
OFBool attributesSigned (DcmItem &item, DcmAttributeTag &tagList) const
 checks whether any attribute mentioned in the tag list is affected by digital signatures. More...
 
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. More...
 

Private Member Functions

 DVSignatureHandler (const DVSignatureHandler &copy)
 private undefined copy constructor
 
DVSignatureHandleroperator= (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. More...
 
void updateSignatureValidationOverview ()
 updates the overview HTML page.
 

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
 
DVConfigurationconfig
 reference to object maintaining the system configuration
 

Detailed Description

handler for all digital signature related functions in dcmpstat

Constructor & Destructor Documentation

DVSignatureHandler::DVSignatureHandler ( DVConfiguration cfg)

constructor

Parameters
cfgsystem 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
itemitem or dataset to be tested
tagListlist 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
mainDatasetreference to main dataset in which signature(s) are to be added
itemStackstack 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.
attributesNotToSignInMainDatasetlist of attribute tags that should be omitted from the signature on the main dataset level
usedIDuser ID in configuration file, must not be NULL
passwdpasswd 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
objtypeobject 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
objtypeobject 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
objtypeobject 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
objtypeobject type
Returns
number of digital signatures
unsigned long DVSignatureHandler::getNumberOfCorruptSignatures ( DVPSObjectType  objtype) const

returns number of corrupt signatures for given object type.

Parameters
objtypeobject type
Returns
number of digital signatures
unsigned long DVSignatureHandler::getNumberOfUntrustworthySignatures ( DVPSObjectType  objtype) const

returns number of untrustworthy signatures for given object type.

Parameters
objtypeobject 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
objtypeobject type
strstring, 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
datasetdataset to be checked for digital signatures
objtypeobject type of dataset
onReadtrue if the dataset is just being read, false if it is being written

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


Generated on Tue Feb 28 2017 for DCMTK Version 3.6.1 20170228 by Doxygen 1.8.8