Mandato setClientDynamicPolicyControl

Utilice el mandato setClientDynamicPolicyControl para establecer cómo una aplicación que es un cliente de servicios web obtiene la configuración de políticas de un proveedor de servicios web. Puede establecer, renovar o eliminar esta información acerca de cómo se obtiene una política de proveedor.

Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.

[IBM i]El cliente de script wsadmin se ejecuta desde Qshell. Para más información, consulte el tema "Configurar Qshell para ejecutar scripts de WebSphere Application Server".

Este mandato sólo es válido cuando se utiliza con servidores de aplicaciones WebSphere Application Server versión 7 y posteriores. No lo utilice con versiones anteriores.

Si desea obtener una lista de los mandatos administrativos de gestión de conjunto de políticas disponibles, además de una breve descripción de cada mandato, especifique el mandato siguiente en el indicador de wsadmin:

print AdminTask.help('PolicySetManagement')

Si desea ayuda general sobre un mandato determinado, especifique el mandato siguiente en el indicador de wsadmin:

print AdminTask.help('nombre_mandato')

Después de utilizar el mandato, guarde los cambios en la configuración maestra. Por ejemplo, utilice el mandato siguiente:

AdminConfig.save()

Finalidad

Utilice el mandato setClientDynamicPolicyControl para establecer cómo un cliente obtiene la configuración de políticas de un proveedor de servicios.

El cliente puede obtener la configuración de políticas del proveedor a través de una solicitud WS-MetadataExchange (Web Services Metadata Exchange) o a través de una solicitud HTTP GET. El proveedor de servicios debe publicar su política en formato WS-PolicyAttachment en el WSDL (Web Services Description Language) y el cliente debe poder soportar estas políticas del proveedor.

Durante el tiempo de ejecución, el cliente utiliza la información para establecer una configuración de políticas que sea aceptable para el cliente y para el proveedor de servicios.

Objeto de destino

Una aplicación o un servicio que es un cliente de servicios web.

Parámetros necesarios

-applicationName
Nombre de la aplicación para la que desea obtener la configuración de políticas del proveedor. (Serie)
-resource
Nombre del recurso para el que desea obtener la configuración de políticas del proveedor. Para ver todos los recursos de la aplicación, especifique WebService:/. También puede especificar un servicio o una referencia de servicio .
Consulte el tema Configuración de la política del cliente para utilizar una política de proveedor de servicios utilizando scripts wsadmin para obtener más detalles.

Parámetros opcionales

-acquireProviderPolicyMethod
Especifica cómo se puede obtener la configuración de política del proveedor. (Serie)
Especifique uno de los valores siguientes:
httpGet
Obtiene la configuración de políticas del proveedor mediante una solicitud HTTP GET.

De forma predeterminada, la solicitud HTTP GET está dirigida al URL de cada punto final de servicio seguido de ?WSDL. Si especifica un servicio para el parámetro resource, y desea especificar una ubicación distinta para la configuración de política del proveedor, puede utilizar el parámetro httpGetProperties para cambiar el destino de la solicitud.

De forma predeterminada, la solicitud HTTP GET utiliza las mismas políticas de transporte HTTP y SSL como la solicitud de aplicación. Si utiliza el parámetro httpGetProperties para cambiar el destino de la solicitud y desea especificar diferentes políticas de transporte HTTP y SSL para la solicitud, puede especificar el conjunto de políticas del sistema y el enlace general que contiene las políticas de transporte HTTP y SSL que necesite.

wsMex
Obtiene la configuración de políticas del proveedor mediante una solicitud WS-MetadataExchange.

De forma predeterminada, la solicitud WS-MetadataExchange hereda el conjunto de políticas y la configuración de enlace de la aplicación. Puede especificar el conjunto de políticas del sistema y el enlace general que contiene las políticas WS-Security que necesita.

-wsMexProperties
Especifica que la seguridad a nivel de mensajes es necesaria para las solicitudes WS-MetadataExchange, además de especificar los valores que proporcionan la seguridad a nivel de mensajes. (Properties)
Especifique los siguientes valores, siguiendo cada valor del elemento necesario para dicho valor:
wsMexPolicySetName
Nombre del conjunto de políticas del sistema que especifica la seguridad a nivel de mensaje para una solicitud WS-MetadataExchange. Especifique un conjunto de políticas del sistema que contenga sólo políticas WS-Security, sólo políticas WS-Addressing, o ambas.
wsMexPolicySetBinding
Nombre del enlace general para la conexión de conjunto de políticas para una solicitud WS-MetadataExchange. Especifique un enlace general cuyo ámbito sea el dominio global, o el dominio de seguridad de este servicio. Si no especifica esta propiedad, se utilizará el enlace predeterminado.

Este valor sólo es válido cuando se especifica el valor wsMexPolicySetName.

Este parámetro sólo es válido si especifica wsMex para el parámetro acquireProviderPolicyMethod.

-httpGetProperties
Especifica el destino para adquirir una política de proveedor utilizando una solicitud HTTP GET si la política del proveedor se encuentra en una ubicación distinta del punto final de destino. Opcionalmente, especifica el conjunto de políticas del sistema y el enlace general que contiene el HTTP y las políticas de transporte SSL que requiere. (Properties)
Especifique los valores siguientes, seguidos del valor necesario para cada valor:
httpGetTargetURI
URL para la ubicación de la política de proveedor. Por ejemplo, la ubicación puede hacer referencia a la política de un registro.
httpGetPolicySetName
Nombre del conjunto de políticas del sistema que contiene la política de transporte HTTP y SSL que se va a utilizar para la solicitud HTTP GET. Si el conjunto de políticas del sistema especificado contiene tipos de política distintos de transporte HTTP y SSL, estos tipos de política adicionales se omiten.

Este valor sólo es válido cuando se especifica el valor httpGetTargetURI.

httpGetPolicySetBinding
Nombre del enlace general que contiene los enlaces de transporte HTTP y SSL para la solicitud HTTP GET. Si no especifica esta propiedad, se utilizará el enlace predeterminado.

Este valor sólo es válido cuando se especifica el valor httpGetPolicySetName.

Este parámetro sólo es válido si se especifica httpGet para el parámetro acquireProviderPolicyMethod y el recurso es un servicio. No utilice este parámetro si el recurso es una aplicación.

-remove
Especifica si desea eliminar la información acerca de cómo el cliente obtiene la configuración de políticas del proveedor. (Booleano)
Este parámetro acepta los valores siguientes:
true
Se elimina la información acerca de cómo el cliente obtiene la configuración de políticas del proveedor.
false
Este valor es el predeterminado. No se elimina la información acerca de cómo el cliente obtiene la configuración de políticas del proveedor.

Ejemplos

En el ejemplo siguiente se elimina la información sobre cómo obtiene el cliente la configuración de política del proveedor del servicio EchoService de la aplicación de cliente WSPolicyClient.

AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient 
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService 
-remove true]')

En el ejemplo siguiente se configura el servicio EchoService de la aplicación de cliente WSPolicyClient para obtener la configuración de políticas del proveedor utilizando una solicitud HTTP GET.

AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient 
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService 
-acquireProviderPolicyMethod [httpGet ] 
-httpGetProperties [httpGetTargetURI http:/vía_acceso_ejemplo]]') 

En el ejemplo siguiente se configura el servicio EchoService de la aplicación de cliente WSPolicyClient para obtener la configuración de políticas del proveedor utilizando una solicitud HTTP GET. La solicitud utiliza las políticas de transporte HTTP y SSL contenidas en el conjunto de políticas SystemWSSecurityDefault y el enlace general "Client sample".

AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient 
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService 
-acquireProviderPolicyMethod [httpGet ] 
-httpGetProperties [ [httpGetTargetURI http://example_path] 
[httpGetPolicySetName SystemWSSecurityDefault] 
[httpGetPolicySetBinding [Client sample]] ]]') 

En el ejemplo siguiente se configura el servicio EchoService de la aplicación de cliente WSPolicyClient para obtener la configuración de política del proveedor mediante una solicitud WS-MetadataExchange con seguridad a nivel de mensajes, utilizando el conjunto de políticas SystemWSSecurityDefault y el enlace general "Client sample".

AdminTask.setClientDynamicPolicyControl('[-applicationName WSPolicyClient 
-resource WebService:/WSPolicyClient.war:{http://example_path/}EchoService 
-acquireProviderPolicyMethod [wsMex ] 
-wsMexProperties [ [wsMexPolicySetName [SystemWSSecurityDefault]] 
[wsMexPolicySetBinding [Client sample]] ]]') 

Icon that indicates the type of topic Reference topic



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