Adapter WCF-BasicHttpRelay

Articolo
07/21/2023

Microsoft BizTalk Server usa l'adapter WCF-BasicHttpRelay per ricevere e inviare richieste di servizio WCF tramite la classe BasicHttpRelayBinding. L'adapter WCF-BasicHttpRelay usa endpoint di inoltro del bus di servizio usando BasicHttpRelayBinding.

Prima di iniziare

A partire da BizTalk Server 2016, questa scheda può usare Controllo di accesso Service (ACS) o la firma di accesso condiviso (SAS) per athenticate con il bus di servizio. È consigliabile usare la firma di accesso condiviso (SAS) durante l'autenticazione con il bus di servizio.

Quando si crea uno spazio dei nomi del bus di servizio, lo spazio dei nomi Controllo di accesso (ACS) non viene creato automaticamente. Se si usa ACS per eseguire l'autenticazione, potrebbe essere necessario creare un nuovo spazio dei nomi ACS. Per informazioni più dettagliate, vedere l'adapter SB-Messaging , inclusi i passaggi per recuperare i valori della chiave ACS.

Creare l'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 amministrazione BizTalk Server, espandere 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 finestra di dialogo Proprietà percorso di ricezione selezionare WCF-BasicHttpRelay nell'elenco a discesa Tipo e quindi fare clic su Configura per configurare le proprietà di trasporto per la posizione di ricezione.

Nella scheda Generale della finestra di dialogo WCF-BasicHttpRelay TransportProperties configurare l'indirizzo dell'endpoint in cui è ospitato l'endpoint di inoltro del bus di servizio e l'identità del servizio per il percorso di ricezione WCF-BasicHttpRelay.

Usare	Per
Indirizzo (URI)	Obbligatorio. Specificare l'URI in cui viene distribuito l'endpoint di inoltro di Service Bus.
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.

Usare

Per

Indirizzo (URI)

Obbligatorio. Specificare l'URI in cui viene distribuito l'endpoint di inoltro di Service Bus.

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.

Nella scheda Binding della finestra di dialogo WCF-BasicHttpRelay Transport Properties (Proprietà trasporto WCF-BasicHttpRelay) configurare le proprietà correlate 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). L'adattatore WCF-BasicHttpRelay sfrutta la classe BasicHttpRelayBinding nella modalità di trasferimento con buffer per comunicare con un endpoint. Per la modalità di trasporto con buffer, la proprietà BasicHttpRelayBinding.MaxBufferSize è sempre uguale al valore di questa proprietà. Valore predefinito: 65536 Valore massimo: 2147483647
Codifica dei messaggi	Specificare il codificatore utilizzato per la codifica del messaggio SOAP. I valori validi sono i seguenti: - Testo: usare un codificatore di messaggi di testo. - Mtom: usare un codificatore MTOM (Message Transmission Organization Mechanism 1.0). Il valore predefinito è Text.
Codifica testo	Specificare la codifica del set di caratteri da usare per l'emissione di messaggi nell'associazione quando la proprietà di codifica Message è impostata su Text. I valori validi sono i seguenti: - utf-16BE (unicodeFFFE): codifica Unicode BigEndian. - utf-16: codifica a 16 bit. - utf-8: codifica a 8 bit Il valore predefinito è utf-8.
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 finestra di dialogo Proprietà trasporto WCF-BasicHttpRelay definire le funzionalità di sicurezza del percorso di ricezione WCF-BasicHttpRelay.

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. Per utilizzare questa modalità, è necessario configurare SSL (Secure Sockets Layer) in Microsoft Internet Information Services (IIS). - Messaggio: la sicurezza viene fornita usando la sicurezza dei messaggi SOAP nel trasporto HTTP. Per impostazione predefinita, l'elemento SOAP Body viene crittografato e firmato. L'unico tipo di credenziali client del messaggio valido per l'adattatore WCF-Basic è Certificato. Questa modalità richiede il trasporto HTTP. Quando si usa questa modalità di sicurezza, è necessario specificare il certificato di servizio per la posizione di ricezione tramite la proprietà Certificato del servizio - Identificazione personale . - TransportWithMessageCredential: integrità, riservatezza e autenticazione del servizio vengono forniti 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 messaggio	Specificare le opzioni di sicurezza a livello di messaggio solo se si imposta la modalità sicurezza precedente su Message o TransportWithMessageCredential. I valori validi sono i seguenti: - UserName: abilita questa posizione di ricezione per richiedere che i client vengano autenticati usando le credenziali UserName . È necessario creare gli account utente di dominio o locale corrispondenti alle credenziali client. - Certificato: i client vengono autenticati in questa posizione di ricezione usando 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. Il valore predefinito è UserName.
Insieme di algoritmi	Specificare gli algoritmi di crittografia e wrapping della chiave solo se si imposta la modalità di sicurezza sopra a Message o TransportWithMessageCredential. Questa operazione non è applicabile se si imposta la modalità sicurezza su Nessuno o Trasporto. Questi algoritmi sono associati a quelli indicati nella specifica Security Policy Language (WS-SecurityPolicy). I valori possibili sono: - Basic128: usare la crittografia Aes128, Sha1 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic128Rsa15: usare Aes128 per la crittografia dei messaggi, Sha1 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic128Sha256: usare Aes256 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic128Sha256Rsa15: usare Aes128 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic192: usare la crittografia Aes192, Sha1 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic192Rsa15: usare Aes192 per la crittografia dei messaggi, Sha1 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic192Sha256: usare Aes192 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic192Sha256Rsa15: usare Aes192 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic256: usare la crittografia Aes256, Sha1 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic256Rsa15: usare Aes256 per la crittografia dei messaggi, Sha1 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic256Sha256: usare Aes256 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic256Sha256Rsa15: usare Aes256 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - TripleDes: usare la crittografia TripleDes, Sha1 per il digest dei messaggi, Rsa-oaep-mgf1p per il wrapping della chiave. - TripleDesRsa15: usare la crittografia TripleDes, Sha1 per il digest dei messaggi e Rsa15 per il wrapping delle chiavi. - TripleDesSha256: usare TripleDes per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - TripleDesSha256Rsa15: usare TripleDes per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. Il valore predefinito è Basic256.
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 impostare questa proprietà solo se si imposta la modalità di sicurezza sopra a Message o TransportWithMessageCredential. Questa operazione non è applicabile se si imposta la modalità sicurezza su Nessuno o Trasporto. 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.
Tipo di autenticazione client di inoltro	Specificare l'opzione di autenticazione con l'endpoint di inoltro di Service Bus a partire dal quale viene ricevuto il messaggio. I valori validi sono i seguenti: - Nessuna: non è necessaria alcuna autenticazione. - RelayAccessToken: specificare questa opzione per usare un token di sicurezza per autorizzare l'endpoint di inoltro del bus di servizio. Il valore predefinito è RelayAccessToken.
Abilita individuazione del servizio	Selezionare questa casella di controllo per specificare se il comportamento del servizio è pubblicato nel Registro di sistema del servizio. - Nome visualizzato : specificare il nome con cui il servizio viene pubblicato nel Registro di sistema del servizio. - Modalità di individuazione: impostare la modalità di individuazione per il servizio pubblicato nel Registro di sistema del servizio. Per altre informazioni, vedere DiscoveryType Enum.
Servizio di controllo di accesso	Si applica a BizTalk Server 2013 R2 e BizTalk Server 2013. Se si imposta Tipo di autenticazione client di inoltro su RelayAccessToken, fare clic sul pulsante Modifica e specificare i seguenti dettagli: - 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 autorità di certificazione. Usare Windows PowerShell per recuperare questi valori, come descritto nell'adapter SB-Messaging.

Nella finestra di dialogo PROPRIETÀ trasporto WCF-BasicHttpRelay specificare la selezione dei dati per l'elemento SOAP Body.

Usare	Per
Busta -- intero <soap:Busta>	Creare la parte corpo del messaggio BizTalk dall'intero elemento SOAP Envelope di un messaggio in arrivo. Per impostazione predefinita, l'opzione è deselezionata.
Corpo - contenuto dell'elemento <soap:Body>	Utilizzare il contenuto dell'elemento SOAP Body di un messaggio in arrivo per creare la parte corpo del messaggio BizTalk. Se l'elemento Body dispone di più di un elemento figlio, solo il primo elemento diventa la parte corpo del messaggio BizTalk. Si tratta dell'impostazione predefinita.
Percorso: contenuto individuato per percorso corpo	Utilizzare l'espressione percorso del corpo nella casella di testo Espressione percorso del corpo per creare la parte corpo del messaggio BizTalk. Tale espressione viene valutata in base all'elemento figlio immediato dell'elemento SOAP Body di un messaggio in arrivo. Per impostazione predefinita, l'opzione è deselezionata.
Espressione percorso del corpo	Immettere l'espressione percorso del corpo per identificare una parte specifica di un messaggio in arrivo utilizzata per creare la parte corpo del messaggio BizTalk. Tale espressione viene valutata in base all'elemento figlio immediato dell'elemento SOAP Body di un messaggio in arrivo. Se questa espressione percorso del corpo restituisce più di un nodo, solo il primo nodo verrà scelto per la parte corpo del messaggio BizTalk. Questa proprietà è necessaria se l'opzione Percorso: contenuto individuato per percorso corpo è selezionata. Tipo: String Lunghezza minima: 0 Lunghezza massima: 32767 Il valore predefinito è una stringa vuota.
Codifica nodo	Specificare il tipo di codifica usato dall'adattatore di ricezione WCF-BasicHttpRelay per decodificare il nodo identificato dall'espressione percorso corpo nella casella di testo Espressione percorso corpo . Questa proprietà è necessaria se l'opzione Percorso: contenuto individuato per percorso corpo è selezionata. I valori validi sono i seguenti: - Base64: codifica Base64. - Esadecimale: codifica esadecimale. - Stringa: codifica di testo - UTF-8 - XML: gli adattatori WCF creano il corpo del messaggio BizTalk con il codice XML esterno del nodo selezionato dall'espressione percorso corpo nella casella di testo Espressione percorso corpo. Il valore predefinito è XML.
Corpo: corpo del messaggio di risposta BizTalk	Usare la parte corpo del messaggio BizTalk per creare il contenuto dell'elemento SOAP Body di un messaggio di risposta in uscita. La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta. Si tratta dell'impostazione predefinita.
Modello: contenuto specificato da modello	Usare il modello fornito nella casella di testo XML per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita. La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta. Per impostazione predefinita, l'opzione è deselezionata.
XML	Digitare il modello in formato XML per il contenuto dell'elemento SOAP Body per un messaggio in uscita. Questa proprietà è necessaria se l'opzione Modello: contenuto specificato da modello è selezionata. La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta. Tipo: String Lunghezza minima: 0 Lunghezza massima: 32767 Il valore predefinito è `<bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">`.
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-BasicHttpRelay per l'opzione Tipo nella sezione Trasporto della scheda Generale .
Nella scheda Generale , nella sezione Trasporto fare clic sul pulsante Configura .

Nella scheda Generale della finestra di dialogo Proprietà trasporto WCF-BasicHttpRelay specificare quanto segue:

Usare	Per
Indirizzo (URI)	Obbligatorio. Specificare l'URL in cui viene distribuito l'endpoint di inoltro nel bus di servizio. Il formato dell'URL in genere è il seguente: `https://<namespace>.servicebus.windows.net/`
Identità endpoint	facoltativo. Specificare l'identità dell'endpoint. Queste impostazioni consentono alla porta di trasmissione di eseguire presso l'endpoint. Nel processo di handshake tra l'endpoint e la porta di trasmissione l'infrastruttura di Windows Communication Foundation (WCF) garantisce che l'identità dell'endpoint corrisponda ai valori di questo elemento. Per impostazione predefinita, l'opzione è deselezionata.
Azione	Specificare il campo intestazione HTTP SOAPAction per i messaggi in uscita. Questa proprietà può essere impostata anche tramite la proprietà del contesto del messaggio WCF. Azione in una pipeline o in un'orchestrazione. È possibile specificare questo valore in due modi diversi: il formato di azione singolo e il formato di mapping delle azioni. Se si imposta questa proprietà nel formato di azione singola, ad esempio, `http://contoso.com/Svc/Op1`l'intestazione SOAPAction per i messaggi in uscita viene sempre impostata sul valore specificato in questa proprietà. Se si imposta questa proprietà nel formato di mapping delle azioni, l'intestazione SOAPAction in uscita viene determinata da BTS. Proprietà contesto operazione . Ad esempio, se questa proprietà è impostata sul formato XML seguente e su BTS. La proprietà Operation è impostata su Op1, l'adapter di invio WCF usa `http://contoso.com/Svc/Op1` per l'intestazione SOAPAction in uscita. `<BtsActionMapping> <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" /> <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" /> </BtsActionMapping>` Se i messaggi in uscita provengono da una porta di orchestrazione, le istanze di orchestrazione impostano dinamicamente BTS. Proprietà Operation con il nome dell'operazione della porta. Se i messaggi in uscita vengono indirizzati con il routing basato sul contenuto, è possibile impostare BTS. Proprietà Operation nei componenti della pipeline. Importante: Il bus di servizio impone che un'azione SOAP venga impostata durante l'invio di messaggi agli endpoint di inoltro. Lunghezza minima: 0 Lunghezza massima: 32767 Il valore predefinito è una stringa vuota.

Nella finestra di dialogo Proprietà trasporto WCF-BasicHttpRelay configurare le proprietà di timeout e codifica nella scheda Binding .

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 trasmissione sollecitazione-risposta, tale valore specificherà l'intervallo di tempo consentito per il completamento dell'intera interazione, anche se il servizio 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). L'adattatore WCF-BasicHttpRelay sfrutta la classe BasicHttpBinding nella modalità di trasferimento con buffer per comunicare con un endpoint. Per la modalità di trasporto con buffer, la proprietà BasicHttpBinding.MaxBufferSize è sempre uguale al valore di questa proprietà. Valore predefinito: 65536 Valore massimo: 2147483647
Codifica dei messaggi	Specificare il codificatore utilizzato per la codifica del messaggio SOAP. I valori validi sono i seguenti: - Testo: usare un codificatore di messaggi di testo. - Mtom: usare un codificatore MTOM (Message Transmission Organization Mechanism 1.0). Valore predefinito: Testo
Codifica testo	Specificare la codifica del set di caratteri da usare per l'emissione di messaggi nell'associazione quando la proprietà di codifica Message è impostata su Text. I valori validi sono i seguenti: - utf-16BE (unicodeFFFE): codifica Unicode BigEndian. - utf-16: codifica a 16 bit. - utf-8: codifica a 8 bit Valore predefinito: utf-8

Nella finestra di dialogo Proprietà trasporto WCF-BasicHttpRelay definire le funzionalità di sicurezza della porta di trasmissione WCF-BasicHttpRelay.

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. - Messaggio: la sicurezza viene fornita usando la sicurezza dei messaggi SOAP. Per impostazione predefinita, l'elemento SOAP Body viene crittografato e firmato. L'unico tipo di credenziale client message valido per l'adattatore di invio WCF-BasicHttpRelay è Certificato. Questa modalità richiede il trasporto HTTP. - 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 messaggio	Specificare le opzioni di sicurezza a livello di messaggio solo se si imposta la modalità sicurezza precedente su Message o TransportWithMessageCredential. I valori validi sono i seguenti: - UserName: questa porta di invio viene autenticata all'endpoint con credenziali UserName . Questa operazione non è supportata per l'adapter di trasmissione WCF-BasicHttpRelay. - Certificato: questa porta di invio viene autenticata all'endpoint usando il certificato client specificato tramite la proprietà Certificato client - Identificazione personale . Inoltre, quando si usa questo tipo di credenziale, il certificato di servizio deve essere fornito tramite la proprietà Certificato del servizio - Identificazione personale . Il valore predefinito è UserName.
Insieme di algoritmi	Specificare gli algoritmi di crittografia dei messaggi e di incapsulamento della chiave. Questi algoritmi sono associati a quelli indicati nella specifica Security Policy Language (WS-SecurityPolicy). I valori possibili sono: - Basic128: usare la crittografia Aes128, Sha1 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic128Rsa15: usare Aes128 per la crittografia dei messaggi, Sha1 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic128Sha256: usare Aes256 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic128Sha256Rsa15: usare Aes128 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic192: usare la crittografia Aes192, Sha1 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic192Rsa15: usare Aes192 per la crittografia dei messaggi, Sha1 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic192Sha256: usare Aes192 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic192Sha256Rsa15: usare Aes192 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic256: usare la crittografia Aes256, Sha1 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic256Rsa15: usare Aes256 per la crittografia dei messaggi, Sha1 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - Basic256Sha256: usare Aes256 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - Basic256Sha256Rsa15: usare Aes256 per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. - TripleDes: usare la crittografia TripleDes, Sha1 per il digest dei messaggi, Rsa-oaep-mgf1p per il wrapping della chiave. - TripleDesRsa15: usare la crittografia TripleDes, Sha1 per il digest dei messaggi e Rsa15 per il wrapping delle chiavi. - TripleDesSha256: usare TripleDes per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa-oaep-mgf1p per il wrapping della chiave. - TripleDesSha256Rsa15: usare TripleDes per la crittografia dei messaggi, Sha256 per il digest dei messaggi e Rsa15 per il wrapping della chiave. Il valore predefinito è Basic256.
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. - 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 autorità di certificazione. Usare Windows PowerShell per recuperare questi valori, come descritto nell'adapter SB-Messaging.

Nella scheda Proxy della finestra di dialogo WCF-BasicHttpRelay Transport Properties (Proprietà trasporto WCF-BasicHttpRelay) configurare l'impostazione proxy per la porta di trasmissione WCF-BasicHttpRelay.

Usare	Per
Usare le impostazioni proxy del gestore di invio	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 invio usa 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 l'opzione Use proxy è selezionata. 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 l'opzione Use proxy è selezionata. Nota: L'adapter di trasmissione WCF-BasicHttpRelay utilizza 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 l'opzione Use proxy è selezionata. Tipo: String Lunghezza minima: 0 Lunghezza massima: 256 Il valore predefinito è una stringa vuota.

Nella finestra di dialogo PROPRIETÀ trasporto WCF-BasicHttpRelay specificare la selezione dei dati per l'elemento SOAP Body.

Usare	Per
Corpo: corpo del messaggio di richiesta BizTalk	Utilizzare la parte del corpo del messaggio BizTalk per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita. Si tratta dell'impostazione predefinita.
Modello: contenuto specificato da modello	Usare il modello fornito nella casella di testo XML per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita. Per impostazione predefinita, l'opzione è deselezionata.
XML	Digitare il modello formattato XML per il contenuto dell'elemento SOAP ody di un messaggio in uscita. Questa proprietà è necessaria se l'opzione Modello: contenuto specificato da modello è selezionata. Tipo: String Lunghezza minima: 0 Lunghezza massima: 32767 Il valore predefinito è `<bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>`.
Busta -- intero <soap:Busta>	Creare la parte corpo del messaggio BizTalk dall'intero elemento SOAP Envelope di un messaggio in arrivo. Questa proprietà è valida solo per le porte sollecitazione-risposta. Per impostazione predefinita, l'opzione è deselezionata.
Corpo - contenuto dell'elemento <soap:Body>	Utilizzare il contenuto dell'elemento SOAP Body di un messaggio in arrivo per creare la parte corpo del messaggio BizTalk. Se l'elemento Body dispone di più di un elemento figlio, solo il primo elemento diventa la parte corpo del messaggio BizTalk. Questa proprietà è valida solo per le porte sollecitazione-risposta. Si tratta dell'impostazione predefinita.
Percorso: contenuto individuato per percorso corpo	Utilizzare l'espressione percorso del corpo nella casella di testo Espressione percorso del corpo per creare la parte corpo del messaggio BizTalk. Tale espressione viene valutata in base all'elemento figlio immediato dell'elemento SOAP Body di un messaggio in arrivo. Questa proprietà è valida solo per le porte sollecitazione-risposta. Per impostazione predefinita, l'opzione è deselezionata.
Espressione percorso del corpo	Immettere l'espressione percorso del corpo per identificare una parte specifica di un messaggio in arrivo utilizzata per creare la parte corpo del messaggio BizTalk. Questa espressione del percorso del corpo viene valutata rispetto all'elemento figlio immediato del nodo SOAP Body di un messaggio in ingresso. Se questa espressione percorso del corpo restituisce più di un nodo, solo il primo nodo verrà scelto per la parte corpo del messaggio BizTalk. Questa proprietà è necessaria se l'opzione Percorso: contenuto individuato per percorso corpo è selezionata. Questa proprietà è valida solo per le porte sollecitazione-risposta. Tipo: String Lunghezza minima: 0 Lunghezza massima: 32767 Il valore predefinito è una stringa vuota.
Codifica nodo	Specificare il tipo di codifica usato dall'adattatore di invio WCF-BasicHttpRelay per decodificare il nodo identificato dall'espressione percorso corpo nella casella di testo Espressione percorso corpo . Questa proprietà è necessaria se l'opzione Percorso: contenuto individuato per percorso corpo è selezionata. Questa proprietà è valida solo per le porte sollecitazione-risposta. I valori validi sono i seguenti: - Base64: codifica Base64. - Esadecimale: codifica esadecimale. - Stringa: codifica di testo - UTF-8 - XML: gli adattatori WCF creano il corpo del messaggio BizTalk con il codice XML esterno del nodo selezionato dall'espressione percorso corpo nella casella di testo Espressione percorso corpo. Il valore predefinito è XML.
Propaga messaggio di errore	Selezionare questa casella di controllo per eseguire il routing del messaggio per il quale non può essere eseguita l'elaborazione in uscita a un'applicazione di sottoscrizione, ad esempio un'altra porta di ricezione o una pianificazione dell'orchestrazione. Deselezionare la casella di controllo per consentire la sospensione dei messaggi con errori e la generazione di un messaggio di riconoscimento negativo (NACK). Questa proprietà è valida solo per le porte sollecitazione-risposta. Per impostazione predefinita la casella è selezionata.

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

Aggiungere un proxy al gestore di invio

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

Nella console di amministrazione BizTalk Server espandere amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Impostazioni piattaforma e quindi espandere Adapter.
Selezionare WCF-BasicHttpRelay e quindi selezionare il gestore di invio.
Nella scheda Generale selezionare Proprietàdel gestore adapter.

Nella scheda Proxy eseguire le operazioni seguenti.

Usare	Per
Usa proxy	Indica se questo gestore di invio usa 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 l'opzione Use proxy è selezionata. 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 l'opzione Use proxy è selezionata. 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 finché non si esce da tutte le finestre di dialogo.

Vedere anche

Adapter di messaggistica SB

Uso degli adapter

Condividi tramite