Sun Identity Manager 8.1 Business Administrator's Guide

Adding and Configuring a JMS Listener Adapter

If the PasswordSync servlet is using JMS to send messages to Identity Manager, you need to add Identity Manager’s JMS Listener resource adapter. The JMS Listener resource adapter periodically checks the JMS Message Queue for messages placed there by the PasswordSync servlet. If the Queue contains a new message, it sends it to Identity Manager for processing.

ProcedureTo Add the JMS Listener Resource Adapter

  1. Log on to the Identity Manager Administrator Interface (Identity Manager Administrator Interface).

  2. Select Resources -> Configure Types from the main menu.

    The Configure Managed Resources page opens as shown in Figure 11–10.

    Figure 11–10 The Configure Managed Resources Page.

    Figure showing the Configure Managed Resources page

  3. Verify that the JMS Listener checkbox in the Managed? column is selected as shown in Figure 11–10.

    If the box is not selected, select it and click Save.

  4. Click List Resources in the secondary menu.

  5. Locate the Resource Type Actions drop-down menu and select New Resource.

    The New Resource page is displayed.

  6. To add the JMS Listener Adapter, select JMS Listener from the drop-down menu (as shown in Figure 11–11) and click New.

    Figure 11–11 The New Resource Wizard

    Figure showing the New Resource wizard

  7. Configure the following settings on the Resource Parameters page, and then click Next.

    • Destination Type. Specify the This value is typically set to Queue. (Topics are not usually relevant because there is one subscriber and potentially multiple publishers.)

    • Initial context JNDI properties. Define the set of properties that are used to build the initial JNDI context.

      You must define the following name/value pairs:

      • java.naming.factory.initial. Specify the classname (including the package) of the Initial Context Factory for the JNDI Service Provider.

      • java.naming.provider.url. Specify the URL of the machine running the JNDI service.

        You might have to define additional properties. The list of properties and values should match those specified on the JMS settings page on the JMS server. For example, to provide the credentials and bind method, you might need to specify the following sample properties:

        • — Bind DN (for example, cn=Directory manager)

        • — Bind method (for example, simple)

        • — Password

    • JNDI name of Connection factory. Enter the name of a connection factory, as defined on the JMS server.

    • JNDI name of Destination. Enter the name of a destination, as defined on the JMS server.

    • User and Password. Enter the account name and password of the administrator that requests new events from the queue.

    • Reliable Messaging Support. Select LOCAL (Local Transactions). The other options are not applicable for password synchronization.

    • Message Mapping. Enter java:com.waveset.adapter.jms.PasswordSyncMessageMapper. This class transforms messages from the JMS server into a format that can be used by the Synchronize User Password workflow.

      Figure illustrating the JMS Listener Resource Wizard
Resource Parameters page.
  8. On the Account Attributes wizard page (Figure 11–12), click Add Attribute and map the following attributes, which are made available to the JMS Listener Adapter by PasswordSyncMessageMapper.

    • IDMAccountId — This attribute is resolved by the PasswordSyncMessageMapper, based on the resourceAccountId and resourceAccountGUID attributes passed in the JMS message.

    • password — The encrypted password forwarded in the JMS message.

    Figure 11–12 The Account Attributes Page of the Create JMS Listener Resource Wizard

    Figure showing the Account Attributes page of the Create
JMS Listener Resource Wizard

  9. Click Next.

    The Identity Template wizard page opens as shown in Figure 11–13. Note that the attributes you added in the previous step are available in the Attribute Mappings section of the Resource Wizard (Figure 11–13).

    Figure 11–13 JMS Listener Resource Wizard Attribute Mappings

    Figure showing the Edit JMS Listener Resource Wizard

  10. Click Next and configure the options on Identity System Parameters page as needed.

    See Sun Identity Manager 8.1 Resources Referencefor more information about setting up the JMS Listener resource adapter.