This documentation applies to the 8.1 version of Service Request Management, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

Configuring Identity Request Management adapter information

For each adapter, defined parameters are required for the adapter to work. After the Adapter Extraction utility runs (during the installation or post installation), the parameters and the values are stored as part of the configuration.

You can change the defined parameters. When the Company - Site configuration is entered without the Site information, the parameters defined are considered for all the Sites of the Company. When the Company - Site configuration is entered with the Site information, the parameters defined are considered for the particular site.

To add a new company configuration

  1. On the Custom Configuration tab on the Application Administration Console, select Identity Request Management > Adapter Configuration > Adapter Configuration.
  2. Select an adapter ID from the first table.
  3. Click Add Company - Site Configuration.
  4. Enter information in the required fields, and click Save Company - Site Configuration.

To update a company configuration

  1. On the Custom Configuration tab on the Application Administration Console, select Identity Request Management > Adapter Configuration > Adapter Configuration.
  2. Select the Company - Site you want to change from the second table and click Update Company - Site Configuration.
  3. Perform the required changes and click Modify Company - Site Configuration.

To delete a company configuration

  1. On the Custom Configuration tab on the Application Administration Console, select Identity Request Management > Adapter Configuration > Adapter Configuration.
  2. Select the Company - Site to be deleted from the second table and click Delete Company - Site Configuration.
  3. Click Close.

To configure the adapter parameters

  1. In a browser, enter the following URL in the address bar:
    http://<webServer>:<port>/arsys/
    In this syntax, <webServer> is the fully qualified name of the BMC Remedy Mid Tier, specified in the format serverName.company.com, and <port> is an optional port number, which is needed if the web server is not on the default port (port 80).
  2. Log on as the IRM Configuration Manager.
  3. In the navigation panel of the Home Page, select Administrator Console > Application Administration Console.
  4. Choose Custom Configuration > Identity Request Management > Adapter Configuration, and double-click the item to configure the details.
  5. From the Available Adapters table, select the CTSA Adapter you installed.
    The Company - Site configured for this adapter is displayed in the Adapters - Companies table.
  6. To add a new company or site for the adapter, click Add Company-Site Configuration, and select the Company and Site for which the adapter parameter must be configured.
    The adapter parameters (as specified in the following tables) are displayed.
  7. If you have not done so already, complete the steps in To prepare for adapter configuration.
  8. To modify configuration values for the adapter parameters, click Configure Parameters.
  9. Click Reload Configuration.

The following table lists the adapter parameters with the field names in the os_params.properties file:

Adapter parameter

Field name in os_params.properties file

Description

OS_SUITE_ADMIN

os_suite_admin

The Unattended Administrator user name that will be used to access the Open Services Server

SUITE_URL

suite_url

The BMC Identity Management Suite URL. This configuration enables you to use the BMC Identity Management Suite links within Identity Request Management. Log in to the computer where BMC Identity Management Suite is installed. Use the idm_tools suite_url command to locate and record the BMC Identity Management Suite URL information. The suite URL should be in the following format:

https://<serverName>:<serverPort>/idm/suite/
riamAuthentication.do?

<serverName> is where the BMC Identity Management Suite is installed, and <serverPort> is the port that is used to connect to the BMC Identity Management Suite.

OS_HOST

os_host

The host name ID or URL of the Open Services Server

OS_PORT

os_port

The port number used to connect to the Open Services Server

ESS_PROFILE

ess_profile

A file containing the parameters for connecting the BMC Identity Management Suite back-end server applications (for example, Identity Open Services) to a specific installation of BMC Identity Enterprise Security Station

ESS_LOGIN_ID_FIELD_NAME

The full field name of the keyword that is to be used as a logon ID in BMC Identity Enterprise SecurityStation (ESS).This parameter is added to support any field in the Person entity to be used as logon ID. Make sure that the index key is specified for the field to be used as a logon ID in ESS and mention the same index key as a value for the _99_LOGIN_ID_FIELD_NAME field under System > Global Parameters > ESS Login.

Note:If ESS_LOGIN_ID_FIELD_NAME is not set to a user ID, then the web launcher for all IRM services will not work.

The following table lists the adapter parameters without the field names in the os_params.properties file:

Adapter parameter

Description

KEY_NAME

The alias of the private key in the client keystore, for example, - irm_client_servername

KEYSTORE_PASSWORD_LOCATION

The relative path from the Identity Request Management home folder to the location of the keystore password file for the client keystore. Create this text file, and include the password in clear text. (Make sure that the keystore password and the private key/certificate within the keystore are the same.)

KEYSTORE_LOCATION

The relative path from the Identity Request Management home folder to the location of the keystore file to be used for the communication with BMC Identity Management Suite applications using the trusted authentication method

PERSON_MAPPING_METHOD

The mapping type of the ITSM person to the Identity Management person. Specify the following values:

  • GUID — The Instance ID of the person, which is used to map the person to the back end
  • LOGIN_ID — The logon ID of the ITSM person, which is used to identify the person in the back end

J2EE_HOST_TYPE

Specifies the application server that will host the BMC Identity Management Suite. Depending on the supported application server, enter JBOSS or WEBSPHERE.

To change or delete adapter parameters for a company or a site

  1. On the Custom Configuration tab on the Application Administration Console, select Identity Request Management > Adapter Configuration > Adapter Configuration.
  2. Select the Company - Site for which you want to change the parameters from the second table.
    On the third table, you will see the parameters and their values.
  3. Click Configure Parameters.
    A table appears and lists different parameters, their default values, and new values (if changed).
  4. Enter the new value or delete the unwanted values in the New Value column.
  5. Click Save Parameters.

    Note

    When a value is deleted from the table, the value of the corresponding parameter is derived from the Default value.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments