org.jmrtd.lds

Class ChipAuthenticationInfo

java.lang.Object

org.jmrtd.lds.SecurityInfo

org.jmrtd.lds.ChipAuthenticationInfo

All Implemented Interfaces:

java.io.Serializable, LDSElement

public class ChipAuthenticationInfo
extends SecurityInfo

A concrete SecurityInfo structure that stores chip authentication info, see EAC 1.11 specification. This data structure provides detailed information on an implementation of Chip Authentication.

• The object identifier protocol SHALL identify the algorithms to be used (i.e. key agreement, symmetric cipher and MAC).
• The integer version SHALL identify the version of the protocol. Currently, versions 1 and 2 are supported.
• The integer keyId MAY be used to indicate the local key identifier. It MUST be used if the MRTD chip provides multiple public keys for Chip Authentication.

Author:

Wojciech Mostowski ([email protected]) FIXME: dependency on BC?

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	VERSION_NUM

Fields inherited from class org.jmrtd.lds.SecurityInfo

ID_AA_OID, ID_CA_DH_3DES_CBC_CBC_OID, ID_CA_DH_AES_CBC_CMAC_128_OID, ID_CA_DH_AES_CBC_CMAC_192_OID, ID_CA_DH_AES_CBC_CMAC_256_OID, ID_CA_ECDH_3DES_CBC_CBC_OID, ID_CA_ECDH_AES_CBC_CMAC_128_OID, ID_CA_ECDH_AES_CBC_CMAC_192_OID, ID_CA_ECDH_AES_CBC_CMAC_256_OID, ID_EC_PUBLIC_KEY, ID_EC_PUBLIC_KEY_TYPE, ID_PACE, ID_PACE_DH_GM, ID_PACE_DH_GM_3DES_CBC_CBC, ID_PACE_DH_GM_AES_CBC_CMAC_128, ID_PACE_DH_GM_AES_CBC_CMAC_192, ID_PACE_DH_GM_AES_CBC_CMAC_256, ID_PACE_DH_IM, ID_PACE_DH_IM_3DES_CBC_CBC, ID_PACE_DH_IM_AES_CBC_CMAC_128, ID_PACE_DH_IM_AES_CBC_CMAC_192, ID_PACE_DH_IM_AES_CBC_CMAC_256, ID_PACE_ECDH_GM, ID_PACE_ECDH_GM_3DES_CBC_CBC, ID_PACE_ECDH_GM_AES_CBC_CMAC_128, ID_PACE_ECDH_GM_AES_CBC_CMAC_192, ID_PACE_ECDH_GM_AES_CBC_CMAC_256, ID_PACE_ECDH_IM, ID_PACE_ECDH_IM_3DES_CBC_CBC, ID_PACE_ECDH_IM_AES_CBC_CMAC_128, ID_PACE_ECDH_IM_AES_CBC_CMAC_192, ID_PACE_ECDH_IM_AES_CBC_CMAC_256, ID_PK_DH_OID, ID_PK_ECDH_OID, ID_TA_OID

Constructor Summary

Constructors

Constructor and Description
ChipAuthenticationInfo(java.lang.String oid, int version) Constructs a new object.
ChipAuthenticationInfo(java.lang.String oid, int version, java.math.BigInteger keyId) Constructs a new object.

Method Summary

Modifier and Type	Method and Description
protected void	checkFields() Checks the correctness of the data for this instance of SecurityInfo
boolean	equals(java.lang.Object other)
byte[]	getEncoded() Gets the encoded contents of this LDS info.
java.math.BigInteger	getKeyId() Returns a key identifier stored in this ChipAuthenticationInfo structure, null if not present
java.lang.String	getObjectIdentifier() Returns the object identifier of this SecurityInfo.
int	hashCode()
java.lang.String	toString()

Methods inherited from class org.jmrtd.lds.SecurityInfo

lookupMnemonicByOID, writeObject

Methods inherited from class java.lang.Object

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

Field Detail

VERSION_NUM

public static final int VERSION_NUM

See Also:

Constant Field Values

Constructor Detail

ChipAuthenticationInfo

public ChipAuthenticationInfo(java.lang.String oid,
                              int version,
                              java.math.BigInteger keyId)

Constructs a new object.

Parameters:

oid - a proper EAC identifier

version - has to be 1

keyId - the key identifier

ChipAuthenticationInfo

public ChipAuthenticationInfo(java.lang.String oid,
                              int version)

Constructs a new object.

Parameters:

oid - a proper EAC identifier

version - has to be 1

Method Detail

getObjectIdentifier

public java.lang.String getObjectIdentifier()

Description copied from class: SecurityInfo

Returns the object identifier of this SecurityInfo.

Specified by:

getObjectIdentifier in class SecurityInfo

Returns:

this SecurityInfo object identifier

getKeyId

public java.math.BigInteger getKeyId()

Returns a key identifier stored in this ChipAuthenticationInfo structure, null if not present

Returns:

key identifier stored in this ChipAuthenticationInfo structure

checkFields

protected void checkFields()

Checks the correctness of the data for this instance of SecurityInfo

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

getEncoded

public byte[] getEncoded()

Description copied from interface: LDSElement

Gets the encoded contents of this LDS info.

Specified by:

getEncoded in interface LDSElement

Returns:

a byte array containing the encoding of this LDS info