Creación de una configuración de servicio Gateway nueva

Utilice Web Services Gateway para correlacionar un servicio existente, ya sea interno o externo, con un nuevo servicio web que parezca proporcionado por la pasarela. El servicio Gateway actúa como proxy: los usuarios de servicios Gateway necesitan saber si el servicio subyacente se proporciona de modo interno o externo.

Antes de empezar

Para obtener una vista de tarea de alto nivel de cómo configurar la pasarela de servicios web como parte de una configuración de servicios web habilitados para el bus global, consulte Habilitación de servicios web a través del bus de integración de servicios.

Cada servicio Gateway se configura para una instancia de pasarela específica, de modo que debe crear una instancia de pasarela antes de configurar para ella un servicio Gateway.

El WSDL del servicio Gateway se crea para el primer servicio de destino. Si el servicio de destino es un servicio web externo, ya tiene un WSDL asociado. Si se trata de un servicio interno:
En este tema se presupone también lo siguiente:

Decida qué método se debe utilizar para configurar estos recursos. Puede crear un nuevo servicio Gateway utilizando la consola administrativa como se describe en esta tarea, o bien utilizando el Mandato createWSGWGatewayService.

Acerca de esta tarea

En la siguiente figura se muestra el aspecto de un servicio de pasarela, para las aplicaciones de solicitante de cliente, como si fuese un servicio de entrada. No obstante, un servicio Gateway se correlaciona también con un destino de servicio en el que un servicio de destino, sea un servicio interno o un servicio web proporcionado externamente, está disponible. Una escucha de punto final recibe una solicitud de cliente y, a continuación, se pasa a través de un puerto de entrada al servicio Gateway; el servicio de destino es o bien un servicio interno disponible directamente en el destino o un servicio externo disponible en el destino a través de uno o más puertos de salida; también puede aplicar manejadores JAX-RPC y enlaces de WS-Security de los puertos.

Figura 1. Cómo un servicio Gateway correlaciona un servicio de entrada con un servicio de destinoEsta figura está descrita en el texto que aparece alrededor.

Un servicio Gateway es la interfaz web de un servicio subyacente (el servicio de destino). El servicio Gateway está disponible en una ubicación diferente del servicio de destino, de esta forma puede sustituir o volver a ubicar el servicio de destino sin modificar los detalles del servicio Gateway asociado. Además puede tener más de un servicio de destino (es decir, más de una implementación del mismo servicio lógico) para cada servicio Gateway. Para obtener más información, consulte Servicios de destino y servicios Gateway.

El servicio de destino puede ser un servicio web proporcionado externamente o un servicio que esté disponible internamente para la organización o puede estar situado en un destino que esté en un bus diferente al servicio Gateway. Si el servicio de destino es un servicio interno, el nuevo servicio Gateway siempre se crea basándose en la plantilla de WSDL para el servicio y en el destino de bus en el que está disponible. Si se trata de un servicio web proporcionado externamente, el nuevo servicio Gateway se suele crear basándose en el WSDL publicado externamente para el servicio y en un nuevo destino de bus. No obstante, si el destino es un servicio web proporcionado externamente que ya está disponible en un destino de bus (por ejemplo, debido a que se ha configurado previamente como un servicio de salida) entonces debe proporcionar los detalles del destino como parte del proceso de creación del nuevo servicio Gateway. De lo contrario, el mismo servicio web externo estará disponible en dos destinos diferentes.

Puede controlar y supervisar el acceso a los servicios Gateway de las siguientes formas:
  • Puede controlar qué grupos de usuarios pueden acceder a un servicio Gateway determinado haciendo que el servicio esté disponible solamente a través de una instancia de pasarela determinada.
  • Puede asociar las listas de manejadores JAX-RPC con puertos para que los manejadores puedan supervisar la actividad del puerto y llevar a cabo las acciones adecuadas dependiendo del emisor y el contenido de cada mensaje que pasa por el puerto.
  • Puede establecer el nivel de seguridad que se aplicará a los mensajes (enlace WS-Security). El nivel de seguridad se puede establecer de forma independiente para mensajes de solicitud y de respuesta.

Cuando se crea un nuevo servicio Gateway, se configura un solo servicio de destino como un nuevo servicio web que parece proporcionado por la pasarela. Después de crear el nuevo servicio Gateway, puede añadir más servicios de destino (es decir, más implementaciones del mismo servicio lógico modificando la configuración de servicio Gateway existente.

Para crear un nuevo servicio Gateway utilizando la consola administrativa, efectúe los pasos siguientes: Para obtener más información acerca de las propiedades del nuevo servicio Gateway, consulte los Valores de los servicios Gateway.

Procedimiento

  1. Inicie la consola administrativa.
  2. En el panel de navegación, pulse Integración de servicios -> Buses -> nombre_bus -> [Propiedades Adicionales] Instancias de pasarela de servicios web -> nombre_instancia -> Servicios de pasarela. Se visualiza el formulario de colección de servicios Gateway.
  3. Pulse Nuevo. Se visualizará un panel en el que puede seleccionar el primer servicio de destino para el nuevo servicio Gateway.
  4. Seleccione uno de los dos métodos para crear el servicio Gateway (ya sea a través del proveedor de servicio web definido mediante WSDL o un destino de servicio) y, a continuación, pulse Siguiente.
    Nota: Si el servicio de destino es un servicio interno o un servicio web proporcionado externamente que ya está disponible en un destino, seleccione Destino de servicio. Si el servicio de destino es un servicio web proporcionado externamente que todavía no está disponible en un destino de bus, seleccione Proveedor del servicio web definido mediante WSDL y el servicio de destino se configurará en un destino nuevo.
    Se visualizará el asistente para nuevo servicio Gateway para el método de creación que haya seleccionado.
  5. Opcional: Si ha seleccionado Proveedor del servicio web definido mediante WSDL, efectúe los pasos siguientes:
    1. Especifique el nombre de servicio Gateway, los destinos del servicio Gateway y las mediaciones.
      Nota:
      • Seleccione un nombre de servicio Gateway que sea exclusivo entre todos los servicios Gateway y proxy incluidos en la instancia de pasarela actual. Si especifica un nombre que no sea exclusivo, se visualizará un mensaje de error.
      • No es necesario que proporcione nombres de destino de pasarela. Si deja cualquiera de estos campos en blanco, se genera un nombre predeterminado cuando el asistente finaliza su operación. Los nombres predeterminados no se muestran en el panel. Se crean del modo siguiente:
        • El nombre del destino de solicitud es el mismo que el nombre del servicio Gateway. Por ejemplo: myGatewayService.
        • El nombre del destino de respuesta es el mismo que el nombre del destino de solicitud, seguido de "Reply". Por ejemplo: myGatewayServiceReply.
      • Las listas de mediaciones disponibles contienen todas las mediaciones que se han desplegado actualmente en este bus de integración de servicios. Si ha creado una mediación y la ha desplegado en el bus, entonces estará disponible para seleccionarla en estas dos listas. Si no desea que utilice una mediación con este servicio Gateway, seleccione none en cualquiera o en ambas listas de selección.
      • Los miembros del bus son servidores de aplicaciones o clústeres que se añaden a este bus. Las propiedades Miembro del bus de mediación de solicitudes y Miembro del bus de mediación de respuestas definen los miembros de bus a los que se asigna la mediación correspondiente. Si cambia el valor de la propiedad Mediación de solicitudes o Mediación de respuestas en (none), también debe cambiar el valor de la propiedad del miembro de bus correspondiente para que sea (none). Si desea utilizar una mediación, asígnela a un miembro de bus. Si no lo hace así, la consola administrativa visualiza un mensaje de error.
    2. Localice el WSDL de servicio de destino.
    3. Seleccione el servicio del WSDL.
      Nota:
      • Esta opción es necesaria si hay más de un servicio en el WSDL. De forma predeterminada,el campo está rellenado. Si solamente hay un servicio en el WSDL, acepte el valor predeterminado.
      • Debe haber como mínimo un puerto definido en el servicio que seleccione.
    4. Seleccione los puertos que hay que habilitar para este servicio.
      Nota:
      • La lista de puertos disponibles es el conjunto de puertos descritos en el archivo WSDL.
      • Seleccione un puerto como mínimo.
    5. Asigne un nombre al servicio de salida, el destino de servicio y todos los destinos de puertos.
      Nota:
      • Se generan nombres predeterminados pero puede cambiarles el nombre. Los nombres predeterminados son exclusivos en el bus de integración de servicios actual. Cualquier nombre de sustitución que seleccione debe ser del mismo modo exclusivo. Si especifica un nombre que no sea exclusivo, se visualizará un mensaje de error.
      • Si ha creado una mediación de selección de puertos y la ha desplegado en el bus, entonces estará disponible para seleccionarla en la lista de mediaciones. Si no desea utilizar una mediación de selección de puerto con este servicio Gateway, seleccione none en la lista desplegable. Esta lista contiene todas las mediaciones, incluidas las mediaciones de selección de puertos que se han desplegado actualmente en este bus de integración de servicios.
      • La lista de puertos disponibles es un subconjunto de puertos que se describe en el archivo WSDL. Ha seleccionado este subconjunto en el paso anterior.
    6. Asigne cada destino de puerto y (opcionalmente) la mediación de selección de puerto a un miembro de bus.
      Nota:
      • La opción para asignar una mediación de selección de puertos a un miembro de bus solo se visualiza si ha seleccionado una mediación en el paso anterior.
    7. Seleccione los escuchas de punto final para la configuración de entrada de este servicio Gateway.
    8. Defina las propiedades de publicación UDDI.
      Nota: Especifique las propiedades de publicación UDDI que se utilizan para publicar este servicio Gateway en uno o más registros UDDI. Para obtener más información acerca de las propiedades de publicación UDDI, consulte Valores de publicación UDDI y Registros UDDI: directorios de servicios web a los que los servicios web habilitados para bus pueden hacer referencia.
  6. Opcional: Si ha seleccionado Destino de servicio, efectúe los pasos siguientes:
    1. Especifique el nombre de servicio Gateway, la pasarela, los destinos de servicios de destino y las mediaciones.
      Nota:
      • Seleccione un nombre de servicio Gateway que sea exclusivo entre todos los servicios Gateway y proxy incluidos en la instancia de pasarela actual. Si especifica un nombre que no sea exclusivo, se visualizará un mensaje de error.
      • No es necesario que el servicio de destino esté disponible en el mismo bus que el servicio Gateway; por lo tanto, especifique el bus y el destino de servicio asociado en el que está disponible el servicio de destino.
      • El campo Nombre de bus de destino lista todos los buses disponibles. El campo Nombre de destino señalado lista todos los destinos disponibles. Cuando elija un bus y un destino asociado, seleccione un destino que esté disponible en el bus que seleccione. Si no lo hace así, la consola administrativa visualiza un mensaje de error.
      • No es necesario que proporcione nombres de destino de pasarela. Si deja cualquiera de estos campos en blanco, se genera un nombre predeterminado cuando el asistente finaliza su operación. Los nombres predeterminados no se muestran en el panel. Se crean del modo siguiente:
        • El nombre del destino de solicitud es el mismo que el nombre del servicio Gateway. Por ejemplo: myGatewayService.
        • El nombre del destino de respuesta es el mismo que el nombre del destino de solicitud, seguido de "Reply". Por ejemplo: myGatewayServiceReply.
      • Las listas de mediaciones disponibles contienen todas las mediaciones que se han desplegado actualmente en este bus. Si ha creado una mediación y la ha desplegado en el bus, entonces estará disponible para seleccionarla en estas dos listas. Si no desea que utilice una mediación con este servicio Gateway, seleccione none en cualquiera o en ambas listas de selección.
      • Las propiedades Miembro del bus de mediación de solicitudes y Miembro del bus de mediación de respuestas definen los miembros de bus a los que se asigna la mediación correspondiente. Si cambia el valor de la propiedad Mediación de solicitudes o Mediación de respuestas en (none), también debe cambiar el valor de la propiedad del miembro de bus correspondiente para que sea (none). Para utilizar una mediación, debe asignarla a un miembro de bus. Si no lo hace así, la consola administrativa visualiza un mensaje de error.
    2. Seleccione la ubicación WSDL.
      Nota: Para un servicio interno, la plantilla WSDL es el archivo WSDL específico del servicio que describe el servicio que está disponible directamente en un destino de servicio.
    3. Seleccione el servicio del WSDL.
      Nota:
      • Esta opción es necesaria si hay más de un servicio en el WSDL. De forma predeterminada,el campo está rellenado. Si solamente hay un servicio en el WSDL, acepte el valor predeterminado.
      • Debe haber como mínimo un puerto definido en el servicio que seleccione.
    4. Seleccione los escuchas de punto final para la configuración de entrada de este servicio Gateway.
    5. Defina las propiedades de publicación UDDI.
      Nota: Especifique las propiedades de publicación UDDI que se utilizan para publicar este servicio de entrada en uno o más registros UDDI. Para obtener más información acerca de las propiedades de publicación UDDI, consulte Valores de publicación UDDI y Registros UDDI: directorios de servicios web a los que los servicios web habilitados para bus pueden hacer referencia.
    6. Si el servicio de destino es un servicio web externo, la opción Habilitación de servicio web de salida está disponible en la sección de propiedades adicionales. Pulse esta opción para modificar la configuración del servicio de salida para este servicio de destino. Para obtener más información, consulte Escuchas de punto final y puertos de entrada: puertos de entrada al bus de integración de servicios.
  7. Pulse Finalizar.

Resultados

Si el proceso se completa correctamente, se actualizará la lista de servicios Gateway para esta instancia de pasarela de modo que incluya el nuevo servicio Gateway. De lo contrario, aparece un mensaje de error.

Qué hacer a continuación

Para modificar el nuevo servicio Gateway o para añadir servicios de destino adicionales (esto es, implementaciones adicionales del mismo servicio lógico) a su servicio Gateway, consulte Modificación de la configuración del servicio Gateway existente. Para establecer el nivel de seguridad que se ha de aplicar a los mensajes (el enlace WS-Security), consulte Configuración de la transmisión segura de mensajes SOAP utilizando WS-Security.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsg_gw_new
File name: twsg_gw_new.html