[Version 5.0.2 and later]Configuring the server to validate LTPA token authentication information

Why and when to perform this task

This task is used to configure Lightweight Third-Party Authentication (LTPA). LTPA is a type of authentication mechanism in WebSphere Application Server security that defines a particular token format. The purpose of the LTPA token authentication is to flow the LTPA token from the first Web service, which authenticated the originating client, to the downstream Web service. Do not attempt to configure LTPA from a pure client.  Once the downstream Web service receives the LTPA token, it validates the token to verify that the token has not been modified and has not expired.  For validation to be successful, the LTPA keys used by both the sending and receiving servers must be the same.

Complete the following steps to specify how the server must validate the LTPA token authentication information:

Steps for this task

  1. Launch the Assembly Toolkit.
  2. Open the J2EE perspective by clicking Window > Open Perspective > Other > J2EE.
  3. Select the Web services-enabled Enterprise JavaBean (EJB) or Web module.
  4. In the Project Navigator window, locate the META-INF directory for an EJB module or the WEB-INF directory for a Web module.
  5. Right-click the webservices.xml file, and click Open With > Web Services Editor.
  6. Click the Binding Configurations tab, which is located at the bottom of the Web services client editor within the Assembly Toolkit.
  7. Expand the Request Receiver Binding Configuration Details > Login Mapping section.
  8. Click Edit to view the login mapping information.
    The login mapping information is displayed. Select or enter the following information:
    Authentication method
    Specifies the type of authentication that occurs. Select LTPA to use LTPA token authentication.
    Configuration name
    Specifies the Java Authentication and Authorization Service (JAAS) login configuration name.  For the LTPA authentication method, enter WSLogin for the JAAS login configuration name.  This configuration understands how to validate an LTPA token.
    Use token value type
    Determines if you want to specify a custom token type. For LTPA authentication, you must select this option because LTPA is considered a custom type. LTPA is not in the Web Services Security Specification.
    Token value type URI and local name
    Specifies custom authentication types. If you select Use Token value type you must enter data into the Token value Type URI and local name fields.  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, enter the following string:  LTPA
    Callback handler factory class name
    Creates a JAAS CallbackHandler implementation that understands the following callback handlers:
    • javax.security.auth.callback.NameCallback
    • javax.security.auth.callback.PasswordCallback
    • com.ibm.wsspi.wssecurity.auth.callback.BinaryTokenCallback
    • com.ibm.wsspi.wssecurity.auth.callback.XMLTokenReceiverCallback
    • com.ibm.wsspi.wssecurity.auth.callback.PropertyCallback
    For any of the default authentication methods (BasicAuth, IDAssertion, Signature, and LTPA), use the callback handler factory default implementation.  Enter the following class name for any of the default authentication methods including LTPA:  com.ibm.wsspi.wssecurity.auth.callback.WSCallbackHandlerFactoryImpl

    This implementation creates the correct callback handler for the default implementations.

    Callback handler factory property
    Specifies callback handler properties for custom callback handler factory implementations.  Default callback handler factory implementation does not any property specifications.  For LTPA, you can leave this field blank.
    Login mapping property
    Specifies properties for a custom login mapping. For default implementations including LTPA, you can leave this field blank.

What to do next

See Configuring the server to handle LTPA token authentication if you have not previously specified this information.

Related concepts
Lightweight Third Party Authentication
Related tasks
Securing Web services using a pluggable token
Configuring the server to handle LTPA token authentication information
Configuring the server security bindings using the Assembly Toolkit
Configuring the server security bindings using the administrative console
Configuring the client for LTPA token authentication: specifying LTPA token authentication
Configuring the client for LTPA token authentication: Collecting the authentication method information



Searchable topic ID:   twbs_confsvrltpaauthvalid
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/twbs_confsvrltpaauthvalid.html

Library | Support | Terms of Use | Feedback