IdentityIQ Custom Connector Modern Sample

Hello everyone,

I’m searching for an IdentityIQ custom connector sample that I can use as a reference for our custom connector development. I have downloaded the CustomConnectorTest.zip which contains a sample, but it seems outdated as it contains methods that are no longer found in IdentityIQ v8.5 Java documentation.

Thanks in advance

@kareem_ramzi Lot of Compass links are still broke. I am not able to access the original post in Compass. Found this alternate link with relevant details: SailPoint IdentityIQ Custom Connector – EnH iSecure Blog

Please see if it helps you.

@neel193 Thank you for your reply

Unfortunately, the link you referenced contains videos of sample code that still uses old methods that are no longer found in the IdentityIQ Java Documentation, some of the methods are create(), update(), testConnection(), etc… Not sure where their replacements are in the latest Java docs.

@kareem_ramzi In that case your best bet would be to drop an email to Sailpoint Support, support@sailpoint.com

If an updated documentation and sample project available, they should be able to share it with you.

Hi @kareem_ramzi,

I think the confusion comes from looking at two different connector APIs rather than methods being removed in IIQ 8.5.

IdentityIQ supports two approaches for developing custom connectors:

  1. OpenConnector framework (openconnector.AbstractConnector): This provides methods such as testConnection(), create(), update(), delete(), enable(), disable(), read() and iterate(Filter). The framework handles much of the provisioning plan processing through its default provision() implementation.

  2. Native IdentityIQ connector API (sailpoint.connector.AbstractConnector): This uses methods such as testConfiguration(), iterateObjects(...), getObject(...) and provision(ProvisioningPlan), where you handle provisioning logic directly.

The CustomConnectorTest sample uses the OpenConnector framework, which explains why you cannot find those methods in the standard sailpoint.* JavaDoc.

For an OpenConnector implementation, your Application XML should reference:

  • connector="sailpoint.connector.OpenConnectorAdapter"

  • <entry key="connectorClass" value="your.package.YourConnector"/> inside the Attributes Map.

The adapter bridges your OpenConnector implementation with IdentityIQ’s native connector API.

The approach is still relevant, but I would recommend compiling against the appropriate OpenConnector SDK libraries and verifying the method signatures and dependencies for your IIQ 8.5 environment, as older samples may require some adjustments.

You can also check this SailPoint Labs example for an OpenConnector implementation:

Hope this helps and let’s us know if you find something !!! :slight_smile:

@sbisson Very informative, thank you a lot.

I did some digging and found out that the connector-bundle-identityiq.jar found in the WEB-INF/lib directory actually contains the openconnector.AbstractConnector class, which also contains the methods inquired about such as create(), update(), enable(), testConnection(), etc…

Thank you once again.