org.jmrtd

Class DESedeSecureMessagingWrapper

java.lang.Object

org.jmrtd.SecureMessagingWrapper

org.jmrtd.DESedeSecureMessagingWrapper

All Implemented Interfaces:

java.io.Serializable, net.sf.scuba.smartcards.APDUWrapper

public class DESedeSecureMessagingWrapper
extends SecureMessagingWrapper
implements java.io.Serializable

Secure messaging wrapper for APDUs. Initially based on Section E.3 of ICAO-TR-PKI.

Version:

$Revision: 1559 $

Author:

Cees-Bart Breunesse ([email protected]), Martijn Oostdijk ([email protected])

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static javax.crypto.spec.IvParameterSpec	ZERO_IV_PARAM_SPEC

Constructor Summary

Constructors

Constructor and Description
DESedeSecureMessagingWrapper(javax.crypto.SecretKey ksEnc, javax.crypto.SecretKey ksMac) Constructs a secure messaging wrapper based on the secure messaging session keys.
DESedeSecureMessagingWrapper(javax.crypto.SecretKey ksEnc, javax.crypto.SecretKey ksMac, long ssc) Constructs a secure messaging wrapper based on the secure messaging session keys and the initial value of the send sequence counter.

Method Summary

Modifier and Type	Method and Description
long	getSendSequenceCounter() Gets the current value of the send sequence counter.
net.sf.scuba.smartcards.ResponseAPDU	unwrap(net.sf.scuba.smartcards.ResponseAPDU responseAPDU, int len) Unwraps the apdu buffer rapdu of a response apdu.
net.sf.scuba.smartcards.CommandAPDU	wrap(net.sf.scuba.smartcards.CommandAPDU commandAPDU) Wraps the apdu buffer capdu of a command apdu.

Methods inherited from class java.lang.Object

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

Field Detail

ZERO_IV_PARAM_SPEC

public static final javax.crypto.spec.IvParameterSpec ZERO_IV_PARAM_SPEC

Constructor Detail

DESedeSecureMessagingWrapper

public DESedeSecureMessagingWrapper(javax.crypto.SecretKey ksEnc,
                                    javax.crypto.SecretKey ksMac)
                             throws java.security.GeneralSecurityException

Constructs a secure messaging wrapper based on the secure messaging session keys. The initial value of the send sequence counter is set to 0L.

Parameters:

ksEnc - the session key for encryption

ksMac - the session key for macs

Throws:

java.security.GeneralSecurityException - when the available JCE providers cannot provide the necessary cryptographic primitives ("DESede/CBC/Nopadding" Cipher, "ISO9797Alg3Mac" Mac).

DESedeSecureMessagingWrapper

public DESedeSecureMessagingWrapper(javax.crypto.SecretKey ksEnc,
                                    javax.crypto.SecretKey ksMac,
                                    long ssc)
                             throws java.security.NoSuchAlgorithmException,
                                    javax.crypto.NoSuchPaddingException

Constructs a secure messaging wrapper based on the secure messaging session keys and the initial value of the send sequence counter. Used in BAC and EAC 1.

Parameters:

ksEnc - the session key for encryption

ksMac - the session key for macs

ssc - the initial value of the send sequence counter

Throws:

javax.crypto.NoSuchPaddingException - when the available JCE providers cannot provide the necessary cryptographic primitives

java.security.NoSuchAlgorithmException - when the available JCE providers cannot provide the necessary cryptographic primitives

Method Detail

wrap

public net.sf.scuba.smartcards.CommandAPDU wrap(net.sf.scuba.smartcards.CommandAPDU commandAPDU)

Wraps the apdu buffer capdu of a command apdu. As a side effect, this method increments the internal send sequence counter maintained by this wrapper.

Specified by:

wrap in interface net.sf.scuba.smartcards.APDUWrapper

Parameters:

commandAPDU - buffer containing the command apdu

Returns:

length of the command apdu after wrapping

unwrap

public net.sf.scuba.smartcards.ResponseAPDU unwrap(net.sf.scuba.smartcards.ResponseAPDU responseAPDU,
                                                   int len)

Unwraps the apdu buffer rapdu of a response apdu.

Specified by:

unwrap in interface net.sf.scuba.smartcards.APDUWrapper

Parameters:

responseAPDU - buffer containing the response apdu

len - length of the actual response apdu

Returns:

a new byte array containing the unwrapped buffer

getSendSequenceCounter

public long getSendSequenceCounter()

Gets the current value of the send sequence counter.

Specified by:

getSendSequenceCounter in class SecureMessagingWrapper

Returns:

the current value of the send sequence counter.