Modification d'une configuration de service entrant existante

Permet de modifier les détails de la configuration d'un service entrant existante. Par exemple, sécuriser le service, appliquer les listes de gestionnaires JAX-RPC aux ports pour le service, publier le service dans plusieurs registres UDDI.

Pourquoi et quand exécuter cette tâche

Un service entrant est une interface Web avec un service fourni en interne (par votre propre entreprise et hébergé dans un emplacement directement disponible par l'intermédiaire d'une destination de bus d'intégration de services).

Lorsque vous créez un service entrant, vous le connectez à un ou plusieurs programmes d'écoute de noeud final et (facultatif) indiquez les propriétés de publication UDDI utilisées pour publier le service entrant dans un registre UDDI initial. Un port de communications entrantes est automatiquement créé pour chaque programme d'écoute de noeud final que vous sélectionnez, mais la création a lieu sans modèle de port, liste de gestionnaires JAX-RPC et paramètres de sécurité. Modifiez la configuration de votre service entrant si vous souhaitez contrôler et surveiller l'accès aux services entrants de l'une des façons suivantes :
  • Associez les listes de gestionnaires JAX-RPC aux ports : de cette façon, les gestionnaires peuvent contrôler l'activité sur le port et entreprendre les actions adéquates selon l'expéditeur et le contenu de chaque message passant par le port.
  • Protégez par un mot de passe une opération de service Web.
  • Définissez le niveau de sécurité à appliquer aux messages (liaisons et configuration WS-Security). Le niveau de sécurité peut être défini indépendamment pour les messages de demande et de réponse.
  • Publiez le service dans un ou plusieurs registres UDDI.

Pour répertorier les services entrants existants, ainsi qu'afficher et modifier leurs détails de configuration, procédez comme suit :

Procédure

  1. Démarrez la console d'administration.
  2. Dans le panneau de navigation, cliquez sur Intégration des services -> Bus -> nom_bus -> [Services] Services entrants La liste de tous les services entrants s'affiche dans un formulaire de collecte de services entrants.
  3. Cliquez sur le nom d'un service entrant dans la liste. Les paramètres actuels de ce service entrant sont affichés.
  4. Facultatif : Cliquez sur Recharger le modèle de document WSDL pour recharger le modèle de fichier WSDL pour ce service entrant.
    Remarque :
    • Lorsque vous créez un service entrant, une copie du modèle de fichier WSDL du service est chargée dans un référentiel géré en local. Si vous modifiez le modèle de fichier WSDL, vous devez mettre à jour la copie locale.
    • Lorsque vous cliquez sur Recharger le modèle de document WSDL, vous exécutez la commande décrite dans la rubrique Régénération du fichier WSDL d'un service entrant à l'aide de l'outil wsadmin. Pour que la commande puisse être exécutée correctement, les conditions décrites dans cette rubrique doivent être satisfaites.
    • Si le bus doit transmettre des messages via un serveur proxy d'authentification pour extraire des documents WSDL, vous ne pouvez pas utiliser l'option Recharger le modèle de document WSDL et vous devez exécuter la commande de régénération WSDL à l'aide de l'outil wsadmin. Pour plus d'informations, consultez les conseils de traitement des incidents correspondants.
  5. Modifiez les propriétés générales. Pour des informations sur chaque propriétés, voir Paramètres des services entrants.
    Remarque :
    • Lorsque vous modifiez le nom d'un service entrant, le système recherche tous les objets qui y font référence et met à jour ce nom.
    • Le modèle de fichier WSDL correspond au fichier WSDL spécifique au service, que vous créez pour décrire ce service entrant. Pour plus d'informations sur la manière de créer un fichier WSDL, voir Développement d'un fichier WSDL pour les applications JAX-RPC.
    • Logiquement, le nom du modèle de fichier WSDL et l'espace de nom ne sont requis que si le WSDL comporte plusieurs services, mais les zones permettant de les définir sont codés dans la console d'administration comme des zones obligatoires. Ces zones étant renseignées automatiquement par défaut, si elles ne sont pas requises pour votre service, vous devez conserver les valeurs par défaut. Si vous supprimez la valeur de l'une de ces zones, la console d'administration traite la zone vide comme une erreur.
    • Si vous sélectionnez l'option pour activer la sécurité au niveau des opérations, vous devez également, pour ce service entrant, suivre la procédure décrite dans la rubrique Protection par mot de passe d'une opération de service Web.
  6. Modifiez les propriétés supplémentaires.
    1. Modifiez les ports de communications entrantes associés à ce service entrant.

      Un port entrant décrit l'activation des services Web d'une destination de service sur un écouteur de noeud final avec la configuration associée. Chaque port entrant est associé à un module d'écoute de noeud final et vous pouvez contrôler les groupes d'utilisateurs qui peuvent accéder à un service entrant en rendant ce service accessible uniquement via des modules d'écoute de noeud final spécifiques. Pour plus d'informations, voir Programmes d'écoute de noeud final et ports d'entrée : Points d'entrée sur le bus d'intégration de services.

      Une liste de gestionnaires JAX-RPC permet de surveiller l'activité au niveau d'un port et de prendre les mesures appropriées selon l'émetteur et le contenu des messages qui transitent par ce port. Pour plus d'informations, voir Services Web activés par un bus et gestionnaires JAX-RPC.

      Vous pouvez définir des niveaux de sécurité applicables aux messages, à l'aide de WS-Security. Le niveau de sécurité peut être défini indépendamment pour les messages de demande et de réponse. Pour plus d'informations, voir Technologies d'intégration de services et WS-Security.

      Voir aussi Paramètres des ports entrants.

    2. Modifiez les propriétés de publication UDDI permettant de publier ce service entrant sur un ou plusieurs registres UDDI. Pour plus d'informations sur les propriétés de publication UDDI, voir Paramètres de publication UDDI et Registres UDDI : annuaires de services web pouvant être référencés par des services Web activés par un bus.
    3. Modifiez les éventuelles propriétés personnalisées que vous avez définies pour ce service entrant. Ces propriétés personnalisées sont les paires nom/valeur que vous pouvez utiliser pour définir les propriétés de configuration système. Dans chaque paire, le nom est une clé de propriété et la valeur est une valeur de chaîne.
    4. A l'aide des fichiers WSDL de publication, exportez le fichier WSDL modèle de ce service entrant dans un fichier compressé.

      Pour donner un aperçu de la technologie, le fichier compressé exporté inclut une version du fichier WSDL pour laquelle aucun port (liaison) n'est défini. Ce WSDL non lié est destiné à vos collègues qui se préparent à déployer un service entrant. Il vous offre un moyen pratique pour partager avec les membres de votre équipe des informations sur le déploiement planifié pour le service. Lorsque vous déployez enfin le service entrant, le WSDL associé doit être complet (il doit inclure les informations de liaison).

      Le fichier WSDL non lié est toujours publié dans le fichier exporté du service entrant, avec le fichier WSDL lié si des ports sont définis pour le service entrant. Par conséquent, le fichier compressé, nommé nom_service_entrant.zip, contient toujours les fichiers suivants :
      • nom_bus.nom_service_entrantNonBound.wsdl (ce fichier contient le service non lié, le port et la liaison du service entrant).
      • nom_bus.nom_service_entrantPortTypes.wsdl (ce fichier contient la définition de type de port du service entrant).
      Si le service entrant dispose d'un ou de plusieurs ports, le fichier compressé contient en plus les fichiers suivants :
      • nom_bus.nom_service_entrantService.wsdl (ce fichier contient les éléments service et port pour le service entrant).
      • nom_bus.nom_service_entrantBindings.wsdl (ce fichier contient les éléments de liaison qui correspondent aux ports du service entrant).

      S'il existe une erreur lors de la génération d'un élément WSDL, une page d'erreur s'affiche.

  7. Sauvegardez les modifications de la configuration principale.

Résultats

Si le traitement se déroule correctement, la liste des services entrants de ce bus d'intégration de services s'affiche à nouveau. Sinon, un message d'erreur est s'affiche.

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