pro.javacard.gp

Class GPSession

java.lang.Object

pro.javacard.gp.GPSession

public class GPSession
extends Object

Represents a connection to a GlobalPlatform Card (BIBO interface) Does secure channel and low-level translation of GP* objects to APDU-s and arguments NOT thread-safe

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GPSession.APDUMode
static class	GPSession.GPSpec

Field Summary

Fields

Modifier and Type	Field and Description
static byte	CLA_GP
static byte	CLA_MAC
static EnumSet<GPSession.APDUMode>	defaultMode
static byte	INS_DELETE
static byte	INS_GET_DATA
static byte	INS_GET_STATUS
static byte	INS_INITIALIZE_UPDATE
static byte	INS_INSTALL
static byte	INS_LOAD
static byte	INS_PUT_KEY
static byte	INS_SET_STATUS
static byte	INS_STORE_DATA
static byte	P1_INSTALL_AND_MAKE_SELECTABLE
static byte	P1_INSTALL_FOR_INSTALL
static byte	P1_INSTALL_FOR_LOAD
static byte	P1_LAST_BLOCK
static byte	P1_MORE_BLOCKS
static int	SCP_01_05
static int	SCP_01_15
static int	SCP_02_04
static int	SCP_02_05
static int	SCP_02_0A
static int	SCP_02_0B
static int	SCP_02_14
static int	SCP_02_15
static int	SCP_02_1A
static int	SCP_02_1B
static int	SCP_ANY
protected boolean	strict

Constructor Summary

Constructors

Constructor and Description
GPSession(apdu4j.APDUBIBO channel, pro.javacard.AID sdAID)

Method Summary

Modifier and Type	Method and Description
static GPSession	connect(apdu4j.APDUBIBO channel, pro.javacard.AID sdAID)
void	deleteAID(pro.javacard.AID aid, boolean deleteDeps)
void	deleteKey(int keyver)
static GPSession	discover(apdu4j.APDUBIBO channel)
void	extradite(pro.javacard.AID what, pro.javacard.AID to)
pro.javacard.AID	getAID()
apdu4j.APDUBIBO	getCardChannel()
static byte[]	getLoadParams(boolean loadParam, byte[] code)
GPRegistry	getRegistry()
int	getScpKeyVersion()
static String	getVersion()
protected void	giveStrictWarning(String message)
void	installAndMakeSelectable(pro.javacard.AID packageAID, pro.javacard.AID appletAID, pro.javacard.AID instanceAID, GPRegistryEntry.Privileges privileges, byte[] installParams)
void	installForInstall(pro.javacard.AID packageAID, pro.javacard.AID appletAID, pro.javacard.AID instanceAID, GPRegistryEntry.Privileges privileges, byte[] installParams, PrivateKey key)
void	installForPersonalization(pro.javacard.AID aid)
void	loadCapFile(pro.javacard.CAPFile cap, pro.javacard.AID targetDomain)
void	loadCapFile(pro.javacard.CAPFile cap, pro.javacard.AID targetDomain, pro.javacard.AID dapdomain, byte[] dap, String hashFunction)
void	loadCapFile(pro.javacard.CAPFile cap, pro.javacard.AID targetDomain, byte[] dap, String hash)
void	loadCapFile(pro.javacard.CAPFile cap, pro.javacard.AID targetDomain, String hashFunction)
void	lockUnlockApplet(pro.javacard.AID app, boolean lock)
void	makeDefaultSelected(pro.javacard.AID aid)
void	openSecureChannel(GPCardKeys keys, GPSecureChannel scp, byte[] host_challenge, EnumSet<GPSession.APDUMode> securityLevel)
void	personalize(pro.javacard.AID aid, byte[] data, int P1)
List<byte[]>	personalize(pro.javacard.AID aid, List<byte[]> data, int P1)
byte[]	personalizeSingle(pro.javacard.AID aid, byte[] data, int P1)
void	putKey(RSAPublicKey pubkey, int version)
void	putKeys(GPCardKeys keys, boolean replace)
void	renameISD(pro.javacard.AID newaid)
void	setBlockSize(int size)
void	setCardStatus(byte status)
void	setDMTokenGenerator(DMTokenGenerator tokenGenerator)
void	setSpec(GPSession.GPSpec spec)
void	setStrict(boolean strict)
void	storeData(byte[] data, int P1)
List<byte[]>	storeData(List<byte[]> blocks, int P1)
byte[]	storeDataSingle(byte[] data, int P1)
apdu4j.ResponseAPDU	transmit(apdu4j.CommandAPDU command)

Methods inherited from class java.lang.Object

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

Field Detail

SCP_ANY

public static final int SCP_ANY

See Also:

Constant Field Values

SCP_01_05

public static final int SCP_01_05

See Also:

Constant Field Values

SCP_01_15

public static final int SCP_01_15

See Also:

Constant Field Values

SCP_02_04

public static final int SCP_02_04

See Also:

Constant Field Values

SCP_02_05

public static final int SCP_02_05

See Also:

Constant Field Values

SCP_02_0A

public static final int SCP_02_0A

See Also:

Constant Field Values

SCP_02_0B

public static final int SCP_02_0B

See Also:

Constant Field Values

SCP_02_14

public static final int SCP_02_14

See Also:

Constant Field Values

SCP_02_15

public static final int SCP_02_15

See Also:

Constant Field Values

SCP_02_1A

public static final int SCP_02_1A

See Also:

Constant Field Values

SCP_02_1B

public static final int SCP_02_1B

See Also:

Constant Field Values

defaultMode

public static final EnumSet<GPSession.APDUMode> defaultMode

CLA_GP

public static final byte CLA_GP

See Also:

Constant Field Values

CLA_MAC

public static final byte CLA_MAC

See Also:

Constant Field Values

INS_INITIALIZE_UPDATE

public static final byte INS_INITIALIZE_UPDATE

See Also:

Constant Field Values

INS_INSTALL

public static final byte INS_INSTALL

See Also:

Constant Field Values

INS_LOAD

public static final byte INS_LOAD

See Also:

Constant Field Values

INS_DELETE

public static final byte INS_DELETE

See Also:

Constant Field Values

INS_GET_STATUS

public static final byte INS_GET_STATUS

See Also:

Constant Field Values

INS_SET_STATUS

public static final byte INS_SET_STATUS

See Also:

Constant Field Values

INS_PUT_KEY

public static final byte INS_PUT_KEY

See Also:

Constant Field Values

INS_STORE_DATA

public static final byte INS_STORE_DATA

See Also:

Constant Field Values

INS_GET_DATA

public static final byte INS_GET_DATA

See Also:

Constant Field Values

P1_INSTALL_AND_MAKE_SELECTABLE

public static final byte P1_INSTALL_AND_MAKE_SELECTABLE

See Also:

Constant Field Values

P1_INSTALL_FOR_INSTALL

public static final byte P1_INSTALL_FOR_INSTALL

See Also:

Constant Field Values

P1_INSTALL_FOR_LOAD

public static final byte P1_INSTALL_FOR_LOAD

See Also:

Constant Field Values

P1_MORE_BLOCKS

public static final byte P1_MORE_BLOCKS

See Also:

Constant Field Values

P1_LAST_BLOCK

public static final byte P1_LAST_BLOCK

See Also:

Constant Field Values

strict

protected boolean strict

Constructor Detail

GPSession

public GPSession(apdu4j.APDUBIBO channel,
                 pro.javacard.AID sdAID)

Method Detail

discover

public static GPSession discover(apdu4j.APDUBIBO channel)
                          throws GPException,
                                 IOException

Throws:

GPException

IOException

connect

public static GPSession connect(apdu4j.APDUBIBO channel,
                                pro.javacard.AID sdAID)
                         throws IOException,
                                GPException

Throws:

IOException

GPException

getVersion

public static String getVersion()

getLoadParams

public static byte[] getLoadParams(boolean loadParam,
                                   byte[] code)

setStrict

public void setStrict(boolean strict)

setBlockSize

public void setBlockSize(int size)

setSpec

public void setSpec(GPSession.GPSpec spec)

setDMTokenGenerator

public void setDMTokenGenerator(DMTokenGenerator tokenGenerator)

getAID

public pro.javacard.AID getAID()

getCardChannel

public apdu4j.APDUBIBO getCardChannel()

giveStrictWarning

protected void giveStrictWarning(String message)
                          throws GPException

Throws:

GPException

getScpKeyVersion

public int getScpKeyVersion()

openSecureChannel

public void openSecureChannel(GPCardKeys keys,
                              GPSecureChannel scp,
                              byte[] host_challenge,
                              EnumSet<GPSession.APDUMode> securityLevel)
                       throws IOException,
                              GPException

Throws:

IOException

GPException

transmit

public apdu4j.ResponseAPDU transmit(apdu4j.CommandAPDU command)
                             throws IOException

Throws:

IOException

loadCapFile

public void loadCapFile(pro.javacard.CAPFile cap,
                        pro.javacard.AID targetDomain)
                 throws IOException,
                        GPException

Throws:

IOException

GPException

loadCapFile

public void loadCapFile(pro.javacard.CAPFile cap,
                        pro.javacard.AID targetDomain,
                        String hashFunction)
                 throws IOException,
                        GPException

Throws:

IOException

GPException

loadCapFile

public void loadCapFile(pro.javacard.CAPFile cap,
                        pro.javacard.AID targetDomain,
                        byte[] dap,
                        String hash)
                 throws IOException,
                        GPException

Throws:

IOException

GPException

loadCapFile

public void loadCapFile(pro.javacard.CAPFile cap,
                        pro.javacard.AID targetDomain,
                        pro.javacard.AID dapdomain,
                        byte[] dap,
                        String hashFunction)
                 throws IOException,
                        GPException

Throws:

IOException

GPException

installAndMakeSelectable

public void installAndMakeSelectable(pro.javacard.AID packageAID,
                                     pro.javacard.AID appletAID,
                                     pro.javacard.AID instanceAID,
                                     GPRegistryEntry.Privileges privileges,
                                     byte[] installParams)
                              throws GPException,
                                     IOException

Throws:

GPException

IOException

installForInstall

public void installForInstall(pro.javacard.AID packageAID,
                              pro.javacard.AID appletAID,
                              pro.javacard.AID instanceAID,
                              GPRegistryEntry.Privileges privileges,
                              byte[] installParams,
                              PrivateKey key)
                       throws GPException,
                              IOException

Throws:

GPException

IOException

extradite

public void extradite(pro.javacard.AID what,
                      pro.javacard.AID to)
               throws GPException,
                      IOException

Throws:

GPException

IOException

installForPersonalization

public void installForPersonalization(pro.javacard.AID aid)
                               throws IOException,
                                      GPException

Throws:

IOException

GPException

personalizeSingle

public byte[] personalizeSingle(pro.javacard.AID aid,
                                byte[] data,
                                int P1)
                         throws IOException,
                                GPException

Throws:

IOException

GPException

personalize

public void personalize(pro.javacard.AID aid,
                        byte[] data,
                        int P1)
                 throws IOException,
                        GPException

Throws:

IOException

GPException

personalize

public List<byte[]> personalize(pro.javacard.AID aid,
                                List<byte[]> data,
                                int P1)
                         throws IOException,
                                GPException

Throws:

IOException

GPException

storeDataSingle

public byte[] storeDataSingle(byte[] data,
                              int P1)
                       throws IOException,
                              GPException

Throws:

IOException

GPException

storeData

public void storeData(byte[] data,
                      int P1)
               throws IOException,
                      GPException

Throws:

IOException

GPException

storeData

public List<byte[]> storeData(List<byte[]> blocks,
                              int P1)
                       throws IOException,
                              GPException

Throws:

IOException

GPException

makeDefaultSelected

public void makeDefaultSelected(pro.javacard.AID aid)
                         throws IOException,
                                GPException

Throws:

IOException

GPException

lockUnlockApplet

public void lockUnlockApplet(pro.javacard.AID app,
                             boolean lock)
                      throws IOException,
                             GPException

Throws:

IOException

GPException

setCardStatus

public void setCardStatus(byte status)
                   throws IOException,
                          GPException

Throws:

IOException

GPException

deleteAID

public void deleteAID(pro.javacard.AID aid,
                      boolean deleteDeps)
               throws GPException,
                      IOException

Throws:

GPException

IOException

deleteKey

public void deleteKey(int keyver)
               throws GPException,
                      IOException

Throws:

GPException

IOException

renameISD

public void renameISD(pro.javacard.AID newaid)
               throws GPException,
                      IOException

Throws:

GPException

IOException

putKeys

public void putKeys(GPCardKeys keys,
                    boolean replace)
             throws GPException,
                    IOException

Throws:

GPException

IOException

putKey

public void putKey(RSAPublicKey pubkey,
                   int version)
            throws IOException,
                   GPException

Throws:

IOException

GPException

getRegistry

public GPRegistry getRegistry()
                       throws GPException,
                              IOException

Throws:

GPException

IOException