Configure 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.
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 V6.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:
- Configure the client security bindings using an assembly tool
- Configure the security bindings on a server acting as a client using the 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.
- Switch to the J2EE perspective. Click Window > Open Perspective > J2EE.
- Click Application Client Projects > application > 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.
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 Configure the client for response decryption: choosing a decryption method for more information.
Related concepts
XML encryption
Response receiver
Related tasks
Configure the client for response decryption: choosing a decryption method
Configure the client security bindings using an assembly tool
Configure the security bindings on a server acting as a client using the console
Configure key locators using an assembly tool
Configure key locators using the console