Oracle Service Bus y Oracle Service Registry Taller Tcnico

1 de 103

CONTROL DE DOCUMENTO

Registro de Cambios
103

Fecha 18/03/2009 04/06/2009 15/06/2009 09/07/2009

Autor Jess Guerra Jess Guerra Jess Guerra Jess Guerra

Empresa Oracle Oracle Oracle Oracle

Versin 0.0.0.0.0 7.1 7.5 7.6

Referencia de Cambios Versin Inicial. Modificaciones en el apartado de requerimientos Correccin de erratas Correccin de erratas

2 de 103

ndice de Contenidos

CONTROL DE DOCUMENTO ................................................................................................................................. 2 Registro de Cambios ....................................................................................................................................... 2 INTRODUCCIN ............................................................................................................................................... 5 INSTRUCCIONES DE INSTALACIN ....................................................................................................................... 6 Requisitos previos .......................................................................................................................................... 6 Instalacin ..................................................................................................................................................... 6 INTRODUCCIN A OSB Y OSR...................................................................................................................... 7 CARACTERSTICAS PRINCIPALES .......................................................................................................................... 7 CASOS DE USO .................................................................................................................................................... 8 PRESENTACIN DE PRODUCTO ............................................................................................................................ 8 CONFIGURACIN DE SERVICIOS EN OSB .............................................................................................. 12 LABORATORIO I ................................................................................................................................................ 12 Publicacin de un servicio sobre OSB......................................................................................................... 13 CONFIGURACIN DE SERVICIOS DE VALOR AADIDO.................................................................... 26 LABORATORIO II ............................................................................................................................................... 26 Orquestacin de servicios (servicios de valor aadido) .............................................................................. 27 ADMINISTRACIN DE OSB.......................................................................................................................... 40 LABORATORIO III.............................................................................................................................................. 41 Configuracin de alertas sobre servicios desplegados en el bus................................................................. 41 Audit y log en OSB....................................................................................................................................... 47
Creacin de una traza de log en un proxy service ...................................................................................................... 47 Creacin de un informe de ejecucin de un servicio proxy ....................................................................................... 49

SEGURIDAD EN OSB ...................................................................................................................................... 52 LABORATORIO IV ............................................................................................................................................. 52 Preparacin de la prctica .......................................................................................................................... 52 Securizacin de un servicio a nivel de transporte........................................................................................ 53 Securizacin de un servicio a nivel de mensaje ........................................................................................... 57 Aplicacin de firma digital a un servicio publicado en OSB ....................................................................... 62 INTEGRACIN OSB OSR............................................................................................................................ 67 WORKSHOP OSR .............................................................................................................................................. 68 Introducin a OSR ....................................................................................................................................... 68 LABORATORIO V............................................................................................................................................... 74 Publicacin e Importacin de servicios entre OSR y OSB .......................................................................... 74 Importacin de un servicio sobre OSB ........................................................................................................ 74 Publicacin de un servicio sobre OSR......................................................................................................... 77 APNDICES....................................................................................................................................................... 80 CONTROL DEL SERVIDOR OSB .......................................................................................................................... 80 CONTROL DEL SERVIDOR OSR .......................................................................................................................... 81 INSTALACIN DE OSB....................................................................................................................................... 81 Instalacin de OSB 3.0 ................................................................................................................................ 82

3 de 103

Configuracin de un dominio de OSB ......................................................................................................... 85 ORACLE WORKSHOP Y TRANSFORMACIONES DE DATOS .................................................................................... 89 TRANSFORMACIONES XQUERY UTILIZADAS EN EL WORKSHOP ......................................................................... 89 INSTALACIN OSR............................................................................................................................................ 91 CONFIGURACIN DE COMUNICACIN OSB Y OSR .......................................................................................... 100

4 de 103

Introduccin
El objetivo del curso es el acercamiento tcnico por parte de los asistentes a la propuesta tcnica de Oracle en el mbito de la publicacin de servicios y plataformas de tipo Enterprise Service Bus (ESB) y UDDI. El taller, desde un enfoque eminentemente prctico, se desarrollar en base a distintas prcticas que los asistentes realizarn en sus propios equipos contando con el apoyo de documentacin y la colaboracin de un experto en ambos productos. Los asistentes dispondrn al finalizar el curso con los conocimientos suficientes para crear, publicar y monitorizar servicios sobre OSB y OSR.

A quin va destinado?
Tcnicos con o sin experiencia en arquitectura SOA Arquitectos de sistemas SOA

La siguiente tabla contiene los datos de inters para el desarrollo de cada una de las prcticas que componen el Workshops Productos instalados en la mquina virtual Scripts de arranque y parada Usuarios Direcciones Oracle Service Bus (OSB) Oracle Service Registry (OSR) OSB: Vase el Apartado 0 Control del servidor OSB (pg. 80) OSR: Vase el Apartado 0 Control del servidor OSR (pg. 81) OSB: Usuario administrador: weblogic, password: weblogic OSB: Usuario administrador: admin, password: weblogic OSB: URL de la consola de administraccin: http://workshop-osbosr-server:7001/sbconsole OSR: consola de usuarios: http://workshop-osb-osrserver:8080/uddi/bsc/web

Soluciones de los laboratorios

El DVD que con el material del curso contiene las soluciones de todos los laboratorios. Consltese el directorio C:\osb.workshop\documentacin\laboratorios.soluciones

5 de 103

INSTRUCCIONES DE INSTALACIN
Requisitos previos
Todas las prcticas han sido testeadas con los sistemas operativos Microsoft Windows XP y Microsoft Windows 2003 Server. Es necesario disponer de 5GBs de espacio en disco. El espacio en disco debe estar disponible en la unidad C: Memoria RAM minima requerida: 15Gb

Instalacin
Editar el fichero hosts de la mquina (ruta: C:\WINDOWS\system32\drivers\etc) y aadir una entrada como la que se muestra a continuacin: ip_maquina ip_maquina workshop-osb-osr-server osb-workshop-machine

Donde ip_maquina es la IP de la mquina donde se desarrollarn las prcticas. Extraer el contenido del fichero osb.workshop versin OSB 10gR3 para Windows-.rar al directorio raz de la unidad C:

6 de 103

Introduccin a OSB y OSR

(30 minutos) Oracle Service Bus (OSB) tiene como objetivo eliminar las costosas integraciones de servicios punto a punto que limitan la capacidad de la organizacin para desplegar servicios heterogneos. El bus realiza una labor de intermediario, sin estado y con un extraordinario rendimiento que apenas introduce latencia en la integracin. OSB permite un desacoplamiento entre clientes de servicios (llamados consumidores) y servicios empresariales (llamados proveedores), sean cuales sean sus tecnologas. OSB proporciona un punto centralizado de control de seguridad, supervisin y obligatoriedad en el cumplimiento de los SLA. Los cambios en las relaciones entre servicios se implementan de forma dinmica, mediante configuracin, sin codificacin.

CARACTERSTICAS PRINCIPALES
Enrutamiento inteligente mediante configuracin, si desarrollo Soporte de transportes heterogneos entre puntos finales de servicio, tanto de entornos Java, como Mainframe, .NET, SAP y otros. Intermediacin de mensajera inteligente. Transformacin dinmica de mensajes. Supervisin proactiva de la salud y la disponibilidad de la infraestructura. Cuadro de control grfico, flexible y ampliable. Registro centralizado de servicios para publicacin y reutilizacin de servicios. Suministro simplificado de servicios. Seguridad configurable impulsada por polticas. Cumplimiento de SLA impulsado por reglas.

Oracle Service Bus (OSR) es un registro de servicios que proporciona la gestin de los metadatos de runtime asociados a los servicios o artefactos SOA. Proporciona el punto nico de visibilidad y control de todas las actividades de interoperatividad de los servicios. Dada su importancia en SOA, el registro proporciona funcionalidad por encima y ms all del estndar UDDI para soportar gestin avanzada de clasificacin y taxonoma, funciones de seguridad y asignacin de informacin, como WSDL y esquemas XML segn las mejores prcticas.

7 de 103

OSR gestiona todos los metadatos necesarios para acceder en runtime a un determinado servicio, tales como descripciones del servicio, su localizacin, internacionalizacin, puntos finales, opciones de dicho servicio, parmetros de calidad, polticas de seguridad y otros.

CASOS DE USO
Una vez se han desarrollado un servicio y ya est listo para entrar en produccin, se despliega encima de AquaLogic Service Bus, y de forma coordinada OSB se encarga de publicarlo en OSR. OSR maneja los metadatos de gestin de dicho servicio, especialmente por todos aquellos datos relacionados con la capacidad de binding de dicho servicio por parte del cliente. OSR acta como si fuera un ndice de los metadatos y polticas de runtime asociados a los artefactos del servicio

PRESENTACIN DE PRODUCTO

8 de 103

9 de 103

10 de 103

11 de 103

Configuracin de servicios en OSB

(30 minutos) La configuracin de servicios sobre OSB se basa en la creacin de un elemento de configuracin de transporte (business service) y de un elemento de interaccin (proxy service) La utilizacin de ambos elementos proporciona transparencia respecto a la localizacin de los servicios, permitiendo minimizar el impacto de la sustitucin de los mismos. Puede encontrarse informacin complementaria en la direccin http://edocs.bea.com/OSB/docs30/concepts/overview.html#wp1072171

LABORATORIO I
El laboratorio se basa en la publicacin de un servicio web remoto sobre OSB.

12 de 103

Resumen de operaciones
Los pasos a seguir para la publicacin de un servicio web son: Creacin de un proyecto y carpetas para alojar los elementos a crear (WSDL, Business service, Proxy service, ) Este paso es opcional Publicacin del fichero de definicin del servicio remoto (WSDL) Configuracin del binding a dicho servicio (Business service) Configuracin del punto de acceso sobre el bus para las aplicaciones cliente (Proxy service)

Publicacin de un servicio sobre OSB Acceso a la consola de OSB y creacin de una sesin
1) Arrancar el servidor OSB tal como se muestra en el Apndice I de este manual (pg. 80) 2) Desde un navegador, accederemos a la direccin http://workshop-osb-osr-server:7001/sbconsole que es la direccin de la consola de administracin de OSB (usuario administrador: weblogic, password: weblogic)

3) Una vez logado con las credenciales de administrador (weblogic/weblogic) Es necesario crear una sesin pulsando el botn Create

Creacin de un proyecto y carpetas para almacenar recursos

13 de 103

4) Crearemos en primer lugar un nuevo proyecto donde configuraremos todos los servicios. Para crear un proyecto, es necesario seleccionar en el men de la izquierda la opcin Projects y luego Add Project. Tal como se muestra en la figura, el nombre del nuevo proyecto ser Workshop.

5) Tras crear el proyecto, crearemos las carpetas: Proxies, Bindings, Servicios y Herramientas tal como se muestra en la siguiente figura.

6) El aspecto del proyecto ser similar al de la figura.

14 de 103

Importar fichero de definicin del servicio remoto (wsdl)

7) Procederemos a continuacin a importar los ficheros wsdl de definicin de los servicios. Para ello, en primer lugar seleccionar la carpeta Servicios del men de la izquierda. Despus desplegar la caja de seleccin de la opcin Create Resource y como tipo de recurso Resources from URL.

8) En la siguiente pantalla introducir los siguientes datos y pulsar el botn Next

15 de 103

URL/Path Resource Name Resource Type

http://workshop-osb-osr-server:7001/AplicacionTest/InformacionClienteWS?WSDL

InformacionClienteWS WSDL

9) El sistema nos pide la confirmacin para importar el elemento. Pulsar Import

10) El sistema nos informa de que la operacin se ha realizado correctamente

Creacin del binding sobre dicho servicio (Business service)

11) Creacin de business services en OSB (binding)

16 de 103

Una vez importados los ficheros de definicin de los servicios remotos, es necesario configurar los puntos de acceso o binding a los mismos. Dichos elementos se denominan business services en OSB. 12) Seleccionando en el men de la izquierda la carpeta Bindings, procederemos a crear un nuevo recurso de tipo Business Service tal como se muestra en la figura.

13) Indicar los parmetros del nuevo servicio tal como se muestra en la tabla. Pantalla: General Configuration Service Name Service Type Parmetros del Web Service InformacionClienteBS WSDL Web Service Es necesario pulsar el botn Browse

En la pantalla que aparece seleccionar el servicio InformacionClienteWS tal como muestra la figura

17 de 103

En la siguiente pgina seleccionar la opcin InformacionClienteWSSoapPort y pulsar el botn Submit para finalizar la operacin

NOTA: Diferencias entre Port y Binding

Binding: define el protocolo y los formatos de mensaje para cada una de las operaciones definidas en el servicio web Port: combina un binding con una direccin (endpoint) donde se ejecuta el servicio

Resto de opciones Pantalla: Transport Configuration Opciones

Valores por defecto

Valores por defecto NOTA: en caso de que el parmetro Existing URI aparezca vaco

Es necesario introducir el valor: http://workshop-osb-osr-server:7001/AplicacionTest/InformacionClienteWS

18 de 103

y pulsar el botn Add

Pantalla: HTTP Transport Configuration Opciones Pantalla: SOAP Binding Configuration Opciones Pantalla: Message Content Handling Opciones Valores por defecto Valores por defecto Valores por defecto

14) Finalizado el proceso de configuracin aparecer la pantalla de resumen. Pulsar Save para finalizar el proceso.

19 de 103

15) El sistema informa de que el servicio binding se creado correctamente.

Creacin del punto de acceso para las aplicaciones cliente (Proxy service)
16) Creacin de servicios proxy Una vez creados los bindings a los servicios remotos, procederemos a la creacin de los servicios proxy. Estos servicios son los invocados por las aplicaciones cliente del bus. 17) De forma similar a como hemos hecho con los business services, seleccionaremos en este caso la carpeta Proxies en el men de la izquierda. Despus, seleccionaremos la opcin Create Resource, indicando en este caso como tipo de recurso Proxy Service.

20 de 103

18) Indicar las opciones de creacin del proxy service tal como se muestra en la siguiente tabla. General Configuration Service Name Service Type InformacionClientePS Seleccionar la opcin Business Service y pulsar el botn Browse tal como muestra la figura.

En la ventana emergente seleccionar el elemento InformacionClienteBS de la lista y pulsar Submit

Resto de opciones Transport Configuration Opciones HTTP Transport Configuration Opciones Operation Selection Configuration Opciones Message Content Handling Opciones

Valores por defecto

Valores por defecto

Valores por defecto

Valores por defecto

Valores por defecto

19) En la pantalla de resumen, pulsar Save con lo que el servicio proxy quedar configurado.

21 de 103

Activar la sesin para consolidar los cambios realizados

20) Para activar los cambios realizados en la sesin, pulsaremos el botn Activate e introduciremos una descripcin de dichos cambios en la pantalla que aparece tal como se muestra en la figura. Por ltimo pulsar el botn Submit

21) El sistema nos informa de que la operacin se ha realizado con xito.

22 de 103

Test del servicio

22) Test de los servicios publicados en OSB. Una vez configurados los servicios, es posible realizar un test de los mismos desde la consola de administracin de OSB. 23) Pulsar el icono debugger tal como se muestra en la figura.

24) Aparecer una pantalla como la que se muestra en la figura en la que podemos configurar el mensaje de entrada al servicio que queremos testear.

23 de 103

25) Tras pulsar el botn Execute se efecta una ejecucin del servicio proxy seleccionado y el sistema nos muestra una ejecucin depurada de la ejecucin del servicio. En la parte inferior puede trazarse la ejecucin del proxy service y la invocacin de los diferentes servicios que se hayan realizado.

24 de 103

25 de 103

Configuracin de servicios de valor aadido

(30 minutos) Adems de las operaciones de enrutado bsico estudiadas en el apartado anterior, OSB permite aadir acciones adicionales en la invocacin y ejecucin de los servicios publicados. La secuencia de estas operaciones se denomina "pipeline". Cada accin dentro de un "pipeline" es un nodo de procesamiento que permite realizar operaciones de enriquecimiento y transformacin de los mensajes, llamadas a servicios intermedios, sentencias de flujo de control (if, for-each, while, stop, ...) y operaciones de control (alertas, reports, lanzamiento de excepciones, ...) En cuanto a transformacin y gestin de mensajes, OSB soporta un amplio nmero de estndares como XQuery, Xpath, XSLT, MFL, ... As mismo, OSB permite la interconexin con diferentes motores de reglas (iLog, etc.) utilizando diferentes estndares como SOAP, JMS, EJB, utilizacin de objetos POJO, etc.

LABORATORIO II
El laboratorio se basa en la configuracin de un servicio de valor aadido sobre OSB. Para ello tomaremos como base el siguiente supuesto: Existen dos servicios remotos desplegados sobre OSB: InformacionCliente-BS y ScoringCliente-BS El servicio remoto ScoringCliente-BS toma como dato de entrada el DNI del cliente. Dicho dato es accesible invocando al servicio de informacin de clientes. Se quiere crear un nuevo servicio proxy ScoringCliente-PS que devuelve el ratio de crdito de un cliente utilizando como dato de entrada el parmetro idCliente (distinto al DNI). Dicho servicio realizar internamente la llamada al servicio de clientes e invocar las transformaciones necesarias.

El siguiente grfico muestra la operativa del nuevo servicio

26 de 103

Resumen de operaciones
Las operaciones a realizar en la ejecucin del laboratorio son las que se enuemeran a continuacin: Creacin de una sesin sobre la consola de OSB Publicacin del servicio remoto de Scoring Creacin del proxy service para el servicio de Scoring Publicacin de las XQuery (transformaciones de datos) Composicin de la lgica del servicio de Scoring Activar la sesin para consolidar los cambios realizados Test del servicio

Orquestacin de servicios (servicios de valor aadido) Creacin de una sesin sobre la consola de OSB
1) Abrir una sesin sobre la consola del OSB

Publicacin del servicio remoto de Scoring

2) Siguiendo las instrucciones del Laboratorio I publicar el servicio remoto ScoringClienteWS (pasos 7 a 10) y el Business service ScoringCliente-BS (pasos 11 a 15) La informacin a introducir para cada uno de los servicios es la que se muestra en las siguientes tablas.

27 de 103

Para el WSDL: URL/Path Resource Name Resource Type http://workshop-osb-osr-server:7001/AplicacionTest/ScoringClienteWS?WSDL ScoringClienteWS WSDL

Para el Business Service: General Configuration Service Name Service Type Parmetros del Web Service Resto de opciones Transport Configuration Opciones HTTP Transport Configuration Opciones SOAP Binding Configuration Opciones Message Content Handling Opciones Valores por defecto Valores por defecto Valores por defecto Valores por defecto ScoringClienteBS WSDL Web Service Workshop/Services/ScoringClienteWS (port) ScoringClienteWSSoapPort Valores por defecto

Comprobacin La carpeta Workshop/Bindings debe contener los siguientes servicios

Y la carpeta Workshop/Servicios estos otros:

Creacin del proxy service para el servicio de Scoring

3) Crear el servicio proxy ScoringClientePS siguiendo las instrucciones de los pasos 16 a 19 del Laboratorio I. Los datos a introducir en cada una de las pantallas es la que se detalla en la siguiente tabla General Configuration Service Name Service Type ScoringClientePS Create From Existing Service. Seleccionar Workshop/Bindings/ScoringClienteBS

28 de 103

Resto de opciones Transport Configuration Opciones HTTP Transport Configuration Opciones Operation Selection Configuration Opciones Message Content Handling Opciones

Valores por defecto

Valores por defecto

Valores por defecto

Valores por defecto

Valores por defecto

Comprobacin La carpeta Workshop/Proxies debe contener los siguientes servicios

Publicacin de las XQuery (transformaciones de datos)

4) En la prctica sern necesarias dos transformaciones de mensajes XML que hemos creado previamente 1. Ser necesario importar ambos recursos en OSB. Para ello, seleccionar la carpeta Herramientas

5) Para crear un nuevo elemento desplegar la lista de seleccin y elegir el elemento XQuery tal como muestra la imagen

Las transformaciones se han creado grficamente utilizando la herramienta Oracle Workshop. Para estudiar la creacin de las mismas vase la seccin 0 Oracle Workshop y transformaciones de datos en la pgina 89

29 de 103

6) Pulsando en el botn Examinar seleccionaremos el fichero cuya ruta es C:\osb.workshop\documentacin\ficheros_auxiliares\DeInfoClienteAScoring.xq

7) Por ltimo pulsar el botn Save

30 de 103

8) El sistema informa de que la operacin se ha realizado correctamente

9) Repetir los pasos 5, 6 y 7 con el fichero C:\osb.workshop\documentacin\ficheros_auxiliares\DeScoringAInfoClientes.xq Comprobacin El contenido de la carpeta Workshop/Herramientas debe ser similar al mostrado en la siguiente figura

31 de 103

Composicin de la lgica del servicio de Scoring

10) A continuacin vamos a modificar el Message Flow del servicio ScoringClientePS. Para ello pinchamos el icono que se muestra en la siguiente imagen

11) Pulsar el botn izquierdo del ratn sobre el icono ScoringClientePS tal como muestra la figura. Seleccionar la opcin Add Pipeline Pair

12) Pulsar el botn izquierdo del ratn sobre el icono Request Pipeline tal como muestra la figura. Despus, seleccionar la opcin Add Stage

32 de 103

13) Ser en este stage o punto de orquestacin de servicios donde incluiremos las operaciones complementarias del servicio de scoring. Pulsar el botn izquierdo del ratn sobre el icono stage1 tal como muestra la figura. Despues, seleccionar la opcin Edit Stage

14) La primera operacin a realizar ser realizar una transformacin sobre el mensaje de entrada al servicio (servicio de scoring) para crear un mensaje de entrada al servicio de informacin de clientes. Para ello utilizaremos la transformacin DeScoringAInfoCliente Pinchando sobre el enlace Add an Action seleccionaremos en los mens emergentes la opcin Assign tal como se muestra en la siguiente figura.

15) Pinchar en el enlace Expression y en la siguiente pantalla la opcin XQuery resources tal como muestra la figura.

16) Pulsar el botn Browse y en la ventana emergente seleccionaremos el recurso DeScoringAInfoCliente. Por ltimo pulsar Submit.

33 de 103

17) En el contenido de la variable getScoring1 introducir la expresin xpath $body/ser:getScoring. La variable $body hace referencia al mensaje de entrada al servicio. Por ltimo pulsar Save

18) Indicar como nombre de la variable donde obtendremos el valor resultante de la transformacin NumeroCliente

19) Procedemos a continuacin a introducir la llamada al servicio InformacionCliente-BS en el flujo del servicio. Para ello pinchar con el botn izquierdo del ratn tal como se muestra en la figura y en los mens emergentes seleccionaremos la opcin Service CallOut

34 de 103

20) Para seleccionar el servicio a invocar, pincharemos en el enlace Service tal como muestra la figura y seleccionaremos el servicio InformacionClienteBS. Por ltimo seleccionar Submit

21) Seleccionar la operacin getInfo tal como se muestra en la figura.

22) Como variable Request seleccionar NumeroCliente y como variable Response InformacionCliente

35 de 103

23) Una vez invocado el servicio, ser necesario obtener el valor identificador del cliente del mensaje de salida. Este valor se utilizar como parmetro de entrada al servicio de routing. Esta operacin se realizar utilizando otra operacin de transformacin. Pinchar en el icono tal como se muestra en la siguiente figura. Despues, en los mens emergentes seleccionar la opcin Replace

24) Pinchar en el enlace XPath

25) Introducir . en el Editor y pulsar Save

36 de 103

26) Como variable seleccionamos body. Indicar la opcin Replace Node Contents Por ltimo seleccionar el enlace Expression

27) Seleccionar el enlace XQuery resources. Despues buscar la XQuery DeInfoClienteAScoring. Como valor de la variable indicar $InformacionCliente/ban:Cliente Por ltimo, pulsar Save

28) Pulsar Save All para guardar todos los cambios efectuados

37 de 103

29) El sistema nos informa de que las operaciones se han realizado correctamente.

Activar la sesin para consolidar los cambios realizados

30) Consolidar los cambios realizados

31) Escribir una descripcin de los cambios efectuados y pulsar el botn Activate

38 de 103

Test del servicio

Para testear el servicio creado podemos utilizar el debugger

39 de 103

Administracin de OSB
(30 minutos) Las operaciones de configuracin, monitorizacin y administracin de OSB se realizan a travs de una consola web grfica que no requiere instalacin en los puestos remotos. OSB Proporciona la capacidad de monitorizar y agregar informacin de ejecucin necesaria para la operacin de los sistemas. Realiza la agregacin de informacin estadstica a travs de unos cuadros de mando. Este sistema facilita la monitorizacin del estado de todo el sistema (incluido el cluster) y notifica en el caso de que se generen alertas en alguno de los servicios (va SNMP, JMS y/o email). Con esta informacin se puede aislar fcil y rpidamente el diagnstico de los problemas que puedan estar sucediendo. La administracin de OSB (http://edocs.bea.com/OSB/docs30/consolehelp/systemadmin.html#wp1063056 ) se puede realizar a travs de diferentes roles: Administrador, Implantador, Operador y Monitorizador. Cada usuario, dependiendo del rol/roles con que acceda tendr acceso a realizar slo determinadas operaciones. Un centro de control de cambios (http://edocs.bea.com/OSB/docs30/consolehelp/changecenter.html) permite la posibilidad de realizar diferentes operaciones sobre el mismo sistema simultneamente por diferentes usuarios sin interferencia entre unos y otros, notificado en el momento de la actualizacin de cualquier posible incompatibilidad que pueda surgir. Otras posibilidades de administracin de OSB: Establecimiento de niveles y disponibilidad de servicio. La consola de administracin de OSB posibilita la asignacin de prioridades a la ejecucin de los servicios en funcin de distintas mtricas (perfil del usuario, tasa de utilizacin del sistema, condiciones de overflow, etc.) As mismo, es posible definir reglas de disponibilidad de servicio en base a criterios como (franjas horarias, disponibilidad de sistemas, campaas de marketing y de oferta de productos, etc.) Todas estas operaciones se realizan va configuracin y, en caso de ser necesario, es posible la ejecucin de scripts automticos para la administracin y gestin de servicios. Definicin de alertas. Uno de los aspectos de intermediacin de servicios que soporta OSB es la definicin y gestin de alertas de servicio. Entendiendo que una alerta es una seal que el sistema generar a lo largo de la ejecucin de un servicio, es posible definir distintos tipos de alertas desde la consola de administracin de OSB: alertas sobre condiciones de error y excepcin en la ejecucin de los servicios, alertas basadas en SLAs y alertas configurables. Estas ltimas son aquellas definidas en concepto de calidad y requerimientos del servicio como pueden ser: contenido errneo de los mensajes de entrada/salida del mensaje, usuarios en listas negras, invocacin denegada de servicios en funcin del origen del cliente, del destino seleccionado o de la franja horaria, etc.) OSB contempla la gestin de dichas alertas sobre diferentes mecanismos: cuadros de mando en la propia consola de administracin del entorno y/o generacin de mensajes JMS, correo electrnico y SNMP. Gestin del ciclo de vida de los servicios. OSB cubre las fases que se enumeran a continuacin en el ciclo de vida de gestin de los servicios: o Orquestacin y modelado de servicios: la consola de administracin y configuracin de OSB posibilita la configuracin de servicios en aspectos como el enrutado, enriquecimiento y la transformacin de mensajes dentro de los mismos. Creacin de servicios: una vez el servicio ha sido configurado, OSB incluir automticamente la informacin UDDI del mismo dentro del registro del sistema (OSR) Desde all, va introspeccin, se incluir la metainformacin del servicio sobre el catlogo (ALER) Despliegue de servicios: OSB conforma la plataforma de intermediacin de servicios (broker). El despliegue de los servicios definidos se realiza sobre dicha plataforma, eliminando de este modo las conexiones punto-a-punto entre los distintos sistemas.

40 de 103

LABORATORIO III
El siguiente laboratorio muestra algunas de las funcionalidades de monitorizacin de servicios de OSB. Se definir en el mismo una condicin de nivel de servicio (SLA) sobre uno de los servicios desplegados de tal modo que si en la ejecucin del mismo se sobrepasa el tiempo mximo indicado, se lanzar una alerta a la consola de monitorizacin de OSB.

Configuracin de alertas sobre servicios desplegados en el bus

A efectos de demostracin, se ha incluido en el servicio TestAlertasSLA-PS un retardo con objeto de que se activen las alertas SLA que se definen en la prctica. Para realizar la siguiente prctica importaremos los recursos directamente. 1) Abrir una sesin sobre la consola de OSB pulsando el botn Create 2) En el men de la izquierda seleccionar la opcin System Administration

3) Seleccionar la opcin Import Resources. Despues, pulsando Browse seleccionaremos el fichero C:\osb.workshop\documentacin\ficheros_auxiliares\Laboratorio3-recursos.jar Por ltimo, pulsar el botn Next

4) Pulsar Import

41 de 103

5) El sistema nos informa de los electos importados.

6) Despues, seleccionar el proxy service sobre el que vamos a generar la alerta. En nuestro caso el servicio TestAlertasSLA-PS. Para definir una alerta, es necesario pulsar sobre el nombre del servicio tal como se muestra en la figura.

42 de 103

7) Pinchar en la pestaa SLA Alert Rules y pulsar el botn Add New.

8) Indicar el contenido de los campos tal como se muestra en la siguiente figura. Despus pulsar Next.

43 de 103

9) Seleccionar como Aggregation Interval 1 minuto. Indicar los parmetros de la alerta a configurar tal como se muestra en la figura. Despus pulsar Add.

10) De este modo queda configurada una alerta SLA que se activar cuando el tiempo de respuesta del servicio supere 1 sg. Pulsar Last para continuar con el proceso de configuracin de la alerta.

44 de 103

11) Pulsar Save en la pantalla de resumen de la configuracin. De este modo finaliza el proceso de configuracin de la alerta SLA.

12) El sistema indica que la alerta ha sido creada. No olvidar pulsar el botn Activate para que la configuracin tenga efecto.

45 de 103

13) Para chequear el funcionamiento de la alerta lanzaremos el debug del servicio proxy TestAlertasSLAPS.

14) Desactivar la opcin Direct call, modificar el valor del mensaje de entrada ser:tiempo a 3000 para forzar que se active la alarma. Por ltimo pulsar el botn Execute.

15) En function del aggregation interval seleccionado, se irn recibiendo las alertas en la consola de administracin de OSB como se muestra en la figura.

46 de 103

Audit y log en OSB

Las siguientes prcticas muestran las funcionalidades de log y audit de OSB. Creacin de una traza de log en un proxy service 1) Del mismo modo que hemos hecho anteriormente, es necesario activar una sesin (botn Create) sobre OSB para introducir trazas y elementos de auditoria sobre los servicios desplegados. Despus seleccionaremos el icono de la pipe line del servicio ScoringClientePS.

2) Seleccionar el icono stage1 y con el botn derecho izquierdo la opcin Edit Stage.

3) Vamos a incluir una traza del mensaje de respuesta del servicio de informacin de clientes. Para ello, pinchamos con el botn derecho sobre el icono como se muestra en la figura y en los mens emergentes seleccionamos la opcin Log.

47 de 103

3) Aparecer un template de accin de tipo Log como el que se muestra en la figura. Pulsar en el link Expression para introducir la traza.

4) Introduciremos $InformacionCliente tal como se muestra en la figura para tracear el mensaje de respuesta del servicio. Despues pulsar Save

5) Rellenar el resto de campos de la accin Log tal como se muestra en la figura. Despus pulsar Save All. Por ltimo, ser necesario activar la sesin para que los cambios tengan efecto.

48 de 103

6) Realizar una ejecucin del servicio tal como se indica utilizando para ello el debugger. En la consola del servidor de OSB aparecer una traza similar a la que se muestra en la imagen.

Creacin de un informe de ejecucin de un servicio proxy 1) La creacin de una traza de auditora ( report) sobre OSB se realiza siguiendo el procedimiento indicado en el punto anterior. En este caso seleccionaremos la accin Report. Seguimos los pasos 1, 2 y 3 descritos en la prctica anterior seleccionando en este caso la opcin Report en lugar de Log en los mens emergentes.

2) Aparece el template de la accin de tipo Report. Pinchar en el enlace Expression.

49 de 103

3) Introducir el valor $body para que en el informe quede registrado el valor del mensaje de entrada al servicio. Despues pulsar Save

4) Es necesario introducir una etiqueta en el informe. Para ello pinchamos en el enlace Add a Key. Como Key name seleccionaremos Cliente. Despus, pulsar el enlace Xpath para indicar el valor que utilizaremos como clave del informe.

5) Tal como se muestra en la figura, introducir la expresin ./ser:getScoring/ser:documentoIdentificacion/text() Por ltimo pulsar Save.

50 de 103

6) Indicar body en el valor de la variable y pulsar Save All.

7) Tras activar los cambios de la sesin (botn Activate), ejecutar de nuevo el servicio ScoringClientePS utilizando como identificadores de cliente diferentes valores (p.e: 1111 y 2222). Hecho esto, seleccionar en la consola de administracin de OSB la opcin Operations/Reporting/Message Reports con lo que aparecer el ndice de los informes generados sobre la ejecucin de los servicios configurados en el bus, tal como se muestra en la imagen.

51 de 103

Seguridad en OSB
(30 minutos) OSB permite la definicin de polticas de seguridad con el objetivo de cubrir los siguientes aspectos de seguridad del entorno: Definicin de grupos de usuarios y conectividad con Repositorio de Identidades. De este modo se garantiza el acceso a la informacin adecuada por parte de las personas autorizadas. Proteccin frente a intrusiones internas o externas mediante el soporte de diferentes estndares de encriptacin, cifrado y seguridad (autenticacin bsica o por certificados digitales, WS-security, WSencrypt, XML-Sign, ) tanto a nivel de transporte como de los mensajes implicados en el consumo de servicios. Evitar problemas de mal funcionamiento o prdida de informacin.

LABORATORIO IV
La siguiente prctica tiene como finalidad mostrar las funcionalidades de aplicacin de polticas de seguridad sobre los servicios desplegados en OSB.

Preparacin de la prctica
Para facilitar el desarrollo de la prctica se ha creado una serie de servicios a los que se le aplicarn diferentes polticas: Autenticacin a nivel de transporte Autenticacin a nivel de mensaje Firma digital a nivel de mensaje

Ser necesario por tanto importar dichos servicios antes de realizar las prcticas. 1) Crear una sesin sobre la consola de administracin de OSB (Create) Despues seleccionar la opcin System Administration y por ultimo la opcin Import Resources

2) Pulsando el botn Examinar seleccionar el fichero C:\osb.workshop\documentacin\ficheros_auxiliares\Laboratorio4-recursos.jar y pulsar Next

52 de 103

3) Pulsar Import para comentar la importacin de los recursos.

4) El sistema nos informa de que la operacin se ha realizado correctamente. Finalizar la sesin pulsando Activate para que los cambios queden consolidados en la configuracin de OSB. 5)

Securizacin de un servicio a nivel de transporte

1) Crear una sesin sobre la consola de administracin de OSB (Create) Despues navegar por la estructura de proyectos hasta la carpeta Workshop/Seguridad. Por ltimo seleccionar el servicio ProxyConAutenticacionNivelTransportePS tal como se muestra en la figura.

53 de 103

2) Entre las distintas opciones de configuracin seleccionar el icono de HTTP Transport Configuration

3) Seleccionar como mtodo de autenticacin Basic y pulsar el botn Last >>

54 de 103

4) Pulsar Save y finalizar la sesin pulsando Activate

Comprobacin 1) Lanzar el debugger del servicio ProxyConAutenticacionNivelTransportePS tal como se muestra en la figura.

2) Introduciremos como usuario de pruebas uno no existente en el entorno (p.e: usuario, password usuario) Por ltimo, pulsar Execute

55 de 103

3) El sistema nos devolver un mensaje de autenticacin errnea.

4) Realizaremos de nuevo el test utilizando en este caso un usuario correcto (p.e: weblogic, password weblogic) El sistema en este caso permitir la ejecucin del servicio

56 de 103

Securizacin de un servicio a nivel de mensaje

En la siguiente prctica, nuestro objetivo es securizar un determinado servicio a nivel de mensaje. De este modo podremos aplicar diferentes polticas de seguridad, o niveles de acceso, a cada uno de los mtodos de un determinado servicio. 1) Crear una sesin sobre OSB pulsando el botn Create Seleccionar el servicio ProxyConAutenticacionNivelMensajePS tal como se muestra en la figura.

57 de 103

2) Seleccionar la pestaa Security y pinchando el botn Browse seleccionar el elemento SecureProxyServiceProvider Por ltimo pulsar el botn Update

3) Seleccionar la pestaa Policies Despues pulsar el icono del mtodo DoEcho

4) Pinchar el botn Add correspondiente a las polticas de tipo Request Policies En la ventana emergente seleccionar la poltica Auth.xml Por ltimo pulsar el botn Submit

58 de 103

5) Pulsar el botn Update para consolidar los cambios

59 de 103

6) Ir a la pestaa Security y seleccionar la opcin Process WS-security Header=yes Por ltimo pulsar Update

7) Activar los cambios de la sesin pulsando el botn Activate

Comprobacin 1) Lanzar el debugger del servicio ProxyConAutenticacionNivelMensajePS

2) En la ventana emergente, indicar un usuario no existente en la seccin de Security tal como muestra la figura. Despues pulsar Execute

60 de 103

3) El sistema nos informar de que se ha producido un error de autenticacin. 4)

5) Repetir el test utilizando en este caso un usuario existente (p.e: weblogic, password weblogic) En este caso el sistema permitir la ejecucin del servicio.

61 de 103

Aplicacin de firma digital a un servicio publicado en OSB

El objetivo de la siguiente prctica es aplicar el protocolo de firma digital a un servicio desplegado en OSB. 1) Crear una sesin sobre OSB pulsando el botn Create Seleccionar el servicio ProxyConFirmaDigitalPS tal como se muestra en la figura.

2) Seleccionar la pestaa Security y pinchando el botn Browse seleccionar el elemento SecureProxyServiceProvider Por ltimo pulsar el botn Update

62 de 103

3) Seleccionar la pestaa Policies Despues pulsar el icono del mtodo DoEcho

4) Pinchar el botn Add correspondiente a las polticas de tipo Request Policies En la ventana emergente seleccionar la poltica Sign.xml Por ltimo pulsar el botn Submit

5) Pulsar el botn Update para consolidar los cambios

63 de 103

6) Ir a la pestaa Security y seleccionar la opcin Process WS-security Header=yes Por ltimo pulsar Update

7) Activar los cambios de la sesin pulsando el botn Activate

Comprobacin 1) Lanzar el debugger del servicio ProxyConFirmaDigitalPS

64 de 103

2) En la ventana emergente pulsar el botn Browse y seleccionar un certificado de pruebas (p.e: Workshop/Seguridad/SecureProxyServiceProvider) Por ltimo pulsar Execute

3) En la ventana de resultado podemos comprobar como en el mensaje de peticin se enva firmado digitalmente.

65 de 103

66 de 103

Integracin OSB OSR

(30 minutos) Utilizando la conectividad que ofrecen las plataformas OSB y OSR, es posible publicar automticamente todos aquellos servicios definidos en el registro, y las modificaciones realizadas sobre el mismo a lo largo de su ciclo de vida, sobre el ESB. Del mismo modo, es posible suscribir el ESB a un conjunto de los servicios publicados sobre el registro. Esto permite la propagacin automtica al ESB de las modificaciones efectuadas sobre los servicios publicados en el registro, disponiendo as de una plataforma plenamente sincronizada en todo momento. OSR un producto autnomo e independiente de OSB satisfaciendo de este modo el principio de modularidad del modelo SOA. Adems, OSR soporta la federacin de registros de servicios lo que, dentro de una estrategia global corporativa, posibilita diferentes funcionalidades para la definicin de entornos federados.

67 de 103

WORKSHOP OSR
Introducin a OSR

68 de 103

69 de 103

70 de 103

71 de 103

72 de 103

73 de 103

LABORATORIO V
Publicacin e Importacin de servicios entre OSR y OSB
La siguiente prctica muestra como publicar e importar un servicio desde OSR sobre OSB. El Apndice 0 Configuracin de comunicacin OSB y OSR (pg. 100) muestra como configurar la comunicacin entre ambos servidores.

Importacin de un servicio sobre OSB

74 de 103

1) Abrir una sesin sobre la consola de OSB pulsando el botn Create Despues seleccionar la opcin System Administration del men de la izquierda y por ltimo Import from UDDI tal como muestra la figura

2) Pulsando el botn Search podremos realizar una bsqueda sobre todos los elementos publicados en OSB. Importaremos el servicio CheckOrderService sobre OSB. Tras seleccionarlo pulsamos Next

75 de 103

3) Seleccionamos la carpeta en la que incluiremos el servicio como se muestra en la siguiente figura.

4) Tras verificar los elementos a importer, pulsar Import

76 de 103

4) El sistema nos informa de que la importacin se ha realizado correctamente. Por ltimo pulsar el botn Activate para consolidar los cambios.

5) El servicio queda listo para utilizarse en la carpeta Workshop/Bindings

Publicacin de un servicio sobre OSR

1) Seleccionar la opcin System Administration del men de la izquierda. Despues pulsar la opcin Publish to UDDI Despues, seleccionar el proxy service ScoringClientePS y como destino Customer Management System tal como se muestra en la figura. Por ltimo pulsar el botn Publish

77 de 103

2) El sistema nos informa de que la publicacin se ha realizado correctamente.

Comprobacin 1) Acceder a la consola de OSR (http:// workshop-osb-osr-server:8080/uddi/bsc/web) Como cadena de bsqueda indicar ScoringClientePS Despues pulsar el botn Find

2) El resultado de la bsqueda nos muestra el servicio publicado.

78 de 103

79 de 103

Apndices
CONTROL DEL SERVIDOR OSB
1) Arrancar el dominio de OSB ejecutando el script StartUp OSB del directorio C:\osb.workshop\enlaces directos.

2) Al finalizar el proceso de arranque, en la consola del servidor aparecer un mensaje como el que se muestra en la figura (Server started in RUNNING mode).

80 de 103

CONTROL DEL SERVIDOR OSR

1) Arrancar el dominio de OSR ejecutando el script StartUp OSR del directorio C:\osb.workshop\enlaces directos

2) Al finalizar el proceso de arranque, en la consola del servidor aparecer un mensaje como el que se muestra en la figura (Server is started).

INSTALACIN DE OSB

81 de 103

Instalacin de OSB 3.0

Para instalar el producto OSB 3.0 pueden seguirse las instrucciones que se detallan a continuacin y que corresponden a la versin anterior del producto (OSB 2.6): 1) El software a instalar se encuentra en la ruta c:\bea\software\OSB260_wls921_win32.exe

2) Lanzar el ejecutable con lo que comenzar el proceso de instalacin

3) Pulsar Next en la pantalla de bienvenida

82 de 103

4) Seleccionar Yes para aceptar las normas de utilizacin del producto

5) Seleccionar un directorio de instalacin (en nuestro caso c:\bea\bea921)

6) Seleccionar la instalacin completa del producto

83 de 103

7) Deseleccionar la opcin de las Mercury profiling tools

8) Seleccionar las opciones por defecto que propone el instalador y pulsar Next

9) De Nuevo seleccionar la opcin por defecto y pulsar Next

84 de 103

10) El proceso de instalacin comienza

11) Al finalizar mostrar una pantalla como la que se muestra en la figura indicando que el proceso de instalacin ha finalizado correctamente.

Configuracin de un dominio de OSB

85 de 103

Un dominio de OSB es la unidad administrativa sobre la que se ejecuta uno o ms servidores Oracle Service Bus. Sobre dichos servidores se desplegan los servicios. 1) Arrancar el Configuration Wizard como se muestra en la siguiente imagen.

2) Seleccionar el tipo de dominio, en nuestro caso ser de tipo OSB. Es necesario adems seleccionar la instalacin de las libreras de BEA Workshop como se muestra en la figura.

3) Indicar las credenciales del usuario administrador (weblogic, password weblogic)

4) Seleccionar la JDK por defecto.

86 de 103

5) Ya que cambiaremos algunas opciones de configuracin del dominio, seleccionamos la opcin Yes y pulsamos Next

6) Seleccionar como Listen Address la direccin de la mquina (192.168.199.130) y pulsar Next. En las siguientes pantallas no cambiaremos ninguna otra de las opciones de configuracin.

7) Por ltimo, como nombre de dominio seleccionaremos OSBdomain.

87 de 103

8) El proceso de creacin del dominio comienza.

9) Si el proceso se realiza correctamente, aparecer una pantalla como la que se muestra a continuacin indicando que el dominio se ha creado correctamente.

88 de 103

ORACLE WORKSHOP Y TRANSFORMACIONES DE DATOS

Oracle Workshop es el entorno de desarrollo basado en Eclipse incluido en OSB y que permite la creacin sobre una interfaz grfica de Xqueries o transformaciones de datos que son utilizadas posteriormente en el bus. El entorno ofrece otras mltiples posibilidades como: Creacin de servicios web Desarrollo de aplicaciones web utilizando frameworks como Struts, JSF, etc. Desarrollo de EJBs y otros elementos java Etc.

Puede encontrarse ms informacin sobre la suite en la direccin: http://edocs.bea.com/wlw/docs103/index.html

TRANSFORMACIONES XQUERY UTILIZADAS EN EL WORKSHOP

Las transformaciones utilizadas en el presente workshop se han desarrollado siguiendo las instrucciones del manual: http://e-docs.bea.com/OSB/docs26/dtguide/ Las siguientes instrucciones muestran como acceder a dichos elementos sobre Oracle Workshop 1) Utilizar el icono Oracle Workshop Studio tal como muestra la figura

2) En el men Project Explorer navegar hasta seleccionar los elementos DeInfoClienteAScoring o DeScoringAInfoCliente tal como muestra la figura. En el panel central aparecer el esquema de creacin de la transformacin seleccionada.

89 de 103

3) Puede visualizarse el cdigo fuente de la function XQuery y realizar un test de la misma seleccionando las pestaas Source y Test

90 de 103

INSTALACIN OSR
1) Ejecutar el programa registry300_win32.exe que se encuentra en el directorio c:\bea\software.

91 de 103

2) El proceso de instalacin de OSR comienza. Pulsar Next.

3) Seleccionar la opcin Yes y pulsar Next.

92 de 103

4) Como directorio de instalacin del producto seleccionar c:\bea\OSR30.

5) Seleccionar la opcin por defecto y pulsar Next.

93 de 103

6) Seleccionar la opcin Install with embedded http/HTTPS server y pulsar Next.

7) Seleccionar la opcin por defecto y pulsar Next.

94 de 103

8) Seleccionar las opciones por defecto y pulsar Next.

9) Utilizar como password de administrador weblogic y pulsar Next.

95 de 103

10) Seleccionar la opcin por defecto y pulsar Next.

11) Seleccionar la opcin por defecto y pulsar Next.

96 de 103

12) Seleccionar la opcin por defecto y pulsar Next.

13) Indicar como hostname 192.168.199.130, despus seleccionar las opciones por defecto y pulsar Next.

97 de 103

14) Tras pulsar Next el proceso de instalacin comenzar.

15) Una vez finalizado correctamente pulsar Finish para terminar el proceso de instalacin.

98 de 103

16) Antes de arrancar el servidor OSR, es necesario modificar el fichero c:\bea\OSR30\bin\env.bat tal como se muestra en la figura.

17) Despus ejecutar el fichero c:\bea\OSR30\bin\serverstart.bat.

99 de 103

18) Una vez finalizado el proceso de arranque, desde un navegador podemos acceder a la consola de OSR en la direccin http:// workshop-osb-osr-server:8080/uddi/web

CONFIGURACIN DE COMUNICACIN OSB Y OSR

Al aadir un registro UDDI sobre OSB, estamos posibilitando las operaciones de publicacin e importacin de servicios entre ambas plataformas. Para configurar un servidor OSR al bus se deben seguir los siguientes pasos. 1) Tras activar una sesin sobre la consola de administracin de OSB, seleccionaremos en el men izquierdo la opcin System Administration/UDDI/UDDI Registries tal como se muestra en la figura.

100 de 103

2) Tras seleccionar la opcin Add Registry indicaremos los parmetros de configuracin del registro UDDI tal como se muestra en la figura.

3) Antes de salvar la configuracin, validar la misma con el botn Validate. El sistema notificar si la operacin se ha realizado con xito tal como muestra la siguiente figura.

101 de 103

4) Por ltimo pulsar Save para que la configuracin sea efectiva.

5) Tras activar la sesin, seleccionar el enlace System Administration/UDDI/Import from UDDI y pulsar Search. De este modo, el bus, utilizando la configuracin definida realizar una bsqueda sobre el servidor OSR y mostrar aquellos servicios que cumplan el criterio de bsqueda introducido.

102 de 103

103 de 103