2 Creating an Application by Using the Connector

Learn about onboarding applications using the connector and the prerequisites for doing so.

• Prerequisites to be done in Siebel Target to Use the Enable/Disable Feature in the Connector

• Prerequisites for Creating an Application By Using the Connector

• Process Flow for Creating an Application By Using the Connector

• Creating an Application By Using the Siebel Connector

2.1 Prerequisites to be done in Siebel Target to Use the Enable/Disable Feature in the Connector

You can add the User Status attribute in target by following either of the following steps:

• Manually Making Configuration Changes
• Importing SIF File

2.1.1 Manually Making Configuration Changes

Perform the followings tasks to manually make the configuration changes:

1. Login to Siebel Web Tools..
2. Create Workspace.
   1. Click Workspace dashboard button next to the option Main.
   2. Click Create button on top.
   3. Enter the name for your Workspace and provide comments and create the workspace.

      The workspace is now available under Main.

3. Close the window.
4. Open the newly created workspace and locate the Employee BusComp as follows.
   1. Under Type, select Expand Business Component, and clickField.
   2. In the Business Component drop-down, select Name and search for the employee.
   3. In the Fields option, add a new field with the following attributes:

      Attribute	Value
      Name	User Status
      Join	S_USER
      Column	STATUS_CD
      Picklist	User Status Picklist
      Text Length	30
      Type	DTYPE_TEXT

5. Create a child Pick Map for this field as follows:
   1. Expand the option Field under Business component and select Pick Map
   2. Add the following attributes under Pick Map.

      Attribute	Value
      Field	User Status
      Picklist Field	Value

6. Navigate to the Employee List Applet as follows.
   1. Expand Applet, and select List.
   2. Under Applet drop-down list, select Name and search for Employee List.
7. Go to List Column under List and add a new list column with the following attributes:

   Attribute	Value
   Name	User Status
   Field	User Status
   Available	TRUE
   Display Name – String Reference	SBL_USER_STATUS-1004233658-7EI
   Display Name	User Status
   HTML Display Mode	EncodeData
   HTML List Edit	TRUE
   HTML Row Sensitive	TRUE
   HTML Type	Field
   Runtime	TRUE
   Text Alignment	Left
   Show in List	TRUE
   Text Alignment-Label	Left

8. For the same applet, choose the Edit List Applet Web Template to add the newly created list column to any empty placeholder in the list as follows:
   1. Expand Applet and select Applet Web Template.
   2. Under Applet Web Template, choose an empty place holder in Edit List and select Edit.
   3. Click Controls/Columns, and deselect the option show unmapped controls only and select User Status
9. Unit test the changes:
   1. Open the Siebel Call Center to Open and Inspect the workspace for ensuring that the newly added column User Status appears in the user interface to change from Active to Inactiveand oppositely.
   2. Change the status to Inactive for different known users.
   3. Log out.
   4. Try to log in as other user.

      Note:

      This test should fail.
10. Deliver the workspace.
    1. Login to Siebel Web Tools.
    2. Click Workspace dashboard button and select your workspace and then click Open.
    3. Click Version to provide the comments and create the version.
    4. Click Submit and submit the delivery in the pop-up window. e.
    5. Click Deliver to provide the comments and deliver the workspace.

2.1.2 Importing SIF File

This approach allows a customer developer to make the changes (without the manual modifications described above) through the import of an archive file (SIF) containing the repository changes.

Perform the following steps:

1. In Siebel Web Tools, create a Developer Workspace under a upcoming release branch (Integration Workspace).
   1. Click Workspace dashboard option next to Main.

      b. Click Create.

   2. Enter the name of your Workspace and provide comments to create the workspace.

      The workspace is now visible under Main.

   3. Open the newly created workspace.
2. Select Archive > Import from Archive menu item.
3. Follow the wizard to import the file.
4. Checkpoint and submit the workspace for delivery, rebasing if necessary.
5. Deliver the workspace as follows:
   1. Click the Workspace dashboard option and select your workspace then click Open.
   2. Click Version to provide your comments and create the version.
   3. Click Submit and submit for delivery in the pop-up window.
   4. Click Deliver to provide the comments and deliver the workspace.

      b.

6. Test the changes as follows:
   1. Open the Siebel Call Center and click Open to inspect the workspace for ensuring that the newly added column is visible under User Status in the user interface and can be changed from Active to Inactive and the opposite.
   2. Change the status to Inactive for different known users.
   3. Log out.
   4. Try to log in as other user.

      Note:

      This test should fail.

2.2 Prerequisites for Creating an Application By Using the Connector

Learn about the tasks that you must complete before you create the application.

• Configuring the Target System

• Using External Code Files

• Creating the Target System User Account for Connector Operations

• Downloading the Connector Installation Package

2.2.1 Configuring the Target System

Note:

Perform this procedure only if you want to use RSA encryption on the target system.

You can configure encryption to secure communication between the target system server and Oracle Identity Manager. This section discusses the following topics related to configuring encryption:

• Enabling RSA Encryption on Siebel

• Configuring the Siebel Web Server Extension for RSA Encryption

• Enabling RSA Encryption for the Siebel Call Center Application

• Starting the Siebel Software Configuration Wizard

2.2.1.1 Enabling RSA Encryption on Siebel

This section describes how to configure the target system to use RSA encryption for Siebel Internet Session API (SISNAPI) communication between the target system server and Oracle Identity Manager.

To enable RSA encryption on Siebel:

1. Start the Siebel Software Configuration Wizard.

   This wizard is started automatically when you install the target system. If required, you can start it manually by following instructions given in Starting the Siebel Software Configuration Wizard.

2. On the Encryption Type page of the wizard, select the RSA option to specify that you want to use the RSA Security Systems 128-bit strong encryption feature for the target system components.
3. Review the settings, and exit the wizard.
4. Restart the server.

2.2.1.2 Configuring the Siebel Web Server Extension for RSA Encryption

After you configure the target system for RSA encryption, perform the same procedure to configure the Siebel Web Server Extension for RSA encryption.

2.2.1.3 Enabling RSA Encryption for the Siebel Call Center Application

To enable RSA encryption for the Siebel Call Center Application:

1. Start the Siebel Call Center Application.
2. Navigate to Sitemap, Server Administration, Components, and Component Parameters.
3. Query for Call Center Object Manager (ENU) in the Server Component-Parameter List applet.
4. In the applet, select the Encryption Type parameter and select RSA. If RSA encryption is not required, then select None instead of RSA.

2.2.1.4 Starting the Siebel Software Configuration Wizard

This section provides information about starting the Siebel Software Configuration Wizard.

The Siebel Software Configuration Wizard opens automatically after the installation of most server components. If required, you can use one of the following methods to manually start the wizard on a Microsoft Windows computer:

From the Microsoft Windows desktop:

1. Click Start.

2. Select Programs, Siebel Servers 7.0, and Configure SERVER_TYPE, where SERVER_TYPE is the server you want to configure. For example, SERVER_TYPE can be Siebel Gateway.

From a command window:

1. In a command window, navigate to the bin subdirectory component to configure components in the SIEBEL_ROOT directory. For example, D://sea700/siebsrvr/bin.
2. Depending on the component that you want to configure, enter one of the following commands:

   • To configure the Siebel Database Server, enter the following command:

     ssincfgw -l LANGUAGE -v y
     

   • To configure any component except the Siebel Database Server, enter the following command:

     ssincfgw -l LANGUAGE
     

   In these commands, replace LANGUAGE with the language in which the Siebel Software Configuration Wizard must run. For example, replace LANGUAGE with ENU for U.S. English or DEU for German. When you run any one of these commands, a menu of configuration modules for each installed component is displayed.

2.2.2 Using External Code Files

Depending on the target system version that you are using, copy these external code files.

• For Siebel 7.5 through 7.7

  Copy the following files from the SIEBEL_INSTALLATION_DIRECTORY/siebsrvr/CLASSES directory into the OIM_HOME/ConnectorDefaultDirectory/targetsystems-lib/siebel-RELEASE_NUMBER directory:

  • SiebelJI.jar
  • SiebelJI_Common.jar
  • SiebelJI_enu.jar

• For Siebel 7.8 through 8.2.2 and Siebel Innovation Pack 2015, 2016, 2017, 2018, Siebel 19.x, Siebel 20.x

  Copy the following files from the SIEBEL_INSTALLATION_DIRECTORY/siebsrvr/CLASSES directory into the OIM_HOME/ConnectorDefaultDirectory/targetsystems-lib/siebel-RELEASE_NUMBER directory:

  • Siebel.jar
  • SiebelJI_enu.jar

Note:

If a particular directory does not exist on the Oracle Identity Manager host computer, then create it.

2.2.3 Creating the Target System User Account for Connector Operations

Oracle Identity Manager uses a target system user account to provision to and reconcile data from the target system. To create this target system user account with the permissions required for performing connector operations:

Note:

The target system user account that you create for connector operations must also be created in the LDAP repository. As a security precaution, you must ensure that this account does not have access to areas protected by Oracle Access Manager.

1. Create the user account on Siebel as follows:

   1. Log in to Siebel.

   2. Click the Site Map icon.

   3. Click Administration – User.

   4. Click Employees.

   5. Click New.

   6. Enter the following details for the account that you are creating:

      Last Name

      First Name

      Job Title

      User ID

      Responsibility: Select Siebel Administrator.

      Position: Select Siebel Administrator.

      Organization: Select Default Organization.

      Employee Type

2. Create the user account on the Siebel database as follows:

   1. Open the Siebel home directory.

   2. Open the dbsrvr directory.

   3. Open one of the following directories:

      For IBM DB2 UDB: DB2

      For Microsoft SQL Server: MSSQL

      For Oracle Database: Oracle

   4. Open one of the following files in a text editor:

      For IBM DB2 UDB: grantusrdb2.sql

      For Microsoft SQL Server: addusrmsql.sql

      For Oracle Database: grantusroracle.sql

   5. In the file that you open:

      Specify the user ID of the user that you create in Step 1.

      Set a password for the user.

      Provide other required details.

   6. Run the script.

2.2.4 Downloading the Connector Installation Package

You can obtain the installation package for your connector on the Oracle Technology Network (OTN) website.

To download the connector installation package:

1. Navigate to the OTN website at http://www.oracle.com/technetwork/middleware/id-mgmt/downloads/connectors-101674.html.
2. Click OTN License Agreement and read the license agreement.
3. Select the Accept License Agreement option.
   You must accept the license agreement before you can download the installation package.
4. Download and save the installation package to any directory on the computer hosting Oracle Identity Governance.
5. Extract the contents of the installation package to any directory on the computer hosting Oracle Identity Governance. This creates a directory named CONNECTOR_NAME-RELEASE_NUMBER.
6. Copy the CONNECTOR_NAME-RELEASE_NUMBER directory to the OIG_HOME/server/ConnectorDefaultDirectory directory.

2.3 Process Flow for Creating an Application By Using the Connector

From Oracle Identity Governance release 12.2.1.3.0 onward, connector deployment is handled using the application onboarding capability of Identity Self Service.

Figure 2-1 is a flowchart depicting high-level steps for creating an application in Oracle Identity Governance by using the connector installation package.

Figure 2-1 Overall Flow of the Prcoess for Creating an Application By Using the Connector

2.4 Creating an Application By Using the Siebel Connector

You can onboard an application into Oracle Identity Governance from the connector package by creating a Target application. To do so, you must log in to Identity Self Service and then choose the Applications box on the Manage tab.

The following is the high-level procedure to create an application by using the connector:

Note:

For detailed information regarding each step in this procedure, see Creating Applications of Oracle Fusion Middleware Performing Self Service Tasks with Oracle Identity Governance.

1. Create an application in Identity Self Service. The high-level steps are as follows:
   1. Log in to Identity Self Service either by using the System Administration account or an account with the ApplicationInstanceAdministrator admin role.
   2. Ensure that the Connector Package option is selected when creating an application.
   3. Update the basic configuration parameters to include connectivity-related information.
   4. If required, update the advanced setting parameters to update configuration entries related to connector operations.
   5. Review the default user account attribute mappings. If required, add new attributes or you can edit or delete existing attributes.
   6. Review the provisioning, reconciliation, organization, and catalog settings for your application and customize them if required. For example, you can customize the default correlation rules for your application if required.
   7. Review the details of the application and click Finish to submit the application details.

      The application is created in Oracle Identity Governance.

   8. When you are prompted whether you want to create a default request form, click Yes or No.

      If you click Yes, then the default form is automatically created and is attached with the newly created application. The default form is created with the same name as the application. The default form cannot be modified later. Therefore, if you want to customize it, click No to manually create a new form and attach it with your application.

2. Verify reconciliation and provisioning operations on the newly created application.

Note:

• Configuring the Connector of for details on basic configuration and advanced settings parameters, default user account attribute mappings, default correlation rules, and reconciliation jobs that are predefined for this connector.
• Configuring Oracle Identity Governance for details on creating a new form and associating it with your application, if you chose not to create the default form