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

Une application qui est un client de services Web peut obtenir la configuration des règles d'un fournisseur de services Web et utiliser ces informations pour établir une configuration de règle acceptable pour le client et le fournisseur de services.

Avant de commencer

Vous avez développé un client de service Web contenant tous les artefacts nécessaires et déployé votre application de services Web sur votre instance de serveur d'applications. Si vous en avez besoin, vous avez associé les ensembles de règles et géré les liaisons associées.

Le fournisseur de services doit publier sa règle dans son fichier WSDL (Web Services Description Language) et celle-ci doit contenir la configuration de ses règles lors de l'exécution au format WS-PolicyAttachments. Le client doit pouvoir prendre en charge les règles du fournisseur.

Pour obtenir la liste des spécifications d'assertion WS-Policy et des domaines WS-Policy pris en charge, reportez-vous à la rubrique WS-Policy.

Pourquoi et quand exécuter cette tâche

Vous pouvez administrer le client pour qu'il se configure lui-même dynamiquement au moment de l'exécution sur la base de la règle du fournisseur de services au format WS-PolicyAttachments standard. Vous pouvez administrer le client pour qu'il applique dynamiquement la règle du fournisseur au niveau de l'application ou du service ou de la référence de service pour prendre un temps d'avance grâce à l'intégration à tous les niveaux.
Remarque : Si vous indiquez un contrôle de stratégie dynamique au niveau de la référence de service, vous devez utiliser la nouveau format de liste avec une paire nom-valeur de la chaîne de ressources. Si vous n'indiquez pas de contrôle de règle dynamique client au niveau de la référence de service, vous pouvez utiliser le format de votre choix.
Tableau 1. Comment spécifier le contrôle de règle à différents niveaux de l'application. Pour chaque niveau applicable de l'application, le tableau répertorie la commande de format de chaîne correspondante et la commande de format de paire nom-valeur nécessaire pour spécifier le contrôle de règles et récapitule le comportement associé.
Niveau Format chaîne Format liste avec paire valeur-nom (NOUVEAU) Comportement
Type "WebService:/" "type=WebService:/" Indique tous les artefacts dans l'application
Maintenance "WebService:/monModule:{espacenom}monService" "type=WebService:/,module=monModule,service={espacenom}monService" Indique tous les artefacts dans le service Web
Noeud final (sous ce service) "WebService:/monModule:{espacenom}monService/noeudfinalA" "type=WebService:/,module=monModule,service={espacenom}monService,endpoint=noeudfinalA" Indique toutes les opérations pour ce noeud final (sous le service)
Opération (sous ce service) "WebService:/monModule:{espacenom}monService/noeudfinalA/opération1" "type=WebService:/,module=monModule,service={espacenom}monService,endpoint=noeudfinalA, operation=opération1" Indique une opération spécifique (sous le service)
Référence de service [Impossible] "type=WebService:/,module=monModule,service={espacenom}monService,serviceRef=maRéfService" Indique tous les artefacts dans la référence de service Web
Noeud final (sous cette référence de service) [Impossible] "type=WebService:/,module=monModule,service={espacenom}monService,serviceRef=maRéfService, endpoint=noeudfinalA" Indique toutes les opérations pour ce noeud final (sous la référence de service)
Opération (sous cette référence de service) [Impossible] "type=WebService:/,module=monModule,service={espacenom}monService,serviceRef=maRéfService, endpoint=noeudfinalA,operation=opération1" Indique une opération spécifique (sous la référence de service)

Si les règles du fournisseur utilisent des WSDL à plusieurs parties, vous pouvez utiliser une requête HTTP GET pour obtenir ces règles mais vous ne pouvez pas utiliser le protocole WS-MetadataExchange. Pour plus d'informations sur les WSDL à plusieurs parties, consultez la rubrique relative à WSDL.

L'intersection de règles est la comparaison d'une règle du client et d'une règle du fournisseur pour déterminer si elles sont compatibles et le calcul d'une nouvelle règle, connue comme la règle effective, conforme à leurs exigences et fonctions.

Cette rubrique explique comment configurer la règle du client afin qu'elle utilise une règle de fournisseur de services à l'aide des commandes wsadmin. Vous pouvez également configurer la règle du client afin qu'elle utilise une règle de fournisseur de services à l'aide de la console d'administration.

Procédure

  1. Démarrez le client de scriptage wsadmin s'il ne l'est pas déjà.
  2. Utilisez la commande SetClientDynamicPolicyControl. Par exemple :
    AdminTask.setClientDynamicPolicyControl('[-applicationName WebServiceClientApplication 
    -resource WebService:/ClientApplication.war:{http://example_path/}Service1 
    -acquireProviderPolicyMethod [httpGet ] 
    -httpGetProperties [httpGetTargetURI http://example_path]]') 
  3. Sauvegardez les modifications dans la configuration principale.
    Pour sauvegarder les changements de configuration, entrez la commande suivante :
    AdminConfig.save()

Résultats

La règle coté client d'une application Web est calculée quand elle est demandée au moment de l'exécution sur la base de la règle du fournisseur de services ou de l'ensemble de règles du client et de la règle du fournisseur de services, selon l'option sélectionnée. Cette règle calculée est appelée la "règle effective" et est mise en mémoire cache en tant que paramètre de configuration d'exécution. La règle effective est utilisée pour les demandes ultérieures de services Web sortantes au noeud final ou à l'opération pour laquelle le calcul de règle dynamique a été effectué. La configuration de l'ensemble de règles du client ne change pas.

La règle du fournisseur que le client détient pour un service est régénérée la première fois que le service Web est appelé après le chargement de l'application. Ensuite, la règle du fournisseur est actualisée lorsque l'application redémarre ou si elle appelle de manière explicite une mise à jour. Une fois les règles du fournisseur régénérées, les règles effectives sont recalculées.


Icône indiquant le type de rubrique Rubrique de tâche



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=twbs_wsp_client_sppw
Nom du fichier : twbs_wsp_client_sppw.html