cdac.medinfo.sdk.dcm30_04.services.dsp

Class DSPSigner

java.lang.Object

cdac.medinfo.sdk.dcm30_04.services.dsp.DSPSigner

public class DSPSigner
extends java.lang.Object

Creates a Digital Signature in the Data Set for specified Digital Signature Profile and also used to retrieving Digital Signature UIDs from DataSet. This class signs DataSet with algorithm SHA1withRSA and accepts X.509 Certificate.

Constructor Summary

Constructors

Constructor and Description
DSPSigner() Initializes a new instance of the DSPSigner class.

Method Summary

Methods

Modifier and Type	Method and Description
void	addDigitalSignature(IDataSet objIDataSet, java.security.interfaces.RSAPrivateKey objRSAPrivateKey, java.security.cert.Certificate objCerificate, ISingleCollection<ITag> objDEtoSign, EnumDigitalSignatureProfile enumDigitalSignatureProfile, EnumMACAlgorithm enumDicomMACAlgorithm, short shMACIDNumber, java.lang.String strDigitalSignatureUID, java.lang.String strCertifiedTimestampType, ISingleCollection<byte[]> vectCertifiedTimestamp) Adds new Digital Signature in specified DataSet.
void	addDigitalSignature(IDataSet objIDataSet, java.security.interfaces.RSAPrivateKey objRSAPrivateKey, java.lang.String certificateFile, ISingleCollection<ITag> objDEtoSign, EnumDigitalSignatureProfile enumDigitalSignatureProfile, EnumMACAlgorithm enumDicomMACAlgorithm, short shMACIDNumber, java.lang.String strDigitalSignatureUID, java.lang.String strCertifiedTimestampType, ISingleCollection<byte[]> vectCertifiedTimestamp) Adds new Digital Signature in specified DataSet.
ISingleCollection<java.lang.String>	getDigitalSignatureUIDs(IDataSet objDataSet) Retrieves the Collection of Digital Signature UIDs from specified DataSet.
ISingleCollection<java.lang.Short>	getMACIDs(IDataSet objDataSet) Retrieves the Collection of numbers used to identify which MAC Parameters Sequence item was used in the calculation of this Digital Signature.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DSPSigner

public DSPSigner()

Initializes a new instance of the DSPSigner class.

Method Detail

addDigitalSignature

public void addDigitalSignature(IDataSet objIDataSet,
                       java.security.interfaces.RSAPrivateKey objRSAPrivateKey,
                       java.security.cert.Certificate objCerificate,
                       ISingleCollection<ITag> objDEtoSign,
                       EnumDigitalSignatureProfile enumDigitalSignatureProfile,
                       EnumMACAlgorithm enumDicomMACAlgorithm,
                       short shMACIDNumber,
                       java.lang.String strDigitalSignatureUID,
                       java.lang.String strCertifiedTimestampType,
                       ISingleCollection<byte[]> vectCertifiedTimestamp)
                         throws java.io.IOException,
                                java.security.NoSuchAlgorithmException,
                                java.security.NoSuchProviderException,
                                java.security.spec.InvalidKeySpecException,
                                java.security.InvalidKeyException,
                                java.security.SignatureException,
                                java.security.cert.CertificateEncodingException

Adds new Digital Signature in specified DataSet.

Parameters:

objIDataSet - specified instance of DataSet in which Digital Signature will be added.

objRSAPrivateKey - Private key which will be used to sign the Message Authentication Code (MAC).

objCerificate - Digital certificate of the signer, This will be the Certificate of Signer (0400,0115).

objDEtoSign - SingleCollection contains Tags of the Data Elements to be signed, if null then all/minimum set of Data Elements of the Data Set may be referenced by the Tags depending on Digital SignatureProfile. Also in case of no Data Element is present in dataset from specified Collection of Tags then all the Data Elements are referenced.

enumDigitalSignatureProfile - RSA Digital Signature Profile.

enumDicomMACAlgorithm - algorithm used in generating the MAC to be signed to form the Digital Signature.

shMACIDNumber - A number used to identify which MAC Parameters Sequence item was used in the calculation of this Digital Signature.

strDigitalSignatureUID - A UID that can be used to uniquely reference this signature.

strCertifiedTimestampType - Certified Timestamp Type required in case of implementation of Public Key Infrastructure Time Stamp Protocol.

vectCertifiedTimestamp - A certified timestamp of the Digital Signature required in case of implementation of Public Key Infrastructure Time Stamp Protocol.

Throws:

java.io.IOException - Signals that an I/O exception of some sort has occurred.

java.security.NoSuchAlgorithmException - This exception is thrown when a particular cryptographic algorithm is requested but is not available in the environment.

java.security.NoSuchProviderException - This exception is thrown when a particular security provider is requested but is not available in the environment.

java.security.spec.InvalidKeySpecException - This is the exception for invalid key specifications.

java.security.InvalidKeyException - exception for invalid Keys (invalid encoding, wrong length, uninitialized, etc).

java.security.SignatureException - generic Signature exception.

java.security.cert.CertificateEncodingException - Certificate Encoding Exception. This is thrown whenever an error occurs while attempting to encode a certificate.

addDigitalSignature

public void addDigitalSignature(IDataSet objIDataSet,
                       java.security.interfaces.RSAPrivateKey objRSAPrivateKey,
                       java.lang.String certificateFile,
                       ISingleCollection<ITag> objDEtoSign,
                       EnumDigitalSignatureProfile enumDigitalSignatureProfile,
                       EnumMACAlgorithm enumDicomMACAlgorithm,
                       short shMACIDNumber,
                       java.lang.String strDigitalSignatureUID,
                       java.lang.String strCertifiedTimestampType,
                       ISingleCollection<byte[]> vectCertifiedTimestamp)
                         throws java.io.IOException,
                                java.security.NoSuchAlgorithmException,
                                java.security.NoSuchProviderException,
                                java.security.spec.InvalidKeySpecException,
                                java.security.InvalidKeyException,
                                java.security.SignatureException,
                                java.security.cert.CertificateException

Adds new Digital Signature in specified DataSet.

Parameters:

objIDataSet - specified instance of DataSet in which Digital Signature will be added.

objRSAPrivateKey - Private key which will be used to sign the Message Authentication Code (MAC).

certificateFile - The name of the file that stores the digital certificate of the signer. This will be the Certificate of Signer (0400,0115).

objDEtoSign - SingleCollection contains Tags of the Data Elements to be signed, if null then all/minimum set of Data Elements of the Data Set may be referenced by the Tags depending on Digital SignatureProfile. Also in case of no Data Element is present in dataset from specified Collection of Tags then all the Data Elements are referenced.

enumDigitalSignatureProfile - RSA Digital Signature Profile.

enumDicomMACAlgorithm - algorithm used in generating the MAC to be signed to form the Digital Signature.

shMACIDNumber - A number used to identify which MAC Parameters Sequence item was used in the calculation of this Digital Signature.

strDigitalSignatureUID - A UID that can be used to uniquely reference this signature.

strCertifiedTimestampType - Certified Timestamp Type required in case of implementation of Public Key Infrastructure Time Stamp Protocol.

vectCertifiedTimestamp - A certified timestamp of the Digital Signature required in case of implementation of Public Key Infrastructure Time Stamp Protocol.

Throws:

java.io.IOException - Signals that an I/O exception of some sort has occurred.

java.security.NoSuchAlgorithmException - This exception is thrown when a particular cryptographic algorithm is requested but is not available in the environment.

java.security.NoSuchProviderException - This exception is thrown when a particular security provider is requested but is not available in the environment.

java.security.spec.InvalidKeySpecException - This is the exception for invalid key specifications.

java.security.InvalidKeyException - exception for invalid Keys (invalid encoding, wrong length, uninitialized, etc).

java.security.SignatureException - generic Signature exception.

java.security.cert.CertificateEncodingException - Certificate Encoding Exception. This is thrown whenever an error occurs while attempting to encode a certificate.

java.security.cert.CertificateException

getDigitalSignatureUIDs

public ISingleCollection<java.lang.String> getDigitalSignatureUIDs(IDataSet objDataSet)

Retrieves the Collection of Digital Signature UIDs from specified DataSet.

Parameters:

objDataSet - specified instance of DataSet

Returns:

SignleCollection UIDs that can be used to uniquely reference the Digital Signature.

getMACIDs

public ISingleCollection<java.lang.Short> getMACIDs(IDataSet objDataSet)

Retrieves the Collection of numbers used to identify which MAC Parameters Sequence item was used in the calculation of this Digital Signature.

Parameters:

objDataSet - specified instance of DataSet

Returns:

SignleCollection numbers used to identify which MAC Parameters Sequence items.