Création d'une configuration de service passerelle

Utilisez la passerelle des services Web pour mapper un service existant (un service entrant ou un service sortant) à un nouveau service Web qui semble être fourni par la passerelle. Le service passerelle joue le rôle de proxy : les utilisateurs de votre service passerelle doivent savoir si le service sous-jacent est fourni de manière interne ou externe.

Avant de commencer

Pour une vue générale de la méthode de configuration de la passerelle des services Web dans le cadre d'une configuration globale des services Web activés par un bus d'intégration de services, voir Activation des services Web via le bus d'intégration de services.

Comme vous configurez chaque service passerelle pour une instance de passerelle spécifique, vous devez créer l'instance de passerelle avant de configurer des services de passerelle pour elle.

Le WSDL du service passerelle est créé à partir du WSDL du premier service cible. Si le service cible correspond à un service Web externe, un fichier WSDL lui est déjà associé. S'il s'agit d'un service interne :
Cette rubrique suppose également que :

Déterminez la méthode à utiliser pour configurer ces ressources. Vous pouvez créer un service de passerelle à l'aide de la console d'administration, comme décrit dans cette tâche, ou à l'aide de la Commande createWSGWGatewayService.

Pourquoi et quand exécuter cette tâche

L'illustration suivant montre l'apparence d'un service passerelle pour les applications demandeuses client, qui se présente comme un service entrant. Toutefois, un service passerelle est également mappé à une destination de service sur laquelle un service cible (service interne ou service Web fourni par des tiers) est disponible. Une demande de client est reçue par un écouteur de noeud final, puis transmise via un port entrante au service passerelle. Le service cible correspond à un service interne disponible directement sur la destination ou à un service externe disponible sur la destination via un ou plusieurs ports sortants. Vous pouvez également appliquer des gestionnaires JAX-RPC et des liaisons WS-Security sur les ports.

Figure 1. Mappage d'un service entrant à un service cible par le service passerelleCette figure est décrite dans le texte.

Un service de passerelle correspond à l'interface Web d'un service (service cible) sous-jacent. Le service de passerelle est accessible au service cible à un emplacement différent, de sorte que vous pouvez remplacer ou déplacer le service cible sans modifier les détails du service de passerelle associé. Chaque service de passerelle peut également avoir plusieurs services cible (plusieurs implémentations du même service logique). Pour plus d'informations, voir Services cible et services de passerelle.

Le service cible peut être un service Web fourni en externe ou un service disponible en interne pour votre organisation ; il peut se trouver sur une destination dans un bus autre que celui du service de passerelle. Si le service cible correspond à un service interne, le nouveau service passerelle est toujours créé en fonction du WSDL modèle du service et de la destination de bus où il est disponible. S'il s'agit d'un service Web fourni en externe, le nouveau service passerelle est généralement créé en fonction du document WSDL publié en externe pour le service et sur une nouvelle destination de bus. Cependant, si la cible correspond à un service Web fourni en externe déjà disponible sur une destination de bus (car elle a déjà été configurée comme service de communications sortantes, par exemple), vous devez fournir les détails de la destination dans la procédure de création du service passerelle. Sinon, le même service Web externe devient disponible sur deux destinations différentes.

Vous pouvez également contrôler et surveiller les accès à vos services de passerelle de la manière suivante :
  • Vous pouvez contrôler les groupes d'utilisateurs qui peuvent accéder à un service passerelle en rendant ce service accessible uniquement via une instance de passerelle.
  • Vous pouvez associer des listes de gestionnaires JAX-RPC à des ports, pour que les gestionnaires puissent surveiller l'activité au niveau d'un port et prendre les mesures appropriées selon l'émetteur et le contenu des messages qui transitent par ce port.
  • Vous pouvez définir le niveau de sécurité à appliquer aux messages (liaison WS-Security). Les niveaux de sécurité peuvent être définis indépendamment pour les messages de demandes et de réponses.

Lorsque vous créez un service de passerelle, vous configurez un service cible comme service Web qui semble être fourni par la passerelle. Une fois que vous avez créé votre service passerelle, vous pouvez ajouter plusieurs services cible (davantage d'implémentations du même service logique) en modifiant la configuration de service passerelle existante.

Pour créer un service de passerelle à l'aide de la console d'administration, effectuez les étapes ci-après. Pour plus d'informations sur les propriétés du nouveau service passerelle, voir Paramètres des services de passerelle.

Procédure

  1. Démarrez la console d'administration.
  2. Dans le panneau de navigation, cliquez sur Intégration des services -> Bus -> nom_bus -> [Propriétés supplémentaires] Instances de la passerelle de services Web -> nom_instance -> Services passerelle Le formulaire de collecte des services de passerelle est affiché.
  3. Cliquez sur Nouveau. Une fenêtre s'affiche dans laquelle vous pouvez sélectionner le premier service cible de votre nouveau service passerelle.
  4. Choisissez l'une des deux méthodes disponibles pour créer votre service passerelle (via un fournisseur de services Web défini par fichier WSDL ou une destination de services), puis cliquez sur Suivant.
    Remarque : Si le service cible correspond à un service interne ou un service Web fourni en externe déjà disponible sur une destination, sélectionnez Destination de services. Si le service cible correspond à un service Web fourni en externe qui n'est pas déjà disponible dans une destination de bus, sélectionnez Fournisseur de services Web défini par WSDL ; le service cible est configuré dans une nouvelle destination.
    L'assistant Nouveau service passerelle est affiché pour la méthode de création de service que vous avez sélectionnée.
  5. Facultatif : Si vous avez sélectionné Fournisseur de services Web défini par WSDL, procédez comme suit :
    1. Spécifiez le nom du service passerelle, les destinations du service passerelle et les médiations.
      Remarque :
      • Choisissez un nom de service passerelle qui n'existe pas déjà sur les services de passerelle et proxy de l'instance de passerelle actuelle. Si vous entrez un nom existant, un message d'erreur est affiché.
      • Vous n'avez pas besoin de fournir les noms des destinations de passerelle. Si vous ne renseignez pas l'une de ces zones, un nom par défaut est généré une fois que l'assistant à terminer son travail. Les noms par défaut ne sont pas affichés dans le panneau. Ils sont créés de la manière suivante :
        • Le nom de la destination des demandes correspond au nom du service passerelle. Par exemple : monServicePasserelle.
        • Le nom de la destination des réponses correspond au nom de la destination des demandes, suivi de "Réponse". Par exemple : monServicePasserelleRéponse.
      • Les listes des médiations disponibles contiennent toutes les médiations actuellement déployées sur ce bus d'intégration de services. Si vous avez créé une médiation et que vous l'avez déployée sur le bus, elle peut être sélectionnée dans ces deux listes. Si vous ne voulez pas utiliser de médiation avec ce service passerelle, sélectionnez aucune dans l'une des listes de sélection.
      • Les membre de bus sont des serveurs d'applications ou des clusters qui sont ajoutés à ce bus. Les propriétés Membre du bus de médiation des demandes et Membre du bus de médiation des réponses définissent les membres de bus auxquels la médiation correspondante est affectée. Si vous remplacez la valeur des propriétés Médiation de demande ou Médiation de réponse par (aucune), vous devez également remplacer la valeur de la propriété du membre de bus correspondant par (aucune). Si vous voulez utiliser une médiation, affectez-la à un membre de bus. Si vous ne le faites pas, la console d'administration affiche un message d'erreur.
    2. Recherchez le fichier WSDL du service cible.
    3. Sélectionnez le service dans le WSDL.
      Remarque :
      • Cette option est nécessaire si le WSDL contient plusieurs services. La zone est renseignée automatiquement par défaut. Si le WSDL ne contient qu'un service, acceptez la valeur par défaut.
      • Au moins un port doit être défini dans le service que vous sélectionnez.
    4. Sélectionnez les ports qui doivent être activés pour ce service.
      Remarque :
      • La liste des ports disponibles correspond à l'ensemble des ports décrits dans le fichier WSDL.
      • Sélectionnez au moins un port.
    5. Nommez le service de communications sortantes, la destination du service et toutes les destinations de port.
      Remarque :
      • Des noms par défaut sont générés, mais vous pouvez les renommer. Les noms par défaut sont uniques dans le bus d'intégration de services actuel. Les noms de remplacement que vous choisissez doivent eux aussi être uniques. Si vous entrez un nom existant, un message d'erreur est affiché.
      • Si vous avez créé une médiation de sélection de port et l'avez déployée sur le bus, elle peut être sélectionnée dans la liste des médiations. Si vous ne voulez pas utiliser de médiation de sélection de port avec ce service passerelle, sélectionnez aucune dans la liste déroulante. Cette liste contient toutes les médiations, y compris les médiations de sélection de port, actuellement déployées sur ce bus d'intégration de services.
      • La liste des ports disponibles correspond à sous-ensemble des ports décrits dans le fichier WSDL. Vous avez choisi ce sous-ensemble à l'étape précédente.
    6. Affectez chaque destination de port et (éventuellement) la médiation de sélection de port à un membre de bus.
      Remarque :
      • L'option d'affectation d'une médiation de sélection de port à un membre de bus n'est affichée que si vous avez sélectionné une médiation à l'étape précédente.
    7. Sélectionnez des modules d'écoute de noeud final pour la configuration des communications entrantes de ce service passerelle.
    8. Définissez les éventuelles propriétés de publication UDDI.
      Remarque : Indiquez les propriétés de publication UDDI permettant de publier ce service passerelle 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.
  6. Facultatif : Si vous avez sélectionné Destination de services, procédez comme suit :
    1. Spécifiez le nom du service passerelle, les destinations du service passerelle et du service cible et les médiations.
      Remarque :
      • Choisissez un nom de service passerelle qui n'existe pas déjà sur les services de passerelle et proxy de l'instance de passerelle actuelle. Si vous entrez un nom existant, un message d'erreur est affiché.
      • Le service cible ne doit pas obligatoirement être disponible sur le même bus que le service passerelle, indiquez donc le bus et la destination de service de bus associée au niveau duquel le service cible est disponible.
      • La zone Nom de bus cible répertorie tous les bus disponibles. La zone Nom de destination cible répertorie toutes les destinations disponibles. Lorsque vous choisissez un bus et une destination associée, cette dernière doit se trouver sur le bus sélectionné. Si vous ne le faites pas, la console d'administration affiche un message d'erreur.
      • Vous n'avez pas besoin de fournir les noms des destinations de passerelle. Si vous ne renseignez pas l'une de ces zones, un nom par défaut est généré une fois que l'assistant à terminer son travail. Les noms par défaut ne sont pas affichés dans le panneau. Ils sont créés de la manière suivante :
        • Le nom de la destination des demandes correspond au nom du service passerelle. Par exemple : monServicePasserelle.
        • Le nom de la destination des réponses correspond au nom de la destination des demandes, suivi de "Réponse". Par exemple : monServicePasserelleRéponse.
      • Les listes des médiations disponibles contiennent toutes les médiations actuellement déployées sur ce bus. Si vous avez créé une médiation et que vous l'avez déployée sur le bus, elle peut être sélectionnée dans ces deux listes. Si vous ne voulez pas utiliser de médiation avec ce service passerelle, sélectionnez aucune dans l'une des listes de sélection.
      • Les propriétés Membre du bus de médiation des demandes et Membre du bus de médiation des réponses définissent les membres de bus auxquels la médiation correspondante est affectée. Si vous remplacez la valeur des propriétés Médiation de demande ou Médiation de réponse par (aucune), vous devez également remplacer la valeur de la propriété du membre de bus correspondant par (aucune). Pour utiliser une médiation, attribuez-la à un membre de bus. Si vous ne le faites pas, la console d'administration affiche un message d'erreur.
    2. Sélectionnez l'emplacement WSDL.
      Remarque : Pour un service interne, le WSDL modèle correspond au fichier WSDL spécifique au service, qui décrit le service directement disponible sur une destination de services.
    3. Sélectionnez le service dans le WSDL.
      Remarque :
      • Cette option est nécessaire si le WSDL contient plusieurs services. La zone est renseignée automatiquement par défaut. Si le WSDL ne contient qu'un service, acceptez la valeur par défaut.
      • Au moins un port doit être défini dans le service que vous sélectionnez.
    4. Sélectionnez des modules d'écoute de noeud final pour la configuration des communications entrantes de ce service passerelle.
    5. Définissez les éventuelles propriétés de publication UDDI.
      Remarque : Spécifiez les propriétés de publication UDDI permettant de publier ce service de communications entrantes 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.
    6. Si le service cible correspond à un service Web externe, l'option Activation de services Web sortants est disponible dans la section des propriétés supplémentaires. Cliquez sur cette option pour modifier la configuration du service de communications sortantes de ce service cible. Pour plus d'informations, voir Modification d'une configuration de service sortant existant.
  7. Cliquez sur Terminer.

Résultats

Si le traitement se déroule correctement, la liste des services de passerelle de cette instance de passerelle est mise à jour pour inclure le nouveau service passerelle. Sinon, un message d'erreur s'affiche.

Que faire ensuite

Pour modifier votre nouveau service passerelle ou ajouter des services cible supplémentaires (des implémentations supplémentaires du même service logique) à votre service passerelle, voir Modification d'une configuration de service passerelle existante. Pour définir le niveau de sécurité à appliquer aux messages (liaison WS-Security), voir Configuration de la transmission sécurisée de messages SOAP à l'aide de WS-Security.

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