Come abilitare i punti di estendibilità WCF con gli adapter WCF

Articolo
07/21/2023

Abilitare tre punti di estendibilità WCF, estensione del comportamento, estensione dell'elemento di associazione e estensione dell'associazione, con le schede di WCF-CustomIsolated e WCF-Custom. A tale scopo, si installano prima gli assembly che implementano i punti di estendibilità WCF nella global assembly cache (GAC), quindi si modifica il file machine.config nei computer e quindi si configura l'WCF-Custom o l'adapter WCF-CustomIsolated usando la console di amministrazione BizTalk Server.

Per altre informazioni sui punti di estendibilità WCF, vedere Estensione WCF .

Prerequisiti

Accedere con un account membro del gruppo Administrators di BizTalk Server. Le autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk forniscono altre informazioni.

Installare gli assembly che implementano un punto di estendibilità WCF nella gaC

Copiare gli assembly che implementano il punto di estendibilità WCF in una cartella sul computer locale.
Copiare gli eventuali assembly utilizzati dal punto di estendibilità WCF in una cartella sul computer locale.
Avviare il prompt dei comandi di Visual Studio.
Digitare il comando seguente:

gacutil.exe /if "<percorso dell'assembly .dll file>"
In questo modo l'assembly viene installato nella GAC sovrascrivendo eventuali assembly esistenti con lo stesso nome.
Al prompt dei comandi di Visual Studio ripetere i passaggi 4 e 5 per tutti gli assembly copiati nei passaggi 1 e 2 di questa procedura.
Se sono presenti BizTalk Server più computer di runtime e computer di amministrazione, ripetere i passaggi da 1 a 6 di questa procedura in tutti i computer.

Nota

Per abilitare i punti di estendibilità WCF per gli adapter WCF, è necessario che l'istanza dell'host BizTalk che esegue l'adapter possa caricare in fase di esecuzione gli assembly in cui sono implementati i punti di estendibilità WCF.

Configurare il file di machine.config per un'estensione di associazione WCF

Al prompt dei comandi passare a %FrameworkDir%\v4. Cartella X.XXXXX\CONFIG e quindi aprire il file dimachine.config usando Blocco note.
Nel Blocco note, se il file machine.config non dispone <degli elementi system.serverModel>\extensions>, aggiungere tali elementi all'interno dell'elemento di configurazione del file machine.config e quindi aggiungere l'elemento bindingExtensions per un'estensione di associazione WCF all'interno degli elementi system.serverModel\<extensions><.><><<> Ad esempio, per abilitare un'estensione di associazione personalizzata, netHttpBinding, aggiungere il codice seguente all'interno <dell'elemento di configurazione> del file machine.config:
```
<system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
      <add name="netHttpBinding" type="Microsoft.Samples.Channels.NetHttpBindingCollectionElement, NetHttpBinding, Version=3.0.0.0, Culture=neutral, PublicKeyToken=5b637b51c4aaa2a8" />  
    </bindingExtensions>        
  </extensions>  
</system.serviceModel>  
```
Nota
- È possibile trovare le informazioni per gli assembly da registrare usando il comando gacutil /lr<assembly_name>.
- Vedere bindingExtensions su questo elemento.
Nel Blocco note salvare il file machine.config.
Se sono presenti più computer di runtime e computer di amministrazione BizTalk Server, ripetere i passaggi da 1 a 3 di questa procedura in tutti i computer.

Nota

È necessario ripetere questi passaggi in tutti i computer per l'infrastruttura WCF per elaborare il punto di estendibilità WCF per l'istanza host BizTalk e la console di amministrazione di BizTalk Server.

Configurare un'estensione di associazione WCF usando la console di amministrazione BizTalk

Aprire BizTalk Server Amministrazione.

Nota

Se la console di amministrazione BizTalk Server è già aperta, riavviare la console di amministrazione BizTalk Server.
Se si usa l'adattatore WCF-Custom, nella console di amministrazione BizTalk Server espandere Impostazioni piattaforma, espandere Istanze host e quindi riavviare l'istanza host BizTalk che esegue l'adapter.
Se si utilizza l'adapter WCF-CustomIsolated, nella Console di gestione IIS riavviare il pool di applicazioni associato all'indirizzo di ricezione WCF.
Se si vuole configurare un percorso di ricezione per usare un punto di estendibilità WCF, nella console di amministrazione BizTalk Server espandere Gruppo BizTalk, espandere <Applicazione> BizTalk, espandere Percorsi di ricezione e quindi nel riquadro destro fare doppio clic su <Posizione> di ricezione.
- Nell'elenco a discesa Tipo della finestra di dialogo Proprietà posizione ricezione selezionare WCF-Custom o WCF-CustomIsolated a seconda dell'adapter WCF da usare e quindi fare clic su Configura.
Se si vuole configurare una porta di invio per usare un punto di estendibilità WCF, nella console di amministrazione di BizTalk Server espandere BizTalk Group, espandere <Applicazione> BizTalk, espandere Porte di trasmissione e quindi nel riquadro destro fare doppio clic su <Invia porta>.
- Nell'elenco a discesa Tipo della finestra di dialogo Invia proprietà porta selezionare WCF-Custom e quindi fare clic su Configura.
Nella scheda Binding della finestra di dialogo Proprietà trasporto selezionare l'estensione di associazione e quindi configurare il resto delle impostazioni per il trasporto.
Nella console di amministrazione BizTalk Server chiudere tutte le finestre di dialogo aperte facendo clic sui pulsanti OK e quindi assicurarsi che non vengano visualizzati messaggi di errore e log eventi errati.

Configurare il file di machine.config per un'estensione dell'elemento di associazione WCF

Al prompt dei comandi passare a %FrameworkDir%\v4. Cartella X.XXXXX\CONFIG e quindi aprire il file dimachine.config usando Blocco note.
Nel Blocco note, se il file machine.config non dispone <degli elementi system.serverModel>\extensions>, aggiungere tali elementi all'interno dell'elemento di configurazione del file machine.config e quindi aggiungere l'elemento bindingElementExtensions per un'estensione dell'elemento di associazione WCF all'interno degli elementi system.serverModel\<extensions><.><><<> Ad esempio, per abilitare un'estensione dell'elemento di associazione personalizzata, eliminareInterceptor, aggiungere il codice seguente all'interno <dell'elemento di configurazione> del file machine.config:
```
<system.serviceModel>  
  <extensions>  
    <bindingElementExtensions>  
      <add name="droppingInterceptor" type="Microsoft.ServiceModel.Samples.DroppingServerElement, MessageInterceptor, Version=0.0.0.0, Culture=neutral, PublicKeyToken=098514eef14aa34a"/>  
    </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>  
```
Nota
- È possibile trovare le informazioni per gli assembly da registrare usando il comando gacutil /lr<assembly_name>.
- Vedere bindingElementExtensions su questo elemento.
Nel Blocco note salvare il file machine.config.
Se sono presenti più computer di runtime e computer di amministrazione BizTalk Server, ripetere i passaggi da 1 a 3 di questa procedura in tutti i computer.

Nota

È necessario ripetere questi passaggi in tutti i computer per l'infrastruttura WCF per elaborare il punto di estendibilità WCF per l'istanza host BizTalk e la console di amministrazione di BizTalk Server.

Configurare un'estensione dell'elemento di associazione WCF usando la console di amministrazione BizTalk

Aprire BizTalk Server Amministrazione.

Nota

Se la console di amministrazione BizTalk Server è già aperta, riavviare la console di amministrazione BizTalk Server.
Se si usa l'adattatore WCF-Custom, nella console di amministrazione BizTalk Server espandere Impostazioni piattaforma, espandere Istanze host e quindi riavviare l'istanza host BizTalk che esegue l'adapter.
Se si utilizza l'adapter WCF-CustomIsolated, nella Console di gestione IIS riavviare il pool di applicazioni associato all'indirizzo di ricezione WCF.
Se si vuole configurare un percorso di ricezione per usare un punto di estendibilità WCF, nella console di amministrazione BizTalk Server espandere Gruppo BizTalk, espandere <Applicazione> BizTalk, espandere Percorsi di ricezione e quindi nel riquadro destro fare doppio clic su <Posizione> di ricezione.
- Nell'elenco a discesa Tipo della finestra di dialogo Proprietà posizione ricezione selezionare WCF-Custom o WCF-CustomIsolated a seconda dell'adapter WCF da usare e quindi fare clic su Configura.
Se si vuole configurare una porta di invio per usare un punto di estendibilità WCF, nella console di amministrazione di BizTalk Server espandere BizTalk Group, espandere <Applicazione> BizTalk, espandere Porte di trasmissione e quindi nel riquadro destro fare doppio clic su <Invia porta>.
- Nell'elenco a discesa Tipo della finestra di dialogo Invia proprietà porta selezionare WCF-Custom e quindi fare clic su Configura.
Nella scheda Binding della finestra di dialogo Proprietà trasporto selezionare customBinding nell'elenco a discesa Tipo di associazione.
Nella finestra di dialogo Proprietà trasporto fare clic con il pulsante destro del mouse sull'area client dell'elenco Binding e quindi scegliere Aggiungi estensione.
Nella finestra di dialogo Seleziona estensione elemento binding selezionare un'estensione dell'elemento di associazione e quindi fare clic su OK.
Nella scheda Binding della finestra di dialogo Proprietà trasporto modificare l'ordine degli elementi di associazione aggiunti nell'elenco Binding a seconda del tipo dell'estensione dell'elemento di associazione aggiunto nel passaggio precedente come indicato di seguito:
- Nell'elenco Binding fare clic con il pulsante destro del mouse su un'estensione dell'elemento di associazione e quindi scegliere Sposta estensione verso l'alto o Sposta estensione verso il basso. L'estensione dell'elemento di associazione più bassa nell'elenco Binding corrisponde al componente inferiore dello stack di canali. L'elemento di associazione più alto nell'elenco Binding corrisponde al componente superiore dello stack di comunicazione.
  
  Nota
  
  Per informazioni dettagliate sull'ordine specifico degli elementi di associazione per l'associazione personalizzata, vedere Binding personalizzati .
Nella finestra di dialogo delle proprietà del trasporto configurare le altre impostazioni relative al trasporto.
Nella console di amministrazione BizTalk Server chiudere tutte le finestre di dialogo aperte facendo clic sui pulsanti OK e quindi assicurarsi che non vengano visualizzati messaggi di errore e log eventi errati.

Configurare il file di machine.config per un'estensione del comportamento WCF

Al prompt dei comandi passare a %FrameworkDir%\v4. Cartella X.XXXXX\CONFIG e quindi aprire il file dimachine.config usando Blocco note.
Nel Blocco note, se il file machine.config non dispone <degli elementi system.serverModel>\extensions>, aggiungere tali elementi all'interno dell'elemento di configurazione del file machine.config e quindi aggiungere l'elemento behaviorExtensions per un'estensione di comportamento WCF all'interno degli elementi system.serverModel\<extensions><.><><<> Ad esempio, per abilitare un'estensione di comportamento personalizzata, schemaValidator, aggiungere il codice seguente all'interno <dell'elemento di configurazione> del file di machine.config:
```
<system.serviceModel>  
  <extensions>  
    <behaviorExtensions>  
      <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ad307e213604f592"/>  
    </behaviorExtensions>  
  </extensions>  
</system.serviceModel>  
```
Nota
- È possibile trovare le informazioni per gli assembly da registrare usando il comando gacutil /lr<assembly_name>.
- Vedere comportamentoExtensions su questo elemento.
Nel Blocco note salvare il file machine.config.
Se sono presenti più computer di runtime e computer di amministrazione BizTalk Server, ripetere i passaggi da 1 a 3 di questa procedura in tutti i computer.

Nota

È necessario ripetere questi passaggi in tutti i computer per l'infrastruttura WCF per elaborare il punto di estendibilità WCF per l'istanza host BizTalk e la console di amministrazione di BizTalk Server.

Configurare un'estensione del comportamento WCF usando la console di amministrazione BizTalk

Aprire BizTalk Server Amministrazione.

Nota

Se la console di amministrazione BizTalk Server è già aperta, riavviare la console di amministrazione BizTalk Server.
Se si usa l'adattatore WCF-Custom, nella console di amministrazione BizTalk Server espandere Impostazioni piattaforma, espandere Istanze host e quindi riavviare l'istanza host BizTalk che esegue l'adapter.
Se si utilizza l'adapter WCF-CustomIsolated, nella Console di gestione IIS riavviare il pool di applicazioni associato all'indirizzo di ricezione WCF.
Se si vuole configurare un percorso di ricezione per usare un punto di estendibilità WCF, nella console di amministrazione BizTalk espandere BizTalk Group, espandere <Applicazione> BizTalk, espandere Percorsi di ricezione e quindi nel riquadro destro fare doppio clic su <Posizione> di ricezione.
- Nell'elenco a discesa Tipo della finestra di dialogo Proprietà posizione ricezione selezionare WCF-Custom o WCF-CustomIsolated a seconda dell'adapter WCF da usare e quindi fare clic su Configura.
Se si vuole configurare una porta di trasmissione per usare un punto di estendibilità WCF, nella console di amministrazione BizTalk espandere BizTalk Group, espandere <Applicazione> BizTalk, espandere Porte di trasmissione e quindi nel riquadro destro fare doppio clic su <Invia porta>.
- Nell'elenco a discesa Tipo della finestra di dialogo Invia proprietà porta selezionare WCF-Custom e quindi fare clic su Configura.
Nella scheda Comportamento della finestra di dialogo Proprietà trasporto fare clic con il pulsante destro del mouse su ServiceBehavior o EndpointBehavior a seconda del tipo dell'estensione del comportamento e quindi, nella finestra di dialogo Seleziona estensione comportamento selezionare l'estensione del comportamento e quindi fare clic su OK.
Nella finestra di dialogo delle proprietà del trasporto configurare le altre impostazioni relative al trasporto.
Nella console di amministrazione BizTalk Server chiudere tutte le finestre di dialogo aperte facendo clic sui pulsanti OK e quindi assicurarsi che non vengano visualizzati messaggi di errore e log eventi errati.

Configurare un percorso di ricezione WCF-Custom con un certificato SSL

Se un WCF-Custom percorso di ricezione viene usato il driver in modalità kernel HTTP (HTTP.sys) come l'elemento di associazione httpsTransport , per le comunicazioni SSL (Secure Sockets Layer), il percorso di ricezione deve avere un certificato registrato per ogni socket (combinazione di indirizzi IP/porta). Utilizzare lo strumento HttpCfg.exe per associare un certificato SSL a una porta nel computer. Per altre informazioni, vedere Procedura: Configurare una porta con un certificato SSL.

Condividi tramite