Contents

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

What's New in the Oracle Identity Manager Connector for Generic Scripting?

• Software Updates
  • Software Updates in Release 11.1.1.5.0
• Documentation-Specific Updates
  • Documentation-Specific Updates in Release 11.1.1.5.0

1 About the Generic Scripting Connector

• 1.1 Introduction to the Generic Scripting Connector
• 1.2 Usage Recommendation
• 1.3 Certified Components for the Generic Scripting Connector
• 1.4 Certified Languages for the Generic Scripting Connector
• 1.5 Connector Architecture of the Generic Scripting Connector
• 1.6 Common Use Cases Supported by the Connector
• 1.7 Features of the Connector
  • 1.7.1 Support for Both Trusted Source and Target Resource Reconciliation
  • 1.7.2 Full and Incremental Reconciliation
  • 1.7.3 Limited (Filtered) Reconciliation
  • 1.7.4 Support for Reconciliation of Deleted Records
• 1.8 Roadmap for Generating and Using the Connector

2 Generating the Generic Scripting Connector

• 2.1 Defining the Schema
  • 2.1.1 Understanding the Schema File Format
    • 2.1.1.1 Account Qualifiers
    • 2.1.1.2 Field Qualifiers
  • 2.1.2 Creating a Schema File
• 2.2 Preparing the Resource Properties File
• 2.3 Configuring the ScriptConfiguration.groovy File
  • 2.3.1 About the ScriptConfiguration.groovy File
  • 2.3.2 Understanding Entries in the Predefined Sections of the Groovy File
  • 2.3.3 Configuring the Groovy File
• 2.4 Generating the Connector
  • 2.4.1 Understanding the Generated Connector Package

3 Installing and Configuring the Generic Scripting Connector

• 3.1 Preinstallation
• 3.2 Installing the Connector
  • 3.2.1 Understanding Installation
    • 3.2.1.1 Summary of Steps to Install the Connector
    • 3.2.1.2 About Installing the Connector Locally and Remote
  • 3.2.2 Running the Connector Installer
  • 3.2.3 Configuring the IT Resource for the Target System
• 3.3 Postinstallation
  • 3.3.1 Configuring Oracle Identity Manager
    • 3.3.1.1 Creating and Activating a Sandbox
    • 3.3.1.2 Creating a New UI Form
    • 3.3.1.3 Associating the Form with the Application Instance
    • 3.3.1.4 Publishing a Sandbox
    • 3.3.1.5 Harvesting Entitlements and Sync Catalog
  • 3.3.2 Replacing the groovy-all.jar File
  • 3.3.3 Localizing Field Labels in UI Forms
  • 3.3.4 Clearing Content Related to Connector Resource Bundles from the Server Cache
  • 3.3.5 Managing Logging for the Generic Scripting Connector
    • 3.3.5.1 Understanding Log Levels
    • 3.3.5.2 Enabling Logging
• 3.4 Upgrading the Connector

4 Using the Generic Scripting Connector

• 4.1 Lookup Definitions Used During Connector Operations
  • 4.1.1 Predefined Lookup Definitions
    • 4.1.1.1 Lookup.RESOURCE.Configuration
    • 4.1.1.2 Lookup.RESOURCE.UM.Configuration
    • 4.1.1.3 Lookup.RESOURCE.UM.ReconAttrMap
    • 4.1.1.4 Lookup.RESOURCE.UM.ProvAttrMap
    • 4.1.1.5 Lookup.RESOURCE.UM.ReconAttrMap.Defaults
  • 4.1.2 Lookup Definitions Synchronized with the Target System
• 4.2 Configuring Reconciliation
  • 4.2.1 Reconciliation Rules
  • 4.2.2 Full Reconciliation and Incremental Reconciliation
  • 4.2.3 Limited Reconciliation
  • 4.2.4 Lookup Field Synchronization
• 4.3 Scheduled Jobs
  • 4.3.1 Scheduled Job for Lookup Field Synchronization
  • 4.3.2 Scheduled Jobs for Reconciliation of User Records
  • 4.3.3 Scheduled Jobs for Reconciliation of Deleted Users Records
  • 4.3.4 Scheduled Jobs for Incremental Reconciliation
  • 4.3.5 Configuring Scheduled Jobs
• 4.4 Performing Provisioning Operations
• 4.5 Uninstalling the Connector

5 Extending the Functionality of the Generic Scripting Connector

• 5.1 Adding Custom OIM User Fields for Trusted Source Reconciliation
• 5.2 Adding Custom Fields for Target Resource Reconciliation
• 5.3 Adding Custom Fields for Provisioning
• 5.4 Configuring Transformation of Data During User Reconciliation
• 5.5 Configuring Validation of Data During Reconciliation and Provisioning

A Understanding Script Arguments

B Sample Schema, Scripts, and Connector Generation and Installation Procedure

• B.1 Summary of Steps to Generate and Use the Connector
• B.2 Sample Schema File for Database Creation
• B.3 Sample Schema Description
  • B.3.1 GENERIC.GENERIC_PARENT Table Description
  • B.3.2 GENERIC.GENERIC_GROUP Table Description
  • B.3.3 GENERIC.GENERIC_ROLE Table Description
  • B.3.4 GENERIC.ORGANIZATIONS Table Description
• B.4 Sample Schema File for the Target System
• B.5 Sample ScriptConfiguration.groovy File
• B.6 Sample Resource Properties File
• B.7 Sample Scripts for Connector Operations
  • B.7.1 Check Alive Script
  • B.7.2 Connection Script
  • B.7.3 Dispose Script
  • B.7.4 Create Script
  • B.7.5 Update Script
  • B.7.6 Delete Script
  • B.7.7 Add Child Data Script
  • B.7.8 Remove Child Data Script
  • B.7.9 Lookup Field Synchronization Script
  • B.7.10 Full and Filtered Reconciliation Script
  • B.7.11 Incremental Reconciliation Script

C Files and Directories of the Generic Scripting Connector