Host del servizio

L'host del servizio è l'ambiente di runtime per l'hosting di un servizio all'interno di un processo.

Un servizio può configurare uno o più endpoint all'interno di un host del servizio.

Creazione di un host del servizio

Prima di creare un host del servizio, un servizio deve definire i relativi endpoint. Un endpoint nell'host del servizio viene specificato nella struttura WS_SERVICE_ENDPOINT ed è definito dalle informazioni seguenti:

• Indirizzo, ovvero l'URI fisico in cui verrà ospitato il servizio.
• Struttura WS_CHANNEL_TYPE che specifica il tipo del canale sottostante per l'endpoint.
• Struttura WS_CHANNEL_BINDING che specifica l'associazione del canale.
• Struttura WS_SECURITY_DESCRIPTION che contiene la descrizione di sicurezza per l'endpoint.
• Struttura WS_SERVICE_CONTRACT che rappresenta il del contratto di servizio per l'endpoint.
• Struttura WS_SERVICE_SECURITY_CALLBACK che specifica una funzione di callback di autorizzazione per l'endpoint.
• Struttura WS_SERVICE_ENDPOINT_PROPERTY che contiene una matrice di proprietà dell'endpoint di servizio.

WS_SERVICE_ENDPOINT serviceEndpoint = {0};
const WS_SERVICE_ENDPOINT* serviceEndpoints[1];
serviceEndpoints[0] = &serviceEndpoint;
WS_STRING url = WS_STRING_VALUE(L"net.tcp://+/Example");

// Method based service contract for the service
static WS_SERVICE_CONTRACT calculatorContract = 
{
    &calculatorContractDescription, // comes from a generated header.
    NULL,
    &calculatorFunctions, // specified by the application
};

serviceEndpoint.address.url = &url;
serviceEndpoint.binding.channelBinding =  WS_TCP_CHANNEL_BINDING; 
serviceEndpoint.contract = &calculatorContract;  
serviceEndpoint.channelType = WS_CHANNEL_TYPE_DUPLEX_SESSION; 
serviceEndpoint.authorizationCallback = AuthorizationCallback; // Authorization callback.

Sono supportati solo contratti unidirezionali per SOAP su UDP, rappresentati da WS_UDP_CHANNEL_BINDING nell'enumerazione WS_CHANNEL_BINDING.

Dopo aver definito un endpoint, può essere passato alla funzioneWsCreateServiceHost, che accetta una matrice di puntatori alle strutture WS_SERVICE_ENDPOINT.

HRESULT hr = WsCreateServiceHost (serviceEndpoints, 1, NULL, 0, &host, error);

Un'applicazione può facoltativamente fornire una matrice di proprietà del servizio a WsCreateServiceHost per configurare le impostazioni personalizzate nell'host del servizio.

Un'applicazione apre l'host del servizio per iniziare ad accettare le richieste client.

WsOpenServiceHost(serviceHost, NULL, NULL);

Dopo aver aperto l'host del servizio, l'applicazione può chiuderla se non sono necessarie altre operazioni. Si noti che questa operazione non rilascia le risorse e che può essere riaperta con una chiamata successiva a WsResetServiceHost.

WsCloseServiceHost(serviceHost, NULL, NULL);

Dopo aver chiuso l'host del servizio, un'applicazione può reimpostare l'host del servizio per il riutilizzo.

WsResetServiceHost(serviceHost, NULL);

Quando l'applicazione viene eseguita con l'host del servizio, può liberare le risorse associate all'host del servizio chiamando la funzioneWsFreeServiceHost. Si noti che WsCloseServiceHost deve essere chiamato prima di chiamare questa funzione.

WsFreeServiceHost(serviceHost, NULL);

Per informazioni sul collegamento di uno stato personalizzato all'host del servizio, vedere User Host State

Per informazioni sull'autorizzazione in un host del servizio per un determinato endpoint, vedere 'autorizzazione del servizio.

Per informazioni sull'implementazione di operazioni di servizio e contratti di servizio per un servizio, vedere gli argomenti operazioni del servizio e contratto di servizio.

Sicurezza

Un'applicazione può usare le proprietà seguenti per controllare la quantità di risorse allocate dall'host del servizio per conto dell'applicazione:

• WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS,
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY,
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS,
• WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE,
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE,
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE.

Le impostazioni predefinite sicure vengono scelte per ognuna di queste proprietà, un'applicazione deve prestare attenzione se vuole modificare queste proprietà. Oltre alle proprietà indicate in precedenza, canale, listener e messaggio proprietà specifiche possono essere modificate anche dall'applicazione. Fare riferimento alle considerazioni sulla sicurezza di questi componenti prima di modificare una di queste impostazioni.

Inoltre, quando si usa l'API host del servizio WWSAPI, è necessario valutare attentamente le considerazioni seguenti sulla progettazione dell'applicazione:

• Quando si usa MEX, le applicazioni devono prestare attenzione a non divulgare dati sensibili. Come mitigazione, se la natura dei dati esposti tramite MEX è sensibile, le applicazioni possono scegliere di configurare l'endpoint MEX con un'associazione sicura che richiede almeno l'autenticazione e implementare l'autorizzazione come parte dell'endpoint usando il WS_SERVICE_SECURITY_CALLBACK.
• Per impostazione predefinita, le informazioni dettagliate sugli errori sono disabilitate nell'host del servizio WS_SERVICE_PROPERTY_FAULT_DISCLOSURE proprietà. È a discrezione dell'applicazione inviare informazioni dettagliate sugli errori come parte dell'errore. Tuttavia, ciò può comportare la divulgazione di informazioni e pertanto è consigliabile modificare questa impostazione solo per gli scenari di debug.
• Oltre alla convalida eseguita per la serializzazione di base del profilo 2.0 e XML, l'host del servizio non esegue alcuna convalida sul contenuto dei dati ricevuto come parte dei parametri dell'operazione del servizio. È responsabilità dell'applicazione eseguire tutte le convalide dei parametri autonomamente.
• L'autorizzazione non viene implementata come parte dell'host del servizio. Tuttavia, le applicazioni possono implementare il proprio schema di autorizzazione usando WS_SECURITY_DESCRIPTION e l'WS_SERVICE_SECURITY_CALLBACK.
• È responsabilità dell'applicazione usare associazioni sicure nell'endpoint. L'host del servizio non fornisce alcuna sicurezza oltre a quella configurata nell'endpoint.

Gli elementi API seguenti vengono usati con l'host del servizio.