Informes de Firma
Portafirma-CSV
Documento n: TGS-ANF-009302-CHG-Analisis-Funcionall
Revisin: 003
Fecha: 28-05-2013
Perodo de retencin: Permanente durante su perodo de vigencia + 3 aos despus de su anulacin
TELVENT 1 de 36 28-05-2013
Anlisis Funcional Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
REALIZADO
28-05-2013 Manuel Enrique
Garca
Ramos
Analista Firma
Electrnica
COMPROBADO
28-05-2013 Isabel
Mrquez
Contreras
Jefe de Proyecto
APROBADO
29-05-2013
TELVENT 2 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
CONTROL DE MODIFICACIONES
Documento n: TGS-ANF-009302-CHG-Analisis-Funcionall
Revisin: 003
Fecha: 28-05-2013
Rev. 001
Fecha 20-05-2013
Autor/es MEGR
Descripcin Documento inicial
Rev. 002
Fecha 24-05-2013
Autor/es MEGR
Descripcin Documento revisado tras la reunin de revisin del anlisis funcional.
Rev. 003
Fecha 28-05-2013
Autor/es MEGR
Descripcin Documento final para su aprobacin.
TELVENT 3 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
CONTROL DE DISTRIBUCIN
Documento n: TGS-ANF-009302-CHG-Analisis-Funcionall
Revisin: 003
Fecha: 28-05-2013
Este documento pertenece a Telvent Interactiva y posee un carcter de PBLICO para uso y distribucin en
el Departamento de Firma Electrnica, segn se recoge en la declaracin de privacidad.
Declaracin de privacidad:
El contenido de este documento est clasificado como restringido y no debe ser distribuido, copiado,
modificado o reproducido, total o parcialmente, de forma alguna sin consentimiento expreso.
La distribucin de ste documento queda restringida a lo especificado dentro del control de distribucin, ya
sea de forma electrnica o papel. Cualquier contenido distribuido fuera del contexto definido ser
responsabilidad de los usuarios de informacin.
Copias Electrnicas:
TELVENT 4 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Copias en Papel:
La vigencia de las copias impresas en papel est condicionada a la coincidencia de su estado de revisin con
el que aparece en el sistema electrnico de distribucin de documentos.
El control de distribucin de copias en papel para su uso en proyectos u otras aplicaciones es responsabilidad
de los usuarios del sistema electrnico de informacin.
Distribucin en Papel:
TELVENT 5 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
ndice
1 Objeto......................................................................................................................................................... 7
2 Alcance ...................................................................................................................................................... 7
6 Introduccin ............................................................................................................................................... 9
8 Casos de uso............................................................................................................................................. 22
12 Anexos ..................................................................................................................................................... 34
TELVENT 6 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
1 Objeto
Este documento pretende definir los requisitos asociados a la nueva plataforma a desarrollar en la Confederacin
Hidrogrfica del Guadalquivir (a partir de ahora, CHG) para la obtencin de cdigos seguros de verificacin, en
adelante CSV, e informes de firma electrnica.
2 Alcance
Partiendo de esta situacin actual, done ya se instaur el uso de port@firma, el nuevo sistema permitir la
generacin de estos justificantes de firma e identificar las firmas de documentos inequvocamente mediante el
uso de los CSV.
Para la generacin de informes de firma, nuestro sistema deber realizar una integracin con el sistema e-Visor,
que ser instalado como nuevo subsistema en CHG. El software de e-Visor permite configurar plantillas para la
generacin de justificantes de firma.
3 Siglas y acrnimos
AD Active Directory
BD Base de Datos
CDI Contexts and Dependency Injection
CHG Confederacin Hidrogrfica del Guadalquivir
CSV Cdigo Seguro de Verificacin
CVE Cdigo de Verificacin Electrnica
MIME Multipurpose Internet Mail Extensions
MINHAP Ministerio de Hacienda y Administraciones Pblicas
MVC Modelo, Vista, Controlador
TGS Telvent Global Service
TSA Time Stamping Authority
WS Web Services
WSDL Web Service Definition Language
XSLT Extensible Stylesheet Language Transformations
TELVENT 7 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
5 Documentos de Referencia
[Port@FirmaCSV-REQ] TGS-REQ-009302-CHG-Requisitos-rev002, Anlisis de Requisitos del Sistema
de Generacin de CSV e Informes de Firma
TELVENT 8 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
6 Introduccin
Debido a la evolucin de la administracin electrnica, impulsada por la Ley 11/2007, de acceso electrnico de
los ciudadanos a los Servicios Pblicos (LAECSP en adelante), la firma electrnica de documentos para los
procedimientos administrativos es una herramienta esencial para todos los organismos que requieren el uso de
documentos con validez contractual con las partes firmantes.
Actualmente este ltimo proceso no est disponible en CHG, lo que lleva a la necesidad de construir un sistema
que permita dar cobertura a los aspectos de la LAECSP que hacen referencia al uso de justificantes de firma
electrnica. Los objetivos principales a cumplir por el nuevo sistema son:
Aportar la funcionalidad de Cdigos Seguros de Verificacin (en adelante CSV). El CSV permiten una
correlacin entre los documentos firmados y la localizacin del original electrnico.
Generar informes de firma que introduzcan en el pie de pgina los datos de localizacin y componente
web de validacin asociado como parte de la informacin de la firma incrustada en el informe.
TELVENT 9 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
7 Arquitectura Funcional
En este apartado mostramos la arquitectura del sistema, desde el punto de vista funcional, en el momento actual.
La arquitectura del sistema deseada y la aproximacin a esta solucin propuesta.
El sistema actual se compone con el acceso a Port@firma de los usuarios de CHG para realizar solicitud de
procesos de firma de documentos, aceptar o rechazar los procesos y en caso de necesidad de realizar una firma se
comunicar con la plataforma @Firma del Ministerio de Hacienda y Administraciones Pblicas (en adelante
MINHAP):
Al contar con infraestructura suficiente, se requiere la ampliacin de este sistema para incorporar los elementos
necesarios que permitan cumplir con los objetivos de la Ley 11/2007 referentes a los documentos originales
electrnicos.
Se requiere de un sistema capaz de generar CSV integrado con Port@firma. Este cdigo se obtiene cada vez que
se realiza una firma de documentos en Port@firma de manera automtica mediante la implementacin de una
capa de servicios web llamada EEUTIL.
Para cubrir esta necesidad se implantar el nuevo sistema Port@firma-CSV, que implementar los servicios web
de EEUTIL para la obtencin del CSV.
TELVENT 10 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
El sistema tambin deber generar informes de firma para los documentos firmados desde Port@firma que
tengan asignado un CSV. Para generar los informes se har uso de un nuevo sistema que se implantara en CHG
llamado eVisor. Es un Sistema de Informacin que permite la generacin de informes de firma mediante la
aplicacin de plantillas definidas en el sistema, presentando la firma de una forma legible y similar a la
manuscrita.
La integracin con eVisor se realiza por medio de WS, por lo que el sistema Port@firma-CSV deber
implementar el servicio de comunicacin con eVisor para la generacin de informes de firma. Esta
comunicacin se realizar usando Integr@ 1.2.1, que es el componente distribuido por el MINHAP para la
integracin con los servicios de la plataforma @Firma.
Con la inclusin de eVisor y el nuevo sistema a desarrollar Port@firma-CSV, la arquitectura del sistema
quedara de la siguiente manera:
Intranet de Confederacin
Hidrogrfica del Guadalquivir
Plataforma
@Firma
Usuario
Autorizado
CSV
El sistema Port@firma-CSV tiene como principal funcin hacer de pasarela entre Port@firma y eVisor.
Respondera a las peticiones generadas desde Port@firma generando los datos necesarios dependiendo de si
solicito obtener un CSV o un informe de firma.
Otra de las funciones que debe cumplir el nuevo sistema Port@firma-CSV es la de disponer de un componente
web que se integrar en el portal de usuarios de CHG para obtener los justificantes de firma por medio de los
cdigos CSV mostrados en los justificantes de firma de los documentos.
La arquitectura del sistema Port@firma-CSV Consulta de Informes de firma, estar orientada al desarrollo
actual de tecnologas cliente servidor para el marco tecnolgico existente. Esta arquitectura estar basada en el
patrn MVC:
TELVENT 11 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
El MVC es un patrn de arquitectura hardware que separa los datos de una aplicacin, la interfaz de usuario y la
lgica de negocio en tres componentes distintos:
Vista: Este presenta el modelo en un formato adecuado para interactuar, usualmente la interfaz de
usuario.
Controlador: Este responde a eventos, usualmente acciones del usuario, e invoca peticiones al
modelo y, probablemente, a la vista.
El flujo que seguira una peticin desde que el usuario realiza una accin hasta que sta se produce y se reflejan
los cambios sera el siguiente:
1. El usuario interacta con la interfaz de usuario de alguna forma (por ejemplo, el usuario pulsa un
botn, enlace, etc.)
TELVENT 12 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
4. El controlador delega a los objetos de la vista la tarea de desplegar la interfaz de usuario. La vista
obtiene sus datos del modelo para generar la interfaz apropiada para el usuario donde se reflejan los
cambios en el modelo (por ejemplo, se da de baja un Usuario). El modelo no debe tener conocimiento
directo sobre la vista.
La interfaz de usuario espera nuevas interacciones del usuario, comenzando el ciclo nuevamente.
Los usuarios que realizarn peticiones a nuestro sistema pertenecen a dos grupos diferentes:
Sistema Port@firma: Las peticiones desde port@firma se realizarn mediante la integracin de los
servicios web de EEUTIL (implementados con Metro).
Usuarios de CHG: Los usuarios de CHG tendrn acceso a la interfaz de consulta de informes previa
comprobacin de sus credenciales en Active Directory.
Para hacer posible la arquitectura del sistema deseada, seguiremos un desarrollo modular del Sistema. Esta
divisin en mdulos persigue dos objetivos primordiales, por un lado independizar las interfaces de los servicios
web de acceso desde Port@firma, y por otro lado evitar la duplicidad de cdigo, optimizacin de recursos del
sistema y facilitar el mantenimiento del conjunto global del sistema.
A continuacin se muestra la descomposicin del sistema en los diversos elementos que se requieren para su
implementacin, contando con varios submdulos representados en la siguiente imagen:
TELVENT 13 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Mdulo Persistencia
Oracle 10g
Hibernate 4
Modelo de
Datos
Transaccional JPA 2.0
CDI Metro
Mdulo Web Consulta
JSF 2.1
Integr@
Core 1.2.1
RichFaces 4
Podemos apreciar los mdulos vinculados a los elementos principales de la arquitectura del sistema:
- Mdulo Web Service EEUTIL: Desarrollado con Metro, creado por Sun, el servicio web
implementar el conjunto de servicios EEUTIL de Port@firma para realizar las peticiones de CSV e
informes de firma.
- Mdulo Web Service eVisor: Se usar la herramienta de integracin de servicios del MINHAP,
Integr@ 2.1.2, que implementar los servicios de comunicacin con eVisor para realizar las peticiones
de generacin de los documentos de informes de firma.
- Mdulo de Web de Consulta: Ser el mdulo web desplegado como aplicacin para el acceso de
los usuarios que quieran validar las copias de informes de firma con los cdigos CVS generados para
Port@firma.
Los componentes comunes a todo el desarrollo modular sern el denominado Core. Es el mdulo que contiene
la lgica de negocio central y realiza las funciones de controlador del patrn MVC. Interacciona con el modelo
de datos gracias al uso de la tecnologa de inyeccin de cdigo (Java Context and Dependency Inyection, en
adelante CDI). El controlador har uso de los clientes de WS creados en Metro para recibir las comunicaciones
de Port@firma. Para su comunicacin con eVisor se har uso de Integr@ 1.2.1. Por ltimo, el controlador
interactuar con la Vista, implementada en JSF, mediante CDI inyectando los objetos de sesin creados para las
sesiones de usuario.
7.3.1.1 Mdulo de Persistencia
Todos los mdulos harn uso de un mdulo comn de persistencia. El Mdulo de Persistencia permite el acceso
seguro y controlado al modelo a datos para los elementos de informacin del modelo transaccional.
TELVENT 14 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Como informacin ms relevante sobre este mdulo, podemos destacar que se implementar mediante la
especificacin Java Persistence API 2.0 (JPA 2.0 en adelante), y mediante CDI podremos simplificar y hacer
ms sencillo el mantenimiento y gestin de nuestro cdigo.
Por ltimo, el mdulo contar con el aporte de seguridad para la comprobacin de que el acceso a las fachadas se
realiza siempre con usuarios con las credenciales correctas y con una sesin activa en el sistema.
7.3.1.2 Mdulo Componente Web de Consulta
Internamente este mdulos seguir el diseo de arquitectura en tres capas MVC (Modelo, Vista y Controlador).
La implementacin se llevar a cabo en JSF 2.1, aprovechando la potencia de los Backing Beans con inyeccin
de cdigo para obtener el acceso a las fachadas de operaciones necesarias.
Dado que este mdulo se basar en un punto de entrada nico y el tamao del componente no es de un tamao
considerable, el uso de un framework MVC complejo no est justificado para este caso en concreto. Se optar
por una solucin a medida con las herramientas que JSF ofrece para el control y un entorno de transaccionalidad
implementado por el equipo de desarrollo de SEAM Framework.
Para acceder al componente web de consulta de informes de firma se emplear el servicio web de validacin de
credenciales existente en CHG. Este servicio se encuentra publicado en la intranet de CHG en
http://cazalla.chg:7780/WSAuthentication/WSAuthenticationSoapHttpPort y se emplear el cliente facilitado por
los servicios de informtica clientWSAuthentication-1.4.jar.
7.3.1.3 Mdulo Servicio Web de Generacin de CSV
Este mdulo se construir usando Metro como para la generacin de clientes de servicios web partiendo del
descriptor del servicio WSDL. Los descriptores del servicio web de EEUTIL se encuetran en la distribucin de
Port@firma. Para este mdulo se implementara el servicio generaCSV.
Permite generar el cdigo de verificacin electrnica de una firma digital. El servicio recibe como parmetros de
entrada:
Como resultado de la llamada, y segn la especificacin del servicio, se devolver un cdigo alfanumrico de 32
caracteres de longitud.
TELVENT 15 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Para ajustarnos a esta restriccin, el algoritmo para generar el cdigo debe devolver exactamente 32 caracteres
alfanumricos que se construirn de forma que garantizen que cada cdigo ser inequvoco, relacionado con la
firma del documento y seguro (no predecible).
Para ello deber contar con al menos dos partes diferentes. Una parte que garantice que cada elemento es nico y
otra parte que debe dotarlo de seguridad para garantizar que no se obtendrn documentos del sistema mediante
prediccin de cdigos.
1. Cabecera: este elemento del cdigo puede ser un identificador del organismo al que pertenece el
documento original electrnico custodiado.
1. Cabecera: CHG para indicar que el documento esta custodiado en el organismo Confederacin
Hidrogrfica del Guadalquivir.
Aunque la seccin de seguridad es lo suficientemente grande como para impedir descubrir documentos firmados
de los que no disponemos un cdigo, este cdigo tiene el problema de ofrecer informacin al sistema de manera
evidente sobre el numero de CSV existentes debido al cdigo de unicidad.
TELVENT 16 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Por otro lado, insertar el cdigo a mano puede ser poco practico si usamos simbolos como /, =, +, etc. Por lo
que base64 no es un encoding correcto para estas circustancias.
La forma de corregir este comportamiento es realizando un encoding en otra base. Se puede emplear notacin
hexadecimal. Pero tambin, se puede usar base36 con el siguiente conjunto de elementos de facil insercin va
web:
Al usar esta base para representar los elementos del cdigo CSV obtenemos los siguientes beneficios:
1. Reservando solo 8 caracteres para garantizar la unicidad nos aseguramos poder almacenar un nmero
del orden del billn de documentos (el mayor nmero alcanzable ZZZZZZZZ en decimal es
2.821.109.907.455).
2. Los caracteres introducidos son intuitivos y podemos hacer un tratamiento de la informacin sin
preocuparnos de la sensibilidad a maysculas.
3. Podemos usar el MD5 u otros algoritmos para generar resumenes de la firma que encajan codificados
en el espacio designado para el cdigo de seguridad. La representacin en Base36 del nmero de 32
caracteres ms alto en hexadecimal FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF, es
F5LXX1ZZ5PCKGSSS04KW8W404, que ocupa 25 caracteres.
4. Al usar algoritmos de resumen SHA512, podemos representar un mayor nmero de bytes del Hash en
Base36 que en hexadecimal, aportando un mayor nivel de seguridad ya que se requieren truncar
menor cantidad de bytes.
Otra caracterstica de seguridad para la generacin del CSV que desarrollaremos consisteir en desordenar los
caracteres de seguridad y unicidad. Cambiar las posiciones con uno o varios patrones diferentes (destinando un
carcter a identificar el patrn que ser elegido de manera aleatoria). Reservamos unos de los caracteres de
seguridad a generar 36 diferentes patrones de ordenacin.
A continuacin se muestra una tabla resumen donde se muestran todas las caracteristicas que pueden usarse para
implementar un CSV:
Opcin Ventajas Debilidades
Uso de cabeceras Mejora usabilidad Disminuye la seguridad.
Cdigo en Hexadecimal Mejora usabilidad Necesita truncar los datos de
seguridad. Menor seguridad.
Cdigo Base36 Tamao de los campos se puede Usabilidad aceptable.
ajustar para mayor seguridad.
Intercalado caracteres de Cdigo no predecibles Complejidad de Clculo. Reserva de
unicidad un carcter para gerenar de manera
aleatoria.
Seguridad basada en Hash Relaciona la firma con el CSV. Requieren mayor nmero de
Aleatoriedad y dispersin caracteres para almacenarlos. Requiere
TELVENT 17 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
seguras. truncamiento
Seguridad y unicidad basada en Sin complejidad de Clculo No es dependiente de la firma.
Timestamp Cdigos predecibles.
Basandonos en esta lista de ventajas y debilidades se decide realizar un algoritmo que genere el cdigo CSV
en Base36 segn la siguiente tabla:
Para un cdigo en base36 se propone el uso de cabecera, codigo de unicidad para dar soporte a 78.000 millones
de documentos, usar un carcter para intercalar el cdigo de unicidad de manera pseudoaleatoria y el los
restantes caracteres para almacenar los primeros caracteres del SHA512 que se almacene en la tabla del CSV:
Este mdulo se construir usando las herramientas que ofrece el MINHAP para integracin con los servicios
web de los productos asociados a la plataforma @Firma. El modulo Integr@ 1.2.1 permite usar los servicios web
de eVisor y externalizando esta capa de comunicacin garantizamos que ser mantenible en caso de mejorar la
versin de eVisor instalada. Tambien garantiza un mantenimiento y correccin de cualquier bug. Los
descriptores del servicio web SignatureReportService.wsdl de eVisor pueden encontrarse en la instalacin en
la ruta correspondiente:
TELVENT 18 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
http://<SERVIDOR>:<PUERTO>/eVisor-2.0/services/SignatureReportService
El parmetro de entrada al servicio ser una cadena que contendr el XML de la peticin escapada con la
siguiente estructura:
<?xml version="1.0" encoding="UTF-8"?>
<GenerationRequest xmlns="urn:es:gob:signaturereport:services:messages"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ApplicationId><IDENTIFICADOR_APLICACION></ApplicationId>
<TemplateId><IDENTIFICADOR_PLANTILLA></TemplateId>
<Signature><CONTENIDO_ELEMENTO_SIGNATURE></Signature>
<Document><CONTENIDO_ELEMENTO_DOCUMENT></Document>
<IncludeSignature><true/false></IncludeSignature>
<Barcodes><CONTENIDO_ELEMENTO_BARCODES></Barcodes>
<ExternalParameters><CONTENIDO_ELEMENTO_EXTERNALPARAMETERS></ExternalParameters>
</GenerationRequest>
Los parmetros ApplicationId y TemplateId son parmetros de configuracin que deben estar fijados para el uso
de nuestra aplicacin en la instalacin de eVisor. Los valores de todos los parmetros sern:
ApplicationId: portafirma
TemplateId: informechg
IncludeSignature: false
Barcodes: Este parmetro no se emplear ya que el cdigo de barras ser el establecido en la plantilla del
informe.
La invocacin al servicio se har mediante Integr@, y el servicio nos responder con un mensaje conteniendo un
nico XML :
TELVENT 19 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Con el servicio Integr@ obtenemos el mensaje tratado de la respuesta, de donde se obtendr el cdigo de
resultado de la operacin, el mensaje descriptivo del cdigo y el informe codificado en base64.
La plantilla ser generada siguiendo el manual de programacin de plantillas eVisor. Las plantillas se programan
en XSLT para, mediante el procesado Apache-FOP obtener el documento de informe de firma compuesto con
el documento y la informacin de firma. El proceso de generacin de la plantilla se muestra en la siguiente
imagen:
La plantilla en XSLT contiene informacin sobre la informacin que se incluir en las pginas del informe
generado. Esta informacin hace referencia a la posicin de los elementos dentro de la pgina, mrgenes,
imgenes de fondo, posicin del texto, orientacin, contenido, etc.
En la seccin de anexos se incluyen las propuestas de plantilla existentes para eVisor como partida al desarrollo
de la plantilla de CHG.
Finalmente, se opta por una plantilla segn la ilustracin 13 del anexo 1 que incluye:
2. El sello de tiempo
TELVENT 21 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
8 Casos de uso
Los siguientes apartados recogen todos los casos de usos posibles en los mdulos de Componente Web de
Consulta, Servicio de Generacin de CSV y Servicio de Generacin de Informes de Firma.
Generacin de CSV
Generar CSV
Port@firma
uses
Generar CSV
Port@firmaCSV
Port@firmaCSV
Casos de Uso.
UC-01 Generar CSV Port@firma. El usuario realiza la generacin de CSV desde Port@firma con la generacin
de una nueva firma de documentos.
UC-02 Generar CSV Port@firmaCSV. El sistema invoca al servicio de obtencin de CSV de configurado en
Port@firma y genera un nuevo CSV.
Resultado. Se ha creado un objeto CSV asociado a la firma realizada en Port@firma en nuestro sistema.
TELVENT 22 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Descripcin El usuario de CHG registrado en Port@firma realiza una operacin de firma electrnica
que requiere de un CSV para la firma.
Precondicin El usuario tiene sesin activa como usuario de Port@firma y se encuentra en un proceso
de firma de documentos en el momento de aceptacin de firmar con su certificado el
documento.
El sistema Port@firma est configurado para usar los servicios EEUTIL para
externalizar la generacin de CSV.
Postcondicin El documento est registrado como firmado en Port@firma y su CSV ha sido generado
segn el algoritmo configurado por el servicio externo.
Comentarios -
TELVENT 23 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Requisitos REQ-001
Precondicin El sistema Port@firma est configurado mediante las herramientas de EEUTIL para
invocar mediante servicios web al sistema Port@firmaCSV de generacin de CSV.
Comentarios -
Generacin de Informe de
Firma
Generar Informe de
Firma
uses
Generar Informe de
Firma Port@firmaCSV
uses
Port@firmaCSV
Signature Report
Service eVisor
eVisor
Casos de Uso.
UC-04 Generar Informe de Firma Port@firmaCSV. El sistema Port@firma realiza la peticin de generacin de
un nuevo informe de firma al sistema eVisor
UC-04.1 Sigfnature Report Service eVisor. El sistema eVisor genera un nuevo informe de firma con los datos de
la peticin de servicio.
Resultado. Se ha creado un nuevo documento de informe de firma en PDF y se devuelve el fichero PDF como
resultado de la operacin.
TELVENT 25 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Precondicin El usuario tiene sesin activa como usuario de Port@firma y se encuentra en el resumen
de documentos firmados.
El sistema Port@firma est configurado para usar los servicios EEUTIL para
externalizar la generacin de informes y el botn de solicitud esta por tanto activo.
Comentarios -
TELVENT 26 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Precondicin El sistema Port@firma est configurado mediante las herramientas de EEUTIL para
invocar al servicio web al servicio de generacin de informes de Port@firmaCSV.
Comentarios -
TELVENT 27 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Se describen los casos de uso para la consulta de Informes de firma mediante CSV o fichero de firma de
documentos desde el componente web de consulta de informes de firma.
Obtener Informe de
Firma
extends
uses
uses
uses
Generar Informe de Signature Report
Firma Port@firmaCSV Service eVisor
eVisor
Casos de Uso.
UC-05.1 Obtener CSV Firma. El sistema Port@firmaCSV obtiene el CSV del fichero de firma insertado para
obtener su informe mediante comprobacin en nuestro sistema.
TELVENT 28 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
UC-06 Solicitar Informe de Firma por CSV. El sistema Port@firmaCSV obtiene el informe de firma mediante el
uso del CSV.
UC-04 Generar Informe de Firma Port@firmaCSV. El sistema Port@firma realiza la peticin de generacin de
un nuevo informe de firma al sistema eVisor
UC-04.1 Sigfnature Report Service eVisor. El sistema eVisor genera un nuevo informe de firma con los datos de
la peticin de servicio.
Resultado. Se ha obtenido un documento de informe de firma en PDF y se devuelve el fichero pdf como
resultado de la operacin.
Precondicin El usuario tiene acceso al componente de consulta y tiene permiso para realizar consultas
de documentos en su sesin.
4 El sistema realiza el caso de uso UC-06 Solicitar Informe de Firma por CSV y
obtiene el resultado.
3.a El sistema no tiene registrado un CSV para la firma insertada. Informa del error
al usuario. Fin del caso de uso.
Comentarios -
Precondicin El CSV se ha validado y tenemos los datos necesarios registrados en el sistema para
generar el informe.
Comentarios -
Requisitos REQ-004
TELVENT 30 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
En la siguiente tabla se representa los requisitos funcionales obtenidos del anlisis de requisitos
[Port@FirmaCSV-REQ] frente los diferentes casos de uso expuestos.
REQ-001 X
REQ-002 X
REQ -003 X
REQ -004 X X
REQ -005 X
REQ -006 X
REQ -007 X
REQ -008 X
REQ -009 X
REQ -010 X
REQ -011 X
REQ -012 X
TELVENT 31 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
El estilo de la interfaz se adecuar al actual estilo visual de las aplicaciones de CHG desde el punto de insercin
que se emplee para el enlace al componente de consulta de informes de firma.
El sistema para consulta de informes de firma constara de una interfaz WEB desde la que los usuarios podrn
introducir el CSV o el fichero de firma para obtener el informe del documento.
Consulta de Informes
Aceptar
Botn
Desde CHG se reciben capturas de pantalla, localizadas en la seccin de anexos, y archivos de estilo CSS para
generar la base de la interfaz de la nueva aplicacin Port@firmaCVS.
TELVENT 32 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
En este apartado se recoge la aceptacin formal de las especificaciones funcionales recogidas en el presente
documento a partir del cual se continuar con las fases de diseo, construccin y pruebas. Adems, pretende
servir de base para la aceptacin formal de la entrega del proyecto.
M. ngel Ripalda Marn M. Isabel Mrquez Contreras Manuel Enrque Garca Ramos
TELVENT 33 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
12 Anexos
TELVENT 34 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
Imgenes de aplicacin de uso interno en CHG como base del diseo de la interfaz:
TELVENT 35 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma
TGS-ANF-009302-CHG-Analisis-Funcionall
TELVENT 36 de 36 28-05-2013
Anlisis de requisitos Sistema
Generador de CSV e Informes de Firma