Condividi tramite

Come configurare una porta di trasmissione SOAP

  • Articolo

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

Come configurare una porta di trasmissione SOAP a livello di codice

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 SOAP sotto forma di coppia nome-valore di stringhe XML. Si noti che per impostare questa proprietà nel modello a oggetti di BizTalk Explorer è prima necessario impostare la proprietà OutboundTransportLocation dell'interfaccia ITransportInfo .

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 SOAP, 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 SOAP.

Nome proprietà Type Descrizione
URI string Directory virtuale contenente il servizio Web nel server di distribuzione.
Nome utente string Nome utente da specificare per l'accesso al servizio Web di destinazione.

Valore predefinito: vuoto
Password string Password utente da utilizzare per l'autenticazione con il server.

Valore predefinito: vuoto
ClientCertificate string Identificazione personale del certificato SSL del client.

Valore predefinito: vuoto
AffiliateApplicationName string Nome dell'applicazione SSO da utilizzare per riscattare il ticket per le credenziali client.

AffiliateApplicationName si escludono a vicenda a una coppia Nome utente e Password.

Valore predefinito: vuoto
UseProxy Boolean Indica se la porta SOAP utilizzerà un server proxy per accedere al servizio Web di destinazione. Il server proxy può essere condiviso da tutte le porte di trasmissione SOAP.

Valore predefinito: False
ProxyAddress string Indirizzo del proxy HTTP da utilizzare per la chiamata del servizio Web.

Valore predefinito: vuoto
ProxyPort Integer Porta del proxy HTTP da utilizzare per la chiamata del servizio Web.

Valore predefinito: vuoto
ProxyUsername string Nome utente da utilizzare per il proxy.

Valore predefinito: vuoto
ProxyPassword string Password da utilizzare per il proxy.

Valore predefinito: vuoto

Nel codice riportato di seguito viene illustrato il formato da utilizzare per impostare queste proprietà:

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>

Come configurare una porta di trasmissione SOAP con la Console di amministrazione BizTalk Server

È possibile impostare le variabili dell'adattatore di porta di trasmissione SOAP nella console di amministrazione di 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.

Per configurare le variabili per una porta di trasmissione SOAP

  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 SOAP per l'opzione Tipo nella sezione Trasporto della scheda Generale .

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

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

    Usare Per
    URL servizio Web Specificare l'indirizzo del servizio Web che si desidera chiamare. Nota: L'URI per una porta di trasmissione o una posizione di ricezione non può superare i 256 caratteri.
    autenticazione Indicare il metodo di autenticazione utilizzato da servizio Web da chiamare.

    Opzioni:

    - Anonimo. Impostazione predefinita.
    - Base. La connessione SOAP invia il nome utente e la password in testo normale.
    - Digerire. La connessione SOAP invia la password in un formato crittografato.
    - NTLM. Né il nome utente né la password vengono inviati tramite una connessione SOAP. L'adapter SOAP utilizza sempre le credenziali del processo nel quale è in esecuzione per questo tipo di autenticazione.
    Credenziali Specificare il tipo di credenziali da utilizzare.

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

    Opzioni:

    - Non usare Single Sign-On
    Nome utente
    Nome utente da utilizzare per l'autenticazione con il server di destinazione. Se la proprietà Tipo di autenticazione è Anonima o NTLM, questa opzione è disabilitata. Questa proprietà richiede un valore se è selezionata l'opzione Basic o Digest e l'opzione Enterprise Single Sign-On non viene utilizzata.
    Lunghezza minima: 0
    Lunghezza massima: 256
    Password
    Password utente da utilizzare per l'autenticazione con il server di destinazione. Se la proprietà Tipo di autenticazione è Anonima o NTLM, questa opzione è disabilitata. Questa proprietà richiede un valore se è selezionata l'opzione Basic o Digest e l'opzione Single Sign-On non viene utilizzata.
    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 affiliata
    Specificare l'applicazione affiliata da utilizzare per Single Sign-On. Per informazioni sul popolamento di questo elenco, vedere Applicazioni affiliate SSO.
    Lunghezza minima: 0
    Lunghezza massima: 256
    Identificazione personale del certificato client Specificare l'identificazione personale del certificato client da utilizzare per stabilire una connessione.

    Esempio: 01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67

    Lunghezza minima: 0

    Lunghezza massima: 59

  4. Nella scheda Proxy della finestra di dialogo Proprietà trasporto SOAP eseguire le operazioni seguenti:

    Usare Per
    Utilizza configurazione proxy predefinita del gestore Specificare la configurazione del gestore proxy della porta di trasmissione. Se è true, la porta 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.

    L'impostazione predefinita è true.
    Non usare il proxy Indicare se il gestore di trasmissione SOAP utilizza o meno un server proxy.
    Usa proxy Indicare se il gestore di trasmissione SOAP utilizza o meno un server proxy. Il server proxy può essere condiviso da tutte le porte di trasmissione SOAP.
    Server Specificare il nome del server proxy.

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

    Tipo: String

    Lunghezza minima: 0

    Lunghezza massima: 256
    Porta Specificare la porta utilizzata dal gestore di trasmissione SOAP.

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

    Valore predefinito: 80

    Tipo: Long

    Valore minimo: 0

    Valore massimo: 65535 Nota: specificando un valore pari a 0 indica di usare il valore predefinito, ovvero la porta 80.
    Nome utente Specificare il nome utente da utilizzare per l'autenticazione. Se si usa l'autenticazione integrata di Windows, il nome utente include il dominio, dominio\nomeutente. Se si usa l'autenticazione Basic o Digest, il nome utente non include domain\.

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

    Tipo: String

    Lunghezza minima: 0

    Lunghezza massima: 256
    Password Specificare la password da utilizzare per l'autenticazione.

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

    Tipo: String

    Lunghezza minima: 0

    Lunghezza massima: 256

  5. Nella scheda Servizio Web della finestra di dialogo Proprietà trasporto SOAP eseguire le operazioni seguenti:

    Usare Per
    Porta Web orchestrazione Specificare per usare il servizio Web esposto nell'URL del servizio Web elencato nella scheda Generale .

    Si tratta dell'impostazione predefinita.
    Nome assembly Specificare il nome dell'assembly che contiene il proxy del servizio Web. Per compilare questo campo è possibile fare clic sul pulsante Sfoglia e selezionare l'assembly desiderato. Dopo aver selezionato l'assembly, nella casella viene immesso automaticamente il nome completo dell'assembly. Nota: L'assembly specificato deve essere presente in tutti i server BizTalk in fase di esecuzione.
    Nome tipo Specificare il nome della classe che contiene il metodo Web da richiamare. Tale nome può essere selezionato in un elenco di tipo contenuti nell'assembly.
    Nome del metodo Specificare uno dei metodi nella casella di riepilogo oppure scegliere l'opzione "Specifica in seguito". Se si sceglie l'opzione "Specifica in seguito", il metodo Web dovrà essere impostato con l'utilizzo di altri strumenti, ad esempio mediante un componente della pipeline. In questo scenario, il metodo Web deve essere scritto nella proprietà di contesto MethodName dell'adapter Soap.
    SOAP 1.2 Specificare questa opzione per generare codice proxy che supporti il protocollo SOAP 1.2. Se non si seleziona questa opzione, verrà generato codice proxy compatibile con SOAP 1.1.

    Valore predefinito: deselezionato

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

Vedere anche

Pubblicazione di servizi Web