Configuration des services WCF publiés à l'aide de l'Assistant Publication de services WCF BizTalk

Après la publication de services WCF avec l'Assistant Publication de services WCF BizTalk, vous devez les configurer correctement. Cette rubrique explique comment configurer les services WCF publiés.

Pour configurer les emplacements de réception pour un service WCF publié

1. Publiez le projet BizTalk en exécutant l'Assistant Publication de services WCF BizTalk.

2. Si vous n’avez pas sélectionné l’option Créer des emplacements de réception BizTalk dans la figure suivante lors de la création du service WCF, créez un port de réception et un emplacement de réception pour le service WCF publié, puis sélectionnez l’adaptateur WCF pour le type de transport que l’emplacement de réception utilisera. Vous devez sélectionner le même adaptateur WCF que celui sélectionné dans la page Type de service WCF illustrée dans la figure suivante. Pour plus d’informations sur la création d’un emplacement de réception, consultez Création d’un emplacement de réception.

   Notes

   L'Assistant Publication de services WCF BizTalk crée un fichier de liaison, BindingInfo.xml, dans le dossier \App_Data\Temp du répertoire Web pour le service WCF publié (fichier .svc). Si vous sélectionnez l’option Créer des emplacements de réception BizTalk , l’Assistant utilise le fichier de liaison pour créer l’emplacement de réception. Dans la console Administration de BizTalk Server, vous pouvez importer ce fichier de liaison pour créer l'emplacement de réception manuellement. Pour plus d’informations sur l’importation d’un fichier de liaison, consultez Importation de liaisons.

   

3. Si nécessaire, ouvrez la console d’administration BizTalk Server comme suit : Cliquez sur Démarrer, pointez sur Programmes, pointez sur Microsoft BizTalk Server, puis cliquez sur administration BizTalk Server.

4. Dans l’arborescence de la console, développez BizTalk Server Administration, groupe BizTalk, Applications, développez l’application où le service WCF généré doit être placé, développez Emplacements de réception, puis double-cliquez sur l’emplacement de réception du service WCF.

5. Dans la boîte de dialogue Propriétés de l’emplacement de réception, cliquez sur Configurer.

6. Si l’emplacement de réception héberge l’adaptateur WCF-BasicHttp ou WCF-WSHttp, dans la boîte de dialogue Propriétés du transport , cliquez sur l’onglet Sécurité , puis configurez les propriétés de sécurité sous l’onglet . Si l’emplacement de réception héberge l’adaptateur WCF-CustomIsolated, dans la boîte de dialogue Propriétés de transport , cliquez sur l’onglet Liaison , puis configurez les informations de liaison sous l’onglet .

   

   Notes

   La propriété Type d'informations d'identification du client du transport pour l'adaptateur WCF isolé doit correspondre au schéma d'authentification du répertoire virtuel Internet Information Services (IIS) hébergeant cet emplacement de réception. Par exemple, si la propriété est définie sur Windows, vous devez également activer les Authentification Windows intégrées pour le répertoire virtuel qui héberge cet emplacement de réception. 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. Pour plus d’informations sur la configuration des propriétés de sécurité pour les adaptateurs WCF-BasicHttp et WCF-WSHttp, consultez Adaptateur WCF-BasicHttp et Configuration d’un emplacement de réception WCF-WSHttp. Pour plus d’informations sur la configuration des informations de liaison, consultez How to Configure a WCF-CustomIsolated Receive Location.

7. Si vous n’avez pas sélectionné l’option Créer des emplacements de réception BizTalk lors de la création des services WCF, dans la boîte de dialogue Propriétés du transport , cliquez sur l’onglet Général . Sous l’onglet Général , tapez l’URI de cet emplacement de réception dans la zone de texte Adresse . Spécifiez le répertoire virtuel et le nom de fichier .svc que l’Assistant Publication du service WCF BizTalk a généré dans la procédure précédente. Par exemple, entrez /path/service.svc.

   Notes

   La propriété Address doit commencer par une barre oblique (« / ») et se terminer par « .svc ». La propriété Address ne doit pas contenir un schéma de protocole, un nom d’ordinateur ou un numéro de port tel que http://host:port. Seul le chemin d'accès du répertoire virtuel peut être utilisé pour la propriété. Le fichier de balisage du service WCF doit avoir une extension .svc.

   

8. Si vous avez sélectionné Transport ou TransportWithMessageCredential dans la liste déroulante Mode de sécurité de l’onglet Sécurité pour les adaptateurs WCF-BasicHttp et WCF-WSHttp, vous devez configurer SSL (Secure Sockets Layer) dans IIS. Si vous définissez le mode de sécurité Transport ou TransportWithMessageCredential dans les informations de liaison de l’adaptateur WCF-CustomIsolated, vous devez également configurer SSL dans IIS.

9. Si l’emplacement de réception héberge l’adaptateur WCF-BasicHttp ou WCF-WSHttp, dans la boîte de dialogue Propriétés du transport , configurez les onglets Général, Liaison et Messages si nécessaire. Si l’emplacement de réception héberge l’adaptateur WCF-CustomIsolated, configurez les onglets Général, Comportement, Autre et Messages pour votre usage. Pour l’adaptateur WCF-CustomIsolated, vous pouvez importer les propriétés Adresse (URI) et Endpoint Identity sous l’onglet Général , les informations de liaison sous l’onglet Liaison et les comportements sous l’onglet Comportement de cet emplacement de réception à partir d’un fichier de configuration.

10. Activez l'emplacement de réception pour le service WCF publié à l'aide de la console Administration de BizTalk Server. Pour plus d’informations sur l’activation de l’emplacement de réception, consultez Activer un emplacement de réception.

    Notes

    Les emplacements de réception sont désactivés lors de leur création. Après avoir créé les emplacements de réception avec l'Assistant Publication de services WCF de BizTalk Server, vous devez les activer.

11. Configurez le pool d'applications IIS pour héberger l'emplacement de réception pour le service WCF publié à l'aide de la console de gestion IIS. Pour plus d’informations sur la configuration du pool d’applications pour les adaptateurs WCF isolés, consultez Configuration d’IIS pour les adaptateurs de réception WCF isolés.

12. Ouvrez une invite de commandes, accédez au dossier du service WCF créé par l'Assistant Publication de services WCF BizTalk Server dans %SystemDrive%\InetPub\, puis ouvrez le fichier Web.config à l'aide du Bloc-notes.

13. Dans le Bloc-notes, ajoutez la ligne suivante à l’intérieur de l’élément <system.web> :

    <trust level="Full" originUrl="" />
    

    Notes

    Ce paramètre est facultatif. Il autorise l'accès de l'application ASP.NET hébergeant le service WCF publié à n'importe quelle ressource exposée à la sécurité du système d'exploitation. Il s'agit du niveau de confiance requis par les services WCF publiés lorsque Windows SharePoint Services est installé et exécuté sur l'ordinateur sur lequel ceux-ci sont hébergés.

14. Dans Internet Explorer, dans la zone Adresse, tapez l’URL du service WCF au format http:// host[:p ort]/apppath/wcfservicename.svc pour tester le service WCF publié. Ces paramètres sont décrits dans le tableau suivant.

    Paramètre	Valeur
    host[:p ort]	Nom de l'ordinateur sur lequel vous avez déployé votre service WCF. Le nom du serveur peut être suivi de deux points et du numéro du port.
    apppath	Nom du répertoire virtuel et chemin d'accès à l'application Web
    nomservicewcf.svc	Nom du fichier .svc du service WCF.

15. Pour empêcher toute divulgation non intentionnelle de métadonnées de service potentiellement sensibles, il est recommandé de désactiver ce comportement dans un environnement de production en procédant comme suit :

    1. Dans le Bloc-notes, ouvrez le fichier Web.config situé dans le dossier dans lequel l'Assistant Publication de services WCF BizTalk Server a créé le service WCF dans %SystemDrive%\InetPub\.

    2. Dans le Bloc-notes, définissez l’attribut httpGetEnabled dans l’élément <serviceMetadata> sur false comme ligne suivante :

       <serviceMetadata httpGetEnabled="false" httpsGetEnabled="false" />
       

Voir aussi

Configuration de l’adaptateur WCF-BasicHttpConfiguration de l’adaptateur WCF-WSHttpConfiguration de l’adaptateur WCF-CustomIsolatedComment configurer l’authentification de site web IIS dans Windows Server 2003