com.entrust.toolkit.x509.jsse

Class JSSEX509Wrapper

java.lang.Object

javax.security.cert.Certificate

javax.security.cert.X509Certificate

com.entrust.toolkit.x509.jsse.JSSEX509Wrapper

public class JSSEX509Wrapper
extends javax.security.cert.X509Certificate

This class re-implements the javax.security.cert.X509Certificate class.

See Also:

X509Certificate

Constructor Summary

Constructors

Constructor and Description
JSSEX509Wrapper(byte[] byteArray) Creates an instance of the JSSEX509Wrapper class.
JSSEX509Wrapper(java.io.InputStream is) Creates an instance of the JSSEX509Wrapper class.

Method Summary

Methods

Modifier and Type	Method and Description
void	checkValidity() Checks the validity of the certificate at the current time.
void	checkValidity(java.util.Date date) Checks the validity of the certificate at the given time.
byte[]	getEncoded() Retrieves this X509 certificate as a DER encoded ASN.1 data structure.
java.security.Principal	getIssuerDN() Retieves the distinguished name of the issuer of this certificate.
java.util.Date	getNotAfter() Retrieves the notAfter date of this certificate.
java.util.Date	getNotBefore() Retrieves the notBefore date of this certificate.
java.security.PublicKey	getPublicKey() Retieves the public key of this certificate.
java.math.BigInteger	getSerialNumber() Retrieves the serial number of the certificate.
java.lang.String	getSigAlgName() Retrieves the name of the signature algorithm used by the issuer for signing this certificate.
java.lang.String	getSigAlgOID() Retrieves the OID of the signature algorithm used by the issuer for signing this certificate.
byte[]	getSigAlgParams() Retrieves the algorithm parameters associated with the signature algorithm used by the issuer for signing this certificate.
java.security.Principal	getSubjectDN() Retrieves the distinguished name of the subject of this certificate, as a Principal object.
int	getVersion() Retrieves the version number of this certificate as an integer.
java.lang.String	toString() Returns a String representing the contents of the certificate.
void	verify(java.security.PublicKey key) This method does nothing.
void	verify(java.security.PublicKey key, java.lang.String sigImpl) This method does nothing.

Methods inherited from class javax.security.cert.X509Certificate

getInstance, getInstance

Methods inherited from class javax.security.cert.Certificate

equals, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JSSEX509Wrapper

public JSSEX509Wrapper(java.io.InputStream is)
                throws javax.security.cert.CertificateException

Creates an instance of the JSSEX509Wrapper class.

Parameters:

is - the input stream from which the X.509 certificate is read and created

Throws:

javax.security.cert.CertificateException

JSSEX509Wrapper

public JSSEX509Wrapper(byte[] byteArray)
                throws javax.security.cert.CertificateException

Creates an instance of the JSSEX509Wrapper class.

Parameters:

byteArray - the PEM or DER byte array containing the X.509 certificate to be created

Throws:

javax.security.cert.CertificateException

Method Detail

checkValidity

public void checkValidity()
                   throws javax.security.cert.CertificateExpiredException,
                          javax.security.cert.CertificateNotYetValidException

Checks the validity of the certificate at the current time.

Specified by:

checkValidity in class javax.security.cert.X509Certificate

Throws:

javax.security.cert.CertificateExpiredException - thrown if the certificate has expired

javax.security.cert.CertificateNotYetValidException - thrown if the certificate is not yet valid

checkValidity

public void checkValidity(java.util.Date date)
                   throws javax.security.cert.CertificateExpiredException,
                          javax.security.cert.CertificateNotYetValidException

Checks the validity of the certificate at the given time.

Specified by:

checkValidity in class javax.security.cert.X509Certificate

Throws:

javax.security.cert.CertificateExpiredException - thrown if the certificate has expired

javax.security.cert.CertificateNotYetValidException - thrown if the certificate is not yet valid

getIssuerDN

public java.security.Principal getIssuerDN()

Retieves the distinguished name of the issuer of this certificate.

Specified by:

getIssuerDN in class javax.security.cert.X509Certificate

Returns:

The DN of the issuer of the certificate.

getNotBefore

public java.util.Date getNotBefore()

Retrieves the notBefore date of this certificate.

Specified by:

getNotBefore in class javax.security.cert.X509Certificate

Returns:

The date on which this certificate becomes valid, or null if the notBefore date has not yet been set in the certificate.

getNotAfter

public java.util.Date getNotAfter()

Retrieves the notAfter date of this certificate.

Specified by:

getNotAfter in class javax.security.cert.X509Certificate

Returns:

The date on which the certificate´s validity expires, or null if the notAfter date has not yet been set in the certificate.

getSerialNumber

public java.math.BigInteger getSerialNumber()

Retrieves the serial number of the certificate.

Specified by:

getSerialNumber in class javax.security.cert.X509Certificate

Returns:

The serial number of the certificate as a BigInteger.

getSigAlgName

public java.lang.String getSigAlgName()

Retrieves the name of the signature algorithm used by the issuer for signing this certificate.

Specified by:

getSigAlgName in class javax.security.cert.X509Certificate

Returns:

The name of the signature algorithm (md5WithRSAEncryption, for example), or null if the signature algorithm has not yet been set.

getSigAlgOID

public java.lang.String getSigAlgOID()

Retrieves the OID of the signature algorithm used by the issuer for signing this certificate.

Specified by:

getSigAlgOID in class javax.security.cert.X509Certificate

Returns:

The OID of the signature algorithm as a String, or null if the signature algorithm has not yet been set.

getSigAlgParams

public byte[] getSigAlgParams()

Retrieves the algorithm parameters associated with the signature algorithm used by the issuer for signing this certificate.

The parameters are returned as a DER encoded ASN.1 data structure.

Specified by:

getSigAlgParams in class javax.security.cert.X509Certificate

Returns:

The signature algorithm parameters as a DER encoded ASN.1 data structure, or null if there are no parameters used or the signature algorithm has not yet been set.

getSubjectDN

public java.security.Principal getSubjectDN()

Retrieves the distinguished name of the subject of this certificate, as a Principal object.

The subject of the certificate is the entity to which the certificate belongs.

Specified by:

getSubjectDN in class javax.security.cert.X509Certificate

Returns:

The distinguished name of the subject of this certificate as a Principal object.

getVersion

public int getVersion()

Retrieves the version number of this certificate as an integer.

The version number can specify a v1, v2, or v3 certificate.

The ASN.1 definition of the certificate's version umber is:

     Version  ::=  INTEGER  {  v1(0), v2(1), v3(2)  }
 

Specified by:

getVersion in class javax.security.cert.X509Certificate

Returns:

The version number of the certificate as an int:

• 0 for a v1 cert
• 1 for a v2 cert
• 2 for a v3 cert

getEncoded

public byte[] getEncoded()
                  throws javax.security.cert.CertificateEncodingException

Retrieves this X509 certificate as a DER encoded ASN.1 data structure.

Specified by:

getEncoded in class javax.security.cert.Certificate

Returns:

A byte array holding the DER encoded X509 certificate ASN.1 data structure

Throws:

javax.security.cert.CertificateEncodingException - thrown if the certificate cannot be encoded correctly

getPublicKey

public java.security.PublicKey getPublicKey()

Retieves the public key of this certificate.

This is the public key that belongs to the subject of the certificate.

Specified by:

getPublicKey in class javax.security.cert.Certificate

Returns:

The public key of the certificate.

toString

public java.lang.String toString()

Returns a String representing the contents of the certificate.

Specified by:

toString in class javax.security.cert.Certificate

Returns:

The String representation of this certificate.

verify

public void verify(java.security.PublicKey key)
            throws javax.security.cert.CertificateException,
                   java.security.NoSuchAlgorithmException,
                   java.security.InvalidKeyException,
                   java.security.NoSuchProviderException,
                   java.security.SignatureException

This method does nothing.

Specified by:

verify in class javax.security.cert.Certificate

Throws:

javax.security.cert.CertificateException

java.security.NoSuchAlgorithmException

java.security.InvalidKeyException

java.security.NoSuchProviderException

java.security.SignatureException

verify

public void verify(java.security.PublicKey key,
          java.lang.String sigImpl)
            throws javax.security.cert.CertificateException,
                   java.security.NoSuchAlgorithmException,
                   java.security.InvalidKeyException,
                   java.security.NoSuchProviderException,
                   java.security.SignatureException

This method does nothing.

Specified by:

verify in class javax.security.cert.Certificate

Throws:

javax.security.cert.CertificateException

java.security.NoSuchAlgorithmException

java.security.InvalidKeyException

java.security.NoSuchProviderException

java.security.SignatureException