# Configuring the CircleCI SaaS Connector

To connect CircleCI to Agentic Fabric, you'll create a personal API token for CircleCI. This will allow Agentic Fabric to discover checkout keys and OIDC custom claims and aggregate them as non-human identities.

!!! important

If your organization has already configured a CircleCI SaaS source, you can use the existing source for agent discovery. The fields will be prepopulated with the source's information. You can edit these fields to configure a new integration.

## Creating a Personal API Token in CircleCI

To create a personal API token, you must use a user account that is assigned the CircleCI Organization Admin. This account should also be [assigned](https://circleci.com/docs/guides/permissions-authentication/manage-roles-and-permissions/#assign-a-project-role) the Viewer role for each project you want to include in the integration. For more information on role permissions, refer to the CircleCI [product documentation](https://circleci.com/docs/guides/permissions-authentication/roles-and-permissions-overview/).

1. Follow the CircleCI [product documentation](https://circleci.com/docs/guides/toolkit/managing-api-tokens/#overview) to create a personal API token in CircleCI.
2. Grant the token access to the target organization (contexts, OIDC custom claims) and each project listed in project slugs.
3. Copy and store the credentials. You'll provide the credentials to connect CircleCI to Agentic Fabric.

## Connecting CircleCI to Agentic Fabric

1. Go to the **Connect Source** step of the Agentic Fabric onboarding experience.
2. Select **CircleCI SaaS** from the left pane.
3. In the **CircleCI SaaS** section, complete the following:

- In the **Source Name** field, enter a unique name for the source.

- In the **Source Owner** field, select the identity who will own the source.

- In the **Description** field, enter a unique description for the source to distinguish it from similar connections.

4. In the **Configure Authentication** section, complete the following:

- In the **CircleCI API Base URL** field, enter the CircleCI API v2 URL. The default is `https://circleci.com/api/v2`. Override this value only for CircleCI Server.
    - In the **Personal API Token** field, enter the personal API token that you created. The connector sends this token in the Circle-Token header.
    - In the **Organization ID (UUID)** field, enter the UUID of the CircleCI organization. You can find this information in CircleCI by going to **Organization Settings > Overview**.
    - In the **Project Slugs** field, enter one or more project slugs in vcs/org/repo format. Separate multiple slugs with commas. The token must be able to read at least one slug.

5. Select **Test Connection** to ensure the connection is successful.

6. If the test is successful, select **Aggregate** to run an aggregation for the source. Select **Exit** to skip this step. You can configure aggregations for the source's [datasets](../../../sources/datasets.md#configuring-dataset-aggregations) later in the source's configuration. For information about the datasets specific to CircleCI, refer to the CircleCI [connector documentation](https://documentation.sailpoint.com/connectors/saas/circleci/help/saas_connectivity/circleci/datasets.html).

A **Completed** status is now displayed next to the source in the left panel.

7. Choose another connector to configure or select **Continue** to proceed to the next onboarding step.

Configuring the CircleCI SaaS Connector

To connect CircleCI to Agentic Fabric, you'll create a personal API token for CircleCI. This will allow Agentic Fabric to discover checkout keys and OIDC custom claims and aggregate them as non-human identities.

Important

If your organization has already configured a CircleCI SaaS source, you can use the existing source for agent discovery. The fields will be prepopulated with the source's information. You can edit these fields to configure a new integration.

Creating a Personal API Token in CircleCI

To create a personal API token, you must use a user account that is assigned the CircleCI Organization Admin. This account should also be assigned the Viewer role for each project you want to include in the integration. For more information on role permissions, refer to the CircleCI product documentation.

Follow the CircleCI product documentation to create a personal API token in CircleCI.
Grant the token access to the target organization (contexts, OIDC custom claims) and each project listed in project slugs.
Copy and store the credentials. You'll provide the credentials to connect CircleCI to Agentic Fabric.

Connecting CircleCI to Agentic Fabric

Go to the Connect Source step of the Agentic Fabric onboarding experience.
Select CircleCI SaaS from the left pane.
In the CircleCI SaaS section, complete the following:
- In the Source Name field, enter a unique name for the source.
- In the Source Owner field, select the identity who will own the source.
- In the Description field, enter a unique description for the source to distinguish it from similar connections.
In the Configure Authentication section, complete the following:
- In the CircleCI API Base URL field, enter the CircleCI API v2 URL. The default is https://circleci.com/api/v2. Override this value only for CircleCI Server.
- In the Personal API Token field, enter the personal API token that you created. The connector sends this token in the Circle-Token header.
- In the Organization ID (UUID) field, enter the UUID of the CircleCI organization. You can find this information in CircleCI by going to Organization Settings > Overview.
- In the Project Slugs field, enter one or more project slugs in vcs/org/repo format. Separate multiple slugs with commas. The token must be able to read at least one slug.
Select Test Connection to ensure the connection is successful.
If the test is successful, select Aggregate to run an aggregation for the source. Select Exit to skip this step. You can configure aggregations for the source's datasets later in the source's configuration. For information about the datasets specific to CircleCI, refer to the CircleCI connector documentation.

A Completed status is now displayed next to the source in the left panel.
Choose another connector to configure or select Continue to proceed to the next onboarding step.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.