Outil Éditeur de configuration (SvcConfigEditor.exe)

L'Éditeur de configuration de service Windows Communication Foundation (WCF) (SvcConfiEditor.exe) permet aux administrateurs et aux développeurs de créer et de modifier des paramètres de configuration pour les services WCF à l'aide d'une interface graphique utilisateur. Grâce à cet outil, vous pouvez gérer les paramètres des liaisons, des comportements, des services et des diagnostics WCF sans modifier directement les fichiers de configuration XML.

Éditeur de configuration WCF

L'Éditeur de configuration de service est fourni avec un Assistant qui vous guide à travers toutes les étapes de configuration d'un service ou d'un client WCF. Il est vivement recommandé d'utiliser l'Assistant au lieu d'utiliser directement l'éditeur.

Si vous avez déjà quelques fichiers de configuration conformes au schéma System.Configuration standard, vous pouvez gérer des paramètres spécifiques pour les liaisons, comportements, services et diagnostics avec l'interface utilisateur. L'Éditeur de configuration de service (SvcConfigEditor) vous permet de gérer les paramètres des fichiers de configuration WCF existants, ainsi que les fichiers exécutables, les services COM+ et les services hébergés sur le Web.

Les paramètres de configuration WCF sont situés dans la section <system.serviceModel> du fichier de configuration ; par conséquent, l'éditeur fonctionne exclusivement sur le contenu de cet élément et n'accède pas à d'autres éléments du même fichier.

Vous pouvez naviguer directement jusqu'aux fichiers de configuration existants ou vous pouvez sélectionner un assembly qui contient un service, un répertoire virtuel ou un service COM+. L'éditeur charge le fichier de configuration pour ce service particulier et autorise l'utilisateur à ajouter des nouveaux éléments ou à modifier des éléments existants imbriqués dans la section <system.serviceModel> du fichier de configuration.

L'éditeur prend en charge IntelliSense et applique la conformité de schéma. Le résultat est conformer au schéma du fichier de configuration et possède des valeurs de données correctes syntaxiquement. Toutefois, l'éditeur ne garantit pas que le fichier de configuration soit correct sur un plan sémantique. En d'autres termes, l'éditeur ne garantit pas que le fichier de configuration puisse fonctionner avec le service qu'il configure.

Attention :

L'éditeur ne peut pas supprimer un élément de configuration du fichier de configuration une fois que vous avez modifié l'élément. Par exemple, si vous utilisez l'éditeur pour affecter au nom de point de terminaison une chaîne non vide et pour l'enregistrer, le contenu du fichier de configuration est le suivant : <endpoint binding="basicHttpBinding" name="somename" /> Si vous tentez de supprimer le nom en lui affectant une chaîne vide et que vous enregistrez le fichier, le fichier de configuration contient toujours l'attribut name : <endpoint binding="basicHttpBinding" name="" /> Pour supprimer l'attribut, vous devez modifier manuellement l'élément à l'aide d'un autre éditeur de texte. Vous devez être particulièrement prudent avec ce problème lorsque vous utilisez l'élément issueToken du comportement de point de terminaison clientCredential. De façon spécifique, l'attribut address de son sous-élément localIssuer ne doit pas être une chaîne vide. Si vous avez modifié l'attribut address à l'aide de l'Éditeur de configuration et que vous souhaitez le supprimer complètement, vous devez pour cela utiliser un autre outil que l'Éditeur. Sinon, l'attribut contiendra une chaîne vide et votre application génèrera une exception.

Utilisation de l'Éditeur de configuration

L'Éditeur de configuration de service se trouve à l'emplacement d'installation du Kit de développement logiciel (SDK) Windows suivant :

C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe

Après avoir lancé l'Éditeur de configuration de service, vous pouvez utiliser le menu Fichier/Ouvrir pour rechercher le service ou l'assembly à gérer. Vous pouvez ouvrir des fichiers de configuration directement, rechercher des services WCF /COM + et ouvrir des fichiers de configuration pour des services hébergés par le Web.

L'interface utilisateur de l'Éditeur de configuration de service est divisée dans les zones suivantes :

• Volet (arborescence) qui affiche les éléments de configuration sous forme d'arbre. Vous pouvez exécuter des opérations dans l'arbre en cliquant avec le bouton droit sur les nœuds.
• Volet de tâches qui affiche les tâches courantes pour les éléments actifs.
• Volet Détail qui affiche les paramètres détaillés du nœud de configuration sélectionné dans l'arborescence.

Ouverture d'un fichier de configuration

1. Démarrez l'Éditeur de configuration de service en utilisant une fenêtre de commande pour accéder à votre emplacement d'installation WCF, puis tapez SvcConfigEditor.exe.
2. Dans le menu Fichier, sélectionnez Ouvrir et cliquez sur le type de fichier que vous souhaitez gérer.
3. Dans la boîte de dialogue Ouvrir, naviguez jusqu'au fichier spécifique que vous souhaitez gérer et double-cliquez sur celui-ci.

La visionneuse suit automatiquement le chemin d'accès de fusion de la configuration et crée une vue de la configuration fusionnée. Par exemple, la configuration réelle d'un service non hébergé est une combinaison de Machine.config et App.config. Toutes les modifications sont appliquées au fichier actif dans SvcConfigEditor. Si vous souhaitez modifier un fichier spécifique dans le chemin d'accès de fusion de la configuration, vous devez l'ouvrir directement.

Remarque :

L'Éditeur de configuration recharge le fichier de configuration actuellement ouvert lorsque ce dernier a été modifié à l'extérieur de l'Éditeur. Lorsque cela se produit, toutes les modifications non enregistrées dans l'Éditeur sont perdues. Si les rechargements sont fréquents, la cause la plus probable est l'accès constant d'un service au fichier de configuration (par exemple, un logiciel antivirus exécuté en arrière-plan). Pour y remédier, vérifiez que l'éditeur de configuration est l'unique processus autorisé à accéder au fichier lorsque celui-ci est ouvert.

Services

Le nœud Services affiche tous les services assignés actuellement dans le fichier de configuration. Chaque sous-nœud dans l'arbre correspond à un sous-élément de l'élément <services> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Services, vous pouvez afficher ou exécuter des tâches dans la page Résumé, dans le volet Détail.

Création d'une configuration de service

Vous pouvez créer une configuration de service de l'une des manières suivantes :

• À l'aide d'un Assistant : cliquez sur le lien Création d'un nouveau service sur le volet de tâches ou la page Résumé pour lancer l'Assistant. Vous pouvez également l'effectuer dans le menu Fichier -> Ajouter un nouvel élément.
• Manuellement : vous pouvez cliquer avec le bouton droit sur le nœud Services et choisir Nouveau service.

Création d'une configuration de point de terminaison de service

Vous pouvez créer une nouvelle configuration de point de terminaison de service de l'une des manières suivantes :

• À l'aide d'un Assistant : cliquez sur le lien Créer un nouveau point de terminaison de service dans le volet de tâches ou la page Résumé, pour lancer l'Assistant. Vous pouvez également l'effectuer dans le menu Fichier -> Ajouter un nouvel élément.
• Manuellement : une fois que vous avez créé un service, vous pouvez cliquer avec le bouton droit sur le nœud Points de terminaison et choisir Nouveau point de terminaison de service.

Modification d'une configuration de service

1. Cliquez sur un nœud Service.
2. Modifiez les paramètres dans les grilles de propriété.

Modification d'une configuration de points de terminaison de service

1. Cliquez sur un nœud Point de terminaison de service.
2. Modifiez les paramètres dans les grilles de propriété.

Ajout d'une adresse de base

1. Cliquez sur le nœud Hôte.
2. Cliquez sur le bouton Nouveau dans la section Adresses de base.
3. Entrez l'URI de l'adresse de base dans la boîte de dialogue.
4. Cliquez sur OK.

Remarque   Vous ne pouvez pas modifier la valeur de <baseAddressPrefixFilters> dans cet outil. Pour ajouter ou modifier cet élément, vous devez utiliser un éditeur de texte ou Visual Studio.

Client

Le nœud Client affiche tous les points de terminaison clients dans le fichier de configuration. Chaque sous-nœud dans l'arbre correspond à un sous-élément de l'élément <client> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Client, vous pouvez afficher ou exécuter des tâches sur la page Résumé du volet >Détail.

Création d'une configuration de point de terminaison client

Vous pouvez créer une configuration de point de terminaison client de l'une des manières suivantes :

• À l'aide d'un Assistant : cliquez sur le lien Créer un client… dans le volet de tâches ou dans la page Résumé pour lancer l'Assistant. Vous pouvez également l'effectuer dans le menu Fichier -> Ajouter un nouvel élément.
• Manuellement : cliquez avec le bouton droit sur le nœud Points de terminaison sous Client et sélectionnez Nouveau point de terminaison de client.

Modification d'une configuration de point de terminaison client

1. Cliquez sur un nœud Point de terminaison de client.
2. Modifiez les paramètres dans les grilles de propriété.

Liaison

Les configurations de liaison sont utilisées pour configurer des liaisons sur les points de terminaison. Ces paramètres de configuration sont stockés dans le nœud Liaison. Les points de terminaison référencent les configurations de liaison par nom et plusieurs points de terminaison peuvent référencer une configuration de liaison unique.

Le nœud Liaisons affiche tous les paramètres de liaison dans le fichier de configuration. Chaque sous-nœud dans l'arbre correspond à un sous-élément de l'élément <bindings> dans le fichier de configuration.

Lorsque vous cliquez sur le nœud Client, vous pouvez afficher ou exécuter des tâches dans la page Résumé du volet >Détail.

Création d'une configuration de liaison

Vous pouvez créer une configuration de liaison de l'une des manières suivantes :

• Cliquez avec le bouton droit sur le nœud Liaisons et sélectionnez Nouvelle configuration de liaison. ; ensuite, sélectionnez le type de liaison dans la boîte de dialogue et cliquez sur OK.
• Sélectionnez le nœud Liaisons et cliquez sur Nouvelle configuration de liaison dans le volet de tâches.
• Dans la page de service ou de résumé cliente, cliquez sur Cliquez ici pour créer dans le champ Configuration de liaison pour créer une configuration de liaison pour le point de terminaison correspondant.

Ajout d'extensions d'élément de liaison à une liaison personnalisée

1. Sélectionnez la liaison à laquelle vous souhaitez ajouter une extension d'élément.
2. Cliquez sur Ajouter.
3. Dans la liste d'extensions disponibles, sélectionnez l'extension d'élément de liaison que vous souhaitez ajouter. Vous pouvez sélectionner plusieurs éléments en appuyant simultanément sur la touche CTRL.
4. Cliquez sur Ajouter.

Ajustement de la position d'extensions dans une liaison personnalisée

Une liaison personnalisée est une collection d'éléments de liaison qui forment une pile. Chaque élément de liaison sur la pile possède ses propres paramètres de configuration. L'ordre des extensions d'élément de liaison dans une liaison personnalisée indique leur position dans la pile. Les éléments en haut de la pile sont appliqués en premier. Pour modifier l'ordre :

1. Sélectionnez le nœud de liaison personnalisé.
2. Sélectionnez un élément d'extension de liaison dans la section Position d'extension de l'élément de liaison.
3. Utilisez le bouton Haut ou Bas sur le côté gauche de la liste pour modifier la position de l'élément sélectionné.

Modification de la configuration d'extensions d'éléments de liaison dans une liaison personnalisée

1. Sélectionnez le nœud de liaison dans l'arbre.
2. Sélectionnez la liaison personnalisée qui contient l'élément que vous souhaitez modifier.
3. Sélectionnez l'extension d'élément de liaison que vous souhaitez modifier. Les paramètres de l'élément apparaissent dans le volet droit où ils peuvent être modifiés.

Comportements

Le nœud Comportements affiche les comportements définis actuellement dans le fichier de configuration.

Les configurations de comportement sont utilisées pour configurer des comportements de points de terminaison et de services. Ces paramètres de configuration sont stockés dans le nœud Avancé sous Comportements de service et Comportements du point de terminaison. Les comportements de service sont utilisés par les services, alors que les comportements de point de terminaison par les points de terminaison.

Les comportements représentent un ensemble d'éléments d'extension qui forment une pile. L'élément en haut de la pile est appliqué en premier. Chaque élément d'extension peut avoir sa propre configuration.

Création d'une configuration de comportement

Vous pouvez créer une nouvelle configuration de comportement de l'une des manières suivantes :

• Cliquez avec le bouton droit sur l'un des nœuds de comportement et sélectionnez Nouvelle configuration de comportement.
• Sélectionnez l'un des nœuds de comportement et cliquez sur New Behavior Configuration dans le volet de tâches.

Ajout d'extensions d'éléments de comportement à un comportement

1. Sélectionnez l'un des nœuds de comportement.
2. Sélectionnez le comportement que vous souhaitez modifier.
3. Cliquez sur Ajouter.
4. Dans la liste d'extensions disponibles, sélectionnez l'extension d'élément de comportement que vous souhaitez ajouter.
5. Cliquez sur Ajouter.

Ajustement de la position d'extension dans un comportement

Les comportements sont des collections d'élément qui forment une pile. Chaque élément sur la pile possède sa propre configuration. L'ordre des extensions d'éléments de comportement dans un comportement personnalisé indique leur position dans la pile. Les éléments en haut de la pile sont appliqués en premier. Pour modifier l'ordre :

1. Sélectionnez l'un des nœuds de comportement.
2. Sélectionnez le comportement que vous souhaitez modifier.
3. Sélectionnez un élément d'extension de comportement dans la section Position d'extension de l'élément de liaison.
4. Utilisez le bouton Haut ou Bas sur le côté gauche de la liste pour modifier la position de l'élément sélectionné.

Modification la configuration des extensions d'élément de comportement

1. Sélectionnez l'un des nœuds de comportement dans l'arbre.
2. Sélectionnez le comportement qui contient l'élément que vous souhaitez modifier.
3. Sélectionnez l'extension d'élément de comportement que vous souhaitez modifier. Les paramètres de l'élément apparaissent dans le volet droit où ils peuvent être modifiés.

Extensions

Les nouvelles extensions de liaison, les extensions d'élément de liaison et les extensions de comportement peuvent être enregistrées en vue d'une utilisation dans la configuration WCF. Les extensions sont des paires de nom/type. Le nom définit le nom de l'extension dans la configuration, alors que le type implémente l'extension. Il existe trois types d'extension :

• Les extensions de liaison définissent un type de liaison entier. Par exemple : basicHttpBinding
• Les extensions d'élément de liaison définissent un élément d'une liaison. Par exemple : textMessageEncoding
• Les extensions d'élément de comportement définissent un élément d'un comportement. Par exemple : clientVia

Les extensions inscrites dans la configuration peuvent être utilisées comme tout autre composant WCF du même type.

Ajout d'une nouvelle extension

Sélectionnez l'un des nœuds d'extension parmi les nœuds avancés.

1. Cliquez sur Nouveau.
2. Entrez un nom et un type.
3. Cliquez sur OK.
4. L'extension apparaît maintenant dans l'éditeur à l'endroit approprié. Par exemple, si vous ajoutez une extension d'élément de comportement, elle apparaît dans la liste des extensions disponibles.

Diagnostics

Le nœud Diagnostics affiche tous les paramètres de diagnostic dans le fichier de configuration. Permet d'activer ou de désactiver des compteurs de performances et Windows Management Instrumentation (WMI), de configurer le traçage WCF et de configurer l'enregistrement de messages WCF. Les paramètres du nœud Diagnostic correspondent à la section <system.diagnostics> et à la section <diagnostics> du <system.serviceModel> fichier de configuration.

Lorsque vous cliquez sur le nœud Diagnostics, vous pouvez afficher ou exécuter des tâches dans la page Résumé du volet Détail.

Configuration des compteurs de performance et de WMI

1. Cliquez sur le nœud Diagnostics.
2. Cliquez sur Basculer les compteurs de performance. Le compteur de performance peut avoir trois états : Off (valeur par défaut), ServiceOnly et All. Il est possible de basculer entre les trois états en cliquant sur le lien.

Configuration d'un fournisseur WMI

1. Cliquez sur le nœud Diagnostics.
2. Pour activer un fournisseur WMI, cliquez sur le lien Activer le fournisseur WMI.

Activation du suivi WCF

Vous pouvez créer un fichier de suivi WCF avec des propriétés standard ou configurer un fichier de suivi personnalisé.

1. Cliquez sur le nœud Diagnostics.
2. Cliquez sur Activer le suivi.
3. Cliquez sur le lien Niveau de suivi pour ajuster le niveau de suivi. Six niveaux de suivi sont disponibles : Fermé, Critique, Erreur, Avertissement, Information et Commentaires. Les options Suivi d'activité et Propager l'activité vous permettent d'utiliser la fonctionnalité de suivi d'activité WCF.
4. Cliquez sur le nom de l'écouteur de suivi pour spécifier le fichier et les options de suivi.

Activation de la journalisation WCF

Vous pouvez créer un fichier de suivi WCF avec des propriétés standard ou configurer un fichier de suivi personnalisé.

1. Cliquez sur le nœud Diagnostics.
2. Cliquez sur Activer la journalisation des messages
3. Cliquez sur le lien Niveau du journal pour ajuster le niveau du journal. Il existe trois niveaux de journal : Messages malformés, Service et Transport.
4. Cliquez sur le nom de l'écouteur pour spécifier le fichier journal et les options de suivi.

Remarque :
Si vous souhaitez que les journaux de suivi et des messages soient supprimés automatiquement lorsque vous fermez l'application, activez l'option Effacement automatique des journaux.

La page Résumé des Diagnostics vous permet d'accomplir les tâches les plus courantes pour configurer les diagnostics. Toutefois, si vous souhaitez modifier les paramètres des écouteurs et des sources manuellement, vous devez développer le nœud Diagnostics et modifier les paramètres dans les nœuds Journalisation des messages, Écouteurs et Sources.

Activation de la journalisation des messages ou le suivi personnalisé de WCF

1. Cliquez sur le nœud Diagnostics et développez-le.
2. Cliquez avec le bouton droit sur le nœud Écouteurs et sélectionnez Nouvel écouteur.
3. Entrez le nom de fichier de suivi dans le champ InitData. Vous pouvez cliquer sur le bouton … pour naviguer jusqu'à un chemin d'accès.
4. Si vous cliquez sur la ligne TypeName, un bouton…s'affiche. Cliquez sur ce bouton pour ouvrir l'Explorateur de types d'écouteur de suivi que vous pouvez utiliser pour rechercher des écouteurs de suivi préconfigurés qui sont déjà installés.
5. Notez la section Source. Cliquez sur Ajouter dans cette section pour ouvrir une boîte de dialogue avec un menu déroulant qui répertorie des sources de suivi disponibles. Sélectionnez une source de suivi et cliquez sur OK.
6. Pour modifier les paramètres de journalisation des messages, cliquez sur le nœud Journalisation des messages. Vous pouvez modifier les paramètres dans la grille des propriétés.

Création d'un fichier de configuration à l'aide de l'Assistant

Pour créer un fichier de configuration, vous pouvez notamment utiliser l'Assistant Nouvel élément de service. L'Assistant recherche les types de service installés et d'autres éléments compatibles avec Windows Communication Foundation (WCF) sur l'ordinateur, y compris les répertoires virtuels hébergés sur le Web et les répertoires COM+, et il les charge pour simplifier la création du fichier de configuration.

Création d'un fichier de configuration

1. Démarrez l'Éditeur de configuration de service en utilisant une fenêtre de commande pour accéder à votre emplacement d'installation WCF, puis tapez SvcConfigEditor.exe.
2. Dans le menu Fichier, sélectionnez Ouvrir et cliquez sur Exécutable, Service COM+ ou Service hébergé sur le Web, selon le type de fichier de configuration que vous souhaitez créer.
3. Dans la boîte de dialogue Ouvrir, naviguez jusqu'au fichier spécifique pour lequel vous souhaitez créer un fichier de configuration et double-cliquez sur celui-ci.
4. Dans le menu Fichier, pointez vers Ajouter un nouvel élément et cliquez sur Service. L'Assistant Nouvel élément de service s'ouvre.
5. Suivez les étapes de création de service dans l'Assistant.

Remarque :
Si vous souhaitez utiliser NetPeerTcpBinding inclus dans le fichier de configuration (généré par l'Assistant), vous devez ajouter manuellement un élément de configuration de liaison et modifier l'attribut mode de son élément security en spécifiant "Aucun."

Configuration de COM+

L'Éditeur de configuration de service vous permet de créer un fichier de configuration pour une application COM+ existante ou de modifier une configuration COM+ existante. Le nœud Contrat COM est visible uniquement lorsque la section <comContract> existe dans le fichier de configuration.

Création d'une nouvelle configuration COM+

Avant de créer une configuration COM+, assurez-vous que votre application COM+ est installée dans les services de composants et enregistrée dans le Global Assembly Cache (GAC).

1. Sélectionnez le menu Fichier -> Intégrer -> Application COM+. Cette opération ferme le fichier actuellement ouvert. Si des données ne sont pas enregistrées dans le fichier actif, une boîte de dialogue d'enregistrement apparaît. Puis, l'Assistant Intégration COM+ est lancé.
2. Dans la première page, sélectionnez l'application COM+ de l'arbre. Si vous ne trouvez pas votre application COM+ dans l'arbre, vérifiez qu'il est installé dans les services de composants et enregistré dans le Global Assembly Cache (GAC).
3. Dans la page suivante, sélectionnez les méthodes que vous souhaitez exposer en tant que services WCF. Toutes les méthodes prises en charge dans l'application COM+ sont affichées et sélectionnées par défaut.
4. Choisissez une méthode d'hébergement.
5. Configurez d'autres paramètres conformément aux indications de l'Assistant.
6. L'Éditeur de configuration de service utilise ComSvcConfig.exe en arrière-plan pour générer un fichier de configuration. Une fois terminé, vous pouvez consulter un résumé et quitter l'Assistant. Le fichier de configuration généré est ouvert afin que vous puissiez le modifier directement.

Modification d'une configuration COM+ existante

1. Sélectionnez le menu Fichier -> Ouvrir -> Service COM+.
2. Sélectionnez le service COM+ que vous souhaitez modifier dans la liste.
3. Modifiez les paramètres de configuration dans le nœud Contrats COM.

   Remarque :
   Vous pouvez également ouvrir et modifier directement un fichier de configuration qui contient des contrats COM+.

Sécurité

Le caractère sécurisé des fichiers de configuration de service générés par l'Éditeur de configuration n'est pas garanti. Consultez la documentation Windows Communication Foundation Security pour plus d'informations sur la méthode permettant de sécuriser vos services WCF.

De plus, l'Éditeur de configuration peut être utilisé uniquement pour lire et écrire des éléments de configuration WCF valides. Cet outil ignore les éléments conformes à des schémas, définis par l'utilisateur. Il ne tente pas non plus de supprimez ces éléments du fichier de configuration ou de déterminer leurs effets sur les éléments WCF connus. Il incombe à l'utilisateur de déterminer si ces éléments font peser une menace à l'application ou au système.