Commande getClientDynamicPolicyControl
Utilisez la commande getClientDynamicPolicyControl pour savoir si une application qui est un client de services web obtient la configuration de règles d'un fournisseur de services web et dresser la liste des propriétés qui s'appliquent pour l'obtention de cette configuration.
Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.
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.
print AdminTask.help('PolicySetManagement')
print AdminTask.help('nom_commande')
AdminConfig.save()
Rôle
Utilisez la commande getClientDynamicPolicyControl pour trouver comment une application, ou un service dans une application, 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.
Objet cible
Aucun.
Paramètres requis
- -applicationName
- Nom de l'application pour laquelle vous souhaitez trouver comment elle obtient la configuration de règles d'un fournisseur de services. L'application doit être un client de services. (Chaîne)
Paramètres optionnels
- -resource
- Nom de la ressource pour laquelle vous souhaitez trouver comment elle obtient la configuration de règles d'un fournisseur de services. Si vous définissez ce paramètre, seules les propriétés de cette ressource sont renvoyées. Pour extraire des informations pour l'application, spécifiez WebService:/. Vous pouvez également spécifier un service, une référence de service, un noeud final ou une opération. (Chaîne)
- Pour plus de détails, 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.
Valeur renvoyée
- httpGetTargetURI
- URL cible de la requête HTTP GET. Cette propriété est renvoyée si la valeur de la propriété acquireProviderPolicyMethod est httpGet.
- httpGetPolicySetName
- Ensemble de règles système qui contient la règle de transport HTTP et SSL à utiliser pour la demande HTTP GET. Cette propriété est renvoyée si la propriété httpGetTargetURI a une valeur.
- httpGetPolicySetBinding
- Liaison générale qui contient les liaisons de transport HTTP et SSL à utiliser pour la demande HTTP GET. Cette propriété est renvoyée si la propriété httpGetTargetURI a une valeur.
- wsMexPolicySetName
- Nom de l'ensemble de règles qui spécifie la sécurité au niveau du message lorsque la ressource partage sa configuration de règles avec une demande WS-MetadataExchange. Cette propriété est renvoyée si la valeur de la propriété acquireProviderPolicyMethod est wsMex et qu'un ensemble de règles a été spécifié pour assurer la sécurité au niveau du message.
- wsMexPolicySetBinding
- Nom de la liaison utilisée lorsque la ressource partage sa configuration de règles avec une demande WS-MetadataExchange. Cette propriété est renvoyée si la valeur de la propriété acquireProviderPolicyMethod est wsMex et qu'une liaison a été spécifiée pour assurer la sécurité au niveau du message.
- acquireProviderPolicyMethod
- Comment la configuration de règles du fournisseur peut être obtenue.
Les valeurs
valides de cette propriété sont les suivantes :
- wsMex
- La ressource peut obtenir la configuration de règles d'un fournisseur de services via une requête WS-MetadataExchange.
- httpGet
- La ressource peut obtenir la configuration de règle d'un fournisseur de services via une requête HTTP GET.
- ressource
- Ressource que vous avez spécifiée.
- directSetting
- Comment les propriétés s'appliquent à la ressource. Les valeurs valides pour cette propriété sont les suivantes :
- true
- Les propriétés s'appliquent directement à la ressource.
- false
- Les propriétés sont héritées de l'application ou du service parent.
Exemples
L'exemple suivant affiche les propriétés qui contrôlent comment le service EchoService de l'application WSPolicyClient obtient la configuration de règles d'un fournisseur de services. Le client est configuré pour extraire la règle du fournisseur via une requête WS-MetadataExchange avec la sécurité au niveau du message, à l'aide de l'ensemble de règles SystemWSSecurityDefault et la liaison générale "Client sample".
AdminTask.getClientDynamicPolicyControl(['-applicationName', 'WSPolicyClient',
'-resource', 'WebService:/WSPClient.war:{http://example_path/}EchoService'])
.
.
[ [wsMexPolicySetName SystemWSSecurityDefault] [wsMexPolicySetBinding [Client sample]]
[acquireProviderPolicyMethod [wsMex]]
[resource WebService:/WSPClient.war:{http://example_path/}EchoService/]
[directSetting true] ]
L'exemple suivant affiche les propriétés qui contrôlent comment le service Echoservice de l'application WSPolicyClient obtient la configuration de règle d'un fournisseur de services lorsque le client est configuré pour extraire la règle du fournisseur via une requête HTTP GET.
AdminTask.getClientDynamicPolicyControl(['-applicationName', 'WSPolicyClient',
'-resource', 'WebService:/WSPClient.war:{http://example_path/}EchoService'])
.
.
[ [httpGetTargetURI http://exemple_de_chemin/EchoService?wsdl]
[acquireProviderPolicyMethod [httpGet]]
[resource WebService:/WSPClient.war:{http://example_path/}EchoService/]
[directSetting true] ]