com.digistamp.pdf
Class TSAClientDigiStamp

java.lang.Object
  com.digistamp.pdf.TSAClientDigiStamp

All Implemented Interfaces:

com.lowagie.text.pdf.TSAClient

public class TSAClientDigiStamp
extends java.lang.Object
implements com.lowagie.text.pdf.TSAClient

Time Stamp Authority Client interface implementation using DigiStamp time stamp servers. Provides failover capability among multiple time stamp servers. See TSAClient for more details.

Provided by DigiStamp Inc. http://www.digistamp.com

Constructor Summary

TSAClientDigiStamp()

Method Summary

byte[]	getTimeStampToken(com.lowagie.text.pdf.PdfPKCS7 caller, byte[] imprint) Get RFC 3161 timeStampToken.
int	getTokenSizeEstimate() Get the time stamp token size estimate.
void	setConfigProperties(java.util.Properties digistampProperties) DigiStamp local proxy configuration for failover and account access.
void	setReporter(Reporter aReporter) Supplying a Reporter object allows the processing to report communications events.
void	setTrustedRootCertificate(java.security.cert.X509Certificate rootCert) After the signature of the time stamp is verified, should the system check to see if that public key certificate that was used to verify the signature is trusted?

Methods inherited from class java.lang.Object

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

Constructor Detail

TSAClientDigiStamp

public TSAClientDigiStamp()

Method Detail

getTimeStampToken

public byte[] getTimeStampToken(com.lowagie.text.pdf.PdfPKCS7 caller,
                                byte[] imprint)
                         throws java.lang.Exception

Get RFC 3161 timeStampToken.

Specified by:

getTimeStampToken in interface com.lowagie.text.pdf.TSAClient

Parameters:

caller - PdfPKCS7 - calling PdfPKCS7 instance (can be null)

imprint - byte[] - the SHA-1 data imprint to be time-stamped

Returns:

byte[] - encoded, TSA signed data of the timeStampToken

Throws:

java.lang.Exception - - TSA request failed - Time stamp did not verify correctly with public key

getTokenSizeEstimate

public int getTokenSizeEstimate()

Get the time stamp token size estimate. Implementation must return value large enough to accommodate the entire token returned by getTimeStampToken() _prior_ to actual getTimeStampToken() call.

Specified by:

getTokenSizeEstimate in interface com.lowagie.text.pdf.TSAClient

setConfigProperties

public void setConfigProperties(java.util.Properties digistampProperties)

DigiStamp local proxy configuration for failover and account access. Default is file "DigiStamp.properties".

DigiStamp configuration properties. An example configuration file was provided in "DigiStamp.properties"; you will need to add your account number and password to the file "DigiStamp.properties". More configuration details are here: TSAConfig.

setReporter

public void setReporter(Reporter aReporter)

Supplying a Reporter object allows the processing to report communications events. A textual description of the steps taken in communication. For example:

• start of communication
• complete or error message
• failover to send time stamp server

Parameters:

aReporter - com.digistamp.tsp.Reporter

setTrustedRootCertificate

public void setTrustedRootCertificate(java.security.cert.X509Certificate rootCert)

After the signature of the time stamp is verified, should the system check to see if that public key certificate that was used to verify the signature is trusted? Does the public key certificate chain to a trust root CA.

See TSAClient.setTrustedRootCertificate(X509Certificate) for more details.