Partager via

Procédure d'activation des points d'extensibilité WCF avec les adaptateurs WCF

  • Article

Activez trois points d’extensibilité WCF (extension de comportement, extension d’élément de liaison et extension de liaison) avec les adaptateurs WCF-Custom et WCF-CustomIsolated. Pour ce faire, vous installez d’abord les assemblys qui implémentent les points d’extensibilité WCF dans le Global Assembly Cache (GAC), modifiez le fichier machine.config sur vos ordinateurs, puis configurez le WCF-Custom ou l’adaptateur WCF-CustomIsolated à l’aide de la console Administration BizTalk Server.

Pour plus d’informations sur les points d’extensibilité WCF, consultez Extension de WCF .

Prérequis

Connectez-vous avec un compte membre du groupe BizTalk Server Administrateurs. Les autorisations requises pour le déploiement et la gestion d’une application BizTalk fournissent plus d’informations.

Installer des assemblys implémentant un point d’extensibilité WCF dans le GAC

  1. Copiez les assemblys implémentant le point d'extensibilité WCF dans un dossier sur votre ordinateur local.

  2. Copiez les assemblys utilisés par le point d'extensibilité WCF (le cas échéant) dans un dossier sur votre ordinateur local.

  3. Démarrez l’invite de commandes Visual Studio.

  4. Tapez la commande suivante :

    gacutil.exe /if »<chemin d’accès au fichier de .dll d’assembly»>

  5. Cette procédure installe l'assembly dans le GAC, en remplaçant tout autre assembly existant sous le même nom.

  6. À l’invite de commandes Visual Studio, répétez les étapes 4 et 5 sur tous les assemblys que vous avez copiés aux étapes 1 et 2 de cette procédure.

  7. Si vous avez plusieurs ordinateurs d’exécution et d’administration BizTalk Server, répétez les étapes 1 à 6 de cette procédure sur tous les ordinateurs.

    Notes

    Pour activer les points d'extensibilité WCF pour les adaptateurs WCF, l'instance de l'hôte BizTalk exécutant l'adaptateur doit être capable de charger, au moment de l'exécution, les assemblys où les points d'extensibilité WCF sont implémentés.

Configurer le fichier machine.config pour une extension de liaison WCF

  1. À l’invite de commandes, accédez à %FrameworkDir%\v4. Dossier X.XXXXX\CONFIG, puis ouvrez le fichier machine.config à l’aide du Bloc-notes.

  2. Dans le Bloc-notes, si le fichier machine.config ne contient pas les <éléments system.serverModel>\<extensions> , ajoutez ces éléments à l’intérieur de l’élément <de configuration> du fichier machine.config, puis ajoutez l’élément <bindingExtensions> pour une extension de liaison WCF à l’intérieur des <éléments system.serverModel>\<extensions> . Par exemple, pour activer une extension de liaison personnalisée, netHttpBinding, ajoutez le code suivant dans l’élément <de configuration> du fichier machine.config :

    <system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
      <add name="netHttpBinding" type="Microsoft.Samples.Channels.NetHttpBindingCollectionElement, NetHttpBinding, Version=3.0.0.0, Culture=neutral, PublicKeyToken=5b637b51c4aaa2a8" />  
    </bindingExtensions>        
  </extensions>  
</system.serviceModel>

    Notes

    • Vous pouvez trouver les informations relatives aux assemblys à inscrire à l’aide de la commande gacutil /lr<assembly_name>.
    • Consultez bindingExtensions sur cet élément.

  3. Dans le Bloc-notes, enregistrez le fichier machine.config.

  4. Si vous avez plusieurs ordinateurs BizTalk Server runtime et des ordinateurs d’administration, répétez les étapes 1 à 3 de cette procédure sur tous les ordinateurs.

    Notes

    Vous devez répéter ces étapes sur tous les ordinateurs de l’infrastructure WCF afin de traiter le point d’extensibilité WCF pour le instance hôte BizTalk et la console Administration BizTalk Server.

Configurer une extension de liaison WCF à l’aide de la console d’administration BizTalk

  1. Ouvrez Administration de BizTalk Server.

    Notes

    Si la console Administration BizTalk Server est déjà ouverte, redémarrez la console Administration BizTalk Server.

  2. Si vous utilisez l’adaptateur WCF-Custom, dans la console administration BizTalk Server, développez Paramètres de plateforme, instances d’hôte, puis redémarrez l’hôte BizTalk instance l’exécution de l’adaptateur.

  3. Si vous utilisez l'adaptateur WCF-CustomIsolated, dans la console de gestion IIS, redémarrez le pool d'applications associé à l'emplacement de réception WCF.

  4. Si vous souhaitez configurer un emplacement de réception pour utiliser un point d’extensibilité WCF, dans la console d’administration BizTalk Server, développez Groupe BizTalk, application <BizTalk>, Emplacements de réception, puis dans le volet droit, double-cliquez sur <Emplacement> de réception.

    • Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la liste déroulante Type , sélectionnez WCF-Custom ou WCF-CustomIsolated en fonction de l’adaptateur WCF que vous souhaitez utiliser, puis cliquez sur Configurer.

  5. Si vous souhaitez configurer un port d’envoi pour utiliser un point d’extensibilité WCF, dans la console d’administration BizTalk Server, développez Groupe BizTalk, application <BizTalk>, Puis, dans le volet droit, double-cliquez sur <Envoyer le port>.

    • Dans la boîte de dialogue Propriétés du port d’envoi, dans la liste déroulante Type , sélectionnez WCF-Custom, puis cliquez sur Configurer.

  6. Dans la boîte de dialogue Propriétés de transport, sous l’onglet Liaison , sélectionnez l’extension de liaison, puis configurez le reste des paramètres pour le transport.

  7. Dans la console Administration BizTalk Server, fermez toutes les boîtes de dialogue ouvertes en cliquant sur les boutons OK, puis assurez-vous qu’aucun message d’erreur et journaux d’événements erronés n’apparaissent.

Configurer le fichier machine.config pour une extension d’élément de liaison WCF

  1. À l’invite de commandes, accédez à %FrameworkDir%\v4. Dossier X.XXXXX\CONFIG, puis ouvrez le fichier machine.config à l’aide du Bloc-notes.

  2. Dans le Bloc-notes, si le fichier machine.config ne contient pas les <éléments system.serverModel>\<extensions> , ajoutez ces éléments à l’intérieur de l’élément <de configuration> du fichier machine.config, puis ajoutez l’élément <bindingElementExtensions> pour une extension d’élément de liaison WCF à l’intérieur <des éléments system.serverModel>\<extensions> . Par exemple, pour activer une extension d’élément de liaison personnalisée, droppingInterceptor, ajoutez le code suivant dans l’élément <de configuration> du fichier machine.config :

    <system.serviceModel>  
  <extensions>  
    <bindingElementExtensions>  
      <add name="droppingInterceptor" type="Microsoft.ServiceModel.Samples.DroppingServerElement, MessageInterceptor, Version=0.0.0.0, Culture=neutral, PublicKeyToken=098514eef14aa34a"/>  
    </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>

    Notes

    • Vous pouvez trouver les informations relatives aux assemblys à inscrire à l’aide de la commande gacutil /lr<assembly_name>.
    • Consultez bindingElementExtensions sur cet élément.

  3. Dans le Bloc-notes, enregistrez le fichier machine.config.

  4. Si vous avez plusieurs ordinateurs BizTalk Server runtime et des ordinateurs d’administration, répétez les étapes 1 à 3 de cette procédure sur tous les ordinateurs.

    Notes

    Vous devez répéter ces étapes sur tous les ordinateurs de l’infrastructure WCF afin de traiter le point d’extensibilité WCF pour le instance hôte BizTalk et la console Administration BizTalk Server.

Configurer une extension d’élément de liaison WCF à l’aide de la console d’administration BizTalk

  1. Ouvrez Administration de BizTalk Server.

    Notes

    Si la console Administration BizTalk Server est déjà ouverte, redémarrez la console Administration BizTalk Server.

  2. Si vous utilisez l’adaptateur WCF-Custom, dans la console administration BizTalk Server, développez Paramètres de plateforme, instances d’hôte, puis redémarrez l’hôte BizTalk instance l’exécution de l’adaptateur.

  3. Si vous utilisez l'adaptateur WCF-CustomIsolated, dans la console de gestion IIS, redémarrez le pool d'applications associé à l'emplacement de réception WCF.

  4. Si vous souhaitez configurer un emplacement de réception pour utiliser un point d’extensibilité WCF, dans la console d’administration BizTalk Server, développez Groupe BizTalk, application <BizTalk>, Emplacements de réception, puis dans le volet droit, double-cliquez sur <Emplacement> de réception.

    • Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la liste déroulante Type , sélectionnez WCF-Custom ou WCF-CustomIsolated en fonction de l’adaptateur WCF que vous souhaitez utiliser, puis cliquez sur Configurer.

  5. Si vous souhaitez configurer un port d’envoi pour utiliser un point d’extensibilité WCF, dans la console d’administration BizTalk Server, développez Groupe BizTalk, application <BizTalk>, Puis, dans le volet droit, double-cliquez sur <Envoyer le port>.

    • Dans la boîte de dialogue Propriétés du port d’envoi, dans la liste déroulante Type , sélectionnez WCF-Custom, puis cliquez sur Configurer.

  6. Dans la boîte de dialogue propriétés de transport, sous l’onglet Liaison , dans la liste déroulante Type de liaison, sélectionnez customBinding.

  7. Dans la boîte de dialogue propriétés de transport, sous l’onglet Liaison , cliquez avec le bouton droit sur la zone cliente de la liste Liaison , puis cliquez sur Ajouter une extension.

  8. Dans la boîte de dialogue Sélectionner une extension d’élément de liaison, sélectionnez une extension d’élément de liaison, puis cliquez sur OK.

  9. Dans la boîte de dialogue propriétés de transport, sous l’onglet Liaison , ajustez l’ordre des éléments de liaison ajoutés dans la liste Liaison en fonction du type de l’extension d’élément de liaison que vous avez ajoutée à l’étape précédente comme suit :

    • Dans la liste Liaison , cliquez avec le bouton droit sur une extension d’élément de liaison, puis cliquez sur Déplacer l’extension vers le haut ou Déplacer l’extension vers le bas. L’extension d’élément de liaison la plus basse de la liste Binding correspond au composant inférieur de la pile de canaux. L’élément de liaison le plus élevé dans la liste Binding correspond au composant supérieur de la pile de communication.

      Notes

      Pour plus d’informations sur l’ordre spécifique des éléments de liaison pour la liaison personnalisée, consultez Liaisons personnalisées .

  10. Dans la boîte de dialogue Propriétés du transport, configurez le reste des paramètres de transport.

  11. Dans la console Administration BizTalk Server, fermez toutes les boîtes de dialogue ouvertes en cliquant sur les boutons OK, puis assurez-vous qu’aucun message d’erreur et journaux d’événements erronés n’apparaissent.

Configurer le fichier machine.config pour une extension de comportement WCF

  1. À l’invite de commandes, accédez à %FrameworkDir%\v4. Dossier X.XXXXX\CONFIG, puis ouvrez le fichier machine.config à l’aide du Bloc-notes.

  2. Dans le Bloc-notes, si le fichier machine.config ne contient pas les <éléments system.serverModel>\<extensions> , ajoutez ces éléments dans l’élément <de configuration> du fichier machine.config, puis ajoutez l’élément <behaviorExtensions> pour une extension de comportement WCF à l’intérieur des <éléments system.serverModel>\<extensions> . Par exemple, pour activer une extension de comportement personnalisé, schemaValidator, ajoutez le code suivant dans l’élément <de configuration> du fichier machine.config :

    <system.serviceModel>  
  <extensions>  
    <behaviorExtensions>  
      <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ad307e213604f592"/>  
    </behaviorExtensions>  
  </extensions>  
</system.serviceModel>

    Notes

    • Vous pouvez trouver les informations relatives aux assemblys à inscrire à l’aide de la commande gacutil /lr<assembly_name>.
    • Consultez behaviorExtensions sur cet élément.

  3. Dans le Bloc-notes, enregistrez le fichier machine.config.

  4. Si vous avez plusieurs ordinateurs BizTalk Server runtime et des ordinateurs d’administration, répétez les étapes 1 à 3 de cette procédure sur tous les ordinateurs.

    Notes

    Vous devez répéter ces étapes sur tous les ordinateurs de l’infrastructure WCF afin de traiter le point d’extensibilité WCF pour le instance hôte BizTalk et la console Administration BizTalk Server.

Configurer une extension de comportement WCF à l’aide de la console d’administration BizTalk

  1. Ouvrez Administration de BizTalk Server.

    Notes

    Si la console Administration BizTalk Server est déjà ouverte, redémarrez la console Administration BizTalk Server.

  2. Si vous utilisez l’adaptateur WCF-Custom, dans la console administration BizTalk Server, développez Paramètres de plateforme, instances d’hôte, puis redémarrez l’hôte BizTalk instance l’exécution de l’adaptateur.

  3. Si vous utilisez l'adaptateur WCF-CustomIsolated, dans la console de gestion IIS, redémarrez le pool d'applications associé à l'emplacement de réception WCF.

  4. Si vous souhaitez configurer un emplacement de réception pour utiliser un point d’extensibilité WCF, dans la console Administration BizTalk, développez Groupe BizTalk, application <BizTalk>, Emplacements de réception, puis dans le volet droit, double-cliquez sur <Emplacement> de réception.

    • Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la liste déroulante Type , sélectionnez WCF-Custom ou WCF-CustomIsolated en fonction de l’adaptateur WCF que vous souhaitez utiliser, puis cliquez sur Configurer.

  5. Si vous souhaitez configurer un port d’envoi pour utiliser un point d’extensibilité WCF, dans la console Administration BizTalk, développez Groupe BizTalk, Application <BizTalk>, Envoyer des ports, puis dans le volet droit, double-cliquez sur <Envoyer le port>.

    • Dans la boîte de dialogue Propriétés du port d’envoi, dans la liste déroulante Type , sélectionnez WCF-Custom, puis cliquez sur Configurer.

  6. Dans la boîte de dialogue propriétés de transport, sous l’onglet Comportement , cliquez avec le bouton droit sur ServiceBehavior ou EndpointBehavior en fonction du type de l’extension de comportement, puis, dans la boîte de dialogue Sélectionner une extension de comportement , sélectionnez l’extension de comportement, puis cliquez sur OK.

  7. Dans la boîte de dialogue Propriétés du transport, configurez le reste des paramètres de transport.

  8. Dans la console Administration BizTalk Server, fermez toutes les boîtes de dialogue ouvertes en cliquant sur les boutons OK, puis assurez-vous qu’aucun message d’erreur et journaux d’événements erronés n’apparaissent.

Configurer un emplacement de réception WCF-Custom avec un certificat SSL

  • Si un emplacement de réception WCF-Custom utilise le pilote en mode noyau HTTP (HTTP.sys), tel que l’élément de liaison httpsTransport , pour les communications SSL (Secure Sockets Layer), l’emplacement de réception doit avoir un certificat inscrit pour chaque socket (combinaison adresse IP/port). Utilisez l'outil HttpCfg.exe pour lier un certificat SSL à un port sur l'ordinateur. Pour plus d’informations, consultez Guide pratique pour configurer un port avec un certificat SSL.