Class TuiR5

java.lang.Object

es.gob.jmulticard.card.AbstractSmartCard

es.gob.jmulticard.card.iso7816four.AbstractIso7816FourCard

es.gob.jmulticard.card.gemalto.tuir5.TuiR5

All Implemented Interfaces:

Card, CryptoCard

public final class TuiR5
extends AbstractIso7816FourCard
implements CryptoCard

Tarjeta Gemalto TUI R5 MPCOS.

Field Summary

Fields

Modifier and Type	Field	Description
private static final byte[][]	APPLETS_AIDS
private static final Atr	ATR
private static final byte[]	ATR_MASK
private static final Location	CDF_LOCATION
private static final Map<String, X509Certificate>	CERTIFICATES_BY_ALIAS
private static final byte	CLA
private final CryptoHelper	cryptoHelper	Manejador de funciones criptográficas.
private static final Logger	LOGGER
private final PasswordCallback	passwordCallback

Fields inherited from class AbstractSmartCard

DEBUG

Constructor Summary

Constructors

Constructor	Description
TuiR5(ApduConnection conn, PasswordCallback pwc, CryptoHelper cryptoHlpr)	Construye un objeto que representa una tarjeta Gemalto TUI R5 MPCOS.

Method Summary

Modifier and Type	Method	Description
private void	connect(ApduConnection conn)	Conecta con el lector del sistema que tenga una TUI insertada.
String[]	getAliases()	Obtiene los alias de los certificados de la tarjeta.
String	getCardName()	Obtiene el nombre de la tarjeta.
X509Certificate	getCertificate(String alias)	Obtiene el certificado correspondiente al alias proporcionado.
PrivateKeyReference	getPrivateKey(String alias)	Obtiene una referencia a la clave privada correspondiente al alias proporcionado.
private void	preloadCertificates()
protected void	selectMasterFile()	Selecciona el fichero maestro (directorio raíz de la tarjeta).
private void	selectPkcs15Applet()
byte[]	sign(byte[] data, String algorithm, PrivateKeyReference keyRef)	Realiza una firma electrónica.
String	toString()
void	verifyPin(PasswordCallback pinPc)	Verifica el PIN de la tarjeta.

Methods inherited from class AbstractIso7816FourCard

getChallenge, readAllRecords, readBinaryComplete, selectFileById, selectFileByIdAndRead, selectFileByLocation, selectFileByLocationAndRead, selectFileByName, selectFileByName, setPublicKeyToVerification

Methods inherited from class AbstractSmartCard

getCla, getConnection, sendArbitraryApdu, setConnection

Methods inherited from class Object

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

Field Details

ATR_MASK

private static final byte[] ATR_MASK

ATR

private static final Atr ATR

APPLETS_AIDS

private static final byte[][] APPLETS_AIDS

CDF_LOCATION

private static final Location CDF_LOCATION

CLA

private static final byte CLA

See Also:

• Constant Field Values

LOGGER

private static final Logger LOGGER

passwordCallback

private final transient PasswordCallback passwordCallback

CERTIFICATES_BY_ALIAS

private static final Map<String, X509Certificate> CERTIFICATES_BY_ALIAS

cryptoHelper

private final CryptoHelper cryptoHelper

Manejador de funciones criptográficas.

Constructor Details

TuiR5

public TuiR5(ApduConnection conn,
 PasswordCallback pwc,
 CryptoHelper cryptoHlpr)
      throws Iso7816FourCardException,
IOException

Construye un objeto que representa una tarjeta Gemalto TUI R5 MPCOS.

Parameters:

conn - Conexión con la tarjeta.

pwc - PasswordCallback para obtener el PIN de la TUI.

cryptoHlpr - Manejador de funciones criptográficas.

Throws:

Iso7816FourCardException - Cuando hay errores relativos a la ISO-7816-4.

IOException - Si hay errores de entrada / salida.

Method Details

connect

private void connect(ApduConnection conn)
              throws IOException

Conecta con el lector del sistema que tenga una TUI insertada.

Parameters:

conn - Conexión hacia la TUI

Throws:

IOException - Cuando hay errores de entrada / salida.

preloadCertificates

private void preloadCertificates()
                          throws IOException,
Iso7816FourCardException

Throws:

IOException

Iso7816FourCardException

selectPkcs15Applet

private void selectPkcs15Applet()
                         throws ApduConnectionException,
InvalidCardException,
Iso7816FourCardException

Throws:

ApduConnectionException

InvalidCardException

Iso7816FourCardException

getAliases

public String[] getAliases()

Description copied from interface: CryptoCard

Obtiene los alias de los certificados de la tarjeta.

Specified by:

getAliases in interface CryptoCard

Returns:

Array con los alias de los certificados de la tarjeta

getCertificate

public X509Certificate getCertificate(String alias)

Description copied from interface: CryptoCard

Obtiene el certificado correspondiente al alias proporcionado.

Specified by:

getCertificate in interface CryptoCard

Parameters:

alias - Alias del certificado.

Returns:

Certificado correspondiente al alias proporcionado o null si no existe ningún certificado con ese alias.

getPrivateKey

public PrivateKeyReference getPrivateKey(String alias)
                                  throws CryptoCardException

Description copied from interface: CryptoCard

Obtiene una referencia a la clave privada correspondiente al alias proporcionado.

Specified by:

getPrivateKey in interface CryptoCard

Parameters:

alias - Alias del certificado

Returns:

Referencia a la clave privada correspondiente al alias proporcionado o null si no existe ninguna clave privada con ese alias

Throws:

CryptoCardException - Si ocurre algún problema al recuperar la clave privada.

sign

public byte[] sign(byte[] data,
 String algorithm,
 PrivateKeyReference keyRef)
            throws CryptoCardException

Description copied from interface: CryptoCard

Realiza una firma electrónica.

Specified by:

sign in interface CryptoCard

Parameters:

data - Datos a firmar.

algorithm - Algoritmo de firma.

keyRef - Referencia a la clave privada de firma.

Returns:

Datos firmados (PKCS#1 v1.5).

Throws:

CryptoCardException - Si ocurre algún problema durante la firma.

selectMasterFile

protected void selectMasterFile()
                         throws ApduConnectionException

Description copied from class: AbstractIso7816FourCard

Selecciona el fichero maestro (directorio raíz de la tarjeta).

Specified by:

selectMasterFile in class AbstractIso7816FourCard

Throws:

ApduConnectionException - Si hay problemas en el envío de la APDU.

getCardName

public String getCardName()

Description copied from class: AbstractSmartCard

Obtiene el nombre de la tarjeta.

Specified by:

getCardName in class AbstractSmartCard

Returns:

Nombre de la tarjeta

verifyPin

public void verifyPin(PasswordCallback pinPc)
               throws ApduConnectionException,
BadPinException

Description copied from class: AbstractIso7816FourCard

Verifica el PIN de la tarjeta. El método reintenta hasta que se introduce el PIN correctamente, se bloquea la tarjeta por exceso de intentos de introducción de PIN o se recibe una excepción (derivada de RuntimeException o una ApduConnectionException.

Specified by:

verifyPin in class AbstractIso7816FourCard

Parameters:

pinPc - PIN de la tarjeta.

Throws:

ApduConnectionException - Cuando ocurre un error en la comunicación con la tarjeta.

BadPinException

toString

public String toString()

Overrides:

toString in class Object