Integrate with Oracle Internet Directory

The Oracle Internet Directory connector integrates Oracle Access Governance with Oracle Internet Directory. You can establish a connection between Oracle Internet Directory and Oracle Access Governance by entering connection details and configuring the connector. To achieve this, use the Connected Systems functionality available in the Oracle Access Governance Console.

Preinstall

Before you install and configure an Oracle Internet Directory connected system, you should consider the following pre-requisites and tasks.

Certified Components

The target system can be any one of the following:

  • Oracle Internet Directory 9.x
  • Oracle Internet Directory 10.1.4.x
  • Oracle Internet Directory 11g 11.1.1.5.0, 11.1.1.6.0, 11.1.1.7.0 and 11.1.1.9.0

Supported Connector Operations

The Oracle Internet Directory connected system supports the following connector operations:

  • User Management
    • Create user
    • Reset password
  • Entitlement Grant Management
    • Add groups
    • Revoke groups

Create a Target System User Account for Oracle Internet Directory Connected System Operations

Oracle Access Governance requires a user account to access the target system during service operations. Depending on the target system you are using, you can create the user in your target system and assign specific permissions and roles to the user.

For Oracle Internet Directory:

You must create a target system user account for performing the following functions.
  • Create, modify, and delete entries related to the managed objects, including accounts, groups, roles (if supported), and organizational units (ou).
  • Update passwords for users.

Create an admin user, admin group, and ACIs on the OID target system. To perform this task, you must be an administrator on the OID target system who is familiar with command-line utilities such as ldapsearch and ldapmodify. If you prefer, you can also use Oracle Directory Services Manager to perform these functions.

For details of how to do this, see the relevant sections in the following:

Install

You can establish a connection between Oracle Internet Directory and Oracle Access Governance by entering connection details and configuring your OID environment. To achieve this, use the Connected Systems functionality available in the Oracle Access Governance Console.

Navigate to the Connected Systems Page

Navigate to the Connected Systems page of the Oracle Access Governance Console, by following these steps:
  1. From the Oracle Access Governance navigation menu icon Navigation menu, select Service Administration → Connected Systems.
  2. Click the Add a connected system button to start the workflow.

Add a Connected System

From the Add a Connected System page, select the type of system that you would like to connect with Oracle Access Governance.

Select the Add button on the Would you like to connect to a directory? tile.

Select system

On the Select system step of the workflow, specify which type of database you would like to onboard.

  1. Select Oracle Internet Directory and click Next.

Enter details

On the Enter Details step of the workflow, enter the details for the connected system:

  1. Enter a name for the database you want to connect to in the What do you want to call your directory? field.
  2. Enter a description for the database in the How do you want to describe this directory? field.
  3. Determine if this connected system is an authoritative source, and if Oracle Access Governance can manage permissions for existing users by setting the following checkboxes.

    Table - Authoritative Source/Permission Management

    Checkbox Default Description
    This is the authoritative source for my Identities. Selected If selected, this checkbox means that this connected system is a trusted source for user or identity information.
    I want to manage permissions for this Connected System. Selected If selected, this checkbox means that Oracle Access Governance can provision accounts on the connected system, and manage permissions for existing accounts residing in the connected system.
  4. Click Next.

Configure

On the Configure step of the workflow, enter the configuration details required to allow Oracle Access Governance to connect to the target Oracle Internet Directory.

  1. In the Host Name field, enter the hostname or IP address for the directory you want to integrate with Oracle Access Governance.
  2. In the Port Number field, enter the value of the TCP/IP port number used to communicate with the LDAP server.
  3. Enter the distinguished name which you will use to authenticate to the directory, in the Administrator Username field. This is the user you created in Create a Target System User Account for Oracle Internet Directory Connected System Operations.
  4. Enter the password of the target distinguished name in the Administrator Password field. Confirm the password in the Confirm password field.
  5. Enter a base context from which to begin searches for users and groups into the Base Contexts field.
  6. In the Failover field, enter a list of failover servers in the format <servername>:<port>, <servername>:<port>, ..., for example OUDExample1:636, OUDExample1:636, ...
  7. In the SSL field, ensure that the value true is selected.
  8. Check the right hand pane to view What I've selected. If you are happy with the details entered, select Add to create the connected system.

Finish up

On the Finish Up step of the workflow, you are asked to download the agent you will use to interface between Oracle Access Governance and Oracle Internet Directory. Select the Download link to download the agent zip file to the environment in which the agent will run.

After downloading the agent, follow the instructions explained in the Agent Administration article.

Postinstall

There are no postinstall steps associated with a Oracle Internet Directory target.