Migrating the client-side bindings file

[Version 6 only]

Migrating the client-side bindings file

This article provides general information about migrating the Web services security client-side binding configuration for a Java 2 Platform,
Enterprise Edition Version 1.3 application to a J2EE Version 1.4 application. The steps are based on typical scenarios, but the steps are not all-inclusive.

The following table lists the mapping of the top-level sections under the client-side Port Bindings tab within a J2EE Version 1.3 application to a J2EE Version 1.4 application.

Table 1. The mapping of the configuration sections

J2EE Version 1.3 binding configuration for Web services security J2EE Version 1.4 binding configuration for Web services security

Security Request Sender Binding Configuration Security Request Generator Binding Configuration
Security Response Receiver Binding Configuration Security Response Consumer Binding Configuration

Table 1. The mapping of the configuration sections
J2EE Version 1.3 binding configuration for Web services security	J2EE Version 1.4 binding configuration for Web services security
Security Request Sender Binding Configuration	Security Request Generator Binding Configuration
Security Response Receiver Binding Configuration	Security Response Consumer Binding Configuration

Consider the following steps to migrate the client-side binding configuration from a J2EE Version 1.3 application to a J2EE Version 1.4 application. These steps are dependent upon your specific configuration.

(dependent on configuration)

Migrate the information in the Security Request Sender Binding Configuration section in a J2EE Version 1.3 application to a J2EE Version 1.4 application. The migrations process for the Security Request Sender Binding Configuration section is similar to the process for the Response Sender Binding Configuration Details section in the server-side binding configuration. For more information, see Migrating the server-side bindings file.
Migrate the information in the Key Locators, Signing Information, and the Encryption Information sections of the J2EE Version 1.3 application to a J2EE Version 1.4 application. The migration process for these elements on the client side is similar to migration process on the server side. For more information, see Migrating the server-side bindings file.
Migrate the information in the Login Bindings section in a J2EE Version 1.3 application to a J2EE Version 1.4 application. The migration of the Login Bindings section depends upon the value of the authentication method. If the authentication method is BasicAuth or IDAssertion, configure a token generator for the username token. If the authentication method is LTPA, select the com.ibm.wsspi.wssecurity.token.LTPATokenGenerator class as the token generator class. If the client-side bindings for the Web service uses IDAssertion, complete the following steps:
1. Configure a token generator for the authentication token of the original client.
2. Define the com.ibm.wsspi.wssecurity.token.IDAssertion.isUsed property and set its value to true in the Token Generator Dialog window within an assembly tool. If the original client is using a username token for authentication and if the target Web service is using BasicAuth for authentication, configure the following token generators in the client-side binding file:
  - The username token of the original client. You must set the com.ibm.wsspi.wssecurity.token.IDAssertion.isUsed property in the token generator of the original client.
  - The username token of the intermediary Web service.
Migrate the Security Response Receiver Binding Configuration section from a J2EE Version 1.3 application to a J2EE Version 1.4 application. Migrating the Security Response Receiver Binding Configuration section is similar to migrating the Request Receiver Binding Configuration Details section of the server-side bindings configuration. Migrate this information under the Security Response Consumer Binding Configuration section. For more information, see Migrating the server-side bindings file.
To configure a nonce in the binding file, define the com.ibm.wsspi.wssecurity.token.username.addNonce property in the token generator of the username token.

ResultThis set of steps describe the types of information that you need to migrate the Web services security client-side bindings configuration for a J2EE Version 1.3 application to a J2EE Version 1.4 application.

What to do next

Verify that you have migrated both the server-side and the client-side extension and binding configurations for a J2EE Version 1.3 application to a J2EE Version 1.3 application. For more information, see Migrating Version 5.x applications with Web services security to Version 6 applications.

Searchable topic ID: twbs_migrateclbndv6