Adapter WCF-WebHttp

Articolo
07/21/2023

Microsoft BizTalk Server usa l'adapter WCF-WebHttp per inviare messaggi ai servizi RESTful. L'adapter di invio WCF-WebHttp invia messaggi HTTP a un servizio da un messaggio BizTalk. I messaggi provenienti da un servizio RESTful vengono ricevuti in un indirizzo di ricezione. Per le richieste GET e DELETE, l'adapter non utilizza alcun payload. Per le richieste POST e PUT, l'adapter utilizza la parte del corpo del messaggio BizTalk fino al contenuto/payload HTTP.

Questo argomento illustra come creare il percorso di ricezione e la porta di trasmissione usando Amministrazione BizTalk.

Creazione di un indirizzo di ricezione

Nota

Prima di completare la procedura seguente, è necessario aver già aggiunto una porta di ricezione unidirezionale. Vedere Come creare una porta di ricezione.

Nella console di amministrazione BizTalk Server espandere BizTalk Server Amministrazione, gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione in cui si vuole creare un percorso di ricezione.
Nel riquadro sinistro fare clic sul nodo Porte di ricezione , nel riquadro destro fare clic con il pulsante destro del mouse sulla porta di ricezione alla quale si desidera associare il nuovo indirizzo di ricezione, quindi fare clic su Proprietà.
Nel riquadro sinistro della finestra di dialogo Proprietà porta di ricezione selezionare Indirizzi di ricezione, quindi nel riquadro destro fare clic su Nuovo per creare un nuovo indirizzo di ricezione.
Nella sezione Trasporto della finestra di dialogo Proprietà indirizzo di ricezione selezionare WCF-WebHttp dall'elenco a discesa Tipo , quindi fare clic su Configura per configurare le proprietà di trasporto per l'indirizzo di ricezione.

Nella scheda Generale configurare l'indirizzo dell'endpoint per l'interfaccia REST da cui viene ricevuto il messaggio.

Usare	Per
Indirizzo (URI)	Obbligatorio. Specificare l'URI in cui BizTalk Server può ricevere messaggi RESTful basati su HTTP.
Identità endpoint	facoltativo. Specificare l'identità dell'endpoint. Queste impostazioni consentono all'endpoint di autenticare l'indirizzo di ricezione corrente. Nel processo di handshake tra l'endpoint e l'indirizzo di ricezione l'infrastruttura di Windows Communication Foundation (WCF) garantisce che l'identità del servizio previsto corrisponda ai valori di questo elemento. Il valore predefinito è una stringa vuota.
Mapping metodo HTTP e URL	Il mapping dell'operazione BTS consente agli utenti di mappare le richieste HTTP in ingresso all'operazione BTS nel contesto del messaggio, in base al metodo HTTP in ingresso e al sottopercorso URL. Il metodo HTTP in ingresso e il sottopercorso URL vengono confrontati con un set di metodi HTTP e il modello URI. Se viene trovata una corrispondenza, l'adapter innalza la proprietà BTS.Operation al livello di contesto del messaggio BizTalk con il valore specificato nel messaggio. È possibile specificare il mapping tra il metodo HTTP e l'URL nel formato con singolo mapping o nel formato con più mapping. Il formato con più mapping è simile al seguente: `<BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345</BtsHttpUrlMapping>` Nel frammento di codice precedente, è possibile notare che l'ID cliente viene fornito come valore costante, ovvero 12345. Sono tuttavia possibili scenari in cui l'ID cliente, o qualsiasi altra variabile di query, devono essere determinati in fase di runtime. Per prevedere scenari di questo tipo, è necessario specificare il componente variabile dell'URL tra parentesi graffe { }. Ad esempio, se nel frammento di codice precedente l'ID cliente viene specificato come variabile, sarà simile al seguente: `<BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}</BtsHttpUrlMapping>` In tal caso, è necessario specificare anche la posizione da cui prelevare il valore dell' ID variabile in fase di runtime. Per eseguire questa operazione, utilizzare Mapping variabili. Nota All'interno del campo URL tutti i caratteri XML speciali devono essere preceduti da un carattere di escape. In questo modo si garantisce che i caratteri XML speciali vengano elaborati e mantenuti dalla porta. Ad esempio, il `&` carattere speciale deve essere preceduto da un carattere di escape come `&`. Da: `Url=”/Customer?{ID}& group=Location”` Con: `Url=”/Customer?{ID}&group=Location”`
Mapping variabili	Se sono state specificate variabili per il mapping basato su metodo HTTP e URL, è necessario specificare la proprietà per il mapping della variabile in fase di runtime. Fare clic sul pulsante Modifica per avviare la finestra di dialogo Mapping variabili . Nella colonna Variabile sono elencate le variabili definite per Mapping metodo HTTP e URL. Nel campo Nome proprietà è necessario specificare il nome della proprietà che fornisce il valore da associare alla variabile. Tale proprietà deve essere già stata definita o innalzata di livello durante la creazione della soluzione. È inoltre necessario specificare lo spazio dei nomi per la proprietà nel campo Spazio dei nomi proprietà .

Nella scheda Binding configurare le proprietà relative al timeout e alla codifica.

Usare	Per
Timeout di apertura (hh:mm:ss)	Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di apertura di un canale. Questo valore deve essere maggiore o uguale a System.TimeSpan.Zero. Valore predefinito: 00:01:00 Valore massimo: 23:59:59
Timeout di invio (hh:mm:ss)	Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di invio. Questo valore deve essere maggiore o uguale a System.TimeSpan.Zero. Se si utilizza una porta di ricezione richiesta-risposta, tale valore specificherà l'intervallo di tempo consentito per il completamento dell'intera interazione, anche se il client restituisce un messaggio di grandi dimensioni. Valore predefinito: 00:01:00 Valore massimo: 23:59:59
Timeout di chiusura (hh:mm:ss)	Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di chiusura di un canale. Questo valore deve essere maggiore o uguale a System.TimeSpan.Zero. Valore predefinito: 00:01:00 Valore massimo: 23:59:59
Dimensioni massime messaggi ricevuti (byte)	Specificare le dimensioni massime in byte di un messaggio, intestazioni comprese, che è possibile ricevere in transito. Le dimensioni dei messaggi sono limitate dalla quantità di memoria allocata per ogni messaggio. È possibile utilizzare questa proprietà per limitare l'esposizione ad attacchi di tipo Denial of Service (DoS). Per la comunicazione con un endpoint, l'adapter WCF-WebHttp utilizza la classe WebHttpBinding nella modalità di trasferimento memorizzata nel buffer. Per la modalità di trasporto memorizzata nel buffer, la proprietà WebHttpBinding.MaxBufferSize è sempre uguale al valore di questa proprietà. Valore predefinito: 65536 Valore massimo: 2147483647
Numero massimo di chiamate simultanee	Specifica il numero di chiamate simultanee a una singola istanza del servizio. Le chiamate oltre il limite vengono accodate. L'impostazione di questo valore su 0 equivale a impostarlo su Int32.MaxValue. Il valore predefinito è 200.

Nella scheda Sicurezza definire le funzionalità di sicurezza del percorso di ricezione WCF-WebHttp.

Usare	Per
Modalità di sicurezza	Specificare il tipo di sicurezza utilizzato. I valori validi sono i seguenti: - Nessuno: i messaggi non sono protetti durante il trasferimento. - Trasporto: la sicurezza viene fornita tramite il trasporto HTTPS. I messaggi SOAP vengono protetti utilizzando HTTPS. Per utilizzare questa modalità, è necessario configurare SSL (Secure Sockets Layer) in Microsoft Internet Information Services (IIS). - TransportWithMessageCredential: l'integrità, la riservatezza e l'autenticazione del servizio vengono fornite dal trasporto HTTPS. Per utilizzare questa modalità, è necessario configurare SSL (Secure Sockets Layer) in Microsoft Internet Information Services (IIS). Il valore predefinito è Transport.
Tipo di credenziali client del trasporto	Specifica il tipo di credenziali da utilizzare durante l'autenticazione del client. I valori validi sono i seguenti: - Nessuno: nessuna autenticazione si verifica a livello di trasporto. - Basic: autenticazione di base. L'autenticazione di base prevede l'invio dei dati del nome utente e della password in testo normale attraverso la rete. È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali. - Digest: autenticazione del digest. Questo metodo di autenticazione opera in modo simile all'autenticazione di base, con la differenza che le password vengono inviate attraverso la rete come valori hash per aumentare la sicurezza. L'autenticazione digest è disponibile solo nei domini con controller di dominio che eseguono l'autenticazione di sistemi operativi Windows Server. È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali client. - Ntlm: autenticazione NTLM. I client possono inviare le credenziali senza una password a questo indirizzo di ricezione. È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali client. - Windows: autenticazione integrata di Windows. Windows Communication Foundation negozia l'autenticazione Kerberos o NTLM, preferendo Kerberos se è presente un dominio. Se si desidera utilizzare Kerberos, è importante che il client identifichi il servizio con un nome principale del servizio (SPN). È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali client. - Certificato: autenticazione client con il certificato client. La catena di certificati CA per i certificati X.509 del client deve essere installata nell'archivio certificati Autorità di certificazione radice attendibili del computer in uso, in modo che i client possano essere autenticati presso questo indirizzo di ricezione. NotaLa proprietà Tipo di credenziali client Transport deve corrispondere allo schema di autenticazione della directory virtuale IIS che ospita questa posizione di ricezione. Ad esempio, se la proprietà è impostata su Windows, è necessario attivare anche Autenticazione integrata Windows per la directory virtuale che la ospita. Analogamente, se la proprietà è impostata su None, è necessario consentire l'accesso anonimo alla directory virtuale che ospita questo indirizzo di ricezione. Il valore predefinito è Windows.
Certificato servizio - Identificazione personale	Specificare l'identificazione personale del certificato X.509 per questo indirizzo di ricezione che i client utilizzano per autenticare il servizio. L'identificazione personale può essere selezionata passando all'archivio personale nella posizione Utente corrente mediante il pulsante Sfoglia . Nota È necessario installare il certificato di servizio nel percorso utente corrente dell'account utente per il gestore di ricezione che ospita questa posizione di ricezione. Lunghezza minima: 0 Lunghezza massima: 40 Il valore predefinito è una stringa vuota.

Nella scheda Comportamento specificare comportamenti diversi a livello di servizio e a livello di endpoint. Questi comportamenti si basano su classi .NET Framework.

Usare	Per
ServiceBehavior	Estendere la funzionalità del servizio WCF a livello di servizio. È possibile aggiungere estensioni diverse, ad esempio definire le impostazioni di sicurezza, abilitare il debug, implementare la limitazione e usare altre classi .NET. Selezionare con il pulsante destro del mouse ServiceBehavior e Aggiungi estensione. L'elenco mostra le classi .NET che possono essere usate.
EndpointBehavior	Estendere la funcionalità della modalità di ricezione delle richieste a livello di endpoint. È possibile aggiungere estensioni che eseguono operazioni diverse, ad esempio ricevere richieste HTTP da un client basato su browser ASP.NET AJAX, specificare un intervallo di tempo sulle transazioni, scegliere di ricevere messaggi in modo sincrono o asincrono e usare altre classi .NET. Selezionare con il pulsante destro del mouse EndpointBehavior e Aggiungi estensione. L'elenco mostra le classi .NET che possono essere usate.

Usare

Per

ServiceBehavior

Estendere la funzionalità del servizio WCF a livello di servizio. È possibile aggiungere estensioni diverse, ad esempio definire le impostazioni di sicurezza, abilitare il debug, implementare la limitazione e usare altre classi .NET.

Selezionare con il pulsante destro del mouse ServiceBehavior e Aggiungi estensione. L'elenco mostra le classi .NET che possono essere usate.

EndpointBehavior

Estendere la funcionalità della modalità di ricezione delle richieste a livello di endpoint. È possibile aggiungere estensioni che eseguono operazioni diverse, ad esempio ricevere richieste HTTP da un client basato su browser ASP.NET AJAX, specificare un intervallo di tempo sulle transazioni, scegliere di ricevere messaggi in modo sincrono o asincrono e usare altre classi .NET.

Selezionare con il pulsante destro del mouse EndpointBehavior e Aggiungi estensione. L'elenco mostra le classi .NET che possono essere usate.

È simile alla configurazione del comportamento per un percorso di ricezione WCF-Custom. Vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Ricezione, Comportamento nella guida dell'interfaccia utente e nei riferimenti agli spazi dei nomi delle API per sviluppatori.

Nella scheda Messaggi specificare la selezione dei dati per l'elemento SOAP Body .

Usare	Per
Intestazioni HTTP in uscita	Specificare le eventuali intestazioni HTTP riportate nel messaggio di risposta.
Disattiva indirizzo in caso di errore	Specificare se disattivare l'indirizzo di ricezione per il quale non è possibile eseguire l'elaborazione in ingresso a causa di un problema della pipeline di ricezione o di un errore di routing. Per impostazione predefinita, l'opzione è deselezionata.
Sospendere il messaggio di richiesta in caso di mancata riuscita	Specificare se sospendere il messaggio di richiesta per cui non è possibile eseguire l'elaborazione in ingresso a causa di un problema della pipeline di ricezione o di un errore di routing. Per impostazione predefinita, l'opzione è deselezionata.
Includere dettaglio di eccezione negli errori	Specificare se restituire gli errori SOAP quando si verificano problemi nel debug. Per impostazione predefinita, l'opzione è deselezionata.

Fare clic su OK.
Immettere i valori appropriati nella finestra di dialogo Proprietà indirizzo di ricezione per completare la configurazione dell'indirizzo di ricezione e fare clic su OK per salvare le impostazioni. Per informazioni sulla finestra di dialogo Proprietà indirizzo di ricezione , vedere Come creare un indirizzo di ricezione.

Creare la porta di trasmissione

Nella Console di amministrazione BizTalk creare una nuova porta di trasmissione oppure fare doppio clic su una porta di trasmissione esistente per modificarla. Vedere Come creare una porta di trasmissione. Configurare tutte le opzioni di porta di invio e specificare WCF-WebHttp per l'opzione Tipo nella sezione Trasporto della scheda Generale .
Nella scheda Generale , nella sezione Trasporto fare clic sul pulsante Configura .

Nella scheda Generale configurare l'indirizzo dell'endpoint per l'interfaccia REST in cui viene inviato il messaggio.

Usare	Per
Indirizzo (URI)	Obbligatorio. Specificare l'URI dell'interfaccia REST in cui viene inviato il messaggio.
Identità endpoint	facoltativo. Specificare l'identità dell'endpoint. Queste impostazioni consentono all'endpoint di autenticare questa porta di trasmissione. Nel processo di handshake tra l'endpoint e l'indirizzo di ricezione l'infrastruttura di Windows Communication Foundation (WCF) garantisce che l'identità del servizio previsto corrisponda ai valori di questo elemento. Il valore predefinito è una stringa vuota.
Mapping metodo HTTP e URL	Il mapping dell'operazione BTS consente agli utenti di mappare le richieste HTTP in ingresso all'operazione BTS nel contesto del messaggio, in base al metodo HTTP in ingresso e al sottopercorso URL. Il metodo HTTP in ingresso e il sottopercorso URL vengono confrontati con un set di metodi HTTP e il modello URI. Se viene trovata una corrispondenza, l'adapter innalza la proprietà BTS.Operation al livello di contesto del messaggio BizTalk con il valore specificato nel messaggio. È possibile specificare il mapping tra il metodo HTTP e l'URL nel formato con singolo mapping o nel formato con più mapping. Il formato con più mapping è simile al seguente: `BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345" /> </BtsHttpUrlMapping>` Nel frammento di codice precedente, è possibile notare che l'ID cliente viene fornito come valore costante, ovvero 12345. Sono tuttavia possibili scenari in cui l'ID cliente, o qualsiasi altra variabile di query, devono essere determinati in fase di runtime. Per prevedere scenari di questo tipo, è necessario specificare il componente variabile dell'URL tra parentesi graffe { }. Ad esempio, se nel frammento di codice precedente l'ID cliente viene specificato come variabile, sarà simile al seguente: `<BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}" /> </BtsHttpUrlMapping>` In tal caso, è necessario specificare anche la posizione da cui prelevare il valore dell' ID variabile in fase di runtime. Per eseguire questa operazione, utilizzare Mapping variabili. Nota All'interno del campo URL, tutti i caratteri XML speciali devono essere "escape". Ciò garantisce che i caratteri XML speciali vengano elaborati e mantenuti dalla porta. Ad esempio, il `&` carattere speciale deve essere escape come `&`. Da: `Url=”/Customer?{ID}& group=Location”` Con: `Url=”/Customer?{ID}&group=Location”`
Mapping variabili	Se sono state specificate variabili per il mapping basato su metodo HTTP e URL, è necessario specificare la proprietà per il mapping della variabile in fase di runtime. Fare clic sul pulsante Modifica per avviare la finestra di dialogo Mapping variabili . Nella colonna Variabile sono elencate le variabili definite per Mapping metodo HTTP e URL. Nel campo Nome proprietà è necessario specificare il nome della proprietà che fornisce il valore da associare alla variabile. Tale proprietà deve essere già stata definita o innalzata di livello durante la creazione della soluzione. È inoltre necessario specificare lo spazio dei nomi per la proprietà nel campo Spazio dei nomi proprietà .

Nella scheda Binding configurare le proprietà relative al timeout e alla codifica.

Usare	Per
Timeout di apertura (hh:mm:ss)	Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di apertura di un canale. Questo valore deve essere maggiore o uguale a System.TimeSpan.Zero. Valore predefinito: 00:01:00 Valore massimo: 23:59:59
Timeout di invio (hh:mm:ss)	Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di invio. Questo valore deve essere maggiore o uguale a System.TimeSpan.Zero. Se si utilizza una porta di ricezione richiesta-risposta, tale valore specificherà l'intervallo di tempo consentito per il completamento dell'intera interazione, anche se il client restituisce un messaggio di grandi dimensioni. Valore predefinito: 00:01:00 Valore massimo: 23:59:59
Timeout di chiusura (hh:mm:ss)	Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di chiusura di un canale. Questo valore deve essere maggiore o uguale a System.TimeSpan.Zero. Valore predefinito: 00:01:00 Valore massimo: 23:59:59
Dimensioni massime messaggi ricevuti (byte)	Specificare le dimensioni massime in byte di un messaggio, intestazioni comprese, che è possibile ricevere in transito. Le dimensioni dei messaggi sono limitate dalla quantità di memoria allocata per ogni messaggio. È possibile utilizzare questa proprietà per limitare l'esposizione ad attacchi di tipo Denial of Service (DoS). Per la comunicazione con un endpoint, l'adapter WCF-WebHttp utilizza la classe WebHttpBinding nella modalità di trasferimento memorizzata nel buffer. Per la modalità di trasporto memorizzata nel buffer, la proprietà WebHttpBinding.MaxBufferSize è sempre uguale al valore di questa proprietà. Valore predefinito: 65536 Valore massimo: 2147483647

Nella scheda Sicurezza definire le funzionalità di sicurezza della porta di trasmissione WCF-WebHttp.

Usare	Per
Modalità di sicurezza	Specificare il tipo di sicurezza utilizzato. I valori validi sono i seguenti: - Nessuno: i messaggi non sono protetti durante il trasferimento. - Trasporto: la sicurezza viene fornita usando il trasporto HTTPS. I messaggi SOAP vengono protetti utilizzando HTTPS. La catena di certificati CA per il certificato X.509 del servizio deve essere installata nell'archivio certificati Autorità di certificazione radice attendibili del computer in uso, in modo che il servizio possa essere autenticato presso la porta di trasmissione mediante il certificato del servizio. - TransportWithMessageCredential: integrità, riservatezza e autenticazione del servizio vengono forniti dal trasporto HTTPS. La catena di certificati CA per il certificato X.509 del servizio deve essere installata nell'archivio certificati Autorità di certificazione radice attendibili del computer in uso, in modo che il servizio possa essere autenticato presso la porta di trasmissione mediante il certificato del servizio. L'autenticazione della porta di trasmissione viene garantita dalla sicurezza dei messaggi SOAP. L'impostazione predefinita è None (Nessuna).
Tipo di credenziali client del trasporto	Specifica il tipo di credenziali da utilizzare durante l'autenticazione del client. I valori validi sono i seguenti: - Nessuno: nessuna autenticazione si verifica a livello di trasporto. - Basic: autenticazione di base. L'autenticazione di base prevede l'invio dei dati del nome utente e della password in testo normale attraverso la rete. È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali. - Digest: autenticazione del digest. Questo metodo di autenticazione opera in modo simile all'autenticazione di base, con la differenza che le password vengono inviate attraverso la rete come valori hash per aumentare la sicurezza. L'autenticazione digest è disponibile solo nei domini con controller di dominio che eseguono l'autenticazione di sistemi operativi Windows Server. È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali client. - Ntlm: autenticazione NTLM. I client possono inviare le credenziali senza una password a questo indirizzo di ricezione. È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali client. - Windows: autenticazione integrata di Windows. Windows Communication Foundation negozia l'autenticazione Kerberos o NTLM, preferendo Kerberos se è presente un dominio. Se si desidera utilizzare Kerberos, è importante che il client identifichi il servizio con un nome principale del servizio (SPN). È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali client. - Certificato: autenticazione client con il certificato client. La catena di certificati CA per i certificati X.509 del client deve essere installata nell'archivio certificati Autorità di certificazione radice attendibili del computer in uso, in modo che i client possano essere autenticati presso questo indirizzo di ricezione. Nota: La proprietà Tipo di credenziali client Transport deve corrispondere allo schema di autenticazione della directory virtuale IIS che ospita questa posizione di ricezione. Ad esempio, se la proprietà è impostata su Windows, è necessario attivare anche Autenticazione integrata Windows per la directory virtuale che la ospita. Analogamente, se la proprietà è impostata su None, è necessario consentire l'accesso anonimo alla directory virtuale che ospita questo indirizzo di ricezione. Il valore predefinito è Windows.
Certificato client - Identificazione personale	Specificare l'identificazione personale del certificato X.509 per l'autenticazione della porta di trasmissione presso l'endpoint. È possibile selezionare l'identificazione personale passando all'archivio personale nel percorso Utente corrente con il pulsante Sfoglia . Nota: È necessario installare il certificato client nel percorso utente corrente dell'account utente per il gestore di invio che ospita questa porta di invio. Lunghezza minima: 0 Lunghezza massima: 40 Il valore predefinito è una stringa vuota.
Certificato servizio - Identificazione personale	Specificare l'identificazione personale del certificato X.509 per l'autenticazione dell'endpoint a cui questa porta di trasmissione invia messaggi. È possibile selezionare l'identificazione personale passando all'archivio Altre Persone nel percorso computer locale con il pulsante Sfoglia. Lunghezza minima: 0 Lunghezza massima: 40 Il valore predefinito è una stringa vuota.
Credenziali nome utente	Specificare le credenziali per l'invio di messaggi. È possibile specificare la proprietà facendo clic sul pulsante Modifica . È necessario impostare le credenziali se è stata selezionata l'opzione Nome utente per il tipo di credenziali client message. Il valore predefinito non usa Single Sign-On.
Usa identità del servizio ACS	Si applica a BizTalk Server 2013 R2 e BizTalk Server 2013. Selezionare questa casella di controllo e fare clic su Modifica e specificare i valori seguenti per l'autenticazione con il bus di servizio. Questa operazione è necessaria solo quando si richiama un'interfaccia REST per le entità correlate al bus di servizio. - Controllo di accesso Uri del servizio: impostare questo valore su `https://<Namespace>-sb.accesscontrol.windows.net/`, dove <lo spazio dei nomi è lo spazio dei nomi> del bus di servizio. - Nome autorità di certificazione : specificare il nome dell'autorità di certificazione. In genere viene impostato il proprietario. - Chiave autorità di certificazione: specificare la chiave dell'autorità di certificazione.
Informazioni sulla connessione del bus di servizio	Novità a partire da BizTalk Server 2016. Scegliere di usare la firma di accesso condiviso (SAS) o Controllo di accesso Service (ACS) dello spazio dei nomi del bus di servizio. Selezionare un'opzione e quindi selezionare Modifica per immettere le informazioni chiave: - Firma di accesso condiviso : immettere il nome della chiave di accesso e la chiave di accesso. Entrambi i valori sono elencati nella portale di Azure. - Controllo di accesso Servizio: immettere l'URI STS (`https://<yourNamespace>-sb.accesscontrol.windows.net/`), il nome dell'autorità di certificazione e la chiave dell'autorità emittente. Usare Windows PowerShell per recuperare questi valori, come descritto in Scheda di messaggistica SB.

Nella scheda Comportamento configurare il comportamento dell'endpoint per questa porta di trasmissione.

Usare	Per
EndpointBehavior	Estendere la funcionalità della modalità di invio delle richieste a livello di endpoint. È possibile aggiungere estensioni che eseguono operazioni diverse, ad esempio definire il comportamento di elaborazione SOAP, specificare un intervallo di tempo per le transazioni, controllare la funzionalità di individuazione e usare altre classi .NET. Selezionare con il pulsante destro del selezionare EndpointBehavior e Aggiungi estensione. L'elenco mostra le classi .NET che è possibile usare.

Usare

Per

EndpointBehavior

Estendere la funcionalità della modalità di invio delle richieste a livello di endpoint. È possibile aggiungere estensioni che eseguono operazioni diverse, ad esempio definire il comportamento di elaborazione SOAP, specificare un intervallo di tempo per le transazioni, controllare la funzionalità di individuazione e usare altre classi .NET.

Selezionare con il pulsante destro del selezionare EndpointBehavior e Aggiungi estensione. L'elenco mostra le classi .NET che è possibile usare.

Questa operazione è analoga alla configurazione del comportamento dell'endpoint per una porta di trasmissione WCF-Custom. Vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Invia, Comportamento nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

Nella scheda Proxy configurare l'impostazione proxy per la porta di trasmissione WCF-WebHttp.

Usare	Per
Utilizza impostazioni proxy gestore di trasmissione	Specificare se la porta di trasmissione utilizza le impostazioni proxy nel gestore di trasmissione che ospita la porta di trasmissione. Si tratta dell'impostazione predefinita.
Non usare il proxy	Indicare se la porta di trasmissione utilizza un server proxy. Per impostazione predefinita, l'opzione è deselezionata.
Usa proxy	Indica se questa porta di trasmissione utilizza il server proxy specificato nella proprietà Address . Per impostazione predefinita, l'opzione è deselezionata.
Indirizzo	Specificare l'indirizzo del server proxy. Usare lo schema https o http a seconda della configurazione di sicurezza. L'indirizzo può essere seguito dai due punti e dal numero di porta, Ad esempio: `http://127.0.0.1:8080`. Questa proprietà richiede un valore solo se è selezionata l'opzione Usa proxy . Tipo: String Lunghezza massima: 256 Il valore predefinito è una stringa vuota.
Nome utente	Specificare il nome utente da utilizzare per l'autenticazione. Se si utilizza l'autenticazione integrata, il nome utente include il dominio, ovvero dominio\nomeutente. Se si utilizza l'autenticazione di base o digest, il nome utente non include dominio\. Questa proprietà richiede un valore solo se è selezionata l'opzione Usa proxy . Nota: L'adattatore di trasmissione WCF-WebHttp usa l'autenticazione di base per il proxy. Tipo: String Lunghezza minima: 0 Lunghezza massima: 256 Il valore predefinito è una stringa vuota.
Password	Specificare la password da utilizzare per l'autenticazione. Questa proprietà richiede un valore solo se è selezionata l'opzione Usa proxy . Tipo: String Lunghezza minima: 0 Lunghezza massima: 256 Il valore predefinito è una stringa vuota.

Nella scheda Messaggi specificare la modalità di invio del messaggio all'interfaccia REST.

Usare Per

Intestazioni HTTP in uscita Specificare le eventuali intestazioni HTTP riportate nel messaggio di risposta.

Eliminazione del corpo per i verbi In base al verbo utilizzato per richiamare un endpoint REST, può essere necessario un payload del messaggio. Ad esempio, se vengono utilizzati i verbi GET o DELETE è possibile che il payload non sia necessario. Tuttavia, per attivare una chiamata all'endpoint REST mediante la porta di trasmissione, può essere opportuno utilizzare un messaggio fittizio con un payload. Prima dell'invio del messaggio all'endpoint REST, il payload deve essere rimosso dal messaggio fittizio. È possibile specificare i verbi per i quali il payload del messaggio deve essere rimosso usando la proprietà Suppress Body for Verbs .

Ad esempio, se si vuole rimuovere il payload del messaggio durante l'uso di un verbo GET, specificare il valore per questa proprietà come GET.

Fare di nuovo clic su OK e su OK per salvare le impostazioni.

Importare estensioni WCF

Importare le estensioni WCF nel gestore di ricezione o nel gestore di invio:

Nella BizTalk Server Amministrazione espandere BizTalk Server Amministrazione, gruppo BizTalk, espandere Impostazioni piattaforma e quindi Adapter.
Selezionare WCF-WebHttp e quindi selezionare il gestore di ricezione o invio.
Nella scheda Generale selezionare Proprietà.
In Estensioni WCF selezionare Importa e passare al file di configurazione dell'estensione WCF.

Aggiungere un proxy al gestore di invio

È possibile aggiungere un proxy alla porta di trasmissione o al gestore di trasmissione. Se si aggiunge un proxy alla porta di trasmissione, ignorare questa sezione.

Nella console di amministrazione di BizTalk Server espandere BizTalk Server Amministrazione, gruppo BizTalk, espandere Impostazioni piattaformae quindi adapter.
Selezionare WCF-WebHttp e quindi selezionare il gestore di invio.
Nella scheda Generale della scheda Proprietà gestore adapter selezionare Proprietà.

Nella scheda Proxy eseguire le operazioni seguenti.

Usare	Per
Usa proxy	Indicare se il gestore di trasmissione utilizza un server proxy. Per impostazione predefinita, l'opzione è deselezionata.
Indirizzo	Specificare l'indirizzo del server proxy. Usare lo schema https o http a seconda della configurazione di sicurezza. L'indirizzo può essere seguito dai due punti e dal numero di porta, Ad esempio: `http://127.0.0.1:8080`. Questa proprietà richiede un valore solo se è selezionata l'opzione Usa proxy . Tipo: String Lunghezza massima: 256 Il valore predefinito è una stringa vuota.
Nome utente	Specificare il nome utente da utilizzare per l'autenticazione. Se si utilizza l'autenticazione integrata o di base, il nome utente include il dominio, ovvero dominio\nomeutente. Se si utilizza l'autenticazione digest, il nome utente non include dominio\. Questa proprietà richiede un valore solo se è selezionata l'opzione Usa proxy . Tipo: String Lunghezza minima: 0 Lunghezza massima: 256 Il valore predefinito è una stringa vuota.
Password	Specificare la password da utilizzare per l'autenticazione. Questa proprietà richiede un valore solo se l'opzione Use proxy è selezionata. Tipo: String Lunghezza minima: 0 Lunghezza massima: 256 Il valore predefinito è una stringa vuota.

Fare clic su OK fino a uscire da tutte le finestre di dialogo.

Vedere anche

Adapter di messaggistica SB

Uso degli adapter

Informazioni sugli adapter WCF

Condividi tramite