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.

[IBM i]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.

Para obter uma lista dos comandos administrativos disponíveis de gerenciamento de conjunto de política, além de uma breve descrição de cada comando, digite o seguinte comando no prompt wsadmin:

print AdminTask.help('PolicySetManagement')

Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:

print AdminTask.help('command_name')

Depois de utilizar o comando, salve suas alterações na configuração principal. Por exemplo, utilize o seguinte comando:

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]] ]]') 

Ícone que indica o tipo de tópico Tópico de Referência



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