Tasks : Using Embedded Client Side Proxy Feature

Using Embedded Client Side Proxy Feature
The Embedded Client Side Proxy feature enables security context propagation, credential mapping, and encryption or decryption to external services as well as provides a capability that management agent can be configured as a substitute for proxy agent.
It exists inside the ActiveMatrix Management Agent for WebSphere and exposes external endpoints through “References” and manages them. Therefore, the users can configure the client side policies on them the same way as is done for the proxy agent.
The "Reference Out" attribute is set to "true" for Reference endpoints as shown in the following screenshot.
Figure 7 Reference Out Attribute Set to ’True’
To use this functionality, the users need to modify their web services (that reference other web services) to add a reference binding file amma-was-config.xml.For SOAP/HTTP based single/multi hop web services (a web service calling another web service) this file has to be packaged in the web archive under WEB-INF folder and for SOAP/JMS this file has to be packaged in the enterprise archive under META-INF folder. This binding file contains WSDL URL information of the referenced web service.
The existing single/multi hop web services must be redeployed by packaging the reference binding file in order to get the reference endpoints auto managed.
The reference endpoint uses the service name of the referenced web service by adding the suffix “_reference”.
Figure 8 Referenced Web Service
Even if multiple web services in one application server references a common web service which is deployed in the same or other application server, only one single Reference endpoint will be exposed in the Policy Manager Console.
If a web service is referencing multiple web services then those many reference endpoints will be created. This solely depends on the number of WSDL URLs specified in the reference binding file amma-was-config.xml.
Refer to the following sample snippet of the reference binding file:
 
 
<?xml version="1.0"?>
<amma-was-config>
<!-- WSDL URL for SOAP/HTTP Web Service -->
<ExternalServicesWsdlUrlList>
<ExternalServiceWsdlUrl>http://hostname:9084/SimpleServer/services/SimpleHttpPortTypeEndpoint1/wsdl/Simple.wsdl</ExternalServiceWsdlUrl>
 
<!-- WSDL URL for SOAP/JMS Web Service -->
<ExternalServiceWsdlUrl>http://hostname:9080/tibcoplugin/amberpoint?getJmsWsdl&amp;ServiceName=http://xmlns.example.com/1211316933444:JmsServiceServer&amp;Port=JmsServiceServerPortTypeEndpoint</ExternalServiceWsdlUrl>
</ExternalServicesWsdlUrlList>
</amma-was-config>