1. Configuring a Generic REST-Based Application
  2. Files and Directories of the Generic REST Connector

7 Files and Directories of the Generic REST Connector

These are the components of the connector installation package and connector metadata package that comprise the Generic REST connector.

Table 7-1 describes the files and directories in the connector installation package.

Table 7-1 Files and Directories in the Connector Installation Package

File in the Installation Package Directory Description

bundle/org.identityconnectors.genericrest-12.3.0.jar

This JAR file is the ICF connector bundle.

configuration/GenericREST-CI.xml

This file is used for installing a CI-based connector. This XML file contains configuration information that is used by the Connector Installer during connector installation.

Files in the resources directory

Each of these resource bundles contains language-specific information that is used by the connector. During connector installation, these resource bundles are copied to Oracle Identity database.

Note: A resource bundle is a file containing localized versions of the text strings that are displayed on the Administrative and User Console. These text strings include GUI element labels and messages.

xml/GenericREST-auth-template.xml

This file contains definitions for the connector objects required for creating an Authoritative application. It includes certain details required to connect Oracle Identity Governance with the target system. It also includes configuration details specific to your target system, attribute mappings, correlation rules, and reconciliation jobs.

xml/GenericREST-ConnectorConfig.xml

This XML file contains definitions for the connector components. These components include the following:

  • IT resource type
  • Process form
  • Process task and adapters (along with their mappings)
  • Resource object
  • Provisioning process
  • Prepopulate rules
  • Lookup definitions
  • Scheduled tasks

xml/GenericREST-pre-config.xml

This XML file contains definitions for the connector objects associated with any non-User objects such as Groups, Organizations, and so on. Also, it contains definitions of Lookups and schedule tasks.

xml/GenericREST-target-template.xml

This file contains definitions for the connector objects required for creating a Target application. It includes certain details required to connect Oracle Identity Governance with the target system. It also includes configuration details specific to your target system, attribute mappings, correlation rules, and reconciliation jobs.

metadata-generator/bin/classpath_append.cmd

metadata-generator/bin/classpath.cmd

These files contain the commands that add the JAR files (located in the lib directory) to the classpath on Microsoft Windows.

metadata-generator/bin/GenericRestGenerator.cmd

metadata-generator/bin/GenericRestGenerator.sh logging.properties

This file contains commands to run the metadata generator.

Note that the .cmd file is the Microsoft Windows version of the metadata generator. Similarly, the .sh file is the UNIX version of the metadata generator.

metadata-generator/lib/connector-framework-internal.jar groovy-ant.jar groovy-sql.jar

This JAR file contains class files that define the ICF Application Programming Interface (API). This API is used to communicate between Oracle Identity Manager and this connector.

metadata-generator/lib/connector-framework.jar groovy-groovydoc.jar groovy-xml.jar

This JAR file contains the groovy libraries required for running the metadata generator.

metadata-generator/lib/GenericREST-oim-integration.jar groovy.jar

This JAR file contains the class files of the metadata generation utility.

metadata-generator/lib/org.identityconnectors.genericrest-12.3.0.jar

These files contain the commands that add the JAR files (located in the lib directory) to the classpath on Microsoft Windows.

metadata-generator/resource/GenericRestConfiguration.groovy

This file contains properties that store basic information about the target system schema, which is used to configure the mode (trusted source or target resource) in which you want to run the connector. In addition, it stores information about the manner in which the connector must connect to the target system.