Manual de configuración de los servicios del Portafirmas móvil

Transcripción

1 DIRECCIÓN DE TECNOLOGÍAS DE LA INFORMACIÓN Y LAS Manual de cnfiguración de ls servicis del

2 Índice de cntenids 1 Intrducción Servicis del Servici Prxy Cnfiguración del servici Servici de firma trifásica Cnfiguración del servici

3 1 Intrducción El es una app para dispsitivs móviles que permite realizar las peracines más destacadas del Prtafirmas web del MinHAP. Esta app sirve únicamente cm interfaz del Prtafirmas web, de tal frma que tda la lógica se mantiene en servidr a excepción de la peración de firma, que se realiza cn el certificad que el usuari tiene instalad en el dispsitiv y cn el que accede a la aplicación. Las peracines que permite realizar el es: Listad de slicitudes de firma (pendientes, firmadas y rechazadas). Visualización del detalle de las peticines. Visualización de ls dcuments de las peticines y de las firmas e infrmes de las peticines ya firmadas. Firma y vist buen de peticines. Rechaz de peticines. Para la ejecución de estas peracines, el requiere de una serie de servicis web. El presente manual trata de la cnfiguración de ests servicis. 3

4 2 Servicis del La slución de se sprta en una serie de servicis que le permiten cmunicarse cn el Prtafirmas web y realizar las distintas peracines de firma. Ests sn ls servicis de prxy y de firma trifásica del respectivamente. 2.1 Servici Prxy El servici prxy del prtafirmas web es el que se encarga de recger las peticines del Prtafirmas móvil y redirigirlas al Prtafirmas Web y/ al servici de firma trifásica cuand se trate de peracines de firma Cnfiguración del servici El servici de prxy se cnfigura a través del ficher pfmvil.prperties. Este ficher está pr defect cntenid dentr del WAR del servici (afirma-signflder-prxy.war) y puede mdificarse directamente. También es psible indicar al servici que lea la cnfiguración de un ficher cn el mism nmbre lcalizad en un directri extern. Para ell, se deberá cnfigurar la ruta de este directri mediante la prpiedad de Java pfmvil.cnfig.path. Pr ejempl: -Dpfmvil.cnfig.path=/pt/usuaris/prtafirmas/prperties Si se va a utilizar un ficher de cnfiguración extern, es recmendable eliminar el ficher cntenid en el WAR del servici para eliminar dudas acerca de cuál se está utilizand. Las prpiedades que se pueden cnfigurar desde este ficher sn: signflder.ws.url Indica cual es la URL de ls servicis web del Prtafirmas que dan sprte al. La URL debe apuntar al WSDL publicad. Ejempl: triphase.server.url Indica la URL del servici de firma trifásica. IMPORTANTE: La ruta de acces al servidr trifásic debería ser interna cuand ambs se encuentren en el mism servidr, evitand que la cmunicación entre ambs servicis deba salir de la red atravesar cualquier prxy. En cas de que el servici cambiase de puert en cada ejecución del servidr de aplicacines, es psible utilizar el símbl ${tmcat.httpprt} para cargar el puert establecid en la variable de entrn Java tmcat.httpprt. Ejempl: frced.extraparams 4

5 Permite establecer parámetrs de cnfiguración que se establecerán para TODAS las firmas que se realicen a través del. Estas prpiedades se agregarán a las especificadas para cada dcument y sustituirán a aquellas que se estableciese en rigen. Ls parámetrs se establecerán cm una cadena de pares clave=valr. Las distintas prpiedades se separarán cn el carácter punt y cma ( ; ). Pr defect: mde=implicit (Tdas las firmas será implícitas) 2.2 Servici de firma trifásica El servici de firma trifásica permite realizar ls prcess de firma del prtafirmas móvil. Este servici se encarga de btener la infrmación que el usuari cifrara cn su clave privada en su dispsitiv y cmpndrá la firma en servidr cn el frmat adecuad. Este servici se distribuye de tal frma que n necesita cnfiguración para permitir al Prtafirmas web generar las firmas. Existe la psibilidad, sin embarg, de cnfigurar varis aspects de este servici, mediante el ficher cnfig.prperties cntenid en el WAR (afirma-servertriphase-signer.war) Cnfiguración del servici El servici de firma trifásica se distribuye ya cnfigurad para que funcine crrectamente cn el. Existe la psibilidad, sin embarg, de cnfigurar varis aspects de su cmprtamient mediante el ficher cnfig.prperties cntenid dentr del WAR del servici (afirma-server-triphase-signer.war). Este ficher puede mdificarse directamente, per también es psible indicar al servici que lea la cnfiguración de un ficher cn el mism nmbre lcalizad en un directri extern. Para ell, se deberá cnfigurar la ruta de este directri mediante la prpiedad de Java clienteafirma.cnfig.path. Pr ejempl: -Dclienteafirma.cnfig.path=/pt/usuaris/prtafirmas/prperties Si se va a utilizar un ficher de cnfiguración extern, es recmendable eliminar el ficher cntenid en el WAR del servici para eliminar dudas acerca de cuál se está utilizand. Las prpiedades que se pueden cnfigurar sn las siguientes: Access Cntrl Allw Origin Permite establecer el rigen permitid de las peticines. El servici de firma trifásica agregará el valr de esta prpiedad en las respuestas del servici. 5

6 Si se establece cm valr un asterisc ( * ), se indica que se pueden realizar peticines desde cualquier dmini. Valr pr defect: * alternative.xmldsig Permite habilitar el md de cmpatibilidad cn biblitecas de firma XML que puedan encntrarse en el classpath del servidr de aplicacines. Este tip de biblitecas pueden interferir cn las que incluye el prpi Oracle Java e impedir realizar firmas XAdES. Ejempls de biblitecas que prvcan ests errres sn XERCES/XALAN. Al indicar el valr true, se habilitará el md de cmpatibilidad cn estas biblitecas, l que bligará al servici a buscar diverss paquetes de clases para encntrar un md de cmpletar las firmas. N se garantiza la cmpatibilidad cn tdas las versines de estas biblitecas. IMPORTANTE: Será necesari establecer a true esta prpiedad cuand se desplieguen ls servicis sbre un servidr JBss 6 superir. Valr pr defect: false dcument.manager Clase que se encargará de gestinar ls dcuments que se deben firmar y las firmas generadas. El Dcument Manager pr defect imita un prces de firma mnfásica. IMPORTANTE: Esta prpiedad n debe mdificarse cuand se despliegue el servici cm parte de la slución del. 6

7 Esta bra está baj una licencia Creative Cmmns Recncimient NCmercial CmpartirIgual 3.0 Unprted. 7