Partager via

Guide pratique pour configurer un port d’envoi SOAP

Vous pouvez configurer un port d’envoi SOAP par programmation ou à l’aide de la console Administration de BizTalk Server.

Comment configurer un port d’envoi SOAP par programmation

Le modèle objet BizTalk Explorer expose une interface spécifique à l’adaptateur pour les ports d’envoi nommés ITransportInfo qui possède la propriété de lecture/écriture TransportTypeData . Cette propriété accepte un conteneur de propriétés de configuration de port d’envoi SOAP sous la forme d’une paire nom-valeur de chaînes XML. Notez que pour définir cette propriété dans le modèle objet De BizTalk Explorer, vous devez d’abord définir la propriété OutboundTransportLocation de l’interface ITransportInfo .

La propriété TransportTypeData de l’interface ITransportInfo n’est pas requise. S’il n’est pas défini, l’adaptateur utilise les valeurs par défaut pour la configuration du port d’envoi SOAP, comme indiqué dans le tableau suivant.

Le tableau suivant répertorie les propriétés de configuration que vous pouvez définir dans le modèle objet BizTalk Explorer pour les ports d’envoi SOAP.

Nom de la propriété Catégorie Descriptif
URI Chaîne Répertoire virtuel contenant le service Web sur le serveur de déploiement.
Nom d’utilisateur Chaîne Nom d’utilisateur à spécifier pour accéder au service Web cible.

Valeur par défaut : Vide
Mot de passe Chaîne Mot de passe utilisateur à utiliser pour l’authentification auprès du serveur.

Valeur par défaut : Vide
ClientCertificate Chaîne Empreinte numérique du certificat SSL client.

Valeur par défaut : Vide
AffiliateApplicationName Chaîne Nom de l'application SSO à utiliser pour obtenir le ticket avec les informations d'identification du client.

Le AffiliateApplicationName est mutuellement exclusif à une paire de nom d'utilisateur et mot de passe.

Valeur par défaut : Vide
UseProxy Booléen Indique si le port d’envoi SOAP utilise un serveur proxy pour accéder au service web cible. Le serveur proxy peut être partagé par tous les ports d’envoi SOAP.

Valeur par défaut : False
ProxyAddress Chaîne Adresse du proxy HTTP à utiliser pour l’appel de service web.

Valeur par défaut : Vide
ProxyPort Nombre entier Port du proxy HTTP à utiliser pour l’appel de service web.

Valeur par défaut : Vide
ProxyUsername Chaîne Nom d’utilisateur à utiliser pour le proxy.

Valeur par défaut : Vide
ProxyPassword Chaîne Mot de passe à utiliser pour le proxy.

Valeur par défaut : Vide

Le code suivant montre le format à utiliser pour définir ces propriétés :

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>

Comment configurer un port d’envoi SOAP avec la console d’administration BizTalk Server

Vous pouvez définir des variables d’adaptateur de port d’envoi SOAP dans la console Administration de BizTalk Server. Si les propriétés ne sont pas définies pour le port d’envoi, les valeurs de gestionnaire d’envoi par défaut définies dans la console Administration de BizTalk Server sont utilisées.

Pour configurer des variables pour un port d’envoi SOAP

  1. Dans la console Administration de BizTalk Server, créez un port d’envoi ou double-cliquez sur un port d’envoi existant pour le modifier. Pour plus d’informations, consultez Comment créer un port d’envoi. Configurez toutes les options de port d’envoi et spécifiez SOAP pour l’option Type dans la section Transport de l’onglet Général .

  2. Sous l’onglet Général , dans la section Transport en regard de Type, cliquez sur Configurer.

  3. Dans la boîte de dialogue Propriétés du transport SOAP , sous l’onglet Général , procédez comme suit :

    Utiliser cette option Pour ce faire
    Web Service URL Spécifiez l’adresse du service Web que vous souhaitez appeler. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.
    Authentification Indiquez la méthode d’authentification utilisée par le service Web que vous appelez.

    Options :

    - Anonyme. Paramètre par défaut.
    - Basique. La connexion SOAP envoie le nom d’utilisateur et le mot de passe en texte brut.
    - Digest. La connexion SOAP envoie le mot de passe dans un format chiffré.
    - NTLM . Ni le nom d’utilisateur ni le mot de passe ne sont envoyés via une connexion SOAP. L’adaptateur SOAP utilise toujours les informations d’identification du processus sous lequel l’adaptateur d’envoi SOAP s’exécute pour ce type d’authentification.
    Identifiants Spécifiez le type d’informations d’identification à utiliser.

    Disponible uniquement si le type d’authentification est De base ou Digest.

    Options :

    - N’utilisez pas l’authentification unique
    Nom d’utilisateur
    Nom d’utilisateur à utiliser pour l’authentification auprès du serveur de destination. Si la propriété de type d’authentification est Anonyme ou NTLM, cette option est désactivée. Cette propriété nécessite une valeur si Basic ou Digest est sélectionné, et enterprise Single Sign-On n’est pas utilisé.
    Longueur minimale : 0
    Longueur maximale : 256
    Mot de passe
    Mot de passe à utiliser pour l’authentification auprès du serveur de destination. Si la propriété de type d’authentification est Anonyme ou NTLM, cette option est désactivée. Cette propriété nécessite une valeur si Basic ou Digest est sélectionné et que l'Sign-On unique n’est pas utilisé.
    Longueur minimale : 0
    Longueur maximale : 256
    - Utiliser l’authentification unique
    Spécifiez s’il faut utiliser une Sign-On unique pour récupérer les informations d’identification du client pour l’authentification auprès du serveur de destination.
    Application d’affilié
    Spécifie l’application affiliée à utiliser pour l’authentification unique. Pour plus d’informations sur le remplissage de cette liste, consultez Applications affiliées pour SSO.
    Longueur minimale : 0
    Longueur maximale : 256
    Empreinte numérique du certificat client Spécifiez l’empreinte numérique du certificat client à utiliser pour établir une connexion.

    Exemple : 01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67

    Longueur minimale : 0

    Longueur maximale : 59

  4. Dans la boîte de dialogue Propriétés du transport SOAP , sous l’onglet Proxy , procédez comme suit :

    Utiliser cette option Pour ce faire
    Utiliser la configuration de proxy par défaut du gestionnaire Spécifiez la configuration du gestionnaire de proxy de port d’envoi. Lorsque la valeur est true, le port utilise les paramètres de proxy spécifiés au niveau du gestionnaire. Lorsque la valeur est false, l’adaptateur d’envoi utilise les informations du proxy spécifiées sur le port d’envoi.

    Le paramètre par défaut est true.
    Ne pas utiliser de proxy Indiquez si le gestionnaire d’envoi SOAP utilise un serveur proxy.
    Utiliser le proxy Indiquez si le gestionnaire d’envoi SOAP utilise un serveur proxy. Le serveur proxy peut être partagé par tous les ports d’envoi SOAP.
    Serveur Spécifie le nom du serveur proxy.

    Cette propriété nécessite uniquement une valeur si l’option Utiliser le proxy est sélectionnée.

    Type : Chaîne

    Longueur minimale : 0

    Longueur maximale : 256
    Port Spécifiez le port utilisé par le gestionnaire d’envoi SOAP.

    Cette propriété nécessite uniquement une valeur si l’option Utiliser le proxy est sélectionnée.

    Valeur par défaut : 80

    Type : Long

    Valeur minimale : 0

    Valeur maximale : 65535 Remarque : la spécification d’une valeur de 0 indique l’utilisation de la valeur par défaut, qui est le port 80.
    Nom d’utilisateur Spécifiez le nom d’utilisateur à utiliser pour l’authentification. Si vous utilisez l’authentification intégrée Windows, le nom d’utilisateur inclut le domaine, domaine\nom d’utilisateur. Si vous utilisez l’authentification de base ou Digest, le nom d'utilisateur n’inclut pas le domaine\.

    Cette propriété nécessite uniquement une valeur si l’option Utiliser le proxy est sélectionnée.

    Type : Chaîne

    Longueur minimale : 0

    Longueur maximale : 256
    Mot de passe Spécifiez le mot de passe à utiliser pour l’authentification.

    Cette propriété nécessite uniquement une valeur si l’option Utiliser le proxy est sélectionnée.

    Type : Chaîne

    Longueur minimale : 0

    Longueur maximale : 256

  5. Dans la boîte de dialogue Propriétés du transport SOAP , sous l’onglet Service web , procédez comme suit :

    Utiliser cette option Pour ce faire
    Port web d’orchestration Spécifiez d’utiliser le service Web exposé à l’URL du service web répertoriée sous l’onglet Général .

    Il s’agit du paramètre par défaut.
    Nom de l'assembly Spécifiez le nom de l’assembly contenant le proxy de service web. Ce champ peut être rempli en cliquant sur le bouton Parcourir pour rechercher un assembly. Après avoir sélectionné l'assemblage, cette zone est remplie avec le nom complet de l'assemblage. Note: L’assembly spécifié doit être présent sur tous les serveurs BizTalk au moment de l’exécution.
    Nom du type Spécifiez le nom de la classe qui contient la méthode Web à appeler. Cette option peut être sélectionnée dans une liste de types contenus dans l’assembly.
    Nom de la méthode Spécifiez l’une des méthodes dans la zone de liste ou choisissez l’option « Spécifier ultérieurement ». Si l’option « Spécifier ultérieurement » est choisie, la méthode Web doit être définie par d’autres moyens, comme un composant de pipeline. Dans ce scénario, la méthode web doit être écrite dans la propriété de contexte MethodName de l’adaptateur Soap.
    SOAP 1.2 Spécifiez pour générer du code proxy qui prendra en charge le protocole SOAP 1.2. Si cette option est désactivée, le code proxy compatible SOAP 1.1 est généré.

    Valeur par défaut : effacée

  6. Cliquez sur OK et OK à nouveau pour enregistrer les paramètres.

Voir aussi

Publication de services web