Compartilhamento de Provedores de Serviço da Web e Configuração de Política

Um provedor de serviço WebSphere Application Server pode compartilhar a configuração da política atual por meio do WSDL (Web Service Description Language). A configuração da política está no formato padrão WS-PolicyAttachment de WSDL para que ela possa ser compartilhada com outros clientes, registros de serviços ou serviços que suportam a especificação do WS-Policy (Web Services Policy).

É possível disponibilizar a configuração de política de um terminal em serviço do Java™ API for XML-Based Web Services (JAX-WS) para compartilhamento das seguintes maneiras:
  • Inclua a configuração da política do provedor de serviços no WSDL. O WSDL está então disponível para publicar, ou para obter usando um pedido HTTP GET.
  • Ativar o protocolo WS-MetadataExchange (Web Services Metadata Exchange) para que a configuração de política do provedor de serviços seja incluída no WSDL e fique disponível para um pedido GetMetadata do WS-MetadataExchange. Uma vantagem de utilizar o protocolo WS-MetadataExchange é que você pode aplicar a segurança do nível de mensagem aos pedidos GetMetadata do WS-MetadataExchange utilizando um conjunto de política do sistema adequado.

Os administradores do sistema também podem acessar um documento WSDL por meio de um arquivo compactado publicado com uma extensão de arquivo .zip, usando o console administrativo ou comandos administrativos. No entanto, um documento WSDL adquirido desta maneira pode diferir de um documento WSDL adquirido usando uma solicitação HTTP GET ou por meio do protocolo WS-MetadataExchange, porque o documento WSDL estático publicado no arquivo compactado não poderá levar em conta nenhum recurso de serviço da web, nenhuma anotação ou elemento do descritor de implementação que possa existir no código do aplicativo, tais como anotações WS-Addressing.

Por padrão, o compartilhamento de políticas fica desativado. Para incluir a configuração da política do provedor de serviços no WSDL, e especificar como ela é compartilhada, é possível utilizar o console administrativo ou os comandos wsadmin.

Quando o compartilhamento de políticas é ativado, todos os anexos WS-Policy que estivessem anteriormente no WSDL são removidos. Observe que as informações da configuração de políticas ficam disponíveis no WSDL para publicação, mas não ficarão disponíveis se o documento WSDL for visualizado diretamente a partir do console administrativo, ou se o WSDL for publicado remotamente usando um agente administrativo.

Se o aplicativo do provedor de serviços utiliza WSDL de vários fabricantes, todos os WSDL devem ser locais para o aplicativo de serviço da Web. Para obter informações adicionais sobre WSDL com múltiplas partes, consulte o tópico sobre WSDL.

Um provedor de serviços que está configurado para usar Security Assertion Markup Language (SAML) pode compartilhar a política para uso por um cliente ou um registro de serviço do WebSphere Application Server. Observe que os tokens SAML são publicados em um formato de proprietário.

Os desenvolvedores de aplicativos podem especificar que um provedor de serviços compartilha sua configuração de política e como ela é compartilhada usando as ferramentas do Rational Application Developer quando um serviço da Web for gerado. Para obter informações adicionais, consulte a documentação do Rational Application Developer.

Informações de política de transporte não são incluídas na configuração de política porque as políticas de transporte como HTTP, SSL e JMS não podem ser expressas no formato WS-PolicyAttachment.

As informações da política de autoinicialização, por exemplo, a política para acessar um serviço WS-Trust, podem ser incluídas na configuração de política se a política de autoinicialização for expressa no formato WS-PolicyAttachment padrão publicável.

É possível configurar um provedor de serviços para compartilhar sua configuração de política no nível de aplicativo ou de serviço. A configuração de política que é representada pelos conjuntos de políticas conectados a quaisquer níveis anteriores também será compartilhada. Os conjuntos de políticas que são conectados a níveis anteriores substituem a configuração do conjunto de políticas conectada em um nível mais recente.

As informações de política podem ser definidas de diversas maneiras. A lista a seguir está na ordem decrescente de precedência. Por exemplo, o método do descritor de implementação substitui o uso de anotações ou recursos no código do aplicativo, mas substitui a si mesmo com o uso de conjuntos de políticas.
  • A política é definida ao anexar um conjunto de políticas no aplicativo.
  • A política é definida com o uso de elementos do descritor de implementação em um elemento port-component-ref.
  • A política é definida usando anotações ou recursos no código do aplicativo.
  • A política é definida usando anexos WS-Policy no documento WSDL compactado com o aplicativo.

Quando um aplicativo é implementado em uma célula e você publica o WSDL usando o console administrativo, o WSDL contém a configuração do conjunto de políticas do gerenciador de implementação da célula. Se você alterar quaisquer conjuntos de política, as mudanças não afetarão a configuração do gerenciador de implementação até que a configuração seja atualizada, por exemplo, quando o gerenciador de implementação for reiniciado ou quando um comando de scripts atualizar a configuração do conjunto de política do gerenciador de implementação.

As informações a seguir mostram as regras que controlam como a configuração de política é publicada:
  • Quando o compartilhamento de políticas está ativado, os anexos WS-Policy no WSDL descrevem a configuração de política do serviço.
  • Quando o compartilhamento de políticas não está ativado:
    • O WSDL retornado por uma solicitação HTTP GET é o WSDL compactado com o aplicativo.
      Nota: Esse WSDL retorna inalterado e, portanto, pode conter anexos WS-Policy preexistentes que não correspondam à configuração do serviço.
    • Se não houver um documento WSDL específico associado ao serviço, o tempo de execução do servidor gerará um documento WSDL automaticamente e o associará ao serviço. Nesse caso, o WSDL não conterá anexos WS-Policy a menos que a anotação @Addressing esteja presente na implementação do serviço e, nesse caso, a configuração da anotação @Addressing será expressa nos anexos WS-Policy no WSDL gerado.

Resolução de Problemas do Compartilhamento de Configuração de Política

Um provedor de serviços pode não estar apto a compartilhar sua configuração de política porque a configuração não pode ser expressa no formato WS-PolicyAttachments padrão. Um motivo pode ser o fato de haver várias políticas incompatíveis definidas para um determinado ponto de conexão. Outro motivo pode ser a insuficiência de informações sobre ligação para gerar a política padrão. A configuração de política pode incluir a política de auto-inicialização, por exemplo, a política para acessar um serviço WS-Trust, para que ela também seja expressa no formato WS-PolicyAttachments.

Se a configuração da política não puder ser compartilhada, um erro descrevendo o problema será gravado no log de erros do provedor de serviços e a seguinte política será conectada ao WSDL do provedor de serviços:
<wsp:Policy>
<wsp:ExactlyOne>
</wsp:ExactlyOne>
</wsp:Policy>
Essa política notifica o cliente de que não existe uma configuração de política aceitável para o serviço. Outros aspectos da WSDL não são afetados.

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



Í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=cwbs_wsp_server_share
Nome do arquivo: cwbs_wsp_server_share.html