Créez un service de
communications sortantes. Un service sortant permet d'accéder, via un ou
plusieurs ports sortants, à un service Web hébergé en externe. Il peut être utilisé par n'importe lequel de vos
systèmes internes qui peut accéder au bus d'intégration de services sur lequel il
est hébergé. Pour
rendre un service hébergé en externe disponible via un bus, vous devez
d'abord l'associer à une destination de services, puis configurer une
ou plusieurs destinations de port (une pour chaque type de liaison, par
exemple, SOAP sur HTTP ou SOAP sur JMS) qui permettent de transmettre
des demandes et des réponses au service externe. Vous obtenez les définitions de port du document WSDL, mais vous pouvez choisir
celles à créer.
Avant de commencer
Cette rubrique suppose que vous avez créé et installé un référentiel SDO (Service Data Objects) (utilisé pour trier et fournir les définitions WSDL) sur chaque serveur autonome ou cluster qui doit exécuter un rôle de services Web de bus d'intégration de services.
Pour créer un service sortant, vous devez connaître
l'emplacement du fichier WSDL publié en externe qui décrit le service. Ce fichier WSDL est
disponible à une adresse Web ou via un registre UDDI.
Si le fichier WSDL de votre service de communications sortantes
est stocké dans un registre UDDI, associez-le à l'aide d'une référence UDDI
au registre. Comme vous sélectionnez la référence UDDI
dans une liste déroulante, vous devez la configurer avant de configurer un
nouveau service sortant qui l'utilise.
Déterminez la méthode à utiliser pour configurer ces ressources. Vous pouvez créer
un service sortant à l'aide de la console d'administration, comme décrit dans
cette tâche, ou à l'aide de la
Commande createSIBWSOutboundService.
Remarque : Si le bus doit transmettre des messages via un serveur proxy d'authentification
pour extraire des documents WSDL, vous ne pouvez pas utiliser la console
d'administration pour cette tâche et devez créer votre service sortant à l'aide
de l'outil wsadmin. Pour plus d'informations, voir
le conseil d'identification et de résolution de l'incident
correspondant.
Pourquoi et quand exécuter cette tâche
Dans la figure suivante, chaque message est envoyé du service sortant au service cible via un port sortant. Une port sortant distinct est créé pour chaque liaison disponible. Les gestionnaires JAX-RPC et les paramètres WS-Security peuvent être appliqués aux ports.
Figure 1. Service sortant
Les demandes et les réponses transmises à un service de
communications sortantes sont envoyées via n'importe quelle liaison de transport (par
exemple, SOAP sur HTTP, SOAP sur JMS, liaison d'EJB) , à condition qu'elle soit
accessible par le service cible et le bus d'intégration de services. Chaque type de
liaison disponible est représenté par un port de communications sortantes configuré sur une destination de port. Pour plus d'informations, voir Ports de communications sortantes et destinations de port.
Vous pouvez contrôler et surveiller les accès au service cible de la
manière suivante :
- 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.
Procédure
- Démarrez la console d'administration.
- Dans le panneau de navigation, cliquez sur
Le formulaire de collecte
des services de communications sortantes est affiché.
- Cliquez sur Nouveau. L'assistant
Nouveau service de communications sortantes est affiché.
- A l'aide de l'assistant, créez une configuration de service de
communications sortantes en effectuant la procédure ci-après. Pour plus
d'informations sur les propriétés définies à l'aide de
l'assistant, voir Paramètres
des services sortants et Paramètres des ports de communications sortantes.
- Recherchez le fichier WSDL du service cible.
- 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.
- Sélectionnez les ports qui doivent être activés pour ce service.
Remarque : Sélectionnez au moins un port.
- 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
d'intégration de services, 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 sortant, 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. Si vous avez
sélectionné plusieurs ports à l'étape précédente, vous devez également définir le port
par défaut à utiliser si aucun autre port n'est spécifié par une
médiation de sélection de port.
- Affectez chaque destination de port et (éventuellement) la médiation
de sélection de port à un membre de bus.
Remarque : - Les membres de bus sont des serveurs d'applications ou des clusters qui sont ajoutés à ce bus.
- 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.
- Cliquez sur Finish.
Résultats
Si le traitement se déroule correctement, la liste des services de communications
sortantes de ce bus d'intégration de services est mise à jour pour inclure le nouveau
service de communications sortantes. Sinon, un message d'erreur
s'affiche.
Que faire ensuite
Dans la mesure où le service est hébergé de façon externe, vous devrez
peut-être activer l'authentification du serveur proxy de chaque port pour obtenir la
permission d'accéder à Internet.
Pour sécuriser votre nouveau service de
communications sortantes, appliquer une liste de gestionnaires JAX-RPC aux ports ou activer l'authentification
du serveur proxy pour un port, modifiez votre configuration de service de communications sortantes à l'aide de la console d'administration.