iaik.pdf.asn1objects

Class ContentTimeStamp

java.lang.Object

iaik.asn1.structures.AttributeValue

iaik.pdf.asn1objects.ContentTimeStamp

All Implemented Interfaces:

iaik.asn1.ASN1Type

public class ContentTimeStamp
extends iaik.asn1.structures.AttributeValue

The CAdES ContentTimeStamp attribute.

CAdES (EN 319 122-1 V0.0.6) specifies the ContentTimeStamp attribute to may be included as a signed attribute in a SignerInfo to prove that the signed content has already existed before the time/date contained in the ContentTimeStamp attribute. It is calculated before the content is signed. The value for the message imprint of the TimeStampToken is calculated over the raw data (value of the eContent field when the content is included in the SignedData object; raw external data when the content is not included).

 ContentTimestamp::= TimeStampToken

 id-aa-ets-contentTimestamp OBJECT IDENTIFIER ::= { iso(1) member-body(2)
      us(840) rsadsi(113549) pkcs(1) pkcs-9(9) smime(16) id-aa(2) 20 }
 

Field Summary

Fields

Modifier and Type	Field and Description
static iaik.asn1.ObjectID	oid The attributeType object identifier of the ContentTimeStamp attribute.

Constructor Summary

Constructors

Constructor and Description
ContentTimeStamp() Empty default constructor.
ContentTimeStamp(iaik.asn1.ASN1Object obj) Creates a ContentTimeStamp from its ASN.1 representation.
ContentTimeStamp(iaik.asn1.ASN1Object obj, byte[] messageDigest, iaik.asn1.structures.AlgorithmID messageDigestAlgorithm) Creates a ContentTimeStamp from its ASN.1 representation.

Method Summary

Modifier and Type	Method and Description
void	decode(iaik.asn1.ASN1Object obj) Decodes the given ASN.1 ContentTimeStamp object
boolean	equals(java.lang.Object obj) Compares this TimeStampToken to the specified object.
iaik.asn1.ObjectID	getAttributeType() Returns the OID identifying the ContentTimeStamp attribute type.
iaik.tsp.TimeStampToken	getTimeStampToken() Returns the underlying TimeStampToken of this ContentTimeStamp.
int	hashCode() Returns a hashcode for this object.
boolean	multipleAllowed() Returns false since only one AttributeValues of this type is allowed in the SET OF AttributeValue of an ContentTimeStamp attribute.
iaik.asn1.ASN1Object	toASN1Object() Returns this ContentTimeStamp as ASN1Object.
java.lang.String	toString() Returns a string representation of this ContentTimeStamp.
void	verifyTimeStampToken(iaik.x509.X509Certificate tsa_certificate) Verify this timestamp's signature and ensure that the timestamp's imprint corresponds to the expected imprint.

Methods inherited from class iaik.asn1.structures.AttributeValue

getName

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

oid

public static final iaik.asn1.ObjectID oid

The attributeType object identifier of the ContentTimeStamp attribute. The corresponding OID string is "1.2.840.113549.1.9.16.2.20".

Constructor Detail

ContentTimeStamp

public ContentTimeStamp()

Empty default constructor. Required for dynamic object creation. Shall NOT be used by an application.

ContentTimeStamp

public ContentTimeStamp(iaik.asn1.ASN1Object obj)

Creates a ContentTimeStamp from its ASN.1 representation. Used when creating this attribute.

Parameters:

obj - the ContentTimeStamp (TimeStampToken) as ASN1Object

ContentTimeStamp

public ContentTimeStamp(iaik.asn1.ASN1Object obj,
                        byte[] messageDigest,
                        iaik.asn1.structures.AlgorithmID messageDigestAlgorithm)
                 throws CmsCadesException

Creates a ContentTimeStamp from its ASN.1 representation. Used when verifying this attribute later.

Parameters:

obj - the ContentTimeStamp (TimeStampToken) as ASN1Object

messageDigest - message digest as specified in the MessageDigest-attribute of the SignerInfo object

messageDigestAlgorithm - digest algorithm used to calculate the given messageDigest

Throws:

CmsCadesException - if the given messageDigestAlgorithm differs from the digest algorithm used in the given timestamp token

Method Detail

equals

public boolean equals(java.lang.Object obj)

Compares this TimeStampToken to the specified object.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to compare this TimeStampToken against.

Returns:

true, if the given object is equal to this TimeStampToken, false otherwise

hashCode

public int hashCode()

Returns a hashcode for this object.

Overrides:

hashCode in class java.lang.Object

Returns:

a hashcode for this object

decode

public void decode(iaik.asn1.ASN1Object obj)

Decodes the given ASN.1 ContentTimeStamp object

Parameters:

obj - the ContentTimeStamp as ASN1Object

toASN1Object

public iaik.asn1.ASN1Object toASN1Object()

Returns this ContentTimeStamp as ASN1Object.

Returns:

this ContentTimeStamp as ASN1Object

getAttributeType

public iaik.asn1.ObjectID getAttributeType()

Returns the OID identifying the ContentTimeStamp attribute type.

Specified by:

getAttributeType in class iaik.asn1.structures.AttributeValue

Returns:

the OID identifying the ContentTimeStamp attribute type.

multipleAllowed

public boolean multipleAllowed()

Returns false since only one AttributeValues of this type is allowed in the SET OF AttributeValue of an ContentTimeStamp attribute.

Overrides:

multipleAllowed in class iaik.asn1.structures.AttributeValue

Returns:

false since only one attribute value is allowed

toString

public java.lang.String toString()

Returns a string representation of this ContentTimeStamp.

Specified by:

toString in class iaik.asn1.structures.AttributeValue

Returns:

this ContentTimeStamp as string

getTimeStampToken

public iaik.tsp.TimeStampToken getTimeStampToken()
                                          throws CmsCadesException

Returns the underlying TimeStampToken of this ContentTimeStamp.

Returns:

The TimeStampToken for further processing.

Throws:

CmsCadesException

verifyTimeStampToken

public void verifyTimeStampToken(iaik.x509.X509Certificate tsa_certificate)
                          throws iaik.tsp.TspVerificationException,
                                 CmsCadesException

Verify this timestamp's signature and ensure that the timestamp's imprint corresponds to the expected imprint. To verify the signature value the given TSA certificate is used. If the given TSA certificate is null and this timestamp contains the corresponding TSA certificate, the included TSA certificate is used.

Parameters:

tsa_certificate - The certificate of the timestamp authority

Throws:

CmsCadesException - if the imprint is invalid or the timestamp token could not be parsed or no TSA certificate is available

iaik.tsp.TspVerificationException - if this timestamp's signature could not be verified