Configuración de opciones para los servicios web XML creados con ASP.NET

Este tema es específico de una tecnología heredada. Ahora, los servicios Web XML y los clientes de servicios Web XML deben crearse con Windows Communication Foundation.

La configuración de servicios Web sigue el mismo modelo utilizado por todas las aplicaciones Web ASP.NET. La configuración de ASP.NET es una arquitectura de configuración de archivo de texto basada en XML, que es eficaz y extensible. Un archivo de configuración simplemente es un conjunto de elementos XML que representa las opciones de configuración para una característica técnica concreta de la Microsoft .NET Framework. En el caso de servicios Web, las opciones de configuración aparecen dentro del elemento XML webServices de un archivo de configuración. Para una lista completa de las opciones de configuración disponible para los servicio Web, vea <webServices> (elemento).

Configurar protocolos de mensajería y la página de ayuda del servicio

Los protocolos de mensajería y la página de ayuda del servicio para los servicios Web se pueden configurar en el elemento XML <protocols> (elemento)<webServices> (elemento) inferior al de archivos de configuración. La configuración se hace agregando <add> (elemento) para <protocols><remove> (elemento) para <protocols> y para cada valor, los cuales especifican si el valor está disponible para el ámbito del archivo de configuración. El elemento add agrega explícitamente la compatibilidad para ese valor en el ámbito del archivo de configuración, mientras que el elemento remove quita compatibilidad agregada en un nivel superior en la jerarquía de configuración. Por ejemplo, un valor protocolar se puede agregar en el nivel del equipo con un elemento add en el archivo Machine.config y, a continuación, se puede quitar para una aplicación web con un elemento remove en un archivo Web.config. La sintaxis de los elementos add y remove es la siguiente:

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

El atributo name de los elementos add y remove tiene las siguientes opciones:

Configuración	Descripción
HttpSoap	Controla compatibilidad del SOAP sobre el protocolo HTTP para servicios Web. La instalación agrega compatibilidad de forma predeterminada.
HttpGet	Controla la compatibilidad del protocolo HTTP-GET para servicios Web. La instalación no agrega de forma predeterminada compatibilidad.
HttpPost	Controla compatibilidad del protocolo HTTP-POST para servicios Web sin tener en cuenta el origen de la solicitud. La instalación no agrega de forma predeterminada compatibilidad.
HttpPostLocalhost	Controla la compatibilidad del protocolo HTTP-POST para servicios Web cuando la solicitud se origina en el equipo local. Si HttpPost se agrega a la configuración actual, entonces este valor no tiene ningún efecto. La instalación agrega compatibilidad de forma predeterminada.
Documentation	Especifica si se muestra una página de ayuda del servicio cuando un usuario navega a la dirección URL para un servicio Web sin ningún parámetro en un examinador. La instalación agrega compatibilidad de forma predeterminada. Configurar el protocolo Documentation se describe más adelante en este tema.

Nota:
La versión 1.0 de .NET Framework admite HttpSoap, HttpGet, HttpPosty los valores Documentation y todos están habilitados de forma predeterminada a nivel de equipo.

Configurar el protocolo de documentación

Navegar a la dirección URL para el servicio Web sin ningún parámetro en un explorador web permite a un cliente ver la página de ayuda del servicio para el servicio Web, si el servicio se configura para ello. La página de ayuda del servicio contiene, de forma predeterminada, información legible en lenguaje natural sobre cómo comunicar con el servicio Web y los métodos de servicio Web que expone.

Dado que la página de ayuda del servicio simplemente es un Formulario Web Forms ASP.NET, se puede reemplazar o modificar para incluir elementos como un logotipo de organización. El nombre de archivo para la página de ayuda del servicio se especifica en el<wsdlHelpGenerator> (elemento) de un archivo de configuración con una configuración predeterminada de DefaultWsdlHelpGenerator.aspx especificada en el archivo Machine.config.

La página de ayuda del servicio solo se muestra para servicios Web dentro del ámbito de un archivo de configuración que tiene el protocolo Documentation especificado dentro del<protocols> (elemento). De forma predeterminada, el protocolo Documentation se especifica en el archivo Machine.config. Consulte cómo: Deshabilitar la página de ayuda del servicio de un servicio Web.

Seguridad

Antes de habilitar los protocolos HTTP-GET o HTTP-POST para un servicio Web, debería ser consciente que al hacer esto podría exponerlo a una invocación por error. Por ejemplo, un usuario confiado podría recibir el correo electrónico con un vínculo en el que, cuando se hace clic, invoca el servicio Web en nombre del usuario utilizando los parámetros proporcionados en el correo electrónico. Debería considerar si tales invocaciones podrían ser perjudiciales antes de habilitar los protocolos HTTP-GET o HTTP-POST.

Vea también

Tareas

Cómo: deshabilitar la compatibilidad con protocolos para servicios Web
Cómo: deshabilitar la página de ayuda del servicio para un servicio Web
Cómo: habilitar detección para servicios Web de XML

Conceptos

Cómo: implementar los servicios Web de XML

Otros recursos

Cómo: generar servicios Web de XML mediante ASP.NET