3 Using the WebEx Connector

You can use the connector for performing reconciliation and provisioning operations after configuring it to meet your requirements.

The following topics provide details on using the connector:

3.1 Scheduled Job for Lookup Field Synchronization

The WebEx TimeZones Lookup Reconciliation scheduled job is used for lookup field synchronization. Values fetched by this scheduled job from the target system are populated in the Lookup.Webex.TimeZones lookup definition.

Table 3-1 Attributes of the Scheduled Job for Lookup Field Synchronization

Attribute Description

Code Key Attribute

Enter the name of the attribute that is used to populate the Code Key column of the lookup definition (specified as the value of the Lookup Name attribute).

Default value: __UID__

Decode Attribute

Enter the name of the attribute that is used to populate the Decode column of the lookup definition (specified as the value of the Lookup Name attribute).

Default value: __NAME__

IT Resource Name

Name of the IT resource for the target system installation from which you reconcile user records.

Default value: Webex

Lookup Name

Name of the lookup definition in Oracle Identity Manager that must be populated with values fetched from the target system.

Default value: Lookup.Webex.TimeZones

Object Type

Name of the type of object you want to reconcile.

Default value: TimeZones

3.2 Configuring Reconciliation for WebEx Connector

You can configure the connector to specify the type of reconciliation and its schedule.

This section provides details on the following topics related to configuring reconciliation:

3.2.1 Full Reconciliation for the WebEx Connector

Full reconciliation involves reconciling all existing user records from the target system into Oracle Identity Manager.

After you deploy the connector, you must first perform full reconciliation. To perform a full reconciliation run, ensure that no value is specified for the Filter attribute of the scheduled job for reconciling users.

3.2.2 Limited Reconciliation for WebEx Connector

Limited or filtered reconciliation is the process of limiting the number of records being reconciled based on a set filter criteria.

By default, all target system records are reconciled during the current reconciliation run. You can customize this process by specifying the subset of target system records that must be reconciled. You do this by creating filters for the reconciliation module.

The following filter operators are supported:

  • equalTo

  • greaterThan

  • lessThan

  • and

  • or

You can apply the and, equalTo, and or filter parameters to the following attributes:

  • User Name

  • FirstName

  • LastName

  • Email

  • Active

  • __UID__

  • __NAME__

You can apply the greaterThan and lessThan filter parameters to the following attributes:

  • RegDateStart

  • RegDateEnd

You can perform limited reconciliation using the Filter attribute (a scheduled task attribute) that allows you to use any of the WebEx resource attributes to filter the target system records. For detailed information about the various filter syntax that are supported, refer the WebEx documentation.

3.2.3 Reconciliation Scheduled Job

Scheduled jobs for reconciliation are created when you run the Connector Installer. The Webex User Reconciliation scheduled job is used to reconcile user account data from the target system in the target resource (account management) mode of the connector.

Table 3-2 Attributes of the User Reconciliation Scheduled Job

Attribute Description

Filter

Enter the search filter for fetching records from the target system during a reconciliation run.

Sample value: equalTo('FirstName','john.doe')

See Limited Reconciliation for WebEx Connector.

IT Resource Name

Name of the IT resource for the target system installation from which you want to reconcile user records.

Default value: Webex

Object Type

Type of object you want to reconcile.

Default value: User

Note: User is the only object that is supported. Therefore, do not change the value of this attribute.

Resource Object Name

Name of the resource object that is used for reconciliation.

Default value: Webex User

Note: Do not change the value of this attribute.

Scheduled Task Name

Name of the scheduled task that is used for reconciliation.

Default value: Webex User Reconciliation

3.3 Configuring Scheduled Jobs

Configure scheduled jobs to perform reconciliation runs that check for new information on your target system periodically and replicate the data in Oracle Identity Manager.

To configure a scheduled job:
  1. Log in to Oracle Identity System Administration.
  2. In the left pane, under System Management, click Scheduler.
  3. Search for and open the scheduled task as follows:
    1. On the left pane, in the Search field, enter the name of the scheduled job as the search criterion. Alternatively, you can click Advanced Search and specify the search criterion.
    2. In the search results table on the left pane, click the scheduled job in the Job Name column.
  4. On the Job Details tab, you can modify the following parameters:
    • Retries: Enter an integer value in this field. This number represents the number of times the scheduler tries to start the job before assigning the Stopped status to the job.
    • Schedule Type: Depending on the frequency at which you want the job to run, select the appropriate schedule type.

    Note:

    See Creating Jobs in Oracle Fusion Middleware Administering Oracle Identity Manager for detailed information about the scheduled types.

    In addition to modifying the job details, you can enable or disable a job.
  5. On the Job Details tab, in the Parameters region, specify values for the attributes of the scheduled task.

    Note:

    • Attribute values are predefined in the connector XML file that you import. Specify values only for those attributes that you want to change.

    • Values (either default or user-defined) must be assigned to all the attributes. If even a single attribute value is left empty, then reconciliation is not performed.

    • Attributes of the scheduled job are discussed in Reconciliation Scheduled Job.

  6. Click Apply to save the changes.

    Note:

    You can use the Scheduler Status page in Identity System Administration to either start, stop, or reinitialize the scheduler.

3.4 Guidelines on Performing Provisioning Operations

You must apply the below guideline while performing a provisioning operation:

For a Create User provisioning operation, you must specify a value for the Username field. For example, John Doe. It is a mandatory field, other mandatory fields are First name, Last name, Email, and Password.

3.5 Performing Provisioning Operations

You create a new user in Oracle Identity Self Service by using the Create User page. You provision or request for accounts on the Accounts tab of the User Details page.

To perform provisioning operations in Oracle Identity Manager:
  1. Log in to Oracle Identity Self Service.
  2. Create a user. See Creating a User in Oracle Fusion Middleware Performing Self Service Tasks with Oracle Identity Manager.
  3. On the Account tab, click Request Accounts.
  4. In the Catalog page, search for and add to cart the application instance created for the IT resource (in Associating the Form with the Application Instance), and then click Checkout.

    Note:

    Ensure to select proper values for lookup type fields as there are a few dependent fields. Selecting a wrong value for such fields may result in provisioning failure.
  5. Click Ready to Submit.
  6. Click Submit.

3.6 Uninstalling the WebEx Connector

Uninstalling the connector involves deleting data related to the connector from Oracle Identity Manager Database. You use the Uninstall Connectors utility to uninstall a connector.

If you want to uninstall the connector for any reason, see Uninstalling Connectors in Oracle Fusion Middleware Administering Oracle Identity Manager.