Class AbstractIso7816FourCard
java.lang.Object
es.gob.jmulticard.card.AbstractSmartCard
es.gob.jmulticard.card.iso7816four.AbstractIso7816FourCard
- All Implemented Interfaces:
Card
- Direct Known Subclasses:
AbstractIso7816EightCard,SmartCafePkcs15Applet
Tarjeta compatible ISO-7816-4.
- Author:
- Tomás García-Merás., Alberto Martínez.
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedAbstractIso7816FourCard(byte c, ApduConnection conn) Construye una tarjeta compatible ISO 7816-4. -
Method Summary
Modifier and TypeMethodDescriptionbyte[]Lanza un desafío a la tarjeta para obtener un array de 8 bytes aleatorios.List<byte[]> Lee todos los registros del binario actualmente seleccionado.byte[]readBinaryComplete(int len) Lee por completo el contenido binario del fichero actualmente seleccionado.intselectFileById(byte[] id) Selecciona un fichero (DF o EF).byte[]selectFileByIdAndRead(byte[] id) Selecciona un fichero y lo lee por completo.byte[]selectFileByLocationAndRead(Location location) Selecciona un fichero y lo lee por completo.intselectFileByName(byte[] name) Selecciona un fichero por nombre.intselectFileByName(String name) Selecciona un fichero por nombre.protected abstract voidSelecciona el fichero maestro (directorio raíz de la tarjeta).voidsetPublicKeyToVerification(byte[] refPublicKey) Establece una clave pública para la la verificación posterior de un certificado emitido por otro al que pertenece esta clave.abstract voidverifyPin(PasswordCallback pinPc) Verifica el PIN de la tarjeta.Methods inherited from class es.gob.jmulticard.card.AbstractSmartCard
getCardName, getCla, getConnection, sendArbitraryApdu, setConnection
-
Constructor Details
-
AbstractIso7816FourCard
Construye una tarjeta compatible ISO 7816-4.- Parameters:
c- Octeto de clase (CLA) de las APDU.conn- Connexión con la tarjeta.
-
-
Method Details
-
readAllRecords
Lee todos los registros del binario actualmente seleccionado.- Returns:
- Lista de registros leidos del binario actualmente seleccionado.
- Throws:
ApduConnectionException- Si hay problemas en el envío de la APDU.Iso7816FourCardException- SI ocurren problemas durante la lectura de los registros.
-
readBinaryComplete
Lee por completo el contenido binario del fichero actualmente seleccionado.- Parameters:
len- Longitud del fichero a leer.- Returns:
- APDU de respuesta.
- Throws:
ApduConnectionException- Si hay problemas en el envío de la APDU.IOException- Si hay problemas en el buffer de lectura.
-
selectFileByName
Selecciona un fichero por nombre.- Parameters:
name- Nombre del fichero- Returns:
- Tamaño del fichero seleccionado.
- Throws:
ApduConnectionException- Si ocurre algún problema durante la selecciónIso7816FourCardException- Si el fichero no se puede seleccionar por cualquier otra causa
-
selectFileByName
Selecciona un fichero por nombre.- Parameters:
name- Nombre del fichero en hexadecimal- Returns:
- Tamaño del fichero seleccionado.
- Throws:
FileNotFoundException- Si el fichero no existeApduConnectionException- Si ocurre algún problema durante la selecciónIso7816FourCardException- Si el fichero no se puede seleccionar por cualquier otra causa
-
selectFileById
Selecciona un fichero (DF o EF).- Parameters:
id- Identificador del fichero a seleccionar.- Returns:
- Tamaño del fichero seleccionado.
- Throws:
ApduConnectionException- Si hay problemas en el envío de la APDU.Iso7816FourCardException- Si falla la selección de fichero.
-
selectFileByIdAndRead
Selecciona un fichero y lo lee por completo.- Parameters:
id- Identificador del fichero a leer.- Returns:
- Contenido del fichero apuntado por la dirección
id. - Throws:
ApduConnectionException- Si hay problemas en el envío de la APDU.Iso7816FourCardException- Si falla la selección de fichero.IOException- Si hay problemas en el buffer de lectura.
-
selectFileByLocationAndRead
public byte[] selectFileByLocationAndRead(Location location) throws IOException, Iso7816FourCardException Selecciona un fichero y lo lee por completo.- Parameters:
location- Ruta absoluta del fichero a leer.- Returns:
- Contenido del fichero apuntado por la ruta
location. - Throws:
ApduConnectionException- Si hay problemas en el envío de la APDU.Iso7816FourCardException- Si falla la selección de fichero.IOException- Si hay problemas en el buffer de lectura.
-
selectMasterFile
Selecciona el fichero maestro (directorio raíz de la tarjeta).- Throws:
ApduConnectionException- Si hay problemas en el envío de la APDU.Iso7816FourCardException- Si no se puede seleccionar el fichero maestro por cualquier otra causa.
-
setPublicKeyToVerification
Establece una clave pública para la la verificación posterior de un certificado emitido por otro al que pertenece esta clave.- Parameters:
refPublicKey- Referencia a la clave pública para su carga.- Throws:
ApduConnectionException- Cuando ocurre un error en la comunicación con la tarjeta.
-
getChallenge
Lanza un desafío a la tarjeta para obtener un array de 8 bytes aleatorios.- Returns:
- Array de 8 bytes aleatorios.
- Throws:
ApduConnectionException- Cuando ocurre un error en la comunicación con la tarjeta.
-
verifyPin
public abstract void verifyPin(PasswordCallback pinPc) throws ApduConnectionException, PinException, PasswordCallbackNotFoundException Verifica el PIN de la tarjeta. 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 deRuntimeExceptiono unaApduConnectionException.- Parameters:
pinPc- PIN de la tarjeta.- Throws:
ApduConnectionException- Cuando ocurre un error en la comunicación con la tarjeta.PinException- Si el PIN proporcionado en la PasswordCallback es incorrecto o la tarjeta tiene el PIN bloqueado.PasswordCallbackNotFoundException- Si no se ha proporcionado una forma de obtener el PIN.AuthenticationModeLockedException- Si está bloqueada la verificación de PIN (por ejemplo, por superar el número máximo de intentos).
-