Class Dnie

    • Field Detail

      • ERROR_PIN_SW1

        private static final byte ERROR_PIN_SW1
        Octeto que identifica una verificación fallida del PIN.
        See Also:
        Constant Field Values
      • CERT_ICC_FILE_ID

        private static final byte[] CERT_ICC_FILE_ID
        Identificador del fichero del certificado de componente del DNIe.
      • MASTER_FILE_NAME

        private static final java.lang.String MASTER_FILE_NAME
        Nombre del Master File del DNIe.
        See Also:
        Constant Field Values
      • CDF_LOCATION

        private static final Location CDF_LOCATION
        Localización del CDF PKCS#15.
      • PRKDF_LOCATION

        private static final Location PRKDF_LOCATION
        Localización del PrKDF PKCS#15.
      • IDESP_LOCATION

        private static final Location IDESP_LOCATION
        Localización del EF IDESP.
      • aliases

        private final java.util.Set<java.lang.String> aliases
      • certs

        private final java.util.Map<java.lang.String,​java.security.cert.X509Certificate> certs
        Certificados de la tarjeta indexados por su alias.
      • aliasByCertAndKeyId

        private final java.util.Map<java.lang.String,​java.lang.String> aliasByCertAndKeyId
        Alias de los certificados de la tarjeta indexados por el identificador interno del certificado (pasado de byte[] a String).
      • keyReferences

        private final java.util.Map<java.lang.String,​DniePrivateKeyReference> keyReferences
        Referencias a las claves privadas de la tarjeta indexadas por el alias de su certificado asociado.
      • cryptoHelper

        private final CryptoHelper cryptoHelper
        Manejador de funciones criptográficas.
      • rawConnection

        protected ApduConnection rawConnection
        Conexión inicial con la tarjeta, sin ningún canal seguro.
      • passwordCallback

        private javax.security.auth.callback.PasswordCallback passwordCallback
      • callbackHandler

        private javax.security.auth.callback.CallbackHandler callbackHandler
    • Constructor Detail

      • Dnie

        protected Dnie​(ApduConnection conn,
                       javax.security.auth.callback.PasswordCallback pwc,
                       CryptoHelper cryptoHlpr,
                       javax.security.auth.callback.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 Detail

      • getCryptoHelper

        protected final CryptoHelper getCryptoHelper()
        Obtiene la clase con funcionalidades de base de criptografía.
        Returns:
        Clase con funcionalidades de base de criptografía.
      • getPasswordCallback

        protected final javax.security.auth.callback.PasswordCallback getPasswordCallback()
        Obtiene la PasswordCallback.
        Returns:
        PasswordCallback.
      • getCwa14890PublicConstants

        protected Cwa14890PublicConstants 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

        protected Cwa14890PrivateConstants 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,
                                            java.lang.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,
                                     java.lang.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

        protected javax.security.auth.callback.PasswordCallback getInternalPasswordCallback()
                                                                                     throws PinException
        Obtiene la PasswordCallback predefinida.
        Returns:
        PasswordCallback predefinida.
        Throws:
        BadPinException - Si el PasswordCallback devuelve un PIN nulo o vacío.
        PasswordCallbackNotFoundException - Si no hay una PasswordCallback definida.
        PinException
      • getPinMessage

        protected java.lang.String getPinMessage​(int retriesLeft)
        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:
        true si el canal CWA-14890 está abierto, false en caso contrario.
      • needsPinForLoadingCerts

        protected boolean needsPinForLoadingCerts()
        Indica si es necesario haber verificado o no el PIN para poder leer los certicados.
        Returns:
        true si es necesario haber verificado o no el PIN para poder leer los certicados, false en caso contrario.
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
      • getAliases

        public final java.lang.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 final java.security.cert.X509Certificate getCertificate​(java.lang.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.
      • verifyIcc

        public final void verifyIcc()
        Description copied from interface: Cwa14890Card
        Verifica el certificado de componente de la tarjeta.
        Specified by:
        verifyIcc in interface Cwa14890Card
      • getIccCertPublicKey

        public final java.security.interfaces.RSAPublicKey getIccCertPublicKey()
                                                                        throws java.io.IOException
        Description copied from interface: Cwa14890Card
        Recupera la clave pública del certificado de componente.
        Specified by:
        getIccCertPublicKey in interface Cwa14890Card
        Returns:
        Clave pública del certificado de componente.
        Throws:
        java.io.IOException - Cuando ocurre algún problema en la selección y lectura del certificado
      • getRefIccPrivateKey

        public final byte[] getRefIccPrivateKey​(Cwa14890PublicConstants consts)
        Description copied from interface: Cwa14890Card
        Recupera la referencia a la clave privada del certificado de componente.
        Specified by:
        getRefIccPrivateKey in interface Cwa14890Card
        Parameters:
        consts - Clase de claves.
        Returns:
        Referencia a clave privada
      • getChrCCvIfd

        public final byte[] getChrCCvIfd​(Cwa14890PublicConstants consts)
        Description copied from interface: Cwa14890Card
        Recupera el CHR de la clave pública del certificado de terminal.
        Specified by:
        getChrCCvIfd in interface Cwa14890Card
        Parameters:
        consts - Clase de claves.
        Returns:
        Referencia a clave pública
      • getIfdPrivateKey

        public final java.security.interfaces.RSAPrivateKey getIfdPrivateKey​(Cwa14890PrivateConstants consts)
        Description copied from interface: Cwa14890Card
        Recupera la clave privada del certificado de componente del terminal.
        Specified by:
        getIfdPrivateKey in interface Cwa14890Card
        Parameters:
        consts - Clase de claves privadas.
        Returns:
        Clave privada.
      • setKeysToAuthentication

        public final void setKeysToAuthentication​(byte[] refPublicKey,
                                                  byte[] refPrivateKey)
                                           throws ApduConnectionException
        Description copied from interface: Cwa14890Card
        Establece una clave pública y otra privada para la autenticación. interna y externa de la tarjeta.
        Specified by:
        setKeysToAuthentication in interface Cwa14890Card
        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: Cwa14890Card
        Obtiene el mensaje de autenticación interna de la tarjeta.
        Specified by:
        getInternalAuthenticateMessage in interface Cwa14890Card
        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: Cwa14890Card
        Envia el mensaje de autenticación externa.
        Specified by:
        externalAuthentication in interface Cwa14890Card
        Parameters:
        extAuthenticationData - Mensaje de autenticación externa.
        Returns:
        true si la autenticación finalizó correctamente, false en caso contrario.
        Throws:
        ApduConnectionException - Cuando ocurre un error en la comunicación con la tarjeta.
      • getPrivateKey

        public final PrivateKeyReference getPrivateKey​(java.lang.String alias)
        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
      • sign

        public byte[] sign​(byte[] data,
                           java.lang.String signAlgorithm,
                           PrivateKeyReference privateKeyReference)
                    throws CryptoCardException,
                           PinException
        Description copied from interface: CryptoCard
        Realiza una firma electrónica.
        Specified by:
        sign in interface CryptoCard
        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.
        AuthenticationModeLockedException - Cuando la tarjeta está bloqueada.
        PinException - Si el PIN proporcionado es incorrecto o no es posible obtenerlo.
      • verifyPin

        public final void verifyPin​(javax.security.auth.callback.PasswordCallback psc)
                             throws ApduConnectionException,
                                    PinException
        Description copied from class: AbstractIso7816FourCard
        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 de RuntimeException o una ApduConnectionException.
        Specified by:
        verifyPin in class AbstractIso7816FourCard
        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.
        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).
      • getIfdKeyLength

        public final int getIfdKeyLength​(Cwa14890PublicConstants consts)
        Description copied from interface: Cwa14890Card
        Obtiene la longitud, en octetos, de las claves RSA del certificado de comnponente del terminal.
        Specified by:
        getIfdKeyLength in interface Cwa14890Card
        Parameters:
        consts - Clase de claves.
        Returns:
        Longitud, en octetos, de las claves RSA del certificado de comnponente del terminal.
      • openSecureChannelIfNotAlreadyOpened

        public void openSecureChannelIfNotAlreadyOpened​(boolean doChv)
                                                 throws CryptoCardException,
                                                        PinException
        Establece y abre el canal seguro CWA-14890 si no lo estaba ya.
        Parameters:
        doChv - true si la apertura de canal seguro debe incluir la verificación de PIN, false si 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

        public int getPinRetriesLeft()
                              throws ApduConnectionException
        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​(java.lang.String oldPin,
                                      java.lang.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

        public final void setCallbackHandler​(javax.security.auth.callback.CallbackHandler handler)
        Asigna un CallbackHandler a la tarjeta.
        Parameters:
        handler - CallbackHandler a asignar.
      • setPasswordCallback

        public final void setPasswordCallback​(javax.security.auth.callback.PasswordCallback pwc)
        Asigna un PasswordCallback a la tarjeta.
        Parameters:
        pwc - PasswordCallback a asignar.
      • getIdesp

        public java.lang.String getIdesp()
                                  throws Iso7816FourCardException,
                                         java.io.IOException
        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.
        java.io.IOException - Si no se puede conectar con la tarjeta.
      • 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.