Indirizzi endpoint

  • Articolo

A ogni endpoint è associato un indirizzo, che è utilizzato per individuarlo e identificarlo. L'indirizzo è costituito principalmente da un URI (Uniform Resource Identifier) che specifica il percorso dell'endpoint. L'indirizzo endpoint è rappresentato nel modello di programmazione Windows Communication Foundation (WCF) tramite la classe EndpointAddress. Questa contiene una proprietà Identity facoltativa che consente l'autenticazione dell'endpoint tramite altri endpoint che scambiano messaggi con esso e un insieme di proprietà Headers facoltative. Tali proprietà definiscono qualsiasi altra intestazione SOAP richiesta per raggiungere il servizio. Le intestazioni facoltative forniscono dettagli aggiuntivi e più precisi sull'indirizzo per identificare o interagire con l'endpoint del servizio. L'indirizzo di un endpoint è rappresentato in transito come riferimento all'endpoint di WS-Addressing (EPR).

Struttura URI di un indirizzo

L'indirizzo URI per la maggior parte dei trasporti è costituito da quattro parti. Le quattro parti dell'URI http://www.fabrikam.com:322/mathservice.svc/secureEndpoint, ad esempio, possono essere specificate come segue:

  • Schema: http:
  • Computer: www.fabrikam.com
  • (facoltativo) Porta: 322
  • Percorso: /mathservice.svc/secureEndpoint

Definizione di un indirizzo per un servizio

L'indirizzo endpoint per un servizio può essere specificato in modo imperativo mediante l'utilizzo di codice oppure in modo dichiarativo mediante la configurazione. In genere definire endpoint nel codice non è pratico in quanto le associazioni e gli indirizzi di un servizio distribuito sono solitamente diversi da quelli utilizzati durante lo sviluppo del servizio. In genere è più pratico definire endpoint di servizio mediante la configurazione piuttosto che mediante codice. Se le informazioni sull'associazione e sull'indirizzo non vengono incluse nel codice, tali dati possono essere modificati senza dover compilare o distribuire nuovamente l'applicazione.

Definizione di un indirizzo nella configurazione

Per definire un endpoint in un file di configurazione, utilizzare l'elemento <endpoint>. Per ulteriori informazioni e per un esempio, vedere Specifica di un indirizzo endpoint.

Definizione di un indirizzo nel codice

È possibile creare un indirizzo endpoint nel codice con la classe EndpointAddress. Per ulteriori informazioni e per un esempio, vedere Specifica di un indirizzo endpoint.

Endpoint in WSDL

Un indirizzo endpoint può essere rappresentato anche in WSDL come elemento EPR di WS-Addressing all'interno dell'elemento wsdl:port dell'endpoint corrispondente. EPR contiene l'indirizzo dell'endpoint e qualsiasi proprietà dell'indirizzo. Per ulteriori informazioni e per un esempio, vedere Specifica di un indirizzo endpoint.

Supporto di associazioni IIS multiple

I provider del servizio Internet spesso ospitano diverse applicazioni nello stesso server e nello stesso sito per aumentare la densità del sito e ridurre il costo totale di proprietà. Queste applicazioni sono in genere associate a indirizzi di base diversi. Un sito Web IIS (Internet Information Services) può contenere numerose applicazioni. Alle applicazioni in un sito è possibile accedere tramite una o più associazioni IIS.

Le associazioni IIS forniscono due tipi di informazioni: un protocollo di associazione e informazioni di associazione. Il protocollo di associazione definisce lo schema sul quale ha luogo la comunicazione, mentre le informazioni di associazione sono utilizzate per accedere al sito.

Nell'esempio seguente vengono illustrati i componenti che possono essere presenti in un'associazione IIS:

  • Protocollo di associazione: HTTP
  • Informazioni di associazione: indirizzo IP, porta, intestazione host

IIS può specificare più associazioni per ogni sito, il che comporta più indirizzi di base per ogni schema. Prima di .NET Framework 3.5, in WCF non erano supportati più indirizzi per uno schema e, nel caso venissero specificati, veniva generata un'eccezione ArgumentException durante l'attivazione.

.NET Framework 3.5 consente ai provider di servizi Internet di ospitare più applicazioni con indirizzi di base diversi per lo stesso schema sullo stesso sito.

Un sito potrebbe contenere, ad esempio, gli indirizzi di base seguenti:

Con .NET Framework 3.5, si specifica un filtro del prefisso a livello di AppDomain nel file di configurazione. A tale scopo, utilizzare l'elemento <baseAddressPrefixFilters> che contiene un elenco di prefissi. Gli indirizzi di base in ingresso, forniti da IIS, sono filtrati in base all'elenco di prefissi facoltativo. Per impostazione predefinita, quando non è specificato un prefisso, vengono passati tutti gli indirizzi. La specifica del prefisso fa sì che venga passato solo l'indirizzo di base corrispondente per quello schema.

Quello che segue è un esempio di codice di configurazione che utilizza i filtri del prefisso.

<system.serviceModel>
  <serviceHostingEnvironment>
     <baseAddressPrefixFilters>
        <add prefix="net.tcp://payroll.myorg.com:8000"/>
        <add prefix="http://shipping.myorg.com:8000"/>
    </baseAddressPrefixFilters>
  </serviceHostingEnvironment>
</system.serviceModel>

Nell'esempio precedente, net.tcp://payroll.myorg.com:8000 e http://shipping.myorg.com:9000 sono gli unici indirizzi di base, per i rispettivi schemi, che vengono passati.

baseAddressPrefixFilter non supporta caratteri jolly.

Gli indirizzi di base forniti da IIS possono avere indirizzi associati ad altri schemi non presenti nell'elenco baseAddressPrefixFilters. Questi indirizzi non vengono filtrati.

Estensione dell'indirizzamento nei servizi WSF

Il modello di indirizzamento predefinito dei servizi WCF utilizza l'indirizzo URI dell'endpoint per gli scopi seguenti:

  • Per specificare l'indirizzo di ascolto del servizio, il percorso su cui l'endpoint resta in ascolto dei messaggi.
  • Per specificare il filtro dell'indirizzo SOAP, l'indirizzo che un endpoint si aspetta come intestazione SOAP.

I valori per ognuno di questi scopi possono essere specificati separatamente, consentendo numerose estensioni di indirizzamento a copertura di scenari utili:

  • Intermediari SOAP: un messaggio inviato da un client attraversa uno o più servizi aggiuntivi che elaborano il messaggio prima che raggiunga la sua destinazione finale. Gli intermediari SOAP possono eseguire numerose attività, ad esempio memorizzazione nella cache, routing, bilanciamento del carico o convalida dello schema sui messaggi. Per realizzare questo scenario, inviare messaggi a un indirizzo fisico separato (via) destinato all'intermediario piuttosto che a un indirizzo logico (wsa:To) per la destinazione finale.
  • L'indirizzo di ascolto dell'endpoint è un URI privato ed è impostato su un valore diverso dalla sua proprietà listenURI.

L'indirizzo di trasporto specificato da via è il percorso al quale dovrebbe inizialmente essere inviato un messaggio mentre si sta dirigendo verso un altro indirizzo remoto specificato dal parametro to in cui si trova il servizio. Nella maggior parte degli scenari Internet, l'URI via corrisponde alla proprietà Uri dell'indirizzo finale to del servizio. La distinzione tra i due indirizzi è necessaria solo quando è richiesto il routing manuale.

Intestazioni di indirizzamento

Un endpoint può essere indirizzato da una o più intestazioni SOAP oltre che dal proprio URI di base. Ciò è utile, ad esempio, in presenza di scenari di intermediari SOAP in cui un endpoint richiede che i client di quell'endpoint includano intestazioni SOAP destinate agli intermediari.

È possibile definire intestazioni di indirizzo personalizzate in due modi: codice o configurazione:

  • Nel codice, creare intestazioni di indirizzo personalizzate utilizzando la classe AddressHeader, quindi utilizzarle nella costruzione di un oggetto EndpointAddress.
  • Nella configurazione, <headers> personalizzate sono specificate come figli dell'elemento <endpoint>.

La configurazione è in genere preferibile al codice, poiché consente di modificare le intestazioni dopo la distribuzione.

Indirizzi di ascolto personalizzati

È possibile impostare l'indirizzo di ascolto su un valore diverso dall'URI dell'endpoint. Ciò è utile negli scenari di intermediari in cui l'indirizzo SOAP da esporre è quello di un intermediario SOAP pubblico, mentre l'indirizzo su cui l'endpoint è effettivamente in ascolto è un indirizzo di rete privata.

È possibile specificare un indirizzo di ascolto personalizzato utilizzando codice o configurazione:

  • Nel codice, specificare un indirizzo di ascolto personalizzato aggiungendo una classe ClientViaBehavior all'insieme di comportamenti dell'endpoint.
  • Nella configurazione, specificare un indirizzo di ascolto personalizzato con l'attributo ListenUri dell'elemento <endpoint> del servizio.

Filtro dell'indirizzo SOAP personalizzato

Uri viene utilizzato insieme a una proprietà Headers per definire il filtro dell'indirizzo SOAP di un endpoint (AddressFilter). Per impostazione predefinita, questo filtro verifica che un messaggio in arrivo abbia un'intestazione del messaggio To che corrisponde all'URI dell'endpoint e che nel messaggio siano presenti tutte le intestazioni dell'endpoint richieste.

In alcuni scenari, un endpoint riceve tutti i messaggi che arrivano sul trasporto sottostante e non solo quelli con l'intestazione To appropriata. Affinché ciò sia possibile, l'utente può utilizzare la classe MatchAllMessageFilter.

Vedere anche

Concetti

Specifica di un indirizzo endpoint
Identità del servizio e autenticazione