# 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](<https://documentation.sailpoint.com/saas/help/sources/index.html#source-and-connector-definitions>).

> [!NOTE]
>
> To view the latest features, enhancements, and fixes for all SaaS connectors, refer to the [SaaS Release Notes](<https://community.sailpoint.com/release-notes/saas>) 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](<https://docs.mage.ai/extensibility/api-reference/overview>).

> [!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.