Installing the .NET Connector Server Configuring the .NET Connector Server

17 Developing Identity Connectors 17-1 17 Developing Identity Connectors This chapter is a tutorial that walks through the procedures necessary to develop an identity connector using the Identity Connector Framework ICF and the Oracle Identity Manager metadata. It includes information about important ICF classes and interfaces, the connector bundle, the connector server, and code samples for implementing a flat file identity connector and creating Oracle Identity Manager metadata for user provisioning and reconciliation processes. It contains the following sections: ■ Developing a Flat File Connector ■ Uploading the Identity Connector Bundle to Oracle Identity Manager Database ■ Provisioning a Flat File Account

17.1 Developing a Flat File Connector

The procedure for developing a flat file connector is to develop an implementation of the Configuration interface followed by the implementation of the Connector class. Before beginning, you must prepare IO representation modules for all flat file connector operations. This might include all or some of the following: ■ Read the column names of the flat file and prepare metadata information. ■ Add a record to the flat file with the corresponding column values separated by the specified delimiter. ■ Delete a record to the flat file based on the UID value. ■ Search operations on flat file. This tutorial is focused on identity connector development, and therefore, these preparations are not discussed in detail. Note: The following supporting classes are used for file input and output handling during identity connector operations: ■ org.identityconnectors.flatfile.io.FlatFileIOFactory ■ org.identityconnectors.flatfile.io.FlatFileMetadata ■ org.identityconnectors.flatfile.io.FlatFileParser ■ org.identityconnectors.flatfile.io.FlatFileWriter See Supporting Classes for File Input and Output Handling on page 17-9 for the implementations of the input and output handling supporting classes. 17-2 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager To develop a flat file connector: 1. Implement the configuration class for the Flat File Connector by extending the org.identityconnectors.framework.spi.AbstractConfiguration base class. Example 17–1 is a sample of this. See Section 16.3.1.2, org.identityconnectors.framework.spi.Configuration for more information. Example 17–1 Implementation of AbstractConfiguration package org.identityconnectors.flatfile; import java.io.File; import org.identityconnectors.flatfile.io.FlatFileIOFactory; import org.identityconnectors.framework.common.exceptions.ConfigurationException; import org.identityconnectors.framework.spi.AbstractConfiguration; import org.identityconnectors.framework.spi.ConfigurationProperty; Class for storing the flat file configuration public class FlatFileConfiguration extends AbstractConfiguration { Storage file name private File storeFile; Delimeter used private String textFieldDelimeter; Unique attribute field name private String uniqueAttributeName = ; Change attribute field name. Should be numeric private String changeLogAttributeName = ; public File getStoreFile { return storeFile; } public String getTextFieldDelimeter { return textFieldDelimeter; } public String getUniqueAttributeName { return uniqueAttributeName; } public String getChangeLogAttributeName { return changeLogAttributeName; } Set the store file param storeFile ConfigurationPropertyorder = 1, helpMessageKey = USER_ACCOUNT_STORE_HELP, displayMessageKey = USER_ACCOUNT_STORE_DISPLAY public void setStoreFileFile storeFile { this.storeFile = storeFile;