Partager via

Configuration d'un port d'envoi HTTP

  • Article

Vous pouvez configurer un port d'envoi HTTP par programme ou à l'aide de la console Administration de BizTalk Server.

Configurer un port d’envoi HTTP par programmation

L'adaptateur HTTP stocke ses informations de configuration dans la base de données de gestion BizTalk (également appelée « base de données de configuration »). Les informations de configuration sont stockées dans un jeu de propriétés XML personnalisé. Lors de l'initialisation et de l'exécution de l'adaptateur HTTP, le serveur transmet la configuration à l'adaptateur comme suit :

  • Pour le gestionnaire d’envoi HTTP, les informations de configuration passent à l’adaptateur en appelant la méthode Load de l’interface IPersistPropertyBag .

  • Pour les ports d'envoi HTTP, les informations de configuration sont transmises à l'adaptateur sous la forme d'un jeu de propriétés dans un contexte de message. L'espace de noms HTTP regroupe ces propriétés.

    Le modèle objet bizTalk Explorer expose l’interface de configuration de l’adaptateur ItransportInfo pour les ports d’envoi, qui contient la TransportTypeData propriété en lecture/écriture. Cette propriété accepte le jeu de propriétés de configuration du port d'envoi HTTP 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, elle doit d’abord être définie sur la Address propriété de l’interface ITransportInfo.

    La définition de la propriété TransportTypeData de l’interface ITransportInfo n’est pas nécessaire. Si elle n'est pas définie, l'adaptateur HTTP utilise les valeurs par défaut pour le gestionnaire d'envoi HTTP.

    Si les propriétés de configuration du port d'envoi qui dupliquent la configuration du gestionnaire ne sont pas définies, les propriétés de configuration pour le gestionnaire sont utilisées. Si le gestionnaire d'envoi HTTP ne dispose pas de valeurs de configuration, l'adaptateur d'envoi HTTP consigne une erreur dans le journal des événements et déplace le message vers l'adaptateur de secours.

    Vous pouvez définir les propriétés de configuration par programme dans un contexte de message. Vous pouvez définir ces propriétés dans une planification d'orchestration BizTalk Server ou dans des composants de pipeline personnalisés. Les règles suivantes s'appliquent dans le cadre de l'utilisation de ces propriétés :

  • Si la propriété de configuration est définie sur une orchestration ou un composant de pipeline personnalisé dans un pipeline de réception, alors :

    • Si un message est envoyé à un port d'envoi statique, la valeur de la propriété est remplacée par la valeur configurée pour ce port d'envoi.

    • Si un message est envoyé à un port d'envoi dynamique, la valeur de la propriété n'est pas remplacée.

  • Si la propriété de configuration est définie dans un composant de pipeline personnalisé dans un pipeline d'envoi, alors :

    • La valeur n'est pas remplacée, que le message soit envoyé à un port d'envoi statique ou dynamique.

    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 l'emplacement d'envoi HTTP.

Nom de la propriété Type Description Restrictions Commentaires
RequestTimeout xs:int Délai d'attente d'une réponse du serveur. Si la valeur définie est zéro (0), le système calcule le délai en fonction de la taille du message de requête. Valeur minimale : 0

Valeur maximale : MAX_LONG		 Valeur par défaut : 0
ContentType xs:string Type de contenu des messages de requête. Longueur minimale : 0

Longueur maximale : 256		 Valeur par défaut : Texte/XML
MaxRedirects xs:int Nombre maximal de fois que l'adaptateur HTTP peut rediriger la requête. Valeur minimale : 0

Valeur maximale : 10		 Valeur par défaut : 5
UseHandlerProxySettings xs:boolean Indique si le port d'envoi HTTP utilisera la configuration de proxy pour le gestionnaire d'envoi. None Valeur par défaut : Vrai

Si la propriété est définie sur True, le port d'envoi 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.
UseProxy xs:boolean Indique si l'adaptateur HTTP utilisera le serveur proxy. Le serveur proxy peut être partagé par tous les ports d'envoi HTTP. None Valeur par défaut : Faux

Cette propriété est ignorée si UseHandlerProxySettings a la valeur True.
ProxyName xs:string Indique le nom du serveur proxy. Longueur minimale : 0

Longueur maximale : 256		 Valeur par défaut : Vide

L’adaptateur d’envoi HTTP ignore cette propriété si la propriété UseHandlerProxySettings a la valeur True. Sinon, l’adaptateur d’envoi HTTP utilise cette propriété uniquement si UseProxy a la valeur True. Cette propriété est obligatoire si UseProxy a la valeur True.
ProxyPort xs:int Spécifie le port du serveur proxy. Valeur minimale : 0

Valeur maximale : 65535		 Valeur par défaut : 80

L’adaptateur d’envoi HTTP ignore cette propriété si UseHandlerProxySettings a la valeur True. Sinon, l’adaptateur d’envoi HTTP utilise cette propriété uniquement si UseProxy a la valeur True. Cette propriété est obligatoire si UseProxy a la valeur True.
ProxyUsername xs:string Indique le nom d'utilisateur utilisé pour l'authentification sur le serveur proxy. Longueur minimale : 0

Longueur maximale : 256		 Valeur par défaut : vide

L’adaptateur d’envoi HTTP ignore cette propriété si UseHandlerProxySettings a la valeur True. Sinon, l’adaptateur d’envoi HTTP utilise cette propriété uniquement si UseProxy a la valeur True.
ProxyPassword xs:string Indique le mot de passe utilisé pour l'authentification sur le serveur proxy. Longueur minimale : 0

Longueur maximale : 256		 Valeur par défaut : vide

L’adaptateur d’envoi HTTP ignore cette propriété si UseHandlerProxySettings a la valeur True. Sinon, l’adaptateur d’envoi HTTP utilise cette propriété uniquement si UseProxy a la valeur True.
AuthenticationScheme xs:string Type d'authentification à utiliser avec le serveur de destination. None Valeurs valides :

- Anonyme (par défaut)
- Base
- Digérer
- Kerberos
Nom d’utilisateur xs:string Nom d'utilisateur utilisé pour l'authentification sur le serveur. Longueur minimale : 0

Longueur maximale : 256		 Valeur par défaut : Vide

Cette valeur est requise si vous sélectionnez Authentification de base ou Digest . L’adaptateur HTTP ignore la valeur de cette propriété si UseSSO a la valeur True.
Mot de passe xs:string Mot de passe de l'utilisateur utilisé pour l'authentification sur le serveur. Longueur minimale : 0

Longueur maximale : 256		 Valeur par défaut : vide

Cette valeur est requise si vous sélectionnez Authentification de base ou Digest . La valeur de cette propriété est ignorée si UseSSO a la valeur True.
EnableChunkedEncoding xs:boolean Spécifie si le codage mémorisé en bloc est utilisé ou non par l'adaptateur HTTP None Valeur par défaut :

True
Certificate xs:string Empreinte du certificat SSL client. Longueur minimale : 0

Longueur maximale : 59		 Valeur par défaut : Vide
UseSSO xs:boolean Spécifie si l'authentification unique sera utilisée pour le port d'envoi. None Valeur par défaut : Faux
AffiliateApplicationName xs:string Nom de l’application affiliée à utiliser pour l’authentification unique. Longueur minimale : 0

Longueur maximale : 256		 Valeur par défaut : vide

Obligatoire si UseSSO a la valeur True.

Le code suivant illustre la chaîne XML à utiliser pour définir ces propriétés :

<CustomProps>  
   <ContentType vt="8">text/xml</ContentType>  
   <RequestTimeout vt="3">0</RequestTimeout>  
   <MaxRedirects vt="3">5</MaxRedirects>  
   <UseHandlerProxySettings vt="8">-1</UseHandlerProxySettings>  
   <UseProxy vt="8">-1</UseProxy>  
   <ProxyName vt="8">sdfsd</ProxyName>  
   <ProxyPort vt="3">80</ProxyPort>  
   <ProxyUsername vt="8">Somename</ProxyUsername>  
   <ProxyPassword vt="8">Somepassword</ProxyPassword>  
   <AuthenticationScheme vt="8">Basic</AuthenticationScheme>  
   <Username vt="8">Somename</Username>  
   <Password vt="8">Somepassword</Password>  
   <EnableChunkedEncoding vt="11">1</EnableChunkedEncoding>  
   <Certificate vt="8">AAAA BBBB CCCC DDDD</Certificate>  
   <UseSSO vt="11">0</UseSSO>  
   <AffiliateApplicationName vt="8">Name</AffiliateApplicationName>  
</CustomProps>

Configurer un port d’envoi HTTP avec la console d’administration BizTalk Server

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

Notes

Les propriétés de configuration décrites dans cette rubrique sont communes aux ports d'envoi HTTP unidirectionnels et de requête-réponse.

  1. Dans la console d’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 Comment créer un port d’envoi. Configurez toutes les options de port d’envoi et spécifiez HTTP 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 , cliquez sur le bouton Configurer en regard de Type.

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

    Propriété Pour
    URL de destination Obligatoire. Indiquez l'adresse à laquelle envoyer les requêtes HTTP. Incluez les chaînes de requête ajoutées à l'URL de base.

    Type: String

    Longueur maximale : 256

    Pour plus d’informations, consultez Restrictions sur la propriété d’URL de destination. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.
    Activer le codage mémorisé en bloc Indiquez qu'il faut utiliser le codage mémorisé en bloc. Si cette option est activée, l'adaptateur HTTP utilise le codage mémorisé en bloc HTTP avec une taille de bloc maximale de 8 Ko. L’encodage segmenté est implicitement désactivé si le gestionnaire d’envoi HTTP est configuré pour Utiliser le proxy.

    Type: Boolean

    Valeur par défaut : Vrai
    Délai d'expiration de la requête (s) Indiquez le délai d'expiration (en secondes) pour la transmission HTTP/HTTPS. Si l'adaptateur HTTP ne reçoit pas la réponse dans ce délai, le service consigne l'erreur et soumet à nouveau le message en se basant sur la procédure de nouvelle tentative.

    Si le délai est paramétré sur zéro (0), le moteur de messagerie BizTalk calcule le délai en fonction de la taille du message de requête. Si vous n'indiquez pas de valeur, le système utilise celle du gestionnaire.

    Type: Long

    Valeur minimale : 0

    Valeur maximale : MAX_LONG
    Nb maximal de redirections Indiquez le nombre maximal de redirections autorisé pour le message envoyé.

    Valeur par défaut : 5

    Type: Int

    Valeur minimale : 0

    Valeur maximale : 10
    Type de contenu Indiquez le type de contenu des messages de requête.

    Lorsqu'aucune valeur n'est entrée, celle du gestionnaire est utilisée.

    Type: String

    Longueur minimale : 0

    Longueur maximale : 256

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

    Propriété Pour
    Utiliser la configuration de proxy par défaut du gestionnaire Indiquez que la configuration du port d'envoi doit utiliser les paramètres de proxy spécifiés pour le gestionnaire d'envoi HTTP.

    Il s'agit du paramètre par défaut.
    Ne pas utiliser le proxy Indiquez si le gestionnaire d'envoi HTTP fait appel ou non au serveur proxy.

    Si cette option est sélectionnée, le gestionnaire d'envoi HTTP pour ce port d'envoi ne fait pas appel au serveur proxy.
    Utiliser le proxy Indiquez si le gestionnaire d'envoi HTTP fait appel ou non au serveur proxy.

    Si cette option est sélectionnée, le gestionnaire d'envoi HTTP fait appel au serveur proxy.
    Serveur Indiquer l'adresse du serveur proxy pour ce port d'envoi.

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

    Type: String

    Longueur minimale : 0

    Longueur maximale : 256
    Port Indiquer le port du serveur proxy pour ce port d'envoi.

    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
    Nom d'utilisateur Indiquer le nom d'utilisateur utilisé pour l'authentification sur le serveur proxy.

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

    Type: String

    Longueur minimale : 0

    Longueur maximale : 256
    Mot de passe Indiquer le mot de passe utilisé pour l'authentification sur le serveur proxy.

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

    Type: String

    Longueur minimale : 0

    Longueur maximale : 256

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

    Propriété Pour
    Type d'authentification Indiquez le type d'authentification à utiliser avec le serveur de destination.

    Les options valides sont les suivantes :

    - Anonyme
    - Base
    - Digérer
    - Kerberos

    Valeur par défaut : Anonyme
    Informations d'identification Indiquez le type d'informations d'identification à utiliser.

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

    Les options valides sont les suivantes :

    - 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 Kerberos, 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 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 Kerberos, 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ée.
    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.
    Vous choisissez les applications que vous souhaitez inclure dans l'authentification unique.
    Longueur minimale : 0
    Longueur maximale : 256
    Empreinte de certificat du client SSL Indiquez l'empreinte de certificat du client à utiliser pour établir une connexion SSL (Secure Sockets Layer).

    Longueur minimale : 0

    Longueur maximale : 59

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

Voir aussi

Configuration d’un port d’envoi HTTP