Integrating SailPoint with StatusGator
StatusGator is a cloud status monitoring platform used to track the status pages, websites, and services an organization depends on, and to administer the users who manage those boards through the StatusGator Dashboard. This document provides the instructions required to configure a new direct connection between SailPoint and StatusGator for Quick Compliance use cases. 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 StatusGator connector supports the following:
Account Management
- Aggregate Users
Entitlement Management
- Aggregate User Roles
Note
This connector is read-only. It supports account aggregation and entitlement aggregation for Quick Compliance. Provisioning, de-provisioning, and write operations are not supported in this release. Roles are aggregated as an account entitlement on the role attribute rather than as a separate entitlement schema.
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 configuring the StatusGator connector, an Org Admin must generate an organization API token. Users with the Admin role cannot access the API section in the StatusGator Dashboard.
- Sign in to the StatusGator Dashboard.
- In the left sidebar, go to API.
- Select Generate org API token.
- Copy the org API token and store it securely. Treat this value as a sensitive credential.
- Record the following values for SailPoint configuration:
- Base URL
- API Token
Note
- Store the API token securely. Treat it like a password and do not share it with unauthorized users.
- Store the API Token securely. Tokens are issued per organization, not per board, so a legacy v2 board token cannot be used with this connector.
- If a token is revoked or regenerated in StatusGator, any SailPoint source configured with the previous token must be updated.
Required Permissions
Role-Based Access
This connector authenticates with a StatusGator organization API token. The data available to SailPoint is determined by the organization that issued the token. Access to the API section is controlled by role, so the token must be generated by an Org Admin.
StatusGator supports two built-in roles. The product UI and StatusGator documentation label them Admin and Org Admin (also written org-admin), while the API returns different values. SailPoint aggregates the API values.
| Role in the StatusGator UI | Value aggregated in SailPoint | Description | Permissions |
|---|---|---|---|
| Admin | editor |
Manages monitors, notifications, and integrations on assigned boards | Assigned boards only. Cannot invite users, create boards, manage billing, or create API tokens |
| Org Admin (org-admin) | org_admin |
Has organization-wide control, similar to the account owner | All boards, user invitations, billing, security settings, and API token creation |
Use editor and org_admin when searching, certifying, or correlating access in SailPoint. Entitlement values named admin or org-admin are not aggregated, as those strings appear only in the StatusGator UI and documentation.
Changing user roles under User Management requires an Org Admin. For more detailed information on StatusGator API authentication and integrations, refer to the following resources:
- StatusGator website
- Advanced Integrations with the StatusGator API
- StatusGator API v3 Documentation
- Set User Permissions
Note
The linked document is not maintained by SailPoint and is subject to change without notice.