Sistema Integral Multicanal de Atencin al Ciudadano

e-SIRCAManual_Consumo_Instrumentales_y_Verificacin

Versin 007 Marzo de 2012

ndice
1 Control del documento .................................................................................................... 3
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 Informacin general .................................................................................................................3 Histrico de revisiones ............................................................................................................3 Estado del documento .............................................................................................................3 Alcance......................................................................................................................................4 Objetivos ...................................................................................................................................4 Audiencia ..................................................................................................................................4 Glosario .....................................................................................................................................4 Referencias ...............................................................................................................................5

Introduccin ..................................................................................................................... 6
2.1 Alcance del Sistema ................................................................................................................7
2.1.1 2.1.2 2.1.3 Separacin funcional de servicios .............................................................................................. 7 Tipos de consumidores .............................................................................................................. 7 Roles del Sistema ...................................................................................................................... 9

2.2

Informacin de Contacto .......................................................................................................10

Gua de para el consumo de servicios publicados en la PAI ...................................... 11

3.1 Configuracin y requisitos....................................................................................................11
3.1.1 Configuracin de las herramientas ........................................................................................... 11
3.1.1.1 3.1.1.2 3.1.1.3 3.1.1.4 3.1.1.5 3.1.1.6 3.1.1.7 3.1.1.8 3.1.1.9 3.1.1.10 3.1.1.11 Librera Apache CXF........................................................................................................... 11 SOAPUI .............................................................................................................................. 11 Configuracin de eclipse ..................................................................................................... 12 Generacin del cliente con soapUI ...................................................................................... 14 Dependencias ..................................................................................................................... 17 Soporte ws-security con Apache CXF ................................................................................. 18 Password Handler ............................................................................................................... 19 Interceptores CXF ............................................................................................................... 20 Firmado .............................................................................................................................. 20 Parmetros del servicio ..................................................................................................... 21 Generacin del cliente con el plugin de eclipse ................................................................. 22

Manual de usuario para el consumo de servicios instrumentales y de verificacin

2 /24

1 Control del documento

1.1
Ttulo Creado por Revisado por Lista de distribucin Nombre del fichero e-SIRCA-CONSTRUCCION-2Manual_Usuario_Consumo_Instrumentales_y_de_Verificacion-001.doc

Informacin general
Manual de usuario de consumo de Servicios Instrumentales y de Verificacin NEORIS

1.2

Histrico de revisiones
Fecha 02/11/2011 13/02/2012 15/02/2012 12/03/2012 13/03/2012 05/06/2012 06/07/12 Autor David Gilsanz Francisco Jos Arnau Vives Susana Chapado Jos Manuel Garca S.Chapado / Jorge Rubira Francisco Jos Arnau Vives Ral Cano Versin inicial Adaptacin a ENI Revisin documento Separacin documento por tipo de servicio Revisin, adaptacin plantilla eSirca, URLs Correccin Username/Token Unificacin de instrumentales Manuales de Verificacion e Observaciones

Versin 001 002 003 004 005 006 007

1.3

Estado del documento

Fecha

Responsable aprobacin

Manual de usuario para el consumo de servicios instrumentales y de verificacin

3 /24

1.4

Alcance

Este documento pretende ser una gua de usuario para el consumo de servicios publicados en la Plataforma Autonmica de Intermediacin de Datos Segura (a partir de ahora PAI).

1.5

Objetivos

Los objetivos del presente documento son: Describir las particularidades y condicionantes que tiene el consumo de los servicios desplegados en el bus de la PAI. Describir el ciclo de consumo de servicios publicados en la plataforma, PAI. Describir la librera Apache CXF para la generacin de clientes de servicio. Describir las herramientas necesarias para la generacin de un cliente CXF de un servicio publicado en la plataforma. Describir como generar un cliente CXF de servicio mediante la herramienta SoapUI. Describir como generar un cliente CXF de servicio mediante el plugin de eclipse. Dar los conocimientos necesarios para usar el soporte WS-Security de la librera Apache CXF y aplicarlos a los clientes CXF generados. Describir brevemente el uso de KeytoolUI para la gestin de keystores y certificados.

1.6

Audiencia
Nombre y Apellidos Rol CONSUMIDORES DE SERVICIOS

Tabla 1: Audiencia

1.7

Glosario
Trmino Definicin Plataforma Autonmica de Intermediacin de Datos Segura

PAI

Tabla 2: Glosario

Manual de usuario para el consumo de servicios instrumentales y de verificacin

4 /24

1.8

Referencias
Referencia Ttulo

Tabla 3: Referencias

Manual de usuario para el consumo de servicios instrumentales y de verificacin

5 /24

2 Introduccin
La Plataforma Autonmica de Intermediacin de Datos Segura (PAI) est basada en la herramienta Oracle Service Bus. Las funcionalidades que contempla las resumimos a continuacin: Autenticacin: Modelo de mensajes basado en la codificacin y securizacin conforme a estndares WSS, que mediante el uso de certificados de uso comn como X.509 permitan garantizar la identidad de la aplicacin demandante del servicio. Firmado: Validacin de la integridad del mensaje verificando que el mensaje firmado corresponde con dicho certificado. Adems, se firma el mensaje de respuesta del servidor con su propio certificado para garantizar la validez legal del mensaje. Autorizacin: Una vez autenticada una determinada identidad, se autoriza que tiene permisos sobre el recurso al que accede. Sellado: Al igual que en la plataforma anterior, se estampa una firma temporal certificada por la ACCV. Transparente para el consumo de servicios. Transformacin de mensajes. Una de las caractersticas que presenta el bus es la adecuacin y transformacin de los mensajes al formato y tipo esperado por los distintos servicios. El bus se comporta de forma transparente a formatos y permite realizar las apropiadas transformaciones para adecuar la orquestacin que en cada caso sea necesaria. Transparente para el consumo de servicios. Registro y Auditora. En el entorno de trabajo presente es fundamental el registro de mensajes que permita certificar determinadas peticiones y respuestas sin penalizar en demasa el funcionamiento de la plataforma. Transparente para el consumo de servicios. Orquestacin de servicios. El bus de integracin de servicios permite definir un flujo diagramado que pueda establecer condiciones de invocacin y todas las caractersticas tpicas en procesos de orquestacin de servicios. Transparente para el consumo de servicios. Herramienta interna de gestin y administracin de servicios llamada Gestor de la Plataforma Autonmica de Intermediacin de Datos Segura, GePI. La gestin y control de acceso a los servicios publicados en la plataforma se realiza por parte de la DGTI utilizando una herramienta desarrollada a tal efecto, que permite otorgar los permisos adecuados a los usuarios y aplicaciones que lo soliciten siguiendo el ciclo de consumo del apartado 2.1.3.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

6 /24

2.1

Alcance del Sistema

2.1.1 Separacin funcional de servicios La separacin funcional de los servicios a publicar en la Plataforma Autonmica de Intermediacin de Datos Segura ha permitido identificar dos grupos principales de servicios cuyas caractersticas presentan diferencias sensibles y que afectan al modo en que se consumen dichos servicios: Servicios de Intermediacin/Verificacin: Estos servicios hacen referencia a las capacidades de verificacin que la Administracin tiene para evitar solicitar al ciudadano documentacin que pueda obrar en su poder en el proceso de interaccin entre ambos. Servicios Instrumentales. Estos servicios hacen referencia a servicios que permiten realizar procesos instrumentales a las distintas entidades de la Administracin Pblica en su gestin con el ciudadano, como puedan ser notificaciones, pagos, etc. En este grupo se englobarn tambin los servicios utilizados en la gestin de la Plataforma de Tramitacin. 2.1.2 Tipos de consumidores Atendiendo al tipo de consumidor de los servicios publicados en la Plataforma Autonmica de Intermediacin de Datos Segura podemos considerar las siguientes agrupaciones: Organismos solicitantes externos: Organismos no pertenecientes a la GVA como la Administracin General del Estado, Entidades Locales, Comunidades Autnomas, .... Estas entes consumirn los servicios publicados en la plataforma firmando las peticiones a la misma con un certificado en vigor autorizado por la GVA mediante WSSECURITY. Las urls correspondientes a los distintos servicios publicados para estos organismos sern del estilo siguiente para los distintos entornos: Preproduccin Servicios Instrumentales: o https:// preinterext.gva.es/eSirca_Bus/ins/<url_servicio_v_XX> Servicios de Verificacion: o https:// preinterext.gva.es/eSirca_Bus/ver/<url_servicio_v_XX> Produccin: Servicios Instrumentales: o https:// interext.gva.es/eSircaBus/ins/<url_servicio_v_XX> Servicios de Verificacin: o https:// interext.gva.es/eSircaBus/ver/<url_servicio_v_XX> Organismos solicitantes internos: En este grupo se engloban los clientes de las organizaciones pertenecientes a la GVA, distinguindose a su vez dos subgrupos: Organismos GVA: Consellerias, Organismos dependientes, etc. que tienen aplicaciones que acceden a los servicios de la plataforma. Consumirn los servicios publicados en la plataforma firmando las peticiones a la plataforma con un certificado en vigor autorizado por la GVA mediante WS-SECURITY.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

7 /24

Plataforma e-Sirca: Aplicaciones y mdulos pertenecientes a la plataforma eSirca que utilicen servicios de interoperabilidad. Consumirn los servicios publicados en la PAI usando un token usuario/contrasea siguiendo los estndares WS-SECURITY.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

8 /24

2.1.3 Roles del Sistema Se han definido los siguientes roles en el sistema e-sirca:
Rol Consumidor servicios bus Responsable servicio proveedor Hospedaje servicio Desarrollador servicio proveedor Gestor Interoperabilidad Administracin tcnica PAI Descripcin Miembro de un organismo o entidad responsable de comunicar a la DGTI el consumo de determinados servicios. Miembro de un organismo o entidad responsable del servicio como proveedor. Miembro de un organismo o entidad responsable del hospedaje (hosting) de un servicio publicado a travs de la PAI. Miembro de un organismo o entidad responsable de desarrollar servicios a publicar a travs de la PAI. Miembro de la DGTI responsable de asignar permisos de aplicaciones sobre servicios orquestados o finales publicados a travs de la PAI. Encargados de especificar polticas y configuraciones generales del bus.

El rol que aplica al presente documento es el de consumidor de servicios de la plataforma. Para el consumo de servicios deber comunicar el serial number del certificado que se usar para firmar las peticiones al bus o en caso de consumo al bus interno mediante token usuario/contrasea se proporcionar dicho token por parte de la DGTI. El Gestor de Interoperabilidad introducir este dato en la herramienta GePI autorizando de este modo el consumo de un servicio a dicho certificado o token. Una vez autorizado el consumo del servicio se podrn realizar peticiones al mismo, todas las peticiones tanto con certificado o token usuario/contrasea se harn conforme al estndar WSSECURITY.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

9 /24

El ciclo de consumo completo es el siguiente:

Proveedor servicio Consumidor servicios bus Consume servicio

3
Consume Servicio bus

1
Documento Peticin permiso y datos

2
Asigna permisos Portal catlogo de Servicios Consulta permisos

Servicio1Proxy

OSB

Gestor Interoperabilidad

Servicio1BS

Administracin tcnica plataforma Interoperabilidad

Establece y mide SLAs

2.2

Informacin de Contacto

Para cualquier duda o sugerencia relativa a temas de interoperabilidad y el consumo de servicios de la plataforma pngase en contacto en la direccin de correo siguiente:
esirca_interoperabilidad@gva.es

Manual de usuario para el consumo de servicios instrumentales y de verificacin

10 /24

3 Gua de para el consumo de servicios publicados en la PAI

3.1 Configuracin y requisitos
El cdigo fuente ejemplo que se comenta en esta seccin se puede bajar desde el portal de difusin en la seccin -cmo usar la plataforma?, que se encuentra en el rea de la Plataforma de Interoperabilidad. Binarios de la librera Apache CXF, esta librera contiene las clases necesarias para la generacin del cliente del servicio y el soporte para securizar las peticiones mediante WS-SECURITY. Usaremos la versin 2.4.2. http://cxf.apache.org/ ficheros y documentacin Eclipse : IDE para la implementacin del cliente. Usaremos la versin GALILEO. http://www.eclipse.org/ Plugin de eclipse para Apache CXF, utilizaremos la ltima versin disponible del mismo. Help -> Install New Software en eclipse SoapUI : Herramienta para testeo de WebServices, usaremos la versin 3.6.1 http://www.soapui.org/ Certificado emitido por la GVA no expirado en caso de requerir peticiones firmadas, este certificado es el certificado de aplicacin, deber estar autorizado en el gestor GePI como requisito previo a la generacin del cliente. Token usuario/contrasea autorizado en el gestor GePI, en caso de peticin al bus interno mediante seguridad reducida. Acceso vpn en caso de consumo externo a la DGTI. 3.1.1 Configuracin de las herramientas

3.1.1.1 Librera Apache CXF Nos descargamos la librera Apache CXF, versin 2.4.2 de la siguiente pgina web http://cxf.apache.org/, una vez descargada, descomprimimos los ficheros a una ruta conocida, esta ruta la usaremos para configurar el plugin de eclipse CXF y el soapUI. La carpeta bin contiene los binarios que usa la librera para la generacin de los clientes a partir del wsdl del servicio, etc. La carpeta lib contiene las clases de la librera y sus dependencias. 3.1.1.2 SOAPUI SoapUI es una herramienta para el testeo y generacin de Servicios Web, soporta mltiples libreras y especificaciones WS-*, para poder generar el cliente CXF deberemos indicarle a la herramienta la ruta donde residen la librera que previamente hemos descargado, para ello: Descargamos e instalamos el soapUI 3.6.1 de la web indicada. Arrancamos la aplicacin y vamos File -> Preferences -> Pestaa tools. Apuntamos CXF a donde hayamos descomprimido los binarios de CXF.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

11 /24

3.1.1.3 Configuracin de eclipse Descargamos eclipse GALILEO, si no lo tenemos ya instalado, (en caso de una versin anterior el plugin debera soportarlo tambin), arrancamos el IDE y procedemos a la instalacin del plugin CXF y su configuracin, para ello: Accedemos al men Help -> Install new software Desplegamos la pestaa work with y seleccionamos todos los sitios disponibles. Esperamos a que cargue los datos.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

12 /24

Buscamos CXF e instalamos la ltima versin del plugin. Reiniciamos eclipse cuando lo indique el IDE.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

13 /24

Vamos al men Window -> Preferences. Desplegamos nodo Web Services. Indicamos donde se encuentra la librera CXF que previamente habamos descargado.

3.1.1.4 Generacin del cliente con soapUI Vamos a proceder a la generacin del cliente del servicio, como servicio de pruebas vamos a usar el servicio de envo de correos mediante SMTP, para ello necesitaremos la url del descriptor del servicio en adelante WSDL, el WSDL describe los mtodos del servicio y los parmetros que recibe y enva, as como las excepciones que produce el servicio. La url del WSLD del servicio de SMTP es la siguiente: https://preinterext.gva.es/eSirca_Bus/Proxy/SMTP/SMTP_v1_00?wsdl Como se puede observar el acceso al mismo se hace mediante HTTPS por lo que deberemos tener el certificado del servidor remoto en nuestro keystore de certificados de confianza. Para ello, usaremos una herramienta de gestin de certificados y keystores llamada keytool-ui accesible en la siguiente url http://code.google.com/p/keytool-iui/ y la arrancamos.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

14 /24

Seguimos los siguientes pasos: Descargamos certificado de preproduccin mediante un navegador, (candado de la barra de direcciones), y lo aadimos a $JAVA_HOME\jre\bin\lib\security\cacerts usando keytool mediante la opcin import -> trusted certificate -> Regular certificate como se muestra en la imagen. En ocasiones hay que cambiar temporalmente el nombre del fichero cacerts, (y ponerle la extensin JKS), para que lo pueda abrir la herramienta keytool-ui. Una vez modificado, hay que quitarle la extensin, y dejarlo con el nombre original. El password por defecto del keystore cacerts es changeit

Ahora el wsdl podr ser accesible desde la aplicacin cliente, por lo que procedemos a generar el cliente, para ello hacemos lo siguiente: Creamos un nuevo proyecto con eclipse File -> New -> Other Web -> Dinamic Web Project.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

15 /24

Generamos el cliente con el soap ui Vamos al men Tools -> Apache CXF. Introducimos la url del wsdl del servicio. Introducimos un nombre de paquete segn Otp : es.gva.dgm.ws.xxxxxx

Manual de usuario para el consumo de servicios instrumentales y de verificacin

16 /24

 Apuntamos a la carpeta src del proyecto de eclipse recin creado. Click en solo cliente y pulsamos generate. Refrescamos la carpeta src del proyecto de eclipse y ya tenemos el cliente del servicio generado. La nica clase que tocaremos ser xxxxxxxxxxx_Client.java, que es la que invoca al mtodo elegido proporcionndole los parmetros requeridos. Bsicamente lo que ha ocurrido es que el soapUI, a partir de la descripcin de servicio y usando las herramientas de la librera CXF, nos ha generado un conjunto de clases que nos permiten consumir el servicio de SMTP. Este cliente generado no tiene seguridad de ningn tipo aadida, si el servicio final no tuviese polticas de seguridad activadas podramos consumir el servicio con este cliente directamente.

3.1.1.5 Dependencias Como podemos observar el IDE muestra errores de compilacin, eso es debido a que no hemos aadido al proyecto las dependencias de la librera CXF, para ello haremos lo siguiente:

Manual de usuario para el consumo de servicios instrumentales y de verificacin

17 /24

Creamos carpeta lib colgando de la raz del proyecto Aadimos los jars de la librera CXF: Los jars se encuentran en la carpeta lib de la librera CXF. En este enlace, http://cxf.apache.org/docs/a-simple-jax-ws-service.html se muestran los jars necesarios en funcin de la configuracin del proyecto. Los mnimos para el cliente indicados en la imagen siguiente. Aadimos al classpath los jars aadidos a la carpeta lib pulsando botn derecho sobre el proyecto y pulsamos en Java Build Path, navegamos hasta la carpeta lib y aadimos las libreras.

3.1.1.6 Soporte ws-security con Apache CXF Apache CXF da soporte a WS-SECURITY mediante interceptores de entrada y salida en las invocaciones a servicios. En el interceptor de salida, (ya que estamos consumiendo el servicio), configuramos el tipo de seguridad a utilizar, en caso del uso de certificados para el firmado deberemos configurar el keystore que almacena el certificado que usamos para firmar la peticin, para ello haremos lo siguiente: Creamos un fichero de texto en la carpeta src del proyecto con nombre client_sign.properties, aqu se configura el keystore a utilizar, el alias de la clave privada para firmar, password del keystore, etc. con las siguientes lneas:

Manual de usuario para el consumo de servicios instrumentales y de verificacin

18 /24

#Provider en nuestro caso Merlin org.apache.ws.security.crypto.provider=org.apache.ws.security.components.crypto.Merlin #Ruta al keystore que almacena el certificado a usar org.apache.ws.security.crypto.merlin.file=d:\\somefile.pfx #Tipo de keystore habitualmente JKS o PKCS12 org.apache.ws.security.crypto.merlin.keystore.type=PKCS12 #Clave del keystore org.apache.ws.security.crypto.merlin.keystore.password=secreto Para mas informacin sobre certificados, keystores, etc. Visitar el siguiente enlace: http://cxf.apache.org/docs/ws-security.html enlace con la documentacin, introduccin al uso de certificados, generacin de los mismos con keytool, configuracin del keystore y uso de interceptores CXF. 3.1.1.7 Password Handler Apache CXF gestiona el uso de las claves de los certificados mediante una interfaz llamada CallbackHandler, en nuestro cliente deberemos proporcionar una clase que implemente dicha interfaz para poder usar la clave privada del certificado a fin de firmar las peticiones, para ello: Creamos la clase WsPasswordHandler en el paquete del cliente y copiamos el siguiente cdigo sustituyendo secreto por la clave real del certificado a usar. En entornos productivos se debe parametrizar esto, pero entindase este ejemplo como base de creacin, en la que se pretende mostrar los pasos bsicos gua.
package es.gva.dgm.ws.smtp; import java.io.IOException; import javax.security.auth.callback.Callback; import javax.security.auth.callback.CallbackHandler; import javax.security.auth.callback.UnsupportedCallbackException; import org.apache.ws.security.WSPasswordCallback; public class WsPasswordHandler implements CallbackHandler { public void handle(Callback[] callbacks) throws IOException, UnsupportedCallbackException { for(Callback callback: callbacks) { WSPasswordCallback pwdCallback = (WSPasswordCallback)callback; int usage = pwdCallback.getUsage(); if(usage == WSPasswordCallback.SIGNATURE || usage == WSPasswordCallback.DECRYPT) { pwdCallback.setPassword("secreto"); } } } }

Manual de usuario para el consumo de servicios instrumentales y de verificacin

19 /24

3.1.1.8 Interceptores CXF Existen dos tipos de interceptores CXF. De salida (out) Intercepta peticiones a servicios y permite: WSHandlerConstants.USERNAME_TOKEN (usuario/contrasea) WSHandlerConstants.TIMESTAMP (sello) WSHandlerConstants.SIGNATURE (firma) WSHandlerConstants.ENCRYPT (encriptacin) De entrada (in) Proceso a la inversa para las respuestas del servicio. WSHandlerConstants.DECRYPT (desencriptar) WSHandlerConstants.xxxxx contiene las constantes predefinidas en CXF, para nuestro cliente nicamente usaremos USERNAME_TOKEN para la autenticacin con usuario/contrasea y SIGNATURE para el firmado con certificado. 3.1.1.9 Firmado Para firmar la peticin mediante WS-SECURITY aadiremos el siguiente cdigo al cliente:
//Obtenemos el endpoint del servicio org.apache.cxf.endpoint.Client client = ClientProxy.getClient(port); org.apache.cxf.endpoint.Endpoint cxfEndpoint = client.getEndpoint(); //Creamos un HashMap para almacenar las propiedades del interceptor Map<String, Object> outProps = new HashMap<String, Object>(); //Aadimos la accin que vamos a realizar, en este caso firmar outProps.put(WSHandlerConstants.ACTION, WSHandlerConstants.SIGNATURE); //Alias del certificado a usar como USER (ESPECIFICACION WS_SECURITY) outProps.put(WSHandlerConstants.USER, "alias_clave_certificado* "); //Alias del certificado a usar como SIGNATURE_USER (ESPECIFICACION WS_SECURITY) outProps.put(WSHandlerConstants.SIGNATURE_USER," alias_clave_certificado* "); //Paquete y clase del PasswordHandler que previamente hemos aadido outProps.put(WSHandlerConstants.PW_CALLBACK_CLASS,"es.gva.dgm.ws.smtp.WsPasswordHandle r"); //Fichero de properties que almacena los datos del keystore outProps.put(WSHandlerConstants.SIG_PROP_FILE, "client_sign.properties"); //Indicamos que haga referencia por ID a la firma (ESPECIFICACION WS_SECURITY) outProps.put(WSHandlerConstants.SIG_KEY_ID, "DirectReference"); //Creamos el interceptor y se lo asociamos al endpoint del cliente WSS4JOutInterceptor wssOut = new WSS4JOutInterceptor(outProps); cxfEndpoint.getOutInterceptors().add(wssOut);

* El alias del certificado lo podemos consultar mediante keytool-ui visualizando el keystore, o mediante la orden:

Manual de usuario para el consumo de servicios instrumentales y de verificacin

20 /24

keytool -list -v -keystore somefile.pfx -storetype pkcs12 siendo somefile.pfx el certificado usado en el ejemplo para firmar la peticin.

3.1.1.10 Parmetros del servicio En este punto tenemos un cliente operativo con la configuracin de seguridad asociada mediante un interceptor cxf de salida, nicamente nos queda proporcionar parmetros vlidos a la llamada al servicio para poder ejecutar el cliente, para ello haremos lo siguiente: Introducimos los parmetros de la llamada al servicio segn documentacin funcional del servicio. En el caso del servicio SMTP modificaremos el cliente con los siguientes parmetros:

//From el que manda el email java.lang.String _send_sendFrom = "simac@gva.es"; //Subject del email java.lang.String _send_subject = "prueba cliente smtp"; //Array de destinatarios del correo java.util.List<java.lang.String> _send_sendTo = new ArrayList<String>(); _send_sendTo.add(foovar@email.com"); //CC destinatarios en copia (opcional) java.util.List<java.lang.String> _send_sendCC = null; //BCC destinatarios en copia oculta (opcional) java.util.List<java.lang.String> _send_sendBCC = null; //Urls de los adjuntos del correo, deben ser visibles desde el servidor de correo //(opcional) java.util.List<java.lang.String> _send_attachments = null; //Texto del correo java.lang.String _send_texto = "Hola mundo"; A continuacin, podemos ejecutar el cliente del servicio haciendo click con el botn derecho del ratn sobre el proyecto y elegimos una de las dos opciones. Run as -> java aplication Debug as -> java aplication

Manual de usuario para el consumo de servicios instrumentales y de verificacin

21 /24

3.1.1.11 Generacin del cliente con el plugin de eclipse Nos descargamos el wsdl y el xsd del servicio a una carpeta del proyecto

Manual de usuario para el consumo de servicios instrumentales y de verificacin

22 /24

Sobre el wsdl botn derecho New -> Other Web Services -> Web Service client

Seleccionamos CXF como web service runtime Generamos el cliente

Manual de usuario para el consumo de servicios instrumentales y de verificacin

23 /24

Copiamos los interceptores y los parmetros de los puntos anteriores en funcin del tipo de autenticacin que queramos usar.

Ahora podemos ejecutar el cliente del servicio haciendo click con el botn derecho del ratn sobre el proyecto y elegimos una de las dos opciones. Run as -> java aplication Debug as -> java aplication

Para consumir el resto de servicios publicados en la plataforma seguiremos los mismos pasos que se han descrito en el presente manual, nicamente cambiaran los wsdl de servicio y los parmetros de los mtodos a configurar segn la documentacin de cada servicio.

Manual de usuario para el consumo de servicios instrumentales y de verificacin

24 /24