WEBSERVICES CON FIRMA DIGITAL Versión 1.2

Transcripción

1 WEBSERVICES CON FIRMA DIGITAL Versión 1.2 FEBRERO 2007 Página: 1

2 1 TABLA DE CONTENIDO 1 TABLA DE CONTENIDO INTRODUCCIÓN HERRAMIENTA DE DESARROLLO ANT CREACION SERVICIO WEB CREACIÓN CLIENTE WEB PROBLEMAS DETECTADOS FICHEROS EJEMPLO FIRMA DE PETICIONES Y RESPUESTAS EN EL SERVICIO WEB FIRMA DE PETICIONES Y RESPUESTAS EN EL CLIENTE DEL SERVICIO WEB Página: 2

3 2 INTRODUCCIÓN Este documento indica como construir servicios web y clientes para dichos servicios firmando el mensaje de petición y de respuesta utilizando el estándar XML-Dsig. Para esta firma y la validación de la misma se utilizará la plataforma ASF, debiendo cumplir el servicio y el cliente todos los pasos necesarios para estar de alta en la misma, como se explica en el manual de la misma. 3 HERRAMIENTA DE DESARROLLO ANT Primeramente y antes de seguir adelante indicar que como herramienta de desarrollo de tanto los WebServices como los clientes de los mismos, se decido utilizar Ant. Un proyecto de código abierto de Apache Software Fondation. Ant es una herramienta desarrollada para sustituir al make que podríamos hacer en cualquier sistema operativo, pero que depende de plataforma ya que esta hecha en Java y sus ficheros de configuración se basan en XML. Su uso y funcionamiento se puede asemejar a los ficheros bat, shell o script de otros sistemas operativos. Dentro de un fichero de configuración de ANT, como puede ser el fichero build.xml que veremos más adelante, cada una de las tareas que se deben realizar se denomina target. Además se pueden establecer variables que podrá ser accesibles por cualquier tarea, a través de la marca property. De todas formas podemos encontrar una relación del significado de cada una de las marcas y sus parámetros dentro de la página 4 CREACION SERVICIO WEB Pasos a seguir para la creación de un Servicio Web: 1. Descargar la versión de axis de la dirección 2. Descomprimir el zip de axis en cualquier directorio. A partir de ahora esa ruta será la variable "axis.home". 3. Copiar el contenido del directorio webapps/axis del directorio axis.home a nuestro directorio web del servicio que estemos creando. Eliminando el directorio samples que se encuentra dentro de él, ya que no es necesario. Al concluir este paso tendremos incluido dentro de nuestro Página: 3

4 directorio WEB-INF, las clases y librerías necesarias para empezar con nuestro servicio web. 4. Hay que crear un fichero usando ANT, como el fichero build.xml de ejemplo (el que viene al final de este apartado o dentro de los ejemplos disponibles dentro de soja_int (ASF->Ejemplos)). Este fichero hay que modificarlo cambiando el nombre del proyecto y las variables que afecten a las rutas físicas de nuestro proyecto. 5. Crear la clase que hará de servicio web, para ello heredar de la clase de sistemas: sistemas.ws.servicioweb. Usar el constructor de esta clase para indicar el nombre del fichero de configuración y que recoja las variables del mismo. Además en esta clase se definirán las operaciones a las que va a dar servicio nuestro WebServices. 6. Luego hay que modificar el fichero anterior eliminando el elemento target llamado autentication-java2wsdl, sustituyendolo por uno propio de nuestro servicio y que ejecuta la tarea "axis-java2wsdl" que genera el WebService, empaquetando las clases generadas dentro del paquete indicado. Además de estas clases se crea un fichero descriptor de nuestro servicio web con extensión wdsl y nombre el que nosotros le indiquemos. Es recomendable que si va a haber varios webservices se cree una tarea para cada servicio. Se puede tomar el ejemplo "autentication-java2wsdl" como guía de creación de esta tarea. 7. Acontinuación crear el fichero deploy.wsdd, del cual se puede ver un ejemplo al final de este punto, ajustandolo con el nombre de la clase del servicio web y el nombre del mismo. En nuestro caso, el servicio es UsuJAutenticationWS y la clase es usuj.ws.usujautenticationws. 8. Realizar un primer despliegue del servicio en un servidor de aplicaciones usando para ello la tarea deploy que esta incluida en el fichero build.xml. La tarea deploy solo crea el ear a partir de la web y copia el fichero en el directorio "deploy.dest". Para el primer despliegue tal vez sea necesario modificar algún fichero de configuración del servidor de aplicaciones para que reconozca la aplicación (server.xml y http-web-site.xml). 9. Ejecutar la tarea deploy-wsdl para realizar el despliegue inicial del WebService en Axis, es decir, para realizar la publicación dentro Axis del servicio web. 10. Copiar el fichero server-config.wsdd del directorio WEB-INF de la aplicación desplegada al de nuestro proyecto de desarrollo. Página: 4

5 Obs: Para comprobar que nuestro servicio se encuentra dado de alta y responde a peticiones, puede hacerse una petición a la dirección correspondiente a nuestro servicio y siguiendo la estructura: Esta petición nos debe responder un mensaje de AXIS para saber que esta funcionando correctamente. 5 CREACIÓN CLIENTE WEB Una vez creado nuestro webservice, es hora de crear el cliente. Este punto también se puede seguir en el caso de que no hayamos creado nosotros el servicio, ya que lo únicamente necesario es el fichero wsdl que describe las operaciones del mismo. Una vez con el fichero comentado, que siguiendo nuestro caso se obtendría en el paso 6. Se debería definir tarea "axis-wsdl2java" de Ant, de la que podemos ver un ejemplo en "autentication-wsdl2java". Esta tarea nos creara todas las clases necesarias para invocar el webservice asi como una clase de test que nos permitirá testear el cliente generado en caso de ser necesario. Para poder ejecutar esta clase de test será necesario tener dentro de nuestro proyecto de Eclipse importado el jar de junit. 6 PROBLEMAS DETECTADOS Se han detectado los siguientes problemas en este proceso de creación de cliente y servicio web: - La generación de los paquetes no es todo lo correcta que deberia ser. Al generar el webservice le indicamos un namespace que luego añade al paquete que indiquemos en la generación del cliente, por lo que habra que tenerlo en cuenta. - La variable "service_address" dentro de la clase Locator es incorrecta, le falta añadir el nombre del servicio que se va a usar al final. - El test que crea para recibir el wsdl no funciona nunca a pesar de que los demas si funcionan y de que el servicio devuelve correctamente el WSDL si se le invoca a traves de un explorador. -En OC4J podemos tener problemas para generar el wsdl puesto que el parser que emplea no es del todo estandar para solucionarlo existe un parche para el parser de oracle. Enviar un correo a Arquitectura e Integración de aplicaciones para recibir este parche. Página: 5

6 7 FICHEROS EJEMPLO Ejemplo de build.xml: <project name="usuj_ws"> <property name="appname" value="${ant.project.name}" /> <property name="src.dir" value="java/fuentes/src"/> <property name="web.dir" value="java/fuentes/web"/> <property name="build.dir" value="java/fuentes/web/web-inf"/> <property name="deploy.dir" value="java/ear"/> <property name="axis.home" value="d:/descargas/axis-bin-1_2_1/axis-1_2_1"/> <property name="deploy.dest" value="d:/producto/oracle9.0.4/j2ee/home8052/icm"/> <property name="target.port" value="8052"/> <property name="target.server" value="pc317668"/> <property name="target.appname" value="${appname}"/> <property name="endpoint-stub.wsdd" value="java/fuentes/web/web-inf/deploy.wsdd"/> <path id="axis.classpath"> <fileset dir="${axis.home}/lib"> <include name="**/*.jar"/> </fileset> <fileset dir="${build.dir}/lib"> <include name="**/*.jar"/> </fileset> <fileset dir="${build.dir}/classes"> <include name="**/*.class"/> </fileset> </path> <taskdef resource="axis-tasks.properties" classpathref="axis.classpath" /> <target name="autentication-java2wsdl" description="crea el WSDL de la clase especificada"> <axis-java2wsdl classname="usuj.ws.usujautenticationws" namespace="usuj.ws.autentication" location=" classpath="${build.dir}/classes" output="${build.dir}/usujautenticationws.wsdl"> <mapping namespace="urn:usujautenticationws" package="usujws.servicio"/> <classpath path="${build.dir}"/> </axis-java2wsdl> </target> <target name="autentication-wsdl2java" description="crea las clases necesarias para invocar un webservice, es decir, el cliente del servicio"> <axis-wsdl2java output="${src.dir}" testcase="true" verbose="true" url="${build.dir}/usujautenticationws.wsdl"> <mapping namespace=" package="usujws.servicio"/> </axis-wsdl2java> </target> <target name="compile" description="compile main source tree java files"> <mkdir dir="${build.dir}/classes"/> <javac destdir="${build.dir}/classes" debug="true" optimize="false" deprecation="false" failonerror="true"> <src path="${src.dir}"/> <classpath> <path refid="compile.classpath"/> <fileset dir="${web.dir}/web-inf/lib" includes="*.jar"/> </classpath> </javac> </target> Página: 6

7 <target name="deploy" description="crea el.ear de la aplicación y lo deja en el directorio ear"> <war destfile="${deploy.dir}/${appname}.war" webxml="${build.dir}/web.xml"> <fileset dir="${web.dir}"/> </war> <ear destfile="${deploy.dir}/${appname}.ear" appxml="${deploy.dir}/meta- INF/application.xml"> <fileset dir="${deploy.dir}" includes="*.war"/> </ear> <delete> <fileset dir="${deploy.dir}" includes="**/*.war"/> </delete> <copy file="${deploy.dir}/${appname}.ear" todir="${deploy.dest}"/> </target> <target name="deploy-wsdl" description="realiza el despliegue inicial del WebService en Axis"> <axis-admin port="${target.port}" hostname="${target.server}" failonerror="true" servletpath="${target.appname}/services/adminservice" debug="true" xmlfile="${endpoint-stub.wsdd}"/> </target> /project> Ejemplo de deploy.wsdd: <deployment xmlns=" xmlns:java=" <service name="usujautenticationws" provider="java:rpc"> name="classname" value="usuj.ws.usujautenticationws"/> name="allowedmethods" value="*"/> </service> </deployment> Página: 7

8 8 FIRMA DE PETICIONES Y RESPUESTAS EN EL SERVICIO WEB Obs: es importante resaltar que todo lo que viene a contuniación relacionado con la firma, esta sujeto a los fichero y variables descritas en la guía de ASF, que es el sistema de firma y validación que es obligatorio usar para los servicios que se integren dentro del Framework de ICM. La forma de firmar la petición y la respuesta es mediante el uso de una clase Handler (librería ws_sign_handler.jar) donde ya está implementada la firma y la validación de un mensaje con el formato XMLDSig con ayuda de la plataforma de ASF. Para ello se debe solicitar a la Unidad de Arquitectura e Integración de aplicaciones, que para nuestra aplicación se den de alta dentro de la plataforma las operaciones de FIRMA y VERIFICACION, indicando las ca s que debe verificar y el certificado con el que se van a firmar las peticiones. Para hacer que el servicio web valide la petición tenemos que editar el fichero server_config.wsdd con lo que sigue. En este fichero tenemos que insertar la información que indica abajo sobre los handlers van a manejar las peticiones y las respuestas del servicio web. Es decir, utilizaremos estos manejadores para obtener la información de la petición firmada (validar la firma y sacar la información) y tambien para firmar la respuesta del servicio web. Para la validación de la petición, en el elemento requestflow de este fichero añadiremos otro elemento handler aparte de los que ya existen, con las variables de configuración de esta operación en la plataforma ASF. Y que corresponden a la aplicación que esta dada de alta en ASF y la operación de verificación asociada a la misma en este caso VERIFICACION: <handler type="java:handlers.validationhandler"> name="aplicacion.asf.verify.verifysignatureapplicationid" name="aplicacion.asf.verify.verifysignatureoperationtypeid" value="verificacion"/> name="aplicacion.asf.verify.registronorepudio" name="aplicacion.asf.verify.signaturecheckrevocation" name="aplicacion.asf.verify.ignoreverificationcaches" Página: 8

9 Para la firma de la respuesta, en el elemento responseflow de este fichero añadiremos otro elemento handler aparte de los que ya existen, con las variables de configuración de esta operación en la plataforma ASF. Y que corresponden a la aplicación que esta dada de alta en ASF y la operación de firma asociada a la misma en este caso FIRMA: <handler type="java:handlers.signerhandler"> name="aplicacion.asf.sign.signapplicationid" name="aplicacion.asf.sign.signoperationtypeid" value="firma"/> name="aplicacion.asf.sign.ignoreverificationcaches" name="aplicacion.asf.sign.registerrevocation" name="aplicacion.asf.sign.alias" value="demo_abogacia"/> De esta forma, el fichero server_config.wsdd quedará de la siguiente forma: <?xml version="1.0" encoding="utf-8"?> <deployment xmlns=" xmlns:java=" <globalconfiguration> name="adminpassword" value="admin"/> name="attachments.implementation" value="org.apache.axis.attachments.attachmentsimpl"/> name="sendxsitypes" value="true"/> name="sendmultirefs" value="true"/> name="sendxmldeclaration" value="true"/> name="axis.sendminimizedelements" value="true"/> <requestflow> <handler type="java:org.apache.axis.handlers.jwshandler"> name="scope" value="session"/> <handler type="java:org.apache.axis.handlers.jwshandler"> name="scope" value="request"/> name="extension" value=".jwr"/> <handler type="java:handlers.validationhandler"> name="aplicacion.asf.verify.verifysignatureapplicationid" name="aplicacion.asf.verify.verifysignatureoperationtypeid" value="verificacion "/> name="aplicacion.asf.verify.registronorepudio" name="aplicacion.asf.verify.signaturecheckrevocation" Página: 9

10 name="aplicacion.asf.verify.ignoreverificationcaches" </requestflow> <responseflow> <handler type="java:handlers.signerhandler"> name="aplicacion.asf.sign.signapplicationid" name="aplicacion.asf.sign.signoperationtypeid" value="firma"/> name="aplicacion.asf.sign.ignoreverificationcaches" name="aplicacion.asf.sign.registerrevocation" name="aplicacion.asf.sign.alias" value="demo_abogacia"/> </responseflow> </globalconfiguration> <handler name="localresponder" type="java:org.apache.axis.transport.local.localresponder"/> <handler name="urlmapper" type="java:org.apache.axis.handlers.http.urlmapper"/> <handler name="authenticate" type="java:org.apache.axis.handlers.simpleauthenticationhandler"/> <handler name="validation" type="java:handlers.validationhandler"/> <handler name="signer" type="java:handlers.signerhandler"/> <service name="adminservice" provider="java:msg"> name="allowedmethods" value="adminservice"/> name="enableremoteadmin" name="classname" value="org.apache.axis.utils.admin"/> <namespace> </service> <service name="version" provider="java:rpc"> name="allowedmethods" value="getversion"/> name="classname" value="org.apache.axis.version"/> </service> <service name="servicioempleados" provider="java:rpc"> name="allowedmethods" value="*"/> name="scope" value="request"/> name="classname" value="servicioempleados.servicio.servicioempleados"/> <typemapping deserializer="org.apache.axis.encoding.ser.beandeserializerfactory" encodingstyle=" qname="ns1:empleadosbean" serializer="org.apache.axis.encoding.ser.beanserializerfactory" type="java:servicioempleados.beans.empleadosbean" xmlns:ns1=" </service> <transport name="http"> <requestflow> <handler type="urlmapper"/> <handler type="java:org.apache.axis.handlers.http.httpauthhandler"/> Página: 10

11 </requestflow> </transport> <transport name="local"> <responseflow> <handler type="localresponder"/> </responseflow> </transport> </deployment> 9 FIRMA DE PETICIONES Y RESPUESTAS EN EL CLIENTE DEL SERVICIO WEB Obs: es importante resaltar que todo lo que viene a contuniación relacionado con la firma, esta sujeto a los fichero y variables descritas en la guía de ASF, que es el sistema de firma y validación que es obligatorio usar para los clientes que se integren dentro del Framework de ICM. Para crear el cliente del servicio Web el procedimiento es similar a lo anteriormente especificado para el servidor. Aquí tendremos que indicar que clase es la que se encarga de firmar la petición y cual es la encargada de validar la respuesta igual que en lo anterior, pero observando que en este caso se firmará la petición y se validará la respuesta. Hay que tener en cuanta como para el servidor que se debe solicitar a la Unidad de Arquitectura e Integración de aplicaciones, que nuestra aplicación se den de alta dentro de la plataforma ASF con las operaciones de FIRMA y VERIFICACION, indicando las ca s que debe verificar y el certificado con el que se van a firmar las peticiones. De esta forma, modificaremos el fichero client-config.wsdd como sigue: Para la firma de la petición, en el elemento requestflow de este fichero añadiremos otro elemento handler aparte de los que ya existen, con las variables de configuración de esta operación en la plataforma ASF. Y que corresponden a la aplicación que esta dada de alta en ASF y la operación de firma asociada a la misma en este caso FIRMA: <handler type="java:handlers.signerhandler"> name="aplicacion.asf.sign.signapplicationid" name="aplicacion.asf.sign.signoperationtypeid" value="firma"/> name="aplicacion.asf.sign.ignoreverificationcaches" name="aplicacion.asf.sign.registerrevocation" name="aplicacion.asf.sign.alias" Página: 11

12 value="demo_abogacia"/> Para la validación de la respuesta: En el elemento responseflow de este fichero añadiremos otro elemento handler aparte de los que ya existen, con las variables de configuración de esta operación en la plataforma ASF. Y que corresponden a la aplicación que esta dada de alta en ASF y la operación de verificación asociada a la misma en este caso VERIFICACION: <handler type="java:handlers.validationhandler"> name="aplicacion.asf.verify.verifysignatureapplicationid" name="aplicacion.asf.verify.verifysignatureoperationtypeid" value="verificacion"/> name="aplicacion.asf.verify.registronorepudio" name="aplicacion.asf.verify.signaturecheckrevocation" name="aplicacion.asf.verify.ignoreverificationcaches" Asi, el fichero client-config.wsdd quedaría de la siguiente manera: <?xml version="1.0" encoding="utf-8"?> <deployment xmlns=" xmlns:java=" <globalconfiguration> name="adminpassword" value="admin"/> name="sendxsitypes" value="true"/> name="sendmultirefs" value="true"/> name="sendxmldeclaration" value="true"/> name="axis.sendminimizedelements" value="true"/> <requestflow> <handler type="java:handlers.signerhandler"> name="aplicacion.asf.sign.signapplicationid" name="aplicacion.asf.sign.signoperationtypeid" value="firma"/> name="aplicacion.asf.sign.ignoreverificationcaches" name="aplicacion.asf.sign.registerrevocation" Página: 12

13 name="aplicacion.asf.sign.alias" value="demo_abogacia"/> </requestflow> <responseflow> <handler type="java:handlers.validationhandler"> name="aplicacion.asf.verify.verifysignatureapplicationid" name="aplicacion.asf.verify.verifysignatureoperationtypeid" value="verificacion"/> name="aplicacion.asf.verify.registronorepudio" name="aplicacion.asf.verify.signaturecheckrevocation" name="aplicacion.asf.verify.ignoreverificationcaches" </responseflow> </globalconfiguration> <transport name="java" pivot="java:org.apache.axis.transport.java.javasender"/> <transport name="http" pivot="java:org.apache.axis.transport.http.httpsender"/> <transport name="local" pivot="java:org.apache.axis.transport.local.localsender"/> </deployment> Página: 13