Opzioni di configurazione per i servizi Web XML creati tramite ASP.NET

Questo argomento è specifico di una tecnologia legacy. Servizi Web XML e client di servizi Web XML devono essere creati attualmente tramite Windows Communication Foundation.

La configurazione dei servizi Web segue lo stesso modello utilizzato da tutte le applicazioni Web ASP.NET. La configurazione di ASP.NET è un'architettura di configurazione di file di testo basata su XML potente ed estensibile. Un file di configurazione è semplicemente un set di elementi XML che rappresenta le opzioni di configurazione per una funzionalità tecnica specifica di Microsoft .NET Framework. Nel caso dei servizi Web, le opzioni di configurazione appaiono all'interno dell'elemento XML webServices di un file di configurazione. Per un elenco completo delle opzioni di configurazione disponibili per i servizi Web, vedere il Elemento <webServices>.

Configurazione dei protocolli di messaggistica e pagina della Guida del servizio

I protocolli di messaggistica e la pagina della Guida del servizio per i servizi Web sono configurabili nell'elemento XLM Elemento <protocols>Elemento <webServices> sotto l'elemento del file di configurazione. La configurazione viene realizzata aggiungendo Elemento <add> per <protocols>Elemento <remove> per <protocols> e per ogni impostazione che specifica se l'impostazione è disponibile nell'ambito del file di configurazione. L'elemento add aggiunge in modo esplicito supporto per un'impostazione nell'ambito del file di configurazione, mentre l'elemento remove rimuove supporto aggiunto più in alto nella gerarchia di configurazione. Ad esempio, un'impostazione del protocollo può essere aggiunta al livello di computer con l'elemento add nel file Machine.config e in seguito può essere rimossa per un'applicazione Web con un elemento remove in un file Web.config. Qui di seguito viene riportata la sintassi per gli elementi add e remove:

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

L'attributo name degli elementi add e remove ha le seguenti opzioni.

Impostazione	Descrizione
HttpSoap	Controlla il supporto SOAP su protocollo HTTP per i servizi Web. L'installazione aggiunge supporto per impostazione predefinita.
HttpGet	Controlla il supporto del protocollo HTTP-GET per i servizi Web. L'installazione non aggiunge supporto per impostazione predefinita.
HttpPost	Controlla il supporto del protocollo HTTP-POST per i servizi Web indipendentemente dall'origine della richiesta. L'installazione non aggiunge supporto per impostazione predefinita.
HttpPostLocalhost	Controlla il supporto del protocollo HTTP-POST per i servizi Web quando la richiesta proviene da una macchina locale. Se HttpPost viene aggiunto alla configurazione corrente, questa impostazione non ha effetto. L'installazione aggiunge supporto per impostazione predefinita.
Documentation	Specifica se una pagina della Guida del servizio viene visualizzata quando un utente si sposta in un'URL per un servizio Web senza nessun parametro nel browser. L'installazione aggiunge supporto per impostazione predefinita. La configurazione del protocollo Documentation verrà descritta successivamente in questo stesso argomento.

Nota:
.NET Framework versione 1.0 supporta le impostazioni HttpSoap, HttpGet, HttpPost e Documentation. Sono tutte abilitate al livello di computer per impostazione predefinita.

Configurazione del protocollo Documentazione

Navigare in un'URL per i servizi Web senza parametri in un browser Web consente a un client di visualizzare la pagina della Guida del servizio per il servizio Web, se il servizio è configurato a tale scopo. La pagina della Guida del servizio contiene, per impostazione predefinita, informazioni leggibili dall'uomo su come comunicare con il servizio Web e con i metodi del servizio Web che espone.

Poiché la pagina della Guida del servizio è semplicemente un Web Form ASP.NET, può essere sostituita o modificata e può includere elementi come ad esempio il logo di un'azienda. Il nome del file della pagina della Guida del servizio è specificato nel Elemento <wsdlHelpGenerator> di un file di configurazione con un'impostazione predefinita DefaultWsdlHelpGenerator.aspx specificata nel file Machine.config.

La pagina della Guida del servizio viene visualizzata solo per i servizi Web nell'ambito di un file di configurazione che ha il protocollo Documentation specificato all'interno dell'elemento Elemento <protocols>. Per impostazione predefinita, il protocollo Documentation è specificato nel file Machine.config. Vedere procedura: disabilitare la pagina della Guida del servizio per un servizio Web.

Sicurezza

Prima di abilitare i protocolli HTTP-GET o HTTP-POST per un servizio Web, è necessario essere consapevoli che così facendo lo si potrebbe esporre a una chiamata accidentale. Ad esempio, un utente ignaro potrebbe ricevere per posta elettronica un'e-mail con un collegamento che, quando selezionato, richiama il servizio Web per conto dell'utente utilizzando i parametri forniti nell'e-mail. È necessario verificare che tali chiamate non siano dannose prima di abilitare i protocolli HTTP-GET o HTTP-POST.

Vedere anche

Attività

Procedura: disabilitare il supporto per il protocollo per i servizi Web
Procedura: disabilitare la pagina della Guida del servizio per un servizio Web
Procedura: abilitare l'individuazione per i servizi Web XML

Concetti

Distribuzione di servizi Web XML

Altre risorse

Compilazione di servizi Web XML mediante ASP.NET