Integrating SailPoint with Condens
Condens is a cloud research repository platform where organizations manage research workspaces, projects, and user access. Each Condens account has users with assigned access roles (for example, Administrator, Contributor, Limited Access Contributor). The Condens connector enables SailPoint to aggregate users from Condens and the access role assigned to each user. This document provides the instructions required to configure a new direct connection between SailPoint and Condens. For a reference to the terminology specific to SailPoint products, refer to Source and Connector Definitions.
Note
To view the latest features, enhancements, and fixes for all SaaS connectors, refer to the SaaS Release Notes page.
Supported Features
The Condens connector supports the following:
Account Management
- Aggregate Users
Entitlement Management
- Aggregate Access roles
Note
Roles are modeled as an account entitlement on the role attribute (not a separate Group schema). There is no separate entitlement aggregation command; role values are collected with account aggregation from GET /v1/users. Participants, projects, and sessions are not aggregated by this connector.
Important
Quick Compliance connectors have the following manual aggregation limits within a 24-hour period:
- Organization Admins: Limited to 3 manual account or entitlement aggregations per day per source. This limit is cumulative across all admins in the organization.
- Regular Users: Limited to 1 manual account or entitlement aggregation per day per source.
These limits ensure that individual compliance statuses are kept up to date while maintaining continuous compliance monitoring. If you need to run additional aggregations beyond these limits, contact SailPoint Support.
Prerequisites
Before you configure the Condens connector, ensure the following requirements are met:
- Sign in to Condens with an Administrator account.
- Generate an API key in Condens:
- Go to Settings > API & MCP-Server.
- Select Create new key.
- Copy and securely store the API key (it is shown only once).
- Confirm the correct API Base URL for your Condens region.
- Confirm the API key can call
GET /v1/userssuccessfully (for example from Condens settings or your internal validation).
Base URL
Condens hosts data in different regions. You must set the Base URL in SailPoint Connection Settings to match your Condens account region:
| Region | Base URL |
|---|---|
| US | https://api-us.condens.io |
| EU | https://api.condens.io |
To find your Base URL:
- Sign in to Condens.
- Go to Settings > API & MCP-Server.
- Use the API base URL shown on that page.
Note
Using the wrong region Base URL causes Test Connection or aggregation to fail even with a valid API token.
Note
- Condens authentication for this connector uses an API Token.
- All API calls use
Authorization: Bearer <API_TOKEN>. - API keys are long-lived and do not expire unless deleted in Condens.
- Regenerating or deleting an API key invalidates previous credentials.
- Only Condens Administrators can create and manage API keys.
Required Permissions
Use a Condens Administrator to generate the API token used by SailPoint. The API token represents the organization and provides access according to Condens API key permissions. This connector is read-only (aggregation only). It does not create, update, or delete Condens users.
Membership Access Roles
Access roles are aggregated from the top-level role field on each user in the list users response, for example from GET /v1/users.
| API Role Value | Condens UI Name | Typical Meaning |
|---|---|---|
| administrator | Administrator | Manages users, workspaces, and account or API settings. |
| contributor | Contributor | Full research collaboration access (analyze data, work in projects). |
| limited_access_contributor | Limited Access Contributor | Contributor-style access with more limits (for example no Participant Pool access). |
| full_access_viewer | Full Access Viewer | Broad read access to workspace research data; not a full contributor seat. |
| viewer | Viewer | Read-only stakeholder access (for example published insights or magazine); can be invited to specific projects. |
For more information about Condens, refer to the following:
Note
The linked document is not maintained by SailPoint and is subject to change without notice.