> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-mcp-bridge-private-server.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a GoCD connector

> C1 provides identity governance for GoCD. Integrate your GoCD server with C1 for unified visibility and governance over user access.

C1 provides identity governance for GoCD. Integrate your GoCD server with C1 for
unified visibility and governance over who can sign in to GoCD, which of them are
administrators, and the security roles each user holds.

## Capabilities

| Resource | Sync                                                          | Provision |
| -------- | ------------------------------------------------------------- | --------- |
| Users    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

Each synced user carries their account status (enabled or disabled), whether they
are a GoCD administrator, and the security roles assigned to them.

## Gather GoCD credentials

<Warning>
  To configure the GoCD connector you need a personal access token that belongs to
  a GoCD **administrator**. Listing all users is an administrator-only operation,
  so a non-admin token cannot be used.
</Warning>

<Steps>
  <Step>
    Sign in to your GoCD server as an administrator.
  </Step>

  <Step>
    Open the user menu in the top-right corner and choose **Personal Access
    Tokens**.
  </Step>

  <Step>
    Create a new token, give it a descriptive name, and copy the generated token
    value. GoCD shows the token only once.
  </Step>

  <Step>
    Note the base URL of your GoCD server — the address you use to reach the
    dashboard, for example `https://gocd.example.com`. You will enter it without
    a trailing slash and without any API path.
  </Step>
</Steps>

## Configure the GoCD connector

<Tabs>
  <Tab title="Cloud-hosted">
    Follow these instructions to use a built-in, no-code connector hosted by C1.

    <Steps>
      <Step>
        In C1, navigate to **Integrations** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **GoCD** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new GoCD connector.
      </Step>

      <Step>
        Set the owner for this connector.
      </Step>

      <Step>
        Click **Next**.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        Enter the GoCD credentials:

        * **GoCD Base URL**: The origin of your GoCD server, for example `https://gocd.example.com`.
        * **Personal Access Token**: The administrator personal access token you created.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by **Connected**. You can view the logs to ensure that information is syncing.
      </Step>
    </Steps>

    **Done.** Your GoCD connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    Follow these instructions to run the GoCD connector in your own environment.

    <Steps>
      <Step>
        Create a secret for the GoCD administrator personal access token.
      </Step>

      <Step>
        Configure the connector with:

        * **GoCD Base URL**: The origin of your GoCD server, for example `https://gocd.example.com`.
        * **Personal Access Token**: The administrator personal access token, supplied as a secret.
      </Step>

      <Step>
        Deploy the connector using your standard self-hosted connector process.
      </Step>
    </Steps>

    **Done.** Your GoCD connector is now pulling access data into C1.
  </Tab>
</Tabs>