> ## 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 Codefresh connector

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

C1 provides identity governance for Codefresh. Integrate your Codefresh account
with C1 for unified visibility and governance over user access.

## Capabilities

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

The connector syncs the members of a single Codefresh account as user
identities. Each user carries their account roles (for example Admin or User)
and email, so you can see who has access to your Codefresh account and at what
level.

## Gather Codefresh credentials

<Warning>
  You need a Codefresh **API key**. It is sent on every request in the
  `Authorization` header and grants API access as your account, so treat it as a
  secret. The key must belong to a user who can read the account's member list.
</Warning>

<Steps>
  <Step>
    Sign in to Codefresh as a member of the account you want to sync.
  </Step>

  <Step>
    Open **User Settings**, then go to **API Keys**.
  </Step>

  <Step>
    Click **Generate**, give the key a descriptive name, grant it access to read
    users, and copy the generated key — you will not be able to see it again.
  </Step>
</Steps>

The connector reads the account the key belongs to automatically (from
`GET /api/user`), so there is nothing else to configure — just the API key.

## Configure the Codefresh 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 **Codefresh** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new Codefresh 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 Codefresh credentials:

        * **API key**: The Codefresh API key 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 Codefresh connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create a secret for the Codefresh API key.
      </Step>

      <Step>
        Configure the connector environment variables:

        * **BATON\_CODEFRESH\_API\_KEY**: The Codefresh API key (store this as a secret).
      </Step>

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

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