Configuration d'un emplacement de réception HTTP

Vous pouvez définir les variables d'un emplacement de réception HTTP par programme ou à l'aide de la console Administration de BizTalk Server. Si les propriétés ne sont pas définies pour l'emplacement de réception, les valeurs par défaut du gestionnaire de réception définies dans la console Administration de BizTalk Server sont utilisées.

Notes

Avant d'effectuer la procédure suivante, vous devez avoir ajouté un port de réception. Pour plus d’informations, consultez Comment créer un port de réception.

Configuration d'un emplacement de réception HTTP par programme

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 »). La configuration est stockée dans un jeu de propriétés XML personnalisé.

Le modèle objet BizTalk Explorer expose l’interface de configuration IReceiveLocation, qui a une propriété de lecture/écriture TransportTypeData. Cette propriété accepte le jeu de propriétés de configuration de l'emplacement de réception HTTP dans une chaîne XML composée d'une paire nom/valeur.

La définition de la propriété TransportTypeData de L’IReceiveLocation n’est pas obligatoire. Si elle n'est pas définie, les valeurs par défaut de configuration de l'emplacement de réception HTTP sont utilisées. Le tableau suivant répertorie les valeurs par défaut et les propriétés de configuration que vous pouvez définir dans le modèle objet de l'Explorateur BizTalk pour l'emplacement de réception HTTP.

Nom de la propriété	Type	Description	Restrictions	Commentaires
ResponseContentType	string	Type de contenu des messages de réponse HTTP que l'adaptateur HTTP renvoie aux clients à partir de cet emplacement de réception. Cette propriété n'est valide que pour les ports de réception de requête-réponse ; elle est ignorée pour des ports de réception unidirectionnels.	String Longueur minimale : 0 Longueur maximale : 256	Valeur par défaut : Texte/XML
Bouclage	Boolean	Indique que le message de requête reçu à cet emplacement est acheminé vers un port d'envoi ou renvoyé à cet emplacement de réception en tant que réponse. Cette propriété n'est valide que pour les ports de réception de requête-réponse ; elle est ignorée pour des ports de réception unidirectionnels.	None	Valeur par défaut : Faux
ReturnCorrelationHandle	Boolean	Indique si, en cas de succès de l'envoi, l'adaptateur HTTP envoie au client le jeton de corrélation du message envoyé dans la réponse HTTP. Cette propriété n'est valide que pour les ports de réception unidirectionnels ; elle est ignorée pour des ports de réception de requête-réponse.	None	Valeur par défaut : Vrai
SuspendFailedRequests	Boolean	Indique s'il faut interrompre les requêtes HTTP ayant échoué. La valeur True indique de suspendre la demande ayant échoué et d’envoyer un code status « Accepté » (202) au client pour les ports de réception unidirectionnel ou un code status « Erreur » (500) au client pour les ports de réception bidirectionnel.	None	Valeur par défaut : Faux
UseSSO	Boolean	Spécifie si l'adaptateur HTTP émet le ticket d'authentification unique pour les messages arrivant sur cet emplacement de réception.	None	Valeur par défaut : Faux

Le format de la chaîne XML permettant de définir ces propriétés est le suivant :

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>  

Configuration d'un emplacement de réception HTTP à l'aide de la console Administration de BizTalk Server

La procédure suivante permet de configurer un emplacement de réception à l'aide de la console Administration de BizTalk Server.

Pour configurer les variables pour un emplacement de réception HTTP

1. Configurez les services Internet (IIS) de manière à ce qu'ils fonctionnent avec les emplacements de réception HTTP. Pour obtenir des instructions sur la configuration d’IIS, consultez Configuration d’IIS pour un emplacement de réception HTTP.

2. Dans la console Administration BizTalk Server, développez BizTalk ServerAdministration, BizTalk Group, Applications, puis l’application dans laquelle vous souhaitez créer un emplacement de réception.

3. Dans le volet gauche, cliquez sur le nœud Ports de réception . Dans le volet droit, cliquez avec le bouton droit sur le port de réception associé à un emplacement de réception existant ou auquel associer un nouvel emplacement, puis cliquez sur Propriétés.

4. Dans la boîte de dialogue Propriétés du port de réception, dans le volet gauche, sélectionnez Emplacements de réception, puis dans le volet droit, double-cliquez sur un emplacement de réception existant ou cliquez sur Nouveau pour créer un emplacement de réception.

5. Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la section Transport en regard de Type, sélectionnez HTTP dans la liste déroulante, puis cliquez sur Configurer.

6. Dans la boîte de dialogue Propriétés du transport HTTP , procédez comme suit :

   Propriété	Pour
   Répertoire virtuel assorti de l'extension ISAPI	Indiquer le nom du répertoire virtuel dans lequel vous publiez les messages reçus à l'emplacement de réception HTTP/HTTPS. Ce nom est constitué du nom du fichier DLL de l'emplacement de réception et d'une chaîne de requête facultative. Voici quelques exemples de noms de répertoires virtuels : /<virtual directory>/BTSHTTPReceive.dll /<virtual directory>/BTSHTTPReceive.dll ? Purchase%20Order Cet emplacement ne doit pas contenir plus d'une extension ISAPI BTSHTTPReceive.dll, y compris dans tous les sous-dossiers. Type: String Longueur maximale : 256 Remarque : l’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.
   Adresse publique	Indiquer l'adresse URI complète de cet emplacement de réception. La valeur de cette propriété est constituée du nom du serveur et de celui du répertoire virtuel. Le moteur de messagerie BizTalk expose cette adresse aux partenaires externes. L'URI indiquée doit désigner l'URL du site Web public de manière à ce que les partenaires commerciaux puissent s'y connecter lors de l'envoi de messages à BizTalk Server. Ces informations sont facultatives et ne sont pas utilisées par BizTalk Server. Ce paramètre est disponible pour permettre aux administrateurs de documenter l'URL publique à laquelle est lié l'emplacement de réception. Type: String Longueur minimale : 0 Longueur maximale : 256
   Type de contenu de retour	Indiquer le type de contenu des messages de réponse HTTP que l'emplacement de réception renvoie aux clients. Cette propriété est valide uniquement pour des emplacements de réception de type requête-réponse. Valeur par défaut : text/xml Type: String Longueur minimale : 0 Longueur maximale : 256
   Loopback	Définir si le message de requête reçu à cet emplacement est acheminé vers un port d'envoi ou renvoyé à cet emplacement de réception en tant que réponse. Cette propriété est valide uniquement pour des emplacements de réception de type requête-réponse. Valeur par défaut : Faux Type: Boolean
   Renvoyer un descripteur de corrélation en cas de réussite (port unidirectionnel uniquement)	Définir si, en cas de succès, l'emplacement de réception envoie au client le jeton de corrélation du message envoyé dans la réponse HTTP. Cette propriété n'est valide que pour les emplacements de réception unidirectionnels. Valeur par défaut : Vrai Type: Boolean
   Utiliser l'authentification unique	Indiquez que l'Sign-On unique d’entreprise est utilisée. Valeur par défaut : Faux Type: Remarque booléenne : si cette option est activée, vous devez également activer l’option Autoriser les tickets au niveau du système SSO . L’option Autoriser les tickets est configurable sous l’onglet Options de la boîte de dialogue Propriétés système de l’authentification unique disponible dans l’interface MMC Administration SSO . Si cette option est activée et que l’option Autoriser les tickets au niveau du système SSO n’est pas activée, tous les messages reçus par cet emplacement de réception seront suspendus.
   Suspendre les requêtes ayant échoué	Indiquer s'il faut interrompre ou non les requêtes HTTP qui échouent au niveau du traitement entrant. La valeur False indique qu'il faut supprimer la requête ayant échoué et envoyer un code d'état d'erreur (401 ou 500) au client. La valeur True indique qu'il faut interrompre la requête ayant échoué et envoyer au client un code d'état « Accepté » (200) pour les ports de réception unidirectionnels ou un code d'état « Erreur » (500) pour les ports de réception bidirectionnels. Valeur par défaut : Faux Type: Boolean

7. Cliquez sur OK pour enregistrer les paramètres.

8. Entrez les valeurs appropriées dans la boîte de dialogue Propriétés de l'emplacement de réception pour terminer la configuration de l'emplacement de réception, puis cliquez sur OK pour enregistrer les paramètres. Pour plus d'informations sur la boîte de dialogue Propriétés de l'emplacement de réception , consultez la rubrique Création d'un emplacement de réception.

   Tandis que le client HTTP appelle l'emplacement HTTP, l'adaptateur HTTP authentifie le client à l'aide de l'authentification Anonyme, De base, Digest ou Intégrée Windows. Si la vérification de l'utilisateur est activée, le contexte utilisateur est transmis au gestionnaire de réception.

Notes

Toute configuration IIS menant au partage du même processus par SOAP et HTTP est non valide. Vous ne pouvez utiliser qu'un seul récepteur isolé par processus.