Creating the Connector Facade

Important

Connectors continue to be released outside the IDM release. For the latest documentation, refer to the ICF documentation.

Applications access the connector API through a ConnectorFacade class, and interact with the connector through a ConnectorFacade instance.

The following steps describe how to create a ConnectorFacade in your application.

Create a ConnectorInfoManager and acquire the ConnectorInfo object for your connector, as described in the previous section.

From the ConnectorInfo object, create the default APIConfiguration.

APIConfiguration apiConfig = info.createDefaultAPIConfiguration();

Use the default APIConfiguration to set the ObjectPoolConfiguration, ResultsHandlerConfiguration, ConfigurationProperties, and TimeoutConfiguration.
```
ConfigurationProperties properties = apiConfig.getConfigurationProperties();
```

Set all of the ConfigurationProperties that you need for the connector, using setPropertyValue().

properties.setPropertyValue("host", SAMPLE_HOST);
properties.setPropertyValue("adminName", SAMPLE_ADMIN);
properties.setPropertyValue("adminPassword", SAMPLE_PASSWORD);
properties.setPropertyValue("useSSL", false);

Use the newInstance() method of the ConnectorFacadeFactory to create a new instance of the connector.
```
ConnectorFacade conn = ConnectorFacadeFactory.getInstance()
        .newInstance(apiConfig); 
```
Validate that you have set up the connector configuration correctly.
```
conn.validate(); 
```
Use the new connector with the supported operations (described in the following sections).
```
conn.[authenticate|create|update|delete|search|...]  
```