Class Dnie
- All Implemented Interfaces:
Card, CryptoCard, Cwa14890Card, Dni
DNI Electrónico.
-
Field Summary
FieldsModifier and TypeFieldDescriptionAlias de los certificados de la tarjeta indexados por el identificador interno del certificado (pasado debyte[]aString).private CallbackHandlerprivate static final LocationLocalización del CDF PKCS#15.private static final byte[]Identificador del fichero del certificado de componente del DNIe.private final Map<String, X509Certificate> Certificados de la tarjeta indexados por su alias.private final CryptoHelperManejador de funciones criptográficas.private static final byteOcteto que identifica una verificación fallida del PIN.private static final LocationLocalización del EF IDESP.private final Map<String, DniePrivateKeyReference> Referencias a las claves privadas de la tarjeta indexadas por el alias de su certificado asociado.private static final StringNombre del Master File del DNIe.private PasswordCallbackprivate static final LocationLocalización del PrKDF PKCS#15.protected ApduConnectionConexión inicial con la tarjeta, sin ningún canal seguro. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedDnie(ApduConnection conn, PasswordCallback pwc, CryptoHelper cryptoHlpr, CallbackHandler ch) Construye una clase que representa un DNIe. -
Method Summary
Modifier and TypeMethodDescriptionfinal byte[]Realiza la operación de cambio de PIN.final byte[]cipherData(byte[] data, PrivateKeyReference privateKeyReference) Realiza un cifrado RSA directo con una clave privada.static voidconnect(ApduConnection conn) Conecta con el lector del sistema que tenga un DNIe insertado.final booleanexternalAuthentication(byte[] extAuthenticationData) Envia el mensaje de autenticación externa.final String[]Obtiene los alias de los certificados de la tarjeta.Obtiene el nombre de la tarjeta.final X509CertificategetCertificate(String alias) Obtiene el certificado correspondiente al alias proporcionado.final byte[]getChrCCvIfd(Cwa14890PublicConstants consts) Recupera el CHR de la clave pública del certificado de terminal.protected final CryptoHelperObtiene la clase con funcionalidades de base de criptografía.protected Cwa14890PrivateConstantsObtiene las constantes privadas CWA-14890 para el cifrado de canal.protected Cwa14890PublicConstantsObtiene las constantes públicas CWA-14890 para el cifrado de canal.final RSAPublicKeyRecupera la clave pública del certificado de componente.getIdesp()Obtiene el número de soporte (IDESP) del DNIe.final intObtiene la longitud, en octetos, de las claves RSA del certificado de comnponente del terminal.final RSAPrivateKeyRecupera la clave privada del certificado de componente del terminal.byte[]getInternalAuthenticateMessage(byte[] randomIfd, byte[] chrCCvIfd) Obtiene el mensaje de autenticación interna de la tarjeta.protected PasswordCallbackObtiene laPasswordCallbackpredefinida.protected final PasswordCallbackObtiene laPasswordCallback.protected StringgetPinMessage(int retriesLeft) Devuelve el texto del diálogo de inserción de PIN.intDevuelve los intentos restantes de comprobación de PIN del DNIe.final PrivateKeyReferencegetPrivateKey(String alias) Obtiene una referencia a la clave privada correspondiente al alias proporcionado.final byte[]Recupera la referencia a la clave privada del certificado de componente.final byte[]Recupera el número de serie de la tarjeta.private voidOculta los alias certificados que no tienen una clave privada asociada.protected final booleanIndica si el canal CWA-14890 está o no abierto.private voidCarga localizaciones de claves, alias y certificados.protected booleanIndica si es necesario haber verificado o no el PIN para poder leer los certicados.voidEstablece y abre el canal seguro CWA-14890 si no lo estaba ya.voidopenSecureChannelIfNotAlreadyOpened(boolean doChv) Establece y abre el canal seguro CWA-14890 si no lo estaba ya.protected final voidSelecciona el fichero maestro (directorio raíz de la tarjeta).final voidsetCallbackHandler(CallbackHandler handler) Asigna unCallbackHandlera la tarjeta.final voidsetKeysToAuthentication(byte[] refPublicKey, byte[] refPrivateKey) Establece una clave pública y otra privada para la autenticación.final voidAsigna unPasswordCallbacka la tarjeta.byte[]sign(byte[] data, String signAlgorithm, PrivateKeyReference privateKeyReference) Realiza una firma electrónica.protected final byte[]signInternal(byte[] data, String signAlgorithm, PrivateKeyReference privateKeyReference) Ejecuta la operación interna de firma de la tarjeta.private byte[]signOperation(byte[] data, String signAlgorithm, PrivateKeyReference privateKeyReference) Realiza la operación de firma.toString()final voidVerifica el certificado de componente de la tarjeta.final voidVerifica que los certificados declarados por el controlador (certificados de terminal) sean válidos para el uso de la tarjeta.final voidVerifica el PIN de la tarjeta.Methods inherited from class AbstractIso7816EightCard
verifyCertificateMethods inherited from class AbstractIso7816FourCard
getChallenge, readAllRecords, readBinaryComplete, selectFileById, selectFileByIdAndRead, selectFileByLocationAndRead, selectFileByName, selectFileByName, setPublicKeyToVerificationMethods inherited from class AbstractSmartCard
getCla, getConnection, sendArbitraryApdu, setConnectionMethods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface Cwa14890Card
getChallenge
-
Field Details
-
ERROR_PIN_SW1
private static final byte ERROR_PIN_SW1Octeto que identifica una verificación fallida del PIN.- See Also:
-
CERT_ICC_FILE_ID
private static final byte[] CERT_ICC_FILE_IDIdentificador del fichero del certificado de componente del DNIe. -
MASTER_FILE_NAME
-
CDF_LOCATION
Localización del CDF PKCS#15. -
PRKDF_LOCATION
Localización del PrKDF PKCS#15. -
IDESP_LOCATION
Localización del EF IDESP. -
aliases
-
certs
Certificados de la tarjeta indexados por su alias. -
aliasByCertAndKeyId
-
keyReferences
Referencias a las claves privadas de la tarjeta indexadas por el alias de su certificado asociado. -
cryptoHelper
Manejador de funciones criptográficas. -
rawConnection
Conexión inicial con la tarjeta, sin ningún canal seguro. -
passwordCallback
-
callbackHandler
-
-
Constructor Details
-
Dnie
protected Dnie(ApduConnection conn, PasswordCallback pwc, CryptoHelper cryptoHlpr, CallbackHandler ch) throws ApduConnectionException Construye una clase que representa un DNIe.- Parameters:
conn- Conexión con la tarjeta.pwc- PasswordCallback para obtener el PIN del DNIe.cryptoHlpr- Funcionalidades criptográficas de utilidad que pueden variar entre máquinas virtuales.ch- Gestor de callbacks para la solicitud de datos al usuario.- Throws:
ApduConnectionException- Si la conexión con la tarjeta se proporciona cerrada y no es posible abrirla.
-
-
Method Details
-
getCryptoHelper
Obtiene la clase con funcionalidades de base de criptografía.- Returns:
- Clase con funcionalidades de base de criptografía.
-
getPasswordCallback
Obtiene laPasswordCallback.- Returns:
PasswordCallback.
-
getCwa14890PublicConstants
Obtiene las constantes públicas CWA-14890 para el cifrado de canal.- Returns:
- Constantes públicas CWA-14890 para el cifrado de canal.
-
getCwa14890PrivateConstants
Obtiene las constantes privadas CWA-14890 para el cifrado de canal.- Returns:
- Constantes privadas CWA-14890 para el cifrado de canal.
-
signInternal
protected final byte[] signInternal(byte[] data, String signAlgorithm, PrivateKeyReference privateKeyReference) throws CryptoCardException, PinException Ejecuta la operación interna de firma de la tarjeta.- Parameters:
data- Datos a firmar.signAlgorithm- Algoritmo de firma.privateKeyReference- Referencia a la clave privada de firma.- Returns:
- Datos firmados.
- Throws:
CryptoCardException- Si hay problemas durante el proceso.PinException- Si no se ha podido realizar la firma por un problema con el PIN (no estar hecha la autenticación de PIN).
-
signOperation
private byte[] signOperation(byte[] data, String signAlgorithm, PrivateKeyReference privateKeyReference) throws CryptoCardException, PinException Realiza la operación de firma.- Parameters:
data- Datos que se desean firmar.signAlgorithm- Algoritmo de firma (por ejemplo,SHA512withRSA,SHA1withRSA, etc.).privateKeyReference- Referencia a la clave privada para la firma.- Returns:
- Firma de los datos.
- Throws:
CryptoCardException- Cuando se produce un error durante la operación de firma.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.
-
getInternalPasswordCallback
Obtiene laPasswordCallbackpredefinida.- Returns:
PasswordCallbackpredefinida.- Throws:
BadPinException- Si elPasswordCallbackdevuelve un PIN nulo o vacío.PasswordCallbackNotFoundException- Si no hay unaPasswordCallbackdefinida.PinException
-
getPinMessage
Devuelve el texto del diálogo de inserción de PIN.- Parameters:
retriesLeft- Intentos restantes antes de bloquear la tarjeta.- Returns:
- Mensaje que mostrar en el cuerpo del diálogo de inserción de PIN.
-
isSecurityChannelOpen
protected final boolean isSecurityChannelOpen()Indica si el canal CWA-14890 está o no abierto.- Returns:
truesi el canal CWA-14890 está abierto,falseen caso contrario.
-
needsPinForLoadingCerts
protected boolean needsPinForLoadingCerts()Indica si es necesario haber verificado o no el PIN para poder leer los certicados.- Returns:
truesi es necesario haber verificado o no el PIN para poder leer los certicados,falseen caso contrario.
-
selectMasterFile
Description copied from class:AbstractIso7816FourCardSelecciona el fichero maestro (directorio raíz de la tarjeta).- Specified by:
selectMasterFilein classAbstractIso7816FourCard- 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.
-
toString
-
getSerialNumber
Description copied from interface:Cwa14890CardRecupera el número de serie de la tarjeta.- Specified by:
getSerialNumberin interfaceCwa14890Card- Returns:
- Número de serie.
- Throws:
ApduConnectionException- Cuando ocurre un error en la comunicación con la tarjeta.
-
getCardName
Description copied from class:AbstractSmartCardObtiene el nombre de la tarjeta.- Specified by:
getCardNamein classAbstractSmartCard- Returns:
- Nombre de la tarjeta.
-
getAliases
Description copied from interface:CryptoCardObtiene los alias de los certificados de la tarjeta.- Specified by:
getAliasesin interfaceCryptoCard- Returns:
- Array con los alias de los certificados de la tarjeta
-
getCertificate
Description copied from interface:CryptoCardObtiene el certificado correspondiente al alias proporcionado.- Specified by:
getCertificatein interfaceCryptoCard- Parameters:
alias- Alias del certificado.- Returns:
- Certificado correspondiente al alias proporcionado o
nullsi no existe ningún certificado con ese alias.
-
verifyIcc
public final void verifyIcc()Description copied from interface:Cwa14890CardVerifica el certificado de componente de la tarjeta.- Specified by:
verifyIccin interfaceCwa14890Card
-
getIccCertPublicKey
Description copied from interface:Cwa14890CardRecupera la clave pública del certificado de componente.- Specified by:
getIccCertPublicKeyin interfaceCwa14890Card- Returns:
- Clave pública del certificado de componente.
- Throws:
IOException- Cuando ocurre algún problema en la selección y lectura del certificado
-
verifyIfdCertificateChain
public final void verifyIfdCertificateChain(Cwa14890PublicConstants consts) throws ApduConnectionException Description copied from interface:Cwa14890CardVerifica que los certificados declarados por el controlador (certificados de terminal) sean válidos para el uso de la tarjeta.- Specified by:
verifyIfdCertificateChainin interfaceCwa14890Card- Parameters:
consts- Clase de claves.- Throws:
ApduConnectionException- Cuando ocurre algín error en la comunicación con la tarjeta.
-
getRefIccPrivateKey
Description copied from interface:Cwa14890CardRecupera la referencia a la clave privada del certificado de componente.- Specified by:
getRefIccPrivateKeyin interfaceCwa14890Card- Parameters:
consts- Clase de claves.- Returns:
- Referencia a clave privada
-
getChrCCvIfd
Description copied from interface:Cwa14890CardRecupera el CHR de la clave pública del certificado de terminal.- Specified by:
getChrCCvIfdin interfaceCwa14890Card- Parameters:
consts- Clase de claves.- Returns:
- Referencia a clave pública
-
getIfdPrivateKey
Description copied from interface:Cwa14890CardRecupera la clave privada del certificado de componente del terminal.- Specified by:
getIfdPrivateKeyin interfaceCwa14890Card- Parameters:
consts- Clase de claves privadas.- Returns:
- Clave privada.
-
setKeysToAuthentication
public final void setKeysToAuthentication(byte[] refPublicKey, byte[] refPrivateKey) throws ApduConnectionException Description copied from interface:Cwa14890CardEstablece una clave pública y otra privada para la autenticación. interna y externa de la tarjeta.- Specified by:
setKeysToAuthenticationin interfaceCwa14890Card- Parameters:
refPublicKey- Referencia a la clave pública.refPrivateKey- Referencia a la clave privada.- Throws:
ApduConnectionException- Cuando ocurre un error de comunicación con la tarjeta.
-
getInternalAuthenticateMessage
public byte[] getInternalAuthenticateMessage(byte[] randomIfd, byte[] chrCCvIfd) throws ApduConnectionException Description copied from interface:Cwa14890CardObtiene el mensaje de autenticación interna de la tarjeta.- Specified by:
getInternalAuthenticateMessagein interfaceCwa14890Card- Parameters:
randomIfd- Bytes aleatorios generados.chrCCvIfd- CHR de la clave pública del certificado de terminal.- Returns:
- Mensaje cifrado con la clave privada de componente de la tarjeta.
- Throws:
ApduConnectionException- Cuando ocurre un error de comunicación con la tarjeta.
-
externalAuthentication
public final boolean externalAuthentication(byte[] extAuthenticationData) throws ApduConnectionException Description copied from interface:Cwa14890CardEnvia el mensaje de autenticación externa.- Specified by:
externalAuthenticationin interfaceCwa14890Card- Parameters:
extAuthenticationData- Mensaje de autenticación externa.- Returns:
truesi la autenticación finalizó correctamente,falseen caso contrario.- Throws:
ApduConnectionException- Cuando ocurre un error en la comunicación con la tarjeta.
-
getPrivateKey
Description copied from interface:CryptoCardObtiene una referencia a la clave privada correspondiente al alias proporcionado.- Specified by:
getPrivateKeyin interfaceCryptoCard- Parameters:
alias- Alias del certificado- Returns:
- Referencia a la clave privada correspondiente al alias proporcionado o
nullsi no existe ninguna clave privada con ese alias
-
sign
public byte[] sign(byte[] data, String signAlgorithm, PrivateKeyReference privateKeyReference) throws CryptoCardException, PinException Description copied from interface:CryptoCardRealiza una firma electrónica.- Specified by:
signin interfaceCryptoCard- Parameters:
data- Datos a firmar.signAlgorithm- Algoritmo de firma.privateKeyReference- Referencia a la clave privada de firma.- Returns:
- Datos firmados (en el algoritmo y formato que determine la tarjeta).
- Throws:
CryptoCardException- Si ocurre algún problema durante la firma.PinException- Si el PIN proporcionado es incorrecto o no es posible obtenerlo.
-
verifyPin
Description copied from class:AbstractIso7816FourCardVerifica 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.- Specified by:
verifyPinin classAbstractIso7816FourCard- Parameters:
psc- 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.
-
getIfdKeyLength
Description copied from interface:Cwa14890CardObtiene la longitud, en octetos, de las claves RSA del certificado de comnponente del terminal.- Specified by:
getIfdKeyLengthin interfaceCwa14890Card- Parameters:
consts- Clase de claves.- Returns:
- Longitud, en octetos, de las claves RSA del certificado de comnponente del terminal.
-
cipherData
public final byte[] cipherData(byte[] data, PrivateKeyReference privateKeyReference) throws CryptoCardException, PinException, LostChannelException Realiza un cifrado RSA directo con una clave privada.- Parameters:
data- Datos a cifrar.privateKeyReference- Referencia a la clave privada RSA a usar.- Returns:
- Datos cifrados.
- Throws:
CryptoCardException- Si hay errores en el proceso en la tarjeta o en la comunicación con ella.PinException- Si el PIN introducido no es correcto.LostChannelException- Si se pierde el canal de cifrado.
-
openSecureChannelIfNotAlreadyOpened
Establece y abre el canal seguro CWA-14890 si no lo estaba ya.- Throws:
CryptoCardException- Si hay problemas en el proceso.PinException- Si el PIN usado para la apertura de canal no es válido o la tarjeta tiene el PIN bloqueado.PasswordCallbackNotFoundException- Si no se ha proporcionado una forma de obtener el PIN.
-
openSecureChannelIfNotAlreadyOpened
public void openSecureChannelIfNotAlreadyOpened(boolean doChv) throws CryptoCardException, PinException Establece y abre el canal seguro CWA-14890 si no lo estaba ya.- Parameters:
doChv-truesi la apertura de canal seguro debe incluir la verificación de PIN,falsesi debe abrirse canal seguro sin verificar PIN.- Throws:
CryptoCardException- Si hay problemas en el proceso.PinException- Si el PIN usado para la apertura de canal no es válido o la tarjeta tiene el PIN bloqueado.PasswordCallbackNotFoundException- Si no se ha proporcionado una forma de obtener el PIN.
-
getPinRetriesLeft
Devuelve los intentos restantes de comprobación de PIN del DNIe.- Returns:
- Intentos restantes de comprobación de PIN del DNIe.
- Throws:
ApduConnectionException- Cuando hay problemas en el proceso.
-
changePIN
public final byte[] changePIN(String oldPin, String newPin) throws CryptoCardException, PinException Realiza la operación de cambio de PIN. Necesita tener un canal administrativo abierto.- Parameters:
oldPin- PIN actual.newPin- PIN nuevo.- Returns:
- APDU de respuesta de la operación.
- Throws:
CryptoCardException- Cuando se produce un error en el cambio de PIN.PinException- Si el PIN actual es incorrecto.AuthenticationModeLockedException- Cuando el DNIe está bloqueado.
-
setCallbackHandler
Asigna unCallbackHandlera la tarjeta.- Parameters:
handler-CallbackHandlera asignar.
-
setPasswordCallback
Asigna unPasswordCallbacka la tarjeta.- Parameters:
pwc-PasswordCallbacka asignar.
-
getIdesp
Obtiene el número de soporte (IDESP) del DNIe.- Returns:
- Obtiene el número de soporte (IDESP) del DNIe.
- Throws:
Iso7816FourCardException- Si hay problemas enviando la APDU.FileNotFoundException- Si no se encuentra el fichero que contiene el IDESP.IOException- Si no se puede conectar con la tarjeta.
-
connect
Conecta con el lector del sistema que tenga un DNIe insertado.- Parameters:
conn- Conexión hacia el DNIe.- Throws:
ApduConnectionException- Si hay problemas de conexión con la tarjeta.
-
loadCertificates
Carga localizaciones de claves, alias y certificados.- Throws:
ApduConnectionException- Si hay problemas en la carga.
-
hideCertsWithoutKey
private void hideCertsWithoutKey()Oculta los alias certificados que no tienen una clave privada asociada. Los certificados se mantienen, y se pueden seguir obteniendo si se conoce el alias.
-