Share via

Que sont les adaptateurs WCF ?

  • Article

Il existe deux adaptateurs WCF (Windows Communication Foundation) : un adaptateur de réception et un adaptateur d'envoi. Vous utilisez l'adaptateur de réception WCF pour recevoir des demandes de service WCF. L'adaptateur de réception WCF reçoit une demande, crée un objet de message BizTalk et promeut les propriétés associées vers le contexte du message. Vous utilisez l'adaptateur d'envoi WCF pour appeler un service WCF. L'adaptateur d'envoi WCF appelle les services WCF via les contrats sans type.

Notes

Les adaptateurs WCF ne prennent pas en charge l'utilisation de services Web de type RPC (appel de procédure distante) car les parties de message dans des services Web RPC se rapportent aux types de message plutôt qu'aux éléments de message, alors que les adaptateurs WCF utilisent les éléments pour les parties de message. Nous vous recommandons d'ajouter les services Web RPC à l'aide de l'Assistant Ajouter une référence Web afin d'utiliser les services Web dans des projets BizTalk.

Prise en charge des normes de services Web

Les adaptateurs WCF assurent la prise en charge des normes WS-*, telles que WS-Addressing, WS-Security et WS-AtomicTransaction. La norme WS-ReliableMessaging n'est pas prise en charge dans cette version des adaptateurs WCF. Pour obtenir la liste des spécifications prises en charge par WCF, consultez https://go.microsoft.com/fwlink/?LinkId=88314.

WS-Addressing

Les adaptateurs WCF s'appuient sur la prise en charge de la norme WS-Addressing qui est assurée par WCF. Les fonctionnalités suivantes sont disponibles dans les adaptateurs WCF :

  • Configuration de l'adresse du point de terminaison du port d'envoi obtenue au cours de la demande d'échange de métadonnées.

  • Configuration des en-têtes d'adressage pour l'adresse du point de terminaison du port d'envoi.

  • Configuration des en-têtes d'adressage pour le point de terminaison exposé dans l'emplacement de réception BizTalk.

WS-Security

Les adaptateurs WCF s'appuient sur la prise en charge de normes de sécurité qui est assurée par WCF. Les normes suivantes sont prises en charge dans les adaptateurs WCF :

  • Web Services Security: SOAP Message Security (WS-Security) 1.0 et 1.1

  • Web Services Secure Conversation Language (WS-SecureConversation)

  • Web Services Trust Language (WS-Trust)

  • Web Services Security X.509 Certificate Token Profile

  • Web Services Security Username Token Profile 1.0

  • Web Services Security Kerberos Token Profile 1.0

Types d'authentification de services

Les types d'authentification de services WCF suivants sont pris en charge :

  • Aucune

  • Windows

  • Certificat

Types d'authentification de clients

Les types d'authentification de clients WCF suivants sont pris en charge :

  • Anonyme

  • UserName

  • Windows

  • Certificat

Modes de sécurité

Les modes de sécurité suivants sont pris en charge :

  • Transport

  • Message

  • Mixte (sécurité de niveau transport et authentification au niveau du message)

WS-AtomicTransaction

Les adaptateurs WCF-WsHttp, WCF-NetTcp et WCF-NetMsmq prennent en charge le protocole WS-AtomicTransaction. Cette prise en charge permet les scénarios suivants :

  • Envoi transactionnel de messages à la base de données MessageBox.

  • Transmission transactionnelle de messages à partir de la base de données MessageBox vers une destination transactionnelle.

Notes

L'étendue transactionnelle est limitée par la MessageBox. Par exemple, une orchestration BizTalk ne peut pas participer à la transaction d'un client. De même, un point de terminaison de destination ne peut pas participer à une transaction initiée par une orchestration BizTalk.

Envoi transactionnel

Pour les cartes WCF-WsHttp et WCF-NetTcp, la soumission transactionnelle à BizTalk Server est activée en sélectionnant la zone Activer les transactions case activée dans la boîte de dialogue Propriétés de transport de l’emplacement de réception. Pour l’adaptateur WCF-NetMsmq, la zone Case activée transactionnelle est sélectionnée par défaut. Si les files d'attente de messages desquelles vous retirez des messages ne sont pas marquées comme transactionnelles, vous devez désactiver cette case à cocher, sinon vous recevrez un message d'erreur.

Si la fonctionnalité de transaction est activée, les messages sont envoyés à la base de données MessageBox à l'aide de transactions de clients. Si un client tente d'envoyer des messages en dehors de l'étendue transactionnelle, l'adaptateur renvoie une exception au client. Toutefois, aucun message n'est interrompu. Si la fonctionnalité de transaction est désactivée, les messages sont envoyés à la base de données MessageBox sans l'aide de transactions de clients. Si un client tente d'envoyer des messages dans l'étendue transactionnelle, l'adaptateur renvoie une exception au client et aucun message n'est interrompu.

Transactions et type d'emplacement de réception

L'envoi transactionnel n'est disponible que pour les emplacements de réception unidirectionnels. Si un client tente d'envoyer des messages dans une étendue transactionnelle pour un emplacement de réception bidirectionnel, une exception est renvoyée au client et aucun message n'est interrompu.

Transmission transactionnelle

Pour les cartes WCF-WsHttp et WCF-NetTcp, la transmission transactionnelle à partir de BizTalk Server est activée en sélectionnant la zone Activer les transactions case activée dans la boîte de dialogue Propriétés de transport du port d’envoi. Pour l’adaptateur WCF-NetMsmq, la zone Case activée transactionnelle est sélectionnée par défaut. Si les files d'attente de messages auxquelles vous envoyez des messages ne sont pas marquées comme transactionnelles, vous devez désactiver cette case à cocher, sinon vous recevrez un message d'erreur.

Si la fonctionnalité de transaction est activée, les messages sont transmis et supprimés de la base de données MessageBox à l'aide de transactions. Si le service de destination a effectué un travail après la réception du message et que le message n'est pas supprimé de la MessageBox, alors la transaction est abandonnée et tout le travail de transaction effectué sur le service est annulé. Si la fonctionnalité de transaction est désactivée, les messages sont transmis et supprimés de la base de données MessageBox sans l'aide de transactions.

Prise en charge de l'authentification unique

Vous pouvez emprunter une identité et acquérir le ticket d'authentification unique de l'entreprise pour utiliser l'authentification unique avec des adaptateurs WCF. Pour plus d’informations sur l’utilisation de l’authentification unique avec des adaptateurs WCF, consultez Prise en charge des Sign-On uniques pour les adaptateurs WCF.

Le tableau suivant récapitule les scénarios qui ne sont pas pris en charge lors de l'utilisation de la prise en charge de l'authentification unique avec les adaptateurs de réception WCF.

Mode de sécurité Informations d'identification
None None
Transport None
Message None
TransportWithMessageCredentials None
TransportCredentialOnly None

Extensibilité WCF

Vous pouvez étendre la fonctionnalité de WCF en développant les extensions suivantes et en les utilisant avec les adaptateurs WCF-Custom et WCF-CustomIsolated :

  • Liaisons personnalisées

  • Éléments de liaison personnalisés

Liaisons personnalisées

Les liaisons personnalisées sont développées en empaquetant des éléments de liaison individuels dans un conteneur qui expose un sous-ensemble de propriétés de configuration pour un scénario d'utilisation particulier. Vous devez enregistrer l'extension de liaison en installant l'assembly dans le Global Assembly Cache (GAC), puis ajouter l'élément d'extension au fichier de configuration de l'ordinateur. Pour utiliser les liaisons personnalisées, vous devez configurer la liaison sur chaque serveur du groupe BizTalk. Une fois la liaison installée, elle est visible pour les adaptateurs WCF-Custom et WCF-CustomIsolated. Les adaptateurs WCF-Custom et WCF-CustomIsolated obtiennent les propriétés de configuration de la liaison à l'aide de la réflexion sur les éléments de configuration de la liaison.

Éléments de liaison personnalisés

Les éléments de liaison personnalisés sont développés en ajoutant ou en modifiant certains composants du canal de transport. Par exemple, un composant de décompression personnalisé est empaqueté en tant qu'élément de liaison ou un transport UDP est représenté en tant qu'élément de liaison. Ces éléments de liaison peuvent être utilisés dans les adaptateurs WCF. Vous pouvez définir une pile de canaux qui utilise l'élément de liaison personnalisé en combinaison avec d'autres éléments de liaison fournis ou personnalisés. Vous devez enregistrer l'extension d'élément de liaison en installant l'assembly dans le Global Assembly Cache (GAC), puis ajouter l'élément d'extension au fichier de configuration de l'ordinateur. Pour utiliser les liaisons personnalisées, vous devez configurer la liaison sur chaque serveur du groupe BizTalk. Pour utiliser les éléments de liaison personnalisés, vous pouvez sélectionner le type de liaison CustomBinding , puis ajouter, modifier ou réorganiser les éléments de liaison dans l’ordre souhaité.

Dans cette section

Voir aussi