Configure your Web services application with the Application Server Toolkit

The Application Server Toolkit is a workstation-based graphical toolkit. It contains several WebSphere Studio tools that you can use to assemble and configure your J2EE applications for WAS. You can download the most recent version of the Application Server Toolkit at http://www.ibm.com/software/webservers/appserv/was/support/

Import your Web services application into the Application Server Toolkit

Complete the following steps to import your EAR file into the Application Server Toolkit:

1. Start the Application Server Toolkit.

2. Open the Java perspective. Click Window --> Open Perspective --> Java.

3. Import the application EAR file. Click File --> Import --> EAR file. Click Next.

4. On the Enterprise Application Import page, enter the fully qualified path name of your EAR file in the EAR file field, or click Browse to navigate to the EAR file.

5. In the Project name field, type the name of the project into which you want to import the EAR file.

6. Click Finish.

Next, open the deployment descriptor so you can configure the Web services security settings that you want.

Open the deployment descriptor for editing

To create or modify your Web services security configuration, edit the deployment descriptor for your application. Use the Web Services Editor in the Application Server Toolkit.

If your application is a Web service, the deployment descriptor is the webservices.xml file. If your application is a Web services client, the deployment descriptor is the webservicesclient.xml file.

Perform the following steps in the Application Server Toolkit to open the deployment descriptor for editing:

1. In the Navigator panel, expand your application module (Web module or EJB module).

   If the Navigator is not shown, you can open it by clicking Window --> Show View --> Navigator.

2. Locate the deployment descriptor file for your application:
   • If your application is a Web application WAR file, expand WebContent --> WEB-INF.
   • If your application is an enterprise bean JAR file, expand ejbModule --> META-INF.

3. Open the deployment descriptor in the Web Services Editor:

   • If your application is a Web service, right-click the webservices.xml file, and select Open With --> Web Services Editor.
   • If your application is a Web service client, right-click the webservicesclient.xml file, and select Open With --> Web Services Client Editor.

In the Web Services Editor, there are several tabs at the bottom of the editor. Use the Security Extensions and Bindings Configuration tabs to configure Web services security.

Note: Although you open the webservices.xml or webservicesclient.xml file in the Web Services Editor, the Web services security configuration is written to the following files:

• For a Web service:

  • ibm-webservices-ext.xmi
    The security extensions configuration specifies what security is to be performed.

  • ibm-webservices-bnd.xmi
    The security bindings configuration indicates how to perform the security that is specified in the security extensions configuration.

• For a Web services client:

  • ibm-webservicesclient-ext.xmi
    The security extensions configuration specifies what security is to be performed.

  • ibm-webservicesclient-bnd.xmi
    The security bindings configuration indicates how to perform the security that is specified in the security extensions configuration.

For information about particular configuration tasks, see Configure Web services authentication.