org.jmrtd.lds

Class ChipAuthenticationInfo

java.lang.Object

org.jmrtd.lds.AbstractLDSInfo

org.jmrtd.lds.SecurityInfo

org.jmrtd.lds.ChipAuthenticationInfo

All Implemented Interfaces:

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.

Version:

$Revision: 1613 $ FIXME: dependency on BC?

Author:

Wojciech Mostowski ([email protected])

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	VERSION_1 Chip Authenticaiton version.
static int	VERSION_2 Chip Authenticaiton version.

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_CAM, ID_PACE_ECDH_CAM_AES_CBC_CMAC_128, ID_PACE_ECDH_CAM_AES_CBC_CMAC_192, ID_PACE_ECDH_CAM_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(String oid, int version) Constructs a new object.
ChipAuthenticationInfo(String oid, int version, 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(Object other)
org.bouncycastle.asn1.ASN1Primitive	getDERObject() Deprecated.
BigInteger	getKeyId() Returns a key identifier stored in this ChipAuthenticationInfo structure, null if not present
String	getObjectIdentifier() Returns the object identifier of this SecurityInfo.
int	hashCode()
String	toString()

Methods inherited from class org.jmrtd.lds.SecurityInfo

getInstance, lookupMnemonicByOID, writeObject

Methods inherited from class org.jmrtd.lds.AbstractLDSInfo

getEncoded

Methods inherited from class java.lang.Object

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

Field Detail

VERSION_1

public static final int VERSION_1

Chip Authenticaiton version.

See Also:

Constant Field Values

VERSION_2

public static final int VERSION_2

Chip Authenticaiton version.

See Also:

Constant Field Values

Constructor Detail

ChipAuthenticationInfo

public ChipAuthenticationInfo(String oid,
                              int version,
                              BigInteger keyId)

Constructs a new object.

Parameters:

oid - a proper EAC identifier

version - has to be 1 or 2

keyId - the key identifier

ChipAuthenticationInfo

public ChipAuthenticationInfo(String oid,
                              int version)

Constructs a new object.

Parameters:

oid - a proper EAC identifier

version - has to be 1 or 2

Method Detail

getDERObject

@Deprecated
public org.bouncycastle.asn1.ASN1Primitive getDERObject()

Deprecated.

Description copied from class: SecurityInfo

Returns a DER object with this SecurityInfo data (DER sequence)

Specified by:

getDERObject in class SecurityInfo

Returns:

a DER object with this SecurityInfo data

getObjectIdentifier

public 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 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 String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object