org.jmrtd.lds

Class CardSecurityFile

java.lang.Object

org.jmrtd.lds.CardSecurityFile

All Implemented Interfaces:

Serializable

public class CardSecurityFile
extends Object
implements Serializable

Card security file stores a set of SecurityInfos for PACE with Chip Authentication Mapping (CAM). FIXME: Strictly speaking this file is not part of the LDS (or even the MRTD application)! Move it out of this package? -- MO

Since:

0.5.6

Version:

$Revision: 1602 $

Author:

The JMRTD team ([email protected])

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CardSecurityFile(InputStream inputStream) Constructs a new file from the data in an input stream.
CardSecurityFile(String digestAlgorithm, String digestEncryptionAlgorithm, Collection<SecurityInfo> securityInfos, byte[] encryptedDigest, X509Certificate certificate) Constructs a new file from the provided data.
CardSecurityFile(String digestAlgorithm, String digestEncryptionAlgorithm, Collection<SecurityInfo> securityInfos, PrivateKey privateKey, X509Certificate certificate) Constructs a new file from the provided data.
CardSecurityFile(String digestAlgorithm, String digestEncryptionAlgorithm, Collection<SecurityInfo> securityInfos, PrivateKey privateKey, X509Certificate certificate, String provider) Constructs a new file from the provided data.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object otherObj) Tests equality with respect to another object.
Collection<ChipAuthenticationInfo>	getChipAuthenticationInfos() Gets the CA public key infos embedded in this card access file.
Collection<ChipAuthenticationPublicKeyInfo>	getChipAuthenticationPublicKeyInfos() Gets the CA public key infos embedded in this card access file.
String	getDigestAlgorithm()
String	getDigestEncryptionAlgorithm()
byte[]	getEncoded() Gets the DER encoded file.
byte[]	getEncryptedDigest()
Collection<PACEInfo>	getPACEInfos() Gets the PACE infos embedded in this card access file.
Collection<SecurityInfo>	getSecurityInfos() Gets the security infos as an unordered collection.
int	hashCode() Gets a hash code of this object.
protected void	readContent(InputStream inputStream)
String	toString() Gets the signature algorithm object identifier.
protected void	writeContent(OutputStream outputStream)

Methods inherited from class java.lang.Object

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

Constructor Detail

CardSecurityFile

public CardSecurityFile(String digestAlgorithm,
                        String digestEncryptionAlgorithm,
                        Collection<SecurityInfo> securityInfos,
                        PrivateKey privateKey,
                        X509Certificate certificate)

Constructs a new file from the provided data.

Parameters:

digestAlgorithm - the digest algorithm as Java mnemonic

digestEncryptionAlgorithm - the signature algorithm as Java mnemonic

securityInfos - a non-empty list of security infos

privateKey - the private signing key

certificate - the certificate to embed, which should correspond to the given private key

CardSecurityFile

public CardSecurityFile(String digestAlgorithm,
                        String digestEncryptionAlgorithm,
                        Collection<SecurityInfo> securityInfos,
                        PrivateKey privateKey,
                        X509Certificate certificate,
                        String provider)

Constructs a new file from the provided data.

Parameters:

digestAlgorithm - the digest algorithm as Java mnemonic

digestEncryptionAlgorithm - the signature algorithm as Java mnemonic

securityInfos - a non-empty list of security infos

privateKey - the private signing key

certificate - the certificate to embed, which should correspond to the given private key

provider - the security provider to use

CardSecurityFile

public CardSecurityFile(String digestAlgorithm,
                        String digestEncryptionAlgorithm,
                        Collection<SecurityInfo> securityInfos,
                        byte[] encryptedDigest,
                        X509Certificate certificate)

Constructs a new file from the provided data.

Parameters:

digestAlgorithm - the digest algorithm as Java mnemonic

digestEncryptionAlgorithm - the signature algorithm as Java mnemonic

securityInfos - a non-empty list of security infos

encryptedDigest - the signature

certificate - the certificate to embed

CardSecurityFile

public CardSecurityFile(InputStream inputStream)
                 throws IOException

Constructs a new file from the data in an input stream.

Parameters:

inputStream - the input stream to parse the data from

Throws:

IOException - on error reading input stream

Method Detail

getDigestAlgorithm

public String getDigestAlgorithm()

getDigestEncryptionAlgorithm

public String getDigestEncryptionAlgorithm()

getEncryptedDigest

public byte[] getEncryptedDigest()

readContent

protected void readContent(InputStream inputStream)
                    throws IOException

Throws:

IOException

writeContent

protected void writeContent(OutputStream outputStream)
                     throws IOException

Throws:

IOException

getEncoded

public byte[] getEncoded()

Gets the DER encoded file.

Returns:

the encoded file

getSecurityInfos

public Collection<SecurityInfo> getSecurityInfos()

Gets the security infos as an unordered collection.

Returns:

security infos

getPACEInfos

public Collection<PACEInfo> getPACEInfos()

Gets the PACE infos embedded in this card access file. If no infos are present, an empty list is returned.

Returns:

a list of PACE infos

getChipAuthenticationInfos

public Collection<ChipAuthenticationInfo> getChipAuthenticationInfos()

Gets the CA public key infos embedded in this card access file. If no infos are present, an empty list is returned.

Returns:

a list of CA public key infos

getChipAuthenticationPublicKeyInfos

public Collection<ChipAuthenticationPublicKeyInfo> getChipAuthenticationPublicKeyInfos()

Gets the CA public key infos embedded in this card access file. If no infos are present, an empty list is returned.

Returns:

a list of CA public key infos

toString

public String toString()

Gets the signature algorithm object identifier.

Overrides:

toString in class Object

Returns:

signature algorithm OID

equals

public boolean equals(Object otherObj)

Tests equality with respect to another object.

Overrides:

equals in class Object

Parameters:

otherObj - another object

Returns:

whether this object equals the other object

hashCode

public int hashCode()

Gets a hash code of this object.

Overrides:

hashCode in class Object

Returns:

the hash code