es.accv.arangi.certificate

Class CertificateFactory

java.lang.Object

es.accv.arangi.certificate.CertificateFactory

public class CertificateFactory
extends java.lang.Object

Los diferentes certificados que implementan la clase es.accv.arangi.base.certificate registran sus políticas en esta clase, de forma que cuando se llama al método getInstance pasándole un certificado x.509v3 la clase devolverá un objeto que se adecúe a la política del certificado pasado.

Ejemplo de uso:

X509Certificate x509Certificate = Util.getCertificate(new File ("/certificates/cert.cer"));
ValidateCertificate cert = CertificateFactory.getInstance(x509Certificate);
if (cert instanceof CertificadoCiudadano) {
CertificadoCiudadano cCiudadano = (CertificadoCiudadano) cert;
System.out.println ("Nombre ciudadano: " + cCiudadano.getName());
}

En ciertas situaciones se quiere trabajar con certificados de algún otro prestador y sería deseable que las llamadas al método getInstance() pudiesen devolver clases que tratasen la información contenida en estos certificados. Los pasos a seguir son los siguientes:

1. Programar la clase que trate con la información del nuevo tipo de certificado. Dicha clase ha de ser hija de ValidateCertificate o de alguno de las clases para certificados de Arangí. Debe contener un constructor con un parámetro de tipo CertificadoDesconocido. Hay un ejemplo más abajo.
2. Crear un paquete es.accv.arangi.ext.certificate y en él generar un fichero llamado certificates.properties. En dicho archivo de propiedades se pueden asociar políticas de certificados con las clases que se quiere utilizar para tratarlos.
3. Llamar a los métodos getInstance() con un CAList que contenga los certificados de la cadena de confianza del nuevo tipo de certificado.

Ejemplo de la clase:

public class CertificadoPrueba extends CertificadoPersona {

public CertificadoPrueba (CertificadoDesconocido certificado) throws CertificateCANotFoundException, NormalizeCertificateException {
super(certificado.toX509Certificate(), certificado.getCertificationChainAsCAList());
}
...

Ejemplo de propiedad:

1.3.6.1.4.1.17345.10.1=es.accv.arangi.ext.certificate.CertificadoPrueba

Author:

José M Gutiérrez

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EXTRA_CERTIFICATES_PROPERTIES_PATH Constante con el path dentro del classpath al fichero de propiedades con la información de certificados que no existen en Arangí.

Constructor Summary

Constructors

Constructor and Description
CertificateFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addCertificateTypes(java.lang.String[] policies, java.lang.Class certificateClass) Método al que llamarán los distintos certificados para registrarse
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(byte[] bCertificate) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(byte[] bCertificate, es.accv.arangi.base.certificate.validation.CAList caList) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(es.accv.arangi.base.certificate.Certificate certificate) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(es.accv.arangi.base.certificate.Certificate certificate, es.accv.arangi.base.certificate.validation.CAList caList) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(java.io.File certificateFile) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(java.io.File certificateFile, es.accv.arangi.base.certificate.validation.CAList caList) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(java.io.InputStream isCertificate) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(java.io.InputStream isCertificate, es.accv.arangi.base.certificate.validation.CAList caList) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(java.security.cert.X509Certificate x509Certificate) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.
static es.accv.arangi.base.certificate.validation.ValidateCertificate	getInstance(java.security.cert.X509Certificate x509Certificate, es.accv.arangi.base.certificate.validation.CAList caList) Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EXTRA_CERTIFICATES_PROPERTIES_PATH

public static final java.lang.String EXTRA_CERTIFICATES_PROPERTIES_PATH

Constante con el path dentro del classpath al fichero de propiedades con la información de certificados que no existen en Arangí.

See Also:

Constant Field Values

Constructor Detail

CertificateFactory

public CertificateFactory()

Method Detail

addCertificateTypes

public static void addCertificateTypes(java.lang.String[] policies,
                       java.lang.Class certificateClass)

Método al que llamarán los distintos certificados para registrarse

Parameters:

policies - Políticas de los certificados

certificateClass - Clase del certificado (ha de ser una subclase de es.accv.arangi.base.certificate.Certificate)

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(java.io.File certificateFile)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException,
                                                                                         java.io.FileNotFoundException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Sólo busca las clases asociadas a los tipos de certificado definidos en la librería Arangí.

Parameters:

certificateFile - Fichero que contiene un certificado en formato X.509v3

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

java.io.FileNotFoundException - El fichero no existe

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(java.io.InputStream isCertificate)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Sólo busca las clases asociadas a los tipos de certificado definidos en la librería Arangí.

Parameters:

isCertificate - Stream de lectua a un certificado en formato X.509v3

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(byte[] bCertificate)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Sólo busca las clases asociadas a los tipos de certificado definidos en la librería Arangí.

Parameters:

bCertificate - Array de bytes de un certificado en formato X.509v3

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(java.security.cert.X509Certificate x509Certificate)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Sólo busca las clases asociadas a los tipos de certificado definidos en la librería Arangí.

Parameters:

x509Certificate - Certificado en formato X.509

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(es.accv.arangi.base.certificate.Certificate certificate)

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Sólo busca las clases asociadas a los tipos de certificado definidos en la librería Arangí.

Parameters:

certificate - Certificado en formato X.509

Returns:

Instancia de certificado

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(java.io.File certificateFile,
                                                                         es.accv.arangi.base.certificate.validation.CAList caList)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException,
                                                                                         java.io.FileNotFoundException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Busca en primer lugar en las clases asociadas a los tipos de certificado definidos en la librería Arangí. Si no encuentra una clase que trate con el tipo de certificado buscará según lo indicado en el javadoc inicial de esta clase.

Parameters:

certificateFile - Fichero que contiene un certificado en formato X.509v3

caList - Lista de certificados de CA

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

java.io.FileNotFoundException - El fichero no existe

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(java.io.InputStream isCertificate,
                                                                         es.accv.arangi.base.certificate.validation.CAList caList)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Busca en primer lugar en las clases asociadas a los tipos de certificado definidos en la librería Arangí. Si no encuentra una clase que trate con el tipo de certificado buscará según lo indicado en el javadoc inicial de esta clase.

Parameters:

isCertificate - Stream de lectura a un certificado en formato X.509v3

caList - Lista de certificados de CA

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(byte[] bCertificate,
                                                                         es.accv.arangi.base.certificate.validation.CAList caList)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Busca en primer lugar en las clases asociadas a los tipos de certificado definidos en la librería Arangí. Si no encuentra una clase que trate con el tipo de certificado buscará según lo indicado en el javadoc inicial de esta clase.

Parameters:

bCertificate - Array de bytes de un certificado en formato X.509v3

caList - Lista de certificados de CA

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(java.security.cert.X509Certificate x509Certificate,
                                                                         es.accv.arangi.base.certificate.validation.CAList caList)
                                                                                  throws es.accv.arangi.base.exception.certificate.NormalizeCertificateException

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Busca en primer lugar en las clases asociadas a los tipos de certificado definidos en la librería Arangí. Si no encuentra una clase que trate con el tipo de certificado buscará según lo indicado en el javadoc inicial de esta clase.

Parameters:

x509Certificate - Certificado en formato X.509

caList - Lista de certificados de CA

Returns:

Instancia de certificado

Throws:

es.accv.arangi.base.exception.certificate.NormalizeCertificateException - El certificado no puede ser normalizado al formato del proveedor criptográfico de Arangi

getInstance

public static es.accv.arangi.base.certificate.validation.ValidateCertificate getInstance(es.accv.arangi.base.certificate.Certificate certificate,
                                                                         es.accv.arangi.base.certificate.validation.CAList caList)

Obtiene una instancia certificado en base a la política del certificado que se le pasa como parámetro. Busca en primer lugar en las clases asociadas a los tipos de certificado definidos en la librería Arangí. Si no encuentra una clase que trate con el tipo de certificado buscará según lo indicado en el javadoc inicial de esta clase.

Parameters:

certificate - Certificado en formato X.509

caList - Lista de certificados de CA

Returns:

Instancia de certificado