kz.gamma.hardware.cms
Class CMSSignedData

java.lang.Object
  kz.gamma.hardware.cms.CMSSignedData

public class CMSSignedData
extends java.lang.Object

general class for handling a pkcs7-signature message.

A simple example of usage - note, in the example below the validity of the certificate isn't verified, just the fact that one of the certs matches the given signer...

  CertStore               certs = s.getCertificatesAndCRLs("Collection", GammaTechProvider.PROVIDER_NAME);
  SignerInformationStore  signers = s.getSignerInfos();
  Collection              c = signers.getSigners();
  Iterator                it = c.iterator();
 

  while (it.hasNext())
  {
      SignerInformation   signer = (SignerInformation)it.next();
      Collection          certCollection = certs.getCertificates(signer.getSID());
 

      Iterator        certIt = certCollection.iterator();
      X509Certificate cert = (X509Certificate)certIt.next();
 

      if (signer.verify(cert.getPublicKey()))
      {
          verified++;
      }
  }
 

Field Summary

(package private) X509Store	attributeStore
(package private) X509Store	certificateStore
(package private) java.security.cert.CertStore	certStore
(package private) ContentInfo	contentInfo
(package private) X509Store	crlStore
private java.util.Map	hashes
private static CMSSignedHelper	HELPER
(package private) CMSProcessable	signedContent
(package private) SignedData	signedData
(package private) SignerInformationStore	signerInfoStore

Constructor Summary

	CMSSignedData(byte[] sigBlock)
	CMSSignedData(CMSProcessable signedContent, byte[] sigBlock)
	CMSSignedData(CMSProcessable signedContent, ContentInfo sigData)
	CMSSignedData(CMSProcessable signedContent, java.io.InputStream sigData) base constructor - content with detached signature.
private	CMSSignedData(CMSSignedData c)
	CMSSignedData(ContentInfo sigData)
	CMSSignedData(java.io.InputStream sigData) base constructor - with encapsulated content
	CMSSignedData(java.util.Map hashes, byte[] sigBlock) Content with detached signature, digests precomputed
	CMSSignedData(java.util.Map hashes, ContentInfo sigData)

Method Summary

X509Store	getAttributeCertificates(java.lang.String type, java.lang.String provider) return a X509Store containing the attribute certificates, if any, contained in this message.
java.security.cert.CertStore	getCertificatesAndCRLs(java.lang.String type, java.lang.String provider) return a CertStore containing the certificates and CRLs associated with this message.
X509Store	getCRLs(java.lang.String type, java.lang.String provider) return a X509Store containing CRLs, if any, contained in this message.
byte[]	getEncoded() return the ASN.1 encoded representation of this object.
CMSProcessable	getSignedContent()
java.lang.String	getSignedContentTypeOID() Return the a string representation of the OID associated with the encapsulated content info structure carried in the signed data.
SignerInformationStore	getSignerInfos() return the collection of signers that are associated with the signatures for the message.
int	getVersion() Return the version number for this object
private static AlgorithmIdentifier	makeAlgId(java.lang.String oid, byte[] params)
private static DERObject	makeObj(byte[] encoding)
static CMSSignedData	replaceCertificatesAndCRLs(CMSSignedData signedData, java.security.cert.CertStore certsAndCrls) Replace the certificate and CRL information associated with this CMSSignedData object with the new one passed in.
static CMSSignedData	replaceSigners(CMSSignedData signedData, SignerInformationStore signerInformationStore) Replace the signerinformation store associated with this CMSSignedData object with the new one passed in.

Methods inherited from class java.lang.Object

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

Field Detail

HELPER

private static CMSSignedHelper HELPER

signedData

SignedData signedData

contentInfo

ContentInfo contentInfo

signedContent

CMSProcessable signedContent

certStore

java.security.cert.CertStore certStore

signerInfoStore

SignerInformationStore signerInfoStore

attributeStore

X509Store attributeStore

certificateStore

X509Store certificateStore

crlStore

X509Store crlStore

hashes

private java.util.Map hashes

Constructor Detail

CMSSignedData

private CMSSignedData(CMSSignedData c)

Parameters:

c -

CMSSignedData

public CMSSignedData(byte[] sigBlock)
              throws CMSException

Parameters:

sigBlock -

Throws:

CMSException

CMSSignedData

public CMSSignedData(CMSProcessable signedContent,
                     byte[] sigBlock)
              throws CMSException

Parameters:

signedContent -

sigBlock -

Throws:

CMSException

CMSSignedData

public CMSSignedData(java.util.Map hashes,
                     byte[] sigBlock)
              throws CMSException

Content with detached signature, digests precomputed

Parameters:

hashes - a map of precomputed digests for content indexed by name of hash.

sigBlock - the signature object.

Throws:

CMSException

CMSSignedData

public CMSSignedData(CMSProcessable signedContent,
                     java.io.InputStream sigData)
              throws CMSException

base constructor - content with detached signature.

Parameters:

signedContent - the content that was signed.

sigData - the signature object.

Throws:

CMSException

CMSSignedData

public CMSSignedData(java.io.InputStream sigData)
              throws CMSException

base constructor - with encapsulated content

Parameters:

sigData -

Throws:

CMSException

CMSSignedData

public CMSSignedData(CMSProcessable signedContent,
                     ContentInfo sigData)

Parameters:

signedContent -

sigData -

CMSSignedData

public CMSSignedData(java.util.Map hashes,
                     ContentInfo sigData)

Parameters:

hashes -

sigData -

CMSSignedData

public CMSSignedData(ContentInfo sigData)

Parameters:

sigData -

Method Detail

getVersion

public int getVersion()

Return the version number for this object

Returns:

getSignerInfos

public SignerInformationStore getSignerInfos()

return the collection of signers that are associated with the signatures for the message.

Returns:

getAttributeCertificates

public X509Store getAttributeCertificates(java.lang.String type,
                                          java.lang.String provider)
                                   throws NoSuchStoreException,
                                          java.security.NoSuchProviderException,
                                          CMSException

return a X509Store containing the attribute certificates, if any, contained in this message.

Parameters:

type - type of store to create

provider - provider to use

Returns:

a store of attribute certificates

Throws:

java.security.NoSuchProviderException - if the provider requested isn't available.

NoSuchStoreException - if the store type isn't available.

CMSException - if a general exception prevents creation of the X509Store

getCRLs

public X509Store getCRLs(java.lang.String type,
                         java.lang.String provider)
                  throws NoSuchStoreException,
                         java.security.NoSuchProviderException,
                         CMSException

return a X509Store containing CRLs, if any, contained in this message.

Parameters:

type - type of store to create

provider - provider to use

Returns:

a store of CRLs

Throws:

java.security.NoSuchProviderException - if the provider requested isn't available.

NoSuchStoreException - if the store type isn't available.

CMSException - if a general exception prevents creation of the X509Store

getCertificatesAndCRLs

public java.security.cert.CertStore getCertificatesAndCRLs(java.lang.String type,
                                                           java.lang.String provider)
                                                    throws java.security.NoSuchAlgorithmException,
                                                           java.security.NoSuchProviderException,
                                                           CMSException

return a CertStore containing the certificates and CRLs associated with this message.

Parameters:

type -

provider -

Returns:

Throws:

java.security.NoSuchProviderException - if the provider requested isn't available.

java.security.NoSuchAlgorithmException - if the cert store isn't available.

CMSException - if a general exception prevents creation of the CertStore

getSignedContentTypeOID

public java.lang.String getSignedContentTypeOID()

Return the a string representation of the OID associated with the encapsulated content info structure carried in the signed data.

Returns:

the OID for the content type.

getSignedContent

public CMSProcessable getSignedContent()

Returns:

getEncoded

public byte[] getEncoded()
                  throws java.io.IOException

return the ASN.1 encoded representation of this object.

Returns:

Throws:

java.io.IOException

replaceSigners

public static CMSSignedData replaceSigners(CMSSignedData signedData,
                                           SignerInformationStore signerInformationStore)

Replace the signerinformation store associated with this CMSSignedData object with the new one passed in. You would probably only want to do this if you wanted to change the unsigned attributes associated with a signer, or perhaps delete one.

Parameters:

signedData - the signed data object to be used as a base.

signerInformationStore - the new signer information store to use.

Returns:

a new signed data object.

replaceCertificatesAndCRLs

public static CMSSignedData replaceCertificatesAndCRLs(CMSSignedData signedData,
                                                       java.security.cert.CertStore certsAndCrls)
                                                throws CMSException

Replace the certificate and CRL information associated with this CMSSignedData object with the new one passed in.

Parameters:

signedData - the signed data object to be used as a base.

certsAndCrls - the new certificates and CRLs to be used.

Returns:

a new signed data object.

Throws:

CMSException - if there is an error processing the CertStore

makeObj

private static DERObject makeObj(byte[] encoding)
                          throws java.io.IOException

Parameters:

encoding -

Returns:

Throws:

java.io.IOException

makeAlgId

private static AlgorithmIdentifier makeAlgId(java.lang.String oid,
                                             byte[] params)
                                      throws java.io.IOException

Parameters:

oid -

params -

Returns:

Throws:

java.io.IOException