Configuration d'un fournisseur de services en vue du partage de la configuration de ses règles

Un fournisseur de services WebSphere Application Server peut partager la configuration de ses règles dans un fichier WSDL (Web Services Description Language) publié ou un fichier WSDL obtenu à l'aide d'une requête HTTP GET ou de la demande GetMetadata Web Services Metadata Exchange (WS-MetadataExchange).

Avant de commencer

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

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

Pourquoi et quand exécuter cette tâche

Vous pouvez rendre la configuration de règles d'un noeud final de service JAX-WS (Java™ API for XML-Based Web Services) disponible pour partage de différentes manières :
  • Incluez la configuration de la règle du fournisseur de services dans le WSDL. Le fichier WSDL peut être alors publié ou obtenu à l'aide d'une requête HTTP GET.
  • Activez le protocole d'échange de métadonnées de services Web (WS-MetadataExchange) afin que la configuration des règles du fournisseur de services soit incluse dans le WSDL et disponible pour une demande GetMetadata WS-MetadataExchange. L'utilisation du protocole WS-MetadataExchange vous offre l'avantage de pouvoir appliquer la sécurité de niveau message aux demandes GetMetaData WS-MetadataExchange à l'aide d'un ensemble de règles système adaptées.

Si l'application du fournisseur de services utilise des WSDL à plusieurs parties, tous les WSDL doivent être sur le même système que l'application de service Web. Pour plus d'informations sur la version à plusieurs parties de WSDL, consultez la rubrique relative à WSDL.

Vous devez configurer un fournisseur de services pour le partage de sa configuration de règles car celle-ci est par défaut indisponible dans son fichier WSDL. Vous pouvez configurer le fournisseur de services afin que la configuration des règles soit incluse dans son WSDL, afin d'utiliser WS-MetadataExchange de telle sorte que la configuration des règles soit disponible, ou les deux. Cette rubrique explique comment configurer un fournisseur de services pour partager la configuration de ses règles à l'aide de la console d'administration. Vous pouvez également configurer un fournisseur de services pour qu'il partage la configuration de ses règles à l'aide des commandes wsadmin ou des outils Rational Application Developer.

Vous pouvez configurer un fournisseur de services pour le partage de sa configuration de règles au niveau de l'application ou du service. La configuration de règles qui est représentée par les ensembles de règles liés à n'importe quel niveau inférieur est également partagée. Les ensembles de règles liés à des niveaux inférieurs se substituent à la configuration d'un ensemble de règles lié à un niveau supérieur.

Procédure

  1. Dans le panneau de navigation de la console d'administration, cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere > instance_application_fournisseur_services > [Propriétés des services Web] Liaisons et ensemble de règles du fournisseur de services.
  2. Sur la ligne de l'application ou du service auquel le fournisseur de service que vous souhaitez partagé est associé, cliquez sur le lien dans la colonne Partage de règles. Le lien est Activé ou Désactivé. Le panneau Partage de règles s'affiche.
  3. Pour inclure la configuration des règles du fournisseur de services dans son fichier WSDL afin qu'elle puisse être publiée ou obtenue à l'aide d'une requête HTTP GET, sélectionnez WSDL exporté.
  4. Pour activer WS-MetadataExchange et mettre à disposition la configuration des règles du fournisseur de services pour une requête GetMetadata WS-MetadataExchange, sélectionnez Requête WS-MetadataExchange.
  5. Facultatif : Si vous sélectionnez Requête WS-MetadataExchange et souhaitez utiliser la sécurité au niveau des messages, sélectionnez Association d'un ensemble de règles du système pour WS-MetadataExchange, puis sélectionnez un ensemble de règles et une liaison appropriés dans les listes déroulantes. Voir Configuration de la sécurité d'une requête WS-MetadataExchange.
  6. Cliquez sur OK et sauvegardez vos modifications dans la configuration maîtresse.

Résultats

La configuration des règles du fournisseur de services est disponible pour ses clients. Le fichier WSDL du fournisseur de services contient la configuration de règles actuelle au format WS-PolicyAttachments afin qu'il soit disponible pour les autres clients, registres de services ou services prenant en charge la spécification WS-Policy (Web Services Policy). Le lien figurant dans la colonne Partage des règles dans le panneau Liaisons et ensemble de règles du fournisseur de services est alors Activé.
Si la configuration de la règle ne peut pas être partagée, une erreur décrivant le problème est consignée dans le journal des erreurs du fournisseur de services et la règle suivante est jointe au WSDL du fournisseur de services :
<wsp:Policy>
<wsp:ExactlyOne>
</wsp:ExactlyOne>
</wsp:Policy>
Cette règle indique au client qu'il n'y a pas de configuration de règles acceptable pour le service. D'autres aspects du WSDL ne sont pas affectés.

Un fournisseur de services peut ne pas être en mesure de partager la configuration de ses règles car cette configuration ne peut pas être exprimée dans le format WS-PolicyAttachments standard. Une raison à cela peut être que plusieurs règles incompatibles sont définies pour un point d'association particulier. Une autre raison peut être que les informations de liaison sont insuffisantes pour générer la règle standard. La configuration des règles peut inclure une règle d'amorce, par exemple la règle d'accès à un service WS-Trust, ainsi la règle d'amorce doit être également exprimée dans le format WS-PolicyAttachments.


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_server_share
Nom du fichier : twbs_wsp_server_share.html