Condividi tramite

Come configurare una porta di trasmissione HTTP

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

Configurare una porta di trasmissione HTTP a livello di codice

L'adapter HTTP archivia le informazioni di configurazione nel database di gestione BizTalk , noto anche come database di configurazione. Le informazioni di configurazione sono archiviate in un contenitore di proprietà XML personalizzato. Durante l'inizializzazione della scheda HTTP e durante il relativo runtime, il server passa la configurazione all'adapter come indicato di seguito:

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

  • Per le porte di trasmissione HTTP, le informazioni di configurazione passano all'adapter come set di proprietà in un contesto di messaggio. Lo spazio dei nomi HTTP raggruppa queste proprietà.

    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. Questa proprietà accetta l'insieme delle proprietà di configurazione della porta di invio HTTP come stringa XML di coppie nome/valore. Si noti che per impostare questa proprietà nel modello a oggetti di BizTalk Explorer, deve prima essere impostata sulla Address proprietà dell'interfaccia ITransportInfo .

    L'impostazione della proprietà TransportTypeData dell'interfaccia ITransportInfo non è obbligatoria. Se non è impostata, l'adapter HTTP userà 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 sono definite, vengono usate le proprietà di configurazione per il gestore. Se il gestore di trasmissione HTTP non dispone di valori di configurazione, l'adapter di invio HTTP registra un errore nel registro eventi e sposta il messaggio nell'adattatore 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 Server o in componenti della pipeline personalizzati. Quando si usano queste proprietà, si applicano le regole seguenti:

  • Se la proprietà di configurazione è impostata su un'orchestrazione o in un componente della pipeline personalizzata nella pipeline di ricezione, allora:

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

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

  • Se la proprietà di configurazione è impostata in un componente personalizzato della pipeline di invio, allora:

    • 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 elencate le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per il percorso di invio HTTP.

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

Valore massimo: MAX_LONG		 Valore predefinito: 0
TipoDiContenuto 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 in 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 userà la configurazione proxy per il gestore di trasmissione. Nessuno Valore predefinito: Vero

Se true, la porta di trasmissione userà le impostazioni proxy specificate a livello di gestore. Se false, l'adattatore di trasmissione userà le informazioni del proxy specificate sulla porta di trasmissione.
UseProxy xs:boolean Specifica se l'adattatore HTTP userà il server proxy. Il server proxy può essere condiviso da tutte le porte di trasmissione HTTP. Nessuno Valore predefinito: Falso

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'adapter di trasmissione HTTP ignora questa proprietà se la proprietà UseHandlerProxySettings è impostata su True. In caso contrario, l'adapter 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 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 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 usare con il server di destinazione. Nessuno Valori validi:

- Anonimo (impostazione predefinita)
- Basico
- Sommario
- Kerberos
Nome utente xs:string Nome utente da usare 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'adapter HTTP ignora il valore di questa proprietà se UseSSO è True.
Parola d’ordine xs:string Password utente da usare 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 la codifica in blocchi viene utilizzata dall'adapter HTTP Nessuno Valore predefinito:

Vero
Certificato xs:string Impronta digitale del certificato SSL del client. Lunghezza minima: 0

Lunghezza massima: 59		 Valore predefinito: Vuoto
Usare Single Sign-On xs:boolean Specifica se si utilizzerà il Single Sign-On per il porto di invio. Nessuno Valore predefinito: Falso
AffiliateApplicationName xs:string Nome dell'applicazione affiliata da usare per l'accesso SSO. Lunghezza minima: 0

Lunghezza massima: 256		 Valore predefinito: vuoto

Obbligatorio se UseSSO è True.

Il codice seguente illustra la stringa XML da usare 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'adattatore porta di trasmissione HTTP nella console di amministrazione di BizTalk Server. Se le proprietà non sono impostate per la porta di trasmissione, vengono usati i valori predefiniti del gestore di invio impostati nella console di amministrazione di BizTalk Server.

Annotazioni

Le proprietà di configurazione descritte in questo argomento sono comuni per le porte di trasmissione HTTP unidirezionale e request-response.

  1. Nella console di amministrazione di BizTalk Server creare una nuova porta di trasmissione o 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 questo Per farlo
    URL di destinazione Obbligatorio. Specificare l'indirizzo per inviare richieste HTTP. Includere stringhe di query aggiunte all'URL di base.

    Tipo: 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.
    Abilitare la codifica in blocchi Specificare per usare la codifica in blocchi. Se questa opzione è abilitata, l'adattatore HTTP userà la codifica in blocchi HTTP con dimensioni massime di 8 KB. La codifica in blocchi è disabilitata in modo implicito se il gestore di invio HTTP è configurato in Usa proxy.

    Digitare: Booleano

    Valore predefinito: Vero
    Timeout della richiesta (sec) Specificare il timeout in secondi per la trasmissione HTTP/HTTPS. Se l'adapter HTTP non riceve la risposta entro questo periodo, il servizio registra l'errore e invia di nuovo il messaggio in base all'infrastruttura di ripetizione dei tentativi.

    Se impostato su zero (0), il motore di messaggistica BizTalk calcola il timeout in base alle dimensioni del messaggio di richiesta. Se non si specifica un valore, viene utilizzato il valore del gestore.

    Digitare: Lungo

    Valore minimo: 0

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

    Valore predefinito: 5

    Tipo: Int

    Valore minimo: 0

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

    Se questo valore non è impostato, viene usato il valore per il gestore.

    Tipo: Stringa

    Lunghezza minima: 0

    Lunghezza massima: 256

  4. Nella finestra di dialogo Proprietà trasporto HTTP, nella scheda Proxy (override del gestore), esegui le operazioni seguenti:

    Usare questo Per farlo
    Usare la configurazione proxy predefinita del gestore Specificare che la configurazione della porta di trasmissione deve usare le impostazioni proxy specificate per il gestore di trasmissione HTTP.

    Questa è l'impostazione predefinita.
    Non usare il proxy Specificare se il gestore di trasmissione HTTP usa il server proxy.

    Se questa opzione è selezionata, il gestore di trasmissione HTTP per questa porta di trasmissione non usa il server proxy.
    Usare il proxy Specificare se il gestore di trasmissione HTTP usa il server proxy.

    Se selezionato, il gestore di trasmissione HTTP usa il server proxy.
    Server Specificare l'indirizzo del server proxy per questa porta di trasmissione.

    Questa proprietà richiede solo un valore se è selezionata l'opzione Usa proxy .

    Tipo: Stringa

    Lunghezza minima: 0

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

    Questa proprietà richiede solo un valore se è selezionata l'opzione Usa proxy .

    Valore predefinito: 80

    Digitare: Lungo

    Valore minimo: 0

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

    Questa proprietà richiede solo un valore se è selezionata l'opzione Usa proxy .

    Tipo: Stringa

    Lunghezza minima: 0

    Lunghezza massima: 256
    Parola d’ordine Specificare la password utente per l'autenticazione con il server proxy.

    Questa proprietà richiede solo un valore se è selezionata l'opzione Usa proxy .

    Tipo: Stringa

    Lunghezza minima: 0

    Lunghezza massima: 256

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

    Usare questo Per farlo
    Tipo di autenticazione Specificare il tipo di autenticazione da usare con il server di destinazione.

    Le opzioni valide sono:

    - Anonimo
    - Basico
    - Sommario
    - Kerberos

    Valore predefinito: Anonimo
    credenziali Specificare il tipo di credenziali da usare.

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

    Le opzioni valide sono:

    - Non utilizzare l'accesso Single Sign-On
    Nome utente:
    Nome utente da usare per l'autenticazione con il server di destinazione. Se la proprietà Tipo di autenticazione è Anonima o Kerberos, questa opzione è disabilitata. Questa proprietà richiede un valore se è selezionata l'opzione Basic o Digest e non viene utilizzata la Sign-On Enterprise Single.
    Lunghezza minima: 0
    Lunghezza massima: 256
    Parola d’ordine:
    Password da usare per l'autenticazione con il server di destinazione. Se la proprietà Tipo di autenticazione è Anonima o Kerberos, questa opzione è disabilitata. Questa proprietà richiede un valore se è selezionata l'opzione Basic o Digest e non viene utilizzata l'Sign-On Single.
    Lunghezza minima: 0
    Lunghezza massima: 256
    - Usare l'Accesso Unico
    Specificare se usare Single Sign-On per recuperare le credenziali client per l'autenticazione con il server di destinazione.
    Applicazione affiliata
    Specifica l'applicazione affiliata da usare per Single Sign-On.
    Scegliere le applicazioni da includere in Single Sign-On.
    Lunghezza minima: 0
    Lunghezza massima: 256
    Impronta digitale del certificato client SSL Specificare l'impronta digitale del certificato del client da usare 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

  • Last updated on