Client del servizio Web e configurazione della politica per utilizzare la politica del provider del servizio

Se un provider di servizi pubblica la sua politica nel proprio WSDL (Web Services Description Language), la configurazione della politica di un client di servizi WebSphere® Application Server può essere configurata in modo dinamico, in base alle politiche supportate dal provider di servizi.

Il fornitore di servizi deve pubblicare la propria politica in formato WS-PolicyAttachment nel proprio WSDL e il cliente deve essere in grado di supportare tali politiche del fornitore. Il client può basare la sua configurazione della politica interamente sulla politica del provider o in parte sulla politica del provider con limitazioni definite dalla configurazione della serie di politiche del client.

Un cliente acquisisce la politica del provider utilizzando una richiesta GET HTTP o il protocollo Web Services Metadata Exchange ( WS-MetadataExchange ) per ottenere il WSDL del provider. È possibile configurare il modo in cui il client ottiene la politica del provider e l'endpoint su cui viene acquisita la politica, utilizzando la console di gestione o i comandi wsadmin. Se si utilizza il protocollo WS-MetadataExchange per ottenere la politica del provider, ciò presenta il vantaggio di poter proteggere le richieste WS-MetadataExchange GetMetadata utilizzando un set di politiche di sistema adeguato.

Se la policy del provider utilizza WSDL multipart, è possibile utilizzare una richiesta GET HTTP per ottenere la policy del provider, ma non è possibile utilizzare il protocollo WS-MetadataExchange. Per ulteriori informazioni su WSDL a più parti, consultare l'argomento relativo a WSDL.

La politica lato client dell'applicazione Web viene calcolata e memorizzata nella cache come configurazione di runtime. Questa politica calcolata è nota come politica effettiva e viene utilizzata per le successive richieste del servizio Web in uscita all'endpoint o all'operazione per cui è stato eseguito il calcolo. La configurazione originale della serie di politiche del client non viene modificata.

Per un servizio specifico, la configurazione della politica dinamica si verifica una volta per impostazione predefinita e si presume che questa configurazione sia la stessa per tutti gli endpoint che implementano un servizio, perché hanno lo stesso WSDL. I calcoli della politica basati sul WSDL vengono memorizzati nella cache nel runtime del client (non sono persistenti) e condivisi con ciascun servizio di destinazione.

In un ambiente cluster, ciò significa che il client non ottiene nuovamente la politica del provider per ciascuna istanza endpoint di un servizio web.

In WebSphere Application Server Versione 8.0 e successive, è possibile configurare un riferimento del servizio per utilizzare un documento WSDL diverso rispetto al WSDL configurato per il servizio client. Per impostazione predefinita, i riferimenti del servizio ereditano la serie di politiche e la configurazione WS - Policy dal servizio principale, tuttavia, se lo si desidera, la serie di politiche e la configurazione WS - Policy possono essere sovrascritte. Consultare Utilizzo di WS - Policy per scambiare le politiche in formato standard per ulteriori dettagli.

Se si richiede una configurazione della politica differente per ogni implementazione dell'endpoint, è necessario creare una nuova porta per ogni endpoint. Quindi, è possibile specificare una configurazione della politica differente per ogni endpoint.

Le politiche di trasporto quali HTTP, SSL e JMS non possono essere espresse in formato WS-PolicyAttachment, pertanto il client non può acquisire le politiche di trasporto del fornitore di servizi. Se il client richiede le politiche di trasporto, è necessario configurare tali politiche come parte della configurazione della serie di politiche del client.

Per una richiesta GET dell' HTTP, quando la richiesta è indirizzata alla stessa posizione dell'endpoint, la richiesta utilizza le stesse politiche di trasporto HTTP e SSL dell'applicazione. Quando la richiesta GET HTTP è indirizzata a un endpoint diverso, è anche possibile allegare un set di criteri di sistema per specificare criteri di trasporto diversi per HTTP e SSL.

Per una richiesta WS-MetadataExchange GetMetadata, viene utilizzata la configurazione WS-Security nel set di criteri di sistema specificato. Le proprietà di trasporto dell' HTTP e sono ereditate dall'applicazione.

Un client configurato per utilizzare il linguaggio Security Assertion Markup Language ( SAML ) può utilizzare la configurazione dinamica dei criteri. Tuttavia, il client deve essere configurato per utilizzare i collegamenti generali.

try 
{ 
dispatch.invoke(params); 
} 
catch (javax.xml.ws.WebServiceException e) 
{ 
Throwable cause = e.getCause(); 
if ((cause instanceof NullPolicyException) || (cause instanceof PolicyException) ) 
{
// The exception might be because the policy of the provider is not up to date.
//
// There is also a message on the console that starts with the characters CWPOL,
// which helps to decipher and debug the cause of the error.
// This message is also available by using
// String nlsedMessage = cause.getMessage(); 
Map<String, Object> requestContext = dispatch.getRequestContext(); 
requestContext.put(WSPConstants.REFRESH_PROVIDER_POLICY, Boolean.TRUE);
// The following method might cause another jax-ws invocation exception.
// The cause might still be policy, in which case, a message is written to the
// console. 
dispatch.invoke(params); 
}
// For all other exceptions, use the normal exception handling for the
// application. In this case, assume there are no other exceptions and rethrow the
// initial exception. Remember that the WebServiceException might be caused by a
// WSPolicyAdministrationException. In this situation, a message is written to the
// console, but forcing a refresh in the application cannot resolve the problem.
throw e; 
}