Contents

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

What’s New in Oracle Identity Manager Connector for Generic REST?

• Software Updates
• Documentation-Specific Updates

1 About the Generic REST Connector

• 1.1 Introduction to the Generic REST Connector
• 1.2 Certified Components for the Generic REST Connector
• 1.3 Certified Languages for the Generic REST Connector
• 1.4 Features of the Generic REST Connector
  • 1.4.1 Support for Both Trusted Source and Target Resource Reconciliation
  • 1.4.2 Full and Incremental Reconciliation
  • 1.4.3 Limited (Filtered) Reconciliation
  • 1.4.4 Custom Authentication
  • 1.4.5 Custom Parsing
  • 1.4.6 Custom Payload
  • 1.4.7 Support for Additional HTTP Headers
  • 1.4.8 Support for Handling Multiple Endpoint URLs
  • 1.4.9 SSL Communication
• 1.5 Use Cases Supported by the Generic REST Connector
• 1.6 Architecture of the Generic REST Connector
• 1.7 Generic REST Connector Concepts

2 Prerequisites for Installing the Generic REST Connector

• 2.1 Downloading the Connector Installation Package
• 2.2 Creating a Schema File
• 2.3 Updating the Groovy File
  • 2.3.1 About the dateAttributeList, entitlementAttributeList, lookupAttributeList, and alias Entries of the Groovy File

3 Installing the Generic REST Connector

• 3.1 Installing the Connector Installation Package
• 3.2 Generating and Installing the Connector Metadata Package
  • 3.2.1 Running the Metadata Generator
  • 3.2.2 Installing the Connector Metadata Package
  • 3.2.3 Understanding the Generated Connector Metadata Package for the Generic REST Connector

4 Configuring the Generic REST Connector

• 4.1 Configuring the IT Resource for the Target System
  • 4.1.1 Specifying Values for the IT Resource Parameters
  • 4.1.2 Connection Parameters
  • 4.1.3 Authentication Parameters
  • 4.1.4 Parser Parameters
  • 4.1.5 Additional Configuration Parameters
• 4.2 Performing Postinstallation Tasks
  • 4.2.1 Configuring Oracle Identity Manager
    • 4.2.1.1 Creating and Activating a Sandbox
    • 4.2.1.2 Creating a New UI Form
    • 4.2.1.3 Associating the Form with the Application Instance
    • 4.2.1.4 Publishing a Sandbox
    • 4.2.1.5 Harvesting Entitlements and Sync Catalog
  • 4.2.2 Managing Logging for the Generic REST Connector
    • 4.2.2.1 Understanding Log Levels
    • 4.2.2.2 Enabling Logging
  • 4.2.3 Configuring SSL
  • 4.2.4 Localizing Field Labels in UI Forms
  • 4.2.5 Clearing Content Related to Connector Resource Bundles from the Server Cache

5 Using the Generic REST Connector

• 5.1 Configuring Reconciliation
  • 5.1.1 Reconciliation Rules for the Generic REST Connector
  • 5.1.2 Full Reconciliation and Incremental Reconciliation
  • 5.1.3 Updating the User Reconciliation Scheduled Job for Incremental Reconciliation
  • 5.1.4 Limited (Filtered) Reconciliation
  • 5.1.5 Lookup Field Synchronization
  • 5.1.6 Reconciling Large Number of Records
• 5.2 Scheduled Jobs
  • 5.2.1 Scheduled Job for Lookup Field Synchronization
  • 5.2.2 Scheduled Jobs for Reconciliation of User Records
  • 5.2.3 Configuring Scheduled Jobs
• 5.3 Performing Provisioning Operations
• 5.4 Uninstalling the Connector

6 Extending the Functionality of the Generic REST Connector

• 6.1 Implementing Custom Authentication
• 6.2 Implementing Custom Parsing
• 6.3 Adding Custom OIM User Fields for Trusted Source Reconciliation
• 6.4 Adding Custom Fields for Target Resource Reconciliation
• 6.5 Adding Custom Fields for Provisioning
• 6.6 Configuring Transformation of Data During User Reconciliation
• 6.7 Configuring Validation of Data During Reconciliation and Provisioning

7 Frequently Asked Questions for the Generic REST Connector

A Sample Schema File

B Lookup Definitions Used During Connector Operations

• B.1 Predefined Lookup Definitions
  • B.1.1 Lookup.RESOURCE.Configuration
  • B.1.2 Lookup.RESOURCE.UM.Configuration
  • B.1.3 Lookup.RESOURCE.UM.ReconAttrMap
  • B.1.4 Lookup.RESOURCE.UM.ProvAttrMap
  • B.1.5 Lookup.RESOURCE.UM.ReconAttrMap.Defaults
• B.2 Lookup Definitions Synchronized with the Target System

C Files and Directories of the Generic REST Connector