Migrazione dei servizi Web WSE 3.0 a WCF
La migrazione dei servizi Web WSE 3.0 a Windows Communication Foundation (WCF) comporta diversi vantaggi, fra cui il miglioramento delle prestazioni, il supporto di trasporti e scenari di sicurezza aggiuntivi nonché la possibilità di applicare le specifiche WS-*. In particolare, la migrazione di un servizio Web da WSE 3.0 a WCF può comportare un miglioramento delle prestazioni compreso fra 200% e 400%. Per ulteriori informazioni sui trasporti supportati da WCF, vedere Scelta di un trasporto. Per un elenco degli scenari supportati da WCF, vedere Scenari di sicurezza comuni. Per un elenco delle specifiche supportate da WCF, vedere Guida di interoperabilità dei protocolli di servizi Web.
Nelle sezioni seguenti vengono fornite indicazioni su come eseguire la migrazione di funzionalità specifiche di un servizio Web da WSE 3.0 a WCF.
Indicazioni generali
Le applicazioni WSE 3.0 e WCF prevedono l'interoperabilità a livello di trasmissione e un set comune di terminologia. L'interoperabilità a livello di trasmissione delle applicazioni WSE 3.0 e WCF si basa sul set di specifiche WS-* supportato da entrambe. Lo sviluppo di un'applicazione WSE 3.0 o WCF presenta un set comune di terminologia, ad esempio i nomi delle asserzioni di sicurezza turnkey in WSE e le modalità di autenticazione.
Benché vi siano molte analogie fra il modello di programmazione di WCF e quello di ASP.NET o WSE 3.0, di fatto tali modelli sono diversi. Per informazioni dettagliate sul modello di programmazione di WCF, vedere Ciclo di vita della programmazione di base.
.gif "ms732008.note(it-it,VS.100).gif") Nota: |
|---|
Per eseguire la migrazione di un servizio Web da WSE a WCF è possibile utilizzare lo Strumento ServiceModel Metadata Utility Tool (Svcutil.exe) per generare un client. Tuttavia, le interfacce e le classi contenute in questo client sono utilizzabili anche come base per un servizio WCF. L'attributo OperationContractAttribute delle interfacce che vengono generate viene applicato ai membri del contratto con la proprietà ReplyAction impostata su *. Quando un client WSE chiama un servizio Web con questa impostazione, viene generata l'eccezione Web.Services3.ResponseProcessingException: WSE910 indicante che si è verificato un errore durante l'elaborazione di un messaggio di risposta e che la descrizione dell'errore è contenuta nell'eccezione interna. Per risolvere questo problema, impostare la proprietà ReplyAction dell'attributo OperationContractAttribute su un valore diverso da null, ad esempio http://Microsoft.WCF.Documentation/ResponseToOCAMethod.
|
Sicurezza
Servizi Web WSE 3.0 protetti mediante un file dei criteri
I servizi WCF possono utilizzare un file di configurazione per proteggere un servizio. Tale meccanismo è analogo a un file dei criteri di WSE 3.0. Quando in WSE 3.0 si protegge un servizio Web tramite un file dei criteri, si utilizza un'asserzione di sicurezza turnkey oppure un'asserzione di criteri personalizzata. Le asserzioni di sicurezza turnkey corrispondono in modo quasi identico alla modalità di autenticazione di un elemento di associazione di sicurezza di WCF. Oltre a presentare una denominazione analoga o identica, le modalità di autenticazione di WCF e le asserzioni di sicurezza turnkey di WSE 3.0 proteggono i messaggi utilizzando gli stessi tipi di credenziale. Ad esempio, l'asserzione di sicurezza turnkey usernameForCertificate di WSE 3.0 corrisponde alla modalità di autenticazione UsernameForCertificate di WCF. Gli esempi di codice seguenti illustrano la corrispondenza fra un criterio minimo che utilizza un'asserzione di sicurezza turnkey UsernameForCertificate di WSE 3.0 e una modalità di autenticazione usernameForCertificate di un'associazione personalizzata di WCF.
WSE 3.0
<policies>
<policy name="MyPolicy">
<usernameForCertificate messageProtectionOrder="SignBeforeEncrypt"
requireDeriveKeys="true"/>
</policy>
</policies>
WCF
<customBinding>
<binding name="MyBinding">
<security authenticationMode="UserNameForCertificate"
messageProtectionOrder="SignBeforeEncrypt"
requireDerivedKeys="true"/>
</binding>
</customBinding>
Per eseguire la migrazione delle impostazioni di sicurezza di un servizio Web specificate in un file dei criteri da WSE 3.0 a WCF, è necessario creare un'associazione personalizzata in un file di configurazione e quindi impostare l'asserzione di sicurezza turnkey sulla relativa modalità di autenticazione equivalente. Quando i client WSE 3.0 comunicano con il servizio occorre inoltre configurare l'associazione personalizzata in modo che utilizzi la specifica WS-Addressing dell'agosto 2004. Quando il servizio WCF di cui è stata eseguita la migrazione non richiede la comunicazione con i client WSE 3.0 e deve gestire solo la parità di sicurezza, anziché creare un'associazione personalizzata può essere conveniente utilizzare le associazioni definite dal sistema di WCF con le impostazioni di sicurezza appropriate.
Nella tabella seguente viene illustrata la corrispondenza fra un file dei criteri di WSE 3.0 e l'associazione personalizzata equivalente di WCF.
| Asserzione di sicurezza turnkey di WSE 3.0 | Configurazione dell'associazione personalizzata di WCF |
|---|---|
<usernameOverTransportSecurity /> |
|
<mutualCertificate10Security /> |
|
<usernameForCertificateSecurity /> |
|
<anonymousForCertificateSecurity /> |
|
<kerberosSecurity /> |
|
<mutualCertificate11Security /> |
|
Per ulteriori informazioni sulla creazione di associazioni personalizzate in WCF, vedere Associazioni personalizzate.
Servizi Web WSE 3.0 protetti mediante il codice dell'applicazione
Quando si utilizza WSE 3.0 o WCF i requisiti di sicurezza possono essere specificati nel codice anziché nella configurazione dell'applicazione. Per eseguire questa operazione in WSE 3.0 occorre creare una classe che deriva dalla classe Policy e quindi aggiungere i requisiti chiamando il metodo Add. Per informazioni più dettagliate sulla specifica dei requisiti di sicurezza in codice, vedere la procedura per proteggere un servizio Web senza ricorrere a un file dei criteri (la pagina potrebbe essere in inglese). In WCF, per specificare in codice i requisiti di sicurezza, è necessario creare un'istanza della classe BindingElementCollection e quindi aggiungere un'istanza di un elemento SecurityBindingElement alla raccolta BindingElementCollection. Per impostare i requisiti delle asserzioni di sicurezza occorre utilizzare i metodi di supporto statici della modalità di autenticazione della classe SecurityBindingElement. Per informazioni più dettagliate sulla specifica in codice dei requisiti di sicurezza in WCF, vedere Procedura: creare un'associazione personalizzata utilizzando SecurityBindingElement e Procedura: creare un elemento SecurityBindingElement per una modalità di autenticazione specificata.
Asserzione di criteri personalizzata di WSE 3.0
In WSE 3.0 sono disponibili due tipi di asserzioni di criteri personalizzate: le asserzioni che proteggono i messaggi SOAP e quelle che non li proteggono. Le asserzioni di criteri che proteggono i messaggi SOAP derivano dalla classe SecurityPolicyAssertion di WSE 3.0 e l'equivalente concettuale in WCF è la classe SecurityBindingElement.
Un importante punto da tenere presente è che le asserzioni di sicurezza turnkey WSE 3.0 sono un sottoinsieme delle modalità di autenticazione WCF. Se è stata creata un'asserzione di criteri personalizzata in WSE 3.0 è possibile che esista una modalità di autenticazione equivalente in WCF. Ad esempio, anziché fornire un'asserzione di sicurezza CertificateOverTransport equivalente all'asserzione di sicurezza turnkey UsernameOverTransport, WSE 3.0 utilizza un certificato X.509 per eseguire l'autenticazione client. Se è stata definita un'asserzione di criteri personalizzata per questo scenario, WCF semplifica la migrazione. In particolare, WCF definisce una modalità di autenticazione per questo scenario, consentendo di utilizzare i metodi di supporto statici della modalità di autenticazione per configurare un elemento WCFSecurityBindingElement.
Quando in WCF non esiste alcuna modalità di autenticazione equivalente a un'asserzione di criteri personalizzata che protegge i messaggi SOAP, derivare una classe dalla classe TransportSecurityBindingElement, SymmetricSecurityBindingElement oppure AsymmetricSecurityBindingElementWCF e specificare l'elemento di associazione equivalente. Per informazioni più dettagliate, vedere Procedura: creare un'associazione personalizzata utilizzando SecurityBindingElement.
Per convertire un'asserzione di criteri personalizzata che non protegge i messaggi SOAP, vedere Filtri e l'esempio di Intercettore dei messaggi personalizzati.
Token di sicurezza personalizzato di WSE 3.0
Il modello di programmazione WCF per la creazione di un token personalizzato è diverso che WSE 3.0. Per dettagli sulla creazione di un token personalizzato in WSE, vedere Creating Custom Security Tokens. Per informazioni dettagliate sulla creazione di un token personalizzato in WCF, vedere Procedura: creare un token personalizzato.
Gestore del token personalizzato di WSE 3.0
Il modello di programmazione per la creazione di un gestore di token personalizzati è diverso in WCF rispetto a WSE 3.0. Per i dettagli su come creare un gestore di token personalizzati e gli altri componenti necessari per un token di sicurezza personalizzato, vedere Procedura: creare un token personalizzato.
| Nota: |
|---|
| Se è stato creato un gestore del token di sicurezza UsernameToken personalizzato, WCF offre un meccanismo per specificare la logica di autenticazione in modo più semplice rispetto alla creazione di un gestore del token di sicurezza personalizzato. Per informazioni più dettagliate, vedere Procedura: utilizzare un validator di nome utente e password personalizzato. |
Servizi Web WSE 3.0 che utilizzano messaggi SOAP con codifica MTOM
Analogamente a un'applicazione WSE 3, un'applicazione WCF può specificare in configurazione l'utilizzo del meccanismo di codifica dei messaggi MTOM. Per eseguire la migrazione di questa impostazione, aggiungere l'mtomMessageEncoding element all'associazione del servizio. L'esempio di codice seguente illustra come specificare la codifica MTOM in WSE 3.0 per un servizio equivalente in WCF.
WSE 3.0
<messaging>
<mtom clientMode="On"/>
</messaging>
WCF
<customBinding>
<binding name="MyBinding">
<mtomMessageEncoding/>
</binding>
</customBinding>
Messaggistica
Applicazioni WSE 3.0 che utilizzano l'API del sistema di messaggistica di WSE
Quando si utilizza l'API del sistema di messaggistica di WSE per accedere in modo diretto ai dati XML scambiati fra il client e il servizio Web, l'applicazione può essere convertita in modo da utilizzare il formato POX (Plain Old XML). Per informazioni più dettagliate su POX, vedere Interoperabilità con applicazioni POX. Per informazioni più dettagliate sull'API del sistema di messaggistica di WSE, vedere Invio e ricezione di messaggi SOAP mediante l'API del sistema di messaggistica di WSE (la pagina potrebbe essere in inglese).
Trasporti
TCP
Per impostazione predefinita, i client e i servizi Web WSE 3.0 che inviano messaggi SOAP utilizzando il trasporto TCP non sono interoperativi con i client e i servizi Web WCF. Questa incompatibilità è dovuta a differenze nella modalità di frame del protocollo TCP e si basa inoltre su motivi legati alle prestazioni. Tuttavia, nell'esempio WCF viene indicato come implementare una sessione TCP personalizzata che interopera con WSE 3.0. Per informazioni dettagliate su questo esempio, vedere Transport: WSE 3.0 TCP Interoperability.
Per specificare che un'applicazione WCF utilizza il trasporto TCP, utilizzare l'netTcpBinding Element.
Trasporto personalizzato
L'equivalente di un trasporto personalizzato di WSE 3.0 in WCF è un'estensione di canale. Per informazioni dettagliate sulla creazione di un'estensione di canale, vedere Estensione del livello del canale.
Vedere anche
Attività
Procedura: creare un elemento SecurityBindingElement per una modalità di autenticazione specificata
Concetti
Ciclo di vita della programmazione di base
Associazioni personalizzate
Procedura: creare un'associazione personalizzata utilizzando SecurityBindingElement