Issue: Setting Up IIQ Development Environment in IntelliJ

[raygarg]

Which IIQ version are you inquiring about?

8.3

I have successfully installed and configured SailPoint IdentityIQ using the .war file, and I can access the SailPoint Console via the browser when my Tomcat server is running. However, I am struggling to set up my local development environment in IntelliJ IDEA for writing and testing Java code using the SailPoint API.

What I Have Done So Far

1. Set Up the IntelliJ Project:

• Created a Maven-based project.
• Added all required JAR files from the WEB-INF/lib folder as External Libraries in IntelliJ.

2. Copied Required Configuration Files:

• Placed all hbm.xml files inside src/main/resources/sailpoint.objects/
• Copied iiq.properties into src/main/resources/

3. Attempted to Run a Simple Test Code:

Steps I’ve Already Tried

• Invalidate Caches & Restart in IntelliJ
• Rebuilt the project
• Checked that all JAR files (including identityiq.jar) are added
• Verified that iiq.properties is correctly placed in src/main/resources
• Tried running with Tomcat running and stopped – same issue
• Tried different working directory settings in Run Configurations (WEB-INF vs. empty)

Questions for the Community

1. Is my project structure correct for SailPoint IIQ development?
2. Do I need to set up any additional environment variables or properties?
3. How should I properly initialize SailPoint IIQ in a standalone Java project?
4. Does IntelliJ require special configuration for IdentityIQ development (like classpath modifications, specific runtime settings, etc.)?
5. Why am I getting “No prototype context exists” and “Cannot resolve symbol IdentityIQ”?
6. Do I need to modify my Run Configuration settings? If so, what should be the correct setup?

[abartkowski (Adam Bartkowski)]

Hi!

First, set up a test directory inside the main directory, such as src.

• Open IntelliJ IDEA.
• Go to File → Project Structure → Modules.
• Select src and mark it as Sources (blue folder icon).
• Select test and mark it as Test Sources (green folder icon).

You need to add the required libraries for testing.

To do this in IntelliJ:

• Open File → Project Structure → Libraries.
• Click + → Java and navigate to your JUnit .jar files.
• Select them and click OK to add them as project dependencies.
• If you keep your libraries in a lib directory, you can import this directory directly.

In my projects I have lib directory and this directory will be imported directly.

Ensure that your project uses a compatible Java version:

• Go to File → Project Structure → Project.
• Set Project SDK to Java 17 (or a compatible version for your JUnit).
• Under Modules, make sure the Language level is also set to at least Java 17.

Run tests.

Test class example:

import org.junit.jupiter.api.Test;
import sailpoint.object.Identity;
import sailpoint.tools.GeneralException;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.mockito.Mockito.*;

class ADUtilTest {
    @Test
    public void testCreateDistinguishedName() throws GeneralException {
        Identity identity = mock(Identity.class);
        when(identity.getFirstname()).thenReturn("John");
        when(identity.getLastname()).thenReturn("Doe");
        when(identity.getStringAttribute("employeeid")).thenReturn("12345");

        ADUtil util = new ADUtil();
        String dn = util.createDistinguishedName(identity);

        assertEquals("CN=Doe John 12345,...", dn);
    }
}

[abartkowski (Adam Bartkowski)]

Regarding Maven Project, I do not have experience but I think similar way of setup should work fine.

1. Instead of manually adding .jar files, define dependencies in pom.xml
2. Open IntelliJ IDEA.

• Go to File → Project Structure → Project.
• Go to File → New → Project from Existing Sources and select pom.xml (or convert your existing project to Maven via “Add Framework Support” → Maven).

3. Refresh Maven Dependencies

When working with SailPoint IdentityIQ, you may come across SSB (Standard Service Builder) and SSD (Standard Service Definitions). These concepts help streamline service integration, reduce manual configurations, and improve maintainability.

[aleksander_jachowicz]

Hi @raygarg
I thing the best way to go is SSB. Pelase read the documentation available. You will have to switch to ant as maven is not supported by SSB.

[raygarg]

Hello @aleksander_jachowicz The documentation link you gave me is expired. can you please provide the necessary documentation to go through.

[aleksander_jachowicz]

Strange. I just checked it: https://community.sailpoint.com/t5/Professional-Services/Services-Standard-Build-SSB-v7-0-2/ta-p/190496
Instead log in to compass and search for SSB in professional services section.

[raygarg]

hi i am logged in, but it says access denied. can you please donwlaod the pdf and link the pdf here? i want to use SSB with ant if that is the way sailpoint reccomends to set up development enviornemnt, as i am still not able to get maven to work @aleksander_jachowicz

[aleksander_jachowicz]

This is not just pfd, it’s also some zip artifacts you need to download (https://community.sailpoint.com/mpomh84452/attachments/mpomh84452/professional-services-documentation/106/7/ssb-v7.0.2.zip).
User guide is availabe here: https://community.sailpoint.com/t5/Professional-Services/Services-Standard-Build-SSB-v7-0-2/ta-p/190496?attachment-id=12921

You need to get your access sorted out with sailpoint.

[raygarg]

Okay, apologies for somany questions. but would you know theportal page to submit a ticket or something. just want access to that documentation page with the zip and instructions thats why @aleksander_jachowicz

[abartkowski (Adam Bartkowski)]

You mean Sailpoint support portal?

here is the link: SailPoint Support Homepage - Customer Support

[abartkowski (Adam Bartkowski)]

If you want only access the page that is mentioned by Aleksander you need to register first on the compass website.
After registration you will have access to those files and instructions regarding SSB.

[paul_hilchey]

Hi Ray,

The DevSecOps toolkit is what you need: https://community.sailpoint.com/t5/Professional-Services/IdentityIQ-DevSecOps-Toolkit-Alpha-V2/ta-p/196332

It has the archetype for maven.