Package com.itextpdf.text.pdf.security

Class TSAClientBouncyCastle

java.lang.Object

com.itextpdf.text.pdf.security.TSAClientBouncyCastle

All Implemented Interfaces:

TSAClient

public class TSAClientBouncyCastle
extends java.lang.Object
implements TSAClient

Time Stamp Authority Client interface implementation using Bouncy Castle org.bouncycastle.tsp package.

Created by Aiken Sam, 2006-11-15, refactored by Martin Brunecky, 07/15/2007 for ease of subclassing.

Since:

2.1.6

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	DEFAULTHASHALGORITHM	The default value for the hash algorithm
static int	DEFAULTTOKENSIZE	The default value for the hash algorithm
protected java.lang.String	digestAlgorithm	Hash algorithm
protected int	tokenSizeEstimate	Estimate of the received time stamp token
protected TSAInfoBouncyCastle	tsaInfo	An interface that allows you to inspect the timestamp info.
protected java.lang.String	tsaPassword	TSA password
protected java.lang.String	tsaURL	URL of the Time Stamp Authority
protected java.lang.String	tsaUsername	TSA Username

Constructor Summary

Constructors

Constructor	Description
TSAClientBouncyCastle(java.lang.String url)	Creates an instance of a TSAClient that will use BouncyCastle.
TSAClientBouncyCastle(java.lang.String url, java.lang.String username, java.lang.String password)	Creates an instance of a TSAClient that will use BouncyCastle.
TSAClientBouncyCastle(java.lang.String url, java.lang.String username, java.lang.String password, int tokSzEstimate, java.lang.String digestAlgorithm)	Constructor.

Method Summary

Modifier and Type	Method	Description
java.security.MessageDigest	getMessageDigest()	Gets the MessageDigest to digest the data imprint
byte[]	getTimeStampToken(byte[] imprint)	Get RFC 3161 timeStampToken.
int	getTokenSizeEstimate()	Get the token size estimate.
java.lang.String	getTSAReqPolicy()
protected byte[]	getTSAResponse(byte[] requestBytes)	Get timestamp token - communications layer
void	setTSAInfo(TSAInfoBouncyCastle tsaInfo)
void	setTSAReqPolicy(java.lang.String tsaReqPolicy)

Methods inherited from class java.lang.Object

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

Field Detail

tsaURL

protected java.lang.String tsaURL

URL of the Time Stamp Authority

tsaUsername

protected java.lang.String tsaUsername

TSA Username

tsaPassword

protected java.lang.String tsaPassword

TSA password

tsaInfo

protected TSAInfoBouncyCastle tsaInfo

An interface that allows you to inspect the timestamp info.

DEFAULTTOKENSIZE

public static final int DEFAULTTOKENSIZE

The default value for the hash algorithm

See Also:

Constant Field Values

tokenSizeEstimate

protected int tokenSizeEstimate

Estimate of the received time stamp token

DEFAULTHASHALGORITHM

public static final java.lang.String DEFAULTHASHALGORITHM

The default value for the hash algorithm

See Also:

Constant Field Values

digestAlgorithm

protected java.lang.String digestAlgorithm

Hash algorithm

Constructor Detail

TSAClientBouncyCastle

public TSAClientBouncyCastle(java.lang.String url)

Creates an instance of a TSAClient that will use BouncyCastle.

Parameters:

url - String - Time Stamp Authority URL (i.e. "http://tsatest1.digistamp.com/TSA")

TSAClientBouncyCastle

public TSAClientBouncyCastle(java.lang.String url,
                             java.lang.String username,
                             java.lang.String password)

Creates an instance of a TSAClient that will use BouncyCastle.

Parameters:

url - String - Time Stamp Authority URL (i.e. "http://tsatest1.digistamp.com/TSA")

username - String - user(account) name

password - String - password

TSAClientBouncyCastle

public TSAClientBouncyCastle(java.lang.String url,
                             java.lang.String username,
                             java.lang.String password,
                             int tokSzEstimate,
                             java.lang.String digestAlgorithm)

Constructor. Note the token size estimate is updated by each call, as the token size is not likely to change (as long as we call the same TSA using the same imprint length).

Parameters:

url - String - Time Stamp Authority URL (i.e. "http://tsatest1.digistamp.com/TSA")

username - String - user(account) name

password - String - password

tokSzEstimate - int - estimated size of received time stamp token (DER encoded)

Method Detail

setTSAInfo

public void setTSAInfo(TSAInfoBouncyCastle tsaInfo)

Parameters:

tsaInfo - the tsaInfo to set

getTokenSizeEstimate

public int getTokenSizeEstimate()

Get the token size estimate. Returned value reflects the result of the last succesfull call, padded

Specified by:

getTokenSizeEstimate in interface TSAClient

Returns:

an estimate of the token size

getTSAReqPolicy

public java.lang.String getTSAReqPolicy()

setTSAReqPolicy

public void setTSAReqPolicy(java.lang.String tsaReqPolicy)

getMessageDigest

public java.security.MessageDigest getMessageDigest()
                                             throws java.security.GeneralSecurityException

Gets the MessageDigest to digest the data imprint

Specified by:

getMessageDigest in interface TSAClient

Returns:

the digest algorithm name

Throws:

java.security.GeneralSecurityException

getTimeStampToken

public byte[] getTimeStampToken(byte[] imprint)
                         throws java.io.IOException,
                                org.bouncycastle.tsp.TSPException

Get RFC 3161 timeStampToken. Method may return null indicating that timestamp should be skipped.

Specified by:

getTimeStampToken in interface TSAClient

Parameters:

imprint - data imprint to be time-stamped

Returns:

encoded, TSA signed data of the timeStampToken

Throws:

java.io.IOException

org.bouncycastle.tsp.TSPException

getTSAResponse

protected byte[] getTSAResponse(byte[] requestBytes)
                         throws java.io.IOException

Get timestamp token - communications layer

Returns:

- byte[] - TSA response, raw bytes (RFC 3161 encoded)

Throws:

java.io.IOException