Options de configuration pour les services Web XML créés à l'aide d'ASP.NET

La configuration de services Web suit le même modèle que toutes les applications Web ASP.NET. La configuration ASP.NET est une architecture de configuration de fichiers texte basée sur XML, à la fois puissante et extensible. Un fichier de configuration est simplement un jeu d'éléments XML qui représente les options de configuration d'une fonctionnalité technique spécifique du Microsoft .NET Framework. Dans le cas de services Web, les options de configuration apparaissent dans l'élément XML webServices d'un fichier de configuration. Pour obtenir une liste complète des options de configuration disponibles pour les services Web, consultez le <webServices>, élément.

Configuration des protocoles de messagerie et page d'aide du service

Les protocoles de messagerie et la page d'aide des services Web sont configurables dans l'élément XML <protocols>, élément sous le <webServices>, élément des fichiers de configuration. La configuration s'effectue par l'ajout de <add>, élément de <protocols> et <remove>, élément de <protocols> pour chaque paramètre, qui spécifient si le paramètre est disponible pour la portée du fichier de configuration. L'élément add ajoute explicitement la prise en charge pour ce paramètre pour la portée du fichier de configuration, alors que l'élément remove supprime la prise en charge ajoutée plus haut dans la hiérarchie de configuration. Par exemple, un paramètre de protocole peut être ajouté au niveau de l'ordinateur avec un élément add dans le fichier Machine.config puis peut être supprimé pour une application Web avec un élément remove dans un fichier Web.config. Les éléments add et remove emploient la syntaxe suivante :

<{add|remove} name="protocol name" />

L'attribut name des éléments add et remove est doté des options suivantes :

Paramètre	Description
HttpSoap	Contrôle la prise en charge du SOAP via le protocole HTTP pour les services Web. L'installation ajoute la prise en charge par défaut.
HttpGet	Contrôle la prise en charge du protocole HTTP-GET pour les services Web. L'installation n'ajoute pas la prise en charge par défaut.
HttpPost	Contrôle la prise en charge du protocole HTTP-POST pour les services Web indépendamment de la provenance de la demande. L'installation n'ajoute pas la prise en charge par défaut.
HttpPostLocalhost	Contrôle la prise en charge du protocole HTTP-POST pour les services Web lorsque la demande provient de l'ordinateur local. Si HttpPost est ajouté à la configuration actuelle, ce paramètre n'a aucun effet. L'installation ajoute la prise en charge par défaut.
Documentation	Spécifie si une page d'aide du service est affichée lorsqu'un utilisateur navigue jusqu'à l'URL d'un service Web sans paramètre dans un navigateur. L'installation ajoute la prise en charge par défaut. La configuration du protocole Documentation est décrite plus en détails dans la suite de cette rubrique.

Remarque :
Le .NET Framework version 1.0 prend en charge les paramètres HttpSoap, HttpGet, HttpPostet Documentation et tous sont activés par défaut au niveau de l'ordinateur.

Configuration du protocole Documentation

La navigation jusqu'à l'URL du service Web sans paramètre dans un navigateur Web permet à un client de consulter la page d'aide du service Web, si la configuration du service le permet. La page d'aide du service contient, par défaut, des informations lisibles par les humains sur la façon de communiquer avec le service Web et les méthodes de service Web qu'il expose.

Étant donné que la page d'aide du service est simplement un formulaire Web ASP.NET, elle peut être remplacée ou modifiée pour inclure des éléments tels qu'un logo de société. Le nom de fichier de la page d'aide du service est spécifié dans le <wsdlHelpGenerator>, élément d'un fichier de configuration avec un paramètre par défaut de DefaultWsdlHelpGenerator.aspx spécifié dans le fichier Machine.config.

La page d'aide du service est affichée uniquement pour les services Web dans la portée d'un fichier de configuration dont le protocole Documentation est spécifié dans le <protocols>, élément. Par défaut, le protocole Documentation est spécifié dans le fichier Machine.config. Consultez Comment : désactiver la page d'aide d'un service Web.

Sécurité

Avant d'activer les protocoles HTTP-GET ou HTTP-POST pour un service Web, vous devez savoir que cela peut l'exposer à appel accidentel. Par exemple, un utilisateur naïf pourrait recevoir un message électronique contenant un lien qui, lorsqu'on clique dessus, appelle le service Web de la part de l'utilisateur à l'aide des paramètres fournis dans le message électronique. Vous devez réfléchir si de tels appels peuvent être nuisibles avant d'activer les protocoles HTTP-GET ou HTTP-POST.

Voir aussi

Tâches

Comment : désactiver la prise en charge de protocoles pour les services Web
Comment : désactiver la page d'aide d'un service Web
Comment : activer la découverte pour les services Web XML

Concepts

Déploiement des services Web XML

Autres ressources

Création de services Web XML à l'aide d'ASP.NET

Copyright ©2007 par Microsoft Corporation. Tous droits réservés.