com.entrust.toolkit.util

Class KeyAndCertificate

java.lang.Object

com.entrust.toolkit.util.KeyAndCertificate

public final class KeyAndCertificate
extends java.lang.Object

Simple data structure for associating a private key with a certificate. Also contains methods for verifying that a Certificate and Key constitute a matching pair.

Constructor Summary

Constructors

Constructor and Description
KeyAndCertificate(java.security.PrivateKey key, java.security.cert.Certificate cert) The constructor.

Method Summary

Modifier and Type	Method and Description
java.security.cert.Certificate	getCert() Return the Certificate associated with this object
java.security.PrivateKey	getKey() Return the PrivateKey associated with this object
static KeyAndCertificate[]	matchCertificatesToKeys(java.util.List<java.security.PrivateKey> keys, java.util.List<java.security.cert.Certificate> certificates) Match a list of private keys to public keys in a list of certificates.
static KeyAndCertificate[]	matchKeysToCertificates(java.util.List<java.security.PrivateKey> keys, java.util.List<java.security.cert.Certificate> certificates) Match a list of private keys to public keys in a list of certificates.
static java.security.KeyPair[]	matchKeysToPublicKeys(java.util.List<java.security.PrivateKey> keys, java.util.List<java.security.PublicKey> publicKeys) Match a list of private keys to public keys.
static boolean	matchKeyToCert(java.security.PrivateKey key, java.security.cert.Certificate cert) Convienance method for checking if a single key and certificate match.
static boolean	matchKeyToPublicKey(java.security.PrivateKey privateKey, java.security.PublicKey publicKey) Convienance method for checking if a single key and public key match.

Methods inherited from class java.lang.Object

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

Constructor Detail

KeyAndCertificate

public KeyAndCertificate(java.security.PrivateKey key,
                         java.security.cert.Certificate cert)

The constructor. Takes a Private Key and a Certificate

Parameters:

key - The PrivateKey

cert - The associated Public Certificate

Method Detail

getCert

public java.security.cert.Certificate getCert()

Return the Certificate associated with this object

Returns:

the Certificate associated with this object

getKey

public java.security.PrivateKey getKey()

Return the PrivateKey associated with this object

Returns:

the PrivateKey associated with this object

matchKeyToCert

public static boolean matchKeyToCert(java.security.PrivateKey key,
                                     java.security.cert.Certificate cert)

Convienance method for checking if a single key and certificate match. A sign operation will be done with the Private key, and a verify operation will be done with the Certificate.

Parameters:

key - The private key to be matched with the certificate

cert - The Certificate to be matched

Returns:

true if the key and certificate are a matching pair, false if they are not a matching pair

matchKeysToCertificates

public static KeyAndCertificate[] matchKeysToCertificates(java.util.List<java.security.PrivateKey> keys,
                                                          java.util.List<java.security.cert.Certificate> certificates)

Match a list of private keys to public keys in a list of certificates. Matching is done by signing and verifying a short message.

Parameters:

keys - the list of private keys to find matching certificates for.

certificates - the list of certificates to match to private keys. There can be more certificates than private keys. Any certificates that do not match a private key are removed from the list.

Returns:

an array of KeyAndCertificate objects containing the matching pairs.

matchCertificatesToKeys

public static KeyAndCertificate[] matchCertificatesToKeys(java.util.List<java.security.PrivateKey> keys,
                                                          java.util.List<java.security.cert.Certificate> certificates)

Match a list of private keys to public keys in a list of certificates. Matching is done by signing and verifying a short message.

Parameters:

keys - the list of private keys to find matching certificates for.

certificates - the list of certificates to match to private keys. There can be more private keys than certificates. Any privateKeys that do not match a certificate are removed from the list.

Returns:

an array of KeyAndCertificate objects containing the matching pairs.

matchKeyToPublicKey

public static boolean matchKeyToPublicKey(java.security.PrivateKey privateKey,
                                          java.security.PublicKey publicKey)

Convienance method for checking if a single key and public key match. A sign operation will be done with the Private key, and a verify operation will be done with the Certificate.

Parameters:

privateKey - The private key to be matched with the certificate

publicKey - the public key to be matched with the private key

Returns:

true if the key and public key are a matching pair, false if they are not a matching pair

matchKeysToPublicKeys

public static java.security.KeyPair[] matchKeysToPublicKeys(java.util.List<java.security.PrivateKey> keys,
                                                            java.util.List<java.security.PublicKey> publicKeys)

Match a list of private keys to public keys. Matching is done by signing and verifying a short message.

Parameters:

keys - the list of private keys to find matching public keys

publicKeys - the list of public keys to match to the private keys. There can be more public keys than private keys. Any public keys that do not match a private key are removed from the list.

Returns:

an array of KeyPair objects containing the matching pairs.