comando setClientDynamicPolicyControl
Utilize o comando setClientDynamicPolicyControl para configurar como um aplicativo que é um cliente de serviços da Web obtém a configuração de política de um provedor de serviços da Web. É possível configurar, atualizar ou remover essas informações sobre como uma política de provedor é obtida.
Para executar o comando, use o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado no Qshell. Para obter informações adicionais, consulte o tópico "Configurar o Qshell para Executar Scripts do WebSphere Application
Server".
Esse comando é válido apenas quando for usado com o WebSphere Application Server Versão 7 e servidores de aplicativos posteriores. Não o utilize com versões anteriores.
print AdminTask.help('PolicySetManagement')
print AdminTask.help('command_name')
AdminConfig.save()
Finalidade
Utilize o comando setClientDynamicPolicyControl para definir como um cliente obtém a configuração de política de um provedor de serviços.
O cliente pode obter a configuração de política do provedor por meio de uma solicitação Web Services Metadata Exchange (WS-MetadataExchange) ou por meio de uma solicitação GET HTTP. O provedor de serviços deve publicar sua política no formato WS-PolicyAttachment no Web Services Description Language (WSDL) e o cliente deve poder suportar essas políticas do provedor.
No tempo de execução, o cliente utiliza as informações para estabelecer uma configuração de política aceitável para o cliente e o provedor de serviços.
Objeto de destino
Um aplicativo ou serviço que é um cliente de serviços da Web.
Parâmetros Requeridos
- -applicationName
- O nome do aplicativo para o qual você deseja obter a configuração de política do provedor. (String)
- -resource
- O nome do recurso para o qual você deseja obter a configuração de política do provedor. Para todos os recursos de um aplicativo, especifique WebService:/. Alternativamente, é possível especificar um serviço ou referência de serviço .
- Consulte o tópico Configurando a Política de Cliente para Utilizar uma Política de Provedor de Serviços Utilizando Scripts wsadmin para obter mais detalhes.
Parâmetros Opcionais
- -acquireProviderPolicyMethod
- Especifica como a configuração da política do provedor pode ser obtida. (String)Digite um dos seguintes valores:
- httpGet
- Obtenha a configuração de política do provedor usando uma solicitação GET HTTP.
Por padrão, a solicitação GET HTTP é destinada na URL para cada terminal de serviço seguido por ?WSDL. Se você especificar esse valor para um parâmetro resource e desejar especificar um local diferente para a configuração de política do provedor, poderá usar o parâmetro httpGetProperties para alterar o destino do pedido.
Por padrão, a solicitação GET HTTP usa as mesmas políticas de transporte HTTP e SSL como a solicitação de aplicativo. Se você usar o parâmetro httpGetProperties para alterar o destino da solicitação e desejar especificar as políticas de transporte HTTP e SSL diferentes para a solicitação, poderá especificar a política do sistema configurada e a ligação geral que contém as políticas de transporte HTTP e SSL necessárias.
- wsMex
- Obtenha a configuração de política do provedor usando um pedido WS-MetadataExchange.
Por padrão, a solicitação WS-MetadataExchange herda a configuração do conjunto de políticas e de ligação a partir do aplicativo. É possível especificar o conjunto de políticas do sistema e a ligação geral que contém as políticas WS-Security necessárias.
- -wsMexProperties
- Especifica que a segurança no nível de mensagem é necessária para pedidos
WS-MetadataExchange e especifica as configurações que fornecem essa segurança. (Propriedades)Digite os valores a seguir, seguindo cada um com a configuração exigida para esse valor:
- wsMexPolicySetName
- O nome do conjunto de política do sistema que especifica a segurança no nível de mensagem para uma solicitação WS-MetadataExchange. Especifique um conjunto de política do sistema que contenha apenas políticas WS-Security, apenas políticas WS-Addressing, ou ambas.
- wsMexPolicySetBinding
- O nome da ligação geral para o anexo do conjunto de política para uma solicitação WS-MetadataExchange. Especifique uma ligação geral com escopo definido para o domínio global ou com escopo definido para
o domínio de segurança desse serviço. Se você não especificar essa propriedade,
a ligação padrão será utilizada.
O valor é válido apenas ao especificar o valor wsMexPolicySetName.
Esse parâmetro é válido apenas ao especificar wsMex para o parâmetro acquireProviderPolicyMethod.
- -httpGetProperties
- Especifica o destino para adquirir a política do provedor usando uma solicitação GET HTTP se a política do provedor estiver em um local diferente do terminal de destino.
Opcionalmente, especifica o conjunto de políticas de sistema e a ligação geral que contém as políticas de transporte HTTP e SSL requeridas.
(Propriedades)Insira os seguintes valores seguidos pela configuração que requer cada valor:
- httpGetTargetURI
- O URL para o local da política do provedor. Por exemplo, o local pode se referir à política mantida em um registro.
- httpGetPolicySetName
- O nome do conjunto de política do sistema que contém a política de transporte HTTP e SSL a ser usada para a solicitação GET HTTP. Se o conjunto de política do sistema especificado contiver tipos de política diferentes do transporte HTTP e SSL, esses tipos de políticas adicionais serão ignorados.
Esse valor é válido apenas quando especificar httpGetTargetURI.
- httpGetPolicySetBinding
- O nome da ligação geral que contém as ligações de transporte HTTP e SSL para a solicitação GET HTTP. Se você não especificar essa propriedade,
a ligação padrão será utilizada.
Esse valor é válido apenas quando especificar httpGetPolicySetName.
Esse parâmetro é válido apenas ao especificar httpGet para o parâmetro acquireProviderPolicyMethod e o recurso for um serviço. Não utilize esse parâmetro se o recurso for um aplicativo.
- -remove
- Especifica a remoção ou não das informações sobre como o cliente obtém a configuração de política do provedor. (Booleano)Esse parâmetro utiliza os seguintes valores:
- verdadeiro
- As informações sobre como o cliente obtém a configuração de política do provedor são removidas.
- falso
- Esse valor é o padrão. As informações sobre como o cliente obtém a configuração de política do provedor não são removidas.
Exemplos
O exemplo a seguir remove as informações sobre como o cliente obtém a configuração de política do provedor do serviço EchoService do aplicativo cliente WSPolicyClient.
AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService
-remove true]')
O seguinte exemplo configura o serviço EchoService do aplicativo cliente WSPolicyClient para obter a configuração de política do provedor usando a solicitação GET HTTP.
AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService
-acquireProviderPolicyMethod [httpGet ]
-httpGetProperties [httpGetTargetURI http://example_path]]')
O seguinte exemplo configura o serviço EchoService do aplicativo cliente WSPolicyClient para obter a configuração de política do provedor usando a solicitação GET HTTP. A solicitação usa as políticas de transporte HTTP e SSL contidas no conjunto de políticas SystemWSSecurityDefault e a ligação geral "Amostra do Cliente".
AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService
-acquireProviderPolicyMethod [httpGet ]
-httpGetProperties [ [httpGetTargetURI http://example_path]
[httpGetPolicySetName SystemWSSecurityDefault]
[httpGetPolicySetBinding [Client sample]] ]]')
O seguinte exemplo configura o serviço EchoService do aplicativo cliente WSPolicyClient para obter a configuração de política do provedor por meio de uma solicitação WS-MetadataExchange com a segurança no nível de mensagem usando o conjunto de políticas SystemWSSecurityDefault e a ligação de geral "Amostra do Cliente".
AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService
-acquireProviderPolicyMethod [wsMex ]
-wsMexProperties [ [wsMexPolicySetName [SystemWSSecurityDefault]]
[wsMexPolicySetBinding [Client sample]] ]]')