Network Deployment (Distributed operating systems), v8.0 > Secure applications and their environment > Secure web services > Secure JAX-RS web applications

Secure downstream JAX-RS resources

You can secure downstream Java API for RESTful Web Services (JAX-RS) resources by configuring the BasicAuth method for authentication and by using the LTPA JAX-RS security handler to take advantage of single sign-on for user authentication.

This task assumes that we have completed the following steps:

• You have defined to your application server a cell profile that is federated into the dmgr cell.
• You have installed your JAX-RS application onto the application server.
• You have enabled security for your JAX-RS application.
• You have secured your JAX-RS applications within the web container by configuring downstream JAX-RS applications to use the basic authentication (BasicAuth) method for user authentication.

New feature: When composing JAX-RS resources, a new LTPA JAX-RS security handler can be used to seamlessly authenticate on downstream resource invocations.New feature:

When invoking downstream secure JAX-RS resources, the calling application is required to authenticate to the target resource. If the target resource on a downstream server uses the BasicAuth method for security, the calling application can take advantage of single sign-on (SSO) for JAX-RS resources. Using single sign-on, an authenticated context is propagated along downstream calls. We can use the LTPA-based security client handler to authenticate to downstream resources that are distributed across servers of a cell environment.

To illustrate this scenario, assume that we have two servers in your cell and that we have deployed JAX-RS resources on both of these servers. Suppose from one resource on server1 invoke another resource that is deployed on server2. When server2 resources are secured using the BasicAuth method for authentication, use the LTPA JAX-RS security handler to take advantage of single sign-on and seamlessly propagate user authentication on downstream calls without having to provide or manage user identities and passwords in the application.

Figure 1. Securing JAX-RS downstream resources BasicAuth method for authentication and by using the LTPA JAX-RS security handler." />

Use the following steps to configure user authentication to a downstream server using the JAX-RS security handler at application build time.

Procedure

1. At application build time, use the LTPA-based security client handler, LtpaAuthSecurityHandler, to authenticate to downstream resources that are distributed across servers of a cell environment.

   For transitioning users: When using the LtpaAuthSecurityHandler class, ensure that you target resources using the https scheme for your URLs, and that the target application is SSL-enabled. It is highly recommended to use SSL connections when sending user credentials, including LTPA cookies. You may explicitly turn off the requirement for SSL in the LtpaAuthSecurityHandler class by invoking the setSSLRequired method on the security handler with the false value. The default value is true.

   yourLtpaAuthSecHandler.setSSLRequired(false);
   

   trns

2. Add the security handler to the handlers chain.

3. Create the REST client instance.
4. Create the resource instance to interact with.
5. Substitute a value representing your resource address.

Results

You have defined secure JAX-RS resources within your cell environment such that when downstream resources are invoked, you can use single sign-on and seamlessly propagate user authentication on downstream calls without having to provide or manage user identities and passwords in the application.

Example

The following code snippet demonstrates how to use this security handler that is packaged as part of the JAX-RS client.

import org.apache.wink.client.Resource;
 import org.apache.wink.client.RestClient;
 import org.apache.wink.client.ClientConfig;
 import org.apache.wink.client.handlers.LtpaAuthSecurityHandler;

 ClientConfig config = new ClientConfig();
 LtpaAuthSecurityHandler secHandler = new LtpaAuthSecurityHandler();

 // Add this security handler to the handlers chain.
 config.handlers(secHandler);

 // Create the REST client instance.
 RestClient client = new RestClient(config);

 // Create the resource instance to interact with.
 // Substitute a value representing your resource address
 resource =
  client.resource("http://localhost:8080/path/to/resource");

// Now you are ready to begin calling your resource.

Implement secure JAX-RS applications
Administer secure JAX-RS applications

+

Search Tips   |   Advanced Search