Partager via

Configuration d'un port d'envoi SOAP

  • Article

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

Guide pratique pour 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é ITransportInfo qui a la propriété de lecture/écriture TransportTypeData. Cette propriété accepte le jeu de propriétés de configuration du port d'envoi SOAP sous la forme d'une chaîne XML composée d'une paire nom/valeur. Notez que pour définir cette propriété dans le modèle objet 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 obligatoire. Si elle n'est pas définie, 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 de l'Explorateur BizTalk pour les ports d'envoi SOAP.

Nom de la propriété Type Description
URI String Répertoire virtuel contenant le service Web sur le serveur de déploiement.
Nom d’utilisateur String Nom d'utilisateur à spécifier pour accéder au service Web cible.

Valeur par défaut : vide
Mot de passe String Mot de passe de l'utilisateur utilisé pour l'authentification sur le serveur.

Valeur par défaut : vide
ClientCertificate String Empreinte numérique du certificat SSL client.

Valeur par défaut : vide
AffiliateApplicationName String Nom de l'application SSO à utiliser pour échanger le ticket et récupérer les informations d'identification du client.

AffiliateApplicationName s’exclue mutuellement d’une paire Nom d’utilisateur et Mot de passe.

Valeur par défaut : vide
UseProxy Boolean Indiquez si le port d'envoi SOAP fait appel ou non à 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 String Adresse du proxy HTTP à utiliser pour l'appel de service Web.

Valeur par défaut : vide
ProxyPort Integer Port du proxy HTTP à utiliser pour l'appel de service Web.

Valeur par défaut : vide
ProxyUsername String Nom d'utilisateur à utiliser pour le proxy.

Valeur par défaut : vide
ProxyPassword String Mot de passe à utiliser pour le proxy.

Valeur par défaut : vide

Le code suivant illustre 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>

Configuration d'un port d'envoi SOAP à l'aide de la console Administration de BizTalk Server

Vous pouvez définir des variables d’adaptateur de port d’envoi SOAP dans la console Administration 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 d’administration BizTalk Server sont utilisées.

Pour configurer les variables d'un port d'envoi SOAP

  1. Dans la console Administration 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 Création d’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 :

    Propriété Pour
    Web Service URL Spécifiez l'adresse du service Web à 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.
    - Base. La connexion SOAP envoie le nom d’utilisateur et le mot de passe en texte brut.
    - Digérer. 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.
    Informations d'identification Indiquez le type d'informations d'identification à utiliser.

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

    Options :

    - Ne pas utiliser l’authentification unique
    Nom d'utilisateur
    Nom d'utilisateur utilisé pour l'authentification sur le serveur de destination. Si la propriété Type d’authentification est Anonyme ou NTLM, cette option est désactivée. Cette propriété nécessite une valeur si l’option De base ou Digest est sélectionnée et si l'Sign-On unique d’entreprise n’est pas utilisée.
    Longueur minimale : 0
    Longueur maximale : 256
    Mot de passe
    Mot de passe utilisé pour l'authentification sur le serveur de destination. Si la propriété Type d’authentification est Anonyme ou NTLM, cette option est désactivée. Cette propriété nécessite une valeur si l’option De base ou Digest est sélectionnée et que l'Sign-On unique n’est pas utilisé.
    Longueur minimale : 0
    Longueur maximale : 256
    - Utiliser l’authentification unique
    Indiquez si l'authentification unique est utilisée pour l'extraction des informations d'identification d'un client en vue d'une authentification auprès du serveur de destination.
    Application associée
    Indiquez une application associée à utiliser pour l'authentification unique. Pour plus d’informations sur le remplissage de cette liste, consultez Applications affiliées de l’authentification unique.
    Longueur minimale : 0
    Longueur maximale : 256
    Empreinte de certificat du client Indiquez l'empreinte de certificat du 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 :

    Propriété Pour
    Utiliser la configuration de proxy par défaut du gestionnaire Spécifiez la configuration du gestionnaire de proxy du port d'envoi. Si la propriété est définie sur True, le port utilisera les paramètres de proxy spécifiés au niveau du gestionnaire. Si elle est définie sur False, l'adaptateur d'envoi utilisera les informations de proxy spécifiées sur le port d'envoi.

    Le paramètre par défaut est true.
    Ne pas utiliser le proxy Indiquer si le gestionnaire d'envoi SOAP fait appel ou non à un serveur proxy.
    Utiliser le proxy Indiquer si le gestionnaire d'envoi SOAP fait appel ou non à 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 une valeur uniquement si l’option Utiliser le proxy est sélectionnée.

    Tapez : String

    Longueur minimale : 0

    Longueur maximale : 256
    Port Indiquer le port que le gestionnaire d'envoi SOAP utilise.

    Cette propriété nécessite une valeur uniquement 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 0 indique l’utilisation de la valeur par défaut, qui est le port 80.
    Nom d'utilisateur Indiquer le nom d’utilisateur nécessaire à 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 domain\.

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

    Tapez : String

    Longueur minimale : 0

    Longueur maximale : 256
    Mot de passe Indiquer le mot de passe nécessaire à l’authentification.

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

    Tapez : String

    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 :

    Propriété Pour
    Port Web d'orchestration Spécifiez d’utiliser le service Web qui est 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 Indiquez le nom de l'assembly contenant le proxy du service Web. Cliquez sur le bouton Parcourir pour localiser un assembly. Sélectionnez l'assembly pour faire apparaître son nom complet dans ce champ. Note: L’assembly spécifié doit être présent sur tous les serveurs BizTalk server au moment de l’exécution.
    Nom du type Indiquez le nom de la classe contenant la méthode Web à appeler. Celui-ci peut être sélectionné dans une liste des types contenue 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 vous choisissez la deuxième option, la méthode Web doit être définie par d'autres moyens, tels qu'un composant de pipeline. Dans ce scénario, la méthode web doit être écrite dans la propriété de contexte Soap Adapter MethodName .
    SOAP 1.2 Indiquez qu'il faut générer un code proxy qui prendra en charge le protocole SOAP 1.2. Si cette option n'est pas sélectionnée, le code proxy compatible SOAP 1.1 sera généré.

    Valeur par défaut : effacée

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

Voir aussi

Publication de services web