# Configuring the Buildkite SaaS Connector

To connect Buildkite to Agentic Fabric, you'll create an access token for Buildkite. This will allow Agentic Fabric to discover cluster-scoped agent tokens, cluster secrets, and package registry read tokens in Buildkite and aggregate them as non-human identities.

!!! important

If your organization has already configured a Buildkite 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 an API Access Token in Buildkite

Before you create an API access token in Buildkite, ensure you have following:

- API access enabled for your Buildkite organization.

- A Buildkite user account that is a member of the organization and can view its teams.

**To create an API access token in Buildkite:**

1. Follow [Buildkite's product documentation](https://buildkite.com/docs/apis/managing-api-tokens#creating-and-editing-api-access-tokens) to create an API access token.

Grant the token the [required read scopes](https://documentation.sailpoint.com/connectors/saas/buildkite/help/saas_connectivity/buildkite/required_permissions.html) to aggregate each supported dataset.

2. Copy and store the access token in a safe location. You'll provide the token to connect Buildkite to Agentic Fabric.

## Connecting Buildkite to Agentic Fabric

1. Go to the **Connect Source** step of the Agentic Fabric onboarding experience.
2. Select **Buildkite SaaS** from the left pane.
3. In the **Buildkite 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 **Organization Slug** field, enter the slug of the Buildkite organization. The slug is the organization identifier that appears in your Buildkite URL (`https://buildkite.com/acme-inc`).
    - In the **API Access Token** field, enter the access token you created in Buildkite.

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 datasets specific to Buildkite, refer to the Buildkite [connector documentation](https://documentation.sailpoint.com/connectors/saas/buildkite/help/saas_connectivity/buildkite/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 Buildkite SaaS Connector

To connect Buildkite to Agentic Fabric, you'll create an access token for Buildkite. This will allow Agentic Fabric to discover cluster-scoped agent tokens, cluster secrets, and package registry read tokens in Buildkite and aggregate them as non-human identities.

Important

If your organization has already configured a Buildkite 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 an API Access Token in Buildkite

Before you create an API access token in Buildkite, ensure you have following:

API access enabled for your Buildkite organization.
A Buildkite user account that is a member of the organization and can view its teams.

To create an API access token in Buildkite:

Follow Buildkite's product documentation to create an API access token.

Grant the token the required read scopes to aggregate each supported dataset.
Copy and store the access token in a safe location. You'll provide the token to connect Buildkite to Agentic Fabric.

Connecting Buildkite to Agentic Fabric

Go to the Connect Source step of the Agentic Fabric onboarding experience.
Select Buildkite SaaS from the left pane.
In the Buildkite 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 Organization Slug field, enter the slug of the Buildkite organization. The slug is the organization identifier that appears in your Buildkite URL (https://buildkite.com/acme-inc).
- In the API Access Token field, enter the access token you created in Buildkite.
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 datasets specific to Buildkite, refer to the Buildkite 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.