Operating Systems: i5/OS
             Personalize the table of contents and search results
Configure the client for response digital signature verification:
verifying the message parts
To configure the Web services security extensions and the Web services
security bindings, use the WS Extension tab and the WS Binding tab in the
Client Deployment Descriptor within an assembly tool.
There is an important distinction between Version
5.x and V6 and later applications. The information in this article
supports V5.x applications only that are used with WebSphere Application
Server V6.0.x and later. The information does not apply to Version
6.0.x and later applications.
Prior to completing these steps, read
either of the following topics to becomes familiar with the WS Extension tab
and the WS Binding tab in the Client Deployment Descriptor within the assembly
tool:
You can use these two tabs to configure the Web services security extensions
and the Web services security bindings, respectively.
Overview
Complete the following steps to configure the client for response
digital signature verification. The steps describe how to modify the extensions
to indicate which parts of the response to verify.
Procedure
- Launch an assembly tool. For more information on the
assembly tools, see Assembly tools.
- Switch to the J2EE perspective.
Click Windows > Open perspective > Other > J2EE.
- Click Application Client projects > application_name >
appClientModule > META-INF.
- Right-click the application-client.xml file and click Open
With > Deployment descriptor editor.
- Click the WS extension tab.
- Expand the Response receiver configuration > Required integrity section.
Required integrity refers to parts that require digital signature verification.
Digital signature verification decreases the risk that the message parts have
been modified while the message is transmitted across the Internet.
- Indicate the parts of the message that must be verified.
You can determine which parts of the message to verify by looking at
the Web service response sender configuration. Click Add and select
one of the following parts:
- Body
-
The body is the user data portion of the message.
- Timestamp
-
The time stamp determines if the message is valid based on the time that
the message is sent and then received. If the time stamp option is selected,
proceed to the next step to add a received time stamp to the message.
- Securitytoken
-
The security token authenticates the client. If Securitytoken option is
selected, the message is signed.
- Optional: Expand the Add received time stamp section.
Select Add received time stamp to add the received time stamp to the
message.
Results
If you configure the client and server signing
information correctly, but receive a Soap body not signed error
when running the client, you might need to configure the actor. You can configure
the actor in the following locations on the client in the Web services client
editor within an assembly tool:
- Click Security extensions > Client service configuration details and
indicate the actor information in the Actor URI field.
- Click Security extensions > Request sender configuration > Details and
indicate the actor information in the Actor field.
You must configure the same actor strings for the Web service on the
server, which processes the request and sends the response back. Configure
the actor in the following locations in the Web services editor within an
assembly tool:
- Click Security extensions > Server service configuration.
- Click Security extensions > Response sender service configuration details
> Details and indicate the actor information in the Actor field.
The actor information on both the client and server must refer
to the same exact string. When the actor fields on the client and server match,
the request or response is acted upon instead of being forwarded downstream.
The actor fields might be different when you have Web services acting as a
gateway to other Web services. However, in all other cases, make sure that
the actor information matches on the client and server. When Web services
are acting as a gateway and they do not have the same actor configured as
the request passing through the gateway, Web services do not process the message
from a client. Instead, these Web services send the request downstream. The
downstream process that contains the correct actor string processes the request.
The same situation occurs for the response. Therefore, it is important that
you verify that the appropriate client and server actor fields are synchronized.
You
have specified which message parts are digitally signed and must be verified
by the client when the server sends a response message to the client.
What to do next
After you specify which message parts contain a digital signature
that must be verified by the client, configure the client to recognize
the digital signature method used to digitally sign the message. See Configuring the client for response digital signature verification:
choosing the verification method for more information.
}
Related concepts
XML digital signature
Response sender
Response receiver
Related tasks
Configuring the client security bindings using an assembly tool
Configuring the security bindings on a server acting as a client using
the administrative console
Configuring the client for response digital signature verification:
choosing the verification method
Securing Web services for V5.x applications using XML digital
signature
  Â