Configure the client for response decryption: decrypting the message parts

Before you begin

Important distinction between V5.x and v6.x applications

Note: The information in this article supports v5.x applications only that are used with WAS v6.x. The information does not apply to v6.0.x applications.

Prior to completing these steps, read either of the following topics to become familiar with the WS Extensions tab and the WS Binding tab in the Client Deployment Descriptor Editor within an assembly tool:

Configuring the client security bindings using an assembly tool
Configuring the security bindings on a server acting as a client using the administrative console

These two tabs are used to configure the Web services security extensions and the Web services security bindings, respectively.

Overview

Complete the following steps to specify which response message parts to decrypt when configuring the client for response decryption. The server response encryption and client response decryption configurations must match.

Procedure

Launch an assembly tool. For more information on the assembly tools, see Assembly tools.
Open the J2EE perspective by clicking Window > Open perspective > Other > J2EE.
Click Application Client Projects > appname > appClientModule > META-INF.
Right-click the application-client.xml file, select Open with > Deployment descriptor editor.
Click the WS Extensions tab, which is located at the bottom of the deployment descriptor editor within the assembly tool.
Expand the Response receiver configuration > Required confidentiality section.
Select the parts of the message that decrypt by clicking Add and selecting either Bodycontent or Usernametoken. The following information describes these message parts:

Bodycontent

The user data portion of the message.

Usernametoken

The basic authentication information, if selected.

The information selected in this step is encrypted by the server in the response sender.
Important: A username token is typically not sent in the response. Thus, you usually do not need to select username token.

What to do next

After you specify which message parts to decrypt, specify which method to use when decrypting the response message. See Configuring the client for response decryption: choosing a decryption method for more information.