# Configuring the Octopus Deploy SaaS Connector

To connect Octopus Deploy to Agentic Fabric, you'll create a service account and an API key in Octopus Deploy. This will allow Agentic Fabric to discover API keys, stored vault accounts, certificates, and other credentials and aggregate them as non-human identities and accounts.

!!! important

If your organization has already configured an Octopus Deploy 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 Service Account and API Key in Octopus Deploy

1. Follow [Octopus Deploy's product documentation](https://octopus.com/docs/security/users-and-teams/service-accounts#ServiceAccounts-CreatingAServiceAccount) to create a service account.
2. Grant the service account the [required permissions](https://documentation.sailpoint.com/connectors/saas/octopus_deploy/help/saas_connectivity/octopus_deploy/required_permissions.html).
3. [Create an API key](https://octopus.com/docs/api/authentication/create-an-api-key/) for the service account.

## Connecting Octopus Deploy to Agentic Fabric

1. Go to the **Connect Source** step of the Agentic Fabric onboarding experience.
2. Select **Octopus Deploy** from the left pane.
3. In the **Octopus Deploy** 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 **Octopus Server URL** field, enter the base URL of your Octopus Deploy server (`https://your-instance.octopus.app`) or the URL of your self-hosted Octopus Deploy server.
    - In the **API Key** field, enter the API key for the service account you created.

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

To connect Octopus Deploy to Agentic Fabric, you'll create a service account and an API key in Octopus Deploy. This will allow Agentic Fabric to discover API keys, stored vault accounts, certificates, and other credentials and aggregate them as non-human identities and accounts.

Important

If your organization has already configured an Octopus Deploy 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 Service Account and API Key in Octopus Deploy

Follow Octopus Deploy's product documentation to create a service account.
Grant the service account the required permissions.
Create an API key for the service account.

Connecting Octopus Deploy to Agentic Fabric

Go to the Connect Source step of the Agentic Fabric onboarding experience.
Select Octopus Deploy from the left pane.
In the Octopus Deploy 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 Octopus Server URL field, enter the base URL of your Octopus Deploy server (https://your-instance.octopus.app) or the URL of your self-hosted Octopus Deploy server.
- In the API Key field, enter the API key for the service account you created.
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 Octopus Deploy, refer to the Octopus Deploy 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.