Condividi tramite

Come configurare una porta di trasmissione HTTP

  • Articolo

È possibile configurare una porta di trasmissione HTTP a livello di codice o tramite la Console di amministrazione BizTalk.

Configurare una porta di trasmissione HTTP a livello di codice

L'adapter HTTP archivia le rispettive informazioni di configurazione nel database di gestione BizTalk (detto anche database di configurazione). Le informazioni di configurazione vengono archiviate in un elenco delle proprietà XML personalizzato. Durante l'inizializzazione dell'adapter HTTP e durante il relativo runtime, il server passa la configurazione all'adapter come segue:

  • Per il gestore di trasmissione HTTP, le informazioni di configurazione passano all'adattatore chiamando il metodo Load dell'interfaccia IPersistPropertyBag .

  • Per le porte di trasmissione HTTP, le informazioni di configurazione vengono passate all'adapter sotto forma di set di proprietà in un contesto di messaggio. Tali proprietà sono raggruppate nello spazio dei nomi HTTP.

    Il modello a oggetti di BizTalk Explorer espone l'interfaccia di configurazione dell'adapter ItransportInfo per le porte di trasmissione, che contiene la TransportTypeData proprietà di lettura/scrittura. Tale proprietà accetta l'elenco delle proprietà di configurazione della porta di trasmissione HTTP come stringa XML costituita dalla coppia nome/valore. Si noti che per impostare questa proprietà nel modello a oggetti di BizTalk Explorer, è innanzitutto necessario impostarla sulla Address proprietà dell'interfaccia ITransportInfo .

    L'impostazione della proprietà TransportTypeData dell'interfaccia ITransportInfo non è obbligatoria. Se non viene impostata, l'adapter HTTP utilizzerà i valori predefiniti per il gestore di trasmissione HTTP.

    Se le proprietà di configurazione della porta di trasmissione che duplicano la configurazione per il gestore non vengono definite, verranno utilizzate le proprietà di configurazione del gestore. Se nel gestore di trasmissione HTTP non sono presenti valori di configurazione, l'adapter di trasmissione HTTP registrerà un errore nel registro eventi e sposterà il messaggio nell'adapter di backup.

    È possibile impostare le proprietà di configurazione a livello di codice in un contesto di messaggio. È possibile impostare queste proprietà in una pianificazione dell'orchestrazione di BizTalk o in un componente della pipeline personalizzato. Di seguito sono riportate le regole applicate per l'utilizzo di queste proprietà.

  • Se la proprietà di configurazione viene impostata in un'orchestrazione o in un componente della pipeline personalizzato in una pipeline di ricezione, vengono applicate le regole seguenti:

    • Se viene inviato un messaggio a una porta di trasmissione statica, il valore della proprietà verrà sovrascritto dal valore configurato per tale porta.

    • Se viene inviato un messaggio a una porta di trasmissione dinamica, il valore della proprietà non verrà sovrascritto.

  • Se la proprietà di configurazione viene impostata in un componente della pipeline personalizzato in una pipeline di trasmissione, vengono applicate le regole seguenti:

    • Il valore non verrà sovrascritto indipendentemente dal fatto che il messaggio venga inviato a una porta di trasmissione statica o dinamica.

    Nella tabella seguente sono illustrate le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per l'indirizzo di trasmissione HTTP.

Nome proprietà Type Descrizione Restrizioni Commenti
RequestTimeout xs:int Periodo di timeout in attesa di una risposta dal server. Se impostato su zero (0), il sistema calcola il timeout in base alla dimensione del messaggio di richiesta. Valore minimo: 0

Valore massimo: MAX_LONG		 Valore predefinito: 0
Contenttype xs:string Tipo di contenuto dei messaggi di richiesta. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: Testo/XML
MaxRedirects xs:int Numero massimo di volte per cui l'adapter HTTP può reindirizzare la richiesta. Valore minimo: 0

Valore massimo: 10		 Valore predefinito: 5
UseHandlerProxySettings xs:boolean Specifica se la porta di trasmissione HTTP utilizzerà la configurazione del proxy per il gestore di trasmissione. Nessuno Valore predefinito: Vero

Quando è true, la porta di trasmissione utilizzerà le impostazioni del proxy specificate a livello di gestore. Se è false, l'adapter di trasmissione utilizzerà le informazioni relative al proxy specificate nella porta di trasmissione.
UseProxy xs:boolean Specifica se l'adapter HTTP utilizzerà il server proxy. Il server proxy può essere condiviso da tutte le porte di trasmissione HTTP. Nessuno Valore predefinito: False

Questa proprietà viene ignorata se UseHandlerProxySettings è True.
ProxyName xs:string Specifica il nome del server proxy. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: Vuoto

L'adattatore di trasmissione HTTP ignora questa proprietà se la proprietà UseHandlerProxySettings è impostata su True. In caso contrario, l'adattatore di trasmissione HTTP usa questa proprietà solo se UseProxy è True. Questa proprietà è obbligatoria se UseProxy è True.
ProxyPort xs:int Specifica la porta del server proxy. Valore minimo: 0

Valore massimo: 65535		 Valore predefinito: 80

L'adapter di trasmissione HTTP ignora questa proprietà se UseHandlerProxySettings è True. In caso contrario, l'adapter di trasmissione HTTP usa questa proprietà solo se UseProxy è True. Questa proprietà è obbligatoria se UseProxy è True.
ProxyUsername xs:string Specifica il nome utente da utilizzare per l'autenticazione con il server proxy. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: vuoto

L'adapter di trasmissione HTTP ignora questa proprietà se UseHandlerProxySettings è True. In caso contrario, l'adapter di trasmissione HTTP usa questa proprietà solo se UseProxy è True.
ProxyPassword xs:string Specifica la password utente da utilizzare per l'autenticazione con il server proxy. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: vuoto

L'adapter di trasmissione HTTP ignora questa proprietà se UseHandlerProxySettings è True. In caso contrario, l'adapter di trasmissione HTTP usa questa proprietà solo se UseProxy è True.
AuthenticationScheme xs:string Tipo di autenticazione da utilizzare con il server di destinazione. Nessuno Valori validi:

- Anonimo (impostazione predefinita)
- Base
- Digerire
- Kerberos
Nome utente xs:string Nome utente da utilizzare per l'autenticazione con il server. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: Vuoto

Questo valore è obbligatorio se si seleziona Autenticazione di base o Digest . L'adattatore HTTP ignora il valore di questa proprietà se UseSSO è True.
Password xs:string Password utente da utilizzare per l'autenticazione con il server. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: vuoto

Questo valore è obbligatorio se si seleziona Autenticazione di base o Digest . Il valore di questa proprietà viene ignorato se UseSSO è True.
EnableChunkedEncoding xs:boolean Specifica se da parte dell'adapter HTTP viene utilizzata o meno la codifica Chunked. Nessuno Valore predefinito:

Vero
Certificate xs:string Identificazione personale del certificato SSL del client. Lunghezza minima: 0

Lunghezza massima: 59		 Valore predefinito: Vuoto
UseSSO xs:boolean Specifica se verrà utilizzato SSO per la porta di trasmissione. Nessuno Valore predefinito: False
AffiliateApplicationName xs:string Nome dell'applicazione affiliata da utilizzare per SSO. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: vuoto

Obbligatorio se UseSSO è True.

Nel codice riportato di seguito viene illustrata la stringa XML da utilizzare per impostare queste proprietà:

<CustomProps>  
   <ContentType vt="8">text/xml</ContentType>  
   <RequestTimeout vt="3">0</RequestTimeout>  
   <MaxRedirects vt="3">5</MaxRedirects>  
   <UseHandlerProxySettings vt="8">-1</UseHandlerProxySettings>  
   <UseProxy vt="8">-1</UseProxy>  
   <ProxyName vt="8">sdfsd</ProxyName>  
   <ProxyPort vt="3">80</ProxyPort>  
   <ProxyUsername vt="8">Somename</ProxyUsername>  
   <ProxyPassword vt="8">Somepassword</ProxyPassword>  
   <AuthenticationScheme vt="8">Basic</AuthenticationScheme>  
   <Username vt="8">Somename</Username>  
   <Password vt="8">Somepassword</Password>  
   <EnableChunkedEncoding vt="11">1</EnableChunkedEncoding>  
   <Certificate vt="8">AAAA BBBB CCCC DDDD</Certificate>  
   <UseSSO vt="11">0</UseSSO>  
   <AffiliateApplicationName vt="8">Name</AffiliateApplicationName>  
</CustomProps>

Configurare una porta di trasmissione HTTP con la console di amministrazione di BizTalk Server

È possibile impostare le variabili dell'adapter della porta di trasmissione HTTP nella Console di amministrazione BizTalk Server. Se non vengono impostate proprietà per la porta di trasmissione, verranno utilizzati i valori del gestore di trasmissione predefinito impostati nella Console di amministrazione BizTalk Server.

Nota

Le proprietà di configurazione descritte in questo argomento sono comuni per le porte di trasmissione HTTP sia unidirezionali che di tipo richiesta-risposta.

  1. Nella Console di amministrazione BizTalk Server 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 trasmissione . Configurare tutte le opzioni della porta di trasmissione e specificare HTTP per l'opzione Tipo nella sezione Trasporto della scheda Generale .

  2. Nella sezione Trasporto della scheda Generale fare clic sul pulsante Configura accanto a Tipo.

  3. Nella scheda Generale della finestra di dialogo Proprietà trasporto HTTP eseguire le operazioni seguenti:

    Usare Per
    URL di destinazione Obbligatorio. Specificare l'indirizzo per l'invio delle richieste HTTP. Aggiungere le stringhe di query all'URL di base.

    Digitare: Stringa

    Lunghezza massima: 256

    Per altre informazioni, vedere Restrizioni per la proprietà URL di destinazione. Nota: L'URI per una porta di trasmissione o una posizione di ricezione non può superare i 256 caratteri.
    Abilita codifica Chunked Specifica di utilizzare la codifica Chunked. Se questa opzione è attivata, l'adapter HTTP utilizzerà la codifica Chunked HTTP con una dimensione massima del blocco di 8 KB. La codifica in blocchi è disabilitata in modo implicito se il gestore di trasmissione HTTP è configurato per l'uso del proxy.

    Digitare: Boolean

    Valore predefinito: Vero
    Timeout richieste (secondi) Specifica il timeout in secondi per la trasmissione HTTP/HTTPS. Se l'adapter HTTP non riceve risposta entro il periodo di tempo specificato, il servizio registrerà l'errore e rinvierà il messaggio in base alle impostazioni per la riesecuzione.

    Se impostato su zero (0), il timeout viene calcolato automaticamente dal motore di messaggistica BizTalk in base alla dimensione del messaggio di richiesta. Se non viene fornito alcun valore, verrà utilizzato il valore per il gestore.

    Digitare: Lungo

    Valore minimo: 0

    Valore massimo: MAX_LONG
    Numero massimo reindirizzamenti Specificare il numero massimo di reindirizzamenti consentiti per il messaggio da inviare.

    Valore predefinito: 5

    Digitare: Int

    Valore minimo: 0

    Valore massimo: 10
    Tipo di contenuto Specificare il tipo di contenuto dei messaggi di richiesta.

    Se non viene specificato un valore, verrà utilizzato il valore fornito per il gestore.

    Digitare: Stringa

    Lunghezza minima: 0

    Lunghezza massima: 256

  4. Nella scheda Proxy (override gestore) della finestra di dialogo Proprietà trasporto HTTP eseguire le operazioni seguenti:

    Usare Per
    Utilizza configurazione proxy predefinita del gestore Specificare che per la configurazione della porta di trasmissione devono essere utilizzate le impostazioni proxy specificate per il gestore di trasmissione HTTP.

    Si tratta dell'impostazione predefinita.
    Non usare il proxy Specificare se il gestore di trasmissione HTTP utilizza il server proxy.

    Se l'opzione è selezionata, il gestore di trasmissione HTTP non utilizzerà il server proxy per questa porta di trasmissione.
    Usa proxy Specificare se il gestore di trasmissione HTTP utilizza il server proxy.

    Se selezionato, il gestore di trasmissione HTTP utilizzerà il server proxy.
    Server Specificare l'indirizzo del server proxy per la porta di trasmissione.

    Questa proprietà richiede solo un valore se è selezionato Use proxy .

    Digitare: Stringa

    Lunghezza minima: 0

    Lunghezza massima: 256
    Porta Specificare la porta del server proxy per la porta di trasmissione.

    Questa proprietà richiede solo un valore se è selezionato Use proxy .

    Valore predefinito: 80

    Digitare: Lungo

    Valore minimo: 0

    Valore massimo: 65535
    Nome utente Specificare il nome utente da utilizzare per l'autenticazione con il server proxy.

    Questa proprietà richiede solo un valore se è selezionato Use proxy .

    Digitare: Stringa

    Lunghezza minima: 0

    Lunghezza massima: 256
    Password Specificare la password utente da utilizzare per l'autenticazione con il server proxy.

    Questa proprietà richiede solo un valore se è selezionato Use proxy .

    Digitare: Stringa

    Lunghezza minima: 0

    Lunghezza massima: 256

  5. Nella scheda Autenticazione della finestra di dialogo Proprietà trasporto HTTP eseguire le operazioni seguenti:

    Usare Per
    Tipo di autenticazione Specifica il tipo di autenticazione da utilizzare con il server di destinazione.

    Le opzioni valide sono:

    - Anonimo
    - Base
    - Digerire
    - Kerberos

    Valore predefinito: Anonimo
    Credenziali Specificare il tipo di credenziali da utilizzare.

    Disponibile solo se il tipo di autenticazione è Basic o Digest.

    Le opzioni valide sono:

    - Non usare Single Sign-On
    Nome utente:
    Nome utente da utilizzare per l'autenticazione con il server di destinazione. Se la proprietà Authentication Type è Anonima o Kerberos, questa opzione è disabilitata. Questa proprietà richiede un valore se l'opzione Basic o Digest è selezionata e non viene utilizzata la Sign-On Single Enterprise.
    Lunghezza minima: 0
    Lunghezza massima: 256
    Password:
    Password utente da utilizzare per l'autenticazione con il server di destinazione. Se la proprietà Authentication Type è Anonima o Kerberos, questa opzione è disabilitata. Questa proprietà richiede un valore se l'opzione Basic o Digest è selezionata e l'Sign-On single non viene usato.
    Lunghezza minima: 0
    Lunghezza massima: 256
    - Usare Single Sign-On
    Specificare se deve essere utilizzato il servizio Single Sign-On per recuperare le credenziali del client per l'autenticazione con il server di destinazione.
    Applicazione di affiliazione
    Specificare l'applicazione affiliata da utilizzare per Single Sign-On.
    Scegliere le applicazioni che si desidera includere nel servizio Single Sign-On.
    Lunghezza minima: 0
    Lunghezza massima: 256
    Identificazione personale del certificato client SSL Specificare l'identificazione personale del certificato client da utilizzare per stabilire una connessione SSL (Secure Sockets Layer).

    Lunghezza minima: 0

    Lunghezza massima: 59

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

Vedere anche

Configurazione di una porta di trasmissione HTTP