Criando uma Nova Configuração de Serviço de Gateway

Use o gateway de serviços da Web para mapear um serviço existente - um serviço de entrada ou de saída - para um novo serviço da Web que parece ser fornecido pelo gateway. O serviço de gateway age como um proxy: os usuários do serviço de gateway não precisam saber se o serviço subjacente está sendo fornecido interna ou externamente.

Antes de Iniciar

Para uma visualização de tarefas de alto nível de como configurar o gateway de serviços da Web como parte de uma configuração geral de serviços da Web ativados para barramento, consulte Ativando Serviços da Web por meio do Barramento de Integração de Serviços.

Você configura cada serviço de gateway para uma instância de gateway específica, portanto, você deve criar uma instância de gateway antes de configurar serviços de gateway para ela.

O WSDL do serviço de gateway é criado a partir do WSDL para o primeiro serviço de destino. Se o serviço de destino for um serviço da Web externo, ele já possui um WSDL associado. Se ele for um serviço interno:
Este tópico também assume que:

Decida que método usar para configurar esses recursos. É possível criar um novo serviço de gateway utilizando o console administrativo conforme descrito nesta tarefa ou utilizando o Comando createWSGWGatewayService.

Sobre Esta Tarefa

A seguinte figura mostra como um serviço de gateway se parece para os aplicativos do solicitante do cliente, como se fosse um serviço de entrada. Entretanto, um serviço de gateway também é mapeado para um destino de serviço no qual um serviço de destino, um serviço interno ou um serviço da Web fornecido externamente, esteja disponível. Um pedido do cliente é recebido por um listener de terminal e, em seguida, transmitido por meio de uma porta de entrada para o serviço de gateway; o serviço de destino é um serviço interno disponível diretamente no destino ou um serviço externo disponível no destino por meio de uma ou mais portas de saída. Também é possível aplicar os manipuladores JAX-RPC e ligações WS-Security nas portas.

Figura 1. Como um Serviço de Gateway Mapeia um Serviço de Entrada para um Serviço de DestinoEsta figura é descrita no texto ao redor.

Um serviço de gateway é a interface da Web para um serviço subjacente (o serviço de destino). O serviço de gateway é disponibilizado em um local diferente para o serviço de destino, portanto, é possível substituir ou relocalizar o serviço de destino sem alterar os detalhes do serviço de gateway associado. Também é possível ter mais de um serviço de destino (ou seja, mais de uma implementação do mesmo serviço lógico) para cada serviço de gateway. Para obter informações adicionais, consulte Serviços de Destino e Serviços de Gateway.

O serviço de destino pode ser um serviço da Web fornecido externamente, ou um serviço que esteja disponível internamente para sua organização e pode ser localizado em um destino que esteja em um barramento diferente do serviço de gateway. Se o serviço de destino for um serviço interno, o novo serviço de gateway será sempre criado com base no WSDL de gabarito para o serviço e o destino do barramento no qual ele está disponível. Se ele for um serviço da Web fornecido externamente, o novo serviço de gateway geralmente será criado com base no WSDL publicado externamente para o serviço e em um novo destino do barramento. Entretanto, se o destino estiver em um serviço da Web fornecido externamente que já esteja disponível no destino do barramento (por exemplo, porque foi configurado previamente como um serviço de saída), você deverá fornecer os detalhes do destino como parte do novo processo de criação de serviço de gateway. Caso contrário, o mesmo serviço da Web será disponibilizado em dois destinos diferentes.

É possível controlar e monitorar o acesso aos serviços de gateway das seguintes maneiras:
  • É possível controlar quais grupos de usuários podem acessar um determinado serviço de gateway, disponibilizando-o apenas por meio de uma instância de gateway específica.
  • É possível associar as listas de rotinas de tratamento JAX-RPC às portas, para que as rotinas de tratamento possam monitorar a atividade na porta e executar a ação adequada dependendo do emissor e do conteúdo de cada mensagem transmitida pela porta.
  • É possível definir o nível de segurança a ser aplicado a mensagens (a ligação do WS-Security). O nível de segurança pode ser definido de maneira independente para mensagens de pedido e resposta.

Ao criar um novo serviço de gateway, configure um serviço de destino único como um novo serviço da Web que parece ser fornecido pelo gateway. Depois de criar o novo serviço de gateway, você pode incluir mais serviços de destino (ou seja, mais implementações do mesmo serviço lógico) modificando a configuração do serviço de gateway existente.

Para criar um novo serviço de gateway utilizando o console administrativo, conclua as etapas a seguir. Para obter informações adicionais sobre as propriedades do novo serviço de gateway, consulte Definições de Serviços de Gateway.

Procedimento

  1. Inicie o administrative console.
  2. Na área de janela de navegação, clique em Integração de serviços -> Barramentos -> bus_name -> [Propriedades Adicionais] Instâncias de gateway de serviço da Web -> instance_name-> Serviços de Gateway . É exibido o formulário de coleta de serviços de gateway.
  3. Clique em Nova. Um painel é exibido através do qual você seleciona o primeiro serviço de destino para o novo serviço de gateway.
  4. Escolha um dos dois métodos para criar seu serviço de gateway (por meio de um provedor de serviço da Web definido por WSDL ou um destino de Serviço) e clique em Avançar.
    Nota: Se o serviço de destino for um serviço interno ou um serviço da Web fornecido externamente que esteja disponível em um destino, selecione Destino de serviço. Se o serviço de destino for um serviço da Web fornecido externamente que ainda não está disponível em um destino do barramento, selecione Provedor de serviço da Web definido por WSDL e o serviço de destino será configurado para um novo destino.
    O Novo serviço de gateway é exibido para o método de criação do serviço selecionado.
  5. Opcional: Se foi selecionado provedor de serviço da Web definido por WSDL, conclua as etapas a seguir:
    1. Especifique o nome do serviço de gateway, os destinos do serviço de gateway e as mediações.
      Nota:
      • Escolha um nome de serviço de gateway que seja exclusivo em todos os serviços de gateway e proxy dentro da instância de gateway atual. Se você digitar um nome que não é exclusivo, uma mensagem de erro será exibida.
      • Você precisa fornecer nomes do destino de gateway. Se qualquer um desses campos ficar em branco, um nome padrão será gerado quando o assistente concluir sua operação. Os nomes padrão não são exibidos no painel. Eles são construídos da seguinte forma:
        • O nome do destino de pedido é o mesmo nome do serviço de gateway. Exemplo: myGatewayService.
        • O nome do destino de resposta é o mesmo nome do destino de pedido, seguido por "Reply". Exemplo: myGatewayServiceReply.
      • As listas de mediações disponíveis contêm todas as mediações que são atualmente implementadas para esse barramento de integração de serviço. Se você tiver criado uma mediação e implementado-a no barramento, ela ficará disponível para seleção nessas duas listas. Se você não desejar utilizar uma mediação com esse serviço de gateway, selecione none em qualquer uma das listas de seleção ou em ambas.
      • Os membros do barramento são servidores de aplicativos ou clusters que são incluídos neste barramento. As propriedades Membro do barramento de mediação de pedido e Membro do barramento de mediação de resposta definem os membros do barramento aos quais a mediação correspondente está designada. Se você alterar o valor da propriedade Mediação de pedido ou Mediação de resposta para (nenhum), deverá alterar também o valor da propriedade do membro do barramento correspondente para (nenhum). Se você deseja utilizar uma mediação, designe-a para um membro de barramento. Se você não fizer isto, o console administrativo exibirá uma mensagem de erro.
    2. Localize o WSDL do serviço de destino.
    3. Selecione o serviço a partir do WSDL.
      Nota:
      • Esta opção será necessária no caso de haver mais de um serviço no WSDL. O campo é preenchido por padrão. Se houver apenas um serviço no WSDL, aceite o padrão.
      • É necessário ter, pelo menos, uma porta definida no serviço selecionado.
    4. Selecione as portas que devem ser ativadas para este serviço.
      Nota:
      • A lista de portas disponíveis é o conjunto de portas que estão descritas no arquivo WSDL.
      • Selecione pelo menos uma porta.
    5. Nomeie o serviço de saída, o destino do serviço e todos os destinos de porta.
      Nota:
      • Os nomes padrão são gerados, mas é possível renomeá-los. Os nomes padrão são exclusivos dentro do barramento de integração de serviço atual. Todos os nomes de substituição que você escolher devem ser similarmente exclusivos. Se você digitar um nome que não é exclusivo, uma mensagem de erro será exibida.
      • Se você tiver criado uma mediação de seleção de porta e implementado-a no barramento, ela ficará disponível para seleção na lista de mediações. Se não desejar usar uma mediação de seleção de porta com esse serviço de gateway, selecione nenhum na lista suspensa. Essa lista contém todas as mediações, incluindo mediações de seleção de porta, que estão atualmente implementadas para esse barramento de integração de serviço.
      • A lista de portas disponíveis é um subconjunto de portas que estão descritas no arquivo WSDL. Você escolheu esse subconjunto na etapa anterior.
    6. Atribua cada destino de porta e (opcionalmente) a mediação de seleção de porta para um membro do barramento.
      Nota:
      • A opção para designar uma mediação de seleção de porta para um membro do barramento será exibida apenas se você tiver selecionado uma mediação na etapa anterior.
    7. Selecione listeners do terminal para a configuração de entrada deste serviço de gateway.
    8. Defina quaisquer propriedades de publicação de UDDI.
      Nota: Especifique as propriedades de publicação de UDDI que são utilizadas para publicar este serviço de gateway para um ou mais registros de UDDI. Para obter informações sobre as propriedades de publicação de UDDI, consulte Configurações de Publicação de UDDI e Registros UDDI: Diretórios de Serviços da Web que Podem Ser Referidos por Serviços da Web Acionados por Barramento.
  6. Opcional: Se você selecionou Destino do Serviço, conclua as seguintes etapas:
    1. Especifique o nome do serviço de gateway, os destinos do serviço de gateway e do serviço de destino e as mediações.
      Nota:
      • Escolha um nome de serviço de gateway que seja exclusivo em todos os serviços de gateway e proxy dentro da instância de gateway atual. Se você digitar um nome que não é exclusivo, uma mensagem de erro será exibida.
      • O serviço de destino não precisa estar disponível no mesmo barramento do serviço de gateway; dessa maneira, especifique o barramento e o destino de serviço associado para o qual o serviço de destino está disponível.
      • O campo Nome do Barramento de destino lista todos os barramentos disponíveis. O campo Nome do destino lista todos os destinos disponíveis. Ao escolher um barramento e um destino associado, escolha um destino que esteja disponível no barramento selecionado. Se você não fizer isto, o console administrativo exibirá uma mensagem de erro.
      • Você precisa fornecer nomes do destino de gateway. Se qualquer um desses campos ficar em branco, um nome padrão será gerado quando o assistente concluir sua operação. Os nomes padrão não são exibidos no painel. Eles são construídos da seguinte forma:
        • O nome do destino de pedido é o mesmo nome do serviço de gateway. Exemplo: myGatewayService.
        • O nome do destino de resposta é o mesmo nome do destino de pedido, seguido por "Reply". Exemplo: myGatewayServiceReply.
      • As listas de mediações disponíveis contêm todas as mediações que são atualmente implementadas para esse barramento. Se você tiver criado uma mediação e implementado-a no barramento, ela ficará disponível para seleção nessas duas listas. Se você não desejar utilizar uma mediação com esse serviço de gateway, selecione none em qualquer uma das listas de seleção ou em ambas.
      • As propriedades Membro do barramento de mediação de pedido e Membro do barramento de mediação de resposta definem os membros do barramento aos quais a mediação correspondente está designada. Se você alterar o valor da propriedade Mediação de pedido ou Mediação de resposta para (nenhum), deverá alterar também o valor da propriedade do membro do barramento correspondente para (nenhum). Para utilizar uma mediação, designe-a como um membro de barramento. Se você não fizer isto, o console administrativo exibirá uma mensagem de erro.
    2. Selecione o local do WSDL.
      Nota: Para um serviço interno, o WSDL de gabarito é o arquivo WSDL específico do serviço que descreve o serviço que está diretamente disponível em um destino do serviço.
    3. Selecione o serviço a partir do WSDL.
      Nota:
      • Esta opção será necessária no caso de haver mais de um serviço no WSDL. O campo é preenchido por padrão. Se houver apenas um serviço no WSDL, aceite o padrão.
      • É necessário ter, pelo menos, uma porta definida no serviço selecionado.
    4. Selecione listeners do terminal para a configuração de entrada deste serviço de gateway.
    5. Defina quaisquer propriedades de publicação de UDDI.
      Nota: Especifique as propriedades de publicação de UDDI que são utilizadas para publicar este serviço de entrada para um ou mais registros de UDDI. Para obter informações sobre as propriedades de publicação de UDDI, consulte Configurações de Publicação de UDDI e Registros UDDI: Diretórios de Serviços da Web que Podem Ser Referidos por Serviços da Web Acionados por Barramento.
    6. Se o serviço de destino for um serviço da Web externo, a opção Ativação do Serviço da Web de Saída estará disponível na seção de propriedades adicionais. Clique nessa opção para modificar a configuração do serviço de saída para esse serviço de destino. Para obter informações adicionais, consulte Modificando uma Configuração de Serviço de Saída Existente.
  7. Clique em Terminar.

Resultados

Se o processamento for concluído com êxito, a lista de serviços de gateway para esta instância de gateway será atualizada para incluir o novo serviço de gateway. Caso contrário, uma mensagem de erro é exibida.

O que Fazer Depois

Para modificar o novo serviço de gateway ou incluir serviços de destino adicionais, (ou seja, implementações adicionais do mesmo serviço lógico) no serviço de gateway, consulte Modificando uma Configuração de Serviço de Gateway Existente. Para configurar o nível de segurança a ser aplicado a mensagens (a ligação de WS-Security), consulte Configurando Transmissões Seguras de Mensagens SOAP Usando o WS-Security.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsg_gw_new
Nome do arquivo: twsg_gw_new.html