Partager via

Adaptateur WCF-WebHttp

  • Article

Microsoft BizTalk Server utilise l’adaptateur WCF-WebHttp pour envoyer des messages aux services RESTful. L’adaptateur d’envoi WCF-WebHttp envoie des messages HTTP à un service à partir d’un message BizTalk. L’emplacement de réception reçoit des messages en provenance d’un service RESTful. Pour les requêtes GET et DELETE, l’adaptateur n’utilise aucune charge. Pour les requêtes POST et PUT, l’adaptateur utilise le corps du message BizTalk dans le contenu et la charge HTTP.

Cette rubrique vous montre comment créer l’emplacement de réception et le port d’envoi à l’aide de l’administration BizTalk.

Créer un emplacement de réception

Notes

Avant d’effectuer la procédure suivante, vous devez avoir déjà ajouté un port de réception unidirectionnel. Consultez Comment créer un port de réception.

  1. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, groupe BizTalk, Applications, puis développez l’application sous laquelle vous souhaitez créer un emplacement de réception.

  2. 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 auquel vous souhaitez associer le nouvel emplacement de réception, puis cliquez sur Propriétés.

  3. Dans le volet gauche de la boîte de dialogue Propriétés des ports de réception , sélectionnez Emplacements de réception, puis dans le volet droit, cliquez sur Nouveau pour créer un emplacement de réception.

  4. Dans la liste déroulante Type de la section Transport de la boîte de dialogue Propriétés de l’emplacement de réception , sélectionnez WCF-WebHttp , puis cliquez sur Configurer pour configurer les propriétés de transport de l’emplacement de réception.

  5. Sous l’onglet Général , configurez l’adresse du point de terminaison pour l’interface REST à partir de laquelle le message est reçu.

    Propriété Pour
    Adresse (URI) Obligatoire. Spécifiez l’URI sur lequel BizTalk Server pouvez recevoir des messages RESTful basés sur HTTP.
    Identité du point de terminaison facultatif. Spécifier l'identité du point de terminaison. Ces paramètres permettent au point de terminaison d'authentifier cet emplacement de réception. Lors du processus d’établissement de liaison entre le point de terminaison et l’emplacement de réception, l’infrastructure WCF (Windows Communication Foundation) garantit que l’identité du service attendu correspond aux valeurs de cet élément.

    La valeur par défaut est une chaîne vide.
    Méthode HTTP et mappage d’URL Le mappage des opérations BTS permet aux utilisateurs de mapper des requêtes HTTP entrantes à une opération BTS dans le contexte de message, sur la base de la méthode HTTP entrante et du sous-chemin URL. La méthode HTTP entrante et le sous-chemin URL sont comparés à un ensemble de méthodes HTTP et au modèle URI. Si une correspondance est trouvée, l’adaptateur promeut la propriété BTS.Operation dans le contexte du message BizTalk avec la valeur spécifiée dans le message.

    Vous pouvez spécifier la méthode HTTP et le mappage d’URL dans un format singulier ou incluant plusieurs mappages. Le format incluant plusieurs mappages ressemble à ce qui suit :

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345</BtsHttpUrlMapping>

    Dans l’extrait de code ci-dessus, notez que l’ID de client est fourni en tant que valeur constante, à savoir 12345. Toutefois, dans certains scénarios, l’ID de client (ou toute autre variable de requête) doit être déterminé au moment de l’exécution. Pour activer de tels scénarios, vous devez renseigner le composant variable de l’URL entre accolades { }. Par exemple, dans l’extrait de code ci-dessus, si vous spécifiez l’ID de client en tant que variable, le résultat doit ressembler à ce qui suit :

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}</BtsHttpUrlMapping>

    Dans ce cas, vous devez également spécifier l’emplacement où la valeur de la variable ID doit être récupérée au moment de l’exécution. Vous indiquez cet emplacement à l’aide d’un mappage de variable.

    Remarque
    Dans le champ URL, tous les caractères XML spéciaux doivent être « placés dans une séquence d’échappement ». Cela garantit que les caractères XML spéciaux sont traités et conservés par le port. Par exemple, le & caractère spécial doit être placé dans une séquence d’échappement en tant que &amp;.

    De :
    Url=”/Customer?{ID}& group=Location”
    Par :
    Url=”/Customer?{ID}&amp;group=Location”
    mappage de variable Si vous avez spécifié des variables pour le mappage d’URL de la méthode HTTP, vous devez spécifier à quoi correspond la variable au moment de l’exécution. Cliquez sur le bouton Modifier pour ouvrir la boîte de dialogue Mappage de variable . Sous la colonne Variable , la boîte de dialogue répertorie les variables que vous avez définies pour Méthode HTTP et mappage d’URL. Dans le champ Nom de la propriété , vous devez spécifier le nom de la propriété qui fournit la valeur à associer à la variable. Vous devez déjà avoir défini/promu cette propriété dans le cadre de votre solution. Vous devez également renseigner l’espace de noms pour la propriété dans le champ Espace de noms de la propriété .

  6. Sous l’onglet Liaison , configurez les propriétés liées au délai d’attente et à l’encodage.

    Propriété Pour
    Délai d'attente d'ouverture (hh:mm:ss) Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'ouverture de canal soit réalisée. Cette valeur doit être supérieure ou égale à la valeur System.TimeSpan.Zero.

    Valeur par défaut : 00:01:00

    Valeur maximale : 23 :59 :59
    Délai d'attente d'envoi (hh:mm:ss) Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'envoi soit réalisée. Cette valeur doit être supérieure ou égale à la valeur System.TimeSpan.Zero. En cas d'utilisation d'un port de réception de requête-réponse, cette valeur indique une période pour la réalisation de l'intégralité de l'interaction, même si le client renvoie un message volumineux.

    Valeur par défaut : 00:01:00

    Valeur maximale : 23 :59 :59
    Délai d'attente de fermeture (hh:mm:ss) Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération de fermeture de canal soit réalisée. Cette valeur doit être supérieure ou égale à la valeur System.TimeSpan.Zero.

    Valeur par défaut : 00:01:00

    Valeur maximale : 23 :59 :59
    Taille maximale des messages reçus (octets) Indiquer la taille maximale en octets d'un message comprenant des en-têtes et pouvant être reçu sur le câble. La taille des messages est limitée par la quantité de mémoire allouée pour chacun d'eux. Vous pouvez vous servir de cette propriété afin de limiter les expositions aux attaques de type refus de service.

    L’adaptateur WCF-WebHttp a recours à la classe WebHttpBinding dans le mode de transfert mis en mémoire tampon pour communiquer avec un point de terminaison. Pour le mode de transport mis en mémoire, la propriété WebHttpBinding.MaxBufferSize est toujours égale à la valeur de cette propriété.

    Valeur par défaut : 65536

    Valeur maximale : 2147483647
    Nombre maximum d'appels simultanés Spécifier le nombre d'appels simultanés par instance de service unique. Les appels excédentaires sont mis en file d'attente. Définir cette valeur sur 0 revient à la définir sur Int32.MaxValue.

    Par défaut, la valeur est 200.

  7. Sous l’onglet Sécurité , définissez les fonctionnalités de sécurité de l’emplacement de réception WCF-WebHttp.

    Propriété Pour
    Mode de sécurité Spécifier le type de sécurité utilisé. Les valeurs valides sont les suivantes :

    - Aucun : les messages ne sont pas sécurisés pendant le transfert.

    - Transport : la sécurité est fournie à l’aide du transport HTTPS. Les messages SOAP sont sécurisés à l'aide de HTTPS. Pour utiliser ce mode, vous devez configurer SSL (Secure Sockets Layer) dans Microsoft Internet Information Services (IIS).

    - TransportWithMessageCredential : l’intégrité, la confidentialité et l’authentification du service sont fournies par le transport HTTPS. Pour utiliser ce mode, vous devez configurer SSL (Secure Sockets Layer) dans Microsoft Internet Information Services (IIS).

    La valeur par défaut est Transport.
    Type d'informations d'identification du client du transport Spécifier le type d’informations d’identification à utiliser lors de l’authentification du client. Les valeurs valides sont les suivantes :

    - Aucun : aucune authentification ne se produit au niveau du transport.

    - De base : Authentification de base. Dans l'authentification de base, les noms d'utilisateur et les mots de passe sont envoyés sous forme de texte brut sur le réseau. Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification.

    - Digest : authentification Digest. Cette méthode d'authentification a un fonctionnement similaire à l'authentification de base, excepté que les mots de passe sont envoyés sur le réseau sous forme de valeur de hachage afin d'améliorer la sécurité. Elle est uniquement disponible sur des domaines avec contrôleurs de domaine exécutant l'authentification des systèmes d'exploitation Windows Server. Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification du client.

    - Ntlm : authentification NTLM. Les clients peuvent envoyer les informations d'identification sans envoyer de mot de passe vers cet emplacement de réception. Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification du client.

    - Windows : Authentification intégrée Windows. Windows Communication Foundation négocie l'authentification Kerberos ou NTLM, la première ayant sa préférence si un domaine est présent. Pour utiliser l'authentification Kerberos, le client doit identifier le service ayant un nom principal de service (SPN, Service Principal Name). Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification du client.

    - Certificat : Authentification du client à l’aide du certificat client. La chaîne du certificat d'Autorité de certification des certificats X.509 du client doit être installée dans le magasin de certificats des autorités de certification racines de confiance de cet ordinateur afin que les clients puissent être authentifiés pour cet emplacement de réception.

    NoteLa propriété Type d’informations d’identification du client de transport doit correspondre au schéma d’authentification du répertoire virtuel IIS qui héberge cet emplacement de réception. Par exemple, si la propriété est définie sur Windows, vous devez également activer Authentification Windows intégrée pour le répertoire virtuel qui l'héberge. De même, si la propriété est définie sur Aucun, vous devez autoriser l'accès anonyme au répertoire virtuel qui héberge cet emplacement de réception.

    La valeur par défaut est Windows.
    Certificat de service - Empreinte Spécifier l'empreinte du certificat X.509 pour cet emplacement de réception permettant au client d'authentifier le service. Pour sélectionner l'empreinte, accédez au magasin Personnel dans l'emplacement Utilisateur actuel à l'aide du bouton Parcourir .

    Note Vous devez installer le certificat de service dans l’emplacement Utilisateur actuel du compte d’utilisateur pour le gestionnaire de réception hébergeant cet emplacement de réception.

    Longueur minimale : 0

    Longueur maximale : 40

    La valeur par défaut est une chaîne vide.

  8. Sous l’onglet Comportement , spécifiez différents comportements au niveau du service et au niveau du point de terminaison. Ces comportements sont basés sur les classes .NET Framework.

    Propriété Pour
    ServiceBehavior Étendez les fonctionnalités de votre service WCF au niveau du service. Vous pouvez ajouter des extensions qui effectuent différentes opérations, telles que définir les paramètres de sécurité, activer le débogage, implémenter la limitation et utiliser d’autres classes .NET.

    Sélectionnez Avec le bouton droit ServiceBehavior, puis Ajouter une extension. La liste affiche les classes .NET qui peuvent être utilisées.
    EndpointBehavior Étendez le fonctionnement de la façon dont les demandes sont reçues au niveau du point de terminaison. Vous pouvez ajouter des extensions qui effectuent différentes opérations, telles que recevoir des requêtes HTTP à partir d’un ASP.NET client AJAX basé sur un navigateur, spécifier un intervalle de temps sur les transactions, choisir de recevoir des messages de manière synchrone ou asynchrone et utiliser d’autres classes .NET.

    Sélectionnez Avec le bouton droit EndpointBehavior, puis Ajouter une extension. La liste affiche les classes .NET qui peuvent être utilisées.

    Cela est similaire à la configuration du comportement d’un emplacement de réception WCF-Custom. Consultez la boîte de dialogue Propriétés de transport WCF-Custom, Onglet Réception, Comportement dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

  9. Sous l’onglet Messages , spécifiez la sélection des données pour l’élément SOAP Body .

    Propriété Pour
    En-têtes HTTP sortants Spécifie les en-têtes HTTP indiqués sur le message de réponse, le cas échéant.
    Désactiver l'emplacement en cas d'échec Spécifiez s'il faut désactiver l'emplacement de réception pour lequel le traitement entrant a échoué en raison d'une erreur de pipeline de réception ou d'un échec de routage.

    Par défaut, cette option est désactivée.
    Suspendre le message de requête en cas d'échec Spécifier s'il faut interrompre le message de requête dont le traitement entrant a échoué en raison d'une erreur de pipeline de réception ou d'un échec de routage.

    Par défaut, cette case à cocher est désactivée.
    Inclure le détail des exceptions dans les messages d'erreur Spécifier s'il faut retourner des messages d'erreur SOAP en cas d'échec afin de faciliter le débogage.

    Par défaut, cette case à cocher est désactivée.

  10. Cliquez sur OK.

  11. 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.

Pour créer un port d'envoi

  1. Dans la console Administration de BizTalk, créez un port d'envoi ou double-cliquez sur un port d'envoi existant pour le modifier. Consultez Comment créer un port d’envoi. Configurez toutes les options de port d’envoi et spécifiez WCF-WebHttp 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 .

  3. Sous l’onglet Général , configurez l’adresse du point de terminaison pour l’interface REST où le message est envoyé.

    Propriété Pour
    Adresse (URI) Obligatoire. Spécifier l’URI de l’interface REST à laquelle le message est envoyé.
    Identité du point de terminaison facultatif. Spécifier l'identité du point de terminaison. Ces paramètres permettent au point de terminaison d’authentifier ce port d’envoi. Lors du processus d’établissement de liaison entre le point de terminaison et l’emplacement de réception, l’infrastructure WCF (Windows Communication Foundation) garantit que l’identité du service attendu correspond aux valeurs de cet élément.

    La valeur par défaut est une chaîne vide.
    Méthode HTTP et mappage d’URL Le mappage des opérations BTS permet aux utilisateurs de mapper des requêtes HTTP entrantes à une opération BTS dans le contexte de message, sur la base de la méthode HTTP entrante et du sous-chemin URL. La méthode HTTP entrante et le sous-chemin URL sont comparés à un ensemble de méthodes HTTP et au modèle URI. Si une correspondance est trouvée, l’adaptateur promeut la propriété BTS.Operation dans le contexte du message BizTalk avec la valeur spécifiée dans le message.

    Vous pouvez spécifier la méthode HTTP et le mappage d’URL dans un format singulier ou incluant plusieurs mappages. Le format incluant plusieurs mappages ressemble à ce qui suit :

    BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345" /> </BtsHttpUrlMapping>

    Dans l’extrait de code ci-dessus, notez que l’ID de client est fourni en tant que valeur constante, à savoir 12345. Toutefois, dans certains scénarios, l’ID de client (ou toute autre variable de requête) doit être déterminé au moment de l’exécution. Pour activer de tels scénarios, vous devez renseigner le composant variable de l’URL entre accolades { }. Par exemple, dans l’extrait de code ci-dessus, si vous spécifiez l’ID de client en tant que variable, le résultat doit ressembler à ce qui suit :

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}" /> </BtsHttpUrlMapping>

    Dans ce cas, vous devez également spécifier l’emplacement où la valeur de la variable ID doit être récupérée au moment de l’exécution. Vous indiquez cet emplacement à l’aide d’un mappage de variable.

    Remarque
    Dans le champ URL, tous les caractères XML spéciaux doivent être « placés dans une séquence d’échappement ». Cela garantit que les caractères XML spéciaux sont traités et conservés par le port. Par exemple, le & caractère spécial doit être placé dans une séquence d’échappement en tant que &amp;.

    De :
    Url=”/Customer?{ID}& group=Location”
    Par :
    Url=”/Customer?{ID}&amp;group=Location”
    mappage de variable Si vous avez spécifié des variables pour le mappage d’URL de la méthode HTTP, vous devez spécifier à quoi correspond la variable au moment de l’exécution. Cliquez sur le bouton Modifier pour ouvrir la boîte de dialogue Mappage de variable . Sous la colonne Variable , la boîte de dialogue répertorie les variables que vous avez définies pour Méthode HTTP et mappage d’URL. Dans le champ Nom de la propriété , vous devez spécifier le nom de la propriété qui fournit la valeur à associer à la variable. Vous devez déjà avoir défini/promu cette propriété dans le cadre de votre solution. Vous devez également renseigner l’espace de noms pour la propriété dans le champ Espace de noms de la propriété .

  4. Sous l’onglet Liaison , configurez les propriétés liées au délai d’attente et à l’encodage.

    Propriété Pour
    Délai d'attente d'ouverture (hh:mm:ss) Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'ouverture de canal soit réalisée. Cette valeur doit être supérieure ou égale à la valeur System.TimeSpan.Zero.

    Valeur par défaut : 00:01:00

    Valeur maximale : 23 :59 :59
    Délai d'attente d'envoi (hh:mm:ss) Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'envoi soit réalisée. Cette valeur doit être supérieure ou égale à la valeur System.TimeSpan.Zero. En cas d'utilisation d'un port de réception de requête-réponse, cette valeur indique une période pour la réalisation de l'intégralité de l'interaction, même si le client renvoie un message volumineux.

    Valeur par défaut : 00:01:00

    Valeur maximale : 23 :59 :59
    Délai d'attente de fermeture (hh:mm:ss) Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération de fermeture de canal soit réalisée. Cette valeur doit être supérieure ou égale à la valeur System.TimeSpan.Zero.

    Valeur par défaut : 00:01:00

    Valeur maximale : 23 :59 :59
    Taille maximale des messages reçus (octets) Indiquer la taille maximale en octets d'un message comprenant des en-têtes et pouvant être reçu sur le câble. La taille des messages est limitée par la quantité de mémoire allouée pour chacun d'eux. Vous pouvez vous servir de cette propriété afin de limiter les expositions aux attaques de type refus de service.

    L’adaptateur WCF-WebHttp a recours à la classe WebHttpBinding dans le mode de transfert mis en mémoire tampon pour communiquer avec un point de terminaison. Pour le mode de transport mis en mémoire, la propriété WebHttpBinding.MaxBufferSize est toujours égale à la valeur de cette propriété.

    Valeur par défaut : 65536

    Valeur maximale : 2147483647

  5. Sous l’onglet Sécurité , définissez les fonctionnalités de sécurité du port d’envoi WCF-WebHttp.

    Propriété Pour
    Mode de sécurité Spécifier le type de sécurité utilisé. Les valeurs valides sont les suivantes :

    - Aucun : les messages ne sont pas sécurisés pendant le transfert.
    - Transport : la sécurité est fournie à l’aide du transport HTTPS. Les messages SOAP sont sécurisés à l'aide de HTTPS. La chaîne du certificat d'Autorité de certification du certificat X.509 du service doit être installée dans le magasin de certificats des autorités de certification racines de confiance de cet ordinateur afin que le service puisse être authentifié sur le port d'envoi à l'aide du certificat du service.
    - TransportWithMessageCredential : l’intégrité, la confidentialité et l’authentification du service sont fournies par le transport HTTPS. La chaîne de certificats d’autorité de certification pour le certificat X.509 du service doit être installée dans le magasin de certificats autorités de certification racines approuvées sur cet ordinateur afin que le service puisse être authentifié sur le port d’envoi à l’aide du certificat du service. L'authentification du port d'envoi est assurée par la sécurité des messages SOAP.

    La valeur par défaut est None (Aucun).
    Type d'informations d'identification du client du transport Spécifier le type d’informations d’identification à utiliser lors de l’authentification du client. Les valeurs valides sont les suivantes :

    - Aucun : aucune authentification ne se produit au niveau du transport.
    - De base : Authentification de base. Dans l'authentification de base, les noms d'utilisateur et les mots de passe sont envoyés sous forme de texte brut sur le réseau. Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification.
    - Digest : Authentification Digest. Cette méthode d'authentification a un fonctionnement similaire à l'authentification de base, excepté que les mots de passe sont envoyés sur le réseau sous forme de valeur de hachage afin d'améliorer la sécurité. Elle est uniquement disponible sur des domaines avec contrôleurs de domaine exécutant l'authentification des systèmes d'exploitation Windows Server. Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification du client.
    - Ntlm : authentification NTLM. Les clients peuvent envoyer les informations d'identification sans envoyer de mot de passe vers cet emplacement de réception. Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification du client.
    - Windows : Authentification intégrée Windows. Windows Communication Foundation négocie l'authentification Kerberos ou NTLM, la première ayant sa préférence si un domaine est présent. Pour utiliser l'authentification Kerberos, le client doit identifier le service ayant un nom principal de service (SPN, Service Principal Name). Vous devez créer les comptes d'utilisateur de domaine ou locaux correspondant aux informations d'identification du client.
    - Certificat : Authentification du client à l’aide du certificat client. La chaîne du certificat d'Autorité de certification des certificats X.509 du client doit être installée dans le magasin de certificats des autorités de certification racines de confiance de cet ordinateur afin que les clients puissent être authentifiés pour cet emplacement de réception. Note: La propriété Type d’informations d’identification du client de transport doit correspondre au schéma d’authentification du répertoire virtuel IIS hébergeant cet emplacement de réception. Par exemple, si la propriété est définie sur Windows, vous devez également activer Authentification Windows intégrée pour le répertoire virtuel qui l'héberge. De même, si la propriété est définie sur Aucun, vous devez autoriser l'accès anonyme au répertoire virtuel qui héberge cet emplacement de réception.

    La valeur par défaut est Windows.
    Certificat client - Empreinte numérique Spécifier l’empreinte du certificat X.509 pour l’authentification de ce port d’envoi auprès du point de terminaison. Vous pouvez sélectionner l’empreinte numérique en accédant à Mon magasin dans l’emplacement utilisateur actuel avec le bouton Parcourir . Note: Vous devez installer le certificat client dans l’emplacement Utilisateur actuel du compte d’utilisateur du gestionnaire d’envoi hébergeant ce port d’envoi.

    Longueur minimale : 0

    Longueur maximale : 40

    La valeur par défaut est une chaîne vide.
    Certificat de service - Empreinte Spécifier l’empreinte du certificat X.509 pour l’authentification du service auquel ce port d’envoi envoie des messages. Vous pouvez sélectionner l’empreinte numérique qui accède au magasin Autres Personnes dans l’emplacement de l’ordinateur local à l’aide du bouton Parcourir.

    Longueur minimale : 0

    Longueur maximale : 40

    La valeur par défaut est une chaîne vide.
    Informations d'identification de l'utilisateur Spécifiez les informations d'identification pour l'envoi des messages. Vous pouvez spécifier la propriété en cliquant sur le bouton Modifier . Vous devez définir les informations d’identification si vous avez sélectionné l’option Nom d’utilisateur pour Type d’informations d’identification du client Message.

    La valeur par défaut est Ne pas utiliser l’authentification unique.
    Utiliser l’identité du service ACS S’applique aux BizTalk Server 2013 R2 et BizTalk Server 2013.

    Cochez cette case, cliquez sur Modifier et fournissez les valeurs suivantes pour vous authentifier auprès de Service Bus. Cela n’est requis que lors de l’appel d’une interface REST pour les entités associées à Service Bus.

    - Access Control URI STS service : définissez cette valeur sur https://<Namespace>-sb.accesscontrol.windows.net/, où <espace de noms> est votre espace de noms Service Bus.
    - Nom de l’émetteur : spécifiez le nom de l’émetteur. Généralement, il s'agit du propriétaire.
    - Clé de l’émetteur : spécifiez la clé de l’émetteur.
    Informations de connexion Service Bus Nouveauté à compter de BizTalk Server 2016.

    Choisissez d’utiliser la signature d’accès partagé (SAS) ou Access Control service (ACS) de l’espace de noms Service Bus.

    Sélectionnez une option, puis modifier pour entrer les informations clés :

    - Signature d’accès partagé : entrez le nom de la clé d’accès et la clé d’accès. Les deux valeurs sont répertoriées dans le Portail Azure.
    - Access Control service : entrez l’URI STS (https://<yourNamespace>-sb.accesscontrol.windows.net/), le nom de l’émetteur et la clé de l’émetteur. Utilisez Windows PowerShell pour récupérer ces valeurs, comme décrit dans Adaptateur SB-Messaging.

  6. Sous l’onglet Comportement , configurez le comportement du point de terminaison pour ce port d’envoi.

    Propriété Pour
    EndpointBehavior Étendez la fonctionnalité de la façon dont les requêtes sont envoyées au niveau du point de terminaison. Vous pouvez ajouter des extensions qui effectuent différentes opérations, telles que définir le comportement de traitement SOAP, spécifier un intervalle de temps sur les transactions, contrôler la fonctionnalité de découverte et utiliser d’autres classes .NET.

    Sélectionnez avec le bouton droit EndpointBehavior, puis Ajouter une extension. La liste affiche les classes .NET qui peuvent être utilisées.

    (configuration semblable à celle du comportement du point de terminaison pour un port d’envoi personnalisé WCF). Consultez la boîte de dialogue Propriétés de transport personnalisées WCF, onglet Envoyer, Comportement dans les instructions de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

  7. Sous l’onglet Proxy , configurez le paramètre de proxy pour le port d’envoi WCF-WebHttp.

    Propriété Pour
    Utiliser les paramètres de proxy du descripteur d’envoi Spécifier si ce port d'envoi utilise les paramètres de proxy du gestionnaire d'envoi l'hébergeant.

    Il s'agit du paramètre par défaut.
    Ne pas utiliser le proxy Indiquer si ce port d’envoi fait appel ou non à un serveur proxy.

    Par défaut, cette case à cocher est désactivée.
    Utiliser le proxy Indiquez si ce port d’envoi utilise le serveur proxy spécifié dans la propriété Address .

    Par défaut, cette case à cocher est désactivée.
    Adresse Indiquez l’adresse du serveur proxy. Utilisez le schéma https ou http en fonction de la configuration de sécurité. Cette adresse peut être suivie d'un deux-points et du numéro de port. Par exemple : http://127.0.0.1:8080.

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

    Tapez : String

    Longueur maximale : 256

    La valeur par défaut est une chaîne vide.
    Nom d'utilisateur Indiquer le nom d’utilisateur nécessaire à l’authentification. Si l'authentification intégrée est utilisée, ce nom comprend le domaine, c'est-à-dire domaine\nom_utilisateur. Dans le cas d'une authentification de base ou Digest, le domaine n'est pas indiqué. Cette propriété nécessite une valeur uniquement si l’option Utiliser le proxy est sélectionnée. Note: L’adaptateur d’envoi WCF-WebHttp utilise l’authentification de base pour le proxy.

    Tapez : String

    Longueur minimale : 0

    Longueur maximale : 256

    La valeur par défaut est une chaîne vide.
    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

    La valeur par défaut est une chaîne vide.

  8. Sous l’onglet Messages , spécifiez la façon dont le message est envoyé à l’interface REST.

    Propriété Pour
    En-têtes HTTP sortants Spécifie les en-têtes HTTP indiqués sur le message de réponse, le cas échéant.
    Supprimer le corps en fonction de verbes En fonction du verbe que vous utilisez pour appeler un point de terminaison REST, vous aurez (ou n’aurez pas) besoin de charge de message. Par exemple, vous n’aurez pas besoin de charge de message si vous utilisez les verbes GET ou DELETE. En revanche, pour déclencher un appel au point de terminaison REST à l’aide du port d’envoi, vous pouvez utiliser un message factice qui comporte une charge de message. Avant d’envoyer le message au point de terminaison REST, la charge du message factice doit être supprimée. Vous pouvez spécifier les verbes pour lesquels la charge utile du message doit être supprimée à l’aide de la propriété Supprimer le corps pour les verbes .

    Par exemple, si vous souhaitez supprimer la charge utile du message lors de l’utilisation d’un verbe GET, spécifiez la valeur de cette propriété comme GET.

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

Importer des extensions WCF

Importez les extensions WCF dans le gestionnaire de réception ou le gestionnaire d’envoi :

  1. Dans le BizTalk Server Administration, développez BizTalk Server Administration, BizTalk Group, Paramètres de plateforme, puis Cartes.

  2. Sélectionnez WCF-WebHttp, puis double-sélectionnez le gestionnaire de réception ou d’envoi.

  3. Sous l’onglet Général, sélectionnez Propriétés.

  4. Dans Extensions WCF, sélectionnez Importer, puis accédez au fichier de configuration de l’extension WCF.

Ajouter un proxy au gestionnaire d’envoi

Vous pouvez ajouter un proxy au port d’envoi ou au gestionnaire d’envoi. Si vous ajoutez un proxy au port d’envoi, ignorez cette section.

  1. Dans la console d’administration BizTalk Server, développez BizTalk Server Administration, BizTalk Group, Paramètres de la plateforme, puis Cartes.

  2. Sélectionnez WCF-WebHttp, puis sélectionnez le gestionnaire d’envoi.

  3. Dans Propriétés du gestionnaire d’adaptateur, sous l’onglet Général , sélectionnez Propriétés.

  4. Sous l’onglet Proxy , procédez comme suit.

    Propriété Pour
    Utiliser le proxy Indiquez si ce gestionnaire d’envoi utilise un serveur proxy.

    Par défaut, cette case à cocher est désactivée.
    Adresse Indiquez l’adresse du serveur proxy. Utilisez le schéma https ou http en fonction de la configuration de sécurité. Cette adresse peut être suivie d'un deux-points et du numéro de port. Par exemple : http://127.0.0.1:8080.

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

    Tapez : String

    Longueur maximale : 256

    La valeur par défaut est une chaîne vide.
    Nom d'utilisateur Indiquer le nom d’utilisateur nécessaire à l’authentification. Si l'authentification intégrée ou de base est utilisée, ce nom comprend le domaine, c'est-à-dire domaine\nom_utilisateur. Dans le cas de l'authentification Digest, le domaine n'est pas indiqué.

    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

    La valeur par défaut est une chaîne vide.
    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

    La valeur par défaut est une chaîne vide.

  5. Cliquez sur OK jusqu’à ce que vous quittez toutes les boîtes de dialogue.

Voir aussi

Adaptateur SB-Messaging

Utilisation des adaptateurs

Présentation des adaptateurs WCF