Skip to content

Integrating SailPoint with Mage AI

Mage AI is a data engineering platform for building, running, and managing data pipelines. Mage Pro deploys workloads on Kubernetes clusters; each development environment exposes a workspace REST API for authentication, user management, and role-based access control (RBAC) within that cluster. This document provides instructions to configure a new direct connection to a Mage AI source. 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 Mage AI connector supports the following:

Account Management

  • Aggregate Accounts

Entitlement Management

  • Aggregate Roles

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

Ensure the following prerequisites are met before proceeding with the configuration:

  1. Active Mage Pro cluster: The development environment must be running. If the cluster is stopped, API calls return errors such as 502 Bad Gateway or 405 Method Not Allowed.
  2. Workspace credentials: A Mage workspace user account (email and password) that can sign in to the target cluster.
  3. Workspace API key: The X-API-KEY value used by the Mage workspace (obtain from the browser Network tab while logged into the cluster editor, or from cluster/container logs).
  4. Cluster UUID: The path segment for your environment (for example, mageai-12345-development), visible in the workspace URL. For example, https://cluster.mage.ai/<cluster-uuid>/. For more information about the Mage API, refer to the Mage AI API overview documentation.

Note

The linked document is not maintained by SailPoint and is subject to change without notice.

Required Permissions

  • The user must have the Admin role to aggregate all users in the cluster.