Set the client for response decryption: decrypting the message parts

To configure the client for response decryption, specify which response message parts to decrypt when configuring the client. The server response encryption and client response decryption configurations must match.

Overview

There is an important distinction between V5.x and V6 and later applications. The information in this article supports V5.x applications only that are used with WAS V6.0.x and later. The information does not apply to V 6.0.x and later 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:

• Set the client security bindings using an assembly tool
• Set the security bindings on a server acting as a client

These two tabs are used to configure the WS-Security extensions and the WS-Security bindings, respectively.

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.

 

1. Launch an assembly tool.

   See the related information on Assembly Tools.

2. Switch to the Java EE perspective. Click Window > Open Perspective > J2EE.

3. Click Application Client Projects > application_name > appClientModule > META-INF.

4. Right-click the application-client.xml file, select Open with > Deployment descriptor editor.

5. Click the WS Extensions tab, which is located at the bottom of the deployment descriptor editor within the assembly tool.

6. Expand the Response receiver configuration > Required confidentiality section.

7. 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.

   A Username Token is typically not sent in the response. Thus, you usually do not need to select username token.

 

Next steps

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

 

Related concepts

XML encryption
Assembly tools
Response receiver

 

Related tasks

Set the client for response decryption: choosing a decryption method
Set the client security bindings using an assembly tool
Set the security bindings on a server acting as a client
Set key locators using an assembly tool
Set key locators