WebSphere Application Server Network Deployment, Version 6.0.x   Operating Systems: AIX, HP-UX, Linux, Solaris, Windows
             [TIP: Focusing the table of contents and search results]

Configuring the client for LTPA token authentication: collecting the authentication method information

To configure Lightweight Third-Party Authentication (LTPA) token authentication, collect the LTPA token authentication information. Do not configure the client for LTPA token authentication unless the authentication mechanism configured in WebSphere Application Server is LTPA.

About this task

Important: There is an important distinction between Version 5.x and Version 6.0.x and later applications. The information in this article supports Version 5.x applications only that are used with WebSphere Application Server Version 6.0.x and later. The information does not apply to Version 6.0.x and later applications.

Use this task to configure Lightweight Third-Party Authentication (LTPA) token authentication. Do not configure the client for LTPA token authentication unless the authentication mechanism configured in WebSphere Application Server is LTPA. When a client authenticates to a WebSphere Application Server, the credential created contains an LTPA token. When a Web service calls a downstream Web service, you can configure the first Web service to send the LTPA token from the originating client. Do not attempt to configure LTPA from a pure client. LTPA works only when you configure the client-side of a Web service acting as a client to a downstream Web service. In order for the downstream Web service to validate the LTPA token, the LTPA keys on both servers must be the same.

Complete the following steps to specify how to collect the LTPA token authentication information:

Procedure

  1. Launch an assembly tool. For more information on the assembly tools, see Assembly tools .
  2. Switch to the Java 2 Platform, Enterprise Edition (J2EE) 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 Bindings tab, which is located at the bottom of the deployment descriptor editor within the assembly tool.
  6. Expand the Security request sender binding configuration > Login binding section.
  7. Click Edit to view the login binding information and select LTPA. If LTPA is not already there, enter it as an option. The login binding dialog is displayed. Select or enter the following information:
    Authentication method
    Specifies the type of authentication that occurs. Select LTPA to use identity assertion.
    Token value type URI and token value type local name
    When you select LTPA, you must edit the token value type URI (Uniform Resource Identifier) and the local name fields. Specifies values for custom authentication types, which are authentication methods not mentioned in the specification. For the token value type URI field, enter the following string: http://www.ibm.com/websphere/appserver/tokentype/5.0.2. For the local name field, enter the following string: LTPA.
    Callback handler
    Specifies the Java Authentication and Authorization Service (JAAS) callback handler implementation for collecting the LTPA information.  Specify the com.ibm.wsspi.wssecurity.auth.callback.LTPATokenCallbackHandler implementation for LTPA.
    Basic authentication user ID and basic authentication password
    For LTPA, you can leave these fields empty. However, when you omit this information, the LTPA CallbackHandler implementation attempts to obtain the LTPA token from the invocation (RunAs) credential. If an invocation (RunAs) credential does not exist, then the LTPA token is not propagated.
    Property name and property value
    For LTPA, you can leave these fields blank.

What to do next

See Configuring the client for LTPA token authentication: specifying LTPA token authentication if you have not previously specified this information.



Related concepts
Lightweight Third Party Authentication
Related tasks
Configuring the client for LTPA token authentication: specifying LTPA token authentication
Configuring the client security bindings using an assembly tool
Configuring the security bindings on a server acting as a client using the administrative console
Securing Web services for version 5.x applications using a pluggable token
Task topic    

Terms of Use | Feedback

Last updated: Mar 8, 2007 8:14:28 PM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/twbs_confclltpaauthcoll.html

© Copyright IBM Corporation 2006. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)