info.pppc.base.security.key

Class RSACertificate

java.lang.Object

info.pppc.base.security.AbstractCertificate

info.pppc.base.security.key.RSACertificate

All Implemented Interfaces:

ICertificate

public class RSACertificate
extends AbstractCertificate

Implements a standard x509 RSA certificate. The key length is variable (at least 1024 bit). Only the public key is mandatory.
For using the certificate for encryption, decryption, signing and verifying, use the underlying methods of the keys.

Author:

WA

Field Summary

Fields inherited from interface info.pppc.base.security.ICertificate

AES_ENCRYPTION_MODE, CERTIFICATE_TYPE, DIGEST_TYPE, HMAC_ALGORITHM, RSA_ENCRYPTION_MODE

Constructor Summary

Constructors

Constructor and Description
RSACertificate(byte[] certificate) Creates a new RSACertificate from a byte array.
RSACertificate(byte[] certificateBytes, byte[] privateKey) Creates a RSA certificate from a byte array.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Every certificate type has to implement a comparison operator.
java.lang.String	getIssuer() Get the issuer of the certificate
IPrivateKey	getPrivateKey() Get the private key of the certificate
IPublicKey	getPublicKey() Get the public key of the certificate
byte[]	getSignature() Get the signature of the issuer of this certificate.
byte[]	getSignedPart() Returns the part of the certificate, that was signed by the issuer.
java.lang.String	getSubject() Get the subject of the certificate.

Methods inherited from class info.pppc.base.security.AbstractCertificate

createCertificate, createCertificate, decrypt, encrypt, getEndDate, getFingerprint, getStartDate, hashCode, hasPrivateKey, isValidRegardingStartAndEndDate, sign, toByteArray, toString, verifyCACertificateSignature, verifyCertificate, verifyCertificate, verifySignature

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RSACertificate

public RSACertificate(byte[] certificate)
               throws java.io.IOException

Creates a new RSACertificate from a byte array. The public key will be loaded into memory, so it can be used later on. This constructor needs the certificate as a byte array.
This constructor does not create a private key in the certificate abstraction, therefore decryption and signing are not available for this instance.

Parameters:

certificate - The byte array containing the certificate

Throws:

java.io.IOException - If the certificate could not be created, an exception will be thrown

RSACertificate

public RSACertificate(byte[] certificateBytes,
              byte[] privateKey)
               throws java.io.IOException

Creates a RSA certificate from a byte array. Also loads a private key from a byte array. This can be used to get simple access to a certificate file, the public and private key (if available) will be loaded into memory, so they can be used later on.

Parameters:

certificateBytes - The certificate in a byte array

privateKey - The private key in a byte array or null, if no private key exists

Throws:

java.io.IOException - If the certificate could not be created, an exception will be thrown

Method Detail

getIssuer

public java.lang.String getIssuer()

Description copied from class: AbstractCertificate

Get the issuer of the certificate

Specified by:

getIssuer in interface ICertificate

Specified by:

getIssuer in class AbstractCertificate

Returns:

The issuer of the certificate as X509Name

getSubject

public java.lang.String getSubject()

Description copied from class: AbstractCertificate

Get the subject of the certificate.

Specified by:

getSubject in interface ICertificate

Specified by:

getSubject in class AbstractCertificate

Returns:

The subject (name) of the certificate as X509Name

getPrivateKey

public IPrivateKey getPrivateKey()

Description copied from class: AbstractCertificate

Get the private key of the certificate

Returns:

The private key of the certificate or null, if no private key exists

getPublicKey

public IPublicKey getPublicKey()

Description copied from class: AbstractCertificate

Get the public key of the certificate

Specified by:

getPublicKey in interface ICertificate

Specified by:

getPublicKey in class AbstractCertificate

Returns:

The public key of the certificate or null, if no public key exists

equals

public boolean equals(java.lang.Object obj)

Description copied from class: AbstractCertificate

Every certificate type has to implement a comparison operator. Usually an certificate equals another one, if ALL fields are identical. This method must returns true, if the certificate equal each other.

Specified by:

equals in interface ICertificate

Specified by:

equals in class AbstractCertificate

Parameters:

obj - The object of the type CertificateAbstraction that should be compared to the current certificate

Returns:

True, if the current certificate and the given certificate are equal, false otherwise

See Also:

Object.equals(java.lang.Object)

getSignature

public byte[] getSignature()

Get the signature of the issuer of this certificate. This is usually a signature about the signed part of the certificate.

Specified by:

getSignature in interface ICertificate

Specified by:

getSignature in class AbstractCertificate

Returns:

The signature of this certificate.

See Also:

AbstractCertificate.getSignedPart()

getSignedPart

public byte[] getSignedPart()

Returns the part of the certificate, that was signed by the issuer. In combination with the signature (and the certificate of the issuer), the authenticity of this certificate can be checked by anyone.

Specified by:

getSignedPart in interface ICertificate

Specified by:

getSignedPart in class AbstractCertificate

Returns:

The part of the certificate, that was signed by the certificate issuer.