Configurare una porta di trasmissione WCF- NetTcp
È possibile configurare una porta di trasmissione WCF-NetTcp a livello di codice o tramite la Console di amministrazione BizTalk.
Proprietà di configurazione
Il modello a oggetti di BizTalk Explorer espone un'interfaccia specifica dell'adapter per le porte di trasmissione denominate ITransportInfo con la proprietà di lettura/scrittura TransportTypeData . Questa proprietà accetta un elenco di proprietà di configurazione delle porte di trasmissione WCF-NetTcp sotto forma di coppia nome-valore di stringhe XML.
La proprietà TransportTypeData dell'interfaccia ITransportInfo non è obbligatoria. Se non viene impostata, l'adapter utilizza i valori predefiniti per la configurazione delle porte di trasmissione WCF-NetTcp, come indicato nella tabella seguente.
Nella tabella seguente sono illustrate le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per le porte di trasmissione WCF-NetTcp.
| Nome proprietà | Type | Descrizione |
|---|---|---|
| Identità | BLOB XML, ad esempio:<identity> <userPrincipalName value="username@contoso.com"/> </identity> |
Specifica l'identità del servizio prevista da questa porta di trasmissione. Queste impostazioni consentono alla porta di trasmissione di autenticare il servizio. Nel processo di handshake tra il client e il servizio, l'infrastruttura WCF (Windows Communication Foundation) garantirà che l'identità del servizio previsto corrisponda ai valori di questo elemento. Il valore predefinito è una stringa vuota. |
| StaticAction | string | Specificare il campo intestazione 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 singola e il formato di mapping delle azioni. Se si imposta questa proprietà nel formato a azione singola, ad esempio , http://contoso.com/Svc/Op1l'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à del contesto dell'operazione . Ad esempio, se questa proprietà è impostata sul formato XML seguente e su BTS. La proprietà Operation è impostata su Op1, l'adattatore di trasmissione 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 instradati con il routing basato sul contenuto, è possibile impostare BTS. Proprietà Operation nei componenti della pipeline. Il valore predefinito è una stringa vuota. |
| OpenTimeout | System.TimeSpan | Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di apertura di un canale. Valore predefinito: 00:01:00 |
| SendTimeout | System.TimeSpan | Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di invio. 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 |
| CloseTimeout | System.TimeSpan | Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di chiusura di un canale. Valore predefinito: 00:01:00 |
| MaxReceivedMessageSize | Intero | Specificare le dimensioni massime in byte di un messaggio, intestazioni comprese, che è possibile ricevere durante la trasmissione. 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-NetTcp sfrutta la classe NetTcpBinding nella modalità di trasferimento memorizzata nel buffer per comunicare con un endpoint. Per la modalità di trasporto memorizzata nel buffer, la proprietà NetTcpBinding.MaxBufferSize è sempre uguale al valore di questa proprietà. Valore predefinito: 65536 |
| EnableTransaction | Boolean | Specificare se un messaggio viene trasmesso al servizio di destinazione ed eliminato dal database MessageBox in un contesto transazionale utilizzando il protocollo di transazione specificato nella proprietà TransactionProtocol . Valore predefinito: False |
| TransactionProtocol | Enumerazione - OleTransaction - WS-AtomicTransaction |
Specificare il protocollo di transazione da utilizzare con questo binding. Valore predefinito: OleTransaction |
| Securitymode | Enumerazione - Nessuno - Messaggio - Trasporto - Transportwithmessagecredential Per altre informazioni sui nomi dei membri per la proprietà SecurityMode , vedere la proprietà Modalità di sicurezza nella finestra di dialogo Proprietà trasporto WCF-NetTcp, Invia, Sicurezza nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori. |
Specificare il tipo di sicurezza utilizzato. Valore predefinito: Transport |
| TransportClientCredentialType | Enumerazione - Nessuno - Windows - Certificato Per altre informazioni sui nomi dei membri per la proprietà TransportClientCredentialType , vedere la proprietà Transport client credential type nella finestra di dialogo Proprietà trasporto WCF-NetTcp, Send, Security nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori. |
Specificare il tipo di credenziali da utilizzare durante l'autenticazione della porta di trasmissione. Valore predefinito: Windows |
| TransportProtectionLevel | Enumerazione - Nessuno: nessuna protezione. - Firma : i messaggi sono firmati. - EncryptAndSign : i messaggi vengono crittografati e firmati. |
Specifica la sicurezza al livello del trasporto TCP. La firma dei messaggi riduce il rischio di manomissione del messaggio a opera di terze parti durante il trasferimento. La crittografia garantisce la privacy a livello dei dati durante il trasporto. Valore predefinito: EncryptAndSign |
| MessageClientCredentialType | Enumerazione - Nessuno - Windows - Nome utente - Certificato Per altre informazioni sui nomi dei membri per la proprietà MessageClientCredentialType , vedere la proprietà Message client credential type nella finestra di dialogo Proprietà trasporto WCF-NetTcp, Send, Security nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori. |
Specificare il tipo di credenziali da utilizzare durante l'autenticazione del client con la sicurezza basata sui messaggi. Valore predefinito: Windows |
| AlgorithmSuite | Enumerazione Per altre informazioni sui nomi dei membri per la proprietà AlgorithmSuite , vedere la proprietà Della suite di algoritmi nella finestra di dialogo Proprietà trasporto WCF-NetTcp, Invia, Sicurezza nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori. |
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). Valore predefinito: Basic256 |
| ClientCertificate | string | Specifica l'identificazione personale del certificato X.509 per l'autenticazione della porta di trasmissione per i servizi. Questa proprietà è necessaria se la proprietà ClientCredentialsType è impostata su Certificate. Il certificato da usare per questa proprietà deve essere installato nell'archivio personale nel percorso utente corrente . Il valore predefinito è una stringa vuota. |
| AffiliateApplicationName | string | Specifica l'applicazione affiliata da utilizzare per Enterprise Single Sign-On (SSO). Il valore predefinito è una stringa vuota. |
| UseSSO | Boolean | Specificare se deve essere utilizzato il servizio Single Sign-On per recuperare le credenziali del client per l'autenticazione con il server di destinazione. Valore predefinito: False |
| UserName | string | Specificare il nome utente da usare per l'autenticazione con il server di destinazione quando la proprietà UseSSO è impostata su False. Non è necessario utilizzare il formato dominio\utente per questa proprietà. Il valore predefinito è una stringa vuota. |
| Password | string | Specificare la password da usare per l'autenticazione con il server di destinazione quando la proprietà UseSSO è impostata su False. Il valore predefinito è una stringa vuota. |
| OutboundBodyLocation | Enumerazione - UseBodyElement : usare la parte del corpo del messaggio BizTalk per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita. - UseTemplate : usare il modello fornito nella proprietà OutboundXMLTemplate per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita. Per altre informazioni su come usare la proprietà OutboundBodyLocation , vedere Specifica del corpo del messaggio per gli adapter WCF. |
Specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in uscita. Valore predefinito: UseBodyElement |
| OutboundXMLTemplate | string Per altre informazioni su come usare la proprietà OutboundXMLTemplate , vedere Specifica del corpo del messaggio per gli adapter WCF. |
Specificare il modello formattato XML per il contenuto dell'elemento SOAP Body di un messaggio in uscita. Questa proprietà è necessaria se la proprietà OutboundBodyLocation è impostata su UseTemplate. Il valore predefinito è una stringa vuota. |
| InboundBodyLocation | Enumerazione - UseBodyElement : usare il contenuto dell'elemento SOAP Body di un messaggio in ingresso per creare la parte del 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. - UseEnvelope : creare la parte del corpo del messaggio BizTalk dall'intera busta SOAP di un messaggio in ingresso. - UseBodyPath : usare l'espressione del percorso del corpo nella proprietà InboundBodyPathExpression per creare la parte del 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 altre informazioni su come usare la proprietà InboundBodyLocation , vedere Specifica del corpo del messaggio per gli adapter WCF. |
Specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in ingresso. Valore predefinito: UseBodyElement |
| InboundBodyPathExpression | string Per altre informazioni su come usare la proprietà InboundBodyPathExpression , vedere Schema e proprietà delle schede WCF. |
Specificare 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 la proprietà InboundBodyLocation è impostata su UseBodyPath. Questa proprietà è valida solo per le porte sollecitazione-risposta. Il valore predefinito è una stringa vuota. |
| InboundNodeEncoding | Enumerazione - XML - 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 in InboundBodyPathExpression. |
Specificare il tipo di codifica usato dall'adattatore di invio WCF-NetTcp per decodificare il nodo identificato da XPath specificato in InboundBodyPathExpression. Questa proprietà è necessaria se la proprietà InboundBodyLocation è impostata su UseBodyPath. Questa proprietà è valida solo per le porte sollecitazione-risposta. Valore predefinito: XML |
| PropagateFaultMessage | Boolean - True : instradare il messaggio che ha esito negativo nell'elaborazione in uscita a un'applicazione di sottoscrizione, ad esempio un'altra pianificazione di ricezione o orchestrazione. - False : sospendere i messaggi non riusciti e generare un riconoscimento negativo (NACK). |
Specifica se eseguire il routing o sospendere i messaggi per i quali non è stato possibile eseguire l'elaborazione in uscita. Questa proprietà è valida solo per le porte sollecitazione-risposta. Valore predefinito: True |
Come configurare una porta di trasmissione WCF-NetTcp con la Console di amministrazione BizTalk
È possibile impostare le variabili dell'adapter della porta di trasmissione WCF-NetTcp nella Console di amministrazione BizTalk. Se non vengono impostate proprietà per la porta di trasmissione, vengono utilizzati i valori predefiniti per la configurazione della porta di trasmissione WCF-NetTcp, come indicato nella tabella precedente.
Configurare le variabili per una porta di trasmissione WCF-NetTcp
Nella Console di amministrazione BizTalk creare una nuova porta di trasmissione oppure fare doppio clic su una porta di trasmissione esistente per modificarla. Per altre informazioni, vedere Come creare una porta di invio. Configurare tutte le opzioni di porta di invio e specificare WCF-NetTcp per l'opzione Tipo nella sezione Trasporto della scheda Generale .
Nella scheda Generale , nella sezione Trasporto fare clic sul pulsante Configura accanto a Tipo.
Nella scheda Generale della finestra di dialogo Proprietà trasporto WCF-NetTcp configurare l'indirizzo dell'endpoint, l'identità del servizio e l'intestazione SOAPAction per la porta di trasmissione WCF-NetTcp. Per altre informazioni sulla scheda Generale nella finestra di dialogo Proprietà trasporto WCF-NetTcp, vedere la finestra di dialogo Proprietà trasporto WCF-NetTcp, Invia, Generale nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori.
Nella scheda Binding della finestra di dialogo Proprietà trasporto WCF-NetTcp configurare le proprietà di timeout e transazioni. Per altre informazioni sulla scheda Binding nella finestra di dialogo Proprietà trasporto WCF-NetTcp, vedere la finestra di dialogo Proprietà trasporto WCF-NetTcp, Invia, Binding nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori.
Nella scheda Sicurezza della finestra di dialogo Proprietà trasporto WCF-NetTcp definire le funzionalità di sicurezza della porta di trasmissione WCF-NetTcp. Per altre informazioni sulla scheda Sicurezza nella finestra di dialogo Proprietà trasporto WCF-NetTcp, vedere la finestra di dialogo Proprietà trasporto WCF-NetTcp, Invia, Sicurezza nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori.
Nella finestra di dialogo Proprietà trasporto WCF-NetTcp specificare la selezione dei dati per l'elemento SOAP Body. Per altre informazioni sulla scheda Messaggi nella finestra di dialogo Proprietà trasporto WCF-NetTcp, vedere la finestra di dialogo Proprietà trasporto WCF-NetTcp, Invia, Messaggi nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori.
Configurare una porta di trasmissione WCF-NetTcp a livello di codice
Per impostare le proprietà, è possibile utilizzare il seguente formato:
<CustomProps>
<UseSSO vt="11">0</UseSSO>
<InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
<InboundBodyPathExpression vt="8" />
<MessageClientCredentialType vt="8">Windows</MessageClientCredentialType>
<SendTimeout vt="8">00:01:00</SendTimeout>
<OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
<OpenTimeout vt="8">00:01:00</OpenTimeout>
<AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
<SecurityMode vt="8">Transport</SecurityMode>
<TransportClientCredentialType vt="8">Windows</TransportClientCredentialType>
<ClientCertificate vt="8" />
<TransactionProtocol vt="8">OleTransactions</TransactionProtocol>
<MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
<StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>
<TransportProtectionLevel vt="8">EncryptAndSign</TransportProtectionLevel>
<CloseTimeout vt="8">00:01:00</CloseTimeout>
<EnableTransaction vt="11">0</EnableTransaction>
<InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
<PropagateFaultMessage vt="11">-1</PropagateFaultMessage>
<OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>
Nel frammento di codice riportato di seguito viene illustrata la creazione di una porta di trasmissione WCF-NetTcp:
// Use BizTalk Explorer object model to create new WCF-NetTcp send port.
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
string transportConfigData = @"<CustomProps>
<StaticAction vt=""8"">http://www.northwindtraders.com/Service/Operation</StaticAction>
<OpenTimeout vt=""8"">00:01:00</OpenTimeout>
</CustomProps>";
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new BizTalk application
Application application = explorer.AddNewApplication();
application.Name = "SampleBizTalkApplication";
// Save
explorer.SaveChanges();
// Add a new static one-way send port
SendPort sendPort = application.AddNewSendPort(false, false);
sendPort.Name = "SampleSendPort";
sendPort.PrimaryTransport.TransportType = explorer.ProtocolTypes["WCF-NetTcp"];
sendPort.PrimaryTransport.Address = "net.tcp://mycomputer/private/samplequeue";
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Save
explorer.SaveChanges();
Vedere anche
Schema e proprietà delle schede WCF Specificando il corpo del messaggio per gli adattatori WCFche installano certificati per gli adattatori WCFConfigurando la scheda di WCF-NetTcp Configurazione delle porte di trasmissione dinamiche tramite le proprietà del contesto degli adattatori WCF