Managing J2EE Connector Architecture authentication data entries

Before you begin

Java 2 Connector authentication data entries are used by resource adapters and Java Database Connectivity (JDBC) data sources. A Java 2 Connector authentication data entry contains authentication data, which includess the following information:
Alias
An identifier that is used to identify the authenticated data entry. When configuring resource adapters or Java Database Connectivity (JDBC) data sources, the administrator can specify which authentication data to choose for the corresponding alias.
User ID
A user identity of the intended security domain. For example, if a particular authentication data entry is used to open a new connection to DB2, this entry contains a DB2 user identity.
Password
The password of the user identity is encoded in the configuration respository.
Description
A short text description.

This task creates and deletes Java 2 Connector (J2C) authentication data entries.

Steps for this task

  1. Delete a J2C authentication data entry.
    1. Click Security in the navigation tree, then click JAAS Configuration > J2C Authentication Data. The J2C Authentication Data Entries panel is displayed.
    2. Select the check boxes for the entries to delete and click Delete.
      Before deleting or removing an authentication data entry, make sure that it is not used or referenced by any resource adapter or Java database connectivity (JDBC) data source. If the deleted authentication data entry is used or referenced by a resource, the application that uses the resource adapter or the JDBC data source fails to connect to the resources.
  2. Create a new J2C authentication data entry.
    1. Click Security in the navigation tree, then click JAAS Configuration > J2C Authentication Data.
      The J2C Authentication Data Entries panel is displayed.
    2. Click New.
    3. Enter a unique alias, a valid user ID, a valid password, and a short description (optional).

      Note: When creating a new authentication data entry and specifying an alias, be aware that the node name is automatically appended as a prefix to the alias name you specify. For example, if you specify the alias, tek_test_Con3, and the node is MyNode, then the final alias name is: MyNode/tek_test_Con3.

      Remember that this full alias name is the one used in your deployment descriptor.

    4. Click OK or Apply.
      No validation for the user ID and password is required.
    5. Click Save.
      For a Network Deployment installation, make sure that a file synchronized operation is performed to propagate the changes to other nodes.

Results

A new J2C authentication data entry is created or an old entry is removed. The newly created entry is visible without restarting the application server process to use in the data source definition. But the entry is only in effect after the server is restarted. Specifically, the authentication data is loaded by an application server when starting an application and is shared among applications in the same application server.

If you create or update a data source that points to a newly created J2C authentication data alias, the test connection fails to connect until you restart the deployment manager. After you restart the deployment manager, the J2C authentication data is reflected in the run-time configuration. Any changes to the J2C authentication data fields require a deployment manager restart for the changes to take effect. The node agent must also be restarted.

Example

What to do next

Use the authentication data entry that is defined in the resource adapters or the JDBC data sources.

Related concepts
Programmatic login
Related reference
Java 2 Connector authentication data entry settings



Searchable topic ID:   tsecj2cauthdata
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/tsec_j2cauthdata.html

Library | Support | Terms of Use | Feedback