com.rsa.certj.cert.attributes

Class VeriSignCRSTransactionID

java.lang.Object
  |
  +--com.rsa.certj.cert.attributes.X501Attribute
        |
        +--com.rsa.certj.cert.attributes.VeriSignCRSTransactionID

All Implemented Interfaces:

Cloneable, Serializable

public class VeriSignCRSTransactionID

extends X501Attribute

implements Cloneable, Serializable

This class holds, encodes, and decodes the CRS transaction ID attribute. The VeriSign CRS service for digital ID certificates expects a transaction identifier in each CRS message. The transaction ID uniquely identifies each enrollment. To ensure uniqueness, the recommended and supported method for generating transaction identifiers is to calculate the transaction ID as the MD5 hash of the following blocks of concatenated data:

• The URL-encoded regInfo string as it would appear in the PKCSReq for the particular enrollment. The name or value pairs in the regInfo should be sorted by the name’s ASCII value (for example, use strcmp()).

• The DER-encoded binary PKCS #10 data.

Additional enrollment information such as jurisdictional information, DN values, billing information, operational information, and extensions can be obtained from data presented in the regInfo octet string of the CRS message. The regInfo data is a simple string of name-value pairs, encoded using the URL-encoding scheme.

The CRS transaction ID attribute polls for the certificate associated with a PKCSReq, if the initial response returned a status of PENDING. The same transactionID used during the PKCSReq request must also be used as the transactionID for the message to retrieve a pending certificate.

The ASN.1 definition is as follows:

 -- Description: Identifies a CRS Transaction ID attribute
 -- OID in decimal notation: (2.16.840.1.113733.1.9.7)
 -- Definition:
    id-crs-transactionID ::= {id-attributes crs-transactionID(7)}
    CRSTransactionID ::= INTEGER

Copyright © RSA Security Inc., 1999-2001. All rights reserved.

See Also

Serialized Form

Fields inherited from class com.rsa.certj.cert.attributes.X501Attribute

CHALLENGE_PASSWORD, CONTENT_TYPE, COUNTRY_OF_CITIZENSHIP, COUNTRY_OF_RESIDENCE, CRS_DUAL_STATUS, CRS_FAILURE_INFO, CRS_MESSAGE_TYPE, CRS_PKI_STATUS, CRS_RECIPIENT_NONCE, CRS_SENDER_NONCE, CRS_TRANSACTION_ID, CRS_VERSION, DATE_OF_BIRTH, FRIENDLY_NAME, GENDER, LOCAL_KEY_ID, MESSAGE_DIGEST, NON_STANDARD, PLACE_OF_BIRTH, POSTAL_ADDRESS, PSEUDONYM, SIGNING_TIME, SMART_CSP, X509_V3_EXTENSION

Constructor Summary

VeriSignCRSTransactionID()

Constructs an empty VeriSignCRSTransactionID object.

VeriSignCRSTransactionID(byte[] id, int offset, int len)

Constructs a VeriSignCRSTransactionID object and initializes it with the values given.

Method Summary

Object	clone() Overrides the default clone method to get a deeper clone.
boolean	equals(Object obj) Returns true if this object and obj contain the same VeriSignCRSTransactionID, returns false otherwise.
byte[]	getTransactionID() Gets the value of this attribute.
void	setTransactionID(byte[] id, int offset, int len) Sets the value of this attribute, the CRS transaction ID, to id.

Methods inherited from class com.rsa.certj.cert.attributes.X501Attribute

clearSensitiveData, compareOID, derEncodeAttributeLen, getAttributeType, getAttributeTypeString, getDEREncoding, getDERLen, getInstance, getNextBEROffset, getOID, isAttributeType

Methods inherited from class java.lang.Object

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

Constructor Detail

VeriSignCRSTransactionID

public VeriSignCRSTransactionID()

Constructs an empty VeriSignCRSTransactionID object.

VeriSignCRSTransactionID

public VeriSignCRSTransactionID(byte[] id,
                                int offset,
                                int len)

Constructs a VeriSignCRSTransactionID object and initializes it with the values given.

Parameters

	id		A byte array that contains a CRS transaction ID that uniquely identifies each enrollment.
	offset		The offset into the id array.
	len		The length of the id array.

Method Detail

setTransactionID

public void setTransactionID(byte[] id,
                             int offset,
                             int len)

Sets the value of this attribute, the CRS transaction ID, to id.

Parameters

	id		A byte array that contains a CRS transaction ID that uniquely identifies each enrollment.
	offset		The offset into the id array.
	len		The length of the id array.

getTransactionID

public byte[] getTransactionID()

Gets the value of this attribute. If the value is not set, this method returns -1.

Returns

An int that specifies the CRS transaction ID. If the value is not set, this method returns -1.

clone

public Object clone()
             throws CloneNotSupportedException

Overrides the default clone method to get a deeper clone.

Overrides

clone in class X501Attribute

Returns

A new VeriSignCRSTransactionID object, a copy of this object.

Throws

CloneNotSupportedException - If the cloning operation is not successful.

equals

public boolean equals(Object obj)

Returns true if this object and obj contain the same VeriSignCRSTransactionID, returns false otherwise.

Overrides

equals in class Object

Parameters

obj

The instance of the VeriSignCRSTransactionID object.

Returns

A boolean indicating whether these objects are equal.