Sun Identity Manager 8.1 Resources Reference

Configuring and Managing Connectors

This section describes how to list the available connectors in your deployment, download connector code, install connectors, and register a connector server. It describes the following topics:

ProcedureListing Available Connectors

For this release, Identity Manager is shipping connectors for Active Directory and SPML2 resources. For more information about these connectors, see Chapter 57, Active Directory Connector and Chapter 58, SPML Connector.

  1. Login in to Identity Manager Administrator Interface as an administrator who has the Resource Administrator capability

  2. Select Resources > Resource Type Actions > Configure Managed Resources. The Resource Connectors area lists all the connectors that Identity Manager currently recognizes.

Downloading Connectors

You can download additional Identity Manager-supported identity connectors from https://identityconnectors.dev.java.net.

Downloading Java Connectors

An Identity Manager-supported Java connector is distributed as one jar file and one ZIP file. To download successfully, you must:

For a more detailed explanation, see Installing a Java Connector.

Downloading .NET Connectors

An Identity Manager-supported .NET connector is distributed as two ZIP files. You must

For a more detailed explanation, see Installing a .NET Connector.

Installing Java Connectors

ProcedureInstalling a Java Connector

A Java connector is delivered as one jar file and one ZIP file.

  1. Stop your Identity Manager web application.

  2. Copy the connector jar file into the WEB-INF/bundles directory of your Identity Manager web application.

  3. Extract the connector ZIP file into the your Identity Manager web application directory.

  4. Start your Identity Manager web application, and follow any additional connector-specific installation notes.

    Your newly installed Java connector should now be visible to Identity Manager. Log in to the Identity Manager Administrator interface as an Administrator who has the Resource Administrator capability. Select Resources > Resource Type Actions > Configure Managed Resources, and confirm that the new Java connector is listed (associated in the displayed table with the LOCAL connector server).

  5. (Optional) You may be required to import one or more Exchange files before using the new connector.

Installing .NET Connectors

Success installation of a .NET connector requires these steps:

Note that before you install the .NET zip files, you must install and register a .NET connector server. A connector server manages one or more .NET bundles, and handles requests between Identity Manager and the .NET bundles. A .NET connector server is roughly analogous to the Identity Manager gateway. For more information, see

ProcedureInstalling a .NET Connector Executable Zip File

.NET connector bundles are delivered as two ZIP files.


Note –

You must install a .NET connector server before installing the .NET executable connector zip file.


To install the .NET connector's executable zip file:

  1. If the connector server is already installed and running, stop the Connector Server service.

  2. Unzip the ZIP file into the connector server installation directory.

  3. Start the Connector Server service. If the connector server is not yet declared in Identity Manager, see Registering a Connector Server.

ProcedureInstalling a .NET Connector Identity Manager Zip File

  1. Stop your Identity Manager web application.

  2. Extract the connector ZIP file into the your Identity Manager web application directory, and restart your Identity Manager.

  3. Follow any additional connector-specific installation notes.

  4. (Optional) You may be required to import one or more Exchange files before using the new connector.

    After following this procedure, the new .NET connector should now be visible to Identity Manager. To confirm this, log in to the Identity Manager Administrator Interface as an administrator who has the Resource Administrator capability. Confirm that the .NET connector is listed in the displayed table with the appropriate connector server by checking Resources > Resource Type Actions > Configure Managed Resources.

Installing a .NET Connector Server

You install and run a .NET connector server when using a .NET connector from Identity Manager. A connector server manages one or more .NET bundles, and handles requests between Identity Manager and the .NET bundles. A .NET connector server is roughly analogous to the Identity Manager gateway. However, you can easily extend the .NET connector server (to add additional connectors), and it is coded in .NET.

The minimal requirements for a machine that will run a connector server include:

To install a connector server on a Windows host, refer to the connector server installation notes on https://identityconnectors.dev.java.net. You must record for later use the following information regarding your connector server installation:

See Registering a Connector Server to declare the newly installed connector server within Identity Manager.

ProcedureRegistering a Connector Server

You must declare within Identity Manager the connection information needed to communicate with each .NET connector server. If this connection information is not correctly declared, then Identity Manager will not have access to the .NET connectors deployed within the .NET connector server.

  1. Log on to the Identity Manager as an administrator who has the Resource Administrator capability.

  2. Select Configuration > Connector Servers.

  3. Click New in the Manage Connector Servers Definitions page.

  4. Complete the required fields in the New Connector Server. See the online help for information about each field.

  5. Click Save. Identity Manager will display “Available” in the Status column for the new Connector Server definition if Identity Manager can successfully communicate with the remote connector server.