Class Dnie3
- All Implemented Interfaces:
Card, CryptoCard, Cwa14890Card, Dni, MrtdLds1
- Direct Known Subclasses:
DnieNfc, IcaoMrtdWithBac
-
Field Summary
FieldsFields inherited from class Dnie
rawConnectionFields inherited from interface MrtdLds1
FILE_ATR_INFO_LOCATION, FILE_CARD_ACCESS_LOCATION, FILE_CARD_SECURITY_LOCATION, FILE_COM_LOCATION, FILE_DG01_LOCATION, FILE_DG02_LOCATION, FILE_DG03_LOCATION, FILE_DG04_LOCATION, FILE_DG05_LOCATION, FILE_DG06_LOCATION, FILE_DG07_LOCATION, FILE_DG08_LOCATION, FILE_DG09_LOCATION, FILE_DG10_LOCATION, FILE_DG11_LOCATION, FILE_DG12_LOCATION, FILE_DG13_LOCATION, FILE_DG14_LOCATION, FILE_DG15_LOCATION, FILE_DG16_LOCATION, FILE_DIR_LOCATION, FILE_SOD_LOCATION -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedDnie3(ApduConnection conn, PasswordCallback pwc, CryptoHelper cryptoHlpr, CallbackHandler ch) Construye una clase que representa un DNIe 3.0. -
Method Summary
Modifier and TypeMethodDescriptionfinal X509Certificate[]Comprueba la validez de los objetos de seguridad a partir del SOD.final byte[]Obtiene el ATR/INFO.final byte[]Obtiene el CardAccess.Obtiene el nombre de la tarjeta.byte[]Obtiene el CardSecurity.final ComgetCom()Obtiene el COM.final MrzgetDg1()Obtiene el DG1 (MRZ).byte[]getDg10()Obtiene el DG10 (elemento sustancia).getDg11()Obtiene el DG11 (detalles personales adicionales).final byte[]getDg12()Obtiene el DG12 (detalles del documento adicionales).getDg13()Obtiene el DG13 (detalles opcionales).final SecurityOptionsgetDg14()Obtiene el DG14 (opciones de seguridad).byte[]getDg15()Obtiene el DG15 (información de clave pública de autenticación activa).byte[]getDg16()Obtiene el DG16 (personas que han de notificarse).final SubjectFacePhotogetDg2()Obtiene el DG2 (fotografía del rostro del titular).byte[]getDg3()Obtiene el DG3 (elementos de identificación adicionales - Dedos).byte[]getDg4()Obtiene el DG4 (elementos de identificación adicionales - Iris).byte[]getDg5()Obtiene el DG5 (retrato exhibido).byte[]getDg6()Obtiene el DG6 (reservado para uso futuro).final SubjectSignaturePhotogetDg7()Obtiene el DG7 (imagen de la firma o marca habitual exhibida).byte[]getDg8()Obtiene el DG8 (elemento datos).byte[]getDg9()Obtiene el DG9 (elemento estructura).final byte[]getDir()Obtiene el DIR.intDevuelve los intentos restantes de comprobación de PIN del DNIe.final SodgetSod()Obtiene el SOD.protected booleanIndica si es necesario haber verificado o no el PIN para poder leer los certicados.final ApduConnectionAbre y establece el canal seguro de PIN.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.final ApduConnectionAbre y establece el canal seguro de usuario.Methods inherited from class Dnie
changePIN, cipherData, connect, externalAuthentication, getAliases, getCertificate, getChrCCvIfd, getCryptoHelper, getCwa14890PrivateConstants, getCwa14890PublicConstants, getIccCertPublicKey, getIdesp, getIfdKeyLength, getIfdPrivateKey, getInternalAuthenticateMessage, getInternalPasswordCallback, getPasswordCallback, getPinMessage, getPrivateKey, getRefIccPrivateKey, getSerialNumber, isSecurityChannelOpen, selectMasterFile, setCallbackHandler, setKeysToAuthentication, setPasswordCallback, sign, signInternal, toString, verifyIcc, verifyIfdCertificateChain, verifyPinMethods 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
-
idesp
-
-
Constructor Details
-
Dnie3
protected Dnie3(ApduConnection conn, PasswordCallback pwc, CryptoHelper cryptoHlpr, CallbackHandler ch) throws ApduConnectionException Construye una clase que representa un DNIe 3.0.- 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 las Callbacks (PIN, confirmación, etc.).- Throws:
ApduConnectionException- Si la conexión con la tarjeta se proporciona cerrada y no es posible abrirla.
-
-
Method Details
-
getCardName
Description copied from class:AbstractSmartCardObtiene el nombre de la tarjeta.- Overrides:
getCardNamein classDnie- Returns:
- Nombre de la tarjeta.
-
getPinRetriesLeft
Description copied from class:DnieDevuelve los intentos restantes de comprobación de PIN del DNIe.- Overrides:
getPinRetriesLeftin classDnie- Returns:
- Intentos restantes de comprobación de PIN del DNIe.
- Throws:
ApduConnectionException- Cuando hay problemas en el proceso.
-
openSecureChannelIfNotAlreadyOpened
Description copied from class:DnieEstablece y abre el canal seguro CWA-14890 si no lo estaba ya.- Overrides:
openSecureChannelIfNotAlreadyOpenedin classDnie- 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.
-
openSecureChannelIfNotAlreadyOpened
public void openSecureChannelIfNotAlreadyOpened(boolean doChv) throws CryptoCardException, PinException Description copied from class:DnieEstablece y abre el canal seguro CWA-14890 si no lo estaba ya.- Overrides:
openSecureChannelIfNotAlreadyOpenedin classDnie- 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.
-
openPinChannel
Abre y establece el canal seguro de PIN.- Returns:
- Nueva conexión establecida.
- Throws:
CryptoCardException- Si hay problemas en la apertura de canal.
-
openUserChannel
Abre y establece el canal seguro de usuario.- Returns:
- Nueva conexión establecida.
- Throws:
CryptoCardException- Si hay problemas en la apertura de canal.
-
needsPinForLoadingCerts
protected boolean needsPinForLoadingCerts()Description copied from class:DnieIndica si es necesario haber verificado o no el PIN para poder leer los certicados.- Overrides:
needsPinForLoadingCertsin classDnie- Returns:
truesi es necesario haber verificado o no el PIN para poder leer los certicados,falseen caso contrario.
-
checkSecurityObjects
public final X509Certificate[] checkSecurityObjects() throws IOException, TlvException, Asn1Exception, SignatureException, CertificateExceptionDescription copied from interface:MrtdLds1Comprueba la validez de los objetos de seguridad a partir del SOD.- Specified by:
checkSecurityObjectsin interfaceMrtdLds1- Returns:
- Cadena de certificados del firmante del SOD (para comprobación externa).
- Throws:
IOException- Si no se puede finalizar la comprobación o esta resulta en que algún objeto no pasa las validaciones.TlvException- Si el SOD del documento no es un TLV válido.Asn1Exception- Si el SOD es estructuralmente incorrecto.SignatureException- Si la firma del SOD es inválida o presenta problemas.CertificateException- Si los certificados de firma del SOD presentan problemas.
-
getCardAccess
Description copied from interface:MrtdLds1Obtiene el CardAccess.- Specified by:
getCardAccessin interfaceMrtdLds1- Returns:
- CardAccess.
- Throws:
IOException- Si no se puede leer el fichero.
-
getAtrInfo
Description copied from interface:MrtdLds1Obtiene el ATR/INFO.- Specified by:
getAtrInfoin interfaceMrtdLds1- Returns:
- ATR/INFO.
- Throws:
IOException- Si no se puede leer el fichero.
-
getDg1
Description copied from interface:MrtdLds1Obtiene el DG1 (MRZ). Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg1in interfaceMrtdLds1- Returns:
- DG1 (MRZ).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg2
Description copied from interface:MrtdLds1Obtiene el DG2 (fotografía del rostro del titular). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg2in interfaceMrtdLds1- Returns:
- DG2 (fotografía del rostro del titular).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg3
Description copied from interface:MrtdLds1Obtiene el DG3 (elementos de identificación adicionales - Dedos). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de administración esté previamente establecido.- Specified by:
getDg3in interfaceMrtdLds1- Returns:
- DG3 (elementos de identificación adicionales - Dedos).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg7
Description copied from interface:MrtdLds1Obtiene el DG7 (imagen de la firma o marca habitual exhibida). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg7in interfaceMrtdLds1- Returns:
- DG7 (imagen de la firma o marca habitual exhibida).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg11
Description copied from interface:MrtdLds1Obtiene el DG11 (detalles personales adicionales). Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg11in interfaceMrtdLds1- Returns:
- DG11 (detalles personales adicionales).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg12
Description copied from interface:MrtdLds1Obtiene el DG12 (detalles del documento adicionales). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg12in interfaceMrtdLds1- Returns:
- DG12 (detalles del documento adicionales).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg13
Description copied from interface:MrtdLds1Obtiene el DG13 (detalles opcionales). Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg13in interfaceMrtdLds1- Returns:
- DG13 (detalles opcionales).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg14
Description copied from interface:MrtdLds1Obtiene el DG14 (opciones de seguridad). Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg14in interfaceMrtdLds1- Returns:
- DG14 (opciones de seguridad).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getSod
Description copied from interface:MrtdLds1Obtiene el SOD. El SOD contiene las huellas digitales de los DG. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getSodin interfaceMrtdLds1- Returns:
- SOD.
- Throws:
IOException- Si hay problemas obteniendo el objeto.
-
getCom
Description copied from interface:MrtdLds1Obtiene el COM. El COM contiene los "datos comunes" (Common Data). Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getComin interfaceMrtdLds1- Returns:
- COM.
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getCardSecurity
Description copied from interface:MrtdLds1Obtiene el CardSecurity.- Specified by:
getCardSecurityin interfaceMrtdLds1- Returns:
- CardSecurity.
- Throws:
IOException- Si no se puede leer el fichero.
-
getDg4
Description copied from interface:MrtdLds1Obtiene el DG4 (elementos de identificación adicionales - Iris). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de administración esté previamente establecido.- Specified by:
getDg4in interfaceMrtdLds1- Returns:
- DG4 (elementos de identificación adicionales - Iris).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg5
Description copied from interface:MrtdLds1Obtiene el DG5 (retrato exhibido). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg5in interfaceMrtdLds1- Returns:
- DG5 (retrato exhibido).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg6
Description copied from interface:MrtdLds1Obtiene el DG6 (reservado para uso futuro). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg6in interfaceMrtdLds1- Returns:
- DG6 (reservado para uso futuro).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg8
Description copied from interface:MrtdLds1Obtiene el DG8 (elemento datos). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg8in interfaceMrtdLds1- Returns:
- DG7 (elemento datos).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg9
Description copied from interface:MrtdLds1Obtiene el DG9 (elemento estructura). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg9in interfaceMrtdLds1- Returns:
- DG9 (elemento estructura).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg10
Description copied from interface:MrtdLds1Obtiene el DG10 (elemento sustancia). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg10in interfaceMrtdLds1- Returns:
- DG10 (elemento sustancia).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg15
Description copied from interface:MrtdLds1Obtiene el DG15 (información de clave pública de autenticación activa). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg15in interfaceMrtdLds1- Returns:
- DG15 (información de clave pública de autenticación activa).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDg16
Description copied from interface:MrtdLds1Obtiene el DG16 (personas que han de notificarse). Devuelve el objeto binario sin tratar. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDg16in interfaceMrtdLds1- Returns:
- DG16 (personas que han de notificarse).
- Throws:
IOException- Si hay problemas leyendo el fichero.
-
getDir
Description copied from interface:MrtdLds1Obtiene el DIR. Puede necesitar que el canal de usuario esté previamente establecido.- Specified by:
getDirin interfaceMrtdLds1- Returns:
- DIR.
- Throws:
IOException- Si hay problemas leyendo el fichero.
-