SailPoint IdentityIQ and EPM

This document provides the steps required to configure the integration between SailPoint IdentityIQ and Endpoint Privilege Management for Windows and Mac.

Create the IdentityIQ Service Account in EPM

Create an API account for IdentityIQ for EPM integration.

  1. Log on to the EPM web console as an Administrator.
  2. Go to Configuration, and then API Settings.
  3. Create an API account for IdentityIQ.

 

Configure SCIM Application in IdentityIQ for EPM

You must log on to IdentityIQ using administrator credentials.

Add application in IdentityIQ for EPM integration.

  1. Go to Applications, and then Application Definition.
  2. Click the Add New Application button.

 

In IdentityIQ, add application details for a EPM integration.

  1. From the Application Type menu, select SCIM 2.0. Provide a name for the application.

 

Application configuration settings in IdentityIQ for EPM integration.

  1. On the Configuration tab, provide the base URL and token URL. Select Client Credentials for Grant type. Enter the client ID and secret for the svc_iiq API account.

If the instance URL is https://pmc01.acme.somedomain.net then the API URLs are based on https://pmc01-services.acme.somedomain.com.

 

  1. Try testing the connection at this point.

Account attributes discovered in IdentityIQ setup with EPM integration

  1. Go to the Schema tab.
  2. Click Discover Schema Attributes for Object Type: account.
  3. The attributes discovered for account are shown.

 

List of SailPoint IdentiyIQ attributes to retain in Endpoint Privilege Management for Windows and Mac integration.

  1. Delete extra attributes and keep the attributes shown here.

 

Discover schema attributes in IdentityIQ for Endpoint Privilege Management for Windows and Mac integration.

  1. Discover the schema attributes for roles, and keep the attributes as shown.

 

  1. Click Provisioning Policies.
  2. Click Add Policy, and then click Create Policy Form.

Add section in IdentityIQ for EPM for integration.

  1. Click Add Section, then + on the new Section and Add Field. The first field is userName which maps to email address. Click Apply.

    The script format: return identity.getAttribute("email");

 

Set attribute givenName in IdentityIQ for EPM integration.

  1. Set the attribute name.givenName. Click Apply.

 

Set attribute familyName in IdentityIQ for EPM integration.

  1. Set the attribute name.familyName. Click Apply.

 

Set attribute email in IdentityIQ for EPM integration.

  1. Set the attribute email. Click Apply.

 

Set attribute displayName in IdentityIQ for EPM integration.

  1. Set the attribute displayName. Click Apply.

 

Settings for the active attribute in IdentityIQ for EPM integration.

  1. Set the attribute active. Click Apply.

 

Set the locale attribute in IdentityIQ for EPM integration.

  1. Set the attribute locale to static, and Value to en-US or en-GB. This can be mapped to an Identity attribute, if available.

 

Set the timezone attribute in IdentityIQ for EPM integration.

  1. Set the attribute timezone to static value. This can be mapped to an Identity attribute, if available.

 

  1. Provide a form name and description, and then save the form. Don’t forget to save the application.
  2. Edit the application again, and go to Correlation.
  3. Create a correlation rule. Save the application.

Account Aggregation in SailPoint IdentityIQ for EPM integration

  1. Create the aggregation task for EPM. Navigate to Setup, then Tasks.
  2. Click the New Task menu, then select Account Aggregation.

 

Create aggregate task in IdentityIQ for EPM integration

  1. Configure the task to scan PM Cloud. Scroll to the bottom of the page and click Save and Execute.
  2. Confirm the Task result is Success.

 

Create group aggregation task for roles in Endpoint Privilege Management for Windows and Mac integration.

  1. Create a group aggregation task for roles, and filter for only the roles type. Click Save and Execute, and confirm the task executed successfully.

 

  1. Go back to the application and select the Accounts tab.

In IdentityIQ, discovered or aggregated accounts together with roles.

  1. Review the discovered or aggregated accounts together with roles.

 

Discovered roles in IdentityIQ

  1. Go to Applications, then Entitlement Catalog. Use Advanced Search to filter for the application. The screen capture shows the discovered roles.

 

  1. Go to Applications, then Entitlement Catalog. Use Advanced Search to filter for the Application. The screen capture shows the discovered roles.

Only roles are requestable. Entitlements are read-only in the current RBAC model.

  1. Select a user that does not yet have access to EPM from the menu in the upper left corner. Select Manage Access, and then Manage User Access.

Select users in IdentityIQ in a EPM integration.

  1. Select a test user on the Manage User Access. Click Next.

 

Select a role in IdentityIQ when adding a user.

  1. Select a role under the EPM Application. Click Next.

 

  1. Click Submit.
  2. The request should be in Verifying mode.

New user details in EPM for IdentityIQ integration.

  1. Confirm the new user is added in EPM.

 

The Application Accounts tab in IdentityIQ in a EPM integration.

  1. Go to the Application Accounts tab and view the user application account and roles.