ATLAS MANUAL DE INTEGRACIÓN

Transcripción

1 ATLAS MANUAL DE INTEGRACIÓN Servicios de Firma AFC Certificado Versión 1.1 Arquitectura de Software

2 Hoja de Control Título Documento de Referencia Responsable Servicios de Firma AFC Certificado NORMATIVA ATLAS Arquitectura de Software Versión 1.1 Fecha Versión 15/01/2016 Registro de Cambios Versión Causa del Cambio Responsable del Cambio Fecha del Cambio 1.0 Versión inicial del documento Área de Soluciones, Aplicaciones Especiales y Arquitectura de Software 31/08/ Se agrega nuevo librería crypt-lib Área de Soluciones, Aplicaciones Especiales y Arquitectura de Software 13/11/ de 13

3 Índice 1. INTRODUCCIÓN AUDIENCIA OBJETIVO DESCRIPCIÓN INSTALACION Y CONFIGURACION ALTA EN AFC CONFIGURACION Configuracion de acceso a AFC INSTALACION Paso 1: Añadir la dependencia al módulo de Encryptación de atlas Paso 2: Actualizar la configuración de Spring Paso 3: Inyectar el Servicio en las clases que lo requieran USO ESTADO DEL CERTIFICADO DATOS DEL CERTIFICADO ENLACES RELACIONADOS de 13

4 1. INTRODUCCIÓN AFC es la solución de firma centralizada para las aplicaciones de la Comunidad de Madrid. Objetivos buscados: Operativo de firma similar y centralizada. Formatos comunes de firma compatibles con ENI (Esquema Nacional de Interoperabilidad) Simplificar la integración de requisitos de firma en los desarrollos. Transparencia en las actualizaciones de la plataforma de firma Inventario de aplicaciones y tipos de firmas Histórico y estadísticas de operaciones realizadas Operaciones que permite: Firma digital en cliente Firma digital en servidor Validación de firmas Comprobación de certificados Tipos de firma (Admitidos por el ENI) PADES Pdf Adavanced Electronic Signatures XADES - Xml Adavanced Electronic Signatures CADES CMS Advanced Electronic Signatures Integración: La integración con la solucion de AFC se realiza a través de la librería del Framework Atlas atlasfrm_eadm (librería que conecta con los servicios de administración electrónica) hasta la versión del framework y la librería atlasfrm_crypt a partir de la versión Esta librería puede ser utilizada tanto por aplicaciones desarrolladas con el framework Atlas así como las desarrolladas con otros frameworks Java (framework 2 o framework Justicia). Dentro de esta librería podemos encontrar dos servicios: AfcOpeClienteService: Servicio de Operaciones en cliente AfcOpeServidorService: Servicio de Operacion en servidor AfcOpeCertificadoService: Servicio de operaciones con certificados Este documento describe el servicio de afc para operaciones con certificados. Si se va a utilizar desde una aplicación que no es del framework ATLAS consultar el manual FW2_MUS_Integracion_AFC Audiencia objetivo 4 de 13

5 Este documento está orientado a desarrolladores java que necesiten realizar operaciones con certificados 2. DESCRIPCIÓN Las operaciones que el servicio de AFC ofrece con certificados son: estadocertificado Comprueba el estado del certificado datoscertificado Devuelve los datos del certificado 3. INSTALACION Y CONFIGURACION 3.1. ALTA EN AFC Antes de utilizar el servicio de AFC en desarrollo es necesario autorizar a la aplicación. Las peticiones de autorización de uso del servicio AFC se dirigirán a través del servicio Remedy al grupo GC.AE. Para firma en servidor es necesario indicar en la petición los siguientes datos: Aplicación: Código poaps del proyecto Nombre del módulo técnico: Nombre del modulo tecnico que se va a integrar con AFC. Este valor será el que se informará en el fichero de configuración de la aplicación en la propiedad afc.modulo. Descripción uso: Breve descripción del uso que se requiere del servicio AFC Entorno: Entorno donde se requiere la autorización Login administrador: Usuario con el que acceder al entorno AFC para la administración de documentos Para cada tipo de documento a firmar - Nombre del tipo de documento - Formato: XADES, PADES o CADES - Firma Sincrona o asincrona - Firma visible o no: Por defecto No - En caso de firma visible: o Fuente: Por defecto Arial 8 o ubicación de la firma.(coordenadas) - Nombre de la operación de firma en ASF: Por defecto FIRMA_SIMPLE - Alias del sello de organo con el que se va a firmar: En desarrollo por defecto 5M. Una vez que se autorice su uso se recibirá una password (diferente para cada entorno) que habrá que informar en el fichero de configuración en la variable afc.password. 5 de 13

6 3.2. CONFIGURACION Configuracion de acceso a AFC La información de acceso, así como las configuraciónes de firma se definirán en el fichero de configuración mediante las siguientes variables (el nombre de estas variables es igual para todos los frameworks): Variable Descripción Obligatorio afc.modulo afc.password Nombre del módulo para autenticarse contra el servicio de ASF. Se corresponde con el nombre dado de alta en el Servicio de ASF. Contraseña de acceso, debe estar cifrada. Esta contraseña se proporciona cuando se solicita el acceso al Servicio de AFC. SI SI A continuación se muestra un ejemplo de configuración. Ejemplo de configuracion # Configuracion de acceso a AFC afc.modulo=ejpl_app afc.password=07d818957a3fa a836732cd6bc23c0008f520e3c9642fd06cce762eac 3.3. INSTALACION El Servicio AfcOpCertificadoService viene incluido en el módulo de Encryptación de Atlas. Para poder utilizarlo, bastará con incluir la dependencia de este módulo en el fichero pom.xml del proyecto Paso 1: Añadir la dependencia al módulo de Encryptación de atlas Para añadir la dependencia al módulo de Encriptación (crypt-lib) dentro de nuestro proyecto maven hay que añadir una entrada dependency en la sección dependencies del fichero pom.xml del proyecto, como se puede ver en el siguiente ejemplo: 6 de 13

7 <dependencies> pom.xml <dependency> <groupid>atlasfrm</groupid> <artifactid>atlasfrm-crypt-lib</artifactid> <version>${atlasfrm-crypt-lib.version}</version> </dependency> </dependencies> Paso 2: Actualizar la configuración de Spring Es necesario importar la configuración de Spring para los servicios de la librería crypt dentro del fichero applicationcontext-services.xml. applicationcontext-services.xml <import resource="classpath:/conf/applicationcontext-crypt-lib.xml" /> Paso 3: Inyectar el Servicio en las clases que lo requieran Para inyectar el Servicio previamente definido, se pasa como property al bean que lo vaya a usar, que debe tener el método set correspondiente. Para más información sobre cómo inyectar referencias, se puede consultar la documentación de Spring. applicationcontext-services.xml <bean id="miservice" class="xxxx.services.miserviceimpl" p:afcopservidorservice-ref=" afcopcertificadoservice"/> xxxx.services.miserviceimpl.java public class MiServiceImpl implements MiService { private AfcOpCertificadoService afcopcertificadoservice; } public void set AfcOpCertificadoService (AfcOpCertificadoService servicio) { this.afcopcertificadoservice = servicio; }... 7 de 13

8 4. USO Una vez configurado y inyectado el servicio se puede proceder a utilizar todas las funcionalidades que ofrece ESTADO DEL CERTIFICADO Para comprobar el estado del certificado, se utiliza el método estadocertificado(string certbase64) AfcOpCertificadoService.java * Solicita a AFC el estado del certificado * String certificado en base 64 AfcDatosCertificado con el estado del certificado ServiceException si hubo problemas <E extends Serializable> AfcDatosCertificado estadocertificado(string certificadobase64) throws ServiceException; Ejemplo de obtención de estado del certificado public void obtenerestadocertificado(string certificadobase64introducido) throws Exception{ AfcDatosCertificado datoscertificado = afcservice.estadocertificado(certificadobase64introducido); } Uso de clase de dominio AfcDatosCertificado para la obtención del estado: AfcDatosCertificado 8 de 13

9 public class AfcDatosCertificado extends DatosCertificado { private static final long serialversionuid = L; * Variable utilizada por afcopcertificadoservice, indica el * código de estado del certificado, Por ejemplo: 0 si el certificado es * correcto * private Integer codigoestado; * Variable utilizada por afcopcertificadoservice, indica el * status del certificado, Por ejemplo: STATUS_GOOD * * private String codigostatuscertificado; * Variable utilizada por afcopcertificadoservice, indica el * mensaje del estado del certificado, Por ejemplo: Certificado OK private String mensajeestadocert; 4.2. DATOS DEL CERTIFICADO Para obtener los datos del certificado, se utiliza el método datoscertificado(string certbase64); AfcOpCertificadoService.java * Solicita a AFC el estado del certificado * String certificado en base 64 AfcDatosCertificado con el estado del certificado ServiceException si hubo problemas <E extends Serializable> AfcDatosCertificado estadocertificado(string certificadobase64) throws ServiceException; Ejemplo de obtención de datos del certificado 9 de 13

10 public void obtenerdatoscertificado(string certificadobase64introducido) throws Exception{ AfcDatosCertificado datoscertificado = afcservice.datoscertificado(certificadobase64introducido); } AfcDatosCertificado 10 de 13

11 public class AfcDatosCertificado extends DatosCertificado { private static final long serialversionuid = L; * Nombre completo del propietario del certificado private String nombrecompleto; * Nombre de persona Física private String phisname; * NIF de persona Física private String phisnif; * Nombre de persona Jurídica private String judname; * CIF de persona Jurídica private String judcif; * Serial del certificado private String serial; * del certificado private String ; * nombre cd la entidad emisora del certificado private String cacommonname; * Tipo de certificado private String tipocert; * Certificado private String cert; 11 de 13

12 Continua: AfcDatosCertificado public class AfcDatosCertificado extends DatosCertificado { private static final long serialversionuid = L; * Mapa de extensiones del certificado private Map<String, String> extensiones; Nombre * private String nombre; Apellido 1* private String apellido1; Apellido 2* private String apellido2; CommonName * private String commonname; private String fullname; 12 de 13

13 5. ENLACES RELACIONADOS Producto Axis2 Certificados ICM Descarga certificados de prueba URL de 13