SailPoint IdentityNow
SailPoint IdentityNow is a SaaS identity and access management (IAM) solution.
Asset Types Fetched
See Additional Resources Required per Asset/Entity Type for a list of asset types this adapter fetches, with the prerequisites relevant to each asset type.
Before You Begin
APIs
Axonius uses the following APIs:
General Permissions
- The value supplied in Client ID must be associated with credentials that have Read-only permissions to fetch assets.
- The SailPoint personal access token must be assigned to the following grant types:
Additional Resources Required per Asset/Entity Type
| Asset/Entity Type | API Endpoint(s) | Required Axonius Product | Type | Permission(s) | Scope(s) |
|---|---|---|---|---|---|
| Users | v3/public-identities | - | Personal Access Token | User levels: USER | sp:scopes:default |
| Users (Identities) | v3/accounts | Identities | Personal Access Token | User levels: ORG_ADMIN, SOURCE_ADMIN, SOURCE_SUBADMIN, HELPDESK | idn:accounts:read |
| Accounts | v3/sources | Axonius SaaS Applications | Personal Access Token | User levels: ORG_ADMIN, SOURCE_ADMIN, SOURCE_SUBADMIN, ROLE_SUBADMIN | idn:sources:read, idn:sources:manage |
| Roles / Rules | v3/roles | Axonius SaaS Applications, Axonius Identities | Personal Access Token | User levels: ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN | idn:role-unchecked:read, idn:role-unchecked:manage, idn:role-checked:manage, idn:role-checked:read |
| Groups | beta/workgroups | - | Personal Access Token | - | idn:workgroup:read |
| Security Roles (1) | beta/entitlements, v3/search | Identities | Personal Access Token | User levels: Any | idn:entitlement:read, idn:entitlement:manage |
| Security Roles (2) | v3/access-profiles, v3/search | Identities | Personal Access Token or Client Credentials | (Only for Client Credentials) User levels: ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, SOURCE_SUBADMIN | idn:access-profile:read |
| Certification Campaigns | v3/campaigns | Identities | Personal Access Token | User levels: ORG_ADMIN, CERT_ADMIN, REPORT_ADMIN | idn:campaign:read, idn:campaign:manage, idn:campaign-report:read, idn:campaign-report:manage |
| Certifications of campaigns | v3/certifications | Identities | Personal Access Token | - | sp:scopes:all |
| Review Items | v3/certifications/{id}/access-review-items | Identities | Personal Access Token | User levels: ORG_ADMIN, CERT_ADMIN | - |
| Approvers | v3/certifications/{id}/reviewers | Identities | Personal Access Token | User levels: ORG_ADMIN, CERT_ADMIN | idn:certification:read |
Adapter Integration Setup
While to access SaaS data you need to grant roles and/or permissions that include write capabilities, the adapter only actually reads data from the application.
- Login to IdentityNow as an organizational administrator (ORG_ADMIN).
- Navigate to the Admin UI
>Dashboard and select the Overview page. - Select Preferences from the drop-down menu under your username
- Select Personal Access Tokens.
- Click New Token and enter a meaningful description to help differentiate the token from others.
- Click Create Token to generate and view the two components that comprise the token: Client ID and Client Secret. Copy them to use when connecting the adapter in Axonius.
Connecting the Adapter in Axonius
Required Parameters
-
Host Name or IP Address - The hostname or IP address of the SailPoint IdentityNow server. The field format is 'https://sailpoint.api.identitynow.com/v3'
-
Client ID and Client Secret - The Client ID and Client Secret for an account that has the Required Permissions to the API. To obtain the Client ID and Client Secret via your personal access token, see Personal Access Tokens.
-
SSO Provider (Only for accounts with Axonius SaaS Applications) - If your organization uses Okta for SSO, this adapter can be set as an SSO provider. See Connecting your SSO Solution Provider for more information.
Optional Parameters
- Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
- HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
- HTTPS Proxy User Name - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.
- HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.
To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.
Advanced Settings
Note
Advanced settings can either apply to all connections for this adapter, or to a specific connection. Refer to Advanced Configuration for Adapters.
- Use alias as employee ID - Select this option to set the alias field as the employee ID.
- List of private account attributes to include - Enter a list of private attributes to include with the users. Leave the field empty to include none.
- Include All Attributes - Select this option to parse all the attributes and ignore the List of private account attributes to include configuration list.
- Add Users Core Filters - Select this option to fetch only users that satisfy the core filters. For more information, see "add-core-filters" in Get a list of public identities.
- Enrich Entitlements of Accounts and Access Profiles (only for accounts with Axonius Identities) - Select this option to fetch entitlements of accounts and access profiles.
- Fetch Entitlements as Roles (only for accounts with Axonius Identities) - Select this option to enrich users with the role permissions they are assigned in SailPoint.
- Exclude Campaigns with prefix - Campaigns with the prefix will be excluded.
- Fetch Accounts (only for accounts with Axonius Software Management) - When selected, the fetch will create users from accounts or enrich users with account information and will create User Extensions.
- Use Filters when fetching accounts - Enable this option to set the following filters:
- Fetch Accounts Created In Last X Days - Enter a value for X.
- Fetch Accounts Modified In Last X Days - Enter a value for X.
- Fetch Only Accounts That Have Entitlements The fetch results will be filtered by what you define in this section.
- Fetch Sources (only for accounts with Axonius Software Management) - When selected, the fetch will create accounts from sources, fetch Applications, enrich users with sources data, and create User Extensions.
- Enrich Governance Groups With Connections - Select this option to enrich the "List Governance Groups" endpoint with the “List Connections for Governance Group“ endpoint.
- Enrich Governance Groups With Members - Select this option to enrich the "List Governance Groups" endpoint with the “List Governance Group Members“ endpoint.
- Use Username Value from Attributes - Select to populate the Username and Email fields with values from the Attributes section.
Note
To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.
Supported From Version
Supported from Axonius version 4.7
Related Enforcement Actions
Updated 3 days ago
