Commande setClientDynamicPolicyControl

Utilisez la commande setClientDynamicPolicyControl pour définir comment une application qui est un client de services Web obtient la configuration de règle d'un fournisseur de services Web. Vous pouvez définir, actualiser ou supprimer les informations qui indiquent comment une règle de fournisseur est obtenue.

Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.

[IBM i]Le client de scriptage wsadmin est exécuté depuis Qshell. Pour plus d'informations, voir "Configurer Qshell pour exécuter des scripts WebSphere Application Server".

Cette commande est valide uniquement lorsqu'elle est utilisée avec des serveurs d'applications WebSphere Application Server de version 7 et ultérieures. Ne l'utilisez pas avec des versions antérieures.

Pour obtenir la liste des commandes d'administration de gestion des ensembles de règles disponibles, ainsi qu'une brève description de chaque commande, entrez la commande suivante à l'invite wsadmin :

print AdminTask.help('PolicySetManagement')

Pour obtenir une aide générale sur une commande donnée, entrez la commande suivante à l'invite wsadmin :

print AdminTask.help('nom_commande')

Après avoir utilisé la commande, sauvegardez vos modifications dans la configuration maîtresse. Par exemple, utilisez la commande suivante :

AdminConfig.save()

Rôle

Utilisez la commande setClientDynamicPolicyControl pour définir comment un client obtient la configuration de règles d'un fournisseur de services.

Le client peut obtenir la configuration de règles du fournisseur via une demande WS-MetadataExchange (Web Services Metadata Exchange) ou via une requête HTTP GET. Le fournisseur de services doit publier sa règle au format WS-PolicyAttachment dans son WSDL (Web Services Description Language) et le client doit pouvoir prendre en charge les règles du fournisseur.

Lors de l'exécution, le client utilise les informations pour établir une configuration de règles qui soit acceptable pour le client et le fournisseur de services.

Objet cible

Application ou service qui est un client de services Web.

Paramètres requis

-applicationName
Nom de l'application pour laquelle vous souhaitez obtenir la configuration de règles du fournisseur. (Chaîne)
-resource
Nom de la ressource pour laquelle vous souhaitez obtenir la configuration de règles du fournisseur. Pour toutes les ressources dans une application, spécifiez WebService:/. Vous pouvez également spécifier un service de la référence de service .
Voir la rubrique Configuration de la règle client en fonction de la règle d'un fournisseur de services à l'aide de l'outil de scriptage wsadmin pour plus de détails.

Paramètres optionnels

-acquireProviderPolicyMethod
Spécifie comment la configuration de règles du fournisseur peut être obtenue. (Chaîne)
Entrez l'une des valeurs suivantes :
httpGet
Obtenez la configuration de règle du fournisseur à l'aide d'une requête HTTP GET.

Par défaut, la requête HTTP GET est ciblée sur l'URL de chaque noeud final de service suivie de ?WSDL. Si vous indiquez un service pour le paramètre resource et que vous voulez indiquer un autre emplacement pour la configuration des règles du fournisseur, vous pouvez utiliser le paramètre httpGetProperties pour modifier la cible de la demande.

Par défaut, la demande HTTP GET utilise les mêmes règles de transport HTTP et SSL que la demande d'application. Si vous utilisez le paramètre httpGetProperties pour modifier la cible de la demande, et vous voulez définir des règles de transport HTTP et SSL différentes pour celle-ci, vous pouvez spécifier l'ensemble de règles système et la liaison générale contenant les règles de transport dont vous avez besoin.

wsMex
Obtenez la configuration de règle du fournisseur à l'aide d'une demande WS-MetadataExchange.

Par défaut, la demande WS-MetadataExchange hérite de l'ensemble de règles et de la configuration de liaison de l'application. Vous pouvez spécifier l'ensemble de règles système et la liaison générale contenant les règles WS-Security dont vous avez besoin.

-wsMexProperties
Indique que la sécurité de niveau message est requise pour les demandes WS-MetadataExchange et spécifie les paramètres qui fournissent cette sécurité. (Propriétés)
Entrez les valeurs suivantes, en faisant suivre chaque valeur du paramètre requis :
wsMexPolicySetName
Nom de l'ensemble de règles système qui spécifie la sécurité au niveau du message pour une demande WS-MetadataExchange. Spécifiez un ensemble qui ne contient que des règles WS-Security, que des règles WS-Addressing ou les deux.
wsMexPolicySetBinding
Nom de la liaison générale de l'association d'ensemble de règles pour une demande WS-MetadataExchange. Spécifiez une liaison générale dont la portée est le domaine global ou le domaine de sécurité de ce service. Si vous ne spécifiez pas cette propriété, la liaison par défaut est utilisée.

Cette valeur n'est admise que si la valeur wsMexPolicySetName est définie.

Ce paramètre n'est valable que lorsque vous spécifiez wsMex pour le paramètre acquireProviderPolicyMethod.

-httpGetProperties
Indique la cible à utiliser pour obtenir les règles du fournisseur à l'aide d'une requête HTTP GET, dans le cas où ces règles ne résident pas sur le noeud final cible. Spécifie facultativement l'ensemble de règles système et la liaison générale contenant les règles HTTP dont vous avez besoin. (Propriétés)
Entrez les valeurs suivantes, suivies du paramètre requis :
httpGetTargetURI
URL de l'emplacement des règles du fournisseur. Par exemple, l'emplacement peut désigner des règles contenues dans un registre.
httpGetPolicySetName
Nom de l'ensemble de règles système qui contient la règle de transport HTTP et SSL à utiliser pour la demande HTTP GET. Si l'ensemble de règles système contient des types de règles autres que le transport HTTP et SSL, ces types sont ignorés.

Cette valeur n'est admise que si la valeur httpGetTargetURI est définie.

httpGetPolicySetBinding
Nom de la liaison générale qui contient les liaisons de transport HTTP et SSL à utiliser pour la demande HTTP GET. Si vous ne spécifiez pas cette propriété, la liaison par défaut est utilisée.

Cette valeur n'est admise que si la valeur httpGetPolicySetName est définie.

Ce paramètre n'est valable que si vous spécifiez httpGet pour le paramètre acquireProviderPolicyMethod et que la ressource est un service. N'utilisez pas ce paramètre si la ressource est une application.

-remove
Spécifie si les informations indiquant comment le client obtient la configuration de règles du fournisseur doivent être supprimées. (Booléen)
Ce paramètre adopte les valeurs suivantes :
true
Les informations indiquant comment le client obtient la configuration de règles du fournisseur sont supprimées.
false
Il s'agit de la valeur par défaut. Les informations indiquant comment le client obtient la configuration de règles du fournisseur ne sont pas supprimées.

Exemples

L'exemple suivant supprime les informations qui indiquent comment le client obtient la configuration de règles du fournisseur à partir du service EchoService de l'application client WSPolicyClient.

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

L'exemple suivant configure le service EchoService de l'application client WSPolicyClient pour obtenir la configuration de règle du fournisseur à l'aide d'une requête HTTP GET.

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

L'exemple suivant configure le service EchoService de l'application client WSPolicyClient pour obtenir la configuration de règle du fournisseur à l'aide d'une requête HTTP GET. La demande utilise les règles de transport HTTP et SSL contenues dans l'ensemble de règles SystemWSSecurityDefault et la liaison générale "Client sample".

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

L'exemple suivant configure le service EchoService de l'application client WSPolicyClient pour obtenir la configuration de règle du fournisseur par une demande WS-MetadataExchange avec la sécurité de niveau message, à l'aide de l'ensemble de règles SystemWSSecurityDefault et de la liaison générale "Client sample".

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

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_wsp_setcdpolicyc
Nom du fichier : rwbs_wsp_setcdpolicyc.html