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

# Set up a Deputy connector

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

C1 provides identity governance for Deputy. Integrate your Deputy
instance with C1 for unified visibility and governance over user access.

## Capabilities

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

The connector reads the employees in your Deputy account and the account's
access levels (Deputy's permission levels). Each employee syncs as a user with
their name, email, and active status, and carries their access level on the
profile so you can see which permission level each person holds. The access
levels themselves sync as separate records so you can browse them directly. The
connector is read-only.

## Gather Deputy credentials

<Note>
  You need an administrator in Deputy to create a permanent access token that
  can read your account's employees and access levels.
</Note>

<Steps>
  <Step>
    Sign in to Deputy as an administrator.
  </Step>

  <Step>
    Note your Deputy install address from the browser address bar. It has the
    form `https://<installname>.<region>.deputy.com` (for example
    `https://acme.au.deputy.com`). The connector needs this host with the
    `/api/v1` path appended.
  </Step>

  <Step>
    Open **Integrations** and create a new **Permanent Token**. Copy the token
    when it is shown — Deputy only displays it once.
  </Step>
</Steps>

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

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

        * **Deputy API base URL**: your install's v1 API base URL, including the
          `/api/v1` path and with no trailing slash — for example
          `https://acme.au.deputy.com/api/v1`.
        * **Permanent access token**: the permanent token you created in Deputy.
      </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 Deputy connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create a secret for the Deputy permanent access token.
      </Step>

      <Step>
        Configure the connector environment variables:

        * **BATON\_DEPUTY\_ENDPOINT**: your install's v1 API base URL, including
          the `/api/v1` path and with no trailing slash (for example
          `https://acme.au.deputy.com/api/v1`).
        * **BATON\_DEPUTY\_PERMANENT\_TOKEN**: the permanent token you created in
          Deputy.
      </Step>

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

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